Bundle Snapshot
curl --request GET \
--url https://demo-api.cabalspy.xyz/v1/bundleimport requests
url = "https://demo-api.cabalspy.xyz/v1/bundle"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://demo-api.cabalspy.xyz/v1/bundle', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://demo-api.cabalspy.xyz/v1/bundle",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://demo-api.cabalspy.xyz/v1/bundle"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://demo-api.cabalspy.xyz/v1/bundle")
.asString();require 'uri'
require 'net/http'
url = URI("https://demo-api.cabalspy.xyz/v1/bundle")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"blockchain": "solana",
"token": {
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"symbol": "invisibull",
"name": "invisibull",
"supply": 1000000000,
"market_cap": 40.08,
"market_cap_usd": 3301.2,
"market_cap_currency": "SOL",
"price": 4.008e-8,
"price_usd": 3.3e-6,
"sol_price_usd": 82.36,
"pool": "pump",
"on_curve": true,
"bonding_curve_progress": 42.5
},
"bundles": [
{
"bundle_id": "bnd_7f3a2c",
"kol_wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"kol_profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"confidence": 0.92,
"jito_confirmed": true,
"proof_type": "same_block",
"slot": 301948220,
"wallet_count": 3,
"proof": "slot:301948220",
"verify_hint": "check same slot buys on solscan",
"detected_at": "2026-07-04T16:25:34Z",
"bundle_wallets": [
{
"address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"is_kol": true,
"transaction_type": "buy",
"signature": "5xr8abc...",
"entry_source": "at_discovery",
"position_source": "live",
"profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"position": {
"held": 22113972.03,
"peak": 22113972.03,
"bought_tokens": 22113972.03,
"sold_tokens": 0.0,
"bag_pct": 100.0,
"supply_pct": 2.21,
"invested": 1.66,
"invested_usd": 137.44,
"max_single_buy": 1.66,
"buy_txn": 1,
"sell_txn": 0,
"sold_value": 0.0,
"sold_value_usd": 0.0,
"realized_pnl_sol": 0.0,
"realized_pnl_usd": 0.0,
"entry_market_cap": 44.6,
"entry_market_cap_usd": 3673.2,
"unrealized_pnl_sol": -0.099817,
"unrealized_pnl_usd": -8.22,
"unrealized_pnl_pct": -10.12,
"remaining_sol": 0.886537,
"remaining_usd": 73.02,
"first_buy_at": "2026-07-04T16:25:34Z",
"last_activity_at": "2026-07-04T16:40:10Z"
}
},
{
"address": "SideWa11etAbc123...",
"is_kol": false,
"transaction_type": "buy",
"signature": "9kp2def...",
"entry_source": "at_discovery",
"position_source": "live",
"profile": {
"name": "",
"image_url": "",
"twitter": "",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": null
},
"fee_lamports": 5000,
"block_index": 4,
"adjacent_to_kol": true,
"same_fee": true,
"occurrences": 7,
"position": {
"held": 8000000.0,
"peak": 8000000.0,
"bought_tokens": 8000000.0,
"sold_tokens": 0.0,
"bag_pct": 100.0,
"supply_pct": 0.8,
"invested": 0.6,
"invested_usd": 49.4,
"max_single_buy": 0.6,
"buy_txn": 1,
"sell_txn": 0,
"sold_value": 0.0,
"sold_value_usd": 0.0,
"realized_pnl_sol": 0.0,
"realized_pnl_usd": 0.0,
"entry_market_cap": 44.6,
"entry_market_cap_usd": 3673.2,
"unrealized_pnl_sol": -0.036,
"unrealized_pnl_usd": -2.97,
"unrealized_pnl_pct": -10.12,
"remaining_sol": 0.320,
"remaining_usd": 26.4,
"first_buy_at": "2026-07-04T16:25:34Z",
"last_activity_at": "2026-07-04T16:25:34Z"
}
}
]
}
]
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": false,
"cache_age_seconds": 0,
"version": "1.0.0",
"timestamp": "2026-07-06T11:01:57Z"
}
}
Bundle
Bundle Snapshot
Detect coordinated KOL bundles on a Solana token, the side wallets that buy alongside a KOL in the same block, with proof and live positions.
GET
/
v1
/
bundle
Bundle Snapshot
curl --request GET \
--url https://demo-api.cabalspy.xyz/v1/bundleimport requests
url = "https://demo-api.cabalspy.xyz/v1/bundle"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://demo-api.cabalspy.xyz/v1/bundle', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://demo-api.cabalspy.xyz/v1/bundle",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://demo-api.cabalspy.xyz/v1/bundle"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://demo-api.cabalspy.xyz/v1/bundle")
.asString();require 'uri'
require 'net/http'
url = URI("https://demo-api.cabalspy.xyz/v1/bundle")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"blockchain": "solana",
"token": {
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"symbol": "invisibull",
"name": "invisibull",
"supply": 1000000000,
"market_cap": 40.08,
"market_cap_usd": 3301.2,
"market_cap_currency": "SOL",
"price": 4.008e-8,
"price_usd": 3.3e-6,
"sol_price_usd": 82.36,
"pool": "pump",
"on_curve": true,
"bonding_curve_progress": 42.5
},
"bundles": [
{
"bundle_id": "bnd_7f3a2c",
"kol_wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"kol_profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"confidence": 0.92,
"jito_confirmed": true,
"proof_type": "same_block",
"slot": 301948220,
"wallet_count": 3,
"proof": "slot:301948220",
"verify_hint": "check same slot buys on solscan",
"detected_at": "2026-07-04T16:25:34Z",
"bundle_wallets": [
{
"address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"is_kol": true,
"transaction_type": "buy",
"signature": "5xr8abc...",
"entry_source": "at_discovery",
"position_source": "live",
"profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"position": {
"held": 22113972.03,
"peak": 22113972.03,
"bought_tokens": 22113972.03,
"sold_tokens": 0.0,
"bag_pct": 100.0,
"supply_pct": 2.21,
"invested": 1.66,
"invested_usd": 137.44,
"max_single_buy": 1.66,
"buy_txn": 1,
"sell_txn": 0,
"sold_value": 0.0,
"sold_value_usd": 0.0,
"realized_pnl_sol": 0.0,
"realized_pnl_usd": 0.0,
"entry_market_cap": 44.6,
"entry_market_cap_usd": 3673.2,
"unrealized_pnl_sol": -0.099817,
"unrealized_pnl_usd": -8.22,
"unrealized_pnl_pct": -10.12,
"remaining_sol": 0.886537,
"remaining_usd": 73.02,
"first_buy_at": "2026-07-04T16:25:34Z",
"last_activity_at": "2026-07-04T16:40:10Z"
}
},
{
"address": "SideWa11etAbc123...",
"is_kol": false,
"transaction_type": "buy",
"signature": "9kp2def...",
"entry_source": "at_discovery",
"position_source": "live",
"profile": {
"name": "",
"image_url": "",
"twitter": "",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": null
},
"fee_lamports": 5000,
"block_index": 4,
"adjacent_to_kol": true,
"same_fee": true,
"occurrences": 7,
"position": {
"held": 8000000.0,
"peak": 8000000.0,
"bought_tokens": 8000000.0,
"sold_tokens": 0.0,
"bag_pct": 100.0,
"supply_pct": 0.8,
"invested": 0.6,
"invested_usd": 49.4,
"max_single_buy": 0.6,
"buy_txn": 1,
"sell_txn": 0,
"sold_value": 0.0,
"sold_value_usd": 0.0,
"realized_pnl_sol": 0.0,
"realized_pnl_usd": 0.0,
"entry_market_cap": 44.6,
"entry_market_cap_usd": 3673.2,
"unrealized_pnl_sol": -0.036,
"unrealized_pnl_usd": -2.97,
"unrealized_pnl_pct": -10.12,
"remaining_sol": 0.320,
"remaining_usd": 26.4,
"first_buy_at": "2026-07-04T16:25:34Z",
"last_activity_at": "2026-07-04T16:25:34Z"
}
}
]
}
]
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": false,
"cache_age_seconds": 0,
"version": "1.0.0",
"timestamp": "2026-07-06T11:01:57Z"
}
}
Detect coordinated bundles on a Solana token. A bundle is a KOL wallet plus the side wallets that bought alongside it in the same block, a common pattern for insiders riding a KOL call. For each detected bundle you get the KOL, the side wallets, a confidence score, on chain proof and a live position for every wallet.
Use it to flag tokens where a KOL is buying together with hidden wallets, or to show a bundle breakdown on a token page. Positions (unrealized PnL, remaining value, entry market cap) are computed live at request time.
Bundle detection is Solana only. If no bundles are detected for the token you get a normal 200 with an empty bundles array and the token block, so you can poll. Within each bundle the KOL wallet is marked with is_kol true, and side wallets carry extra proof fields like adjacent_to_kol and same_fee.
Query Parameters
Your API key, required on
https://api.cabalspy.xyz. Alternatively pass it as an Authorization Bearer header. Not needed on the demo server https://demo-api.cabalspy.xyz.Try it without an API key: Try it runs on the demo server
https://demo-api.cabalspy.xyz (20 requests per IP per day, data delayed 15 minutes, at most 5 rows), so you can send a request without a key. For live data, switch the server to https://api.cabalspy.xyz and enter your API key. Your own integration always calls api.cabalspy.xyz with your API key, as in the usage examples below. Get a free key · About the demoUsage Example
curl "https://api.cabalspy.xyz/v1/bundle?blockchain=solana&mint=3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump&api_key=YOUR_KEY"
import requests
params = {
"blockchain": "solana",
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"api_key": "YOUR_KEY",
}
r = requests.get("https://api.cabalspy.xyz/v1/bundle", params=params)
d = r.json()["data"]
for b in d["bundles"]:
print("KOL", b["kol_wallet"], "confidence", b["confidence"], "wallets", b["wallet_count"])
for w in b["bundle_wallets"]:
pos = w["position"]
print(" ", w["address"], "kol" if w["is_kol"] else "side", "uPNL", pos["unrealized_pnl_sol"])
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));
Response
Show data
Show data
Show token
Show token
Show bundle
Show bundle
Show bundle wallet, KOL first then by invested
Show bundle wallet, KOL first then by invested
Show position
Show position
{
"success": true,
"data": {
"blockchain": "solana",
"token": {
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"symbol": "invisibull",
"name": "invisibull",
"supply": 1000000000,
"market_cap": 40.08,
"market_cap_usd": 3301.2,
"market_cap_currency": "SOL",
"price": 4.008e-8,
"price_usd": 3.3e-6,
"sol_price_usd": 82.36,
"pool": "pump",
"on_curve": true,
"bonding_curve_progress": 42.5
},
"bundles": [
{
"bundle_id": "bnd_7f3a2c",
"kol_wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"kol_profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"confidence": 0.92,
"jito_confirmed": true,
"proof_type": "same_block",
"slot": 301948220,
"wallet_count": 3,
"proof": "slot:301948220",
"verify_hint": "check same slot buys on solscan",
"detected_at": "2026-07-04T16:25:34Z",
"bundle_wallets": [
{
"address": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"is_kol": true,
"transaction_type": "buy",
"signature": "5xr8abc...",
"entry_source": "at_discovery",
"position_source": "live",
"profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"position": {
"held": 22113972.03,
"peak": 22113972.03,
"bought_tokens": 22113972.03,
"sold_tokens": 0.0,
"bag_pct": 100.0,
"supply_pct": 2.21,
"invested": 1.66,
"invested_usd": 137.44,
"max_single_buy": 1.66,
"buy_txn": 1,
"sell_txn": 0,
"sold_value": 0.0,
"sold_value_usd": 0.0,
"realized_pnl_sol": 0.0,
"realized_pnl_usd": 0.0,
"entry_market_cap": 44.6,
"entry_market_cap_usd": 3673.2,
"unrealized_pnl_sol": -0.099817,
"unrealized_pnl_usd": -8.22,
"unrealized_pnl_pct": -10.12,
"remaining_sol": 0.886537,
"remaining_usd": 73.02,
"first_buy_at": "2026-07-04T16:25:34Z",
"last_activity_at": "2026-07-04T16:40:10Z"
}
},
{
"address": "SideWa11etAbc123...",
"is_kol": false,
"transaction_type": "buy",
"signature": "9kp2def...",
"entry_source": "at_discovery",
"position_source": "live",
"profile": {
"name": "",
"image_url": "",
"twitter": "",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": null
},
"fee_lamports": 5000,
"block_index": 4,
"adjacent_to_kol": true,
"same_fee": true,
"occurrences": 7,
"position": {
"held": 8000000.0,
"peak": 8000000.0,
"bought_tokens": 8000000.0,
"sold_tokens": 0.0,
"bag_pct": 100.0,
"supply_pct": 0.8,
"invested": 0.6,
"invested_usd": 49.4,
"max_single_buy": 0.6,
"buy_txn": 1,
"sell_txn": 0,
"sold_value": 0.0,
"sold_value_usd": 0.0,
"realized_pnl_sol": 0.0,
"realized_pnl_usd": 0.0,
"entry_market_cap": 44.6,
"entry_market_cap_usd": 3673.2,
"unrealized_pnl_sol": -0.036,
"unrealized_pnl_usd": -2.97,
"unrealized_pnl_pct": -10.12,
"remaining_sol": 0.320,
"remaining_usd": 26.4,
"first_buy_at": "2026-07-04T16:25:34Z",
"last_activity_at": "2026-07-04T16:25:34Z"
}
}
]
}
]
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": false,
"cache_age_seconds": 0,
"version": "1.0.0",
"timestamp": "2026-07-06T11:01:57Z"
}
}
Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | missing_parameter | mint is missing. |
| 400 | invalid_parameter | blockchain is not solana. Bundle detection is Solana only. |
| 401 | unauthorized | API key missing. |
| 403 | forbidden | API key invalid or credits exhausted. |
| 429 | rate_limited | Rate limit exceeded. |

