Skip to main content

Get Repayment History

Permission: "Spot trade"
UID rate limit: 5 req / second

HTTP Request

GET /v5/crypto-loan-fixed/repayment-history

Request Parameters

ParameterRequiredTypeComments
repayIdfalsestringRepayment order ID
loanCurrencyfalsestringLoan coin name
limitfalsestringLimit for data size per page. [1, 100]. Default: 10
cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters

ParameterTypeComments
listarrayObject
> detailsarrayObject
>> loanCurrencystringLoan coin name
>> repayAmountlongRepay amount
>> loanIdstringLoan ID. One repayment may involve multiple loan contracts.
> loanCurrencystringLoan coin name
> repayAmountlongRepay amount
> repayIdstringRepay order ID
> repayStatusintegerStatus, 1: success, 2: processing, 3: fail
> repayTimelongRepay time
> repayTypeintegerRepay type, 1: repay by user; 2: repay by liquidation; 3: auto repay; 4: overdue repay; 5: repay by delisting; 6: repay by delay liquidation
nextPageCursorstringRefer to the cursor request parameter

Request Example

GET /v5/crypto-loan-fixed/repayment-history?repayId=1780 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXXX
X-BAPI-API-KEY: XXXXXXX
X-BAPI-TIMESTAMP: 1752714738425
X-BAPI-RECV-WINDOW: 5000

Response Example

{
"retCode": 0,
"retMsg": "ok",
"result": {
"list": [
{
"details": [
{
"loanCurrency": "ETH",
"loanId": "568",
"repayAmount": "0.1"
},
{
"loanCurrency": "ETH",
"loanId": "571",
"repayAmount": "1.4"
}
],
"loanCurrency": "ETH",
"repayAmount": "1.5",
"repayId": "1782",
"repayStatus": 1,
"repayTime": 1752717174353,
"repayType": 1
}
],
"nextPageCursor": "1674"
},
"retExtInfo": {},
"time": 1752717183557
}