公告關於合約與現貨WebSocket訂單簿功能更新的通知

關於合約與現貨WebSocket訂單簿功能更新的通知

2025-04-27 09:13:10 UTC 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.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日部署實盤環境** 。
感謝您一直以來的支持與信任，我們將持續優化產品體驗，敬請關注後續更新。

<sp>
Gate.io團隊
2025年4月27日
<sp>
**加密貨幣之門**
安全、快捷、輕鬆交易超過 %Amount_of_Currency% 種加密貨幣
**立即行動**
<a href="https://www.gate.io/signup" target="_blank">註冊帳戶</a>，最高可領 $10,000 迎新獎勵
<a href="https://www.gate.io/referral" target="_blank">邀請他人註冊</a>，可獲 40% 佣金
**關注官方渠道**
<a href="https://www.gate.io/" target="_blank">訪問Gate.io 官網</a>
<a href="https://www.gate.io/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.io/community" target="_blank">進入全球社區</a>，獲取最新資訊
**透明度保障**
<a href="https://www.gate.io/proof-of-reserves" target="_blank">查看 100% 儲備金證明</a>

漲跌幅與 K 線開盤時間

漲跌顏色

Pay With

關於合約與現貨WebSocket訂單簿功能更新的通知

關於合約與現貨WebSocket訂單簿功能更新的通知

選擇語言及地區

選擇您所在的地區

法幣匯率