公告 Gate 現貨深度頻道升級公告

Gate 現貨深度頻道升級公告

2025-05-30 08:56:54 UTC 127451 閱讀

[//]: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

請開發者根據新規則調整對接邏輯。如有疑問，請聯繫客戶支持團隊。

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

漲跌幅與 K 線開盤時間

漲跌顏色

Pay With

Gate 現貨深度頻道升級公告

Gate 現貨深度頻道升級公告

選擇語言及地區

選擇您所在的地區

法幣匯率