用户持仓风险

接口描述

查询用户持仓风险

HTTP请求

GET /dapi/v1/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", // 开仓均价
        "breakEvenPrice": "0.0",  // 盈亏平衡价
        "markPrice": "0.00000000", // 当前标记价格
        "unRealizedProfit": "0.00000000", // 持仓未实现盈亏
        "liquidationPrice": "0", // 参考强平价格
        "leverage": "125", // 当前杠杆倍数
        "maxQty": "50",  // 当前杠杆倍数允许的数量上限(标的数量)
        "marginType": "cross", // 逐仓模式或全仓模式
        "isolatedMargin": "0.00000000", // 逐仓保证金
        "isAutoAddMargin": "false",
        "positionSide": "BOTH", // 持仓方向
        "updateTime": 0 // 最新更新时间
    },
    {
        "symbol": "BTCUSD_201225",
        "positionAmt": "1",
        "entryPrice": "11707.70000003",
        "breakEvenPrice": "11707.80000005",  // 盈亏平衡价
        "markPrice": "11788.66626667",
        "unRealizedProfit": "0.00005866",
        "liquidationPrice": "11667.63509587",
        "leverage": "125",
        "maxQty": "50",
        "marginType": "cross",
        "isolatedMargin": "0.00000000",
        "isAutoAddMargin": "false",
        "positionSide": "LONG",
        "updateTime": 1627026881327
     },
    {
        "symbol": "BTCUSD_201225",
        "positionAmt": "0",
        "entryPrice": "0.0",
        "breakEvenPrice": "0.0",  // 盈亏平衡价
        "markPrice": "0.00000000",
        "unRealizedProfit": "0.00000000",
        "liquidationPrice": "0",
        "leverage": "125",
        "maxQty": "50",
        "marginType": "cross",
        "isolatedMargin": "0.00000000",
        "isAutoAddMargin": "false",
        "positionSide": "SHORT",
        "updateTime":1627026881327
  }
]