Get Started with Aeion Sports
Set up your first sports organization in 5 steps. HMAC ticket gates, AI injury risk, holographic playcalls, dynamic yield pricing, and performance tracking—all in under 20 minutes.
Configure Your League
Go to Sports → League → Settings.
League Configuration:
typescript
{
name: "Metro United Soccer League",
sport: "soccer",
season: "2026 Spring",
seasonStartDate: "2026-03-01",
seasonEndDate: "2026-06-30",
divisions: ["Premier", "Division 1", "Division 2"],
format: "round-robin",
pointsSystem: {
win: 3,
draw: 1,
loss: 0
}
}
Standing Configuration:
typescript
{
tiebreaker: ["head-to-head", "goal-difference", "goals-for"],
promotionRelegation: true,
maxTeamsPerDivision: 12
}
Add Teams:
- Go to Sports → Teams → Add Team
- Set team name, home venue, colors, logo
- Assign to division
- Add roster (athletes)
Add Athletes:
- Go to Sports → Athletes → Add Athlete
- Set name, position, jersey number
- Assign to team
- Add medical history for injury risk analysis
Set Up Facility & Scheduling
Go to Sports → Facilities.
Facility Configuration:
typescript
{
name: "Metro United Stadium",
type: "stadium",
capacity: 50000,
surfaceType: "grass",
address: "123 Sports Ave",
fields: [
{ name: "Main Field", type: "full-size" },
{ name: "Training Field 1", type: "full-size" },
{ name: "Training Field 2", type: "half-size" }
]
}
Create Scheduled Events:
- Go to Sports → Events → Schedule
- Set event type: game, practice, tournament, training
- Select facility/field
- Set date, time, duration
- Assign teams (for games)
- Set ticket capacity (for games)
Season Schedule:
- Go to Sports → League → Generate Schedule
- System auto-generates fixtures based on format
- Review and adjust
- Publish to teams and fans
Enable Gate Management
Go to Sports → Gate Management.
Ticket Signing:
Set your ticket-signing secret under Sports → Gate Management → Security before issuing tickets. Aeion Sports uses this to HMAC-sign every QR payload so gate scanners can detect tampering or counterfeit tickets.
Ticket Template:
typescript
{
ticketTypes: [
{ name: "General Admission", price: 25, color: "white" },
{ name: "Premium", price: 75, color: "gold" },
{ name: "VIP", price: 150, color: "black" },
{ name: "Season Ticket", price: 800, color: "blue" }
],
gateConfig: {
gates: ["Gate A", "Gate B", "Gate C", "VIP Gate"],
modbusEnabled: true,
turnstileCoilAddress: 1
}
}
Issue Tickets (API):
bash
POST /sports/tickets
{
"eventId": "event-uuid",
"holderName": "Jane Smith",
"holderEmail": "jane@example.com",
"seatSection": "Section A",
"seatRow": "12",
"seatNumber": "45",
"ticketType": "Premium",
"price": 75
}
Response:
typescript
{
"id": "ticket-uuid",
"ticketNumber": "TKT-2026-000001",
"qrPayload": "TKT-2026-000001:event-uuid.eyJzZWNyZXQiOiIuLi4ifQ=="
// QR contains: ticketNumber:eventId.hmacSignature
}
Gate Scan:
bash
POST /sports/gates/scan
{
"qrPayload": "TKT-2026-000001:event-uuid.eyJzZWNyZXQiOiIuLi4ifQ==",
"gate": "Gate A",
"operatorId": "operator-uuid"
}
Smart Gate Setup (via Bridge):
- Connect Bridge to stadium network
- Enable Modbus/GPIO on Bridge
- Wire turnstile coil to Bridge GPIO pins
- Test unlock via Bridge hardware API
Enable Yield Management
| Multiplier | Label | Use Case |
|---|---|---|
| 0.5–0.7 | Low demand | Off-season, bottom-tier |
| 0.8–1.0 | Normal | Regular season |
| 1.1–1.5 | Elevated | Playoff implications |
| 1.6–2.0 | High | Rivalry games |
| 2.1–2.5 | Premium | Championship |
Track Performance & AI Insights
Record Training Session:
bash
POST /sports/performance
{
"athleteId": "athlete-uuid",
"date": "2026-05-11",
"rpe": 7,
"duration": 60,
"heartRateAvg": 155,
"heartRateMax": 182,
"sprintCount": 12,
"wellnessScore": 7,
"notes": "Good session, slight hamstring tightness"
}
Response:
typescript
{
"id": "metric-uuid",
"loadScore": 420 // RPE × duration = 7 × 60
}
Get Athlete Trend:
bash
GET /sports/performance/athletes/{athleteId}/trend?weeks=8
Response:
typescript
{
"athleteId": "athlete-uuid",
"weeks": 8,
"trends": [
{ "weekStarting": "2026-03-16", "avgLoadScore": 380, "avgWellnessScore": 7.2, "avgRpe": 6.3, "sessionCount": 5 },
{ "weekStarting": "2026-03-23", "avgLoadScore": 420, "avgWellnessScore": 6.8, "avgRpe": 7.0, "sessionCount": 5 },
// ... more weeks
],
"flaggedWeeks": ["2026-04-20"] // Overtraining detected
}
Generate Injury Risk:
bash
POST /sports/athletes/{athleteId}/injury-risk
{ "athleteId": "athlete-uuid" }
Response:
typescript
{
"score": 72,
"riskLevel": "high",
"indicators": ["Increasing load over 3 weeks", "Low wellness score"],
"recommendation": "Consider reducing training load by 20%. Monitor for fatigue symptoms."
}
Generate Holographic Playcall (WebXR):
bash
POST /sports/ai/holographic-playcall
{
"opponentTeamId": "team-uuid",
"gameSituation": {
"down": 3,
"distance": 7,
"fieldPosition": 45
}
}
Response:
typescript
{
"status": "processing",
"renderJobId": "spatial-abc-123",
"renderTarget": "bridge_gpu", // or "cloud_farm"
"gpuDetected": true
}
Smart Gate Configuration:
- Go to Sports → Gate Management → Smart Gate
- Enable Modbus/GPIO
- Set coil address for turnstile
- Test unlock command
- Configure DOOH trigger on entry
Quick Reference
Ticket API:
```bash # Issue ticket POST /sports/tickets { "eventId": "uuid", "holderName": "...", "ticketType": "Premium" }
# Scan ticket POST /sports/gates/scan { "qrPayload": "...", "gate": "Gate A", "operatorId": "uuid" }
# Get ticket status GET /sports/tickets/{ticketId}
# Transfer ticket POST /sports/tickets/{ticketId}/transfer { "newHolderEmail": "..." } ```
Event API:
```bash # Create event POST /sports/events { "name": "vs City Rivals", "date": "2026-05-20", "venueId": "uuid" }
# Get yield GET /sports/events/{eventId}/yield
# Update yield POST /sports/events/{eventId}/evaluate-yield ```
Performance API:
```bash # Record session POST /sports/performance { "athleteId": "uuid", "rpe": 7, "duration": 60 }
# Get trend GET /sports/performance/athletes/{id}/trend?weeks=8
# Get athlete overview GET /sports/performance/athletes/{id}/overview ```
AI Insights API:
```bash # Injury risk POST /sports/athletes/{athleteId}/injury-risk { "athleteId": "uuid" }
# Holographic playcall POST /sports/ai/holographic-playcall { "opponentTeamId": "uuid", "gameSituation": {...} }
# Tactical summary POST /sports/ai/tactical-summary { "teamId": "uuid" }
# Scouting report POST /sports/ai/scouting-summary { "opponentTeamId": "uuid" } ```
Standings API:
```bash # Get standings GET /sports/standings?season=2026-spring&division=premier
# Update game result POST /sports/games/{gameId}/result { "homeScore": 2, "awayScore": 1 } ```
FAQ
Tickets are signed with HMAC-SHA256. QR payload = `{ticketNumber}:{eventId}.{signature}`. Gate scan recomputes signature and validates match. Tampered or counterfeit tickets fail signature check and are rejected.
Aeion Bridge connects to turnstile hardware via Modbus/GPIO. On valid ticket scan, Bridge writes to coil address to unlock turnstile. DOOH screen personalization triggered simultaneously for targeted messaging.
The AI analyzes performance metrics (RPE, duration, heart rate) and medical history. Returns a score 0-100 and a risk level (low/moderate/high), and notifies your medical team automatically when an athlete crosses into elevated risk.
Aeion detects available edge GPU hardware (Bridge, 16GB+ VRAM). If available, it routes rendering to the edge for the lowest latency; otherwise it renders in the cloud. Output: 3D volumetric point cloud for Apple Vision Pro.
The AI analyzes team standings (position, points), venue capacity, and historical data to compute a multiplier (0.5-2.5). Top-5 matchups → higher multiplier. Rivalry games → premium pricing.
Load Score = RPE × Duration (minutes). Higher values indicate more fatigue. Week-over-week trends tracked for overtraining detection. Wellness scores supplement for holistic view.
Yes. Record sessions per athlete and pull weekly aggregates for any athlete. Compare athletes, flag overtraining across the team, and get AI-generated team-level tactical summaries for coaches.
Points-based ranking: Win = 3, Draw = 1, Loss = 0. Position updates automatically on game result submission. Tiebreakers: head-to-head, goal difference, goals for. Season-filtered queries.
Yes. Ticket transfer endpoint changes holder in database. Generates new QR payload with new holder info. Old ticket invalidated. Email notification to both parties.
Aeion automatically detects available VRAM on your Bridge hardware. 16GB or more routes rendering to the edge for the lowest latency; below that, rendering falls back to the cloud. Either way you get holographic rendering for sideline coaching — the edge path is just faster.
Fans earn points for attendance, purchases, engagement. Points redeemable for rewards catalog. Tier levels (bronze/silver/gold/platinum). Event emissions for analytics. Integration with ticketing for auto-enrollment.