跳至主要内容

查詢借貸歷史利率

您可以查詢最多過去6個月的借貸利率數據

信息
  • 需要鑒權, API密鑰需要有"現貨"權限
  • 僅支持統一帳戶訪問
  • 返回的是公共數據, i.e., 不同用戶在查詢相同的vip等級時, 拿到的是相同的歷史利率

HTTP 請求

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

請求參數

參數是否必需類型說明
currencytruestring幣種名稱, 必須大寫
vipLevelfalsestringVIP等級
  • 請注意對於"No VIP", 需要傳入"No%20VIP"
  • 若不傳, 則返回匹配您帳戶等級的數據
  • startTimefalseinteger開始時間戳 (毫秒)
  • 兩個時間參數要麼都傳要麼都不傳
  • 當都不傳時, 默認返回過去7天的數據
  • 當都傳時, 最多支持30天的時間跨度
  • endTimefalseinteger結束時間戳 (毫秒)

    響應參數

    參數類型說明
    listarray<object>
    > timestamplong時間
    > currencystring幣種名稱
    > hourlyBorrowRatestring每小時利率
    > vipLevelstringVIP等級

    請求示例

    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

    響應示例

    {
    "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
    }