Real-Time Holding Table - CabalSpy Use Case

A live table of everyone holding a token, updating as they trade and as the market cap moves. Each holder shows their position, bag percentage, unrealized PnL, native balance, and whether they entered through a coordinated bundle. This is the full Axiom style holders tab.

What it shows

Who holds the token and how they are doing, live. It merges three streams, the holder position, the wallet native balance, and bundle detection, into one row per wallet, so you see the position, the wallet size and the bundle flag together.

Blockchains

Solana only. The holder position uses live market cap, the balance is native SOL, and bundle detection is Solana based.

Endpoints

Three streams, merged into one table keyed by wallet.

WSS holder stream

Positions, bag percentage and unrealized PnL. This stream owns which rows exist.

WSS balance stream

Native SOL balance per wallet.

WSS bundle stream

Flags the wallets that entered through a coordinated bundle.

First steps

Get an API key

Pick a Solana token

You need the token mint. This feature is Solana only.

Subscribe to all three streams

Open one WebSocket, subscribe to the holder, balance and bundle streams for the token, and merge each event into a row keyed by wallet address.

Subscribe to all three

const ws = new WebSocket("wss://stream.cabalspy.xyz?apiKey=YOUR_KEY");
ws.onopen = () => {
  ws.send(JSON.stringify({ op: "subscribe", stream: "holder", token: "YOUR_MINT", mode: "full" }));
  ws.send(JSON.stringify({ op: "subscribe", stream: "balance", wallet: "*" }));
  ws.send(JSON.stringify({ op: "subscribe", stream: "bundle", token: "YOUR_MINT", mode: "full" }));
};

Overview

Getting started

Use cases

KOL Real-Time Holding Table

What it shows

Blockchains

Endpoints

WSS holder stream

WSS balance stream

WSS bundle stream

First steps

Build it

Cookbook, Holder Table (Advanced)

GitHub demo

​What it shows

​Blockchains

​Endpoints

WSS holder stream

WSS balance stream

WSS bundle stream

​First steps

​Build it

Cookbook, Holder Table (Advanced)

GitHub demo

What it shows

Blockchains

Endpoints

First steps

Build it