Klines

Topic: /contractMarket/limitCandle:{symbol}_{type}

Description

Subscribe to this topic to get K-Line data. If there is no change in the market, data will not be pushed

The 'type' in the topic is to get the kline granuarity and can have following values:
1min, 3min, 5min, 15min, 30min, 1hour, 2hour, 4hour, 8hour, 12hour, 1day, 1week, 1month

Push frequency: 1s

{
  "id": 1545910660739,
  "type": "subscribe",
  "topic": "/contractMarket/limitCandle:XBTUSDTM_1min,ETHUSDTM_1min",
  "response": true
}

Response

Data Schema

klines

topic

string

required

type

string

required

subject

string

required

data

object

required

symbol

string

required

Symbol of the contract, Please refer to Get Symbol endpoint: symbol

candles

array[string]

required

Start time, open price, close price, high price, low price, Transaction volume(This value is incorrect, please do not use it, we will fix it in subsequent versions), Transaction amount

time

integer <int64>

required

timestamp(ms)

Example

{
    "topic": "/contractMarket/limitCandle:XBTUSDTM_1min",
    "type": "message",
    "data": {
        "symbol": "XBTUSDTM",
        "candles": [
            "1731898200", //Start time of the candle cycle
            "90638.6",    //open price
            "90638.6",    //close price    
            "90638.6",    //high price
            "90638.6",    //low price
            "21.0",      //Transaction volume(This value is incorrect, please do not use it, we will fix it in subsequent versions)
            "21"         //Transaction amount
        ],
        "time": 1731898208357
    },
    "subject": "candle.stick"
}

Request

Query Params

token

string

required

The token required to establish a websocket connection

Example:

2neAiuYvAU61ZDXANAGAsiL4-iAExhsBXZxftpOeh_55i3Ysy2q2LEsEWU64mdzUOPusi34M_wGoSf7iNyEWJ5L-EC7BtqnpYjR8gv1-fvDMhNUmkkWztdiYB9J6i9GjsxUuhPw3Blq6rhZlGykT3Vp1phUafnulOOpts-MEmEEfgimtWbtRdrNxixuN5wueJBvJHl5Vs9Y=.dN4sS8wBGiemrhhCOGcs1w==

connectId

string

optional

Connection Id, a unique value taken from the client side. Both the id of the welcome message and the id of the error message are connectId.

Example:

121345

Topic: /contractMarket/limitCandle:{symbol}_{type}#

Subscribe Message#

Response#

Request

Topic: /contractMarket/limitCandle:{symbol}_{type}

Subscribe Message

Response