Get Leaderboard
Get the global perpetuals leaderboard, ranked by PnL, notional volume, or current account value across all instruments.
Windows are anchored to calendar UTC boundaries: day starts at 00:00 UTC
today, week at Monday 00:00 UTC, month at the first of the month
00:00 UTC, and all at exchange launch.
PnL is realized PnL minus trading fees plus funding payments, consistent
with the account PnL endpoint; unrealized PnL is excluded. Notional is the
USD value of all fills in the window. Every entry carries both metrics;
rank is the position under the requested sort_by.
PnL, notional, and account value are raw numeric strings from the engine.
Account value is current equity (collateral value plus unrealized PnL).
The background census advances by at most 8,192 accounts on each 60-second
poller tick, so a full publication can span multiple ticks as the account
population grows. For account-value sorting, timestamp is the earlier of
the published census start and the historical window’s computation time,
so stale membership and PnL remain observable if a historical rebuild fails.
When sorting by account value, the requested window still determines which
accounts and historical PnL/notional metrics are included, while the
ranking uses their current equity. Accounts whose equity cannot be computed
are excluded from that ranking. When unrealized PnL is unavailable (for
example, due to stale marks), the display field falls back to collateral
value on PnL/notional entries and address lookups; it does not establish an
equity rank. total counts accounts with published equity in that window.
sort_by=account_value returns 503 while the first completed census is
warming. PnL and notional rankings remain available during that warm-up.
Clients are responsible for decimal and currency presentation formatting.
Rankings are recomputed periodically; timestamp is the computation time.
Returns 25 entries by default and at most 100 per request; only the top
1000 ranks are pageable (offset + limit must not exceed 1000).
Provide address to additionally return that account’s row regardless of
rank. An address with no activity in the window returns zero metrics and
no rank.
Cached 5s — a request served from cache costs 1
Query Parameters
Leaderboard window, anchored to calendar UTC boundaries. day starts at 00:00 UTC today, week at Monday 00:00 UTC, month at the first of the month 00:00 UTC, all at exchange launch.
day, week, month, all Leaderboard ranking metric
pnl, notional, account_value Maximum number of entries to return
100
Number of entries to skip
0
Address
"0x1234567890abcdef1234567890abcdef12345678"
Response
Leaderboard response.
Leaderboard window, anchored to calendar UTC boundaries. day starts at 00:00 UTC today, week at Monday 00:00 UTC, month at the first of the month 00:00 UTC, all at exchange launch.
day, week, month, all Leaderboard ranking metric
pnl, notional, account_value Update timestamp in milliseconds
1767225600000
Total number of ranked accounts
15234
100Leaderboard row for the requested address. rank is absent when the account has no activity in the window, or when sorting by account value and that account has no computed equity in the published census. A collateral-only display fallback does not establish an equity rank.