​
Overview

The “Token Hold” loyalty rule allows admins to reward users based on their NFT holdings across supported blockchain networks. The rule enables the aggregation of token balances across multiple collections and defines a structured reward system based on holding requirements.
Token Hold

​
Rule Configuration Fields

​
Contract Address

  • Collection Contract Address: Enter one or more contract addresses representing the collections.
  • Network: Select the blockchain network where the contract is deployed.
  • Add New Collection: Allows adding multiple collections for token aggregation.
  • Important Note: Token holdings from different collections will be aggregated to determine total holdings when more than one collection is added.

​
Reward

  • Type of Reward: Choose between “Points” or “Multiplier”.
  • Points: Users will get the defined no of points based on their holdings.
  • Multiplier: Users will get the multiplier of the defined range based on their holdings.
  • Reward Per Token: Toggle on to reward users per token held.
  • Required Hold Tokens Range: Define a range of tokens that need to be held for eligibility.
  • Points to Reward: Define the number of points assigned for the specified holding range.
  • Add New Range: Allows defining multiple token holding ranges with corresponding rewards.
  • Only reward existing users: If enabled this will limit rewards to users already in the loyalty program instead of all eligible wallets.

​
Update Cadence

The Update Cadence field is crucial as it defines:
  1. Reward Frequency: Determines how often the user will receive rewards (e.g., Daily, Weekly, Monthly).
  2. Holding Verification: Specifies when the system will check the token holdings to determine eligibility.
  3. Relation to Start Time: The first verification of token holdings and reward distribution will begin at the defined Start Time. Subsequent verifications and rewards will follow the selected cadence (e.g., if the cadence is set to “Daily,” the system will check and reward holdings every 24 hours from the Start Time).

​
Custom Settings

  • Only reward users that bought on native marketplace
  • Only reward users with unlisted tokens
  • Skip the multiplier for this rule
  • Only reward single token ownership per collection
  • Add API to get dynamic rewards for each token
  • Add custom reward for each token
  • Only reward users that have paid full royalty
  • Only reward users that have verified Twitter accounts

​
Call to Action (Optional)

This will show a call to action in our loyalty rule.
  • Link: Provide a URL for users to take further action.
  • Button Text: Define the button label.