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)

get

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)

Authorizations

bearerAuthapiKeyQuery

AuthorizationstringRequired

Authorization: Bearer YOUR_KEY

Query parameters

blockchainstring · enumRequiredExample: bnbPossible values:

typestring · enumRequiredExample: kolPossible values:

hoursintegerOptionalExample: 24

minutesintegerOptionalExample: 0

secondsintegerOptionalExample: 0

mintstringOptionalExample: 0x23a49ea152d14fe4bc41b71345b7da6687de4444

api_keystringOptionalExample: YOUR_KEY

Responses

200

Returns the summed trading volume for the requested time window.

application/json

successbooleanOptional

metaobjectOptional

400

Missing or invalid parameter (e.g. type or blockchain).

application/json

401

Missing API key.

application/json

403

Invalid or exhausted API key.

application/json

429

Rate limit exceeded.

application/json

get

/v1/transactions/volume

HTTPcURLJavaScriptPython

GET /v1/transactions/volume?blockchain=solana&type=kol HTTP/1.1
Host: api.cabalspy.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "data": {
    "blockchain": "bnb",
    "type": "kol",
    "mode": "volume",
    "volume": 1731.45787,
    "volume_usd": 1181203.24,
    "currency": "BNB",
    "time_window_seconds": 86400
  },
  "meta": {
    "request_id": "req_a26a1dc49399",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2026-06-02T19:12:43Z"
  }
}