GMGN is a simple yet powerful solution for collecting, tracking, and analyzing on-chain data. It fetches information from various blockchains, stores them in a local database, and provides commands for quickly retrieving or updating wallet data.
- Manage multiple wallet addresses
- Retrieve token balances, PnL, and other on-chain metrics
- Update and retrieve data via Telegram Bot
- Export results to CSV for quick sharing or further analysis
- Scrap/: Contains scraping scripts (request/response logic, address parsing)
- Database/: Database setup and migration scripts
- Bot/: Telegram bot handlers, including main interface and services
- config/: Global configurations (DB paths, tokens, etc.)
- Python 3.9+
- Required libraries are listed in requirements.txt (PyJWT, cloudscraper, etc.)
- A Telegram bot token (see configs.py)
- Clone or download this repository.
- Install dependencies:
pip install -r requirements.txt - Edit configs.py to set your own DB_PATH, CSV_PATH, and TELEGRAM_BOT_TOKEN.
- Run main.py to initialize the bot:
python main.py - Interact with the bot via Telegram to add wallet addresses, scrape results, and export data.
Contributions are welcome! Please create a pull request for any improvements or bug fixes.
MIT License