Skip to main content
Two steps maximize your rewards earnings. Complete both for every payout group.
  • Associate unassigned addresses — Reward addresses with no payout group do not accrue rewards. Assign them to start earning rewards.
  • Register your payout destination — If the address where rewards are paid out is also registered for monitoring, claimed rewards continue to compound at the claim frequency.

​
Associate All Addresses

Required scopes: rewards:read_monitoring_address to list, rewards:write_monitoring_address to update.

​
➊ Find unassigned addresses

Use List Reward Addresses and pass the zero UUID as payout_group_id. The API returns only addresses that have no payout group assigned. Record the id and ledger for each address returned. If the response is empty, all of your addresses are already associated — skip to Register Payout Addresses.

​
➋ Ensure a payout group exists for each chain

Payout groups are chain-specific. Each address must be assigned to a payout group on the same network.
If you already have a payout group for each chain, skip to ➌ Assign. Otherwise, create one first — see Create a Payout Group.

​
➌ Assign each address

Use Update Reward Address to set the payout_group_id on each address.
Update the address — do not re-submit it. Creating a new entry with the same on-chain address will silently succeed without updating the payout group assignment. Only PUT /v2/rewards/addresses/{id} correctly moves an existing address into a payout group.
The address status returns to UNREGISTERED and on-chain registration begins automatically. Repeat for each unassigned address.

​
➍ Confirm registration

Poll List Reward Addresses filtered to your payout group until each address shows status: ACTIVE.
Rewards are not retroactive. Accrual begins on the day an address reaches ACTIVE status.

​
Register Payout Addresses

When rewards are claimed, they are sent to each payout group’s destination address. If that destination address is also registered for monitoring, the paid out rewards will also accrue, further compounding your rewards.
Required scope: rewards:write_monitoring_address

​
➊ Find each payout group’s destination address

Use List Payout Groups to retrieve the destination_address for each group:

​
➋ Check if the destination address is already registered

If the destination address already appears in the response, it is registered — skip to the next payout group.

​
➌ Register the destination address

Use Create a Reward Address to add the destination address as a monitored reward address in its own payout group: Repeat for each payout group whose destination address is not already registered.

​
Next steps

Monitor Reward Details

Check current rates, accruals, and available rewards

View Claims

Track payout history and claim status
Questions? Contact Support.