On-Chain Token Holder Analytics and Whale Tracking
RATU On-chain Monitor is an on-chain token holder analytics and whale tracking tool using the Ankr API. Part of RATUProject, it demonstrates real-time holder monitoring with paginated API queries and snapshot comparison for tracking holder changes over time.
The system provides three modes: (1) Basic Info for fast token metadata and top holders, (2) Top Holders with known labels identifying exchanges and burn addresses, (3) Full Snapshot for complete holder lists with pagination.
Built for system prototyping focus, it supports multi-chain analysis across BSC, Ethereum, Polygon, Arbitrum, Base, and Avalanche. Snapshots are saved as timestamped JSON files enabling comparison of holder distributions over time for whale tracking.
Traders need to track token holder distributions and identify whale wallets. On-chain data requires pagination for tokens with millions of holders. Exchange wallets and burn addresses need automatic identification. Snapshot comparison enables tracking holder changes over time.
Whale tracking provides insights into token distribution and potential market movements. Exchange wallet identification helps understand liquidity. Burn address tracking shows token supply reduction. Snapshot comparison enables change detection over time.
A three-mode architecture: (1) Basic Info mode using fast Ankr endpoints for token metadata and top holders, (2) Top Holders mode with known label identification, (3) Full Snapshot mode with pagination handling for complete holder lists. All modes support multi-chain analysis.
Uses Ankr getTokenPrice and getCurrencies APIs for fast token metadata. Returns top 5 holders. No pagination required.
Retrieves top 20 holders with known label identification. Automatically identifies exchanges (Binance, OKX, Bybit) and special addresses (Burn, Null).
Paginates through all holders using Ankr getTokenHolders API. Handles tokens with millions of holders. Saves timestamped JSON snapshots for comparison.
Maintains database of known wallet addresses: exchanges (Binance Hot Wallet, OKX), special addresses (Burn Address, Null Address). Automatically labels holders in output.
Ankr API provides unified multi-chain holder data. httpx connection pooling optimizes repeated API calls. Pagination handles large holder counts. Known labels provide context for holder analysis. Snapshot JSON enables time-series comparison.
Deep dive into the technical implementation with annotated code examples
View Technical DetailsHandling pagination for tokens with millions of holders
Implemented pagination loop using Ankr getTokenHolders API with page parameter. Continues until all holders retrieved. Handles large holder counts efficiently.
Identifying known wallets (exchanges, burn addresses)
Maintains database of known wallet addresses with labels. Automatically matches holder addresses against database. Identifies exchanges and special addresses in output.
Optimizing API calls for fast basic info vs full snapshots
Implemented three modes: Basic (fast, no pagination), Top Holders (fast, limited pagination), Full Snapshot (complete pagination). Users choose based on needs.
Enabling snapshot comparison for holder change tracking
Saves snapshots as timestamped JSON files. Includes holder_count, price_usd, and complete holder list. Enables programmatic comparison of snapshots over time.
Built on-chain analytics tool supporting 6 chains with fast basic info and full snapshot capability. Known label identification provides context for holder analysis. Pagination handles tokens with millions of holders. Snapshot comparison enables whale tracking.