公共频道
深度频道
描述
获取深度数据books,books5,books15默认推送频率:150msbooks1默认推送频率:10ms
books对应全量深度数据,首次推送全量数据:snapshot,后续推送增量变化数据:updatebooks1对应1档位深度数据,每次推送:snapshotbooks5对应5档位深度数据,每次推送:snapshotbooks15对应15档位深度数据,每次推送:snapshot
seq说明
- update增量消息的seq在除币对维护的情况是递增的
Code
请求参数
| 参数名 | 参数类型 | 是否必须 | 描述 |
|---|---|---|---|
| op | String | 是 | 操作, subscribe unsubscribe |
| args | List<Object> | 是 | 请求订阅的频道列表 |
| > instType | String | 是 | 产品类型USDT-FUTURES U本位合约COIN-FUTURES 币本位合约USDC-FUTURES USDC合约 |
| > channel | String | 是 | 频道名: books/books1/books5/books15 |
| > instId | String | 是 | 产品ID |
Code
返回参数
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| event | String | 事件 |
| arg | Object | 订阅的频道 |
| > instType | String | 产品类型USDT-FUTURES U本位合约COIN-FUTURES 币本位合约USDC-FUTURES USDC合约 |
| > channel | String | 频道名: books/books1/books5/books15 |
| > instId | String | 产品ID |
| msg | String | 错误消息 |
| code | String | 错误码 |
Code
推送数据参数
| 返回字段 | 参数类型 | 字段说明 |
|---|---|---|
| arg | Object | 订阅成功的频道 |
| > instType | String | 产品类型USDT-FUTURES U本位合约COIN-FUTURES 币本位合约USDC-FUTURES USDC合约 |
| > channel | String | 频道名: books/books1/books5/books15 |
| > instId | String | 产品ID |
| action | String | 推送数据动作, 增量推送数据还是全量推送数据 |
| data | List<Object> | 订阅的数据 |
| > asks | List<String> | 卖方深度 |
| > bids | List<String> | 买方深度 |
| > ts | String | 撮合引擎时间戳,Unix时间戳的毫秒数格式,如 1597026383085 |
| > seq | Long | 序列号 订单簿更新时递增,可以用来判断是否乱序 |
| > pseq | String | 上次推送序列号books 频道:推送增量变化数据时有值且非0;books1、books5、books15 频道:固定返回 0。可用来判断是否丢包 |
| ts | String | 数据推送时间 |
