> For the complete documentation index, see [llms.txt](https://docs.fansports.fun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fansports.fun/getting-started/tournaments.md).

# Tournaments

Tournaments are **real-time competitive events** where users participate in short-term competitions based on live football matches.

Players earn **FanPoints (FP)** by predicting match outcomes and player performance. FP is used to rank users on the tournament leaderboard and determine rewards once the tournament ends.

Tournaments follow a **Seasonal and Event-based model**, allowing flexible deployment across:

* Major international tournaments (World Cup, Euro, Copa America)
* Club competitions (Champions League, domestic leagues)
* Special football events

### Core Game Loop

<figure><img src="/files/PYqNenhw9LAxMDwdcZYW" alt=""><figcaption></figcaption></figure>

The Tournament system follows a continuous core gameplay loop:

1. **Squad Building**\
   Users analyze data and make predictions to build their lineup.\
   Only player cards with **Active status** can be selected for tournament lineups.
2. **Live Match Execution**\
   When a tournament starts, real-world football matches are played.\
   Match data and player statistics are updated after each match concludes.
3. **Player Scoring**\
   Each player receives a **Player Score** based on final match statistics.\
   Player Scores are used to rank players and determine leaderboard positions.
4. **Tournament Settlement**\
   At the end of the tournament, the system finalizes rankings and distributes **FP rewards** to users.
5. **Reinvestment Loop**\
   Users can use FP to purchase player packs, receive player shares, and:
   * Trade shares on the marketplace, or
   * Use them to build new lineups for future tournaments.

### Tournament Information & Match Data

The Tournament page displays:

* **Past, ongoing, and upcoming tournaments**
* A full list of matches included in each tournament

For each match, users can view:

* Detailed match information
* Player performance statistics
* Points gained or deducted after match completion

To improve usability, players can:

* Search by player name
* Use filters to quickly locate specific players or matches


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.fansports.fun/getting-started/tournaments.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.