Get the trader leaderboard
The ranked board of realized PnL, combos included.
?time_period= is day (default), week, month or all; ?category=
is overall (default) or a market category; ?sort_by= picks the PNL
(default) or VOLUME board. Deeper pages come only from ?cursor=.
A cursor pins the board it was minted on; sort, window and category;
so following it needs no params at all, and restating a different one is a
400 rather than a silent re-point (the builders-board pattern).
?user= answers a different question; one wallet’s standing, carrying
both the PnL and volume ranks in a single object rather than a page. A
rank of 0 there means unranked for that board, not first. sort_by,
limit and cursor do not apply to that arm.
rank ties and skips: tied users share a rank and the next one jumps,
so a partition’s highest rank approaches its row count. Page with the
cursor; never compute a page from a rank.
Finite windows (day/week/month) serve the MARKED equity change net of
flows; they move with unrealized marks; all is the realized-only
lifetime ledger. volume is in shares, not USDC.
Query Parameters
Response
A page of the board, or one wallet's standing when user is given
- Option 1
- Option 2
Either arm's body. ?user= answers with one standing; everything else with
a page of the board; genuinely different shapes, so the spec says oneOf
rather than pretending one covers both.