查询风险单元强制平仓记录 (USER_DATA)

接口描述

获取风险单位强制平仓记录。 仅支持放贷账户调用该接口。

HTTP请求

GET /sapi/v1/margin/loan-group/force-liquidation

请求权重

1(IP)

请求参数

名称	类型	是否必需	描述
groupId	LONG	NO	唯一风险单位标识符
startTime	LONG	NO	开始时间
endTime	LONG	NO	结束时间
current	LONG	NO	当前查询页。 开始值 1. 默认:1
size	LONG	NO	默认:10 最大:100
recvWindow	LONG	NO
timestamp	LONG	YES

• 放贷账户可根据参数groupId查询当前生效状态 风险单位和已经关闭的风险单位，若groupId为空，则返回当前生效状态 的风险单位。
• 响应返回为降序排列。
• 若startTime和endTime没传，则默认返回最近7天数据。
• startTime不传，默认endTime-7天；结束时间不传，默认当前时间。
• startTime和endTime时间长度不能超过100天，否则报错，无返回记录。

响应示例

{
  "total": 2,
  "rows": [
    {
      "groupId": 6,
      "startLtv": 1,
      "endLtv": 0,
      "liquidationStartTime": 1748381716906,
      "liquidationEndTime": 1748525848742,
      "totalNetEquity": 16671.5507973,
      "totalMaintenanceMargin": 0,
      "totalLiability": 16667.926,
      "liquidationSnapshot": {
        "snapshots": [
          {
            "subEmail": "[email protected]",
            "memberType": "CREDIT",
            "walletType": "PORTFOLIO_MARGIN",
            "netEquity": "12671.05079731",
            "maintainMargin": "0E-8"
          },
          {
            "subEmail": "[email protected]",
            "memberType": "CREDIT",
            "walletType": "SPOT",
            "netEquity": "0E-8",
            "maintainMargin": "0E-8"
          },
          {
            "subEmail": "[email protected]",
            "memberType": "COLLATERAL",
            "walletType": "PORTFOLIO_MARGIN",
            "netEquity": "1000.25333000",
            "maintainMargin": "0E-8"
          },
          {
            "subEmail": "[email protected]",
            "memberType": "COLLATERAL",
            "walletType": "PORTFOLIO_MARGIN",
            "netEquity": "1000.24667000",
            "maintainMargin": "0E-8"
          },
          {
            "subEmail": "[email protected]",
            "memberType": "COLLATERAL",
            "walletType": "CROSS_MARGIN",
            "netEquity": "1000.00000000",
            "maintainMargin": "0E-8"
          },
          {
            "subEmail": "[email protected]",
            "memberType": "COLLATERAL",
            "walletType": "CROSS_MARGIN",
            "netEquity": "1000.00000000",
            "maintainMargin": "0E-8"
          }
        ],
        "liabilities": 
          {"assetName": "USDT",
            "principal": "11667.92600000",
            "interest": "5000.00000000"
          }
      }
    }
  ]
}

Response detail description:

Parameter	Type	Description
total	LONG	风险单位数量
rows	OBJECT ARRAY
→ groupId	Long	唯一风险单位标识符
→ startLtv	LONG	初始贷款价值比
→ endLtv	LONG	最新贷款价值比
→ liquidationStartTime	Long	强平开始时间 (毫秒)
→ liquidationEndTime	Long	强平结束时间 (毫秒)
→ totalNetEquity	String	Σ所有统一账户子账户抵押品权益 + Σ 抵押品价值 - Σ 全仓杠杆账户（负债 + 利息） + 现货可用资产
→totalMaintenanceMargin	String	维持保证金总额
→ totalLiability	String	未偿还贷款本金 + 未偿还贷款利息
liquidationSnapshot	OBJECT ARRAY
snapshots	OBJECT ARRAY
→ subEmail	String	Sub account registered email
→ memberType	String	子账号类型，可取值"CREDIT" 或 "COLLATERAL"
→ walletType	String	钱包类型，可取值 "PORTFOLIO_MARGIN", "SPOT" 或 "CROSS_MARGIN"
→ netEquity	String	账户净资产
→ maintainMargin	String	维持保证金
liabilities	OBJECT ARRAY
→ assetName	String	币种名称
→ principal	String	未偿还贷款本金
→ interest	String	未偿还利息