# Get OHLC candlestick data

GET /api/v1/market-data/ohlc

## Get OHLC candlestick data

> 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.

```json
{"openapi":"3.1.1","info":{"title":"FortyTwo Read API","version":"1.0"},"tags":[{"description":"GET /api/v1/market-data/ohlc","name":"get-ohlc"}],"servers":[{"url":"https://rest.ft.42.space/"}],"paths":{"/api/v1/market-data/ohlc":{"get":{"description":"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.","tags":["get-ohlc"],"summary":"Get OHLC candlestick data","parameters":[{"schema":{"type":"string"},"description":"Market contract address","name":"market","in":"query","required":true},{"schema":{"type":"string"},"description":"Outcome token ID (provide token_id or outcome_index, not both)","name":"token_id","in":"query"},{"schema":{"type":"integer"},"description":"Outcome index, 0-based (provide token_id or outcome_index, not both)","name":"outcome_index","in":"query"},{"schema":{"type":"string","enum":["10s","1m","3m","30m","2h","6h","12h","1d"]},"description":"Candle bucket interval","name":"interval","in":"query","required":true},{"schema":{"type":"integer"},"description":"Start unix timestamp (default: 24h before end_ts)","name":"start_ts","in":"query"},{"schema":{"type":"integer"},"description":"End unix timestamp (default: now)","name":"end_ts","in":"query"},{"schema":{"type":"integer"},"description":"Max data points returned (default 500, max 5000)","name":"limit","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/handler.OHLCResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/api.ErrorResponse"}}}}}}}},"components":{"schemas":{"handler.OHLCResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/handler.OHLCDataPoint"}}}},"handler.OHLCDataPoint":{"type":"object","properties":{"c":{"type":"number"},"h":{"type":"number"},"l":{"type":"number"},"o":{"type":"number"},"payoutClose":{"type":"number"},"payoutHigh":{"type":"number"},"payoutLow":{"type":"number"},"payoutMid":{"type":"number"},"payoutOpen":{"type":"number"},"t":{"type":"integer"},"v":{"type":"number"}}},"api.ErrorResponse":{"type":"object","properties":{"code":{"type":"integer"},"error":{"type":"string"},"message":{"type":"string"}}}}}}
```