> For the complete documentation index, see [llms.txt](https://docs.fuyo.markets/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fuyo.markets/rewards/leaderboard/how-leaderboard-works.md).

# How leaderboard works?

#### The big picture

The Fuyo leaderboard is updated automatically every time a market settles. There is no separate daily ranking job — *your score changes the moment your trades are resolved*.

Here is the sequence:

1. A prediction market closes and is resolved.
2. Your trades on that market are marked as **Resolved** (or Void if unconfirmed).
3. Your trading stats are updated for both weekly and all-time.
4. Your daily XP is recalculated for the day those trades resolved.
5. Any new XP is minted to your wallet.
6. The leaderboard API reads the updated stats and returns the new rankings.

This means your rank can shift throughout the day as markets resolve — not just at midnight or end of week. 

{% hint style="info" %}
Fuyo leaderboard does not measure each accounts total P\&L performance. The calculation is based on each trade per market resolved. Therefore, the more users trade regularly, consistently, matters more than how skillful the trader is to increase the overall P\&L.
{% endhint %}

***

#### Weekly vs all-time: same formula, different window

Both leaderboard views use **exactly the same scoring formula**. The only difference is which of your trades are counted.

|                     | Weekly                                   | All-time                  |
| ------------------- | ---------------------------------------- | ------------------------- |
| **Trades counted**  | Resolved during the current UTC week     | All resolved trades, ever |
| **Week definition** | Monday 00:00 UTC → next Monday 00:00 UTC | —                         |
| **Formula**         | Identical                                | Identical                 |
| **XP gate**         | 100 XP minimum                           | 100 XP minimum            |

{% hint style="info" %}
The weekly leaderboard resets every Wednesday at 00:00 UTC. Your all-time leaderboard preserves your full history and never resets.
{% endhint %}

***

#### Which trades count?

Only **resolved** trades are used for leaderboard scoring.

| Trade status                     | Counts for leaderboard? | Counts for XP?           |
| -------------------------------- | ----------------------- | ------------------------ |
| Resolved (win or loss)           | ✅ Yes                   | ✅ Yes (if stake ≥ 1 USD) |
| Open (not yet settled)           | ❌ No                    | ❌ No                     |
| Void (unconfirmed at settlement) | ❌ No                    | ❌ No                     |
| Pending transaction              | ❌ No                    | ❌ No                     |

***

#### How streaks work

Your streak is measured in **consecutive active UTC days**.

A day counts as active if you have at least **1 USD of eligible resolved stake** on that day.

| Situation                                    | Effect on streak      |
| -------------------------------------------- | --------------------- |
| First ever trade                             | Streak starts at 1    |
| Trade on the same UTC day as your last trade | Streak stays the same |
| Trade on the very next UTC day               | Streak increases by 1 |
| Gap of 2 or more days                        | Streak resets to 1    |

Your streak feeds into your **Consistency Score**, which is 50% of your leaderboard score. Keeping your streak alive is one of the most impactful things you can do to improve your rank.

{% hint style="warning" %}
Streaks are tracked in UTC time. If you trade at 23:50 one night and then again at 00:10 the next night, that counts as two separate active days — good for your streak. But if you miss an entire UTC day, your streak resets.
{% endhint %}

***

#### How the minimum Fuyo XP gate works?

Before your score is even considered for the leaderboard, you must have at least **100 Fuyo XP**.

Your Fuyo XP balance shown on the leaderboard is the total XP that has been minted to your wallet by the Fuyo backend. It reflects all XP earned from resolved trades across your history.

**How you earn XP:**

* Place eligible resolved trades (minimum 1 USD stake per trade)
* Stay on the same side of a market — a hold bonus adds 10% extra XP
* Build a multi-day streak — a streak multiplier boosts your XP
* Hit 1 USD of eligible daily volume to earn a flat daily bonus

**What reduces XP earnings:**

* Placing more than 30 eligible trades in a single UTC day triggers diminishing returns (XP factor drops after trade number 30)
* Total XP is capped at 1,000 per UTC day regardless of activity level

{% hint style="success" %}
A realistic new user placing 5–10 trades per day across 2–3 trading sessions will generally cross 100 XP within their first few active days. *This is to prevent farming bots dominating leaderboard with 2-3 trades.*
{% endhint %}

***

#### How ties are broken

When two traders have the same score, the tiebreaker chain is applied in this order:

1. Higher profit percentage wins
2. If still tied — higher total stake wins
3. If still tied — more total resolved trades wins
4. If still tied — lower user ID wins (deterministic, always produces a unique result)

***

#### Who does not appear on the leaderboard

You will not appear on the leaderboard if any of the following apply:

* Your FUYO XP balance is below 100
* You have no resolved trades
* Your score calculates to zero (this happens when you don't meet the minimum volume or minimum trade thresholds)

This is intentional. The leaderboard is meant to surface active, consistent traders — not brand-new or single-session accounts.