Reality深度频道

描述

订阅 Reality 美股指定交易对的实时深度数据。

每次均推送全量快照（snapshot）。该接口返回的深度数据是不合并的原始深度。

接入要求

• 该频道需 API Key 认证，且要提前联系 BD 申请开通白名单权限。

请求示例

{
    "op": "subscribe",
    "args": [
        {
            "instType": "UTA",
            "topic": "reality-orderbook",
            "symbol": "RAAPLUSDT"
        }
    ]
}

请求参数

参数名	参数类型	是否必须	描述
op	String	是	操作 subscribe 订阅 unsubscribe 退订
args	List<Object>	是	请求订阅的频道列表
> instType	String	是	产品线类型 固定传 UTA
> topic	String	是	频道名 固定传 reality-orderbook
> symbol	String	是	交易对名称 例如RAAPLUSDT

订阅返回示例

{
  "event": "subscribe",
  "arg": {
    "instType": "UTA",
    "topic": "reality-orderbook",
    "symbol": "RAAPLUSDT"
  }
}

返回参数

返回字段	参数类型	字段说明
event	String	操作 subscribe 订阅 unsubscribe 退订 error 参数错误
arg	Object	订阅的频道
> instType	String	产品线类型 固定传 UTA
> topic	String	频道名 固定传 reality-orderbook
> symbol	String	交易对名称
code	String	错误码
msg	String	错误消息

推送返回示例

{
  "arg": {
    "instType": "UTA",
    "topic": "reality-orderbook",
    "symbol": "RAAPLUSDT"
  },
  "action": "snapshot",
  "ts": 1740000000000,
  "data": [
    {
      "symbol": "RAAPLUSDT",
      "a": [
        ["227.55", "80"],
        ["227.60", "300"]
      ],
      "b": [
        ["227.50", "100"],
        ["227.45", "250"]
      ],
      "pseq": "0",
      "seq": "0",
      "ts": "0"
    }
  ]
}

推送数据参数

返回字段	参数类型	字段说明
arg	Object	订阅成功的频道
> instType	String	产品线类型 固定传 UTA
> topic	String	频道名 固定传 reality-orderbook
> symbol	String	交易对名称
action	String	推送数据动作 snapshot 全量
ts	String	数据推送时间戳，Unix 时间戳的毫秒数格式
data	List<Object>	订阅的数据
> symbol	String	交易对名称
> a	List<Array>	卖盘档位，每项为 [price, size]，按价格升序排列
> > a[0]	String	卖出价格
> > a[1]	String	卖出数量
> b	List<Array>	买盘档位，每项为 [price, size]，按价格降序排列
> > b[0]	String	买入价格
> > b[1]	String	买入数量
> pseq	String	上次推送序列号
> seq	String	序列号
> ts	String	固定返回 0，暂未启用