# 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: 2021/12/2 下午2:36:56