Get Interest Rate History

Description

Query the historical margin borrowing interest rate for a specified coin and VIP tier. Used for backtesting borrowing costs, reconciling historical position interest, or estimating the interest savings from a VIP tier upgrade.

Data granularity is fixed at 1 hour, with the most recent 1 month retained.

HTTP Request

• GET /api/v3/market/interest-rate-history
• Rate limit: 10/sec/UID
• Permission: UTA mgt. (read)

Request

curl "https://api.bitget.com/api/v3/market/interest-rate-history?coin=USDT&vipLevel=0&limit=100" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:en-US" \
  -H "Content-Type: application/json"

Request Parameters

Parameter	Type	Required	Description
coin	String	Yes	Coin name, e.g. USDT Only coins with margin borrowing enabled are supported; an unsupported coin returns an error
startTime	String	No	Start time, a Unix millisecond timestamp Only data from the most recent 1 month is supported
endTime	String	No	End time, a Unix millisecond timestamp Must not be more than 30 days apart from startTime If no time parameters are provided, returns the most recent limit entries counting back from now
level	String	No	User tier vip0/vip1/vip2/vip3/vip4/vip5/vip6/vip7 pro1/pro2/pro3/pro4/pro5/pro6 Default: vip0
limit	String	No	Number of entries per page Default: 10. Maximum: 500
cursor	String	No	Pagination cursor Pass the cursor from the previous page's response

Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1756616400000,
  "data": {
    "cursor": "1756594800000",
    "list": [
      {
        "coin": "USDT",
        "dailyInterestRate": "0.00007704",
        "annualInterestRate": "0.0281",
        "ts": "1756616400000"
      },
      {
        "coin": "USDT",
        "dailyInterestRate": "0.00007728",
        "annualInterestRate": "0.0282",
        "ts": "1756609200000"
      }
    ]
  }
}

Response Parameters

Parameter	Type	Description
list	List<Object>	Interest rate history data set
> coin	String	Coin name
> dailyInterestRate	String	Daily interest rate In decimal form, e.g. 0.01 represents 1%
> annualInterestRate	String	Annual interest rate In decimal form, e.g. 0.01 represents 1%
> ts	String	Interest rate effective time A Unix millisecond timestamp
cursor	String	Cursor for the next page Empty indicates there is no more data