---
title: "Get OHLC candlestick data"
method: GET
path: "/api/v1/market-data/ohlc"
tags: ["get-ohlc"]
---

# Get OHLC candlestick data

`GET /api/v1/market-data/ohlc`

Returns OHLC (open/high/low/close) candlestick data for a specific outcome token over a given time range and bucket interval. Provide token ID or outcome index (not both). Payout fields are included for resolved markets.

## Query parameters

- `market` string, required
- `token_id` string
- `outcome_index` integer
- `interval` '1s' | '10s' | '1m' | '3m' | '30m' | '2h' | '6h' | '12h' | '1d', required
- `start_ts` integer
- `end_ts` integer
- `limit` integer

## Response `200`

OK

- InternalHandlerOHLCResponse
  - `data` InternalHandlerOHLCDataPoint[]
    - `c` number
    - `closeCollateral` number
    - `closeMintedQuantity` number
    - `h` number
    - `l` number
    - `o` number
    - `openCollateral` number
    - `openMintedQuantity` number
    - `payoutClose` number
    - `payoutHigh` number
    - `payoutLow` number
    - `payoutMid` number
    - `payoutOpen` number
    - `t` integer
    - `v` number

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/42/apis/fortytwo-read-api.md) · [All operations](https://skmtc.dev/42/apis/fortytwo-read-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/42/fortytwo-read-api/revisions/660740bda403/schema)