跳到主要内容

用户持仓风险

接口描述​

获取用户当前持仓风险及详细信息。

HTTP请求​

GET /fapi/v1/positionRisk (HMAC SHA256)

请求权重​

5

请求参数​

名称类型是否必需描述
symbolSTRINGNO交易对
timestampLONGYES时间戳

响应示例​

[
    {
        "symbol": "BTCUSDT",
        "positionAmt": "0.001",          // 持仓数量
        "entryPrice": "57183.0",        // 开仓均价
        "breakEvenPrice": "57183.0",     // 持仓保本价
        "markPrice": "58123.0",          // 当前标记价格
        "unRealizedProfit": "1.12353",   // 未实现盈亏
        "liquidationPrice": "0",         // 预估强平价
        "leverage": "20",                // 杠杆倍数
        "maxNotionalValue": "1000000",   // 该交易对的仓位名义价值上限；详见 ./leverage-brackets.md
        "marginType": "cross",           // 保证金模式 (逐仓/全仓)
        "isolatedMargin": "0.00000000",  // 逐仓保证金
        "isAutoAddMargin": "false",
        "positionSide": "BOTH",          // 持仓方向
        "notional": "58.123",            // 名义持仓价值
        "isolatedWallet": "0",           // 逐仓钱包余额
        "updateTime": 1623910239123      // 最后更新时间
    }
]

如果不发送 symbol，则会返回所有交易对的持仓信息。

上面的 leverage 与 maxNotionalValue 描述的是该交易对作用于此持仓的限制。 完整的约束集合（单笔订单 min/max 名义、OI 上限、 GET …/leverage-brackets 接口、以及逐仓 vs 全仓模式的差异）， 详见 杠杆档位与仓位限制。

代码示例​

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-sepolia.ztdx.io/fapi/v1/positionRisk?${QUERY_STRING}&signature=${SIGNATURE}"

Python​

import time, hmac, hashlib, requests

API_KEY = "your_api_key"
API_SECRET = "your_api_secret"
BASE_URL = "https://api.ztdx.io"

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 position risk information for BTCUSDT
resp = signed_get("/fapi/v1/positionRisk", params={
    "symbol": "BTCUSDT"
})
print(resp.json())