用户UM持仓风险(USER_DATA)

接口描述

获取用户UM持仓风险

HTTP请求

GET /papi/v1/um/positionRisk

请求权重

5

请求参数

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

• 请与账户推送信息ACCOUNT_UPDATE配合使用，以满足您的及时性和准确性需求。
• 对于单向持仓模式，仅会展示BOTH方向的持仓
• 对于双向持仓模式，会展示所有BOTH，LONG，和SHORT方向的持仓

响应示例

• 单向持仓模式下:

 [
    {
        "entryPrice": "0.00000", // 开仓均价
        "leverage": "10", // 当前杠杆倍数
        "markPrice": "6679.50671178",   // 当前标记价格
        "maxNotionalValue": "20000000", // 当前杠杆倍数允许的名义价值上限
        "positionAmt": "0.000", // 头寸数量，符号代表多空方向, 正数为多，负数为空
        "notional": "0",
        "symbol": "BTCUSDT", // 交易对
        "unRealizedProfit": "0.00000000", // 持仓未实现盈亏
        "liquidationPrice": "6170.20509059",
        "positionSide": "BOTH", // 持仓方向
        "updateTime": 1625474304765   // 更新时间
    }
]

• 双向持仓模式下(存在持仓才会返回):

[
    {
        "symbol": "BTCUSDT",
        "positionAmt": "0.001",
        "entryPrice": "22185.2",
        "markPrice": "21123.05052574",
        "unRealizedProfit": "-1.06214947",
        "liquidationPrice": "6170.20509059",
        "leverage": "4",
        "maxNotionalValue": "100000000",
        "positionSide": "LONG",
        "notional": "21.12305052",
        "updateTime": 1655217461579
    },
    {
        "symbol": "BTCUSDT",
        "positionAmt": "0.000",
        "entryPrice": "0.0",
        "markPrice": "21123.05052574",
        "unRealizedProfit": "0.00000000",
        "liquidationPrice": "6170.20509059",
        "leverage": "4",
        "maxNotionalValue": "100000000",
        "positionSide": "SHORT",
        "notional": "0",
        "updateTime": 0
    }
]