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

Parameter	Required	Type	Comments
orderId	false	string	Loan order ID
loanCurrency	false	string	Loan coin name
collateralCurrency	false	string	Collateral coin name
limit	false	string	Limit for data size per page. [1, 100]. Default: 10
cursor	false	string	Cursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters

Parameter	Type	Comments
list	array	Object
> borrowTime	string	The timestamp to borrow
> collateralCurrency	string	Collateral coin
> expirationTime	string	Loan maturity time, keeps "" for flexible loan
> hourlyInterestRate	string	Hourly interest rate Flexible loan, it is real-time interest rate Fixed term loan: it is fixed term interest rate
> initialCollateralAmount	string	Initial amount to mortgage
> initialLoanAmount	string	Initial loan amount
> loanCurrency	string	Loan coin
> loanTerm	string	Loan term, 7, 14, 30, 90, 180 days, keep "" for flexible loan
> orderId	string	Loan order ID
> repaidInterest	string	Total interest repaid
> repaidPenaltyInterest	string	Total penalty interest repaid
> status	integer	Loan order status 1: fully repaid manually; 2: fully repaid by liquidation
nextPageCursor	string	Refer to the cursor request parameter

Request Example

HTTP

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

Python

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
  testnet: true,
  key: 'apikey',
  secret: 'apisecret',
});

client
  .getCompletedLoanOrderHistory({ orderId: '1794267532472646144' })
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

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
}