# Websocket 行情推送

# 1. 訂閱合約交易深度

訂閱合約對盤口深度的數據的推送,此主題發送最新市場深度快照。快照頻率為每秒1次。

訂閱類型

dataType 為 market.depth.$Symbol.$Step.$Level,比如market.depth.BTC-USDT.step0.level5

訂閱參數

參數名 參數類型 必填 描述
symbol String 合約名稱中需有"-",如BTC-USDT
step String 合併深度類型,step0,step1,step2,step3,step4,step5
level String 檔數, 如 level5,level10,level20,level50,level100

備註

"step" 合併深度類型

參數名 描述
step0 不合併深度
step1 按價格最小精度乘以10合併深度數據
step2 按價格最小精度乘以100合併深度數據
step3 按價格最小精度乘以1000合併深度數據
step4 按價格最小精度乘以10000合併深度數據
step5 按價格最小精度乘以100000合併深度數據

"level" 深度檔數定義

參數名 描述
level5 5檔
level10 10檔
level20 20檔
level50 50檔
level100 100檔

推送數據

返回欄位 欄位說明
code 是否有錯誤信息,0為正常,1為有錯誤
dataType 訂閱的數據類型,例如 market.depth.BTC-USDT.step0.level5
data 推送內容
asks 賣方深度
bids 買方深度
p price價格
v volume數量
    # Response
    {
        "code": 0,
        "dataType": "market.depth.BTC-USDT.step0.level5",
        "data": {
            "asks": [
                {
                    "p": 5319.94,
                    "v": 0.05483456
                },{
                    "p": 5320.19,
                    "v": 1.05734545
                },{
                    "p": 5320.39,
                    "v": 1.16307999
                },{
                    "p": 5319.94,
                    "v": 0.05483456
                },{
                    "p": 5320.19,
                    "v": 1.05734545
                },{
                    "p": 5320.39,
                    "v": 1.16307999
                },
            ],
            "bids": [
                {
                    "p": 5319.94,
                    "v": 0.05483456
                },{
                    "p": 5320.19,
                    "v": 1.05734545
                },{
                    "p": 5320.39,
                    "v": 1.16307999
                },{
                    "p": 5319.94,
                    "v": 0.05483456
                },{
                    "p": 5320.19,
                    "v": 1.05734545
                },{
                    "p": 5320.39,
                    "v": 1.16307999
                },
            ],
        }
    }

# 2. 訂單最新成交記錄

訂閱單個合約的逐筆成交明細

訂閱類型

dataType 為 market.trade.detail.$Symbol,比如market.trade.detail.BTC-USDT

訂閱參數

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

推送數據

返回欄位 欄位說明
code 是否有錯誤信息,0為正常,1為有錯誤
dataType 訂閱的數據類型,例如 market.tradeDetail.BTC-USDT
data 推送內容
trades 逐筆成交
time 成交時間
makerSide 吃單方向(Bid / Ask 買/賣)
price 成交價格
volume 成交數量
 # Response
 {
     "code": 0,
     "dataType": "market.tradeDetail.BTC-USDT",
     "data": {
         "trades": [
             {
                 "time": "2018-04-25T15:00:51.999Z",
                 "makerSide": "Bid",
                 "price": 0.279563,
                 "volume": 100,
             },
             {
                 "time": "2018-04-25T15:00:51.000Z",
                 "makerSide": "Ask",
                 "price": 0.279563,
                 "volume": 300,
             }
         ]
     }
 }

# 3. 訂閱合約k線數據

訂閱單個合約的行情k線數據

訂閱類型

dataType 為 market.kline.$Symbol.$KlineType,比如market.kline.$Symbol.BTC-USDT.1min

訂閱參數

參數名 參數類型 必填 欄位描述 描述
symbol String 合約名稱 合約名稱中需有"-",如BTC-USDT
klineType String k線類型 參考欄位說明,如分鐘,小時,周等

備註

klineType 欄位說明
1 1m一分鐘K線
3 3m三分鐘K線
5 5m五分鐘K線
15 15m十五分鐘K線
30 30m三十分鐘K線
60 1h一小時K線
120 2h兩小時K線
240 4h四小時K線
360 6h六小時K線
720 12h十二小時K線
1D 1D日K線
1W 1W周K線
1M 1M月K線

推送數據

返回欄位 欄位說明
code 是否有錯誤信息,0為正常,1為有錯誤
data 推送內容
dataType 數據類型
klineInfosVo K線數據
close 收盤價
high 最高價
low 最低價
open 收盤價
statDate k線時間
time k線時間戳,單位是毫秒
volume 成交量
 # Response
 {
     "code": 0,
     "data": {
         "klineInfosVo": [
             {
                 "close": 54564.31, 
                 "high": 54711.73,
                 "low": 54418.27,
                 "open": 54577.41, 
                 "statDate": "2021-04-29T11:00:00.000+0800", 
                 "time": 1619665200000, 
                 "volume": 1607.0727000000002
             }
         ]
     },
     "dataType": "market.kline.BTC-USDT.30min" // 數據類型
 }

備註

更多返回錯誤代碼請看首頁的錯誤代碼描述
Last Updated: 2/12/2021 下午2:36:56