公告关于合约与现货WebSocket订单簿功能更新的通知

关于合约与现货WebSocket订单簿功能更新的通知

2025-04-27 17:13:10 UTC+8 136349 阅读

[//]:content-type-MARKDOWN-DONOT-DELETE
为了进一步提升订单簿数据的准确性和同步效率，我们对合约及现货的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-learn.com/v4/ws/spot

**3.现货订单簿更新频道逻辑优化** 
**更新范围** ： spot.order_book_update
**更新说明** ：
增量/全量推送动态切换 ：系统将不定期推送全量订单簿数据。
新增全量数据标识字段 full ：
full=true ：当前消息包含全量深度数据，需 **覆盖本地订单簿** 以保障一致性；
full=false：增量数据推送，默认不返回。
**部署进度** **：**
模拟环境：已部署
实盘环境：未部署
 **现货模拟环境WebSocket地址** ： wss://ws-testnet.gate-learn.com/v4/ws/spot

**适配建议**
上述现货相关功能已全部部署至 **模拟环境** ，请务必在使用正式环境前，通过上述方式完成验证，避免对您的影响。
我们将持续更新部署进度， **现货相关功能预计于2025年4月29日部署实盘环境** 。
感谢您一直以来的支持与信任，我们将持续优化产品体验，敬请关注后续更新。

<sp>
Gate.io团队
2025年4月27日
<sp>
**加密货币之门**
安全、快捷、轻松交易超过 %Amount_of_Currency% 种加密货币
**立即行动**
<a href="https://www.gate-learn.com/signup" target="_blank">注册账户</a>，最高可领 $10,000 迎新奖励
<a href="https://www.gate-learn.com/referral" target="_blank">邀请他人注册</a>，可获 40% 佣金
**关注官方渠道**
<a href="https://www.gate-learn.com/" target="_blank">访问Gate.io 官网</a>
<a href="https://www.gate-learn.com/mobileapp?ch=ann44678" target="_blank">下载Gate.io App | 电脑端</a>
<a href="https://x.com/Gateio_zh" rel="nofollow noopener noreferrer" target="_blank">关注X (Twitter)</a>，获取最新福利
<a href="https://t.me/gate_zh" rel="nofollow noopener noreferrer" target="_blank">加入Telegram社群</a>，讨论热点话题
<a href="https://www.gate-learn.com/community" target="_blank">进入全球社区</a>，获取最新资讯
**透明度保障**
<a href="https://www.gate-learn.com/proof-of-reserves" target="_blank">查看 100% 储备金证明</a>

涨跌幅与 K 线开盘时间

涨跌颜色

Pay With

关于合约与现货WebSocket订单簿功能更新的通知

域名提示

关于合约与现货WebSocket订单簿功能更新的通知

域名提示

选择语言及地区

选择您所在的地区

法币汇率