SettleMint
API integrationToken features

aum-fee

API reference for configuring the aum-fee token feature and reading or collecting accrued management fees through dapi endpoints.

The aum-fee token feature accrues a periodic management fee against outstanding supply, paid to a configured recipient. Configure during token creation. Read accrued fees and collect through the feature endpoints.

For the operator how-to, see AUM fee how-to. For the architecture model, see AUM fee architecture.

Configuration during token creation

{
  "aum-fee": {
    "feeBps": 200,
    "recipient": "0x..."
  }
}
ParameterTypeRequiredDescription
feeBpsIntegerYesAnnualised fee rate in basis points. 200 = 2.00% per year.
recipientEthereum addressYesWallet that receives the collected fee.

Reading accrued fees

GET /api/v2/token/{address}/features/aum-fee

Returns the running accrual since the last collection, plus the configured rate and recipient.

Collecting accrued fees

POST /api/v2/token/{address}/features/aum-fee/collect

Transfers accrued tokens from the asset to the configured recipient. The platform queues the transfer as an async blockchain mutation.

Updating parameters

Restricted-mutable. Update through the asset's governance-update path:

PUT /api/v2/token/{address}/features/aum-fee
{
  "feeBps": 150,
  "recipient": "0x..."
}

Updates apply forward; previously accrued amounts continue to settle at the previous rate to the previous recipient.

On this page