Token Holders

Every smart money, KOL and whale wallet that ever held a single token on Solana, BNB Chain, Base and Ethereum — including wallets that already sold, with current balance, all-time peak and a still-holding flag, sorted by amount held.

Token Holders — KOL & Smart Money Wallets Holding a Token

get

Get every tracked smart money, KOL and whale wallet that ever held one token on Solana, BNB Chain, Base or Ethereum — including wallets that already sold their entire position. Sold-out wallets are recognisable by still_holding: false and token_amount: 0, but keep their all-time peak, so you can analyse who is still holding versus who has exited. Ideal for token holder analysis and smart-money tracking.

Sorting — descending by current amount held (token_amount), then by all-time peak (token_amount_peak). Wallets still holding appear first, followed by those that have exited.

holders vs. stats — this is the pure holder view: per wallet a profile and holdings. Per-wallet trading metrics (buy/sell, PnL) are served by GET /v1/tokens/stats (traders[]); individual transactions by GET /v1/tokens/transactions.

Data source — full history from the database (no 30-day cap) merged with the newest live transactions, deduplicated by signature. Peaks are computed by chronological replay and survive a full sell-off — this even survives an in-memory flush because it is recomputed from the database.

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 holders 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 holder counts and the holder list.

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

HTTPcURLJavaScriptPython

GET /v1/tokens/holders?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
    },
    "total_holders": {
      "kol_count": 2,
      "smart_count": 0,
      "whale_count": 0,
      "still_holding_count": 1
    },
    "holders": [
      {
        "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": {
          "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
        }
      },
      {
        "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": {
          "token_amount": 0,
          "token_amount_peak": 17077627.093561,
          "supply_pct": 0,
          "supply_pct_peak": 1.707763,
          "bag_pct": 0,
          "still_holding": false
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_b51d8e9a07c4",
    "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
  }
}