KOL Bundle Detection — see the side wallets
behind a KOL

What it shows

A bundle is a KOL wallet and the side wallets that bought together with it in the same block. KOL bundle detection returns, per token, each detected bundle with the KOL at its center (kol_wallet, kol_profile), the number of wallets, a confidence value, whether it was confirmed as a Jito bundle (jito_confirmed), the proof_type, the Solana slot, a proof reference and a verify_hint for checking it on chain yourself.

Every wallet in the bundle carries a live position: tokens held, bag percentage, supply percentage, amount invested, realized and unrealized PnL, remaining value and entry market cap. Side wallets also carry proof fields such as adjacent_to_kol, same_fee, block_index and occurrences, the number of times that wallet has bundled with the KOL.

How it works

For a snapshot, call GET /v1/bundle with blockchain=solana and the token mint. Positions are computed live at request time. If no bundles are detected you get a normal 200 with an empty bundles array and the token block, so the endpoint is safe to poll.

For live detections, subscribe to the bundle stream with a token mint, or "*" for every tracked token. A single mint returns an init snapshot of its current bundles, followed by kol_bundle events as bundles are detected and wallets trade. mode: "full" (the default) also sends position updates whenever the market cap moves, which you can throttle with mc_interval (1 to 30 seconds); mode: "events" sends only detection and trade events and uses the fewest credits.

Supported chains: Solana only.

Quick start

Get a free key from the API dashboard (10,000 credits per month, no credit card), then:

curl "https://api.cabalspy.xyz/v1/bundle?blockchain=solana&mint=3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump&api_key=YOUR_KEY"

const p = new URLSearchParams({
  blockchain: "solana",
  mint: "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
  api_key: "YOUR_KEY",
});
const res = await fetch(`https://api.cabalspy.xyz/v1/bundle?${p}`);
const { data } = await res.json();
data.bundles.forEach(b => console.log(b.kol_wallet, b.confidence, b.wallet_count));

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

ws.onopen = () => {
  ws.send(JSON.stringify({
    op: "subscribe", stream: "bundle",
    token: "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump", mode: "full",
  }));
};

ws.onmessage = (e) => {
  const msg = JSON.parse(e.data);
  if (msg.event === "init" || msg.event === "kol_bundle") {
    msg.data.bundles.forEach(b => console.log(b.kol_wallet, "wallets", b.wallet_count));
  }
};

Who builds this

• Trading terminals — a bundle breakdown on the token page and bundle flags in the holder table
• Alpha and alert bots — a notification when a KOL buys together with side wallets
• Risk tools — flag tokens where a KOL’s visible position is only part of the real one
• Analysts — see which side wallets repeatedly bundle with the same KOL

Go deeper

Related use cases