风险单位历史利息 (USER_DATA)

接口描述

查询机构贷风险单位给定时间段内的利息历史记录。此接口仅可使用信用账户API Key访问。

HTTP 请求

GET /sapi/v1/margin/loan-group/interest-history

请求权重

10(IP)

请求参数

名称	类型	是否必须	描述
groupId	LONG	NO	唯一风险单位标识符
asset	STRING	NO	资产名称， 如 USDT 或 USDC
startTime	LONG	NO
endTime	LONG	NO
current	LONG	NO	当前查询页。 开始值 1. 默认:1
size	LONG	NO	默认:10 最大:100

• 放贷账户可根据参数groupId查询当前生效状态 风险单位和已经关闭的风险单位，若groupId为空，则返回当前生效状态 的风险单位。
• 响应返回为降序排列。
• 查询时间范围最大不得超过30天。这是确保数据正确性必须的。
• 若startTime和endTime没传，则默认返回最近7天数据
• 如果startTime传递了而endTime没传，则返回 startTime到现在的利息历史记录；若startTime至今超过30天，则返回过去30天的利息历史记录。
• 如果startTime没传而endTime传递了，则返回 endTime之前7天的利息历史记录

响应示例

{
"total": 2,

"rows": [

  {

    "groupId": 2,

    "assetName": "USDC",

    "principal": 851340.57601652,

    "interestRate": 0.00000833,

    "interest": 7.09447643,

    "interestTimestamp": 1746442800000

  },

  {

    "groupId": 2,

    "assetName": "USDC",

    "principal": 851340.57601652,

    "interestRate": 0.00000833,

    "interest": 7.09447643,

    "interestTimestamp": 1746439200000

  }

]

}

响应信息详解：

参数	类型	描述
total	STRINGString	查询到的历史利息记录数量
rows	OBJECT ARRAY
→ groupId	STRINGString	唯一风险单位标识符
→ assetName	STRING	借款币种名称
→ principal	STRING	借款本金
→ interestRate	STRING	借款小时利率
→ interest	STRING	利息金额
→ interestTimestamp	LONG	利率最后更新时间戳（毫秒