Skip to main content

Kline

Get kline data

HTTP Request

GET /derivatives/v3/public/kline

Request Parameters

ParameterRequiredTypeComments
categoryfalsestringProduct type. linear,inverse. Default: linear, but in the response category shows ""
symboltruestringSymbol name
intervaltruestringKline interval. 1 3 5 15 30 60 120 240 360 720 D M W
starttrueintegerThe start timestamp (ms)
endtrueintegerThe end timestamp (ms)
limitfalseintegerLimit for data size per page. [1, 1000]. Default: 200

Response Parameters

ParameterTypeComments
symbolstringSymbol name
categorystringProduct type. Keeps empty string "" when category is not passed
listarray
  • An string array of individual candle
  • Sort in reverse by start
  • The default collation within the array is start, open, high, low, close, volume, turnover

Request Example

GET /derivatives/v3/public/kline?category=linear&symbol=BTCPERP&interval=1&start=1670371140000&end=1670371200000 HTTP/1.1
Host: api.bybit.com

Response Example

{
"retCode": 0,
"retMsg": "OK",
"result": {
"symbol": "BTCPERP",
"category": "linear",
"list": [
[
"1670371200000",
"17077",
"17084",
"17077",
"17084",
"0.017",
"290.412"
],
[
"1670371140000",
"17074",
"17077.5",
"17074",
"17077",
"0.006",
"102.457"
]
]
},
"retExtInfo": {},
"time": 1671968612436
}