强平减仓分位 (ADL Quantile)

接口描述

获取用户仓位的强平减仓分位估计。

占位实现

该接口当前返回的是粗糙的占位值，并非真正计算出的分位数。对每个 持仓，你所持有的方向恒定报告为 2，对侧为 0（BOTH 取两者最大值）。 数值在每次请求时根据你的持仓即时推导 —— 没有周期性重算，也不会与 其他账户排名对比。请勿用这些值估计实际 ADL 风险。

HTTP请求

GET /fapi/v1/adlQuantile (HMAC SHA256)

请求参数

名称	类型	是否必需	描述
symbol	STRING	NO	交易对
timestamp	LONG	YES	时间戳

响应示例

[
    {
        "symbol": "BTCUSDT",
        "adlQuantile": {
            "LONG": 2,    // 持有方向恒为 2，否则为 0
            "SHORT": 0,
            "BOTH": 2     // max(LONG, SHORT)
        }
    }
]

每个持仓返回一个元素。 如果不发送 symbol，则会返回所有持仓的 ADL 分位。

代码示例

cURL

API_KEY="your_api_key"
API_SECRET="your_api_secret"
TIMESTAMP=$(date +%s%3N)
QUERY_STRING="symbol=BTCUSDT&timestamp=${TIMESTAMP}"
SIGNATURE=$(echo -n "${QUERY_STRING}" | openssl dgst -sha256 -hmac "${API_SECRET}" | awk '{print $2}')

curl -s -H "X-MBX-APIKEY: ${API_KEY}" \
  "https://api.prex.world/fapi/v1/adlQuantile?${QUERY_STRING}&signature=${SIGNATURE}"

Python

import time, hmac, hashlib, requests

API_KEY = "your_api_key"
API_SECRET = "your_api_secret"
BASE_URL = "https://api.prex.world"

def sign(params: str) -> str:
    return hmac.new(API_SECRET.encode(), params.encode(), hashlib.sha256).hexdigest()

def signed_get(path, params={}):
    params["timestamp"] = int(time.time() * 1000)
    qs = "&".join(f"{k}={v}" for k, v in params.items())
    params["signature"] = sign(qs)
    return requests.get(f"{BASE_URL}{path}", params=params, headers={"X-MBX-APIKEY": API_KEY})

# Get ADL quantile estimation for BTCUSDT
resp = signed_get("/fapi/v1/adlQuantile", params={
    "symbol": "BTCUSDT"
})
print(resp.json())