ASasksurf
Prediction Market

Polymarket Volume History

Aggregate trading volume (USD) and trade count as a time series. Use this for volume trend analysis. For YES/NO volume breakdown by outcome side, use volume-split instead.

Data refresh: ~30 minutes

get/gateway/v1/prediction-market/polymarket/volumes

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

condition_idstring

Market condition identifier (required if token_id not provided)

Example:0x6fefc0438c7598b23531457c8c60541990d0786bd4bd9dfc3eabc8d95c291092
token_idstring

Token ID (alternative identifier, resolved to condition_id internally)

time_range'7d' | '30d' | '90d' | '180d' | '1y'

Window of history to return (how much data, from now backward): 7d, 30d, 90d, 180d, or 1y. Distinct from interval (which sets bucket size within the window).

Example:30d
interval'1h' | '1d'

Bucket size for each point in the returned series: 1h (hourly) or 1d (daily). Distinct from time_range (which sets the window size).

Example:1d
granularity'day' | 'week' | 'month' | 'year' | 'all'

Aggregation granularity (alternative to interval). When provided, queries daily table with buy/sell volume breakdown.

start_timeinteger

Start time as Unix seconds (alternative to time_range)

end_timeinteger

End time as Unix seconds (alternative to time_range)

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponsePolymarketVolumePoint.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.