KOL Supply Holding — how much is in
smart hands

What it shows

KOL supply holding answers how much of a token sits with wallets you follow. Each tracked holder has a supply_pct (percent of supply currently held) and a bag_pct (percent of its peak holding still held). Summing supply_pct across holders gives the share of supply in tracked hands, which you can split by wallet type: KOL, Smart Money and Whale.

A high or rising total means the token is concentrating in tracked wallets. The bag percentage shows the other side: a wallet whose supply_pct_peak is far above its current supply_pct has been selling.

How it works

Start with a snapshot: GET /v1/tokens/holders with blockchain and mint returns every tracked holder of the token, sorted by amount held, each with holdings.supply_pct, supply_pct_peak and bag_pct, plus a total_holders count by type. One pass over the list gives the combined total, the breakdown by wallet type and a per-wallet ranking.

To keep it live, subscribe to the transactions stream (stream: "tx") for the token. Every buy or sell delivers a position_update event whose position block contains supply_pct, bag_pct, the previous values and the deltas (delta_supply_pct, delta_bag_pct). Update the wallet’s entry and re-sum. The holder stream carries the same supply_pct per holder if you prefer full holder updates.

Supported chains: Solana, BNB Chain, Base, Ethereum and Robinhood Chain (blockchain values solana, bnb, base, eth and rh). Solana has KOL, Smart Money and Whale wallets; BNB Chain, Base and Robinhood Chain have KOL and Smart Money; Ethereum has KOL wallets.

Quick start

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

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

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

ws.onopen = () => {
  ws.send(JSON.stringify({
    op: "subscribe", stream: "tx", blockchain: "solana", type: "kol", token: "*",
  }));
};

ws.onmessage = (e) => {
  const msg = JSON.parse(e.data);
  if (msg.event === "position_update") {
    const d = msg.data;
    console.log(d.profile.name, d.transaction.action, d.token.symbol, d.position.bag_pct);
  }
};

Who builds this

• Trading terminals — a “12.4% held by KOLs” badge on the token page
• Token screeners — filter or sort tokens by supply concentration in tracked wallets
• Risk and alert bots — warn when a large holder’s bag percentage drops
• Analysts — compare KOL, Smart Money and Whale shares of a token’s supply

Go deeper

Related use cases