Get Earn Limited-Time Promotion Products

This endpoint retrieves limited-time promotion products. If no products are available, an empty list is returned.

HTTP REQUEST

GET /api/v1/earn/promotion/products

Example

GET /api/v1/earn/promotion/products

{
  "code": "200000",
  "data": [
    {
      "id": "30112",
      "currency": "USDT",
      "category": "ACTIVITY",
      "type": "TIME",
      "precision": 8,
      "productUpperLimit": "999999",
      "userUpperLimit": "600",
      "userLowerLimit": "2",
      "redeemPeriod": 1,
      "lockStartTime": 1655091200000,
      "lockEndTime": 1717557730000,
      "applyStartTime": 1655091200000,
      "applyEndTime": null,
      "returnRate": "1.00000000",
      "incomeCurrency": "USDT",
      "earlyRedeemSupported": 1,
      "productRemainAmount": "999999",
      "status": "ONGOING",
      "redeemType": "TRANS_DEMAND",
      "incomeReleaseType": "DAILY",
      "interestDate": 1716952930000,
      "duration": 7,
      "newUserOnly": 1
    }
  ]
}

API KEY Permissions

This endpoint requires general permission.

REQUEST URL

This endpoint supports spot URL.

REQUEST RATE LIMIT

Earn weight: 5

PARAMETERS

Param	Type	Mandatory	Description
currency	String	No	Subscription currency

RESPONSES

Param	Description
id	Product ID
currency	Subscription currency
category	Product category: ACTIVITY (activity)
type	Product subtype: TIME (fixed), DEMAND (demand)
precision	Maximum precision supported
productUpperLimit	Total product limit
userUpperLimit	Maximum subscription limit per user
userLowerLimit	Minimum subscription limit per user
redeemPeriod	Redemption waiting period (days)
lockStartTime	Product earliest interest start time, in milliseconds
lockEndTime	Product maturity time, in milliseconds
applyStartTime	Subscription start time, in milliseconds
applyEndTime	Subscription end time, in milliseconds
returnRate	Annual interest rate, raw value, not multiplied by 100
incomeCurrency	Income currency
earlyRedeemSupported	Whether the fixed product supports early redemption: 0 (no), 1 (yes)
productRemainAmount	Remaining product limit
status	Product status: ONGOING (ongoing), PENDING (pending), FULL (full), INTERESTING (interest in progress)
redeemType	Redemption channel: MANUAL (manual redemption), TRANS_DEMAND (transfer to corresponding demand product upon maturity), AUTO (redeem to funding account upon maturity)
incomeReleaseType	Income release type: DAILY (daily release), AFTER (release after product ends)
interestDate	Most recent interest date
duration	Product duration (days)
newUserOnly	Whether the product is exclusive for new users: 0 (no), 1 (yes)