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

categoryfalsestringProduct type. linear,inverse
  • When category is not passed, use linear by default
  • symboltruestringSymbol name
    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

    categorystringProduct type
    symbolstringSymbol name
    • 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

    Response Example

    "retCode": 0,
    "retMsg": "OK",
    "result": {
    "symbol": "BTCUSDT",
    "category": "linear",
    "list": [
    "retExtInfo": {},
    "time": 1672026361839