跳至主要内容

查詢空投每日收益記錄

可查詢最近 3 個月的歷史收益數據。

信息
  • API key 需要 理財 權限
  • 僅返回已發放（status = complete）的收益記錄，未發放、失敗及金額為零的記錄均不可見。
  • 非 byfi earn 歷史用戶調用將直接返回成功狀態及空列表。

HTTP 請求​

GET/v5/earn/hold-to-earn/yield-history

請求參數​

參數是否必需類型說明
timeStartfalseinteger起始時間（Unix 秒）。不得早於「當前時間 - 3 個月」，否則返回 INVALIDARGUMENTS
timeEndfalseinteger結束時間（Unix 秒）。要求 timeStart ≤ timeEnd
limittrueinteger單頁大小，範圍：1 至 49。超出範圍返回 INVALIDARGUMENTS
cursorfalsestring翻頁游標。首次查詢不傳；後續翻頁傳入上一次響應中的 nextCursor。游標對接入方不透明，僅作整體回傳，不要解析或拼接
信息

當 timeStart 與 timeEnd 同時為 0 時，自動查詢最近 3 個月的數據。

響應參數​

參數類型說明
nextCursorstring下一頁游標。空字符串表示已到尾頁；翻頁時將其原樣傳回 cursor 即可
airdropDailyPnlsarray收益記錄列表，按發放日倒序排列（較新在前）
> coinNamestring投資幣種名稱
> yieldCoinNamestring收益幣種名稱。跨幣種空投時與 coinName 不同
> effectiveAmountstring當日計息本金（已格式化字符串，如 "10000.00"）
> pnlstring當日實際發放收益（已格式化字符串，如 "0.27397260"）
> apystring該日折算年化收益文案（如 "10%"）
> createdAtinteger收益發放時間（Unix 秒）

請求示例​

GET /v5/earn/hold-to-earn/yield-history?timeStart=1739952000&timeEnd=1747728000&limit=20 HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1741651200000
X-BAPI-RECV-WINDOW: 5000

響應示例​

{
    "nextCursor": "eyJsYXN0SWQiOjEwMDE5MH0=",
    "airdropDailyPnls": [
        {
            "coinName": "USDE",
            "yieldCoinName": "USDE",
            "effectiveAmount": "10000.00",
            "pnl": "0.27397260",
            "apy": "10%",
            "createdAt": 1747641600
        },
        {
            "coinName": "USDE",
            "yieldCoinName": "USDE",
            "effectiveAmount": "10000.00",
            "pnl": "0.27397260",
            "apy": "10%",
            "createdAt": 1747555200
        }
    ]
}

翻頁示例​

繼續向後翻頁時，將上一次響應中的 nextCursor 原樣傳回 cursor：

GET /v5/earn/hold-to-earn/yield-history?limit=20&cursor=eyJsYXN0SWQiOjEwMDE5MH0= HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1741651200000
X-BAPI-RECV-WINDOW: 5000

當響應中的 nextCursor 為空字符串時，表示已到達尾頁。