Core

Get trader leaderboard rankings

Returns trader leaderboard rankings filtered by category, time period, and ordering.

get/v1/leaderboard

Request

  • Base URL: https://data-api.polymarket.com
  • URL: https://data-api.polymarket.com/v1/leaderboard
  • Auth: none declared

Query parameters

category'OVERALL' | 'POLITICS' | 'SPORTS' | 'CRYPTO' | 'CULTURE' | 'MENTIONS' | 'WEATHER' | 'ECONOMICS' | 'TECH' | 'FINANCE'

Market category for the leaderboard

timePeriod'DAY' | 'WEEK' | 'MONTH' | 'ALL'

Time period for leaderboard results

orderBy'PNL' | 'VOL'

Leaderboard ordering criteria

limitinteger

Max number of leaderboard traders to return

offsetinteger

Starting index for pagination

userstring

User Profile Address (0x-prefixed, 40 hex chars)

Example:0x56687bf447db6ffa42ffe2204a05edaa20f55839

Limit leaderboard to a single user by address

userNamestring

Limit leaderboard to a single username

Response

Success

rankstring

The rank position of the trader

proxyWalletstring

User Profile Address (0x-prefixed, 40 hex chars)

userNamestring

The trader's username

volnumber

Trading volume for this trader

pnlnumber

Profit and loss for this trader

profileImagestring

URL to the trader's profile image

xUsernamestring

The trader's X (Twitter) username

verifiedBadgeboolean

Whether the trader has a verified badge

Example response

[
  {
    "proxyWallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.