maturity-redemption
API reference for configuring the maturity-redemption token feature during token creation and triggering redemption after the maturity date.
The maturity-redemption token feature handles end-of-life redemption for fixed-income instruments. Configure during token creation; trigger maturity through the dedicated endpoint after the maturity date.
For the operator how-to, see Maturity redemption how-to. For the architecture model, see Maturity redemption architecture.
Configuration during token creation
Include maturity-redemption in the featureConfigs map of POST /api/v2/token:
{
"maturity-redemption": {
"maturityDate": "2027-12-31",
"denominationAsset": "0x...",
"treasury": "0x...",
"faceValue": "1000.00"
}
}| Parameter | Type | Required | Description |
|---|---|---|---|
maturityDate | ISO 8601 date | Yes | When the instrument matures. Immutable on most templates. |
denominationAsset | Ethereum address | Yes | ERC-20 token face value pays in. |
treasury | Ethereum address | Yes | Wallet that holds the denomination asset for redemption. |
faceValue | Decimal string | Yes | Redemption amount per token, in denominationAsset units. |
Trigger maturity
After maturityDate, post to the maturity endpoint to move the asset into redemption state:
POST /api/v2/token/{address}/features/maturity-redemption/triggerThe platform queues the on-chain transition. Pre-maturity transfers continue to evaluate against the asset's compliance modules; post-maturity transfers are blocked.
Holder redemption
Holders submit redemption through the standard burn flow once the maturity state is active. The platform transfers faceValue × balance of the denomination asset from treasury and burns the holder's position. Insufficient treasury balance fails the redemption.
Related
- Fixed treasury yield — often paired for coupon-paying bonds.
- Token lifecycle
permit
API reference for the DALP permit token feature, which enables EIP-2612 signature-based approvals on the asset.
fixed-treasury-yield
API reference for configuring the fixed-treasury-yield token feature and operating the holder claim, treasury top-up, and yield-withdraw endpoints through the fixed-yield-schedule addon.