Skip to main content
GET
Get Leaderboard
Ranked list of wallets by trading performance. Supports filtering by trading style (WHALE, MARKET_MAKER, ACTIVE_TRADER, etc.), PnL range, minimum volume, win rate, and more.
Requires Dev or Pro tier. This endpoint is not available on the Free tier.
Each wallet exposes individual boolean columns (is_whale, is_contrarian, etc.) so you can filter by any combination of labels - not just primary_trading_style. See Trading Labels for the full list and criteria.
Rolling total PnL accuracy timeline - Total PnL (realized + unrealized - net fees) uses rolling windows that need time to accumulate full data:
  • All-time total PnL: accurate immediately (February 10, 2026)
  • 1-day rolling total PnL: fully accurate starting February 11, 2026
  • 7-day rolling total PnL: fully accurate starting February 17, 2026
  • 30-day rolling total PnL: fully accurate starting March 12, 2026

Authorizations

x-api-key
string
header
required

Query Parameters

window
enum<string>
default:all_time

Time window for metrics

Available options:
1d,
7d,
30d,
all_time
sort_by
enum<string>
default:total_pnl

Sort field

Available options:
realized_pnl,
total_pnl,
volume,
roi,
profit_factor,
win_rate,
trades
order
enum<string>
default:desc

Sort order

Available options:
asc,
desc
style
string | null

Comma-separated styles to include (OR logic)

exclude_style
string | null

Comma-separated styles to exclude

min_realized_pnl
number | null

Minimum realized PnL in USD

max_realized_pnl
number | null

Maximum realized PnL in USD

min_total_pnl
number | null

Minimum total PnL in USD (realized + unrealized - net fees)

max_total_pnl
number | null

Maximum total PnL in USD (realized + unrealized - net fees)

min_volume
number | null

Minimum volume in USD

Required range: x >= 0
max_volume
number | null

Maximum volume in USD

Required range: x >= 0
min_trades
integer | null

Minimum trade count

Required range: x >= 1
max_trades
integer | null

Maximum trade count

Required range: x >= 1
min_roi
number | null

Minimum ROI (decimal)

max_roi
number | null

Maximum ROI (decimal)

min_profit_factor
number | null

Minimum profit factor

Required range: x >= 0
max_profit_factor
number | null

Maximum profit factor

Required range: x >= 0
min_win_rate
number | null

Minimum win rate (decimal)

Required range: 0 <= x <= 1
max_win_rate
number | null

Maximum win rate (decimal)

Required range: 0 <= x <= 1
min_avg_trade_usd
number | null

Minimum avg trade size in USD

Required range: x >= 0
max_avg_trade_usd
number | null

Maximum avg trade size in USD

Required range: x >= 0
min_wallet_age_days
integer | null

Minimum wallet age in days

Required range: x >= 0
max_wallet_age_days
integer | null

Maximum wallet age in days

Required range: x >= 0
min_avg_buy_price
number | null

Minimum avg buy price (0-1)

Required range: 0 <= x <= 1
max_avg_buy_price
number | null

Maximum avg buy price (0-1)

Required range: 0 <= x <= 1
min_avg_sell_price
number | null

Minimum avg sell price (0-1)

Required range: 0 <= x <= 1
max_avg_sell_price
number | null

Maximum avg sell price (0-1)

Required range: 0 <= x <= 1
min_entry_edge
number | null

Minimum entry edge (avg_sell - avg_buy)

Required range: -1 <= x <= 1
max_entry_edge
number | null

Maximum entry edge (avg_sell - avg_buy)

Required range: -1 <= x <= 1
limit
integer
default:100

Results per page

Required range: 1 <= x <= 100
pagination_key
string | null

Cursor for pagination

Response

Successful Response

Response for global leaderboard endpoint.

window
enum<string>
required

Time window for metrics

Available options:
1d,
7d,
30d,
all_time
sort_by
enum<string>
required

Sort field used

Available options:
realized_pnl,
total_pnl,
volume,
roi,
profit_factor,
win_rate,
trades
entries
LeaderboardEntry · object[]
required

Leaderboard entries

pagination
CursorPagination · object
required

Pagination info