Query Liquidation Loan Repay History (USER_DATA)

Description

Query the repayment history of cross-margin liquidation loans (deficit caused by bankruptcy during liquidation). Supports time-range filtering and pagination.

HTTP Request

GET /sapi/v1/margin/liquidation-loan/repay-history

Request Weight

100(UID)

Request Parameters

Name	Type	Mandatory	Description
startTime	LONG	NO	Start time in Unix timestamp (milliseconds). Defaults to 7 days ago if not specified
endTime	LONG	NO	End time in Unix timestamp (milliseconds). Defaults to now if not specified
current	LONG	NO	Current page number, default 1
size	LONG	NO	Page size, default 50
recvWindow	LONG	NO	The value cannot be greater than 60000
timestamp	LONG	YES

• The maximum query range is 90 days. If startTime is earlier than 90 days ago, it will be clamped to 90 days ago.
• Only records with status SUCCESS or PENDING are returned. Failed repayment records are excluded.

Response Example

{
    "total": 2,
    "rows": [
        {
            "repayId": 12345678,
            "asset": "USDC",
            "amount": "300.00000000",
            "status": "SUCCESS",
            "createTime": 1714492800000
        },
        {
            "repayId": 12345679,
            "asset": "USDC",
            "amount": "200.00000000",
            "status": "SUCCESS",
            "createTime": 1714579200000
        }
    ]
}

Response Parameters

Name	Type	Description
total	LONG	Total number of repayment records
rows	ARRAY	List of repayment records
rows[].repayId	LONG	Unique identifier for the repayment transaction
rows[].asset	STRING	Asset used for repayment
rows[].amount	DECIMAL	The repayment amount
rows[].status	STRING	Repayment status: SUCCESS (completed) or PENDING (processing)
rows[].createTime	LONG	Unix timestamp (milliseconds) when the repayment was created