KOL Holders Table — who is in the bag,
live

What it shows

A table of the tracked wallets holding a token and how they are doing. Each row carries the wallet’s profile and its position: tokens held, percent of supply, bag percentage (how much of the peak holding is still held), invested and remaining value, realized and unrealized PnL, and the market cap at which the wallet first entered.

In the full version each row also shows the wallet’s native balance and whether it entered through a coordinated bundle. That is the holders tab known from terminals like Axiom: who is in the token, how large the wallet is, and who is up or down on the position.

How it works

For a live table, subscribe to the holder stream with the token address. You first receive an init event with a snapshot of every tracked holder, then holder_update when a holder trades and position_update when the market cap moves and the unrealized numbers change. Positions are computed server side, so you replace a holder’s position with the latest one instead of adding up trades.

Use mode to control message volume: full sends trades plus price-driven updates, events sends only real trades. In full mode, mc_interval (1 to 30 seconds) limits price updates to one per token per window. To add wallet size and bundle flags, subscribe to the balance and bundle streams on the same connection and merge the events into rows keyed by wallet address. For a one-off snapshot, the REST holders endpoint returns the holders ranked by amount held.

Supported chains: The holder and balance streams and the REST holders endpoint cover Solana, BNB Chain, Base, Ethereum and Robinhood Chain. The full table that merges holder, balance and bundle data is Solana only, because bundle detection is Solana based; unrealized PnL, remaining value and entry market cap are also Solana-only fields and null on other chains.

Quick start

Get a free key from the API dashboard (10,000 credits per month, no credit card), then:

const ws = new WebSocket("wss://stream.cabalspy.xyz?apiKey=YOUR_KEY");

ws.onopen = () => {
  ws.send(JSON.stringify({
    op: "subscribe", stream: "holder", blockchain: "solana",
    token: "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
    wallet_types: ["kol", "smart", "whale"], mode: "full",
  }));
};

ws.onmessage = (e) => {
  const msg = JSON.parse(e.data);
  if (msg.event === "init") {
    console.log("holders", msg.data.holder_count);
  } else if (msg.event === "holder_update") {
    const h = msg.data.holder;
    console.log(h.profile.name, h.position.bag_pct, h.position.unrealized_pnl_usd);
  }
};

{
  "op": "subscribe",
  "stream": "holder",
  "blockchain": "solana",
  "token": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
  "mode": "full",
  "mc_interval": 5
}

curl "https://api.cabalspy.xyz/v1/tokens/holders?blockchain=solana&mint=3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump&limit=50&api_key=YOUR_KEY"

Who builds this

• Trading terminals — the holders tab on every token page, updating without polling
• Token screeners — a column showing which KOLs and Smart Money wallets are still in
• Copy-trading apps — see whether the wallets you follow are holding or have sold
• Telegram and Discord bots — a holders command that lists KOL positions for a token

Go deeper

Related use cases