Skip to main content
GET
GET /leaderboard: PnL Leaderboard
Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use request signing examples. Python examples use the signed session from that page; Node.js examples use its bravadoFetch helper.
Returns traders on Polymarket ranked by realized PnL for the requested window. All PnL values are computed under PMWAS. For volume-ranked results, use GET /leaderboard/volume.

Query Parameters

string
default:"30d"
Rolling time window over which to compute PnL. One of 24h, 7d, 30d, all.
integer
default:"100"
Number of traders to return. Maximum 500.
integer
default:"0"
Offset for pagination. See Pagination.
string
Filter: keep only wallets whose dominant category (by volume) equals this value. One of Politics, Crypto, Sports, Science, Tech, Entertainment, Earnings, Finance, Geopolitics, World, Elections, Weather, Other. Not “rank within category X” — and on sub-day windows (1h/4h/24h) this matches the wallet’s all-time dominance, not its dominance within that window. See the same param on GET /leaderboard/volume for the full semantics (window/venue/backfill restrictions are identical on both boards).

Response

array
string
Echo of the window parameter used for the response.
integer
Total number of traders matching the window.
boolean
True if additional pages exist.
object | null
Board-wide aggregate over the same candidate set as total (window, min_trades, is_mm_bot/exclude_bots, and — for the PnL sums — basis) — for a stat-strip header, not for paging. null only if it could not be computed.

Errors

See the Error reference.

Example