Skip to main content
GET
Get the all-traders leaderboard
The response body shown here is a static example, not live data. After you click Send, your live result appears in a separate panel headed 200 OK. The panel under the status-code tabs is a fixed sample from the spec — its field values (fees, prices, sizes, IDs, timestamps) are placeholders. Use Send, or call the endpoint, for current values.
Returns the top-N traders ranked by sortBy (volume, pnl, or fees; default volume) over the requested rolling window (all, 30d, or 24h; default 30d). Each row carries volume, fees paid, realized PnL, and its rank on the active sortBy column, all computed in a single query so the columns are always mutually consistent for a row. pnl is realized only (sum of per-fill closed_pnl); open-position (unrealized) MTM is NOT included. Served from the hourly rollup, which lags real-time by up to the current partial hour. Pass address to fetch just that one trader’s row — its figures and its rank on the sortBy column, wherever it sits on the board (not only within the top-N). limit is ignored in that mode, and an address that did not trade in the window returns an empty entries list. Pagination: limit max is 100 and there is no cursor — fetch up to 100 rows in one call and paginate client-side.

Query Parameters

window
enum<string>
default:30d

Rolling window for the ranking.

Available options:
all,
30d,
24h
sortBy
enum<string>
default:volume

Column to rank by. Determines which top-N traders return and which column each row's rank is computed on.

Available options:
volume,
pnl,
fees
address
string

Optional. When set, return only this trader's row (with its rank on the sortBy column) instead of the top-N list. limit is ignored; an address that did not trade in the window yields an empty entries list.

20-byte EVM address as hex: optional 0x or 0X prefix and exactly 40 hexadecimal digits. API responses normalize to lowercase a–f after 0x.

Pattern: ^(0x|0X)?[0-9a-fA-F]{40}$
limit
integer
default:100

Number of leaderboard rows to return. Default and maximum are both 100; requests above the maximum are silently clamped. Ignored when address is set.

Required range: 1 <= x <= 100

Response

Leaderboard entries.

entries
object[]
required
window
enum<string>
required

The rolling window the ranking was computed over.

Available options:
all,
30d,
24h
sortBy
enum<string>
required

The column the leaderboard was ranked by.

Available options:
volume,
pnl,
fees