公告 Gate 永續合約WebSocket新增ADL排名推送渠道

Gate 永續合約WebSocket新增ADL排名推送渠道

2025-07-03 12:02:43 UTC 119722 閱讀

[//]:content-type-MARKDOWN-DONOT-DELETE
爲了提升用戶體驗，永續合約 WebSocket 將新增頻道 futures.position_adl_rank，該頻道用於推送客戶倉位 ADL 排名信息。用戶可通過訂閱該頻道，實時獲取合約倉位自動減倉（ADL）排名數據，助力更精準的風險管理和交易決策。

**1. 頻道詳情**
名稱：futures.position_adl_rank

參數格式：
* 單個合約："BTC_USDT"
* 多個合約："BTC_USDT,ETH_USDT,SOL_USDT"
* 所有合約："!all"

頻率：
* ADL 排名檔位發生變化時實時推送

**2. 操作與數據推送示例**

2.1 訂閱

2.1.1 訂閱請求 **示例**

```
from websocket import create_connection
import json

ws = create_connection("wss://ws-testnet.gate.io/v4/ws/futures/usdt")

subscribe_msg = {"time": 1751008332, "channel": "futures.position_adl_rank", "event": "subscribe", "payload": ["!all"]}

ws.send(json.dumps(subscribe_msg))
print(ws.recv())
```

2.1.2 訂閱成功響應示例

```
{"time":1751008269,"time_ms":1751008269602,"conn_id":"7b562e69c00aa773","trace_id":"4cf15240fa36f3d9b3da7f5039b35771","channel":"futures.position_adl_rank","event":"subscribe","payload":["!all"],"result":{"status":"success"}}
```

2.1.3 消息推送示例

```
{"time":1751016269,"time_ms":1751016269602,"channel":"futures.position_adl_rank","event":"update","result":[{"contract":"BTC_USDT","mode":"single","rank_division":1,"size":0,"time_ms":1748585406559,"user_id":2124426495}]}
```

2.2 取消訂閱

2.2.1 取消訂閱請求示例

```
from websocket import create_connection 
import json

ws = create_connection("wss://ws-testnet.gate.io/v4/ws/futures/usdt")

unsubscribe_msg = {"time": 1751018269, "channel": "futures.position_adl_rank", "event": "unsubscribe", "payload": ["!all"]}

ws.send(json.dumps(unsubscribe_msg)) 
print(ws.recv())
```

2.2.2 取消訂閱響應示例

```
{"time": 1751018269,"time_ms": 1751018269242,"id": 1,"conn_id": "7b562e69c00aa773","trace_id": "4cf15240fa36f3d9b3da7f5039b35771","channel": "futures.position_adl_rank","event": "unsubscribe","payload": ["!all"],"result": {"status": "success"}}
```

**3. 模擬盤測試通知**
此功能已在永續合約模擬環境上線，請通過以下 URL 接入測試： WebSocket U本位永續合約模擬交易地址：wss://ws-testnet.gate.io/v4/ws/futures/usdt

請相關用戶參考上述格式，及時接入並使用該頻道。如在訂閱或使用過程中遇到問題，歡迎隨時與我們聯繫。感謝您的支持與配合。

<sp>
Gate 團隊
2025年7月3日
<sp>
**加密貨幣之門**
安全、快捷、輕鬆交易超過 %Amount_of_Currency% 種加密貨幣
**立即行動**
<a href="https://www.gate.com/zh-tw/signup" target="_blank">註冊帳戶</a>，最高可領 $10,000 迎新獎勵
<a href="https://www.gate.com/zh-tw/referral" target="_blank">邀請他人註冊</a>，可獲 40% 佣金
**關注官方頻道**
<a href="https://www.gate.com/zh-tw" target="_blank">訪問 Gate 官網</a>
<a href="https://www.gate.com/zh-tw/mobileapp?ch=ann45934" target="_blank">下載 Gate App | 電腦端</a>
<a href="https://x.com/GateTw8774" rel="nofollow noopener noreferrer" target="_blank">關注 X (Twitter)</a>，獲取最新福利
<a href="https://t.me/Gateio_TW" rel="nofollow noopener noreferrer" target="_blank">加入 Telegram 社群</a>，討論熱點話題
<a href="https://www.gate.com/zh-tw/community" target="_blank">進入全球社群</a>，獲取最新資訊
**透明度保障**
<a href="https://www.gate.com/zh-tw/proof-of-reserves" target="_blank">查看 100% 儲備金證明</a>

漲跌幅與 K 線開盤時間

漲跌顏色

Pay With

Gate 永續合約WebSocket新增ADL排名推送渠道

Gate 永續合約WebSocket新增ADL排名推送渠道

選擇語言及地區

選擇您所在的地區

法幣匯率