Get Earn Redeem Preview by Holding ID

This endpoint retrieves redemption preview information by holding ID. If the current holding is fully redeemed or in the process of being redeemed, it indicates that the holding does not exist.

HTTP REQUEST

GET /api/v1/earn/redeem-preview

Example

GET /api/v1/earn/redeem-preview?orderId=13100&fromAccountType=MAIN

{
  "code": "200000",
  "data": {
    "currency": "USDT",
    "redeemAmount": "216.82345600",
    "penaltyInterestAmount": "1.00000000",
    "redeemPeriod": 0,
    "deliverTime": 1716967121000,
    "manualRedeemable": true,
    "redeemAll": true
  }
}

API Permissions

This endpoint requires earn permission.

REQUEST URL

This endpoint supports Spot URL.

REQUEST RATE LIMIT

Wealth weight: 5

PARAMETERS

Param	Type	Mandatory	Description
orderId	String	Yes	Holding ID
fromAccountType	String	No	Account type: MAIN (funding account), TRADE (spot trading account). This parameter is valid only when orderId=ETH2

RESPONSES

Param	Description
currency	Redemption currency
redeemAmount	Expected redemption amount
penaltyInterestAmount	Penalty interest amount, incurred for early redemption of fixed-term products
redeemPeriod	Redemption waiting period (days)
deliverTime	Expected deliver time (milliseconds)
manualRedeemable	Whether manual redemption is possible
redeemAll	Whether the entire holding must be redeemed, required for early redemption of fixed-term products