Skip to main content

Get Borrow Contract Info

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

HTTP Request

GET /v5/crypto-loan-fixed/borrow-contract-info

Request Parameters

ParameterRequiredTypeComments
orderIdfalsestringLoan order ID
loanIdfalsestringLoan ID
orderCurrencyfalsestringLoan coin name
termfalsestringFixed term 7: 7 days; 14: 14 days; 30: 30 days; 90: 90 days; 180: 180 days
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
> annualRatestringAnnual rate for the borrowing
> autoRepaystring"true": enable auto repay, default; "false": disable auto repay
> borrowCurrencystringLoan coin
> borrowTimestringLoan order timestamp
> interestPaidstringPaid interest
> loanIdstringLoan contract ID
> orderIdstringLoan order ID
> repaymentTimestringTime to repay
> residualPenaltyIntereststringUnpaid interest
> residualPrincipalstringUnpaid principal
> statusintegerLoan order status 1: unrepaid; 2: fully repaid; 3: overdue
> termstringFixed term 7: 7 days; 14: 14 days; 30: 30 days; 90: 90 days; 180: 180 days
nextPageCursorstringRefer to the cursor request parameter

Request Example

GET /v5/crypto-loan-fixed/borrow-contract-info?orderCurrency=ETH HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1752652691909
X-BAPI-RECV-WINDOW: 5000

Response Example

{
"retCode": 0,
"retMsg": "ok",
"result": {
"list": [
{
"annualRate": "0.022",
"autoRepay": "true",
"borrowCurrency": "ETH",
"borrowTime": "1752633756068",
"interestPaid": "0.002531506849315069",
"loanId": "571",
"orderId": "13007",
"repaymentTime": "1755225756068",
"residualPenaltyInterest": "0",
"residualPrincipal": "1.4",
"status": 1,
"term": "30"
},
{
"annualRate": "0.022",
"autoRepay": "true",
"borrowCurrency": "ETH",
"borrowTime": "1752633696068",
"interestPaid": "0.00018082191780822",
"loanId": "570",
"orderId": "13007",
"repaymentTime": "1755225696068",
"residualPenaltyInterest": "0",
"residualPrincipal": "0.1",
"status": 1,
"term": "30"
}
],
"nextPageCursor": "568"
},
"retExtInfo": {},
"time": 1752652692603
}