🆕 Keep up with new releases faster by writing your upgrade scripts in Chipa Editor. Try free →

Changelog

All notable changes to GmGnAPI. Follows Keep a Changelog format and Semantic Versioning.

GitHub Releases Announce on Discord
v1.3.0 2025-06-01 — Latest
  • NEW Added subscribe_trending() channel for GMGN trending token list updates
  • NEW TokenFilter.max_holder_concentration parameter to filter high-risk concentrated tokens
  • NEW ConnectionConfig.ping_interval and ping_timeout for keep-alive control
  • IMPROVE Reconnection now re-subscribes all active channels automatically after reconnect
  • IMPROVE Pydantic v2 migration complete — 40% faster model parsing
  • FIX Race condition in listen() when multiple subscriptions were active simultaneously
  • FIX Memory leak in long-running sessions when on_statistics_update was registered
v1.2.0 2025-04-15
  • NEW SQLiteExporter and CSVExporter for persistent data storage
  • NEW on_reconnect event hook with attempt count parameter
  • NEW subscribe_trades(address) for individual transaction streams
  • IMPROVE Exponential backoff now capped at 60 seconds (was uncapped)
  • IMPROVE Type stubs (.pyi files) now shipped with the package for full IDE support
  • FIX on_raw_message now fires before model validation, not after
  • FIX TokenFilter.chains case-insensitive matching
v1.1.0 2025-02-28
  • NEW TokenFilter class for declarative event filtering
  • NEW on_statistics_update hook with connection metrics
  • NEW subscribe_token_updates(address) for per-token monitoring
  • IMPROVE Context manager (async with) now properly closes on exception
  • FIX Handler exceptions no longer kill the entire event loop
v1.0.0 2025-01-10 — Initial Release
  • NEW GmGnClient with async context manager support
  • NEW subscribe_new_pools() WebSocket channel
  • NEW on_new_pool event decorator
  • NEW Pydantic v2 models for all data types
  • NEW Automatic reconnection with backoff
  • NEW Python 3.8+ support

Upgrading

Always upgrade in a virtual environment and pin your version in production:

# Upgrade to latest
pip install --upgrade gmgnapi

# Pin a specific version
pip install gmgnapi==1.3.0

Breaking changes are marked BREAK and described in the GitHub Releases page with migration instructions. Join Discord to get upgrade announcements first.

Stay in the Loop

Join our Discord to get release announcements, beta previews, and early access to new features before they ship to PyPI.

Join Discord Watch on GitHub Try Chipa Editor