Token Transactions

Every on-chain buy and sell that tracked smart money, KOL and whale wallets made for a single token on Solana, BNB Chain, Base and Ethereum — newest first, with each wallet's profile and its balance (incl. all-time peaks) after the trade.

Track KOL & Smart Money Token Transactions (Buys & Sells)

get

Get every on-chain buy and sell that tracked smart money, KOL and whale wallets made for one token on Solana, BNB Chain, Base or Ethereum — newest first. Each transaction carries the wallet profile and holdings_after (the wallet's balance for this token after the trade, including all-time peaks that survive a full sell-off), making it easy to follow smart-money entries and exits and to power copy-trading signals. Mint and token name are returned once in the top-level token block and are not repeated per transaction.

Data source — the full transaction history from the database (no 30-day cap) merged with the newest live transactions, deduplicated by signature. Peaks are computed by chronological replay, so a wallet that already sold everything still shows token_amount: 0 together with a non-zero token_amount_peak. Historical USD values come straight from each transaction; very old transactions without a stored USD value stay null.

Parameters / settings

• blockchain (required) — one of: solana, bnb, base, eth

• mint (required) — token mint / contract address

• type (optional) — kol, smart, or whale; if omitted, all valid wallet types for the chain are merged

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

• api_key (optional if the Bearer header is used)

Authorizations

bearerAuthapiKeyQuery

AuthorizationstringRequired

Authorization: Bearer YOUR_KEY

Query parameters

blockchainstring · enumRequiredExample: bnbPossible values:

mintstringRequiredExample: 0x23a49ea152d14fe4bc41b71345b7da6687de4444

typestring · enumOptionalExample: kolPossible values:

limitinteger · min: 1OptionalDefault: 50Example: 50

api_keystringOptionalExample: YOUR_KEY

Responses

200

Token found — returns the token block and its transactions.

application/json

successbooleanOptional

metaobjectOptional

paginationobjectOptional

400

Missing or invalid parameter (e.g. mint 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/tokens/transactions

HTTPcURLJavaScriptPython

GET /v1/tokens/transactions?blockchain=solana&mint=text HTTP/1.1
Host: api.cabalspy.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "data": {
    "token": {
      "mint": "0x23a49ea152d14fe4bc41b71345b7da6687de4444",
      "token_name": "Groot",
      "blockchain": "bnb",
      "currency": "BNB",
      "token_supply": 1000000000,
      "token_decimals": 18
    },
    "transactions": [
      {
        "tx_signature": "0x9be1efe75a915f7f1979e4ff0b8359e9ef30a039589d6faf77bdc0bbdb138b42",
        "transaction_type": "sell",
        "value": 0.114398,
        "value_usd": 75.683552,
        "currency": "BNB",
        "token_amount": 17077627.093561362,
        "price_per_token": 6.699e-9,
        "price_per_token_usd": 0.000004431737,
        "created_at": "2026-06-02T19:11:06.473Z",
        "profile": {
          "wallet_address": "0x39dca9c3c5daca0b453fd27c027a0cd0347ff7cb",
          "name": "IconXBT",
          "image_url": "https://cabalspy.xyz/images/n-Twwg0T_400x400.jpg",
          "twitter": "https://x.com/iconXBT",
          "telegram": "",
          "copytrade_link": "https://t.me/maestro?start=r-tokiogaijin",
          "type": "kol",
          "blockchain": "bnb",
          "currency": "BNB"
        },
        "holdings_after": {
          "token_amount": 0,
          "token_amount_peak": 17077627.093561,
          "supply_pct": 0,
          "supply_pct_peak": 1.707763,
          "bag_pct": 0,
          "still_holding": false
        }
      },
      {
        "tx_signature": "0x6af8d3709080f0004d66d36f3b88eb120562ec8102ff7b34a9bbb05a15399704",
        "transaction_type": "buy",
        "value": 0.011346,
        "value_usd": 7.501658,
        "currency": "BNB",
        "token_amount": 1373912.813676077,
        "price_per_token": 8.258e-9,
        "price_per_token_usd": 0.000005460068,
        "created_at": "2026-06-02T19:10:10.548Z",
        "profile": {
          "wallet_address": "0x39dca9c3c5daca0b453fd27c027a0cd0347ff7cb",
          "name": "IconXBT",
          "image_url": "https://cabalspy.xyz/images/n-Twwg0T_400x400.jpg",
          "twitter": "https://x.com/iconXBT",
          "telegram": "",
          "copytrade_link": "https://t.me/maestro?start=r-tokiogaijin",
          "type": "kol",
          "blockchain": "bnb",
          "currency": "BNB"
        },
        "holdings_after": {
          "token_amount": 1373912.813676,
          "token_amount_peak": 17077627.093561,
          "supply_pct": 0.137391,
          "supply_pct_peak": 1.707763,
          "bag_pct": 8.0451,
          "still_holding": true
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_3f1a9c22d0e1",
    "cached": true,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2026-06-02T19:12:43Z"
  },
  "pagination": {
    "limit": 50,
    "total": 2,
    "has_more": false,
    "next_cursor": null
  }
}