Token balance

Verify and reward users based on the balance of a specific token they hold in their cryptocurrency wallet.

Use this task to incentivize users to hold your project's token, reward early adopters, or encourage participation in token-gated communities or events.

Before you start

Make sure you have:

• A quest created within your campaign

• The token contract address(es) for the networks you want to support

• A minimum token balance threshold determined

Create the task

Follow the steps in Web3 tasks to navigate to the task creation screen, select Web3 from the Groups section, and choose Token Balance.

Task settings

Completion points: Set the number of points awarded when the user completes the task.

Points multiplier (%): Add a percentage-based bonus to the total reward. For example, a 10% multiplier increases the final reward by 10%.

Recurrence: Control how often users can complete the task:

• Once – can only be completed one time per user

• 8h – available once every eight hours

• Daily – available once every 24 hours

• Weekly – available once every 7 days

• Multiple – stays open and can be completed as many times as needed, one after another, without any waiting time

Networks: Select the blockchain network on which the token is issued. Click Add network to add multiple networks. For each network, you'll need to specify the Contract Address of the token on that specific network. This ensures that the task accurately checks the user's token balance across all relevant networks

Amount: Specify the minimum total token balance required to complete the task, across all specified networks. Example: If your token is "XYZ" and you want users to hold at least 10 XYZ tokens in total (across all networks they've added), enter "10". The balance is cumulative across all networks

Is progressive reward? (optional): Toggle this on if you want to offer increasing rewards based on the user's total token balance. This works by setting a base reward amount for the minimum token balance and then multiplying that reward for each multiple of the minimum balance

Example: If the minimum balance is 5 tokens and the base reward is 10 points, a user with 12 tokens would receive 20 points (2× the base reward since they have more than twice the minimum balance)

Is continous (optional): Toggle this on to enable continuous checking of the token balance.

Max progressive amount (optional): Set the maximum amount for progressive rewards. This field appears when "Is progressive reward?" is enabled.

Helpful tips

• Use this task to foster a sense of community among your token holders and encourage them to actively participate in your project

• Explain why you're checking token balances and how it relates to your campaign goals

• Consider using progressive rewards to incentivize users to hold more tokens