# 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" // 數據類型
 }

備註

更多返回錯誤代碼請看首頁的錯誤代碼描述

← Websocket 介紹