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. For operating guidance, see Voting Power how-to.
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
| 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
| 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
- Historical Balances for balance checkpoints and snapshot reads.
- Voting Power architecture for the feature model and constraints.
- Voting Power how-to for operator workflow guidance.