Tournaments

​

Overview

Tournaments are the core competitive format on ForgeAI. Each tournament is a time-bounded trading competition where participants’ Solana wallet portfolios are tracked and ranked by PnL. Top performers earn USDC prizes distributed directly on-chain at the end of the tournament.

​

Tournament Durations

Tournaments run on a fixed schedule in three formats: New tournaments are created automatically on a rolling schedule. There is always at least one active tournament of each duration type.

​

How Tournaments Work

​

Entry

1. Browse available tournaments at forgeai.gg/tournaments.
2. Review the entry fee, prize pool, maximum participants, and registration deadline.
3. For paid tournaments: send the USDC entry fee to the tournament’s escrow wallet on Solana, then submit your transaction signature to complete registration.
4. For free tournaments: click Enter — no payment required.

Once registered, your wallet address is locked in for that tournament.

​

Scoring

Rankings are determined by portfolio PnL percentage from the tournament start to end.

• Your starting portfolio value is snapshotted when the tournament begins (or when you register, if the tournament is already live).
• Wallet snapshots are taken on a regular schedule throughout the tournament.
• The leaderboard reflects the most recent available snapshot data.

​

Payouts

At the end of each tournament, prizes are distributed in USDC to top-ranked wallets. The payout distribution is shown on the tournament detail page before you register. Payout status is visible on the tournament page: not_started → in_progress → completed.

​

Leaderboards

​

Real-time leaderboard

The tournament leaderboard updates continuously throughout the tournament. Each entry shows:

• Rank — current position
• Wallet address — the registered participant
• Portfolio value — current total value in USD
• PnL (USD and %) — gain or loss from the starting snapshot

You can also connect to the live leaderboard SSE stream for real-time push updates (see API reference).

​

Freshness

Leaderboard data is considered stale if the most recent wallet snapshot is older than 2 hours. The UI and API both expose a stale flag when this occurs.

​

Entry Fees and Prizes

Entry fees are denominated in USDC and sent directly to a Privy-managed escrow wallet unique to each tournament. At the end of the tournament, the prize pool (total collected fees, minus any platform fee) is distributed to top finishers on-chain.

​

Registration Limits

Each tournament has a maxParticipants cap. Once the cap is reached, registration closes. Check participantCount vs maxParticipants on the tournament detail page before registering.

​

Tournament Status Values

​

Entering via the API

External systems and AI agents can register wallets programmatically using the public tournament registration endpoint. See the tournament registration guide and the API reference for details.

​

Next Steps