Grid Ledger

Data

Matches

List and fetch fixtures, live games, and results. Match objects include teams, league, tournament, series score, and nested maps (with optional player stats).

Endpoints

MethodPathNotes
GET/matchesFlexible list + filters
GET/matches/:idSingle match
GET/fixturesUpcoming / started / live (cached)
GET/resultsFinished (cached)

Useful query params

  • game — cs2, lol, valorant
  • status — upcoming, started, live, finished, …
  • team — id, name, or short name (partial if 3+ chars)
  • league / tournament — id or exact name
  • date — UTC day YYYY-MM-DD
  • limit — 1–100 (default 50)

Example

GET /v1/matches?game=cs2&status=finished&team=NAVI&limit=20

Payload sketch

{
  "data": [{
    "id": "…",
    "game": "cs2",
    "status": "finished",
    "scoreTeam1": 2,
    "scoreTeam2": 0,
    "team1": { "id": "…", "name": "WW", "logoUrl": "…" },
    "team2": { "id": "…", "name": "Phantom Academy" },
    "maps": [{
      "mapNumber": 1,
      "mapName": "Dust II",
      "scoreTeam1": 13,
      "scoreTeam2": 6,
      "playerStats": [
        { "nickname": "tried", "kills": 20, "deaths": 5, "adr": 103.8, "rating": 1.87 }
      ]
    }]
  }]
}

Depth varies by game — see Games & depth. Try live calls in the API reference.

Grid Ledger — Sports & Esports Data