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

爲了提升用戶體驗，永續合約 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

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

Gate 團隊 2025年7月3日 **加密貨幣之門** 安全、快捷、輕鬆交易超過 4,300 種加密貨幣 **立即行動** 註冊帳戶，最高可領 $10,000 迎新獎勵 邀請他人註冊，可獲 40% 佣金 **關注官方頻道** 訪問 Gate 官網 下載 Gate App | 電腦端 關注 X (Twitter)，獲取最新福利 加入 Telegram 社群，討論熱點話題 進入全球社群，獲取最新資訊 **透明度保障** 查看 100% 儲備金證明