Get Borrow History

Get interest records, sorted in reverse order of creation time.

HTTP Request

GET /v5/account/borrow-history

Request Parameters

Parameter	Required	Type	Comments
currency	false	string	USDC,USDT,BTC,ETH etc, uppercase only
startTime	false	integer	The start timestamp (ms) startTime and endTime are not passed, return 30 days by default Only startTime is passed, return range between startTime and startTime+30 days Only endTime is passed, return range between endTime-30 days and endTime If both are passed, the rule is endTime - startTime <= 30 days
endTime	false	integer	The end time. timestamp (ms)
limit	false	integer	Limit for data size per page. [1, 50]. Default: 20
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
> currency	string	USDC,USDT,BTC,ETH
> createdTime	integer	Created timestamp (ms)
> borrowCost	string	Interest
> hourlyBorrowRate	string	Hourly Borrow Rate
> InterestBearingBorrowSize	string	Interest Bearing Borrow Size
> costExemption	string	Cost exemption
> borrowAmount	string	Total borrow amount
> unrealisedLoss	string	Unrealised loss
> freeBorrowedAmount	string	The borrowed amount for interest free
nextPageCursor	string	Refer to the cursor request parameter

---

Request Example

HTTP

GET /v5/account/borrow-history?currency=BTC&limit=1 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672277745427
X-BAPI-RECV-WINDOW: 5000

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.get_borrow_history(
    currency="BTC",
    limit=1,
))

Node.js

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

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

client
  .getBorrowHistory({
    currency: 'USDT', 
    startTime: 1670601600000, 
    endTime: 1673203200000, 
    limit: 30, 
    cursor: 'nextPageCursorToken', 
  })
  .then((response) => {
    console.log(response);
  })
  .catch((error) => {
    console.error(error);
  });

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "nextPageCursor": "2671153%3A1%2C2671153%3A1",
        "list": [
            {
                "borrowAmount": "1.06333265702840778",
                "costExemption": "0",
                "freeBorrowedAmount": "0",
                "createdTime": 1697439900204,
                "InterestBearingBorrowSize": "1.06333265702840778",
                "currency": "BTC",
                "unrealisedLoss": "0",
                "hourlyBorrowRate": "0.000001216904",
                "borrowCost": "0.00000129"
            }
        ]
    },
    "retExtInfo": {},
    "time": 1697442206478
}