Get Risk Unit Force Liquidation Record(USER_DATA)

API Description

Get Institution Loan Risk Unit Force Liquidation Record. This endpoint is accessible only with the credit account API key.

HTTP Request

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

Request Weight

1(IP)

Request Parameters

Name	Type	Mandatory	Description
groupId	LONG	NO	Risk unit unique identifier
startTime	LONG	NO
endTime	LONG	NO
current	LONG	NO	The currently querying page. Start from 1. Default:1
size	LONG	NO	Default:10 Max:100
recvWindow	LONG	NO	The value cannot be greater than 60000
timestamp	LONG	YES

• Credit account can query either activated risk unit or closed risk unit with the specific groupId. The current activated risk unit will be returned if the parameter of groupId is not input.
• Response in descending order
• If neither startTime nor endTime is sent, the recent 7-day data will be returned.
• If startTime is not sent, default is endTime - 7days. If endTime is not sent, current time will be returned by default.
• startTime set as endTime - 7days by default, endTime set as current time by default.
• The length between startTime and endTime cannot exceed 100 days, otherwise an error is reported and no record is returned.

Response Example

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