Token Analytics
When to Use
- Tracking whale wallet movements
- Analyzing DEX trading volume and liquidity
- Calculating wallet profit/loss (PnL)
- Monitoring token unlock/vesting schedules
- Identifying smart money flows
Prerequisites
- MCP:
blockchain-rpc-server,defi-protocol-server,price-feed-server - Optional: Dune Analytics, Nansen, Arkham APIs
Workflow
1. Whale Tracking
- Define whale threshold (e.g., > 0.1% of supply or > $1M holdings)
- Query top holders via explorer API or
eth_callon token contract - Monitor large transfers via event logs (
Transfertopic) - Alert on exchange inflows (potential sell pressure)
2. DEX Volume
- Pull 24h volume from subgraph (Uniswap, Curve) via
defi-protocol-server - Compare CEX vs DEX volume for price discovery quality
- Track unique traders and buy/sell ratio
3. Wallet PnL
Realized PnL = Σ(sell proceeds) - Σ(buy cost basis for sold tokens)
Unrealized PnL = current value - remaining cost basis
- Index wallet
Transferevents for target token - Apply FIFO or specific-lot cost basis method
- Fetch historical prices from
price-feed-server - Account for gas costs and bridge fees
4. Unlock Schedules
- Parse vesting contracts (linear, cliff, milestone)
- Cross-reference with token allocations (team, investors, community)
- Flag upcoming unlocks > 1% of circulating supply
Data Sources
| Source | Data |
|---|---|
| The Graph | DEX trades, LP events, lending |
| CoinGecko | Market cap, price history |
| Etherscan | Holder distribution, contract events |
| Token unlocks APIs | Vesting calendars |
Output Format
Present analytics with:
- Time range and data freshness timestamp
- Methodology (cost basis method, price source)
- Confidence level for incomplete data