Polymarket API reference / Data API v1
GET/v1/builders/leaderboard

Get aggregated builder leaderboard

**Data API v2:** this route has a v2 counterpart, `GET /v2/builders/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

NameInTypeRequiredDescription
timePeriodquerystringnoThe time period to aggregate results over.
limitqueryintegernoMaximum number of builders to return
offsetqueryintegernoStarting index for pagination

Example

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

Returns a list of objects with these fields

FieldTypeDescription
rankstringThe rank position of the builder
builderstringThe builder name or identifier
builderCodestringThe builder's onchain attribution code as attached to orders via `builderCode` (see CLOB V2). Empty string for legacy builders without a registered code.
volumenumberTotal trading volume attributed to this builder
activeUsersintegerNumber of active users for this builder
verifiedbooleanWhether the builder is verified
builderLogostringURL to the builder's logo image

Responses

StatusMeaning
200Success
400Bad Request
500Server Error

Related endpoints

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.