Gate 現貨深度頻道升級公告

爲提升交易體驗，Gate 將於近期在現貨推出全新深度頻道 spot.obu ，優化推送邏輯並擴展深度檔位。具體規則如下：

1.頻道詳情

名稱：spot.obu
參數格式：ob.{symbol}.{level}
示例：
ob.BTC_USDT.400（400檔）、ob.BTC_USDT.50（50檔）
檔位與頻率：
400檔：每100ms更新
50檔：每20ms更新

2.訂閱與推送規則

全量深度推送（full=true）
當頻道推送的深度爲全量深度時，需要將該深度數據完整替換本地深度，並將深度ID更新爲消息中的字段 u 。服務端可能會重復推送全量深度。

訂閱該頻道時，首次推送爲全量深度。

增量深度推送（full=false）
增量消息中不會顯示 “full” 字段，此時消息包含字段 “U”（深度起始ID）和 “u”（深度結束ID）。

如果 U = 本地深度ID + 1，則表示深度連續更新：
- 將本地深度ID替換爲消息中的 “u”。
- 若更新中的 “a” 和 “b” 不爲空，分別按價格更新對應的買、賣深度數量（level[0] 爲價格，level[1] 爲數量）。當數量 level[1] = “0” 時，需移除對應檔位。
若 U ≠ 本地深度ID + 1，則深度數據不連續，需要取消訂閱該市場，並重新訂閱以獲取初始化深度。

訂閱限制
針對同一幣對的同一深度流，一個連結只允許訂閱一次，重復訂閱會返回錯誤。示例：

{ "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,600 種加密貨幣
立即行動
註冊帳戶，最高可領 $10,000 迎新獎勵
邀請他人註冊，可獲 40% 佣金
關注官方渠道
訪問Gate官網
 下載Gate App | 電腦端
 關注X (Twitter)，獲取最新福利
加入Telegram社群，討論熱點話題
進入全球社區，獲取最新資訊
透明度保障
查看 100% 儲備金證明