Tournaments are time-bound competitions that rank users against each other and reward top performers at the end of a fixed period. For example:
A one-week tournament that ranks users by how many qualifying bets they place, awarding tokens to the top 10 finishers when it ends.
A weekend tournament that ranks users by how many quests they complete, with the top 3 winning a bonus reward pack.
No separate Tournaments tab
You configure a tournament from Ways to Earn > Leaderboards like you do for standard leaderboards. There is no separate to configure tournaments. The main difference when configuring a tournament is:
You make opt-in participation mandatory
You set distribute rewards to occur only once, when the tournament ends.
Tournaments use the same scoring methods as leaderboards to calculate a user's score:
User Attribute value: Users are ranked by the value of a user attribute, for example a
total_tokens_wonattribute.+1 with every event: Users are ranked by how many times they trigger a chosen event. Each qualifying occurrence adds 1 to their score.
Accumulative (by event field): Users are ranked by the sum of a numeric field from an event, for example the total amount staked across all qualifying bets.
Custom Expression: Users are ranked by a mathjs formula you write yourself. The formula runs each time the desired a specified event occurs, and combines the user's existing score with details from that event to calculate the new score.
To learn how to configure these settings, see Create a Tournament. For a worked configuration, see Example Tournament.
When to use Tournaments instead of Leaderboards
A standard leaderboard can run indefinitely and, in most cases, is open to all eligible users automatically. A tournament is designed around a fixed lifecycle.
Consider a tournament rather than a standard leaderboard when you want:
A clearly bounded competition with a defined start and end, rather than an always-on ranking.
Users to explicitly opt in before they compete, for example for compliance or to build anticipation around a launch.