/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.