Ticker V1

Topic: /contractMarket/ticker:{symbol}

Description

Subscribe this topic to get the realtime push of BBO changes.

The ticker channel provides real-time price updates whenever a match happens. If multiple orders are matched at the same time, only the last matching event will be pushed.

It is not recommended to use this topic any more. For real-time ticker information, please subscribe /contractMarket/tickerV2:{symbol}.

Push frequency: real-time

{
  "id": 1545910660739,
  "type": "subscribe",
  "topic": "/contractMarket/ticker:XBTUSDTM",
  "response": true
}

Response

Data Schema

tickerV1

topic

string

required

type

string

required

subject

string

required

integer

required

data

object

required

symbol

string

required

sequence

integer <int64>

required

side

string

required

size

integer

required

price

string

required

bestBidSize

integer

required

bestBidPrice

string

required

bestAskPrice

string

required

tradeId

string

required

bestAskSize

integer

required

integer <int64>

required

Example

{
    "topic": "/contractMarket/ticker:XBTUSDTM",
    "type": "message",
    "subject": "ticker",
    "sn": 1828964168748,
    "data": {
        "symbol": "XBTUSDTM",
        "sequence": 1828964168748,
        "side": "buy",
        "size": 2,
        "price": "86429.7",
        "bestBidSize": 112,
        "bestBidPrice": "86429.6",
        "bestAskPrice": "86429.7",
        "tradeId": "1828964168748",
        "bestAskSize": 1578,
        "ts": 1740642161735000000
    }
}

Request

Query Params

token

string

required

The token required to establish a websocket connection

Example:

2neAiuYvAU61ZDXANAGAsiL4-iAExhsBXZxftpOeh_55i3Ysy2q2LEsEWU64mdzUOPusi34M_wGoSf7iNyEWJzXbfe8VU3FBitj9GBKOxznq_vFdPFuOytiYB9J6i9GjsxUuhPw3Blq6rhZlGykT3Vp1phUafnulOOpts-MEmEH0rh6aQ4MJMT4XzQkr2-prJBvJHl5Vs9Y=.dzV-5TpKaqa1ZGsGqaicbQ==

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/ticker:{symbol}#

Subscribe Message#

Response#

Request

Topic: /contractMarket/ticker:{symbol}

Subscribe Message

Response