Base URL
Authentication
All requests require anx-api-key header:
V1 vs V2 Comparison
| Feature | V1 (Standard) | V2 (Enhanced) |
|---|---|---|
| Endpoints | ~15 | 89 |
| Fighter profiles | Basic | Full record, weight class, stats |
| Fight stats | Limited | Strikes, takedowns, submissions |
| Odds | Pre-match | Pre-fight + live in-fight |
| Promotions | Major only | UFC, Bellator, KSW, PFL, ONE, and 50+ more |
MMA-Specific Concepts
Fighters = Teams
In the V2 API, each fighter is represented as a “team” entity (similar to tennis players). Use/api/teams/:id for fighter profiles and fight history.
Fight Format
- Championship fights: 5 rounds × 5 minutes
- Regular fights: 3 rounds × 5 minutes
- Win methods: KO/TKO, Submission, Decision (Unanimous/Split/Majority), Draw, No Contest
Weight Classes
Flyweight, Bantamweight, Featherweight, Lightweight, Welterweight, Middleweight, Light Heavyweight, Heavyweight (and women’s divisions).Key Statistics
- Strikes landed / attempted (significant + total)
- Takedowns landed / attempted
- Submission attempts
- Control time
- Knockdowns
Key Test IDs
| Entity | Name | ID |
|---|---|---|
| Tournament | KSW | 19946 |
| Fighter (Team) | Adrian Bartosiński | 470979 |
| Fighter (Team) | Madars Fleminas | 461395 |
| Fight (Match) | Bartosiński vs Fleminas | 15522982 |
Endpoint Categories
| Category | Endpoints | Description |
|---|---|---|
| Live & Schedule | 14 | Live fights, schedules, search |
| Match / Fight | 23 | Fight details, stats, odds |
| Tournament / Promotion | 18 | Promotion info, seasons, rankings |
| Team / Fighter | 11 | Fighter profiles, fight history |
| Player / Fighter | 16 | Detailed fighter stats |
| Referee & Venue | 8 | Officials, arenas |
| Total | 89 |
Example Requests
UI Design Ideas
- Fight card layout: Show fights stacked as Main Card / Prelims / Early Prelims
- Fighter profile: Show record (W-L-D), weight class, reach, stance (Orthodox/Southpaw), country flag
- Fight result: Show method of victory (KO/TKO R2 3:45, Sub R1 2:22, Decision Unanimous)
- Fight stats: Visualize significant strikes (head/body/leg), takedown accuracy, control time
- Odds: MMA odds are moneyline only (no spread/point totals) — show as favorites vs underdogs