ASasksurf
Prediction Market

Polymarket OHLCV Candlesticks

OHLCV candlestick data for charting a Polymarket market — open, high, low, close, volume per candle. Use this for rendering price charts with candlestick or bar visualizations. For simple price time series (one price per interval), use prices instead.

Data refresh: ~30 minutes

get/gateway/v1/prediction-market/polymarket/price-ohlcv/{condition_id}

Request

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

Path parameters

condition_idstring required

Polymarket condition ID

Example:0x6fefc0438c7598b23531457c8c60541990d0786bd4bd9dfc3eabc8d95c291092

Query parameters

start_timeinteger

Start time (Unix seconds). 0 means no lower bound. Cache aligns to 5-minute buckets, so two requests within the same bucket return the same cached result.

end_timeinteger

End time (Unix seconds). 0 means current time. Cache aligns to 5-minute buckets, so two requests within the same bucket return the same cached result.

intervalinteger

Candle interval in minutes: 1=1min, 60=1hour, 1440=1day

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

condition_idstring required
intervalinteger required

Example response

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

Changes

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