Polymarket Volume History

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

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

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_rangeenum<string>

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

Available options:7d30d90d180d1y

Example: 30d

intervalenum<string>

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

Available options:1h1d

Example: 1d

granularityenum<string>

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

Available options:dayweekmonthyearall

start_timeinteger

Start time as Unix seconds (alternative to time_range)

end_timeinteger

End time as Unix seconds (alternative to time_range)

Polymarket Volume History

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/prediction-market/polymarket/volumes?condition_id=0x6fefc0438c7598b23531457c8c60541990d0786bd4bd9dfc3eabc8d95c291092&time_range=30d&interval=1d', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponsePolymarketVolumePoint.json",
  "data": [
    {
      "buy_volume": 123,
      "notional_volume_usd": 123,
      "sell_volume": 123,
      "timestamp": 123,
      "trade_count": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}