Signals
curl --request GET \
--url https://demo-api.cabalspy.xyz/v1/signalsimport requests
url = "https://demo-api.cabalspy.xyz/v1/signals"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://demo-api.cabalspy.xyz/v1/signals', 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/signals",
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/signals"
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/signals")
.asString();require 'uri'
require 'net/http'
url = URI("https://demo-api.cabalspy.xyz/v1/signals")
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",
"wallet_types": ["kol"],
"currency": "SOL",
"filters": {
"min_win_rate": null,
"include_wallets": null,
"exclude_wallets": null,
"min_token_age_hours": null,
"max_token_age_hours": null
},
"signals": [
{
"token": {
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"token_name": "invisibull",
"blockchain": "solana",
"currency": "SOL",
"token_supply": 1000000000,
"token_decimals": 6
},
"signal_type": "cluster",
"signal_strength": "strong",
"currency": "SOL",
"gate": { "met": true, "wallet_types": ["kol"], "thresholds": { "kol": 3 } },
"window": {
"hours": 1,
"wallet_count": 5,
"by_type": { "kol": 5 },
"total_invested": 12.4,
"total_invested_usd": 1021.4,
"first_buy_at": "2026-07-06T10:20:00Z",
"latest_buy_at": "2026-07-06T10:52:00Z",
"time_span_minutes": 32.0
},
"token_stats": {
"total_buyers": 12,
"still_holding_count": 8,
"active_count": 7,
"total_volume": 44.6,
"total_volume_usd": 3673.2,
"net_flow": 30.1,
"holders_by_type": { "kol_count": 5, "smart_count": 0, "whale_count": 0 },
"first_entry_time": "2026-07-06T09:58:00Z"
},
"wallets": [
{
"profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"wallet_type": "kol",
"win_rate": null,
"window_invested": 3.2,
"window_invested_usd": 263.6,
"window_buy_txn": 1,
"window_sell_txn": 0,
"sold_in_window": false,
"bought_at": "2026-07-06T10:20:00Z",
"realized_pnl": 0.0,
"realized_pnl_usd": 0.0,
"realized_pnl_percentage": 0.0,
"bag_pct": 100.0,
"supply_pct": 0.32,
"still_holding": true,
"is_active": true
}
]
}
]
},
"pagination": { "limit": 50, "total": 1, "has_more": false, "next_cursor": null },
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": false,
"cache_age_seconds": 0,
"version": "1.0.0",
"timestamp": "2026-07-06T11:01:57Z"
}
}
Signals
Signals
Live trade signals derived from tracked wallet activity, including token clusters where several wallets buy the same token within a time window.
GET
/
v1
/
signals
Signals
curl --request GET \
--url https://demo-api.cabalspy.xyz/v1/signalsimport requests
url = "https://demo-api.cabalspy.xyz/v1/signals"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://demo-api.cabalspy.xyz/v1/signals', 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/signals",
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/signals"
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/signals")
.asString();require 'uri'
require 'net/http'
url = URI("https://demo-api.cabalspy.xyz/v1/signals")
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",
"wallet_types": ["kol"],
"currency": "SOL",
"filters": {
"min_win_rate": null,
"include_wallets": null,
"exclude_wallets": null,
"min_token_age_hours": null,
"max_token_age_hours": null
},
"signals": [
{
"token": {
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"token_name": "invisibull",
"blockchain": "solana",
"currency": "SOL",
"token_supply": 1000000000,
"token_decimals": 6
},
"signal_type": "cluster",
"signal_strength": "strong",
"currency": "SOL",
"gate": { "met": true, "wallet_types": ["kol"], "thresholds": { "kol": 3 } },
"window": {
"hours": 1,
"wallet_count": 5,
"by_type": { "kol": 5 },
"total_invested": 12.4,
"total_invested_usd": 1021.4,
"first_buy_at": "2026-07-06T10:20:00Z",
"latest_buy_at": "2026-07-06T10:52:00Z",
"time_span_minutes": 32.0
},
"token_stats": {
"total_buyers": 12,
"still_holding_count": 8,
"active_count": 7,
"total_volume": 44.6,
"total_volume_usd": 3673.2,
"net_flow": 30.1,
"holders_by_type": { "kol_count": 5, "smart_count": 0, "whale_count": 0 },
"first_entry_time": "2026-07-06T09:58:00Z"
},
"wallets": [
{
"profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"wallet_type": "kol",
"win_rate": null,
"window_invested": 3.2,
"window_invested_usd": 263.6,
"window_buy_txn": 1,
"window_sell_txn": 0,
"sold_in_window": false,
"bought_at": "2026-07-06T10:20:00Z",
"realized_pnl": 0.0,
"realized_pnl_usd": 0.0,
"realized_pnl_percentage": 0.0,
"bag_pct": 100.0,
"supply_pct": 0.32,
"still_holding": true,
"is_active": true
}
]
}
]
},
"pagination": { "limit": 50, "total": 1, "has_more": false, "next_cursor": null },
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": false,
"cache_age_seconds": 0,
"version": "1.0.0",
"timestamp": "2026-07-06T11:01:57Z"
}
}
Live trade signals derived from tracked wallet activity in a recent time window. The main mode, cluster, surfaces tokens where several tracked wallets are buying at once, a strong early signal. Two more modes, entry and exit, return individual buy and sell signals in the feed format.
Use it to drive alerts, for example notify me when three or more KOLs buy the same token within an hour. Signals are derived live from the feed, so they reflect the current window every time.
Choose the mode with mode. cluster groups wallets buying the same token, entry and exit return single buy or sell events. Tune clusters with min_wallets, min_value and hours. An advanced gated mode is available by passing per type filters like kol=3 and smart=2, see the gated mode parameters below.
Query Parameters
Gated mode. Comma separated KOL wallet counts at which a signal fires, up to 3 values, for example
3 or 2,3,5. Passing kol or any kol_ parameter turns on the gated mode. Default 3.Gated mode. Minimum amount a KOL wallet must have bought (native) to count. Use
smart_min_buy for Smart Money.Gated mode. Maximum amount a KOL wallet may have bought (native) to count. Use
smart_max_buy for Smart Money.Gated mode. Comma separated wallet counts, up to 2 values. An exit is flagged when the number of KOL wallets still holding drops to one of these counts or below. Use
smart_exit for Smart Money.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/signals?blockchain=solana&type=kol&mode=cluster&min_wallets=3&hours=1&api_key=YOUR_KEY"
import requests
params = {
"blockchain": "solana", "type": "kol", "mode": "cluster",
"min_wallets": 3, "hours": 1, "api_key": "YOUR_KEY",
}
r = requests.get("https://api.cabalspy.xyz/v1/signals", params=params)
for s in r.json()["data"]["signals"]:
w = s["window"]
print(s["token"]["token_name"], "wallets", w["wallet_count"], "invested", w["total_invested"])
const p = new URLSearchParams({
blockchain: "solana", type: "kol", mode: "cluster",
min_wallets: "3", hours: "1", api_key: "YOUR_KEY",
});
const res = await fetch(`https://api.cabalspy.xyz/v1/signals?${p}`);
const { data } = await res.json();
data.signals.forEach(s => console.log(s.token.token_name, s.window.wallet_count));
Response
The response shape depends on mode. Below is the cluster mode, the most detailed. entry and exit return individual transactions in the same shape as the transactions feed (with holdings_after).Show data
Show data
The applied filters (min_win_rate, include_wallets, exclude_wallets, min_token_age_hours, max_token_age_hours).
Show signal (cluster)
Show signal (cluster)
Show window
Show window
Whole history token stats (total_buyers, still_holding_count, active_count, total_volume, total_volume_usd, net_flow, holders_by_type, first_entry_time).
Show wallet in the cluster
Show wallet in the cluster
{
"success": true,
"data": {
"blockchain": "solana",
"wallet_types": ["kol"],
"currency": "SOL",
"filters": {
"min_win_rate": null,
"include_wallets": null,
"exclude_wallets": null,
"min_token_age_hours": null,
"max_token_age_hours": null
},
"signals": [
{
"token": {
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"token_name": "invisibull",
"blockchain": "solana",
"currency": "SOL",
"token_supply": 1000000000,
"token_decimals": 6
},
"signal_type": "cluster",
"signal_strength": "strong",
"currency": "SOL",
"gate": { "met": true, "wallet_types": ["kol"], "thresholds": { "kol": 3 } },
"window": {
"hours": 1,
"wallet_count": 5,
"by_type": { "kol": 5 },
"total_invested": 12.4,
"total_invested_usd": 1021.4,
"first_buy_at": "2026-07-06T10:20:00Z",
"latest_buy_at": "2026-07-06T10:52:00Z",
"time_span_minutes": 32.0
},
"token_stats": {
"total_buyers": 12,
"still_holding_count": 8,
"active_count": 7,
"total_volume": 44.6,
"total_volume_usd": 3673.2,
"net_flow": 30.1,
"holders_by_type": { "kol_count": 5, "smart_count": 0, "whale_count": 0 },
"first_entry_time": "2026-07-06T09:58:00Z"
},
"wallets": [
{
"profile": {
"name": "Maze",
"image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"type": "kol"
},
"wallet_type": "kol",
"win_rate": null,
"window_invested": 3.2,
"window_invested_usd": 263.6,
"window_buy_txn": 1,
"window_sell_txn": 0,
"sold_in_window": false,
"bought_at": "2026-07-06T10:20:00Z",
"realized_pnl": 0.0,
"realized_pnl_usd": 0.0,
"realized_pnl_percentage": 0.0,
"bag_pct": 100.0,
"supply_pct": 0.32,
"still_holding": true,
"is_active": true
}
]
}
]
},
"pagination": { "limit": 50, "total": 1, "has_more": false, "next_cursor": null },
"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 | invalid_parameter | blockchain, type or mode missing or invalid. |
| 401 | unauthorized | API key missing. |
| 403 | forbidden | API key invalid or credits exhausted. |
| 429 | rate_limited | Rate limit exceeded. |

