Holder

Live positions of tracked KOL, smart-money and whale wallets in a single Solana token — bought, sold, held, unrealized PnL and remaining value — seeded from history on subscribe and updated live.

Holder — Live Tracked-Wallet Positions per Token (WebSocket)

get

Subscribe to one Solana token and receive an init snapshot of all tracked holders, then live holder_update (a wallet traded) and position_update (market cap moved) messages.

• blockchain (required) — must be solana.

• token (required) — a mint to watch one token, or * for all tokens live (no snapshot).

• wallet_types (optional) — any subset of kol, smart, whale; defaults to all three.

Authorizations

bearerAuthapiKeyQuery

AuthorizationstringRequired

Authorization: Bearer YOUR_KEY

Body

application/json

Client -> server. Subscribe to a token's tracked holders; filters persist until unsubscribe.

opstring · enumRequiredExample: subscribePossible values:

streamstring · enumRequiredExample: holderPossible values:

blockchainstring · enumOptional

Must be solana.

Possible values:

tokenstringRequired

A mint to watch one token, or "*" for all tokens (live only, no snapshot).

Example: 2yeMv8fRYmLTmCDJJsdF7sNBFuPP2BunRkKRpUQbpump

channelstring · nullableOptional

Alternative to blockchain+token: holder.solana. or holder.solana for all.

Responses

200

init, holder_update and position_update messages. (The connection also delivers a connected welcome, a subscribed ack per subscribe, and error messages — see schemas.)

application/json

One holder message — init snapshot, holder_update, or position_update.

successbooleanOptionalExample: true

channelstringOptionalExample: holder.solana

eventstring · enumOptionalPossible values:

get/holder

HTTPcURLJavaScriptPython

GET /holder HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 152

{
  "op": "subscribe",
  "stream": "holder",
  "blockchain": "solana",
  "token": "2yeMv8fRYmLTmCDJJsdF7sNBFuPP2BunRkKRpUQbpump",
  "wallet_types": [
    "kol",
    "smart",
    "whale"
  ]
}

One token, all wallet typesOne token, KOLs onlyAll tokens, live only (no snapshot)Channel shorthand

200

init, holder_update and position_update messages. (The connection also delivers a connected welcome, a subscribed ack per subscribe, and error messages — see schemas.)

{
  "success": true,
  "channel": "holder.solana",
  "event": "init",
  "data": {
    "blockchain": "solana",
    "mint": "2yeMv8fRYmLTmCDJJsdF7sNBFuPP2BunRkKRpUQbpump",
    "wallet_types": [
      "kol",
      "smart",
      "whale"
    ],
    "holder_count": 2,
    "token": {
      "mint": "2yeMv8fRYmLTmCDJJsdF7sNBFuPP2BunRkKRpUQbpump",
      "symbol": "EXMPL",
      "name": "Example",
      "supply": 1000000000,
      "decimals": 6,
      "market_cap": 2744,
      "market_cap_usd": 221500,
      "market_cap_currency": "SOL",
      "price": 0.000002744,
      "price_usd": 0.0002215,
      "sol_price_usd": 80.73,
      "pool": "pump-amm",
      "on_curve": false,
      "bonding_curve_progress": 100
    },
    "holders": [
      {
        "wallet": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
        "wallet_type": "kol",
        "win_rate": 62.5,
        "profile": {
          "name": "Loopierr",
          "image_url": "https://cabalspy.xyz/images/7xKX.png",
          "twitter": "https://x.com/loopierr",
          "telegram": "",
          "blockchain": "solana",
          "currency": "SOL",
          "type": "kol",
          "active_hours": null
        },
        "position": {
          "held": 18200000,
          "peak": 18200000,
          "bought_tokens": 18200000,
          "sold_tokens": 0,
          "bag_pct": 100,
          "supply_pct": 1.82,
          "invested": 50.79,
          "invested_usd": 4100,
          "max_single_buy": 30,
          "buy_txn": 2,
          "sell_txn": 0,
          "sold_value": 0,
          "sold_value_usd": 0,
          "sold": false,
          "realized_pnl_sol": -50.79,
          "realized_pnl_usd": -4100,
          "entry_market_cap": 2404,
          "entry_market_cap_usd": 194100,
          "unrealized_pnl_sol": -0.77,
          "unrealized_pnl_usd": -62,
          "unrealized_pnl_pct": -1.51,
          "remaining_sol": 50.02,
          "remaining_usd": 4038,
          "first_buy_at": "2026-07-02T15:20:00.000Z",
          "last_activity_at": "2026-07-02T15:24:00.000Z"
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_ab12cd34",
    "version": "2.0.0",
    "timestamp": "2026-07-02T15:24:01.000Z"
  }
}