Skip to main content
The KOL endpoints cover tracked wallets with public identity labels. Start with the leaderboard, choose a time window, and open a wallet’s positions to understand its results. KOLScan leaderboard showing KOL wallet PnL, volume, and active days

List all KOLs

The KOL leaderboard returns the tracked KOL roster with performance metrics and available identity labels.

Sort options

Compare KOLs over a time period

Use the period leaderboard to compare wallets over the same window. Lifetime totals and recent returns answer different questions.
Supported period shortcuts: 1d, 7d, 14d, 30d, 90d.

KOL calendar (monthly heatmap)

The calendar endpoint returns daily aggregate performance for the tracked KOL set.
Each day includes total PnL, trade count, and active KOL count across the tracked set.
Color days by aggregate PnL to spot market-wide trends at a glance.

Single-day KOL breakdown

The daily breakdown shows every tracked KOL’s activity for one specific day.
Use the daily breakdown to inspect which wallets traded and how their PnL changed on that date.

Drill into a KOL’s wallet

Pass a leaderboard wallet address to the summary and position endpoints for the underlying holdings and returns:

Follow new KOL trades

Use the whale and KOL trade feed for new swaps. GET /trades/kols loads recent activity; the transaction:kol Datastream room keeps it current. Use the leaderboard for performance comparisons and the trade feed for alerts.

Wallet PnL

Full guide for inspecting any wallet’s PnL, positions, and risk.

Trader rankings

KOL and top trader rankings with all sort and filter options.