订阅 Market Depth 数据

market.$contract_code.depth.$type

是否验签: 否

接口权限: 读取

限频: 行情类的公开接口，比如：获取K线数据、获取聚合行情、市场行情、获取行情深度数据、获取溢价指数K线、获取实时预测资金费率k线，获取基差数据、获取市场最近成交记录： websocket：req请求，同一时刻最多请求50次；sub请求，无限制，服务器主动推送数据

接口描述: 该接口支持全仓模式和逐仓模式 请求参数contract_code支持交割合约代码，格式为BTC-USDT-210625；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。

订阅地址

环境	地址
线上环境	wss://api.sunx.io/ws/v1/market
线上环境（aws客户首选）	wss://api.sunx.io/ws/v1/market

请求参数

字段名称	类型	说明
无数据

规则说明

订阅(sub)	取消订阅(unsub)	规则
无数据

订阅参数

参数	数据类型	是否必填	描述	取值范围	默认值
contract_code	string	true	合约代码 或 合约标识	永续:BTC-USDT（永续合约代码） ，交割：BTC-USDT-210625（交割合约代码） 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
type	string	true	Depth 类型	(150档数据) step0, step1, step2, step3, step4, step5, step14, step15, step16, step17（合并深度1-5,14-17）,step0时，不合并深度;(20档数据) step6, step7, step8, step9, step10, step11, step12, step13, step18, step19（合并深度7-13,18-19）；step6时，不合并深度；

备注: 合并深度仅改变显示方式，不改变实际成交价格。 step16、step17、step18、step19仅供SHIB-USDT合约使用，暂不支持其他合约使用。 step1至step5, step14至step17是进行了深度合并后的150档深度数据，step7至step13, step18, step19是进行了深度合并后的20档深度数据，对应精度如下： 档位 Depth 类型 精度 150档 step0 不合并 150档 step16 0.0000001 150档 step17 0.000001 150档 step1 0.00001 150档 step2 0.0001 150档 step3 0.001 150档 step4 0.01 150档 step5 0.1 150档 step14 1 150档 step15 10 20档 step6 不合并 20档 step18 0.0000001 20档 step19 0.000001 20档 step7 0.00001 20档 step8 0.0001 20档 step9 0.001 20档 step10 0.01 20档 step11 0.1 20档 step12 1 20档 step13 10

数据更新

参数	数据类型	是否必填	描述	取值范围
ch	string	true	数据所属的 channel，格式： market.period
ts	long	true	数据进入行情服务器时间戳，单位：毫秒
<tick>		false
mrid	long	true	订单ID
id	long	true	tick ID
asks	object	false	卖盘,[price(挂单价), vol(此价格挂单张数)], 按price升序
bids	object	false	买盘,[price(挂单价), vol(此价格挂单张数)], 按price降序
ts	long	true	深度生成时间戳，每100MS生成一次，单位：毫秒
version	long	true	版本号
ch	string	true	数据所属的 channel，格式： market.period
</tick>		false

订阅示例

{
  "sub": "market.BTC-USDT.depth.step0",
  "id": "id5"
}

订阅成功示例

{
  "id": "id1",
  "status": "ok",
  "subbed": "market.BTC-USDT.depth.step0",
  "ts": 1489474081631
}

数据更新示例

{
  "ch": "market.BTC-USDT.depth.step6",
  "ts": 1603707576468,
  "tick": {
    "mrid": 131596447,
    "id": 1603707576,
    "bids": [
      [
        13071.9,
        38
      ],
      [
        13068,
        5
      ]
    ],
    "asks": [
      [
        13081.9,
        197
      ],
      [
        13099.7,
        371
      ]
    ],
    "ts": 1603707576467,
    "version": 1603707576,
    "ch": "market.BTC-USDT.depth.step6"
  }
}

取消订阅示例

{
  "unsub": "market.BTC-USDT.depth.step0",
  "id": "id5"
}