KOL Leaderboard API — who is
winning right now
One endpoint returns a ranked list of KOL, Smart Money and Whale wallets for any period — each with profile, realized PnL, win rate, trade count and volume. The data behind copy-trading boards like Axiom’s Vision tab.
Build a KOL leaderboard with one API call
What it shows
A ranked list of tracked wallets for a period you choose — 6 hours, 1 day, 7 days or 30 days. Every entry carries the trader’s public profile (name, avatar, X/Twitter, Telegram) and period statistics: buy and sell volume, realized PnL, average hold time and a win rate breakdown showing how many closed positions were winners.
Show the top traders as a podium and the rest in a sortable table. Your users get a discovery page for the best wallets to follow or copy — and a simple answer to the question every trader asks: who is winning right now?
How it works
Call the leaderboard endpoint with a chain, a wallet type (kol, smart or whale) and a period. Without a limit you get the full ranking in one response; for large boards, set limit and page with the returned next_cursor.
The leaderboard is served from a permanently cached, WebSocket-driven store, so reads are fast and consistent. Sorting by PnL, win rate, trades or volume happens instantly on the client, because every entry already includes all four metrics.
Supported chains: Solana, BNB Chain, Base, Ethereum and Robinhood Chain (blockchain values solana, bnb, base, eth and rh). Solana has KOL, Smart Money and Whale wallets; BNB Chain, Base and Robinhood Chain have KOL and Smart Money; Ethereum has KOL wallets.
Quick start
Get a free key from the API dashboard (10,000 credits per month, no credit card), then:
curl "https://api.cabalspy.xyz/v1/wallets/leaderboard?blockchain=solana&type=kol&period=7d&limit=20&api_key=YOUR_KEY"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}`));Who builds this
- Trading terminals — a “Top traders” tab that keeps users inside your product
- Copy-trading apps — a shortlist of verified wallets to follow, ranked by real PnL
- Telegram and Discord bots — a daily “Top KOLs this week” post
- Analysts — spot who is rotating capital and which traders are consistently profitable
Frequently asked questions
01How do I build a KOL leaderboard?
Call GET https://api.cabalspy.xyz/v1/wallets/leaderboard with blockchain, type (kol, smart or whale) and period (6h, 1d, 7d or 30d). The response is a ranked list where each wallet includes its profile, period stats and win rate — enough to render a podium and a sortable table without further calls.
02Which metrics can I rank KOLs by?
The API returns the list sorted by trading volume and includes realized PnL, win rate, trade count and volume for every wallet, so you can re-sort by any of them on the client instantly.
03Which chains does the KOL leaderboard support?
Solana, BNB Chain, Base, Ethereum and Robinhood Chain. Solana offers KOL, Smart Money and Whale leaderboards; BNB Chain, Base and Robinhood Chain offer KOL and Smart Money; Ethereum offers KOL.
04Is there a ready-made example?
Yes. The CabalSpy docs include a step-by-step cookbook for a leaderboard like Axiom Vision, and an open-source demo is available on GitHub.
Go deeper
Related use cases
Build KOL Leaderboard into your product. Start free today.
10,000 free credits every month, REST and WebSocket access, no credit card. Plans from $49/month.