Announcements Gate Launches ADL Ranking Push Channel for Perpetual Futures WebSocket

Gate Launches ADL Ranking Push Channel for Perpetual Futures WebSocket

2025-07-03 12:02:43 UTC 119905 Read

[//]:content-type-MARKDOWN-DONOT-DELETE
To enhance the user experience, the Perpetual Futures WebSocket will add a new channel **futures.position_adl_rank** . This channel is used to push customers' position ADL (Auto-Deleveraging) ranking information. Users can subscribe to this channel to receive real-time ADL ranking data, helping to achieve more precise risk management and trading decisions.

**1. Channel Details**
Name: futures.position_adl_rank

Parameter Format:
* Single contract: "BTC_USDT"
* Multiple contracts: "BTC_USDT,ETH_USDT,SOL_USDT"
* All contracts: "!all"

Frequency:
* Real-time push whenever ADL ranking tier changes

**2. Usage and Data Push Examples**
2.1 Subscribe

2.1.1 Subscribe request example

```
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 Subscribe success response example

```
{"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 Message push example

```
{"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 Unsubscribe

2.2.1 Unsubscribe request example

```
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 Unsubscribe response example

```
{"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. Testnet Notification**
This feature is now available in the Perpetual Futures testnet environment. Please connect for testing via the following WebSocket URL:
USDT-margined Perpetual Futures Testnet WebSocket:
wss://ws-testnet.gate.io/v4/ws/futures/usdt

We encourage relevant users to refer to the above format and integrate promptly to use this channel. If you encounter any issues during subscription or use, please feel free to contact us anytime.

Thank you for your support and cooperation.

<sp>
Gate Team
July 3rd, 2025
<sp>
**Gateway to Crypto**
Trade over %Amount_of_Currency% cryptocurrencies safely, quickly, and easily on Gate
**Take Action Now**
<a href="https://www.gate.com/signup" target="_blank">Sign up</a> and claim up to $10,000 in welcome rewards
<a href="https://www.gate.com/referral" target="_blank">Invite friends</a> and earn a 40% commission
**Stay Connected**
<a href="https://www.gate.com/" target="_blank">Visit Gate's official website</a>
<a href="https://www.gate.com/mobileapp?ch=ann45934" target="_blank">Download the Gate App | Desktop</a>
<a href="https://x.com/Gate_io" rel="nofollow noopener noreferrer" target="_blank">Follow us on X (Twitter)</a> to get more bonuses
<a href="https://t.me/GateCom_EN" rel="nofollow noopener noreferrer" target="_blank">Join our Telegram community</a> to discuss trending topics
<a href="https://www.gate.com/community" target="_blank">Engage with our global community</a> for the latest insights
**Transparency & Security**
<a href="https://www.gate.com/proof-of-reserves" target="_blank">Check our 100% Proof of Reserves</a>

Change & Chart Start-End Time

Rise/Fall Color

Pay With

Gate Launches ADL Ranking Push Channel for Perpetual Futures WebSocket

Gate Launches ADL Ranking Push Channel for Perpetual Futures WebSocket

Select language and region

Select your region

Fiat Currencies