GmGnAPI

🚀 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

Professional Python client library for the GMGN.ai WebSocket API. GmGnAPI provides real-time access to Solana blockchain data with advanced features including intelligent filtering, data export, monitoring statistics, and automated alerting.

Get Started · View on GitLab

Key Features

Feature	Description
Real-time WebSocket	Persistent connection with automatic reconnection and exponential backoff
Type Safety	Full type hints with Pydantic v2 models for robust validation and IDE support
Advanced Filtering	Filter tokens by market cap, liquidity, volume, holders, exchange, and risk score
Data Export	Export to JSON, CSV, or SQLite with automatic rotation and compression
Monitoring & Stats	Real-time connection metrics, message counts, and unique token/pool tracking
Smart Alerts	Configurable alerts with rate limiting, webhook, and email notifications
Async First	Built on `asyncio` and `websockets` for modern Python applications
Multi-Chain	Solana by default, with support for Ethereum, BSC, and Polygon channels

Quick Installation

pip install gmgnapi

Quick Example

import asyncio
from gmgnapi import GmGnClient

async def main():
    async with GmGnClient() as client:
        # Subscribe to new token pools
        await client.subscribe_new_pools()

        # Handle real-time data
        @client.on_new_pool
        async def handle_pool(pool_data):
            print(f"New pool: {pool_data.chain}")

        # Start receiving data
        await client.listen()

asyncio.run(main())

Available Channels

Public Channels

new_pools — New liquidity pool creation events
pair_update — Trading pair price and volume updates
token_launch — New token launch notifications
chain_stats — Blockchain statistics and metrics

Authenticated Channels (require access token)

token_social — Token social media and community information
wallet_trades — Wallet trading activity and transactions
limit_orders — Limit order updates and fills

Account Setup

Create a GMGN account — sign up with our referral link to support the project: Create GMGN Account
Get your API token — log in, open Account Settings, generate an API token, and store it securely
Join the community — get help and updates on the Chipa Discord

Documentation

Installation — pip, source, Docker, and virtual environment setup
Getting Started — first connection, authentication, and basic usage
Tutorials — step-by-step guides from zero to production
WebSocket Guide — connection lifecycle, reconnection, and performance tuning
Filters Guide — every filter parameter with presets and custom logic
Examples — practical, runnable examples for common scenarios
Advanced Usage — production deployment, persistence, performance, and security
Trading Bots — bot patterns, risk management, and architecture
API Reference — complete class, method, and model documentation
FAQ — quick answers to common questions
Community — Discord, contributing, and project links
Changelog — version history and upgrade notes

Community & Support

GitLab Repository — source code, issues, and merge requests
Discord Server — join the community, get help, and share your projects
PyPI Package — latest releases

License & Disclaimer

GmGnAPI is open source under the MIT License. Trading cryptocurrencies involves substantial financial risk — this software is for educational purposes; always trade responsibly.

Level Up Your GmGnAPI Setup

🚀 Create your GMGN.ai account → — Register with our referral link to get API access and support GmGnAPI’s continued development. It’s free and keeps the project actively maintained.
💬 Join the Chipa Discord → — Get real-time support, share your bots and strategies, and connect with other GmGnAPI developers.
⚡ Try ChipaEditor → — Build, backtest, and deploy trading strategies with our AI-powered, no-code editor. The perfect companion to GmGnAPI.