Skip to main content

Get Fixed-Rate Borrow Contract Info

info
  • Results are returned in descending order by borrowTime.

HTTP Request

GET/v5/spot-margin-trade/fixedborrow-contract-info

Request Parameters

ParameterRequiredTypeComments
orderIdfalsestringLoan order 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
> borrowCurrencystringLoan coin
> borrowTimestringLoan order timestamp
> interestPaidstringPaid interest
> loanIdstringLoan contract ID
> orderIdstringLoan order ID
> repaymentTimestringTime to repay
> residualPenaltyIntereststringUnpaid interest
> residualPrincipalstringUnpaid principal
> statusintegerLoan contract 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
> repayTypestring1: Auto Repayment; 2: Transfer to flexible loan; 0: No Automatic Repayment (compatible with existing orders)
> strategyTypestringPARTIAL: Allow partial fill; FULL: Full fill only
nextPageCursorstringRefer to the cursor request parameter

Request Example

GET /v5/spot-margin-trade/fixedborrow-contract-info?orderCurrency=USDT&limit=10 HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1692696840996
X-BAPI-RECV-WINDOW: 5000

Response Example

{
"retCode": 0,
"retMsg": "success",
"result": {
"list": [
{
"annualRate": "1.000000000000000000",
"borrowCurrency": "USDT",
"borrowTime": "1764162490000",
"interestPaid": "1.065753424657534247",
"loanId": "2092341042506646784",
"orderId": "FIXED_BORROW_a17089fc526441faa52eb99b0b9feb69185",
"repaymentTime": "1764288000000",
"residualPenaltyInterest": "0",
"residualPrincipal": "0.000000000000000000",
"status": 3,
"term": "1",
"repayType": "1",
"strategyType": "PARTIAL"
},
{
"annualRate": "1.000000000000000000",
"borrowCurrency": "USDT",
"borrowTime": "1764149170000",
"interestPaid": "0.030136986301369864",
"loanId": "2092229306860452864",
"orderId": "FIXED_BORROW_a17089fc526441faa52eb99b0b9feb69185",
"repaymentTime": "1764244800000",
"residualPenaltyInterest": "0",
"residualPrincipal": "0.000000000000000000",
"status": 3,
"term": "1",
"repayType": "1",
"strategyType": "PARTIAL"
},
{
"annualRate": "1.000000000000000000",
"borrowCurrency": "USDT",
"borrowTime": "1764120790000",
"interestPaid": "1.643835616438356165",
"loanId": "2091991237922142464",
"orderId": "FIXED_BORROW_a17089fc526441faa52eb99b0b9feb69185",
"repaymentTime": "1764244800000",
"residualPenaltyInterest": "0",
"residualPrincipal": "0.000000000000000000",
"status": 3,
"term": "1",
"repayType": "1",
"strategyType": "PARTIAL"
}
],
"nextPageCursor": "0"
},
"retExtInfo": {},
"time": 1775617311081
}