Skip to main content

Get Repayment Transaction History

Query repaid transaction history

Permission: "Spot trade"

info
  • Support querying last 6 months completed loan orders
  • Only successful repayments can be queried

HTTP Request

GET /v5/crypto-loan/repayment-history

Request Parameters

ParameterRequiredTypeComments
orderIdfalsestringLoan order ID
repayIdfalsestringRepayment tranaction 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
> collateralCurrencystringCollateral coin
> collateralReturnstringReturned collateral amount by this repayment. No collateral returned if this transaction does not fully repay the debt
> loanCurrencystringLoan coin
> loanTermstringLoan term, 7, 14, 30, 90, 180 days, keep "" for flexible loan
> orderIdstringLoan order ID
> repayAmountstringRepayment amount
> repayIdstringRepayment transaction ID
> repayStatusintegerRepayment status, 1: success; 2: processing
> repayTimestringRepay timestamp
> repayTypestringRepayment type, 1: repay by user; 2: repay by liquidation
nextPageCursorstringRefer to the cursor request parameter

Request Example

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

Response Example

{
"retCode": 0,
"retMsg": "request.success",
"result": {
"list": [
{
"collateralCurrency": "BTC",
"collateralReturn": "0",
"loanCurrency": "USDT",
"loanTerm": "",
"orderId": "1794267532472646144",
"repayAmount": "100",
"repayId": "1794271131730737664",
"repayStatus": 1,
"repayTime": "1728629786875",
"repayType": "1"
}
],
"nextPageCursor": ""
},
"retExtInfo": {},
"time": 1728633717935
}