Skip to main content

Get Historical Interest Rate

You can query up to six months borrowing interest rate of Margin trading.

info
  • Need authentication, the api key needs "Spot" permission
  • Only supports Unified account
  • It is public data, i.e., different users get the same historical interest rate for the same VIP/Pro

HTTP Request

GET /v5/spot-margin-trade/interest-rate-history

Request Parameters

ParameterRequiredTypeComments
currencytruestringCoin name, uppercase only
vipLevelfalsestringVip level
  • Please note that "No VIP" should be passed like "No%20VIP" in the query string
  • If not passed, it returns your account's VIP level data
  • startTimefalseintegerThe start timestamp (ms)
  • Either both time parameters are passed or neither is passed.
  • Returns 7 days data when both are not passed
  • Supports up to 30 days interval when both are passed
  • endTimefalseintegerThe end timestamp (ms)

    Response Parameters

    ParameterTypeComments
    listarray<object>
    > timestamplongtimestamp
    > currencystringcoin name
    > hourlyBorrowRatestringHourly borrowing rate
    > vipLevelstringVIP/Pro level

    Request Example

    GET /v5/spot-margin-trade/interest-rate-history?currency=USDC&vipLevel=No%20VIP&startTime=1721458800000&endTime=1721469600000 HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-SIGN: XXXXXX
    X-BAPI-API-KEY: XXXXXX
    X-BAPI-TIMESTAMP: 1721891663064
    X-BAPI-RECV-WINDOW: 5000

    Response Example

    {
    "retCode": 0,
    "retMsg": "OK",
    "result": {
    "list": [
    {
    "timestamp": 1721469600000,
    "currency": "USDC",
    "hourlyBorrowRate": "0.000014621596",
    "vipLevel": "No VIP"
    },
    {
    "timestamp": 1721466000000,
    "currency": "USDC",
    "hourlyBorrowRate": "0.000014621596",
    "vipLevel": "No VIP"
    },
    {
    "timestamp": 1721462400000,
    "currency": "USDC",
    "hourlyBorrowRate": "0.000014621596",
    "vipLevel": "No VIP"
    },
    {
    "timestamp": 1721458800000,
    "currency": "USDC",
    "hourlyBorrowRate": "0.000014621596",
    "vipLevel": "No VIP"
    }
    ]
    },
    "retExtInfo": "{}",
    "time": 1721899048991
    }