Gate Launches ADL Ranking Push Channel for Perpetual Futures WebSocket

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.

Gate Team July 3rd, 2025 **Gateway to Crypto** Trade over 4,300 cryptocurrencies safely, quickly, and easily on Gate **Take Action Now** Sign up and claim up to $10,000 in welcome rewards Invite friends and earn a 40% commission **Stay Connected** Visit Gate's official website Download the Gate App | Desktop Follow us on X (Twitter) to get more bonuses Join our Telegram community to discuss trending topics Engage with our global community for the latest insights **Transparency & Security** Check our 100% Proof of Reserves