Analytics
curl --request GET \
--url https://demo-api.cabalspy.xyz/v1/analyticsimport requests
url = "https://demo-api.cabalspy.xyz/v1/analytics"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://demo-api.cabalspy.xyz/v1/analytics', 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/analytics",
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/analytics"
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/analytics")
.asString();require 'uri'
require 'net/http'
url = URI("https://demo-api.cabalspy.xyz/v1/analytics")
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": {
"mode": "most_traded",
"blockchain": "solana",
"type": "kol",
"period": "7d",
"currency": "SOL",
"data": [
{
"rank": 1,
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"token_name": "invisibull",
"wallet_count": 12,
"total_volume": 312.5,
"total_buy": 180.25,
"total_sell": 132.25,
"net_flow": 48.0,
"buying_pressure": 57.6,
"currency": "SOL",
"first_buy_at": "2026-07-01T09:58:00Z"
}
]
},
"pagination": { "limit": 20, "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"
}
}
{
"success": true,
"data": {
"mode": "win_rate",
"blockchain": "solana",
"type": "kol",
"period": "7d",
"currency": "SOL",
"total_wallets": 342,
"wallets_with_trades": 210,
"win_count": 1240,
"closed_count": 2010,
"win_rate_percentage": 61.69,
"distribution": {
"above_500": 42,
"above_100_to_500": 310,
"above_zero_to_100": 888,
"below_zero": 770
}
},
"meta": {
"request_id": "req_9aa1917e433b",
"cached": false,
"cache_age_seconds": 0,
"version": "1.0.0",
"timestamp": "2026-07-06T11:02:10Z"
}
}
Signals
Analytics
Aggregate analytics over tracked wallets for a period, including most traded tokens, top performing wallets, win rate stats and volume trends.
GET
/
v1
/
analytics
Analytics
curl --request GET \
--url https://demo-api.cabalspy.xyz/v1/analyticsimport requests
url = "https://demo-api.cabalspy.xyz/v1/analytics"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://demo-api.cabalspy.xyz/v1/analytics', 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/analytics",
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/analytics"
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/analytics")
.asString();require 'uri'
require 'net/http'
url = URI("https://demo-api.cabalspy.xyz/v1/analytics")
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": {
"mode": "most_traded",
"blockchain": "solana",
"type": "kol",
"period": "7d",
"currency": "SOL",
"data": [
{
"rank": 1,
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"token_name": "invisibull",
"wallet_count": 12,
"total_volume": 312.5,
"total_buy": 180.25,
"total_sell": 132.25,
"net_flow": 48.0,
"buying_pressure": 57.6,
"currency": "SOL",
"first_buy_at": "2026-07-01T09:58:00Z"
}
]
},
"pagination": { "limit": 20, "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"
}
}
{
"success": true,
"data": {
"mode": "win_rate",
"blockchain": "solana",
"type": "kol",
"period": "7d",
"currency": "SOL",
"total_wallets": 342,
"wallets_with_trades": 210,
"win_count": 1240,
"closed_count": 2010,
"win_rate_percentage": 61.69,
"distribution": {
"above_500": 42,
"above_100_to_500": 310,
"above_zero_to_100": 888,
"below_zero": 770
}
},
"meta": {
"request_id": "req_9aa1917e433b",
"cached": false,
"cache_age_seconds": 0,
"version": "1.0.0",
"timestamp": "2026-07-06T11:02:10Z"
}
}
Aggregate analytics over tracked wallets for a period. Four modes cover different questions, which tokens are most traded, which wallets perform best, what the win rate looks like, and how volume trends over time.
Use it to build dashboards and leaderboards, for example a most traded tokens this week widget or a top performers table.
Choose the view with mode. All modes share the same wrapper (mode, blockchain, type, period, currency) and differ in the data they return. Set the window with period, one of 6h, 1d, 7d or 30d.
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/analytics?blockchain=solana&type=kol&mode=most_traded&period=7d&limit=20&api_key=YOUR_KEY"
import requests
params = {
"blockchain": "solana", "type": "kol", "mode": "most_traded",
"period": "7d", "limit": 20, "api_key": "YOUR_KEY",
}
r = requests.get("https://api.cabalspy.xyz/v1/analytics", params=params)
for t in r.json()["data"]["data"]:
print(t["rank"], t["token_name"], "wallets", t["wallet_count"], "vol", t["total_volume"])
const p = new URLSearchParams({
blockchain: "solana", type: "kol", mode: "most_traded",
period: "7d", limit: "20", api_key: "YOUR_KEY",
});
const res = await fetch(`https://api.cabalspy.xyz/v1/analytics?${p}`);
const { data } = await res.json();
data.data.forEach(t => console.log(t.rank, t.token_name, t.total_volume));
Response
All modes return the same wrapper. The list modes (most_traded, top_performers) put their items in a data array. win_rate returns summary fields directly. The sections below describe each mode.most_traded item
top_performers item
Period statistics for the wallet (period, currency, total_buy, total_buy_usd, total_sell, total_sell_usd, total_volume, total_volume_usd, realized_pnl, realized_pnl_usd and related fields).
win_rate fields
For win_rate the wrapper carries the summary directly instead of a data array.volume_trend
For volume_trend the data array holds time bucketed volume points over the period.{
"success": true,
"data": {
"mode": "most_traded",
"blockchain": "solana",
"type": "kol",
"period": "7d",
"currency": "SOL",
"data": [
{
"rank": 1,
"mint": "3Pkrq4MmLvDXyn1fa3sz5MekKRkZkc1iLDcz5AzWpump",
"token_name": "invisibull",
"wallet_count": 12,
"total_volume": 312.5,
"total_buy": 180.25,
"total_sell": 132.25,
"net_flow": 48.0,
"buying_pressure": 57.6,
"currency": "SOL",
"first_buy_at": "2026-07-01T09:58:00Z"
}
]
},
"pagination": { "limit": 20, "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"
}
}
{
"success": true,
"data": {
"mode": "win_rate",
"blockchain": "solana",
"type": "kol",
"period": "7d",
"currency": "SOL",
"total_wallets": 342,
"wallets_with_trades": 210,
"win_count": 1240,
"closed_count": 2010,
"win_rate_percentage": 61.69,
"distribution": {
"above_500": 42,
"above_100_to_500": 310,
"above_zero_to_100": 888,
"below_zero": 770
}
},
"meta": {
"request_id": "req_9aa1917e433b",
"cached": false,
"cache_age_seconds": 0,
"version": "1.0.0",
"timestamp": "2026-07-06T11:02:10Z"
}
}
Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_parameter | blockchain, type, mode or period missing or invalid. |
| 401 | unauthorized | API key missing. |
| 403 | forbidden | API key invalid or credits exhausted. |
| 429 | rate_limited | Rate limit exceeded. |

