Token Volume Time Series (Polymarket)
ADMIN-ONLY (gated, not yet public). Cumulative trading volume time series for a single Polymarket outcome token, computed from market_trades. Bucket presets: hour (90d max), day (1y max), week (3y max). Series begins at 2026-04-28T22:28:14Z — the earliest market_trades.executed_at for polymarket. Cumulative volume from before that date is not represented; the response includes a _meta.data_available_from warning.
/v2/polymarket/markets/{token_id}/volumeQuery Parameters
Polymarket outcome token ID (path parameter).
Bucket size: hour | day | week. Default: hour.
Start of range, unix seconds. Default: 2026-04-28T22:28:14Z.
End of range, unix seconds. Default: now.
Response Schema
Polymarket outcome token ID.
Bucket size: hour | day | week.
Bucket size in seconds.
Per-bucket cumulative volume in ascending timestamp order.
Bucket start (unix seconds).
Sum of trade notional in this bucket (USDC).
Sum of trade size in this bucket (shares).
Running total of dollar volume from series start.
Running total of share volume from series start.
Data warning metadata.
ISO8601 timestamp before which trade data is missing.
Plain-text caveat about the data window.
Authentication
API Key
To secure your requests, we strongly recommend passing your API key via the X-API-Key header. This prevents sensitive keys from being exposed in access logs or browser history.
X-API-Key: pmx_test_5e8f...Rate Limits
API rate limits are enforced based on the tier associated with your API key. Limits are tracked on two dimensions: requests per second and requests per month. Each completed request counts toward the global monthly quota. Separate endpoint-group monthly limits (matched markets, arbitrage, EV) only advance when the response body has success: true.
Usage is returned on responses via headers such as:
X-RateLimit-Limit-Second: 10X-RateLimit-Remaining-Second: 9X-RateLimit-Limit-Month: 1000X-RateLimit-Remaining-Month: 842Example (endpoint-group, when applicable)X-RateLimit-Limit-Arb-Month: 500X-RateLimit-Remaining-Arb-Month: 412If you exceed a rate limit, the API returns a 429 status with a Retry-After header indicating when you can resume.
Request
Live API Key
Parameters
Response
—Click EXECUTE to send a request →