Skip to main content

Get Completed Loan Order History

Query the completed loan orders

Permission: "Spot trade"

info

Support querying last 6 months completed loan orders

HTTP Request

GET /v5/crypto-loan/borrow-history

Request Parameters

ParameterRequiredTypeComments
orderIdfalsestringLoan order ID
loanCurrencyfalsestringLoan coin name
collateralCurrencyfalsestringCollateral 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
> borrowTimestringThe timestamp to borrow
> collateralCurrencystringCollateral coin
> 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
  • > initialCollateralAmountstringInitial amount to mortgage
    > initialLoanAmountstringInitial loan amount
    > loanCurrencystringLoan coin
    > loanTermstringLoan term, 7, 14, 30, 90, 180 days, keep "" for flexible loan
    > orderIdstringLoan order ID
    > repaidIntereststringTotal interest repaid
    > repaidPenaltyIntereststringTotal penalty interest repaid
    > statusintegerLoan order status 1: fully repaid manually; 2: fully repaid by liquidation
    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": [
    {
    "borrowTime": "1728546174028",
    "collateralCurrency": "BTC",
    "expirationTime": "1729148399000",
    "hourlyInterestRate": "0.0000010241",
    "initialCollateralAmount": "0.0494727",
    "initialLoanAmount": "1",
    "loanCurrency": "ETH",
    "loanTerm": "7",
    "orderId": "1793569729874260992",
    "repaidInterest": "0.00000515",
    "repaidPenaltyInterest": "0",
    "status": 1
    }
    ],
    "nextPageCursor": ""
    },
    "retExtInfo": {},
    "time": 1728632014857
    }