> 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)
```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"}}}}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://cabalspy.gitbook.io/cabalspy-docs/trade-activity/trading-volume.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.