订阅买一卖一逐笔行情推送

market.$contract_code.bbo

是否验签: 否

接口权限: 读取

限频: 行情类的公开接口，比如：获取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（次季合约标识）

数据更新

参数	数据类型	是否必填	描述	取值范围
ch	string	true	数据所属的 channel，格式： market.$contract_code.bbo
ts	long	true	响应生成时间点，单位：毫秒（指接口响应时间）
<tick>	object	true
ch	string	true	数据所属的 channel，格式： market.$contract_code.bbo
mrid	string	true	订单ID
id	long	true	tick ID
ask	array	false	卖一盘,[price(挂单价), vol(此价格挂单张数)]
bid	array	false	买一盘,[price(挂单价), vol(此价格挂单张数)]
version	long	true	版本号
ts	long	true	响应生成时间点，单位：毫秒（指数据生成时间）
</tick>		false

备注: 当买一价、买一量、卖一价、卖一量，其中任一数据发生变化时，进行逐笔推送； 如果同一时刻有多个买一卖一的价格/单量的变化，直接用最新的买一卖一进行推送，直接丢弃中间结果； 由于客户端网络等原因导致接收数据失败，服务端会丢弃旧的队列数据； version（版本号），直接取撮合id，保证全局唯一并且最新的推送版本号都是数值最大的。

订阅示例

{
  "sub": "market.BTC-USDT.bbo",
  "id": "id8"
}

订阅成功示例

{
  "id": "id8",
  "status": "ok",
  "subbed": "market.BTC-USDT.bbo",
  "ts": 1489474081631
}

数据更新示例

{
  "ch": "market.BTC-USDT.bbo",
  "ts": 1603707934525,
  "tick": {
    "mrid": 131599726,
    "id": 1603707934,
    "bid": [
      13064,
      38
    ],
    "ask": [
      13072.3,
      205
    ],
    "ts": 1603707934525,
    "version": 131599726,
    "ch": "market.BTC-USDT.bbo"
  }
}

取消订阅示例

{
  "unsub": "market.BTC-USDT.bbo",
  "id": "id8"
}