---
title: "Kline"
method: GET
path: "/api/v1/public/kline"
tags: ["Public API V1"]
---

# Kline

`GET /api/v1/public/kline`

The endpoint retrieves information about market kline.

<Note>
The API caches the response for: 1 second
</Note>

<Warning>
Rate limit 1000 requests/10 sec.
</Warning>

<Note>
The maximum number of candles per request is 1440. Use `limit` (default: 1440, max: 1440) to control the number of results. Use `start` and `end` timestamps to page through historical data.
</Note>

<Note>
Request validation errors return HTTP `200` with `success: false`, `result: null`, and a `message` object mapping each invalid field to the corresponding messages — for example `{"market": ["Market is not available."]}` or `{"end": ["End field must be greater then start."]}`.
</Note>

## Query parameters

- `market` string, required
- `start` integer
- `end` integer
- `interval` '1s' | '10s' | '30s' | '1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' | '6h' | '8h' | '12h' | '1d' | '3d' | '1w' | '1M'
- `limit` integer

## Response `200`

Successful response

- object
  - `success` boolean
  - `message` string, nullable
  - `result` array[]
    - union[] — [Time in seconds, Open, Close, High, Low, Volume stock, Volume money]
      - union
        - integer
        - string

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4.md) · [All operations](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whitebit/whitebit-private-http-api-v4/revisions/76c9def9942f/schema)