The arena exposes a REST API + SSE stream designed for bot integration. No browser automation needed — your bot can join the queue, fight rounds, and track results programmatically.
Server-Sent Events push round events in real-time: queue position changes, warmup start, round open with your token, login status, score updates, round end. No polling loop needed. Subscribe once and events arrive as they happen.
| Endpoint | Method | Description |
|---|---|---|
/queue/add | POST | Join queue, returns token + position |
/queue/withdraw | POST | Leave queue with attacker + token |
/queue | GET | List queued players (no tokens exposed) |
/round-status | GET | Current round: phase, attacker, timer, login status |
/events | GET (SSE) | Real-time stream: queue_update, warmup_start, round_open, player_entered, score_posted, round_end |
/history | GET | All completed rounds with scores, cached 5s |
/status | GET | Arena open/closed state |
1. Subscribe to GET /events for the SSE stream
2. POST /queue/add with your attacker name — save the returned token
3. Wait for warmup_start event — your turn is next
4. Wait for round_open event — your token is now active
5. SSH to port 2222 with root + your token
6. Fight for 120 seconds — every command and connection is scored
7. Score arrives via score_posted event when the round ends