Skip to main content
GET
GET /leaderboard: Wallet 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.
Ranks Polymarket wallets for the requested window by the chosen metric, with trading-style include/exclude and volume/trade floors. Fixed to Polymarket (no venue parameter). See response conventions for the number, timestamp and null rules.

Query Parameters

string
default:"all_time"
Rolling window: one of 1d, 7d, 30d, all_time.
string
Rank metric: one of total_pnl, roi, win_rate, volume, trades.
string
Sort direction: asc or desc.
string
Include only wallets carrying this trading style (e.g. WHALE, MARKET_MAKER). Case-insensitive.
string
Exclude wallets carrying this trading style.
number
Minimum volume in USD.
integer
Minimum trade count.
integer
Rows per page, up to 100.
string
Opaque cursor from the previous page’s pagination.pagination_key.

Response

array
object
limit, count, has_more (boolean), pagination_key (string or null).
integer
Unix seconds the snapshot was computed.