# aum-fee

Source: https://docs.settlemint.com/docs/developers/api-integration/token-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](/docs/operators/token-features/aum-fee). For the architecture model, see [AUM fee architecture](/docs/architects/components/token-features/aum-fee).

## Configuration during token creation [#configuration-during-token-creation]

```json
{
  "aum-fee": {
    "feeBps": 200,
    "recipient": "0x..."
  }
}
```

| Parameter   | Type             | Required | Description                                                  |
| ----------- | ---------------- | -------- | ------------------------------------------------------------ |
| `feeBps`    | Integer          | Yes      | Annualised fee rate in basis points. `200` = 2.00% per year. |
| `recipient` | Ethereum address | Yes      | Wallet that receives the collected fee.                      |

## Reading accrued fees [#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 [#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 [#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.

## Related [#related]

* [Funds use case](/docs/business/use-cases/funds)
* [Token lifecycle](/docs/developers/api-integration/tokens/token-lifecycle)