> ## 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 Signal Service

> Surface tokens where several tracked wallets buy together, and stream live entry and exit alerts. Endpoints, chains, first steps and a cookbook.

Surface tokens where several tracked wallets are buying at once, a cluster, and stream live entry and exit alerts as they form. It is the engine behind an alerts feed, a Telegram bot or a trading agent.

## What it shows

Coordinated buying. When a group of KOLs or Smart Money wallets pile into the same token inside a short window, that is a cluster, and it is a strong early signal. You set the rules, how many wallets, what win rate, which types, and the service tells you the moment they are met.

## Blockchains

The core cluster and entry logic runs on Solana, BNB, Base, ETH and Robinhood. The live market cap attached to a signal is Solana only.

## Endpoints

Get signals live as they form, or as a snapshot on a schedule.

<CardGroup cols={2}>
  <Card title="WSS signal stream" href="https://docs.cabalspy.xyz/signal">
    Live entry and exit signals with your own per type thresholds.
  </Card>

  <Card title="GET /v1/signals" href="https://docs.cabalspy.xyz/signals">
    A snapshot of current clusters, with cluster, entry and exit modes.
  </Card>
</CardGroup>

## 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="Decide your rules">
    Choose how many wallets make a cluster, an optional minimum win rate, and which wallet types must agree.
  </Step>

  <Step title="Subscribe or poll">
    Open the signal stream with your thresholds for live alerts, or poll the signals endpoint in cluster mode for a snapshot.
  </Step>
</Steps>

```bash Quick test, cluster snapshot theme={null}
curl "https://api.cabalspy.xyz/v1/signals?blockchain=solana&type=kol&mode=cluster&min_wallets=3&hours=6&api_key=YOUR_KEY"
```

## Build it

<Card title="Cookbook, Signal Service" href="https://docs.cabalspy.xyz/build-a-signal-for-wallet-cluster-buying">
  Build cluster scanning and live alerts step by step.
</Card>