# Voting Power

Source: https://docs.settlemint.com/docs/api-reference/token-features/voting-power
API reference for the DALP Voting Power token feature, including delegation mutations, delegation history, and current distribution reads.



Voting Power exposes delegated governance weight for a token.

Use this reference when you need API paths for delegation, relayed delegation, delegation history, or current Voting Power distribution. For the product model, see [Voting Power architecture](/docs/architects/components/token-features/voting-power). For operating guidance, see [Voting Power how-to](/docs/operators/token-features/voting-power).

## Configuration [#configuration]

No `featureConfigs` entry is required. `voting-power` is the API feature identifier for Voting Power. It has no feature-specific configuration during token creation, and the feature can be omitted from `featureConfigs` or supplied as an empty object.

## Mutations [#mutations]

| Endpoint                                                                            | Body                                                                                                  | Returns                                                      |
| ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| `POST /api/v2/tokens/{tokenAddress}/features/voting-power/delegations`              | `{ "delegatee": "0x..." }`                                                                            | An async blockchain mutation response for the updated token. |
| `POST /api/v2/tokens/{tokenAddress}/features/voting-power/delegations/by-signature` | `{ "delegatee": "0x...", "nonce": "0", "expiry": "1767225600", "v": 27, "r": "0x...", "s": "0x..." }` | An async blockchain mutation response for the updated token. |

A direct delegation uses the selected wallet and requires that wallet to be registered in the token identity registry. A signature delegation relays signed delegation data; the API validates the signer before queuing the transaction.

## Reads [#reads]

| Endpoint                                                      | Returns                                                                                                                                   |
| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `GET /api/v2/tokens/{tokenAddress}/voting-delegations`        | Paginated delegation lifecycle rows for Voting Power.                                                                                     |
| `GET /api/v2/tokens/{tokenAddress}/voting-power/distribution` | Current voting power per delegate, ordered by latest votes, with a top-N list and an aggregated `other` bucket for the remaining holders. |

For historical holder balances at a snapshot timepoint, use the `historical-balances` feature endpoints. Voting Power and Historical Balances answer different questions: Voting Power tracks delegated governance weight, while Historical Balances tracks token balances and total supply over time.

## Related [#related]

* [Historical Balances](/docs/api-reference/token-features/historical-balances) for balance checkpoints and snapshot reads.
* [Voting Power architecture](/docs/architects/components/token-features/voting-power) for the feature model and constraints.
* [Voting Power how-to](/docs/operators/token-features/voting-power) for operator workflow guidance.