Tournament API
The Tournament API provides endpoints for querying tournaments, calculating NFT-based scores, and accessing tournament-related data in the Intraverse platform.
Overview
The Tournament API enables you to:
- Query Tournaments: Retrieve tournament information by game with cursor-based pagination
- Calculate Scores: Calculate tournament scores based on raw game points and NFT holdings
- Access Tournament Data: Get associated projects and NFT drops for tournaments
- NFT Integration: Leverage owned NFTs to apply scoring multipliers
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v2/tournament/game/:gameSlug | Get tournaments for a specific game with pagination |
| POST | /api/v2/tournament/:id/calculateScore | Calculate score based on game points and NFT holdings |
| GET | /api/v2/tournament/:id/projects/ | Get projects associated with a tournament |
| GET | /api/v2/tournament/:id/drops/ | Get NFT drops associated with a tournament |
Authentication
All tournament endpoints are public and do not require authentication.
Tournament Structure
A tournament in the Intraverse platform consists of:
- Basic Information: ID, name, organization, and visual elements (color, image)
- Game Association: Linked to a specific game via gameId
- Timeline: Start and end dates (Unix timestamps)
- Projects: Associated blockchain projects and NFT collections
- Airdrops: Linked NFT drops for rewards and multipliers
- Rounds: Tournament phases with intervals and reward structures
- Scoring: NFT-based multiplier system for final scores
Tournament Status
| Status | Description |
|---|---|
RUNNING | Tournament is currently active |
UPCOMING | Tournament is scheduled but not started |
FINISHED | Tournament has completed |
NFT-Based Scoring
The tournament scoring system leverages NFT ownership:
- Raw Game Points: Base score from gameplay performance
- NFT Multipliers: Owned NFTs contribute to score multipliers
- Rarity System: Different NFT rarities provide different multiplier values
- Final Score: Calculated as
rawGamePoint × multiplier
Pagination
Tournament queries use cursor-based pagination:
- Size: Number of items per page (1-30)
- Cursor Navigation: Use
keyanddirectionfor pagination - Ordering: Sort by supported fields like
startDate
Error Codes
| Code | Description |
|---|---|
| 400 | Bad Request - Invalid parameters |
| 404 | Not Found - Resource not found |