跳到主要内容

查询风险单元借贷/还款记录 (USER_DATA)

接口描述

查询风险单位借贷/还款记录,仅支持放贷账户调用该接口。

HTTP请求

GET /sapi/v1/margin/loan-group/borrow-repay

请求权重

10(IP)

请求参数

名称类型是否必需描述
groupIdLONGNO唯一风险单位标识符
typeSTRINGYES操作类型:BORROW、REPAY
assetSTRINGNO资产名称, 如 USDT 或 USDC
startTimeLONGNO开始时间
endTimeLONGNO结束时间
currentLONGNO当前查询页。 开始值 1。 默认:1
sizeLONGNO默认:10 最大:100
recvWindowLONGNO
timestampLONGYES
  • 放贷账户可根据参数groupId查询当前生效状态 风险单位和已经关闭的风险单位,若groupId为空,则返回当前生效状态 的风险单位。
  • 响应返回为降序排列。
  • 若传了asset参数,最大查询时间范围为endTime往前30天;不传asset参数,最大查询时间范围为endTime往前7天。
  • 若startTime和endTime没传,则默认返回最近7天数据。
  • startTime不传,默认endTime-7天;结束时间不传,默认当前时间。
  • startTime和endTime时间长度不能超过100天,否则报错,无返回记录。

响应示例

{
"total": 1,
"rows": [
{
"tranId": 1648963682,
"assetName": "USDT",
"amount": 300,
"status": "CONFIRM",
"type": "BORROW",
"timestamp": 1750420899036 // Create Time
},
{
"tranId": 1648963682,
"assetName": "USDT",
"amount": 300,
"status": "FAILED",
"type": "BORROW",
"timestamp": 1750420899036 // Create Time
},
{
"tranId": 1648963682,
"assetName": "USDT",
"amount": 300,
"principal": 298,
"interest": 2,
"status": "CONFIRM",
"type": "REPAY",
"timestamp": 1750420899036 // Create Time
}
]}