Frequently Asked Questions

Yes. GmGnAPI connects to GMGN.ai's WebSocket infrastructure, which requires an account. Sign up for free using our referral link — it costs nothing and helps support the project:

 Create Free Account →

GmGnAPI supports Python 3.8 and above. We recommend Python 3.11+ for best performance with asyncio. Run python --version to check yours.

pip install gmgnapi

See the full Installation Guide for virtual environment setup and optional dependencies.

Yes — GmGnAPI is fully open source under the MIT License. You can use it commercially, modify it, and redistribute it. Check the GitHub repo for the full license.

GmGnAPI reconnects automatically with exponential backoff. If you're seeing frequent drops, try enabling ping keepalives:

from gmgnapi import ConnectionConfig
config = ConnectionConfig(ping_interval=20, ping_timeout=10)
async with GmGnClient(connection_config=config) as client: ...

See the WebSocket Guide for more reconnection options.

Yes. Call multiple subscribe methods before listen():

await client.subscribe_new_pools()
await client.subscribe_trending()
await client.subscribe_token_updates("7xKXt...")
await client.listen()

Without filters, the new_pools channel can produce dozens of events per minute on a busy market day. With filters applied, expect a much lower rate matching only tokens you care about. See the Filters Guide.

TokenFilter parameters that map to GMGN subscription options are sent server-side — GMGN only pushes matching events. Additional custom logic in your handler runs client-side. See the Filters Guide for details.

Currently, filter changes require re-subscribing, which the client handles automatically if you call subscribe_new_pools(filters=new_filter) on a live connection.

No — GmGnAPI is purely a data library. It streams market data from GMGN.ai. You connect trade execution yourself (Jupiter, Raydium SDK, custom wallet integration, etc.). See the Trading Bots guide.

Replace your buy/sell functions with print() statements ("paper trading"). Log what the bot would have done, check the results after 24–48 hours, then go live. This is described in Tutorial 5.

Join our Discord server — the #trading-bots channel is active with builders sharing strategies, reviewing code, and collaborating. Or visit the Community page to see what others have built.

We built GmGnAPI using Chipa Editor — an AI-powered code editor purpose-built for Python developers. It has first-class support for async/await, inline type hints, and fast debugging. It's free to download.

Download Chipa Editor →

Open an issue on GitHub Issues. Include your Python version, GmGnAPI version (pip show gmgnapi), and a minimal reproducible example.