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.com/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.com/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.com/v4/ws/futures/usdt

请相关用户参考上述格式，及时接入并使用该频道。如在订阅或使用过程中遇到问题，欢迎随时与我们联系。感谢您的支持与配合。