Integra PRD: 24-trading-tournaments

24-trading-tournaments.md

Trading Tournaments

Owner: Kalki | Ship: Week 3 | Est: 0.5-1d | Chain: integra-testnet-1 (EVM 26218) URL: tournaments.integralayer.com

Overview

Weekly trading competitions where users pay an IRL entry fee, trade on GOB for a fixed period, and compete on portfolio performance. A public leaderboard ranks participants in real time. Winners split the prize pool. Think DraftKings meets DeFi — creating urgency, repeat engagement, and meaningful on-chain volume every week.

Features

• Tournament Listing — Browse active, upcoming, and completed tournaments with entry fee, participant count, prize pool, and countdown timer
• IRL Entry Fee — Pay to join, entry fees aggregate into the prize pool held by the contract
• 7-Day Default Duration — Standard weekly tournament window, configurable per tournament
• Max Participants Cap — Optional limit on participants per tournament to control pool size
• Live Leaderboard — Real-time ranking of participants by portfolio performance during the tournament
• Portfolio Snapshots — Starting and ending portfolio values captured for accurate performance scoring
• Prize Distribution — 1st: 50%, 2nd: 30%, 3rd: 15%, Protocol: 5%
• Prize Claiming — Winners claim their share directly from the contract after finalization
• Tournament Detail Page — Leaderboard, countdown timer, participant list, and portfolio performance chart per user
• Performance Tracking — Participant GOB trades tracked and scored during the tournament window
• Tournament History — Past results with winner profiles, final standings, and prize amounts
• Countdown Timer — Prominent display of time remaining in active tournaments

Functions

• createTournament — Admin creates a tournament with entry fee, duration, and max participants
• join — User pays entry fee and registers for the tournament
• submitResult — Snapshot portfolio value at tournament end
• finalize — Rank all participants by performance, allocate prize pool
• claimPrize — Winner withdraws their share from the contract
• getLeaderboard — Returns ranked participant list with performance data

User Flow

1. Connect via Web3Auth
2. Browse active and upcoming tournaments on the listing page
3. Join a tournament by paying the IRL entry fee
4. Trade on GOB during the tournament window (7 days default)
5. Check the live leaderboard to track ranking vs. other participants
6. Tournament ends — contract finalizes rankings by portfolio performance
7. Winners claim prizes from the contract

Deliverables

• TradingTournament smart contract deployed on integra-testnet-1
• Tournament creation flow (admin)
• Tournament listing page (active, upcoming, completed)
• Join flow with IRL entry fee payment
• Live leaderboard with real-time ranking updates
• Portfolio snapshot and performance scoring
• Prize distribution and claiming mechanism (50/30/15/5 split)
• Tournament detail page with countdown timer and participant charts
• Tournament history with past results and winners
• On-chain event emissions for all actions

Integration Points

• Depends on: GOB exchange contracts (trade/balance data for scoring), IRL token (entry fees and payouts), Web3Auth for authentication
• Used by: Ecosystem Hub (category: Trading), XP system for participation and wins
• Explorer: Integra Explorer

XP Rewards

Action	Points
Join a tournament	25 XP
Complete a tournament (active + submitted result)	50 XP
Finish in top 3	200 XP
Win a tournament (1st place)	500 XP

Success Metrics

Metric	Target
Tournaments completed	8+ (weekly cadence, 2 months)
Unique participants	200+ wallets
Average participants per tournament	25+
Total prize pool distributed	50K+ IRL
Repeat participation rate	40%+ return for next tournament
GOB volume during tournaments vs. off-tournament	2x+ lift