Trader Leaderboard (Polymarket)

The canonical Polymarket trader leaderboard, ranked by profit or volume across all time. Look up any wallet's exact rank in the global ranking.

GET/v2/polymarket/leaderboard

Plans All plansPlan rate limits apply

Parameters

categorystring

Market category filter. One of: OVERALL (default), POLITICS, SPORTS, CRYPTO, CULTURE, MENTIONS, WEATHER, ECONOMICS, TECH, FINANCE.

timePeriodstring

Time window. One of: DAY (default), WEEK, MONTH, ALL.

orderBystring

Sort key. One of: PNL (default), VOL.

limitinteger

Number of rows to return. Range 1-50, default 25.

offsetinteger

Starting index in the ranking. Range 0-1000, default 0. Combined with limit, list iteration is bounded to rank ~1050.

userstring

Optional. 0x-prefixed wallet address - returns the single row at that wallet's rank in the global ranking. Use this to look up ranks beyond the pagination cap.

userNamestring

Optional. Single-user lookup by Polymarket username.

Response

categorystring

Echoed back: market category filter applied.

time_periodstring

Echoed back: time window applied (DAY/WEEK/MONTH/ALL).

order_bystring

Echoed back: sort key (PNL or VOL).

limitinteger

Echoed back: max rows requested.

offsetinteger

Echoed back: starting index in the global ranking.

countinteger

Number of rows returned in this response.

leaderboardobject[]

Ranked rows. Same data Polymarket's own UI displays.

Show 8 fields

rankinteger

Global rank position for the (category, time_period, order_by) tuple.

proxy_walletstring

Trader's Polygon wallet address (0x-prefixed).

user_namestring

Display name on Polymarket. Often the wallet address itself when no custom username has been set.

x_usernamestring | null

Linked X/Twitter username if the trader has connected one.

verified_badgeboolean

Whether Polymarket has issued a verified badge for the trader.

profile_image_urlstring | null

Profile image URL if set.

volnumber

Trading volume (USD) for the selected period.

pnlnumber

Profit and loss (USD) for the selected period.

_metaobject

Response metadata.

Show 2 fields

sourcestring

Data source identifier.

pagination_capstring

List iteration is capped near rank 1050. Pass ?user= for deeper rank lookups.

Try it

Sample data

Category

Time Period

Order By

Limit (1–50)

Offset (0–1000)

User Address (single-user lookup)

Sample mode returns a fixed recorded example; input changes apply to live requests. Switch it off to query live data with these parameters.

{
  "_meta": {
    "pagination_cap": "List iteration is capped near rank 1050. For ranks beyond that, query by `?user=` against the global ranking.",
    "source": "polymarket"
  },
  "category": "OVERALL",
  "count": 25,
  "leaderboard": [
    {
      "pnl": 529421.3149377331,
      "profile_image_url": null,
      "proxy_wallet": "0xa5ea13a81d2b7e8e424b182bdc1db08e756bd96a",
      "rank": 1,
      "user_name": "bossoskil1",
      "verified_badge": false,
      "vol": 792872.124721,
      "x_username": null
    },
    {
      "pnl": 421695.01445889514,
      "profile_image_url": null,
      "proxy_wallet": "0x86283633b8d8ee0c0d6db3ce4c7a23f811f56f0b",
      "rank": 2,
      "user_name": "Katello",
      "verified_badge": false,
      "vol": 1262928.847223,
      "x_username": null
    },
    {
      "pnl": 243864.3100410049,
      "profile_image_url": null,
      "proxy_wallet": "0xfbf3d501e88815464642d0e913f15379c3eeb218",
      "rank": 3,
      "user_name": "VPenguin",
      "verified_badge": false,
      "vol": 142348.06571999996,
      "x_username": "Vlad_kori"
    },
    {
      "pnl": 221801.15213551105,
      "profile_image_url": null,
      "proxy_wallet": "0x9b1e0334569aa1768a07705a859686aad58e82c9",
      "rank": 4,
      "user_name": "FullPicks1",
      "verified_badge": false,
      "vol": 645161.29032,
      "x_username": null
    },
    {
      "pnl": 205594.23546935222,
      "profile_image_url": null,
      "proxy_wallet": "0xbddf61af533ff524d27154e589d2d7a81510c684",
      "rank": 5,
      "user_name": "Countryside",
      "verified_badge": false,
      "vol": 1088442.173045,
      "x_username": null
    },
    {
      "pnl": 197409.01502970903,
      "profile_image_url": null,
      "proxy_wallet": "0x971a4bb4c480c7bbee0a4e1bee72459b21ac447d",
      "rank": 6,
      "user_name": "0x971a4Bb4c480C7BbEE0A4e1BEe72459b21ac447d-1778884311892",
      "verified_badge": false,
      "vol": 284451.03,
      "x_username": null
    },
    {
      "pnl": 181382.11375191607,
      "profile_image_url": null,
      "proxy_wallet": "0x1136368d7f6728e94ed14c532ab95a932f710c2e",
      "rank": 7,
      "user_name": "arlanta",
      "verified_badge": false,
      "vol": 64181.532694999994,
      "x_username": null
    },
    {
      "pnl": 179187.18318233718,
      "profile_image_url": null,
      "proxy_wallet": "0x53757615de1c42b83f893b79d4241a009dc2aeea",
      "rank": 8,
      "user_name": "0x53757615de1c42b83f893b79d4241a009dc2aeea",
      "verified_badge": false,
      "vol": 683263.958379,
      "x_username": null
    },
    {
      "pnl": 170326.30880300017,
      "profile_image_url": null,
      "proxy_wallet": "0xa0f21e6d351baa9185716b5c00c2925ed9621848",
      "rank": 9,
      "user_name": "0xa0f21e6d351baa9185716b5c00c2925ed9621848",
      "verified_badge": false,
      "vol": 196775,
      "x_username": null
    },
    {
      "pnl": 138177.68747515598,
      "profile_image_url": null,
      "proxy_wallet": "0x2c335066fe58fe9237c3d3dc7b275c2a034a0563",
      "rank": 10,
      "user_name": "0x2c335066FE58fe9237c3d3Dc7b275C2a034a0563-1759935795465",
      "verified_badge": false,
      "vol": 1235285.482423,
      "x_username": null
    },
    {
      "pnl": 128247.78781278494,
      "profile_image_url": "https://polymarket-upload.s3.us-east-2.amazonaws.com/profile-image-3880352-2c848d1c-d674-41af-a677-157d83998b8b.gif",
      "proxy_wallet": "0x6ade597c0e2b43c0bf3542cada8a5e330d73f5b0",
      "rank": 11,
      "user_name": "TheOnlyHuman",
      "verified_badge": false,
      "vol": 69007.096628,
      "x_username": null
    },
    {
      "pnl": 122646.58278634746,
      "profile_image_url": null,
      "proxy_wallet": "0x19254b55e7c48e88baab9e62cc218223a6544654",
      "rank": 12,
      "user_name": "coon777",
      "verified_badge": false,
      "vol": 23095.465791000002,
      "x_username": null
    },
    {
      "pnl": 86904.80545304576,
      "profile_image_url": null,
      "proxy_wallet": "0xfe787d2da716d60e8acff57fb87eb13cd4d10319",
      "rank": 13,
      "user_name": "ferrariChampions2026",
      "verified_badge": false,
      "vol": 1751559.3337680001,
      "x_username": null
    },
    {
      "pnl": 76476.54398785485,
      "profile_image_url": null,
      "proxy_wallet": "0x4bff30af91642dc7d2b19a8664378fe55c45fc26",
      "rank": 14,
      "user_name": "Sassy-Bucket",
      "verified_badge": false,
      "vol": 8310.956919,
      "x_username": null
    },
    {
      "pnl": 75065.86390726443,
      "profile_image_url": null,
      "proxy_wallet": "0x5966db1fe50763c9e3c014d756369bad07e1f804",
      "rank": 15,
      "user_name": "0x5966Db1fE50763C9e3C014d756369BAd07E1F804-1777648534241",
      "verified_badge": false,
      "vol": 0,
      "x_username": null
    }
  ],
  "limit": 25,
  "offset": 0,
  "order_by": "PNL",
  "time_period": "DAY"
}