Token Volume Time Series (Polymarket)

Cumulative trading volume time series for a single Polymarket outcome token, computed from market trades.

GET/v2/polymarket/markets/{token_id}/volume

Plans All plansPlan rate limits apply

Parameters

token_idstring (path)required

Polymarket outcome token ID (path parameter).

bucketstring

Bucket size: hour | day | week. Default: hour.

start_tsinteger

Start of range, unix seconds. Defaults to 24 hours before end_ts. Clamped to >= 2026-05-19T00:00:00Z (the served floor). Pass an explicit value for longer history, up to the bucket limit.

end_tsinteger

End of range, unix seconds. Default: now.

Response

_meta.materialized_throughinteger | null

Exclusive Unix-second materialization watermark. Recent absent buckets may not yet be aggregated; older buckets can change with late trades.

_meta.last_refresh_atstring | null

Last successful aggregate refresh (ISO 8601).

_meta.latest_completed_hour_materializedboolean

Whether the latest complete hour is materialized as of _meta.as_of. Day/week buckets can still be partial.

_meta.aggregation_lag_secondsinteger | null

Seconds between _meta.as_of and the materialization watermark. Responses are cached for 20 seconds.

token_idstring

Polymarket outcome token ID.

bucketstring

Bucket size: hour | day | week.

bucket_secondsinteger

Bucket size in seconds.

seriesobject[]

Per-bucket cumulative volume in ascending timestamp order.

Show 5 fields

tinteger

Bucket start (unix seconds).

bucket_dollar_volumenumber

Sum of trade notional in this bucket (USDC).

bucket_share_volumenumber

Sum of trade size in this bucket (shares).

cumulative_dollar_volumenumber

Running total of dollar volume from series start.

cumulative_share_volumenumber

Running total of share volume from series start.

_metaobject

Data warning metadata.

Show 2 fields

data_available_fromstring

ISO8601 served floor - earlier ranges are not served (2026-05-19T00:00:00Z).

warningstring

Plain-text coverage statement.