Leaderboard

Ranked list of tracked wallets for a chain, wallet type and period. Each entry includes profile, period_stats (native + USD volume and PnL, win rate, average hold time) and a win-rate distribution. Results are sorted by volume.

Get the wallet leaderboard

get

Returns the ranked wallet leaderboard for the given chain, type and period.

Parameters / settings

• blockchain (required) — one of: solana, bnb, base, eth

• type (optional, default kol) — one of: kol, smart, whale (availability depends on chain)

• period (optional, default 1d) — one of: 6h, 1d, 7d, 30d

• limit (optional) — number of entries to return. Omit it to get ALL entries (no cap).

• cursor (optional) — wallet address from a previous page for pagination

• api_key (optional if Bearer header is used)

Alias: GET /v1/wallets/leaderboard is identical.

Authorizations

bearerAuthapiKeyQuery

AuthorizationstringRequired

Authorization: Bearer YOUR_KEY

Query parameters

blockchainstring · enumRequiredExample: solanaPossible values:

typestring · enumOptionalDefault: kolExample: kolPossible values:

periodstring · enumOptionalDefault: 1dExample: 1dPossible values:

limitinteger · min: 1OptionalExample: 50

cursorstringOptional

api_keystringOptionalExample: YOUR_KEY

Responses

200

Ranked leaderboard.

application/json

successbooleanOptional

metaobjectOptional

400

Missing or invalid parameter.

application/json

401

Missing API key.

application/json

403

Invalid or exhausted API key.

application/json

429

Rate limit exceeded.

application/json

get

/v1/wallet/leaderboard

HTTPcURLJavaScriptPython

GET /v1/wallet/leaderboard?blockchain=solana HTTP/1.1
Host: api.cabalspy.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "data": {
    "blockchain": "solana",
    "type": "kol",
    "period": "1d",
    "currency": "SOL",
    "pagination": {
      "limit": 50,
      "total": 312,
      "has_more": true,
      "next_cursor": "7xKp...VwXyZa"
    },
    "leaderboard": [
      {
        "wallet": "G6fUXjMKPJzCY1rveAE6Qm7wy5U3vZgKDJmN1VPAdiZC",
        "profile": {
          "name": "Cented",
          "image_url": "https://cabalspy.xyz/images/cented.png",
          "twitter": "@Cented",
          "telegram": "",
          "blockchain": "solana",
          "currency": "SOL",
          "wallet_type": "kol"
        },
        "period_stats": {
          "period": "1d",
          "total_buy": 148.2341,
          "total_buy_usd": 21344.71,
          "total_sell": 254.182,
          "total_sell_usd": 36602.21,
          "total_volume": 402.4161,
          "total_volume_usd": 57946.92,
          "realized_pnl": 105.9479,
          "realized_pnl_usd": 15257.5,
          "realized_pnl_percentage": 71.48,
          "avg_hold_time_minutes": 37,
          "total_txn": 62,
          "buy_txn": 34,
          "sell_txn": 28
        },
        "period_win_rate_distribution": {
          "win_count": 9,
          "closed_count": 14,
          "win_rate_percentage": 64.29
        },
        "period_history_tokens": {
          "total_tokens": 21
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_a1b2c3d4e5f6",
    "cached": true,
    "cache_age_seconds": 0,
    "version": "1.0.0",
    "timestamp": "2025-03-19T14:22:30Z"
  }
}