---
title: "Tournaments"
slug: "tournaments"
status: "new"
updated: 2026-09-16T15:04:24Z
published: 2026-09-16T15:04:24Z
canonical: "docs.xtremepush.com/tournaments"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tournaments

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.

> [!NOTE]
> 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_won` attribute.
- **+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](/docs/en/create-a-tournament). For a worked configuration, see [Example Tournament](/docs/en/example-tournament).

> [!TIP]
> 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.