Leaderboard

{
  "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"
  }
}

{
  "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"
  }
}

Your users’ verified wallets ranked for a period, by volume, realized PnL, win rate or number of trades. Every entry carries the owner’s profile and KOL badge, so you can render a verified leaderboard in your app directly. Only wallets with trades in the period appear. Enterprise keys can add scope=global to rank every CabalSpy ID user.

The leaderboard is cached for 30 seconds. To page through it, pass the wallet of the last entry, data.pagination.next_cursor, as cursor.

Query Parameters

string

required

Chain. One of solana, bnb, base, eth, rh.

string

default:"1d"

Ranking window, one of 6h, 1d, 7d or 30d.

string

default:"volume"

Ranking order, highest first. One of volume, pnl (native), pnl_usd, win_rate (ties broken by closed positions) or trades.

integer

default:"100"

Entries per page, 1 to 500.

string

Cursor for the next page, the data.pagination.next_cursor from the previous response.

string

default:"instance"

global ranks every CabalSpy ID user. Enterprise plan only.

string

Your Instance ID. Only needed when your account has several instances.

string

required

Your API key. Alternatively pass it as an Authorization Bearer header.

Usage Example

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));

Response

boolean

True on success.

object

Show data

string

Chain.

string

Always csid.

string

instance or global.

string

The requested window.

string

The ranking order.

string

Native currency of the chain.

object

limit, total (ranked wallets), has_more and next_cursor (null means end).

array

Show entry

integer

Position in the ranking, starting at 1.

string

Wallet address.

object

csid_id, username, name, image_url, twitter (null without X), telegram (t.me link or empty), blockchain, currency, wallet_type (always csid), kol and public_trading (whether the user shows their trading publicly on CabalSpy ID).

object

Show period_stats

string

The requested window.

number

Bought (native).

number

Bought in USD.

number

Sold (native).

number

Sold in USD.

number

Buy plus sell volume (native).

number

Buy plus sell volume in USD.

number

Realized PnL (native), sells minus buys.

number

Realized PnL in USD.

number

Realized PnL percentage.

number

Average holding time in minutes.

integer

All trades.

integer

Buys.

integer

Sells.

object

win_count, closed_count and win_rate_percentage.

object

total_tokens, the number of tokens traded in the 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"
  }
}

Errors

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 or not enabled for CabalSpy ID.
403	scope_not_allowed	scope=global needs the Enterprise plan.
429	rate_limit_exceeded	Rate limit exceeded.

Introduction

Login

Data API

Users

Trading

Theses

Streams

Reference

Query Parameters

Usage Example

Response

Errors

​Query Parameters

​Usage Example

​Response

​Errors

Query Parameters

Usage Example

Response

Errors