Volume Based XPs

Follow these steps to set up volume based XP:

1. Set Up the API:

   • Follow the usual steps to integrate your API. If you need assistance, refer to our detailed guide.

   • Ensure you select the option specifying whether your API returns the value of the action.

2. Test Your API:

   • Run tests to verify the API is functioning correctly. This is the crucial step that ensures everything else will work seamlessly.

3. Set Up Tasks:

   • In the task setup section, choose "verify task with your API" and select the API you just integrated.

   • Fill in all the required fields and check the "metric-based XP" option.

4. Choose XP Distribution Method:

   • You will be presented with three options for XP distribution: Linear, Sigmoid, and Tiered.

   • Select the method that best suits your needs and complete the task setup.

Linear Volume based XPs

Max XP: This is a cap on the total XP a user can earn. No matter how active a user is, they cannot earn more than this set amount of XP. This ensures that there's a limit to the rewards any user can accumulate within a given timeframe or activity set.

XP Multiplier: This multiplier is applied to the user's activity volume to calculate the XP they earn. The formula is simple:

Rewarded XP = Activity Volume * XP multiplier

For example, if the activity volume is 10 and the XP multiplier is 2, the user earns 20 XP.

Tiered Volume Based XPs

With the tiered option, you can create multiple tiers and set specific rewards for each tier. You can set as many tiers as you want.

Tier Min Metric: This is the minimum volume a user needs to have to be included in that tier.

Tier Max Metric: This is the maximum volume a user can have to be included in the tier.

Tier XP: This is the amount of XP the users in that tier earn for completing the task.

Sigmoid XPs

Set an optimal value for the volume, the Max XP a user can earn for the task, and a rate of increase.

• Optimal Value for the Volume: The target activity volume at which a user earns the maximum XP.

• Max XP: The maximum XP a user can earn for the task, capping the reward.

• Rate of Increase determines how quickly XP increases as volume approaches the optimal value. A higher rate means XP rises quickly near the optimal value; a lower rate means a gradual increase.

For transactions with lower volumes, users will earn proportionally less XP.

For higher volumes, users will earn more XP, but the increase will slow down and plateau at the maximum XP.