/v4/data/prediction/top-traders

200 credits per API call

Ranked leaderboard of top traders, scoped by category and time period. Each row carries the trader's wallet, display fields (username, X handle, profile image), verified-badge status, and the metrics used for ranking (volume and PnL within the requested window).

Platform support

• Polymarket only.

Filtering, sorting and pagination

• category selects the leaderboard slice — one of OVERALL, POLITICS, SPORTS, CRYPTO, CULTURE, MENTIONS, WEATHER, ECONOMICS, TECH, FINANCE. Defaults to OVERALL.
• timePeriod sets the lookback window — DAY, WEEK, MONTH, ALL. Defaults to DAY.
• orderBy chooses the ranking metric: PNL (realised + unrealised profit) or VOL (trading volume). Defaults to PNL.
• user filters the leaderboard to a single wallet — useful for "where does this trader rank" lookups. userName filters by trader display name (substring match).
• Pagination is offset-based — limit (1..50, default 25) and offset (0..1000, default 0). Higher offsets are not supported by the upstream leaderboard.

Other notes

• rank is the continuous 1-indexed position given the requested filters — rank = 1 is the leader for the chosen category and time period.
• proxyWallet is returned lowercased.
• vol and pnl are USD figures, scoped to the requested category and timePeriod.