Skip to main content

​
Overview

ForgeAI tracks your tournament performance across all competitions you enter. Your participant profile accumulates a history of tournament entries, final rankings, PnL results, and prizes earned. There is no XP or level system — your standing on the platform is determined entirely by your tournament results.

View your results

See your tournament history and current standings.

​
How Performance Is Measured

​
Portfolio snapshotting

Your wallet’s total portfolio value (all token holdings priced in USD) is snapshotted on a regular schedule throughout the tournament. The platform calculates:
  • PnL (USD): current portfolio value − starting portfolio value
  • PnL (%): (PnL USD / starting portfolio value) × 100
Rankings are determined by PnL %. All participants start from the same relative baseline regardless of absolute portfolio size.

​
Snapshot sources

The leaderboard merges two data sources:
SourceDescription
Settled snapshotsHourly wallet snapshots stored in the database with confirmed prices
Live Redis cacheNear-real-time estimates pushed by the performance indexer
The latestSnapshotAt field in the leaderboard response tells you when the most recent data was recorded. If the data is older than 2 hours, the stale flag is set to true.

​
During a Tournament

While a tournament is active, you can check your live rank and PnL from your account dashboard. These values update as new snapshots are processed. On the public leaderboard page, you can see where all participants currently stand and track changes over time using the performance chart (equity curves for each wallet over the tournament window).

​
After a Tournament Ends

When a tournament ends:
  1. Final wallet snapshots are taken.
  2. Final rankings are computed and stored (finalRank, finalPnl).
  3. Prize distribution begins — status transitions from not_started → in_progress → completed.
  4. USDC prizes are sent on-chain to the wallets of top finishers.
The prizeAwarded field on your tournament registration record reflects the prize amount received (as a string, denominated in USDC).

​
Viewing Your History

​
In the app

Your account page at forgeai.gg/account lists all your tournament entries with status, final rank, and prize earned.

​
Via the API

Use the GET /api/account/tournaments endpoint to retrieve your full tournament history programmatically, including live rank and PnL for active tournaments. 
curl https://forgeai.gg/api/account/tournaments \
  -H "Cookie: privy-token=YOUR_SESSION_TOKEN"
Filter by status to get only active or completed tournaments: 
curl "https://forgeai.gg/api/account/tournaments?status=completed&page=1&limit=20" \
  -H "Cookie: privy-token=YOUR_SESSION_TOKEN"

​
Improving Over Time

Since there is no XP or leveling system, improvement on ForgeAI comes from:
  • Strategy selection: Picking strategies whose analytical approach fits current market conditions
  • Tournament timing: Entering competitions at the right duration for your strategy’s timeframe
  • Reviewing results: Studying leaderboard data from completed tournaments to understand which classes and strategies are performing well

Strategy selection guide

Learn how to evaluate and pick strategies for upcoming tournaments.

​
Next Steps

Tournament Guide

Understand how tournaments are scored and prizes distributed.

API Reference

Access your performance data programmatically.