跳至主要内容

查詢每小時收益歷史

信息

API key需要"理財""權限

HTTP 請求

GET /v5/earn/hourly-yield

請求參數

參數名稱必填類型說明
categorytruestringFlexibleSaving
productIdfalsestring產品 ID
startTimefalseinteger開始時間戳 (ms)。
  • 1. 如果未提供 startTime 和 endTime,默認返回最近 7 天的數據。
  • 2. 如果提供了 startTime 和 endTime,則結束時間與開始時間的差值必須小於或等於 7 天。
endTimefalseinteger結束時間戳 (ms)
limitfalseinteger每頁數據大小限制。範圍:[1, 100]。默認值:50
cursorfalsestring游標,使用返回的 nextPageCursor 查詢下一頁的數據。

響應參數

參數名稱類型說明
nextPageCursorstring游標,用於翻頁
listarray
> productIdstring產品 ID
> coinstring幣種名稱:"BTC", "ETH"
> idstring唯一鍵(僅在同一用戶下保證唯一)
> amountstring收益金額
>effectiveStakingAmountstring有效持倉金額,例如:1000.00
> statusstring訂單狀態:PendingSuccessFail
> hourlyDatestring每小時收益時間 (ms),例如:1755478800000
> createdAtstring訂單創建時間 (ms),例如:1684738540561

請求示例

GET /v5/earn/hourly-yield?category=FlexibleSaving HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1739937044221
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

響應示例

{
"retCode": 0,
"retMsg": "",
"result": {
"list": [
{
"productId": "428",
"coin": "USDT",
"amount": "0.060810502283105022",
"effectiveStakingAmount": "1000",
"hourlyDate": "1759989600000",
"status": "Success",
"createdAt": "1759989603000"
}
],
"nextPageCursor": ""
},
"retExtInfo": {},
"time": 1759993045287
}