---
title: "Get Candlesticks"
method: GET
path: "/v2/polymarket/candlesticks/{condition_id}"
tags: ["polymarket"]
---

# Get Candlesticks

`GET /v2/polymarket/candlesticks/{condition_id}`

Fetch historical candlestick data for a market.

Returns combined OHLCV data from both YES and NO tokens, normalized to YES perspective.
NO token prices are converted as (1 - price) and volumes are combined.

## Path parameters

- `condition_id` string, required — Condition ID for the market

## Query parameters

- `start_time` integer, nullable — Unix timestamp (seconds) for start of time range
- `end_time` integer, nullable — Unix timestamp (seconds) for end of time range
- `interval` integer — Interval: 0=auto, 1=1m, 5=5m, 15=15m, 60=1h, 1440=1d

## Response `200`

Successful Response

- CandlesticksResponse — Candlesticks endpoint response.
  - `condition_id` string, nullable — Market condition ID (set for condition-level candles)
  - `token_id` string, nullable — Outcome token ID (set for token-level candles)
  - `first_trade_ts` integer, nullable — Unix timestamp of the first trade
  - `last_trade_ts` integer, nullable — Unix timestamp of the last trade
  - `interval` integer, required — Resolved candle interval in minutes (1, 5, 15, 60, or 1440). Reflects the auto-selected value when interval=0 is requested.
  - `interval_seconds` integer, required — Resolved candle interval in seconds — the bucket width of each candlestick
  - `candlesticks` CandlestickData[], required — Array of candlestick data points
    - `end_period_ts` integer, required
    - `price` PriceData, required — Price data within candlestick.
      - `open` number, required
      - `high` number, required
      - `low` number, required
      - `close` number, required
      - `open_dollars` string, required
      - `high_dollars` string, required
      - `low_dollars` string, required
      - `close_dollars` string, required
      - `mean` number, required
      - `mean_dollars` string, required
      - `previous` number, required
      - `previous_dollars` string, required
    - `volume` number, required
    - `trades_count` integer, required

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

[API](https://skmtc.net/predexon/apis/predexon-api.md) · [All operations](https://skmtc.net/predexon/apis/predexon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/predexon/predexon-api/versions/80a306fbdb39/schema)