---
title: "Get candle history (OHLCV)"
method: GET
path: "/klines"
tags: ["Market Data"]
---

# Get candle history (OHLCV)

`GET /klines`

Returns historical candlestick data for charting.

**Supported intervals**: 10s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M

## Query parameters

- `symbol` string, required
- `interval` '10s' | '1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' | '6h' | '8h' | '12h' | '1d' | '3d' | '1w' | '1M', required
- `startTime` integer
- `endTime` integer

## Response `200`

Successful response

- Candle[]
  - `t` integer, required — Open timestamp (ms)
  - `T` integer, required — Close timestamp (ms)
  - `o` number, required — Open price
  - `h` number, required — High price
  - `l` number, required — Low price
  - `c` number, required — Close price
  - `v` number, required — Volume
  - `n` integer, required — Number of trades

## Other responses

- `500` — Internal Server Error - Database or channel error

---

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