# Websocket 行情推送

# 1. 訂閱逐筆交易

逐筆交易推送每一筆成交的信息。成交,或者說交易的定義是僅有一個吃單者與一個掛單者相互交易

訂閱類型

dataType 為 <symbol>@trade,比如BTC-USDT@trade ETH-USDT@trade

訂閱例子

{"id":"24dd0e35-56a4-4f7a-af8a-394c7060909c","dataType":"BTC-USDT@trade"}

訂閱參數

參數名 參數類型 必填 描述
symbol String 合約名稱中需有"-",如BTC-USDT

推送數據

返回欄位 欄位說明
dataType 訂閱的數據類型,例如 BTC-USDT@trade
data 推送內容
e 事件類型
E 事件時間
s 交易對
t 交易ID
p 成交價格
q 成交數量
T 成交時間
m 買方是否是做市方。如true,則此次成交是一個主動賣出單,否則是一個主動買入單。
  # Response
  {
      "data": {
            "E": 1649832413551,
            "T": 1649832413512,
            "e": "trade",
            "p": "40125.48",
            "q": "0.007146",
            "s": "BTC-USDT",
            "t": "33685717"
            "m": true
     },
     "dataType": "BTC-USDT@trade"
  }

# 2. K線 Streams

K線stream逐秒推送所請求的K線種類(最新一根K線)的更新。

訂閱類型

dataType 為 <symbol>@kline_<interval>,比如BTC-USDT@kline_1min

訂閱例子

{"id":"e745cd6d-d0f6-4a70-8d5a-043e4c741b40","dataType":"BTC-USDT@kline_1min"}

訂閱參數

參數名 參數類型 必填 欄位描述 描述
symbol String 合約名稱 合約名稱中需有"-",如BTC-USDT
interval String k線類型 參考欄位說明,K線類型,1min, 5min, 15min, 30min, 60min, 1day

備註

目前僅提供一分鐘的k線數據

klineType 欄位說明
1min 1min一分鐘K線

推送數據

返回欄位 欄位說明
dataType 訂閱的數據類型,例如 BTC-USDT@kline_1min
data 推送內容
e 事件類型
E 事件時間
s 交易對
K 數據
t 這根K線的起始時間
T 這根K線的結束時間
s 交易對
i K線間隔
o 這根K線期間第一筆成交價
c 這根K線期間末一筆成交價
h 這根K線期間最高成交價
l 這根K線期間最低成交價
v 這根K線期間成交量
n 這根K線期間成交筆數
q 這根K線期間成交額
 # Response
{
"data": {
"E": 1649832726550,
       "K": {
        "T": 1649832779999,
         "c": "40017.48",
         "h": "40027.83",
         "i": "1min",
         "l": "40017.48",
         "n": 13,
         "o": "40025.42",
         "q": "2693.492344",
         "s": "BTC-USDT",
         "t": 1649832720000,
         "v": "0.067295"
   },
       "e": "kline",
       "s": "BTC-USDT"
},
 "dataType": "BTC-USDT@kline_1min"
}

# 3. 有限檔深度信息

 每秒推送有限檔深度信息。默認20檔,某些小幣種可能不足20檔,可以選擇100檔

訂閱類型

  dataType 為 <symbol>@depth<level>,比如BTC-USDT@depth, BTC-USDT@depth20, BTC-USDT@depth100 

訂閱例子

 {"id":"975f7385-7f28-4ef1-93af-df01cb9ebb53","dataType":"BTC-USDT@depth"}

訂閱參數

參數名 參數類型 必填 欄位描述 描述
symbol String 合約名稱 合約名稱中需有"-",如BTC-USDT

推送數據

返回欄位 欄位說明
dataType 訂閱的數據類型,例如 BTC-USDT@depth
data 推送內容
bids 變動的買單深度
asks 變動的賣單深度
 # Response
{
   "dataType": "BTC-USDT@depth",
   "data": {
     "bids": [
           [
             "43302.00", // 變動的價格檔位
             "0.000021"  // 數量
           ]
     ],
       "asks": [
           [
             "43499.00", // 變動的價格檔位
             "0.000021"  // 數量
           ]
       ]
    }
}
Last Updated: 7/27/2022, 11:04:42 AM