Get Klines

Request via this endpoint to get the kline of the specified symbol. Data are returned in grouped buckets based on requested type.

TIP

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

TIP

Klines should not be polled frequently. If you need real-time information, use the trade and book endpoints along with the websocket feed.

HTTP REQUEST

GET /api/v1/market/candles

Example

GET /api/v1/market/candles?type=1min&symbol=BTC-USDT&startAt=1566703297&endAt=1566789757

[
  [
    "1545904980", //Start time of the candle cycle
    "0.058", //opening price
    "0.049", //closing price
    "0.058", //highest price
    "0.049", //lowest price
    "0.018", //Transaction volume
    "0.000945" //Transaction amount
  ],
  ["1545904920", "0.058", "0.072", "0.072", "0.058", "0.103", "0.006986"]
]

REQUEST URL

This endpoint support Spot URL

REQUEST RATE LIMIT

Public weight：3

PARAMETERS

Param	Type	Mandatory	Description
symbol	String	Yes	symbol
startAt	long	No	Start time (second), default is 0
endAt	long	No	End time (second), default is 0
type	String	Yes	Type of candlestick patterns: 1min, 3min, 5min, 15min, 30min, 1hour, 2hour, 4hour, 6hour, 8hour, 12hour, 1day, 1week, 1month

TIP

For each query, the system would return at most 1500 pieces of data. To obtain more data, please page the data by time.

RESPONSES

Param	Description
time	Start time of the candle cycle
open	Opening price
close	Closing price
high	Highest price
low	Lowest price
volume	Transaction volume(One-sided transaction volume)
turnover	Transaction amount(One-sided transaction amount)