用户持仓风险V3 (USER_DATA)

接口描述

查询持仓风险，仅返回有持仓或挂单的交易对

HTTP请求

GET /fapi/v3/positionRisk

请求权重

5

请求参数

名称	类型	是否必需	描述
symbol	STRING	NO
recvWindow	LONG	NO
timestamp	LONG	YES

注意

• 请与账户推送信息ACCOUNT_UPDATE配合使用，以满足您的及时性和准确性需求。

响应示例

单向持仓模式下：

[
  {
        "symbol": "ADAUSDT",                  // 交易对
        "positionSide": "BOTH",               // 持仓方向
        "positionAmt": "30",                  // 头寸数量，符号代表多空方向, 正数为多，负数为空
        "entryPrice": "0.385",                // 开仓均价
        "breakEvenPrice": "0.385077",         // 盈亏平衡价
        "markPrice": "0.41047590",            // 当前标记价格
        "unRealizedProfit": "0.76427700",     // 持仓未实现盈亏
        "liquidationPrice": "0",              // 参考强平价格
        "isolatedMargin": "0",                // 逐仓保证金
        "notional": "12.31427700",            // 名义价值
        "marginAsset": "USDT",                // 保证金资产
        "isolatedWallet": "0",                // 逐仓钱包余额
        "initialMargin": "0.61571385",        // 初始保证金
        "maintMargin": "0.08004280",          // 维持保证金
        "positionInitialMargin": "0.61571385",// 仓位初始保证金
        "openOrderInitialMargin": "0",        // 订单初始保证金
        "adl": 2,                             // 自动减仓等级
        "bidNotional": "0",                   // 忽略
        "askNotional": "0",                   // 忽略
        "updateTime": 1720736417660           // 更新时间
  }
]

双向持仓模式下：

[
  {
        "symbol": "ADAUSDT",                  // 交易对
        "positionSide": "LONG",               // 持仓方向
        "positionAmt": "30",                  // 头寸数量，符号代表多空方向, 正数为多，负数为空
        "entryPrice": "0.385",                // 开仓均价
        "breakEvenPrice": "0.385077",         // 盈亏平衡价
        "markPrice": "0.41047590",            // 当前标记价格
        "unRealizedProfit": "0.76427700",     // 持仓未实现盈亏
        "liquidationPrice": "0",              // 参考强平价格
        "isolatedMargin": "0",                // 逐仓保证金
        "notional": "12.31427700",            // 名义价值
        "marginAsset": "USDT",                // 保证金资产
        "isolatedWallet": "0",                // 逐仓钱包余额
        "initialMargin": "0.61571385",        // 初始保证金
        "maintMargin": "0.08004280",          // 维持保证金
        "positionInitialMargin": "0.61571385",// 仓位初始保证金
        "openOrderInitialMargin": "0",        // 订单初始保证金
        "adl": 2,                             // 自动减仓等级
        "bidNotional": "0",                   // 忽略
        "askNotional": "0",                   // 忽略
        "updateTime": 1720736417660           // 更新时间
  },
  {
        "symbol": "COMPUSDT",                 // 交易对
        "positionSide": "SHORT",              // 持仓方向
        "positionAmt": "-1.000",              // 头寸数量，符号代表多空方向, 正数为多，负数为空
        "entryPrice": "70.92841",             // 开仓均价
        "breakEvenPrice": "70.900038636",     // 盈亏平衡价
        "markPrice": "49.72023376",           // 当前标记价格
        "unRealizedProfit": "21.20817624",    // 持仓未实现盈亏
        "liquidationPrice": "2260.56757210",  // 参考强平价格
        "isolatedMargin": "0",                // 逐仓保证金
        "notional": "-49.72023376",           // 名义价值
        "marginAsset": "USDT",                // 保证金资产
        "isolatedWallet": "0",                // 逐仓钱包余额
        "initialMargin": "2.48601168",        // 初始保证金
        "maintMargin": "0.49720233",          // 维持保证金
        "positionInitialMargin": "2.48601168",// 仓位初始保证金
        "openOrderInitialMargin": "0",        // 订单初始保证金
        "adl": 2,                             // 自动减仓等级
        "bidNotional": "0",                   // 忽略
        "askNotional": "0",                   // 忽略
        "updateTime": 1708943511656           // 更新时间
  }
]