Skip to main content
GET
Leaderboard

Authorizations

X-API-Key
string
header
required

Your Hypedexer API key. Create one in the console at https://app.hypedexer.com. Authorization: Bearer <key> and the api_key query parameter are accepted as well.

Headers

X-API-Key
string

Query Parameters

by
enum<string>
default:volume

Ranking metric. win_rate, pnl_pct and unrealized_pnl require window. priority_fees (live mode) ranks users by total priority gas paid and returns user, total_priority_gas, fill_count.

Available options:
volume,
pnl,
trades,
win_rate,
pnl_pct,
unrealized_pnl,
priority_fees
hours
integer
default:24

Lookback window in hours (live mode only, ignored with window)

Required range: 1 <= x <= 168
limit
integer
default:20

Users per page: up to 500 in window mode, 100 in live mode

Required range: 1 <= x <= 500
window
enum<string>

Pre-computed ranking across every address, paginated. Omit for live mode.

Available options:
7d,
30d,
all
page
integer
default:1

Page number (window mode). has_more and next_cursor (next page number) tell whether more pages exist; total_count is the number of ranked addresses.

Required range: x >= 1
min_trades
integer
default:10

Window mode: minimum round-trip trades for an address to appear in win_rate and pnl_pct rankings

Required range: x >= 0

Response

200 - application/json

OK

success
boolean
message
string
data
object[]
total_count
integer | null
next_cursor
string | null
has_more
boolean | null