skill-07-token-analytics

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

1. Define whale threshold (e.g., > 0.1% of supply or > $1M holdings)
2. Query top holders via explorer API or eth_call on token contract
3. Monitor large transfers via event logs (Transfer topic)
4. 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

1. Index wallet Transfer events for target token
2. Apply FIFO or specific-lot cost basis method
3. Fetch historical prices from price-feed-server
4. 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