KOL Wallet Count — a live KOL badge for
every token

What it shows

The KOL wallet count is the number of distinct tracked KOL wallets holding a token. Shown as a badge in a token list or on a token page, it works as an activity indicator: a rising count means more KOLs are entering the token.

Two related numbers are available over REST. The transactions count returns how many trades tracked wallets of one type (kol, smart or whale) made in a time window of up to 24 hours. The token holders endpoint returns a total_holders block with kol_count, smart_count, whale_count and still_holding_count for one token.

How it works

For a live badge, open the WebSocket and subscribe to the count stream with a chain and a token: "*" for every token or one mint or contract address. Each time a tracked KOL wallet buys, you receive a wallet_count event with mint and kol_count. The stream is not split by wallet type; it always reports the KOL wallet count. One connection can feed a whole token list: keep the latest count per mint and update the matching badge.

For a number on demand, call GET /v1/transactions/count with blockchain, type and a window built from seconds, minutes and hours, optionally filtered to one token with mint. It returns only the count, not the transactions. Note the difference: this endpoint counts trades in the window, while the stream counts distinct KOL wallets holding the token.

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:

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

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

ws.onmessage = (e) => {
  const msg = JSON.parse(e.data);
  if (msg.event === "wallet_count") {
    console.log(msg.data.mint, "kol count", msg.data.kol_count);
  }
};

curl "https://api.cabalspy.xyz/v1/transactions/count?blockchain=solana&type=kol&hours=1&api_key=YOUR_KEY"

const p = new URLSearchParams({
  blockchain: "solana", type: "kol", hours: "1", api_key: "YOUR_KEY",
});
const res = await fetch(`https://api.cabalspy.xyz/v1/transactions/count?${p}`);
const { data } = await res.json();
console.log("count", data.count);

Who builds this

• Trading terminals — a “5 KOLs” badge on every row of a token list or pulse page
• Token pages and screeners — a heat indicator that ticks up as KOLs enter
• Bots and agents — a cheap trigger before pulling heavier holder or signal data
• Dashboards — activity sparklines from trade counts over the last minutes or hours

Go deeper

Related use cases