Skip to main content

Get K-line Data

Description

Get K-line data of the designated trading pair

HTTP Request

GET /v3/market/candles

Request Parameters

ParameterRequiredTypeDescription
symbolYesStringA trading pair, consisting of two currencies: base currency and quote currency
intervalYesString
  • MINUTE_1
  • MINUTE_5
  • MINUTE_15
  • MINUTE_30
  • HOUR_1
  • HOUR_2
  • HOUR_4
  • HOUR_12
  • DAY_1
  • DAY_3
  • WEEK_1
limitNoIntegerNumber of results per request. The default limit is 100, with a maximum of 500.
sTimeNoLongStart time
eTimeNoLongEnd time

Response Parameters

ParameterTypeDescription
lStringLowest price
hStringHighest price
oStringOpening price
cStringClosing price
amtStringTrading unit, the quantity of the quote currency.
qtyStringTrading unit, the quantity of the base currency, or Cont for the number of contracts.
tCStringTrades
sTStringStart time
cTStringEnd time

Request Example

{
"symbol": "BTC_USDT_PERP",
"interval": "MINUTE_1",
"limit": "10"
}

Response Example

{
"code": 200,
"data": [
[
"58651",
"58651",
"58651",
"58651",
"0",
"0",
"0",
"0",
"0",
"1719975420000",
"1719975479999"
],
[
"58651",
"58651",
"58651",
"58651",
"0",
"0",
"0",
"0",
"0",
"1719975480000",
"1719975539999"
],
[
"58651",
"58651",
"58651",
"58651",
"0",
"0",
"0",
"0",
"0",
"1719975540000",
"1719975599999"
],
[
"58651",
"58651",
"58651",
"58651",
"0",
"0",
"0",
"0",
"0",
"1719975600000",
"1719975659999"
],
[
"58651",
"58651",
"58651",
"58651",
"0",
"0",
"0",
"0",
"0",
"1719975660000",
"1719975719999"
],
[
"58651",
"58651",
"58651",
"58651",
"0",
"0",
"0",
"0",
"0",
"1719975720000",
"1719975779999"
],
[
"58651",
"58651",
"58651",
"58651",
"0",
"0",
"0",
"0",
"0",
"1719975780000",
"1719975839999"
],
[
"58651",
"58651",
"58651",
"58651",
"0",
"0",
"0",
"0",
"0",
"1719975840000",
"1719975899999"
],
[
"58651",
"58651",
"58651",
"58651",
"0",
"0",
"0",
"0",
"0",
"1719975900000",
"1719975959999"
],
[
"58651",
"58651",
"58651",
"58651",
"0",
"0",
"0",
"0",
"0",
"1719975960000",
"1719976019999"
]
],
"msg": "Success"
}