Query Parameters
Ranking order, highest first. One of volume, pnl (native), pnl_usd, win_rate (ties broken by closed positions) or trades.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
{
"success": true,
"data": {
"blockchain": "solana",
"type": "csid",
"scope": "instance",
"period": "7d",
"sort": "pnl_usd",
"currency": "SOL",
"pagination": {
"limit": 25,
"total": 1,
"has_more": false,
"next_cursor": null
},
"leaderboard": [
{
"wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"profile": {
"csid_id": "0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11",
"username": "MazeCCC",
"name": "Maze",
"image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"wallet_type": "csid",
"kol": true,
"public_trading": true
},
"period_stats": {
"period": "7d",
"total_buy": 180.25,
"total_buy_usd": 14840.6,
"total_sell": 228.45,
"total_sell_usd": 18809.2,
"total_volume": 408.7,
"total_volume_usd": 33649.8,
"realized_pnl": 48.2,
"realized_pnl_usd": 3968.6,
"realized_pnl_percentage": 26.74,
"avg_hold_time_minutes": 84.5,
"total_txn": 40,
"buy_txn": 22,
"sell_txn": 18
},
"period_win_rate_distribution": {
"win_count": 14,
"closed_count": 18,
"win_rate_percentage": 77.78
},
"period_history_tokens": { "total_tokens": 21 },
"rank": 1
}
]
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": true,
"cache_age_seconds": 12,
"version": "v1",
"timestamp": "2026-10-13T08:04:11Z"
}
}
GET /v1/wallets/leaderboard: your users’ verified wallets ranked by volume, PnL, win rate or trades for a period.
{
"success": true,
"data": {
"blockchain": "solana",
"type": "csid",
"scope": "instance",
"period": "7d",
"sort": "pnl_usd",
"currency": "SOL",
"pagination": {
"limit": 25,
"total": 1,
"has_more": false,
"next_cursor": null
},
"leaderboard": [
{
"wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"profile": {
"csid_id": "0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11",
"username": "MazeCCC",
"name": "Maze",
"image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"wallet_type": "csid",
"kol": true,
"public_trading": true
},
"period_stats": {
"period": "7d",
"total_buy": 180.25,
"total_buy_usd": 14840.6,
"total_sell": 228.45,
"total_sell_usd": 18809.2,
"total_volume": 408.7,
"total_volume_usd": 33649.8,
"realized_pnl": 48.2,
"realized_pnl_usd": 3968.6,
"realized_pnl_percentage": 26.74,
"avg_hold_time_minutes": 84.5,
"total_txn": 40,
"buy_txn": 22,
"sell_txn": 18
},
"period_win_rate_distribution": {
"win_count": 14,
"closed_count": 18,
"win_rate_percentage": 77.78
},
"period_history_tokens": { "total_tokens": 21 },
"rank": 1
}
]
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": true,
"cache_age_seconds": 12,
"version": "v1",
"timestamp": "2026-10-13T08:04:11Z"
}
}
curl "https://api-id.cabalspy.xyz/v1/wallets/leaderboard?blockchain=solana&period=7d&sort=pnl_usd&limit=25" \
-H "Authorization: Bearer YOUR_KEY"
import requests
params = {"blockchain": "solana", "period": "7d", "sort": "pnl_usd", "limit": 25}
r = requests.get("https://api-id.cabalspy.xyz/v1/wallets/leaderboard", params=params,
headers={"Authorization": "Bearer YOUR_KEY"})
for e in r.json()["data"]["leaderboard"]:
print(e["rank"], e["profile"]["username"], e["period_stats"]["realized_pnl_usd"])
const p = new URLSearchParams({ blockchain: "solana", period: "7d", sort: "pnl_usd", limit: "25" });
const res = await fetch(`https://api-id.cabalspy.xyz/v1/wallets/leaderboard?${p}`, {
headers: { Authorization: "Bearer YOUR_KEY" },
});
const { data } = await res.json();
data.leaderboard.forEach(e => console.log(e.rank, e.profile.username, e.period_stats.realized_pnl_usd));
Show data
Show entry
Show period_stats
{
"success": true,
"data": {
"blockchain": "solana",
"type": "csid",
"scope": "instance",
"period": "7d",
"sort": "pnl_usd",
"currency": "SOL",
"pagination": {
"limit": 25,
"total": 1,
"has_more": false,
"next_cursor": null
},
"leaderboard": [
{
"wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
"profile": {
"csid_id": "0b7c4a52-3f1e-4f43-9d0a-2b5e7c1d9a11",
"username": "MazeCCC",
"name": "Maze",
"image_url": "https://pbs.twimg.com/profile_images/.../photo.jpg",
"twitter": "https://x.com/MazeCCC",
"telegram": "",
"blockchain": "solana",
"currency": "SOL",
"wallet_type": "csid",
"kol": true,
"public_trading": true
},
"period_stats": {
"period": "7d",
"total_buy": 180.25,
"total_buy_usd": 14840.6,
"total_sell": 228.45,
"total_sell_usd": 18809.2,
"total_volume": 408.7,
"total_volume_usd": 33649.8,
"realized_pnl": 48.2,
"realized_pnl_usd": 3968.6,
"realized_pnl_percentage": 26.74,
"avg_hold_time_minutes": 84.5,
"total_txn": 40,
"buy_txn": 22,
"sell_txn": 18
},
"period_win_rate_distribution": {
"win_count": 14,
"closed_count": 18,
"win_rate_percentage": 77.78
},
"period_history_tokens": { "total_tokens": 21 },
"rank": 1
}
]
},
"meta": {
"request_id": "req_5162c7cf7f87",
"cached": true,
"cache_age_seconds": 12,
"version": "v1",
"timestamp": "2026-10-13T08:04:11Z"
}
}
| Status | Code | Meaning |
|---|---|---|
| 400 | missing_parameter | blockchain is missing. |
| 400 | invalid_parameter | blockchain, period, sort, limit, cursor or scope invalid. |
| 401 | missing_api_key | API key missing. |
| 403 | invalid_api_key | API key invalid. |
| 403 | product_not_enabled | The key is not enabled for the CabalSpy ID API (API keys page, Works with). |
| 403 | scope_not_allowed | scope=global needs the Enterprise plan. |
| 429 | rate_limit_exceeded | Rate limit exceeded. |
