LoL match stats API
Game stats, player rows, gold, CS, and objectives from one LoL match endpoint.
Pull the stats behind a finished game: champions, KDA, gold, CS, team objectives, and player rows for recaps or fantasy scoring.
API response preview
Game stats for recaps, tables, and fantasy scoring
Useful endpoints
/api/v1/lol/games/{gameId}/statsPlayer and team stat rows
/api/v1/lol/matches/{matchId}/gamesGames in a match
/api/v1/lol/teams/{slug}/objectivesObjective control rates
Run the request
X-API-Keycurl "https://api.citoapi.com/api/v1/lol/games/{gameId}/stats" \
-H "X-API-Key: $CITO_API_KEY"{
"gameId": "game_1",
"duration": 1924,
"teams": [
{ "slug": "gen", "kills": 18, "dragons": 3, "barons": 1 },
{ "slug": "t1", "kills": 12, "dragons": 1, "barons": 0 }
],
"players": [
{ "name": "Chovy", "champion": "Azir", "kills": 7, "deaths": 1, "assists": 8 }
]
}Primary endpoint: /api/v1/lol/games/{gameId}/stats
Pull the stats behind a finished game: champions, KDA, gold, CS, team objectives, and player rows for recaps or fantasy scoring.
Endpoint chain
Start with /api/v1/lol/games/{gameId}/stats, then add the supporting rows your screen needs.
The first request should answer the user's main question. Add live state, roster rows, match stats, transfer history, or earnings only when the UI needs that detail.
/api/v1/lol/games/{gameId}/statsGame stats for recaps, tables, and fantasy scoring.
Player and team stat rows
/api/v1/lol/games/{gameId}/statsUse this first when the page needs game stats for recaps, tables, and fantasy scoring.
Games in a match
/api/v1/lol/matches/{matchId}/gamesGames in a match fills in the detail around the primary response.
Objective control rates
/api/v1/lol/teams/{slug}/objectivesObjective control rates fills in the detail around the primary response.
Returned data
Pull the stats behind a finished game: champions, KDA, gold, CS, team objectives, and player rows for recaps or fantasy scoring.
Best first request
Call /api/v1/lol/games/{gameId}/stats from your backend and cache the response based on how often that screen changes.
Common fallback
If live data is empty, show today's schedule, upcoming matches, recent results, or the last known team/player rows.
API key handling
Keep the API key on your server. Send your frontend only the fields it needs to render the page.
Data fit
Use this API for pro matches, teams, players, rosters, stats, and esports history.
If you need Riot ID, PUUID, ranked ladder, champion mastery, or account-linked match history, use Riot's APIs. If you need a pro esports app, use Cito's LoL endpoints.
Pro Esports API
Built for match centers, fantasy products, scouting tools, wikis, dashboards, team pages, player pages, and live bots.
Ranked and Ladder Workflows
Use Riot APIs for direct Riot ID, PUUID, summoner, match history, ranked ladder, champion mastery, and account-linked workflows. Cito only references public pro-player account context where source data allows it.
Resources
Docs, examples, and machine-readable endpoint files.
Open the docs when you want examples. Import Postman when you want to test. Use the endpoint manifest when an AI coding tool needs exact paths.
| Feature | Cito API | Riot API | PandaScore |
|---|---|---|---|
| Price | Free testing, Starter $25/mo, Builder $50/mo | Free, rate limited; production approval varies | Usually sales/custom pricing |
| Ranked account data | Not the primary product; use Riot for direct account workflows | Yes | Not the core LoL ranked source |
| Pro esports live | Yes | Fragmented across official surfaces | Yes |
| Player earnings | Yes | No | Provider-dependent |
| Org/transfer history | Yes | Current GCD affiliation/contract data, not full history | Provider-dependent |
| Unified REST API | Yes | Multiple products and routing models | Yes |
| Instant signup | Yes | Developer key yes; production can require approval | Often sales-led |
Riot's API is free but fragmented. PandaScore is enterprise-only. Cito is the only self-serve option with earnings and org history.
Endpoints
Endpoint paths for this workflow.
Start with /api/v1/lol/games/{gameId}/stats. Add supporting endpoints only when your page needs more context.
/api/v1/lol/players/{playerId}/earningsCareer prize pool earnings with tournament-by-tournament rows.
/api/v1/lol/players/{playerId}/earnings/summaryPlayer earnings totals, event counts, placements, and tracked history.
/api/v1/lol/players/{playerId}/teamsTeam history for org changes, roles, and date ranges.
/api/v1/lol/teams/{slug}/roster/historyHistorical rosters with roster membership periods.
/api/v1/lol/transfersRecent transfer activity across tracked LoL teams and players.
/api/v1/lol/teams/{slug}/earningsOrganization-level earnings and tournament results where tracked.
/api/v1/lol/liveActive League of Legends esports matches and live state.
/api/v1/lol/schedule/todayToday's LoL esports schedule for match-day apps.
/api/v1/lol/games/{gameId}/statsGame-level player stats after source publication.
/api/v1/lol/webhooks/eventsSupported LoL webhook events for paid plans.
Use cases
Built for League of Legends apps developers actually launch.
Match recaps
Turn a completed game into a readable summary with score, champions, KDA, gold, CS, and objective context.
Fantasy scoring
Calculate fantasy points from player stat rows instead of parsing match pages by hand.
Gold graphs
Draw momentum charts from game data when gold snapshots are available.
Player stat tables
Show KDA, champion, CS, gold, damage, and role context in a familiar table layout.
Post-game cards
Generate shareable cards for MVPs, team wins, standout players, and final scorelines.
Analytics dashboards
Group match stats by player, team, league, patch, or tournament for deeper analysis.
Separate match stats from player profiles
Match stats belong on product surfaces like recaps, live centers, fantasy scoring, and timeline views. Player profile stats can consume the same underlying rows later.
Build around one game at a time
Start from a match or schedule row, resolve the game ID, then fetch game stats for player KDA, champion context, gold, CS, objectives, and team-level summaries where source data is available.
Pricing
Start free. Upgrade when your LoL product needs room to grow.
Free testing includes 500 requests/month. Starter handles early products at $25/month. Builder is the $50/month tier for earnings, org history, transfers, webhooks, and higher-volume LoL apps.