| name | skill-07-token-analytics |
| description | Analyzes on-chain token data including whale tracking, DEX volume, wallet PnL, and token unlock schedules. Use when researching token metrics, portfolio performance, or market activity. |
| metadata | {"phase":2,"chains":"ethereum,solana,polygon,arbitrum,base"} |
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_call on token contract
- Monitor large transfers via event logs (
Transfer topic)
- 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
Transfer events 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
