Get Candles

Fetch OHLCV candles from the Polymarket CLOB /prices-history endpoint.

The CLOB returns price history keyed by token_id, not condition_id. This endpoint resolves the token_id from the cached price data.

GET /v1/markets/{condition_id}/candles

Get Candles

cURL

curl --request GET \
  --url https://staging-api.polysimulator.com/v1/markets/{condition_id}/candles \
  --header 'X-API-Key: <x-api-key>'

200

[
  {
    "t": 123,
    "o": "<string>",
    "h": "<string>",
    "l": "<string>",
    "c": "<string>"
  }
]

Headers

X-API-Key · string · required

Your PolySimulator API key

Path Parameters

condition_id · string · required

Query Parameters

outcome · string · default: Yes

Outcome label

interval · string · default: 1h

Interval: 1h, 6h, 1d, 1w, max

Response

200

application/json

Successful Response

t · integer · required

o · string | null

h · string | null

l · string | null

c · string | null