查询强平欠款还款历史 (USER_DATA)
接口描述
查询全仓杠杆强平穿仓欠款(强平穿仓产生的负债)的还款历史记录,支持按时间范围过滤和分页查询。
HTTP请求
GET /sapi/v1/margin/liquidation-loan/repay-history
请求权重
100(UID)
请求参数
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| startTime | LONG | NO | 起始时间,Unix 时间戳(毫秒)。未指定时默认为 7 天前 |
| endTime | LONG | NO | 结束时间,Unix 时间戳(毫秒)。未指定时默认为当前时间 |
| current | LONG | NO | 当前页码,默认 1 |
| size | LONG | NO | 每页数量,默认 50 |
| recvWindow | LONG | NO | 赋值不能大于 60000 |
| timestamp | LONG | YES |
- 最大查询范围为 90 天。如果
startTime早于 90 天前,将被截断为 90 天前。 - 仅返回状态为
SUCCESS(成功)或PENDING(处理中)的记录,失败的还款记录不会返回。
响应示例
{
"total": 2,
"rows": [
{
"repayId": 12345678,
"asset": "USDC",
"amount": "300.00000000",
"status": "SUCCESS",
"createTime": 1714492800000
},
{
"repayId": 12345679,
"asset": "USDC",
"amount": "200.00000000",
"status": "PENDING",
"createTime": 1714579200000
}
]
}
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| total | LONG | 还款记录总数 |
| rows | ARRAY | 还款记录列表 |
| rows[].repayId | LONG | 还款交易唯一标识 |
| rows[].asset | STRING | 还款资 产 |
| rows[].amount | DECIMAL | 还款金额 |
| rows[].status | STRING | 还款状态:SUCCESS(成功)或 PENDING(处理中) |
| rows[].createTime | LONG | 还款创建时间,Unix 时间戳(毫秒) |