用户持仓风险V2(USER-DATA)

类型：USER-DATA

GET /fapi/v2/positionRisk

按 symbol 的持仓状态，包括开仓均价、实时 mark 价（oracle）、已锁定保证金。

请求

GET /fapi/v2/positionRisk?symbol=BTCUSDT

Query 参数

字段	类型	必填	说明
symbol	string	否	standard pair。省略时返回所有非零持仓。传入时即使 positionAmt 为 0（如已完全平仓）也会返回该 symbol 的 row；不存在仓位记录则返回 []。

响应 — 200

[
  {
    "symbol": "BTCUSDT",
    "positionAmt": "0.001",
    "entryPrice": "76500.00",
    "markPrice": "76538.12",
    "unRealizedProfit": "0",
    "leverage": "10",
    "marginType": "cross",
    "isolatedMargin": "7.65",
    "positionSide": "BOTH",
    "updateTime": 1748275200000
  }
]

字段	说明
positionAmt	带符号数量：正数 = 多头，负数 = 空头。
entryPrice	开仓均价。
markPrice	实时 oracle 价格；oracle 尚未发布该 symbol 价格时为 "0"。
unRealizedProfit	目前固定 "0"。 请客户端用 positionAmt * (markPrice − entryPrice) 自行计算。
leverage	该仓位实际使用的杠杆（1–100），由开仓时通过 POST /fapi/v1/leverage 设置的值或等效杠杆的 /v1/orders 成交决定。不再固定为 "10"。
marginType	固定 "cross"。
isolatedMargin	该仓位当前锁定的保证金（ledger.positions.locked_margin），尽管 marginType 为 cross。
positionSide	固定 "BOTH"（Rocky 使用 one-way 模式）。
updateTime	服务端响应时间（毫秒），所有 row 相同。

liquidationPrice、maxNotionalValue、isolatedWallet、breakEvenPrice 暂未返回。

错误

HTTP	code	msg
400	-1100	未知 symbol。
500	-1000	数据库故障。

签名 / API key 错误（-1021、-1022、-1102、-2014、-2015）及限流（-1003，HTTP 429）适用于所有签名接口；见 错误码。