---
title: "Get Kline"
method: GET
path: "/api/v1/market/kline"
tags: ["Market"]
---

# Get Kline

`GET /api/v1/market/kline`

## Request

- Base URL: `https://api.ekiden.fi`
- URL: `https://api.ekiden.fi/api/v1/market/kline`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ekidenfi/apis/ekiden-gateway/docs/api/v1/market/kline/get.ts> (a function with typed inputs; its response is checked against the schema)

Query for historical klines (also known as candles/candlesticks). Charts are returned in groups based on the requested interval.

## Query parameters

- `symbol` string, required
- `interval` '1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' | '6h' | '12h' | '1d' | '3d' | '1w' | '1M', required
- `start_time` string, date-time, nullable
- `end_time` string, date-time, nullable
- `limit` integer, nullable

## Response `200`

Klines

- GetKlineResponse: Kline response.
  - `list` KlineSnapshot[], required
    - `Q` string, required: Taker buy quote asset volume. Binance `Q` field.
    - `T` string, date-time, required: Candle close time (ms).
    - `V` string, required: Taker buy base asset volume. Binance `V` field.
    - `c` string, required: Close - the price of the last trade in this candle (closing price).
    - `h` string, required: High - the highest trade price within this interval.
    - `i` '1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' | '6h' | '12h' | '1d' | '3d' | '1w' | '1M', required
    - `l` string, required: Low - the minimum trade price within this interval.
    - `n` string, required: Trade count. The number of trades included in this candle
    - `o` string, required: Open - the price of the first trade in this candle (opening price).
    - `t` string, date-time, required: Candle open time (ms).
    - `v` string, required: Volume. the trading volume for the candle
  - `symbol` string, required

## Changes

- **2026-05-28** `75ffe546b73a`: 2 info
  - added the required property `list/items/Q` to the response with the `200` status
  - added the required property `list/items/V` to the response with the `200` status
- **2026-01-29** `16fe50636aa5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/changes/api/v1/market/kline/get.md)

---

[API](https://skmtc.dev/ekidenfi/apis/ekiden-gateway.md) - [All operations](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/revisions/fad9eecaba2e?raw)