Skip to content

WebSocket / 24-Hour Ticker Channel

Endpoint: /ws/v1/futures/market

Description

Provides real-time market information including the latest trade price, best bid, best ask, and 24-hour trading statistics.

  • Push interval: up to 500ms
  • No push will be sent if no triggering event occurs
  • Triggering events include: trades

Channel Name

tickers

Subscription Parameters

Parameter Required Type Example Description
op Yes string sub Operation: sub to subscribe, unsub to unsubscribe
channel Yes string tickers Channel name
symbol Yes string BTC-USDT Trading pair

Response Parameters

Parameter Required Type Example Description
errno Yes int 0 Status code
errmsg Yes string success Status message
op Yes string sub Operation: sub or unsub
channel Yes string tickers Channel name
symbol Yes string BTC-USDT Trading pair

Push Data Fields

Parameter Required Type Example Description
channel Yes string tickers Channel name
symbol Yes string BTC-USDT Trading pair
last Yes string 999.2 Last traded price
ask Yes string 999.3 Best ask price
bid Yes string 999.1 Best bid price
open Yes string 999.1 24-hour open price
close Yes string 999.1 24-hour close price
high Yes string 999.1 24-hour high price
low Yes string 999.1 24-hour low price
vol Yes string 2222 24-hour trading volume (contracts)
vol_ccy Yes string 999.1 24-hour trading volume (base currency)
ts Yes long 1597026383085 Event timestamp in milliseconds

Push Example

JSON
{
  "channel": "tickers",
  "symbol": "BTC-USDT",
  "last": "999.2",
  "ask": "999.3",
  "bid": "999.1",
  "open": "999.0",
  "close": "999.2",
  "high": "999.2",
  "low": "999.0",
  "vol": "2222",
  "vol_ccy": "22.22",
  "ts": 1597026383085
}