> ## 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 Chart Events

> Drop live buy and sell bubbles onto a price chart at the moment a KOL trades. Endpoints, chains, first steps and a reference.

Drop a small bubble onto a price chart at the exact moment a KOL buys or sells. Green for a buy, red for a sell, placed on the candle where it happened. It turns a plain chart into a live map of smart money activity.

## What it shows

When KOLs enter and exit, right on the chart. A trader can read a buy bubble as a possible entry and a sell bubble as an exit, or study the pattern to understand how KOLs time their trades. It is one of the most intuitive ways to show wallet activity, because it sits on the chart people already watch.

## Blockchains

Solana, BNB, Base, ETH and Robinhood.

## Endpoints

The transactions stream pushes each buy and sell as it happens, with the value and time to place the bubble.

<Card title="WSS transactions stream" href="https://docs.cabalspy.xyz/transactions-1">
  Live buy and sell events per token, with the trade value and timestamp.
</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="Have a chart ready">
    You need a chart you can add markers to, for example TradingView Lightweight Charts or the full Charting Library.
  </Step>

  <Step title="Subscribe to the token">
    Open the transactions stream, subscribe to the token mint, and for each trade add a marker at its timestamp, green for a buy and red for a sell.
  </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="Reference, transactions stream" href="https://docs.cabalspy.xyz/transactions-1">
  Full field-by-field reference for the buy and sell events.
</Card>