> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cabalspy.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# KOL Supply Holding

> Show how much of a token supply tracked wallets hold, updating live from the trade stream. Endpoints, chains, first steps and a cookbook.

Show how much of a token supply the tracked wallets hold, updating live as they trade. It answers how much of this token is in smart hands, a concentration signal traders watch.

## What it shows

The combined percent of supply held by tracked wallets, and how it moves as they buy and sell. A high or rising number means the token is concentrating in wallets you follow. Because it updates from the live trade stream, the number moves in real time rather than on a refresh.

## Blockchains

Solana, BNB, Base, ETH and Robinhood.

## Endpoints

The transactions stream pushes the trades you aggregate into the held supply.

<Card title="WSS transactions stream" href="https://docs.cabalspy.xyz/transactions-1">
  Live buy and sell events at wss\://stream.cabalspy.xyz, aggregated into held supply.
</Card>

## First steps

<Steps>
  <Step title="Get an API key">
    Register at [apidashboard.cabalspy.xyz](https://apidashboard.cabalspy.xyz) and create a key.
  </Step>

  <Step title="Pick a token">
    You need the token mint you want to measure.
  </Step>

  <Step title="Subscribe and aggregate">
    Open the transactions stream, subscribe to the mint, and keep a running total of how much supply the tracked wallets hold as trades arrive.
  </Step>
</Steps>

```javascript Subscribe theme={null}
const ws = new WebSocket("wss://stream.cabalspy.xyz?apiKey=YOUR_KEY");
ws.onopen = () => ws.send(JSON.stringify({
  op: "subscribe", stream: "transactions", blockchain: "solana", token: "YOUR_MINT",
}));
```

## Build it

<Card title="Cookbook, Supply Holding" href="https://docs.cabalspy.xyz/build-a-supply-and-bag-holdings-badge">
  Aggregate held supply, per wallet and combined, step by step.
</Card>