API preview

Documentation preview for the v1 football data API.

The public API is not open yet. This preview shows the intended direction for v1 so early users can evaluate fit before launch.

Overview

StatArena API will use versioned REST paths under https://live.statarena-api.com/v1. Responses will be JSON and authenticated with API keys issued through the account portal after launch.

The first public release will prioritize stable contracts over broad experimental endpoints.

Authentication

Requests will include an API key using the X-API-Key header. Keys will be scoped by plan, rate limits, and account status.

curl "https://live.statarena-api.com/v1/matches/live" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Accept: application/json"

Planned endpoint groups

Live matches

GET /v1/matches/live

Fixtures

GET /v1/fixtures

Teams and players

GET /v1/teams and GET /v1/players

Standings

GET /v1/competitions/{id}/standings

Example response shape

{
  "data": [
    {
      "id": "match_123",
      "competition": "Premier League",
      "homeTeam": "Liverpool",
      "awayTeam": "Manchester City",
      "status": "live",
      "minute": 67,
      "score": { "home": 1, "away": 1 }
    }
  ]
}