GET/v2/live-volume

Get live volume for an event

Cumulative one-side (taker) volume per market. Pass `?event_id=` as a comma-separated list of integer event ids (aliases `id` / `eventId`); every market under those events is returned, `taker_volume` descending, with `taker_volume_total` their sum. A list spans events. Unlike the feeds this is not paginated; `data` is the object with no `pagination`.

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
event_id	query	stringnull	yes	Event id(s), comma-separated (at most 20 distinct values). Required. `event_id` is the unified key across v2 (same as the feeds); `id` and `eventId` are accepted aliases.

event_id is listed as optional in Polymarket's OpenAPI spec, but the API returns 400 without it (checked 2026-10-04).

Example

curl -X GET "https://data-api.polymarket.com/v2/live-volume?event_id=<event_id>"

Response fields

Field	Type	Description
conditions	object[]	One row per market under the requested event(s), `taker_volume` descending; empty when the events resolve to no markets.
taker_volume_total	number	Sum of the rows' `taker_volume`, in shares.

Responses

Status	Meaning
200	Per-market taker volume for the requested event(s), plus taker_volume_total
400	Missing or unparseable event_id, or more than 20 distinct event ids
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 /live-volume Data API v1

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.