Polymarket Leaderboard

GET/gateway/v1/prediction-market/polymarket/leaderboard

Returns a ranked leaderboard of Polymarket traders by realized PnL, volume, or trade count.

Sortable by `pnl`, `volume`, or `trade_count`. Each entry includes the wallet address and aggregate trading statistics.

Data refresh: ~5 minutes.

Query Parameters

sort_byenum<string>

Ranking metric

Available options:pnlvolumetrade_count

orderenum<string>

Sort direction

Available options:ascdesc

limitinteger

Results per page

offsetinteger

Pagination offset

Polymarket Leaderboard

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/prediction-market/polymarket/leaderboard', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseLeaderboardItem.json",
  "data": [
    {
      "address": "<string>",
      "pnl": 123,
      "positions": 123,
      "positions_lost": 123,
      "positions_open": 123,
      "positions_won": 123,
      "trade_count": 123,
      "volume": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}