---
title: "Get Candlesticks By Token"
method: GET
path: "/v2/polymarket/candlesticks/token/{token_id}"
tags: ["polymarket"]
---

# Get Candlesticks By Token

`GET /v2/polymarket/candlesticks/token/{token_id}`

Fetch historical candlestick data for a single outcome token.

Returns raw OHLCV data for this specific token — no YES/NO normalization is
applied, so NO-token prices stay as NO prices (e.g. ~$0.30 in a 70/30 market).
Volume is only from trades of this token; summing the YES and NO token volumes
over the same window approximates the condition-level volume.

## Path parameters

- `token_id` string, required — Outcome token ID

## 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.dev/predexon/apis/predexon-api.md) · [All operations](https://skmtc.dev/predexon/apis/predexon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/predexon/predexon-api/revisions/80a306fbdb39/schema)