为了进一步提升订单簿数据的准确性和同步效率,我们对合约及现货的WebSocket 订单簿推送逻辑进行了重要优化 ,具体内容如下:
功能更新说明
1.合约订单簿频道推送新增档位标识字段 l 更新范围 : futures.order_book 与 futures.order_book_update 频道 更新说明 : 推送新增 l (level)字段用于标识用户订阅时指定的 订单簿档位参数 。 示例 : 订阅参数 ["BTC_USDT", "5", "0"] 对应推送数据中 " l ":"5" ,标明当前数据基于5档深度生成。
{"channel":"futures.order_book","event":"all","result":{"asks":[{"p":"94364.1","s":41549},{"p":"94364.2","s":2201},{"p":"94366","s":281},{"p":"94366.1","s":938},{"p":"94367","s":212}],"bids":[{"p":"94364","s":10000},{"p":"94362.3","s":2},{"p":"94362","s":10},{"p":"94360.4","s":2},{"p":"94359.2","s":59}],"contract":"BTC_USDT","id":81045888518,"l":"5","t":1745721460828},"time":1745721460,"time_ms":1745721460831}
部署进度: 实盘环境:已部署
2.现货订单簿频道推送新增档位标识字段 l
更新范围 : spot.order_book 频道
更新说明 : 现货频道推送的 l 字段定义与合约市场完全对齐。
部署进度:
模拟环境:已部署
实盘环境:未部署
现货模拟环境WebSocket地址: wss://ws-testnet.gate.io/v4/ws/spot
3.现货订单簿更新频道逻辑优化 更新范围 : spot.order_book_update 更新说明 : 增量/全量推送动态切换 :系统将不定期推送全量订单簿数据。 新增全量数据标识字段 full : full=true :当前消息包含全量深度数据,需 覆盖本地订单簿 以保障一致性; full=false:增量数据推送,默认不返回。 部署进度 : 模拟环境:已部署 实盘环境:未部署 现货模拟环境WebSocket地址 : wss://ws-testnet.gate.io/v4/ws/spot
适配建议 上述现货相关功能已全部部署至 模拟环境 ,请务必在使用正式环境前,通过上述方式完成验证,避免对您的影响。 我们将持续更新部署进度, 现货相关功能预计于2025年4月29日部署实盘环境 。 感谢您一直以来的支持与信任,我们将持续优化产品体验,敬请关注后续更新。