Skip to main content

Get Mark Price Kline

Query for historical mark price klines. Charts are returned in groups based on the requested interval.

Covers: USDT perpetual / USDC contract / Inverse contract

HTTP Request

GET /v5/market/mark-price-kline

Request Parameters

ParameterRequiredTypeComments
categoryfalsestringProduct type. linear,inverse
  • When category is not passed, use linear by default
  • symboltruestringSymbol name, like BTCUSDT, uppercase only
    intervaltruestringKline interval. 1,3,5,15,30,60,120,240,360,720,D,M,W
    startfalseintegerThe start timestamp (ms)
    endfalseintegerThe end timestamp (ms)
    limitfalseintegerLimit for data size per page. [1, 1000]. Default: 200

    Response Parameters

    ParameterTypeComments
    categorystringProduct type
    symbolstringSymbol name
    listarray
    • An string array of individual candle
    • Sort in reverse by startTime
    > list[0]: startTimestringStart time of the candle (ms)
    > list[1]: openPricestringOpen price
    > list[2]: highPricestringHighest price
    > list[3]: lowPricestringLowest price
    > list[4]: closePricestringClose price. Is the last traded price when the candle is not closed

    Request Example

    GET /v5/market/mark-price-kline?category=linear&symbol=BTCUSDT&interval=15&start=1670601600000&end=1670608800000&limit=1 HTTP/1.1
    Host: api-testnet.bybit.com

    Response Example

    {
    "retCode": 0,
    "retMsg": "OK",
    "result": {
    "symbol": "BTCUSDT",
    "category": "linear",
    "list": [
    [
    "1670608800000",
    "17164.16",
    "17164.16",
    "17121.5",
    "17131.64"
    ]
    ]
    },
    "retExtInfo": {},
    "time": 1672026361839
    }