​
Overview

Multipliers are a powerful feature in the loyalty system that allow you to amplify the points users earn. Unlike standard point rewards that grant a fixed number of points, multipliers increase the value of all point-based rewards a user receives, creating opportunities for enhanced engagement and more valuable rewards.

​
Multipliers vs. Points

The loyalty system supports two primary reward types:

  • Points: A straightforward reward where users receive a specific number of points in the designated currency upon completing a rule.
  • Multipliers: A reward that increases the value of all point-based rewards a user receives.

​
How Multipliers Work

When a user completes a rule configured with a multiplier reward, they receive a multiplier value (e.g., 2x, 3x, 4x) that will be applied to their future point earnings. Multipliers effectively act as point amplifiers, allowing users to earn points at an accelerated rate.

​
Example

If a user has a 3x multiplier and completes an action worth 10 points, they will receive 30 points (10 × 3) instead of the base 10 points.

​
Retroactive Multiplier Application

The loyalty system includes a flag that allows multipliers to be applied retroactively to a user’s existing point balance. When you activate this toggle, please note that the selected multiplier will be applied retroactively to the user’s existing balance. This means that the multiplier will increase the current balance by the specified factor, effectively multiplying the user’s total rewards from previous wins. Ensure that this retroactive adjustment is communicated clearly to users.

For example, if a user has 500 points and earns a 2x multiplier with retroactive application enabled, their balance would immediately increase to 1,000 points.

​
Excluding Rules from Multiplier Effects

For certain point-based rules, you can enable the “Skip Multiplier” flag. When this flag is turned on, points earned from that specific rule will not be multiplied by the user’s multiplier value. This allows you to create baseline rewards that are always awarded at their face value, regardless of a user’s accumulated multipliers.

​
Multiplier Balance Logic

Users can accumulate multiple multipliers from different rules. When a user has multiple multipliers, they stack according to a specific balance logic:

  1. The first multiplier is applied at full value
  2. Each additional multiplier is reduced by 1 before being added to the total

​
Formula

Total Multiplier = First Multiplier + Sum of (Additional Multipliers - 1)

​
Example

If a user has the following multipliers:

  • Hold BAYC NFT: 4x
  • Hold PENGU NFT: 3x
  • Hold ETH: 3x
  • Have Discord Role Moderator: 2x

The total multiplier would be calculated as:

  • First multiplier (4x) + (3x - 1) + (3x - 1) + (2x - 1)
  • 4x + 2x + 2x + 1x = 9x

This means all point rewards for this user would be multiplied by 9.

​
Multipliers and User Groups

When users connect multiple wallets through a user group, the system applies special logic for handling multipliers across the group. This ensures that all wallets in the group benefit from the highest available multipliers while maintaining a balanced reward economy.

​
Multiplier Selection in User Groups

For each loyalty rule type, the system will:

  1. Identify all multipliers earned by wallets in the same user group
  2. Select the highest multiplier value for each rule type
  3. Apply this highest multiplier to all wallets in the group

​
Example

Consider a user group with two connected wallets:

  • Wallet A has earned:

    • 3x multiplier for holding BAYC NFT
    • 2x multiplier for Discord role “Moderator”
    • 1.5x multiplier for completing daily quests

  • Wallet B has earned:

    • 4x multiplier for holding BAYC NFT
    • 1.5x multiplier for Discord role “Moderator”
    • 2x multiplier for completing daily quests

The system will select the highest multiplier for each rule type:

  • BAYC NFT holding: 4x (from Wallet B)
  • Discord role “Moderator”: 2x (from Wallet A)
  • Daily quests: 2x (from Wallet B)

Both Wallet A and Wallet B will benefit from these highest multipliers, effectively:

  • Both wallets get 4x multiplier for BAYC NFT holdings
  • Both wallets get 2x multiplier for Discord role “Moderator”
  • Both wallets get 2x multiplier for daily quests

Using the multiplier balance logic formula (First Multiplier + Sum of (Additional Multipliers - 1)):

  • First multiplier (4x) + (2x - 1) + (2x - 1)
  • 4x + 1x + 1x = 6x total multiplier

This means all point rewards for both wallets in the group would be multiplied by 6, unless the “Skip Multiplier” flag is enabled for specific rules.

​
Important Notes

  1. No Stacking Within Groups: Multipliers from different wallets in the same group do not stack. Only the highest multiplier for each rule type is applied.

  2. Individual Multiplier Tracking: While the highest multiplier is applied to all wallets in the group, the system still tracks individual multiplier achievements for each wallet.

  3. Group Benefits: This system ensures that all wallets in a group benefit from the best multipliers earned by any member, creating an incentive for users to maintain their connections within the group.

​
Setting Up Multiplier Rewards

When creating a loyalty rule, you can select “Multiplier” as the reward type instead of “Points.” You’ll then need to specify the multiplier value (e.g., 2x, 3x, 4x) that users will receive upon completing the rule.

​
Currency Selection for Multipliers

The loyalty system allows you to specify which currencies your multipliers will affect. Using a dropdown menu, you can select one or more currencies to which the multiplier will be applied. This gives you fine-grained control over your reward economy, as rules can be configured to reward points in different currencies, and multipliers can be targeted to specific currencies.

For example, you might create a multiplier that only applies to your “Premium Points” currency but not to your “Standard Points” currency, allowing for strategic differentiation in how users can accelerate their earnings across different point types.

​
Rule Type Limitations

Note that multiplier rewards are not supported for all rule types. Specifically:

  • Referral rules
  • Smart contract event rules

These rule types only support point-based rewards.

​
Strategic Uses for Multipliers

Multipliers can be strategically implemented to:

  1. Reward high-value actions: Assign higher multipliers to actions that are more valuable to your platform
  2. Encourage collection ownership: Reward users who hold specific NFTs or tokens with multipliers
  3. Create tiered loyalty systems: Design a system where users can progressively increase their earning potential
  4. Drive engagement with key features: Incentivize users to engage with important platform features

​
Strategic Considerations

  • Use multipliers sparingly for high-value actions to maintain their perceived value
  • Clearly communicate to users how multipliers work and how they stack
  • Balance your multiplier values to ensure the reward economy remains sustainable

​
Direct Multiplier Rewards via API

In addition to rule-based multiplier rewards, you can also directly assign multipliers to specific users through the Create Loyalty Multiplier API. This allows for programmatic control over multiplier distribution from your own server, enabling custom reward logic or manual multiplier assignments.

To implement direct multiplier rewards, use the API endpoint documented at Multiplier API Reference.

This approach is particularly useful for:

  • Custom reward campaigns not covered by standard rules
  • Manual multiplier adjustments for specific users
  • Integration with external systems or events
  • Bulk multiplier assignments based on your own business logic