Wallet Leaderboard - Rank Top KOL and Smart Money Traders

Leaderboard

curl --request GET \
  --url https://demo-api.cabalspy.xyz/v1/wallets/leaderboard

const options = {method: 'GET'};

fetch('https://demo-api.cabalspy.xyz/v1/wallets/leaderboard', 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/wallets/leaderboard",
  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/wallets/leaderboard"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://demo-api.cabalspy.xyz/v1/wallets/leaderboard")

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",
    "type": "kol",
    "period": "7d",
    "currency": "SOL",
    "pagination": {
      "total": 342,
      "limit": 20,
      "next_cursor": "8CvFWU1Hfmy7HkS7eWG2x8EMtQxAzCr7KcukKwspGFwB",
      "has_more": true
    },
    "leaderboard": [
      {
        "wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
        "profile": {
          "name": "Maze",
          "image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
          "twitter": "https://x.com/MazeCCC",
          "telegram": "",
          "blockchain": "solana",
          "currency": "SOL",
          "wallet_type": "kol"
        },
        "period_stats": {
          "period": "7d",
          "total_buy": 180.25,
          "total_buy_usd": 14840.6,
          "total_sell": 132.25,
          "total_sell_usd": 10890.65,
          "total_volume": 312.5,
          "total_volume_usd": 25731.25,
          "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": 23
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": true,
    "cache_age_seconds": 42,
    "version": "1.0.0",
    "timestamp": "2026-07-06T11:01:57Z"
  }
}

GET

wallets

leaderboard

Leaderboard

curl --request GET \
  --url https://demo-api.cabalspy.xyz/v1/wallets/leaderboard

const options = {method: 'GET'};

fetch('https://demo-api.cabalspy.xyz/v1/wallets/leaderboard', 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/wallets/leaderboard",
  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/wallets/leaderboard"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://demo-api.cabalspy.xyz/v1/wallets/leaderboard")

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",
    "type": "kol",
    "period": "7d",
    "currency": "SOL",
    "pagination": {
      "total": 342,
      "limit": 20,
      "next_cursor": "8CvFWU1Hfmy7HkS7eWG2x8EMtQxAzCr7KcukKwspGFwB",
      "has_more": true
    },
    "leaderboard": [
      {
        "wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
        "profile": {
          "name": "Maze",
          "image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
          "twitter": "https://x.com/MazeCCC",
          "telegram": "",
          "blockchain": "solana",
          "currency": "SOL",
          "wallet_type": "kol"
        },
        "period_stats": {
          "period": "7d",
          "total_buy": 180.25,
          "total_buy_usd": 14840.6,
          "total_sell": 132.25,
          "total_sell_usd": 10890.65,
          "total_volume": 312.5,
          "total_volume_usd": 25731.25,
          "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": 23
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": true,
    "cache_age_seconds": 42,
    "version": "1.0.0",
    "timestamp": "2026-07-06T11:01:57Z"
  }
}

Rank the wallets CabalSpy tracks by trading volume over a chosen period, each enriched with period statistics such as buy and sell volume, realized PnL, average hold time and a win rate breakdown (how many closed positions were winners). Use it to surface the hottest traders right now, build a Top KOLs this week board, spot who is rotating capital, or seed a copytrade shortlist. The leaderboard is served from a permanently cached, WebSocket driven store, so reads are fast and consistent (meta.cached tells you the cache age).

Pick the window with period, one of 6h, 1d, 7d or 30d. Without a limit you get the full ranking, set limit and page with cursor (the cursor is a wallet address) for large boards.

Query Parameters

string

required

Chain. One of solana, bnb, base, eth, rh (Robinhood Chain).

string

default:"kol"

Wallet category kol, smart or whale. Availability per chain. Solana has kol, smart, whale. BNB, Base and Robinhood Chain (rh) have kol, smart. ETH has kol.

string

default:"1d"

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

integer

Maximum wallets per page. Omit to return the full ranking.

string

Cursor for the next page, the pagination.next_cursor (a wallet address) from the previous response.

string

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 demo

Usage Example

curl "https://api.cabalspy.xyz/v1/wallets/leaderboard?blockchain=solana&type=kol&period=7d&limit=20&api_key=YOUR_KEY"

import requests

params = {"blockchain": "solana", "type": "kol", "period": "7d", "limit": 20, "api_key": "YOUR_KEY"}
r = requests.get("https://api.cabalspy.xyz/v1/wallets/leaderboard", params=params)

for i, w in enumerate(r.json()["data"]["leaderboard"], 1):
    ps = w["period_stats"]
    wr = w["period_win_rate_distribution"]["win_rate_percentage"]
    print(f'{i:>2}. {w["profile"]["name"] or w["wallet"]:<16} vol {ps["total_volume"]:>8.1f} win {wr:.0f}%')

const p = new URLSearchParams({
  blockchain: "solana", type: "kol", period: "7d", limit: "20", api_key: "YOUR_KEY",
});
const res = await fetch(`https://api.cabalspy.xyz/v1/wallets/leaderboard?${p}`);
const { data } = await res.json();
data.leaderboard.forEach((w, i) =>
  console.log(`${i + 1}. ${w.profile.name || w.wallet} vol ${w.period_stats.total_volume}`));

Response

boolean

True on success.

object

Show data

string

Requested chain.

string

Requested wallet type.

string

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

string

Native currency of the chain.

object

Show pagination

integer

Total ranked wallets.

integer

Requested limit (null means all).

string

Wallet address to start the next page (null means end).

boolean

Whether more pages follow.

array

Show entry, sorted by volume highest first

string

Wallet address.

object

Show profile

string

Display name (may be empty).

string

Avatar URL.

string

Twitter or X link.

string

Telegram link.

string

Chain.

string

Native currency.

string

kol, smart or whale.

object

Show period_stats

string

The requested window.

number

Buy volume in the period (native).

number

Buy volume in USD.

number

Sell volume in the period (native).

number

Sell volume in USD.

number

Buy plus sell volume (native). This is the ranking key.

number

Buy plus sell volume in USD.

number

Realized PnL in the period (native).

number

Realized PnL in USD.

number

Realized PnL as a percentage of buy volume.

number

Average holding time in minutes.

integer

Total transactions (buys plus sells).

integer

Number of buys.

integer

Number of sells.

object

Show period_win_rate_distribution

integer

Closed positions that ended in profit.

integer

Total closed positions in the period.

number

win_count divided by closed_count times 100.

object

Show period_history_tokens

integer

Distinct tokens traded in the period.

{
  "success": true,
  "data": {
    "blockchain": "solana",
    "type": "kol",
    "period": "7d",
    "currency": "SOL",
    "pagination": {
      "total": 342,
      "limit": 20,
      "next_cursor": "8CvFWU1Hfmy7HkS7eWG2x8EMtQxAzCr7KcukKwspGFwB",
      "has_more": true
    },
    "leaderboard": [
      {
        "wallet": "7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW",
        "profile": {
          "name": "Maze",
          "image_url": "https://cabalspy.xyz/images/7j7AA3HZR2zEjwAQEKPFh2qucLY4fqZpB9iodf39w8xW.png",
          "twitter": "https://x.com/MazeCCC",
          "telegram": "",
          "blockchain": "solana",
          "currency": "SOL",
          "wallet_type": "kol"
        },
        "period_stats": {
          "period": "7d",
          "total_buy": 180.25,
          "total_buy_usd": 14840.6,
          "total_sell": 132.25,
          "total_sell_usd": 10890.65,
          "total_volume": 312.5,
          "total_volume_usd": 25731.25,
          "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": 23
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_5162c7cf7f87",
    "cached": true,
    "cache_age_seconds": 42,
    "version": "1.0.0",
    "timestamp": "2026-07-06T11:01:57Z"
  }
}

Errors

Status	Code	Meaning
400	invalid_parameter	blockchain, type or period missing or invalid (for example an unknown period, or eth with whale).
401	unauthorized	API key missing.
403	forbidden	API key invalid or credits exhausted.
429	rate_limited	Rate limit exceeded.

Introduction

Wallet data

Tokens

Bundle

Transactions

Signals

Leaderboard

Query Parameters

Usage Example

Response

Errors

​Query Parameters

​Usage Example

​Response

​Errors

Query Parameters

Usage Example

Response

Errors