Transactions by Time Range

All buys and sells from tracked smart money, KOL and whale wallets within a time window on Solana, BNB Chain, Base and Ethereum — each with the wallet profile and its balance (incl. all-time peaks) after the trade.

Token Transactions by Time Range — Smart Money & KOL Buys and Sells

get

Returns every transaction 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 — newest first. Each transaction carries the full token detail, the wallet profile and holdings_after (balance after the trade, including all-time peaks that survive a full sell-off). Add &mint= to restrict to a single token; the response then also includes a top-level token block.

Time window — set seconds and/or minutes; they add up. The window is capped at 60 minutes. If you request more, results are capped and a note is added to the warnings array (data is still returned). The applied window is echoed back as time_window_seconds.

Data source — transactions come straight from the per-chain, per-type live trade index (sorted by timestamp). Per-trade holdings_after is sourced from the token holder cache (chronological replay from the database), so all-time peaks are preserved even after a wallet sells out. Historical USD comes from each trade; a very old trade without a stored USD value falls 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 (optional) — time window, capped at 60 minutes

• mint (optional) — restrict to one token mint / contract address

• limit (optional, default 50) — maximum number of transactions returned

• api_key (optional if the Bearer header is used)

Authorizations

AuthorizationstringRequired

Authorization: Bearer YOUR_KEY

Query parameters

blockchainstring · enumRequiredExample: bnbPossible values:

typestring · enumRequiredExample: kolPossible values:

minutesintegerOptionalExample: 15

secondsintegerOptionalExample: 0

mintstringOptionalExample: 0x23a49ea152d14fe4bc41b71345b7da6687de4444

limitinteger · min: 1OptionalDefault: 50Example: 50

api_keystringOptionalExample: YOUR_KEY

Responses

200

Returns all transactions within the requested time window.

application/json

successbooleanOptional

metaobjectOptional

paginationobjectOptional

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/timerange

GET /v1/transactions/timerange?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": "timerange",
    "currency": "BNB",
    "time_window_seconds": 900,
    "count": 1,
    "transactions": [
      {
        "tx_signature": "0x85ca7da461aa1636498b7fbb961a2bc9ded4bb100e4931273b8e234c67e1452e",
        "mint": "0x1671ba8c2526ffdf90c33241db97967cb4f34444",
        "token_name": "宇宙所",
        "token_supply": 1000000000,
        "token_decimals": 18,
        "transaction_type": "buy",
        "value": 0.033351,
        "value_usd": 22.050754,
        "currency": "BNB",
        "token_amount": 156709.23407784244,
        "price_per_token": 2.12822e-7,
        "price_per_token_usd": 0.000140711261,
        "created_at": "2026-06-02T19:10:17.661Z",
        "profile": {
          "wallet_address": "0xd171ebe9d3c1e55d918563107b0b7782948dd52c",
          "name": "YYYzzy",
          "image_url": "https://cabalspy.xyz/images/NzRDhfLz_400x400.jpg",
          "twitter": "https://x.com/YYzzy_diamond",
          "telegram": "",
          "copytrade_link": "https://t.me/maestro?start=r-tokiogaijin",
          "type": "kol",
          "blockchain": "bnb",
          "currency": "BNB"
        },
        "holdings_after": {
          "token_amount": 2281698.642548,
          "token_amount_peak": 15411989.727134,
          "supply_pct": 0.22817,
          "supply_pct_peak": 1.541199,
          "bag_pct": 14.8047,
          "still_holding": true
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_6dc48f125be2",
    "cached": false,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2026-06-02T19:12:43Z"
  },
  "pagination": {
    "limit": 50,
    "total": 1,
    "has_more": false,
    "next_cursor": null
  }
}