Volume Chart (Polymarket, by Condition)

Trading volume time series for a Polymarket market, broken down by YES and NO outcome, computed from market trades.

GET/v2/polymarket/volume-chart/{condition_id}

Plans All plansPlan rate limits apply

Parameters

condition_idstring (path)required

Polymarket condition 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.

condition_idstring

The Polymarket condition ID.

bucketstring

Bucket size: hour | day | week.

bucket_secondsinteger

Bucket size in seconds.

yes_token_idstring | null

Resolved YES outcome token ID.

no_token_idstring | null

Resolved NO outcome token ID.

yes_outcome_labelstring | null

Outcome label used for the YES side (e.g. "Yes", "Up").

no_outcome_labelstring | null

Outcome label used for the NO side (e.g. "No", "Down").

seriesobject[]

Per-bucket volume with YES/NO breakdown, ascending by t.

Show 7 fields

tinteger

Bucket start (unix seconds).

total_dollarnumber

Total dollar volume in this bucket.

total_sharenumber

Total share volume in this bucket.

yes_dollarnumber

Dollar volume on the YES side.

no_dollarnumber

Dollar volume on the NO side.

yes_sharenumber

Share volume on the YES side.

no_sharenumber

Share volume on the NO side.

_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.