Candlesticks (Polymarket, by Condition)

Market-level price history for a Polymarket market, normalized to the YES outcome and bucketed at your chosen interval. For traded dollar and share volume, use the Token Volume and Volume Chart endpoints. Markets without Yes/No outcomes (e.g. Up/Down) resolve to the first outcome.

GET/v2/polymarket/candlesticks/{condition_id}

Plans All plansPlan rate limits apply

Parameters

condition_idstring (path)required

Polymarket condition ID (path parameter).

intervalinteger

Bucket size in minutes. Allowed: 0 (auto-pick), 1, 5, 15, 60, 1440. Default: 0.

start_tsinteger

Start of range, unix seconds. Optional.

end_tsinteger

End of range, unix seconds. Optional.

Response

candlesticksobject[]

OHLCV candles in ascending timestamp order.

Show 6 fields

tinteger

Unix timestamp (seconds) of the bucket start.

onumber

Open price (mid).

hnumber

High - mid-market price for the interval.

lnumber

Low - mid-market price for the interval.

cnumber

Close - mid-market price for the interval.

vnumber | null

Traded volume. Use the Token Volume and Volume Chart endpoints for dollar and share volume.

intervalinteger

Resolved interval in minutes (1, 5, 15, 60, or 1440).

interval_secondsinteger

Resolved interval in seconds.

first_trade_tsinteger | null

Earliest timestamp in the response.

last_trade_tsinteger | null

Latest timestamp in the response.

token_idstring

The YES token ID resolved from the requested condition_id.

condition_idstring

The condition_id from the request.

_metaobject

Source metadata.

Show 3 fields

sourcestring

Data source identifier.

volume_availableboolean

Whether traded volume is included in this series.

notestring

Note describing the price series.

Try it

Sample data

Condition ID*

Interval (minutes)

Start (unix seconds)

End (unix seconds)

Sample mode returns a fixed recorded example; input changes apply to live requests. Switch it off to query live data with these parameters.

{
  "_meta": {
    "note": "Mid-market price series. For traded dollar and share volume, use the Token Volume and Volume Chart endpoints.",
    "source": "polymarket",
    "volume_available": false
  },
  "candlesticks": [
    {
      "c": 0.305,
      "h": 0.305,
      "l": 0.305,
      "o": 0.305,
      "t": 1778932812,
      "v": null
    },
    {
      "c": 0.305,
      "h": 0.305,
      "l": 0.305,
      "o": 0.305,
      "t": 1778936409,
      "v": null
    },
    {
      "c": 0.305,
      "h": 0.305,
      "l": 0.305,
      "o": 0.305,
      "t": 1778940007,
      "v": null
    },
    {
      "c": 0.305,
      "h": 0.305,
      "l": 0.305,
      "o": 0.305,
      "t": 1778943611,
      "v": null
    },
    {
      "c": 0.305,
      "h": 0.305,
      "l": 0.305,
      "o": 0.305,
      "t": 1778947207,
      "v": null
    },
    {
      "c": 0.305,
      "h": 0.305,
      "l": 0.305,
      "o": 0.305,
      "t": 1778950813,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1778954409,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1778958005,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1778961608,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1778965211,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1778968806,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1778972406,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1778976027,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1778979606,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1778983207,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1778986807,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1778990405,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1778994007,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1778997613,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1779001224,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1779004808,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1779008407,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1779012007,
      "v": null
    },
    {
      "c": 0.315,
      "h": 0.315,
      "l": 0.315,
      "o": 0.315,
      "t": 1779015612,
      "v": null
    }
  ],
  "condition_id": "0x8246b715242536356d2938f90df8b50271fcf6d7586495249e2e9f75a1101981",
  "first_trade_ts": 1778932812,
  "interval": 60,
  "interval_seconds": 3600,
  "last_trade_ts": 1779172504,
  "token_id": "68580493576236870766302603986708023994049090291380498445316442868936066297574"
}