Guild & Guild Tournament Flow
This guide explains how guilds and guild tournaments work on the Intraverse platform.
Guild Creation
Guilds are created by platform admins. If you want to create a guild, contact the Intraverse team. Once your guild is set up, you'll be assigned as the guild owner with the added permission of guilds.owner.
Guild Tournament Lifecycle
1. Request a Tournament (Guild Owner)
As a guild owner, you can request a tournament for your guild by creating a tournament via the API:
POST /api/v2/guild-tournaments
The tournament is created in pending status and submitted for review. You must provide all required details: guild ID, name, game, dates, prize configuration, and more.
See Create Guild Tournament for the full API reference.
2. Admin Review
Guild tournaments are reviewed by platform admins. Admins will either:
- Accept the tournament → status becomes
accepted - Reject the tournament → status becomes
rejected
You can check the status of your tournament via Get Guild Tournament or List My Guild Tournaments.
3. Launch (Guild Owner)
Once the tournament is accepted, the guild owner can launch it:
POST /api/v2/guild-tournaments/:id/launch
Launching creates the actual tournament and transitions the guild tournament to launched status. The tournament is now live and players can participate.
See Launch Guild Tournament for details.
Status Summary
| Status | Description |
|---|---|
pending | Awaiting admin review |
accepted | Approved by admin; owner can now launch |
rejected | Declined by admin |
launched | Tournament is live and running |
What is Treasury?
The treasury is the wallet associated with a guild tournament that holds funds for prize distribution. Each tournament has a dedicated treasury that you can inspect via:
GET /api/v2/guild-tournaments/:id/treasury
Automatic vs Manual Prize Distribution
When creating a tournament, you choose prizeDistributionType:
automatic— Prizes are distributed automatically by the platform based on final rankings.manual— You distribute prizes yourself outside the platform.
Treasury and Launch Requirements
If prize distribution is automatic, you must fund the tournament treasury before launching.
- The treasury must have enough funds to cover the total prize amount (
totalPrize). - If the balance is insufficient, the owner cannot launch the tournament.
- Use the Get Guild Tournament Treasury endpoint to verify the treasury balance before attempting to launch.
If prize distribution is manual, you handle payouts yourself. The platform does not require a funded treasury to launch, but you're responsible for rewarding winners according to your tournament rules.
Quick Reference
- Guilds → Created by admins
- Guild owner → Requests a tournament (status:
pending) - Admins → Review and accept or reject
- If accepted → Owner can launch (must meet treasury requirements for automatic prizes)
- If launched → Tournament is live