ChipaDocs

Changelog

🚀 New to GMGN.ai? Create your account with our referral link to support GmGnAPI’s development → Sign up on GMGN.ai
💬 Need help? Join the Chipa Discord · ⚡ Go no-code with ChipaEditor

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

v1.3.0 — 2025-06-01 (Latest)

Added

  • subscribe_trending() channel for GMGN trending token list updates
  • TokenFilter.max_holder_concentration parameter to filter high-risk concentrated tokens
  • ConnectionConfig.ping_interval and ping_timeout for keep-alive control

Improved

  • Reconnection now re-subscribes all active channels automatically after reconnect
  • Pydantic v2 migration complete — 40% faster model parsing

Fixed

  • Race condition in listen() when multiple subscriptions were active simultaneously
  • Memory leak in long-running sessions when on_statistics_update was registered

v1.2.0 — 2025-04-15

Added

  • SQLiteExporter and CSVExporter for persistent data storage
  • on_reconnect event hook with attempt count parameter
  • subscribe_trades(address) for individual transaction streams

Improved

  • Exponential backoff now capped at 60 seconds (was uncapped)
  • Type stubs (.pyi files) now shipped with the package for full IDE support

Fixed

  • on_raw_message now fires before model validation, not after
  • TokenFilter.chains case-insensitive matching

v1.1.0 — 2025-02-28

Added

  • TokenFilter class for declarative event filtering
  • on_statistics_update hook with connection metrics
  • subscribe_token_updates(address) for per-token monitoring

Improved

  • Context manager (async with) now properly closes on exception

Fixed

  • Handler exceptions no longer kill the entire event loop

v1.0.0 — 2025-01-10 (Initial Release)

  • GmGnClient with async context manager support
  • subscribe_new_pools() WebSocket channel
  • on_new_pool event decorator
  • Pydantic v2 models for all data types
  • Automatic reconnection with backoff
  • 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 described on the GitLab releases page with migration instructions. Join the Chipa Discord to get upgrade announcements first.

Stay in the Loop