GET/v2/builders/volume

Get builder volume over time

The per-builder volume time series. `?interval=` is the **bucket width**, not a window: `day` (default) returns every day on record bucketed daily, `week` and `month` bucket accordingly, and `all` buckets by calendar YEAR. `?limit=` bounds how many of the most recent buckets come back (default 30); buckets, not rows, so a period is never returned half-populated. `timePeriod` is accepted as an alias for `interval`.

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
interval	query	stringnull	no	Bucket width: `day` \| `week` \| `month` \| `all`. Defaults to `day`. `timePeriod` and `time_period` are accepted aliases.
limit	query	integernull	no	How many of the most recent buckets to return. Defaults to 30, capped at 90; a lower ceiling than the rest of the surface, because only ~308 daily buckets exist and the family maximum would return the whole series.

Example

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

Returns a list of objects with these fields

Field	Type	Description
active_users	integer	Distinct active users attributed in that bucket.
builder_code	string	Stable identifier of the builder.
builder_name	string	Builder display name; cosmetic; key on `builder_code`.
date	string	Bucket start date, `YYYY-MM-DD` (UTC); `interval` sets the width.
profile_image	string	Builder profile image URL.
rank	integer	Builder's rank within that bucket.
verified	boolean	Whether the builder is verified.
volume	number	Volume attributed in that bucket, in shares.

Responses

Status	Meaning
200	The volume series for the requested interval
400	Invalid interval
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/leaderboard 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.