> 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/trade-activity/trading-volume.md).

# Trading Volume

Summed buy and sell volume from tracked smart money, KOL and whale wallets over a time window on Solana, BNB Chain, Base and Ethereum — in native currency and USD, for volume charts and analytics.

## Trading Volume — Smart Money & KOL Buy/Sell Volume (Native & USD)

> Returns the total trading volume of tracked smart money, KOL and whale wallets within a time window for one chain and wallet type on Solana, BNB Chain, Base or Ethereum — summed in native currency (\`volume\`) and in historical USD (\`volume\_usd\`). Ideal for smart-money volume charts, trading dashboards and analytics. Add \`\&mint=\` to measure a single token.\
> \
> \*\*Time window\*\* — set \`seconds\`, \`minutes\` and/or \`hours\`; they add up. The window is capped at 24 hours. If you request more, the volume is summed over the capped window and a note is added to the \`warnings\` array. The applied window is echoed back as \`time\_window\_seconds\`.\
> \
> \*\*Data source\*\* — summed straight from the per-chain, per-type live trade index (sorted by timestamp). \`volume\_usd\` sums the historical USD value of each trade; trades without a stored USD value fall back to the current native price.\
> \
> \*\*Parameters / settings\*\*\
> \- \`blockchain\` (required) — one of: \`solana\`, \`bnb\`, \`base\`, \`eth\`\
> \- \`type\` (required) — \`kol\`, \`smart\`, or \`whale\` (availability per chain:\
>   solana → kol/smart/whale; bnb → kol/smart; base → kol/smart; eth → kol)\
> \
> \- \`seconds\` / \`minutes\` / \`hours\` (optional) — time window, capped at 24 hours\
> \- \`mint\` (optional) — measure only one token mint / contract address\
> \- \`api\_key\` (optional if the Bearer header is used)<br>

```json
{"openapi":"3.0.3","info":{"title":"CabalSpy API — Trading Volume","version":"1.0.0"},"tags":[{"name":"Trading Volume","description":"Summed buy and sell volume from tracked smart money, KOL and whale wallets over a time window on Solana, BNB Chain, Base and Ethereum — in native currency and USD, for volume charts and analytics.\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":{"TradingVolumeEnvelope":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"blockchain":{"type":"string"},"type":{"type":"string"},"mode":{"type":"string"},"volume":{"type":"number","description":"Summed volume in native currency."},"volume_usd":{"type":"number","nullable":true,"description":"Summed historical USD volume."},"currency":{"type":"string"},"time_window_seconds":{"type":"integer","description":"The applied time window in seconds."},"mint":{"type":"string","description":"Only present when filtered with mint."},"warnings":{"type":"array","description":"Present when the time window was capped.","items":{"type":"string"}}}},"meta":{"type":"object"}}},"ErrorEnvelope":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"},"docs":{"type":"string"}}}}}}},"paths":{"/v1/transactions/volume":{"get":{"tags":["Trading Volume"],"summary":"Trading Volume — Smart Money & KOL Buy/Sell Volume (Native & USD)","operationId":"getTradingVolume","description":"Returns the total trading volume of tracked smart money, KOL and whale wallets within a time window for one chain and wallet type on Solana, BNB Chain, Base or Ethereum — summed in native currency (`volume`) and in historical USD (`volume_usd`). Ideal for smart-money volume charts, trading dashboards and analytics. Add `&mint=` to measure a single token.\n\n**Time window** — set `seconds`, `minutes` and/or `hours`; they add up. The window is capped at 24 hours. If you request more, the volume is summed over the capped window and a note is added to the `warnings` array. The applied window is echoed back as `time_window_seconds`.\n\n**Data source** — summed straight from the per-chain, per-type live trade index (sorted by timestamp). `volume_usd` sums the historical USD value of each trade; trades without a stored USD value fall back to the current native price.\n\n**Parameters / settings**\n- `blockchain` (required) — one of: `solana`, `bnb`, `base`, `eth`\n- `type` (required) — `kol`, `smart`, or `whale` (availability per chain:\n  solana → kol/smart/whale; bnb → kol/smart; base → kol/smart; eth → kol)\n\n- `seconds` / `minutes` / `hours` (optional) — time window, capped at 24 hours\n- `mint` (optional) — measure only one token mint / contract address\n- `api_key` (optional if the Bearer header is used)\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":"hours","in":"query","required":false,"schema":{"type":"integer","minimum":0}},{"name":"minutes","in":"query","required":false,"schema":{"type":"integer","minimum":0}},{"name":"seconds","in":"query","required":false,"schema":{"type":"integer","minimum":0}},{"name":"mint","in":"query","required":false,"schema":{"type":"string"}},{"name":"api_key","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Returns the summed trading volume for the requested time window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradingVolumeEnvelope"}}}},"400":{"description":"Missing or invalid parameter (e.g. `type` or `blockchain`).","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"}}}}}}}}}
```