---
title: "Get Candlesticks"
method: GET
path: "/polymarket/candlesticks/{condition_id}"
---

# Get Candlesticks

`GET /polymarket/candlesticks/{condition_id}`

Fetches historical candlestick data for a market identified by `condition_id`, over a specified interval.

## Query parameters

- `start_time` integer, required
- `end_time` integer, required
- `interval` 1 | 60 | 1440

## Response `200`

Candlestick response

- object
  - `candlesticks` array[] — Array of market candlestick data, where each element is a tuple containing candlestick data array and token metadata
    - union[] — Tuple of [candlestick_data_array, token_metadata]
      - union
        - object[] — Candlestick data array
        - object — Token metadata
          - `token_id` string
          - `side` string — The outcome label for this token (e.g., 'Yes', 'No', 'Up', 'Down', 'Over', 'Under', or team names for sports markets)

## Other responses

- `400` — Bad Request - Invalid parameters

---

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