Skip to main content
GET
/
v1
/
leaderboard
Get trader leaderboard rankings
curl --request GET \
  --url https://data-api.polymarket.com/v1/leaderboard
[
  {
    "rank": "<string>",
    "proxyWallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
    "userName": "<string>",
    "vol": 123,
    "pnl": 123,
    "profileImage": "<string>",
    "xUsername": "<string>",
    "verifiedBadge": true
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
category
enum<string>
default:OVERALL

Market category for the leaderboard

Available options:
OVERALL,
POLITICS,
SPORTS,
CRYPTO,
CULTURE,
MENTIONS,
WEATHER,
ECONOMICS,
TECH,
FINANCE
​
timePeriod
enum<string>
default:DAY

Time period for leaderboard results

Available options:
DAY,
WEEK,
MONTH,
ALL
​
orderBy
enum<string>
default:PNL

Leaderboard ordering criteria

Available options:
PNL,
VOL
​
limit
integer
default:25

Max number of leaderboard traders to return

Required range: 1 <= x <= 50
​
offset
integer
default:0

Starting index for pagination

Required range: 0 <= x <= 1000
​
user
string

Limit leaderboard to a single user by address User Profile Address (0x-prefixed, 40 hex chars)

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

​
userName
string

Limit leaderboard to a single username

Response

Success

​
rank
string

The rank position of the trader

​
proxyWallet
string

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

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

​
userName
string

The trader's username

​
vol
number

Trading volume for this trader

​
pnl
number

Profit and loss for this trader

​
profileImage
string

URL to the trader's profile image

​
xUsername
string

The trader's X (Twitter) username

​
verifiedBadge
boolean

Whether the trader has a verified badge