公告 Gate 永续合约 WebSocket 新增 ADL 排名推送渠道

Gate 永续合约 WebSocket 新增 ADL 排名推送渠道

2025-07-03 20:02:43 UTC+8 119755 阅读

[//]: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-learn.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-learn.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-learn.com/v4/ws/futures/usdt

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

<sp>
Gate 团队
2025年7月3日
<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=ann45934" 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 永续合约 WebSocket 新增 ADL 排名推送渠道

域名提示

Gate 永续合约 WebSocket 新增 ADL 排名推送渠道

域名提示

选择语言及地区

选择您所在的地区

法币汇率