Skip to main content

Get Airdrop Products

info

Does not need authentication. Guest access is supported. Authenticated users receive a product list filtered based on account eligibility.

HTTP Request

GET/v5/earn/hold-to-earn/product

Request Parameters

None

Response Parameters

ParameterTypeComments
productsarrayObject
> coinNamestringInvestment coin name, e.g., "USDE", "USDTB", "USD1"
> yieldsarrayYield coin object, e.g., "USDE", "WLFI". May differ from coinName for cross-coin airdrops (e.g., USD1 holdings → WLFI rewards)
>> coinNamestringYield coin name
>> apystringYesterday's APR, formatted for direct display, e.g., "10%", "3.5%". Returns "0%" when no yield was distributed yesterday for the yield coin
>> personalApystringPersonal APR for this yield coin, formatted for direct display including the % suffix, e.g., "5.285982%". Reflects the user's individual rate after applying their personal multiplier
>> multiplierstringPersonal coefficient applied to the base APR. Returns "1" when the user has no position in this product
> statusstringProduct stage, NotStarted, Online, Ended
> apystringYesterday's avg APR cross all yield coins, formatted for direct display, e.g., "10%", "3.5%". Returns "0%" when no yield was distributed yesterday
> personalApystringSum of personal APR across all yield coins, formatted for direct display including the % suffix, e.g., "6.52459%"
> announcementUrlstringActivity rules announcement URL
info
  • Products are filtered by compliance rules, region (EEA), Islamic account status, whitelist membership, and product status. Only products the current user is eligible to participate in are returned.
  • When coinName != yields.coinName, it is a cross-coin airdrop
  • Results are sorted by product creation time, newest first.

Request Example

GET /v5/earn/hold-to-earn/product HTTP/1.1
Host: api.bybit.com

Response Example

{
"retCode": 0,
"retMsg": "",
"result": {
"products": [
{
"coinName": "USDE",
"yields": [
{
"coinName": "USDE",
"apy": "0.210604%",
"personalApy": "0.421208%",
"multiplier": "2"
}
],
"status": "Online",
"apy": "0.210604%",
"personalApy": "0.421208%",
"announcementUrl": "https://testnet.bybit.com/en/earn/usde-page"
},
{
"coinName": "USDTB",
"yields": [
{
"coinName": "USDTB",
"apy": "0.029978%",
"personalApy": "0.029978%",
"multiplier": "1"
}
],
"status": "Online",
"apy": "0.029978%",
"personalApy": "0.029978%",
"announcementUrl": "https://testnet.bybit.com/en/earn/usdtb-page"
},
{
"coinName": "USD1",
"yields": [
{
"coinName": "WLFI",
"apy": "10%",
"personalApy": "10%",
"multiplier": "1"
}
],
"status": "Ended",
"apy": "10%",
"personalApy": "10%",
"announcementUrl": "https://testnet.bybit.com/en/earn/usd1-page"
}
]
},
"retExtInfo": {},
"time": 1779348459085
}