---
title: "Polymarket OHLCV Candlesticks"
method: GET
path: "/gateway/v1/prediction-market/polymarket/price-ohlcv/{condition_id}"
tags: ["Prediction Market"]
---

# Polymarket OHLCV Candlesticks

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

## Request

- Base URL: `https://api.asksurf.ai`
- URL: `https://api.asksurf.ai/gateway/v1/prediction-market/polymarket/price-ohlcv/{condition_id}`
- Auth: HTTP bearer

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

## Path parameters

- `condition_id` string, required: Polymarket condition ID

## Query parameters

- `start_time` integer: 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_time` integer: 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.
- `interval` integer: Candle interval in minutes: 1=1min, 60=1hour, 1440=1day

## Response `200`

OK

- V2CandlestickResponse
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `candles` V2CandlestickData[], nullable, required
    - `close` number, double, required: Closing price
    - `end_period_ts` integer, required: Period end Unix timestamp (seconds)
    - `high` number, double, required: Highest price in period
    - `low` number, double, required: Lowest price in period
    - `open` number, double, required: Opening price
    - `timestamp` integer, required: Period start Unix timestamp (seconds)
    - `trades_count` integer, required: Number of trades
    - `volume` number, double, required: Total shares traded
  - `condition_id` string, required
  - `interval` integer, required

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api.md) - [All operations](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/revisions/91774fdd5302?raw)