# 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 介绍