深度

描述

获取深度数据，books是全量深度频道，books1是1档频道，books5是5档频道，books50是50档频道；

• books 对应全量深度数据,首次推送全量数据 snapshot，后续推送增量变化数据: update
• books1 对应1档位深度数据,每次推送: snapshot
• books5 对应5档位深度数据,每次推送: snapshot
• books50 对应50档位深度数据,每次推送: snapshot

现货

• books1 推送频率:60ms
• books5 推送频率:200ms
• books50 推送频率:200ms
• books 推送频率:200ms
• 深度频道 books1 推送频率优化为20ms ，优化的交易对为：BTCUSDT, ETHUSDT, XRPUSDT ,SOLUSDT ,SUIUSDT,DOGEUSDT,ADAUSDT,PEPEUSDT ,LINKUSDT ,HBARUSDT

合约

• books1 推送频率:100ms
• books5 推送频率:150ms
• books50 推送频率:150ms
• books 推送频率:150ms
• 深度频道 books1 推送频率优化为20ms ，优化的交易对为：BTCUSDT, ETHUSDT, XRPUSDT ,SOLUSDT ,SUIUSDT,DOGEUSDT,ADAUSDT,PEPEUSDT ,LINKUSDT ,HBARUSDT

上次推送序列号 pseq :

• 正常情况下，深度频道推送的序列号是增长的，即在一个推送序列里接收到的seq值总是大于pseq。
• 在系统发布等服务重启的情况下，序列号可能会被重置。此时用户大概率会收到一个 pseq=0的推送消息。重置后，所有后续消息将继续按正常顺序排序。

请求示例

{
    "op": "subscribe",
    "args": [
        {
            "instType": "usdt-futures",
            "topic": "books1",
            "symbol": "BTCUSDT"
        }
    ]
}

请求参数

参数名	参数类型	是否必须	描述
op	String	是	操作 subscribe 订阅 unsubscribe 退订
args	List<Object>	是	请求订阅的频道列表
> instType	String	是	产品线类型 spot 现货交易 usdt-futures USDT合约 coin-futures 币本位合约 usdc-futures USDC合约
> topic	String	是	频道名 books全部档位频道 books1一档频道 books5五档频道 books50五十挡频道
> symbol	String	是	交易对名称 例如BTCUSDT

订阅返回示例

{
  "event": "subscribe",
  "arg": {
    "instType": "usdt-futures",
    "topic": "books1",
    "symbol": "BTCUSDT"
  }
}

返回参数

返回字段	参数类型	字段说明
event	String	事件
arg	Object	订阅的频道
> instType	String	产品线类型 spot 现货交易 usdt-futures USDT合约 coin-futures 币本位合约 usdc-futures USDC合约
> topic	String	频道名
> symbol	String	交易对名称
code	String	错误码
msg	String	错误消息

推送返回示例

{
  "data": [
    {
      "a": [
        [
          "99756.7",
          "23.9774"
        ]
      ],
      "b": [
        [
          "99756.6",
          "0.0128"
        ]
      ],
      "checksum": 0,
      "pseq":0,
      "seq": 1304314508780744705,
      "ts": "1746698732562"
    }
  ],
  "arg": {
    "instType": "usdt-futures",
    "symbol": "BTCUSDT",
    "topic": "books1"
  },
  "action": "snapshot",
  "ts": 1746698732563
}

推送数据参数

返回字段	参数类型	字段说明
arg	Object	订阅成功的频道
> instType	String	产品线类型 spot 现货交易 usdt-futures USDT合约 coin-futures 币本位合约 usdc-futures USDC合约
> topic	String	频道名
> symbol	String	交易对名称
action	String	推送数据动作 snapshot全量 update 增量
data	List<String>	订阅的数据
> a	String	卖方深度
> > a[0]	String	卖一价
> > a[1]	String	卖一量
> b	String	买方深度
> > b[0]	String	买一价
> > b[1]	String	买一量
> > checksum	String	校验和 用于校验数据准确性
> >seq	String	序列号 订单簿更新时递增，可以用来判断是否乱序
> >pseq	String	上次推送序列号，可以用来判断是否丢包
> >ts	String	撮合时间戳