Get Klines - KUCOIN API

Description

Get the symbol’s candlestick chart. Data are returned in grouped buckets based on requested type.
For each query, the system will return at most 500 pieces of data. To obtain more data, please page the data by time.

Tips

Candlestick chart data may be incomplete. No data is published for intervals where there are no ticks.

If the specified start/end time and the time granularity exceed the maximum size allowed for a single request, the system will only return 500 pieces of data for your request. If you want to get fine-grained data in a larger time range, you will need to specify the time ranges and make multiple requests for multiple times.

If you’ve specified only the start time in your request, the system will return 500 pieces of data from the specified start time to the current time of the system; if only the end time is specified, the system will return 500 pieces of data closest to the end time; if neither the start time nor the end time is specified, the system will return the 500 pieces of data closest to the current time of the system.

Request

Query Params

symbol

string

required

Symbol of the contract. Please refer to Get Symbol endpoint: symbol, indexSymbol, premiumsSymbol1M, premiumsSymbol8H

Examples:

XBTUSDTM.KXBTUSDT.XBTUSDTMPI.XBTUSDTMPI8H

granularity

enum<integer> <int64>

required

Type of candlestick patterns (minutes)

Allowed values:

15153060120240480720144010080

from

integer <int64>

optional

Start time (milliseconds)

Example:

1728552342000

integer <int64>

optional

End time (milliseconds)

Example:

1729243542000

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

code

string

required

data

array [array]

required

number

optional

Start time of the candle cycle, opening price, highest price, lowest price, closing price, transaction volume

Example

{
  "code": "200000",
  "data": [
    [
      1728576000000,
      60791.1,
      61035,
      58940,
      60300,
      5501167
    ],
    [
      1728604800000,
      60299.9,
      60924.1,
      60077.4,
      60666.1,
      1220980
    ],
    [
      1728633600000,
      60665.7,
      62436.8,
      60650.1,
      62255.1,
      3386359
    ]
  ]
}