> For the complete documentation index, see [llms.txt](https://cabalspy.gitbook.io/cabalspy-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cabalspy.gitbook.io/cabalspy-docs/signals/analytics.md).

# Analytics

Volume trend, most-traded tokens, aggregate win rate and top performers for tracked smart money, KOL and whale wallets on Solana, BNB Chain, Base and Ethereum.

## Analytics — Volume Trend, Most Traded, Win Rate & Top Performers

> Returns one of four analytics views for a chain and wallet type over a period.\
> \
> \*\*Parameters / settings\*\*\
> \- \`blockchain\` (required) — \`solana\`, \`bnb\`, \`base\`, \`eth\`\
> \- \`type\` (required) — \`kol\`, \`smart\`, or \`whale\` (per chain: solana →\
>   kol/smart/whale; bnb → kol/smart; base → kol/smart; eth → kol)\
> \
> \- \`mode\` (required) — \`volume\_trend\`, \`most\_traded\`, \`win\_rate\`, or \`top\_performers\`\
> \- \`period\` (optional, default \`7d\`) — \`6h\`, \`1d\`, \`7d\`, or \`30d\`\
> \- \`limit\` (optional) — page size for list modes (most\_traded, top\_performers)\
> \- \`api\_key\` (optional if the Bearer header is used)\
> \
> \*\*Note on units\*\* — \`volume\_trend\` and \`most\_traded\` are reported in native currency only (no historical USD is stored for these series).<br>

```json
{"openapi":"3.0.3","info":{"title":"CabalSpy API — Analytics","version":"1.0.0"},"tags":[{"name":"Analytics","description":"Volume trend, most-traded tokens, aggregate win rate and top performers for tracked smart money, KOL and whale wallets on Solana, BNB Chain, Base and Ethereum.\n"}],"servers":[{"url":"https://api.cabalspy.xyz"}],"security":[{"bearerAuth":[]},{"apiKeyQuery":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Authorization: Bearer YOUR_KEY"},"apiKeyQuery":{"type":"apiKey","in":"query","name":"api_key"}},"schemas":{"AnalyticsEnvelope":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","description":"Always carries mode, blockchain, type, period, currency. For volume_trend / most_traded / top_performers the rows are in `data` (array). win_rate returns its totals and a `distribution` object inline.\n","properties":{"mode":{"type":"string","enum":["volume_trend","most_traded","win_rate","top_performers"]},"blockchain":{"type":"string"},"type":{"type":"string"},"period":{"type":"string","enum":["6h","1d","7d","30d"]},"currency":{"type":"string","enum":["SOL","BNB","ETH"]},"data":{"type":"array","description":"Rows for list modes; absent for win_rate.","items":{"oneOf":[{"$ref":"#/components/schemas/VolumeTrendDay"},{"$ref":"#/components/schemas/MostTradedToken"},{"$ref":"#/components/schemas/TopPerformer"}]}},"total_wallets":{"type":"integer","description":"win_rate only."},"wallets_with_trades":{"type":"integer","description":"win_rate only."},"win_count":{"type":"integer","description":"win_rate only."},"closed_count":{"type":"integer","description":"win_rate only."},"win_rate_percentage":{"type":"number","description":"win_rate only."},"distribution":{"$ref":"#/components/schemas/PnlDistribution"}}},"meta":{"type":"object","description":"Includes request_id, cached, cache_age_seconds, version, timestamp, and pagination for list modes."}}},"VolumeTrendDay":{"type":"object","properties":{"date":{"type":"string"},"total_volume":{"type":"number"},"total_buy":{"type":"number"},"total_sell":{"type":"number"},"buy_txn":{"type":"integer"},"sell_txn":{"type":"integer"},"total_txn":{"type":"integer"},"net_flow":{"type":"number"},"active_wallets":{"type":"integer"}}},"MostTradedToken":{"type":"object","properties":{"rank":{"type":"integer"},"mint":{"type":"string"},"token_name":{"type":"string"},"wallet_count":{"type":"integer"},"total_volume":{"type":"number"},"total_buy":{"type":"number"},"total_sell":{"type":"number"},"net_flow":{"type":"number"},"buying_pressure":{"type":"number","nullable":true},"currency":{"type":"string"},"first_buy_at":{"type":"string"}}},"TopPerformer":{"type":"object","properties":{"rank":{"type":"integer"},"profile":{"$ref":"#/components/schemas/Profile"},"period_stats":{"type":"object","properties":{"period":{"type":"string"},"currency":{"type":"string"},"total_buy":{"type":"number"},"total_buy_usd":{"type":"number"},"total_sell":{"type":"number"},"total_sell_usd":{"type":"number"},"total_volume":{"type":"number"},"total_volume_usd":{"type":"number"},"realized_pnl":{"type":"number"},"realized_pnl_usd":{"type":"number"},"realized_pnl_percentage":{"type":"number"},"buy_txn":{"type":"integer"},"sell_txn":{"type":"integer"},"total_txn":{"type":"integer"},"win_count":{"type":"integer"},"closed_count":{"type":"integer"},"win_rate_percentage":{"type":"number"},"avg_hold_time_minutes":{"type":"number"},"active_tokens":{"type":"integer"},"tokens_traded":{"type":"integer"}}},"period_win_rate_distribution":{"allOf":[{"$ref":"#/components/schemas/PnlDistribution"},{"type":"object","properties":{"win_count":{"type":"integer"},"closed_count":{"type":"integer"},"win_rate_percentage":{"type":"number"}}}]}}},"Profile":{"type":"object","properties":{"name":{"type":"string"},"image_url":{"type":"string"},"twitter":{"type":"string"},"telegram":{"type":"string"},"blockchain":{"type":"string"},"currency":{"type":"string"},"type":{"type":"string","enum":["kol","smart","whale"]},"wallet_address":{"type":"string"}}},"PnlDistribution":{"type":"object","description":"Count of closed trades by realized-PnL bucket (%).","properties":{"above_500":{"type":"integer"},"above_100_to_500":{"type":"integer"},"above_zero_to_100":{"type":"integer"},"below_zero":{"type":"integer"}}},"ErrorEnvelope":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}}}}}}},"paths":{"/v1/analytics":{"get":{"tags":["Analytics"],"summary":"Analytics — Volume Trend, Most Traded, Win Rate & Top Performers","operationId":"getAnalytics","description":"Returns one of four analytics views for a chain and wallet type over a period.\n\n**Parameters / settings**\n- `blockchain` (required) — `solana`, `bnb`, `base`, `eth`\n- `type` (required) — `kol`, `smart`, or `whale` (per chain: solana →\n  kol/smart/whale; bnb → kol/smart; base → kol/smart; eth → kol)\n\n- `mode` (required) — `volume_trend`, `most_traded`, `win_rate`, or `top_performers`\n- `period` (optional, default `7d`) — `6h`, `1d`, `7d`, or `30d`\n- `limit` (optional) — page size for list modes (most_traded, top_performers)\n- `api_key` (optional if the Bearer header is used)\n\n**Note on units** — `volume_trend` and `most_traded` are reported in native currency only (no historical USD is stored for these series).\n","parameters":[{"name":"blockchain","in":"query","required":true,"schema":{"type":"string","enum":["solana","bnb","base","eth"]}},{"name":"type","in":"query","required":true,"schema":{"type":"string","enum":["kol","smart","whale"]}},{"name":"mode","in":"query","required":true,"schema":{"type":"string","enum":["volume_trend","most_traded","win_rate","top_performers"]}},{"name":"period","in":"query","required":false,"schema":{"type":"string","enum":["6h","1d","7d","30d"],"default":"7d"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"api_key","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"The requested analytics view.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsEnvelope"}}}},"400":{"description":"Missing or invalid parameter (e.g. `mode`, `period`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Missing API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Invalid or exhausted API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}}}
```