Skip to main content

Get Unpaid Loan Orders

Query the ongoing loan orders, which are not fully repaid

Permission: "Spot trade"

HTTP Request

GET /v5/crypto-loan/ongoing-orders

Request Parameters

ParameterRequiredTypeComments
orderIdfalsestringLoan order ID
loanCurrencyfalsestringLoan coin name
collateralCurrencyfalsestringCollateral coin name
loanTermTypefalsestring
  • 1: fixed term, when query this type, loanTerm must be filled
  • 2: flexible term
  • By default, query all types
    loanTermfalsestring7, 14, 30, 90, 180 days, working when loanTermType=1
    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
    > collateralAmountstringCollateral amount
    > collateralCurrencystringCollateral coin
    > currentLTVstringCurrent LTV
    > expirationTimestringLoan maturity time, keeps "" for flexible loan
    > hourlyInterestRatestringHourly interest rate
  • Flexible loan, it is real-time interest rate
  • Fixed term loan: it is fixed term interest rate
  • > loanCurrencystringLoan coin
    > loanTermstringLoan term, 7, 14, 30, 90, 180 days, keep "" for flexible loan
    > orderIdstringLoan order ID
    > residualIntereststringUnpaid interest
    > residualPenaltyIntereststringUnpaid penalty interest
    > totalDebtstringUnpaid principal
    nextPageCursorstringRefer to the cursor request parameter

    Request Example

    GET /v5/crypto-loan/ongoing-orders?orderId=1793683005081680384 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1728630979731
    X-BAPI-RECV-WINDOW: 5000

    Response Example

    {
    "retCode": 0,
    "retMsg": "request.success",
    "result": {
    "list": [
    {
    "collateralAmount": "0.0964687",
    "collateralCurrency": "BTC",
    "currentLTV": "0.4161",
    "expirationTime": "1731149999000",
    "hourlyInterestRate": "0.0000010633",
    "loanCurrency": "USDT",
    "loanTerm": "30",
    "orderId": "1793683005081680384",
    "residualInterest": "0.04016",
    "residualPenaltyInterest": "0",
    "totalDebt": "1888.005198"
    }
    ],
    "nextPageCursor": ""
    },
    "retExtInfo": {},
    "time": 1728630980861
    }