GET
/v1/leaderboardGet trader leaderboard rankings
**Data API v2:** this route has a v2 counterpart, `GET /v2/leaderboard`. See [Migrating to Data API v2](/migrate/data-api-v1-to-v2).
- Base URL
- https://data-api.polymarket.com
- Auth
- Public, no key
- Rate limit
- 1,000 req / 10s (100 per second)
- Limit applies to
- Data API general
Things to know
Data API v1 has been frozen since 4 September 2026. It still answers, but new fields and endpoints only go to v2.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| category | query | string | no | Market category for the leaderboard |
| timePeriod | query | string | no | Time period for leaderboard results |
| orderBy | query | string | no | Leaderboard ordering criteria |
| limit | query | integer | no | Max number of leaderboard traders to return |
| offset | query | integer | no | Starting index for pagination |
| user | query | string | no | Limit leaderboard to a single user by address |
| userName | query | string | no | Limit leaderboard to a single username |
Example
curl -X GET "https://data-api.polymarket.com/v1/leaderboard"Returns a list of objects with these fields
| Field | Type | Description |
|---|---|---|
| rank | string | The rank position of the trader |
| proxyWallet | string | User Profile Address (0x-prefixed, 40 hex chars) |
| 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 |
Responses
| Status | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad Request |
| 500 | Server Error |
Related endpoints
- GET /v1/accounting/snapshot Data API v1
- GET /v1/activity/combos Data API v1
- GET /v1/positions/combos Data API v1
- GET /v1/market-positions Data API v1
- GET /v1/builders/leaderboard Data API v1
- GET /v1/builders/volume Data API v1
From Polymarket's published OpenAPI spec and rate-limit tables, synced 2026-10-04.