GET/v2/builders/leaderboard

Get the builders leaderboard

The ranked board of builders by volume. `?time_period=` is `day` (default), `week`, `month` or `all` and selects the **window**; one row per builder in it. Deeper pages come only from `?cursor=`. A cursor **pins the window it was minted on**, so following it needs no `?time_period=`; and passing a different one is a `400` rather than a silent re-point, since an offset from one board means nothing on another.

Base URL: https://data-api.polymarket.com
Auth: Public, no key
Rate limit: 800 req / 10s (80 per second)
Limit applies to: General (all /v2 endpoints)

Things to know

Every v2 response wraps its payload in a data field. Paginated reads return an opaque cursor in pagination and do not accept offset. Under load the API answers 429 with a Retry-After header.

Parameters

Name	In	Type	Required	Description
time_period	query	stringnull	no	Window: `day` \| `week` \| `month` \| `all`. Defaults to `day`.
limit	query	integernull	no	First-page size. Ignored when `cursor` is supplied.
cursor	query	stringnull	no	Opaque pagination cursor from a prior response's `next_cursor`.

Example

curl -X GET "https://data-api.polymarket.com/v2/builders/leaderboard"

Returns a list of objects with these fields

Field	Type	Description
active_users	integer	Distinct active users attributed to the builder in the window.
builder_code	string	Stable identifier of the builder.
builder_name	string	Builder display name; cosmetic; key on `builder_code`.
profile_image	string	Builder profile image URL.
rank	integer	Board rank in the requested window; ties share a rank and the next skips.
verified	boolean	Whether the builder is verified.
volume	number	Volume attributed to the builder in the window, in shares.

Responses

Status	Meaning
200	A page of the builders board
400	Invalid time_period or cursor, or a time_period that contradicts the cursor's
429	Too many requests; retry after `Retry-After`
500	Internal server error
503	Timed out (the request deadline, the datastore statement timeout, or the connection pool's acquire budget) or a serving dependency is unavailable; retry after `Retry-After`

Related endpoints

GET /v2/builders/volume Data API v2

Polymarket's API serves current state only, so it cannot show what a market's book looked like after it resolved. PolyTest records Up/Down markets while they run and keeps the snapshots. Try it free, or read the full rate limit reference.

From Polymarket's published OpenAPI spec and rate-limit tables, synced 2026-10-04.