用户CM持仓风险(USER_DATA)

接口描述

获取用户CM持仓风险

HTTP请求

GET /papi/v1/cm/positionRisk

请求权重

1

请求参数

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

• marginAsset 和 pair 不要同时提供
• marginAsset 和 pair 均不提供则返回所有上市状态和结算中的symbol
• 对于单向持仓模式，仅会展示BOTH方向的持仓
• 对于双向持仓模式，会展示所有BOTH，LONG，和SHORT方向的持仓
• 请与账户推送信息ACCOUNT_UPDATE配合使用，以满足您的及时性和准确性需求。

响应示例

单向持仓模式下:

[
    {
        "symbol": "BTCUSD_201225", // 交易对
        "positionAmt": "0", // 头寸数量, 符号代表多空方向, 正数为多, 负数为空
        "entryPrice": "0.0", // 开仓均价
        "markPrice": "0.00000000", // 当前标记价格
        "unRealizedProfit": "0.00000000", // 持仓未实现盈亏
        "liquidationPrice": "6170.20509059", // 爆仓价
        "leverage": "125", // 当前杠杆倍数
        "positionSide": "BOTH", // 持仓方向
        "updateTime": 0, // 最新更新时间
        "maxQty": "50",  // 当前杠杆倍数允许的数量上限(标的数量)
        "notionalValue": "0.00084827"
    }
]

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

[
    {
        "symbol": "BTCUSD_201225",
        "positionAmt": "1",
        "entryPrice": "11707.70000003",
        "markPrice": "11788.66626667",
        "unRealizedProfit": "0.00005866",
        "liquidationPrice": "6170.20509059", // 爆仓价
        "leverage": "125",
        "positionSide": "LONG",
        "updateTime": 1627026881327,
        "maxQty": "50",
        "notionalValue": "0.00084827" 
    },
    {
        "symbol": "BTCUSD_201225",
        "positionAmt": "1",
        "entryPrice": "11707.70000003",
        "markPrice": "11788.66626667",
        "unRealizedProfit": "0.00005866",
        "liquidationPrice": "6170.20509059", // 爆仓价
        "leverage": "125",
        "positionSide": "LONG",
        "updateTime": 1627026881327,
        "maxQty": "50",
        "notionalValue": "0.00084827" 
    }
]