[//]:content-type-MARKDOWN-DONOT-DELETE 爲提升交易體驗，Gate 將於近期在現貨推出全新深度頻道 **spot.obu** ，優化推送邏輯並擴展深度檔位。具體規則如下： **1.頻道詳情** * 名稱：spot.obu * 參數格式：ob.{symbol}.{level} * 示例： ob.BTC_USDT.400（400檔）、ob.BTC_USDT.50（50檔） * 檔位與頻率： 400檔：每100ms更新 50檔：每20ms更新 **2.訂閱與推送規則** 1. **全量深度推送（full=true） ** 當頻道推送的深度爲全量深度時，需要將該深度數據完整替換本地深度，並將深度ID更新爲消息中的字段 **u** 。服務端可能會重復推送全量深度。 * 訂閱該頻道時，首次推送爲全量深度。 2. **增量深度推送（full=false）** 增量消息中不會顯示 "full" 字段，此時消息包含字段 "U"（深度起始ID）和 "u"（深度結束ID）。 * 如果 U = 本地深度ID + 1，則表示深度連續更新： * 將本地深度ID替換爲消息中的 "u"。 * 若更新中的 "a" 和 "b" 不爲空，分別按價格更新對應的買、賣深度數量（level[0] 爲價格，level[1] 爲數量）。當數量 level[1] = "0" 時，需移除對應檔位。 * 若 U ≠ 本地深度ID + 1，則深度數據不連續，需要取消訂閱該市場，並重新訂閱以獲取初始化深度。 3. **訂閱限制 ** 針對同一幣對的同一深度流，一個連結只允許訂閱一次，重復訂閱會返回錯誤。示例： ``` { "error": { "code": 2, "message": "Alert sub ob.BTC_USDT.50" } } ``` **3.操作與數據推送示例** **1.訂閱** **1.1訂閱請求示例** ``` from websocket import create_connection import json ws = create_connection("wss://ws-testnet.gate.io/v4/ws/spot") subscribe_msg = {"time": 1748572393, "channel": "spot.obu", "event": "subscribe", "payload": ["ob.BTC_USDT.50"]} ws.send(json.dumps(subscribe_msg)) print(ws.recv()) ``` **1.2 訂閱成功響應示例** ``` {"time":1748572394,"time_ms":1748572394271,"conn_id":"b61f70b2e6bcca91","trace_id":"d2e2d92c3a7eabc3d5be52514ef508d2","channel":"spot.obu","event":"subscribe","payload":["ob.BTC_USDT.50"],"result":{"status":"success"},"requestId":"d2e2d92c3a7eabc3d5be52514ef508d2"} ``` **1.3 全量推送示例** ``` {"channel":"spot.obu","result":{"t":1748572394325,"full":true,"s":"ob.BTC_USDT.50","u":28606981,"b":[["105958.9","0.00908"],["105953.2","0.02426"],["105942.6","0.02074"],["105937.7","0.0099"],["105932","0.01731"],["105927.1","0.01796"],["105921.4","0.02041"],["105893.2","0.01265"],["105872","0.01895"],["70000","0.00005"],["49000.1","0.0002"],["66","0.05"]],"a":[["106009.9","0.01555"],["106038.1","0.00648"],["106048.7","0.01751"],["106059.3","0.00198"],["106080.5","0.01861"],["106091.1","0.02018"],["106101.7","0.01548"],["106112.3","0.01776"],["106122.9","0.01546"],["106133.5","0.02117"]]},"time_ms":1748572394325,"event":"update"} ``` **1.4 增量推送示例** ``` {"channel":"spot.obu","result":{"t":1748572395237,"s":"ob.BTC_USDT.50","u":28606989,"U":28606988,"b":[["66","0"]],"a":[["106009.9","0"]]},"time_ms":1748572395237,"event":"update"} ``` **2. 取消訂閱** **2.1 取消訂閱請求示例** ``` from websocket import create_connection import json ws = create_connection("wss://ws-testnet.gate.io/v4/ws/spot") unsubscribe_msg = {"time": 1747054611, "channel": "spot.obu", "event": "unsubscribe", "payload": ["ob.BTC_USDT.50"]} ws.send(json.dumps(unsubscribe_msg)) print(ws.recv()) ``` **2.2 取消訂閱響應示例** ``` {"time": 1743673617,"time_ms": 1743673617242,"id": 1,"conn_id": "7b06ff199a98ab0e","trace_id": "8f86e4021a84440e502f73fde5b94918","channel": "spot.obu","event": "unsubscribe","payload": ["ob.BTC_USDT.50"],"result": {"status": "success"}} ``` **4. 模擬盤測試通知** 此功能已在現貨模擬環境上線，請通過以下URL接入測試： WebSocket 現貨模擬交易地址： wss://ws-testnet.gate.io/v4/ws/spot 請開發者根據新規則調整對接邏輯。如有疑問，請聯繫客戶支持團隊。 Gate團隊 2025年5月30日 **加密貨幣之門** 安全、快捷、輕鬆交易超過 3,500 種加密貨幣 **立即行動** 註冊帳戶，最高可領 $10,000 迎新獎勵邀請他人註冊，可獲 40% 佣金 **關注官方渠道** 訪問Gate官網下載Gate App | 電腦端關注X (Twitter)，獲取最新福利加入Telegram社群，討論熱點話題進入全球社區，獲取最新資訊 **透明度保障** 查看 100% 儲備金證明

Gate 現貨深度頻道升級公告

Gate 現貨深度頻道升級公告