League of Legends API
Player earnings, org history, transfers, live matches, and esports data
https://api.citoapi.com/api/v1LoL live webhooks are available on One Game Starter and higher paid plans
Subscribe to live state, gold swing, objective, kill, tower, match started, score updated, and match completed events from the dashboard webhook page. CitoAPI does not expose a public WSS stream right now; webhooks are the push path, and REST endpoints return the latest payload.
GET /api/v1/lol/webhooks/eventsUpgrade for webhooksLoL Webhook Events
Push events available for live match and score automation.
lol.match.startedlol.live.game_startedlol.live.statelol.live.gold_swinglol.live.objectivelol.live.kill_updatelol.live.tower_destroyedlol.score.updatedlol.match.completedPlayers
Player stats, form, champion pools, earnings, and team history.
GET/api/v1/lol/players/{playerId}/earningsPlayer earningsPlayer prize pool earnings with tournament rows
/api/v1/lol/players/{playerId}/earningscurl "https://api.citoapi.com/api/v1/lol/players/{playerId}/earnings" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/players/{playerId}/earnings/summaryPlayer Earnings SummaryPlayer earnings totals, placement counts, and sync metadata
/api/v1/lol/players/{playerId}/earnings/summarycurl "https://api.citoapi.com/api/v1/lol/players/{playerId}/earnings/summary" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/players/{playerId}/teamsPlayer teamsPlayer org history and team timeline
/api/v1/lol/players/{playerId}/teamscurl "https://api.citoapi.com/api/v1/lol/players/{playerId}/teams" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/players/{playerId}/statsPlayer statsPlayer statistics and recent performance rows
/api/v1/lol/players/{playerId}/statscurl "https://api.citoapi.com/api/v1/lol/players/{playerId}/stats" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/players/{playerId}/formPlayer formSliding-window player form for last 10, 20, and 50 matches with optional league and role filters
/api/v1/lol/players/{playerId}/formcurl "https://api.citoapi.com/api/v1/lol/players/{playerId}/form" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/players/{playerId}/champion-poolPlayer Champion PoolRecent champion picks, pick rates, and decided-game win rates over the player's last N matches
/api/v1/lol/players/{playerId}/champion-poolcurl "https://api.citoapi.com/api/v1/lol/players/{playerId}/champion-pool" \
-H "x-api-key: YOUR_CITO_API_KEY"Teams & Rosters
Professional teams, objectives, roster history, and team timelines.
GET/api/v1/lol/players/{playerId}/teamsPlayer teamsPlayer org history and team timeline
/api/v1/lol/players/{playerId}/teamscurl "https://api.citoapi.com/api/v1/lol/players/{playerId}/teams" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/teams/{slug}/roster/historyTeam Roster HistoryHistorical team rosters and date ranges
/api/v1/lol/teams/{slug}/roster/historycurl "https://api.citoapi.com/api/v1/lol/teams/{slug}/roster/history" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/teamsList TeamsProfessional LoL teams
/api/v1/lol/teamscurl "https://api.citoapi.com/api/v1/lol/teams" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/teams/{slug}/objectivesTeam ObjectivesTeam objective control rates over recent matches with optional league filter
/api/v1/lol/teams/{slug}/objectivescurl "https://api.citoapi.com/api/v1/lol/teams/{slug}/objectives" \
-H "x-api-key: YOUR_CITO_API_KEY"Transfers
Recent movement and player/team transfer history.
GET/api/v1/lol/transfersRecent TransfersRecent player transfers with filters
/api/v1/lol/transferscurl "https://api.citoapi.com/api/v1/lol/transfers" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/transfers/player/{playerId}Player TransfersTransfer history for one player
/api/v1/lol/transfers/player/{playerId}curl "https://api.citoapi.com/api/v1/lol/transfers/player/{playerId}" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/transfers/team/{slug}Team TransfersTransfer activity for one team
/api/v1/lol/transfers/team/{slug}curl "https://api.citoapi.com/api/v1/lol/transfers/team/{slug}" \
-H "x-api-key: YOUR_CITO_API_KEY"Live Matches
Active matches, live series state, visual state, and live aliases.
GET/api/v1/lol/liveLive MatchesCurrently active LoL esports matches and live match IDs
/api/v1/lol/livecurl "https://api.citoapi.com/api/v1/lol/live" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/matches/liveLive MatchesAlias for currently active pro matches
/api/v1/lol/matches/livecurl "https://api.citoapi.com/api/v1/lol/matches/live" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/live/{matchId}/seriesLive SeriesLive series state with completed games, score, and current game context
/api/v1/lol/live/{matchId}/seriescurl "https://api.citoapi.com/api/v1/lol/live/{matchId}/series" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/live/{gameId}/visual-stateLive Visual StateAccepted near-live visual reads for game time, gold, kills, towers, dragons, and barons
/api/v1/lol/live/{gameId}/visual-statecurl "https://api.citoapi.com/api/v1/lol/live/{gameId}/visual-state" \
-H "x-api-key: YOUR_CITO_API_KEY"Matches & Games
Match detail, games, player stats, postgame data, vision, plates, and jungle share.
GET/api/v1/lol/matches/liveLive MatchesAlias for currently active pro matches
/api/v1/lol/matches/livecurl "https://api.citoapi.com/api/v1/lol/matches/live" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/matches/{id}Match DetailMatch detail by stored match ID or raw LoL esports match ID
/api/v1/lol/matches/{id}curl "https://api.citoapi.com/api/v1/lol/matches/{id}" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/matches/{id}/gamesMatch GamesGames inside a match, including raw game IDs where available
/api/v1/lol/matches/{id}/gamescurl "https://api.citoapi.com/api/v1/lol/matches/{id}/games" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/games/{gameId}games gameIdGame details by stored ID or raw LoL esports game ID
/api/v1/lol/games/{gameId}curl "https://api.citoapi.com/api/v1/lol/games/{gameId}" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/games/{gameId}/statsGame statsStored per-player stats for a specific game
/api/v1/lol/games/{gameId}/statscurl "https://api.citoapi.com/api/v1/lol/games/{gameId}/stats" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/games/{gameId}/player-statsGame Player StatsAlias for game-level player stat rows
/api/v1/lol/games/{gameId}/player-statscurl "https://api.citoapi.com/api/v1/lol/games/{gameId}/player-stats" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/games/{gameId}/postgameGame postgameCompleted-game gold graph, timeline, plates, role distributions, vision, and jungle share
/api/v1/lol/games/{gameId}/postgamecurl "https://api.citoapi.com/api/v1/lol/games/{gameId}/postgame" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/games/{gameId}/platesGame platesVoidgrubs, tower plates, and lane plate counts for one game
/api/v1/lol/games/{gameId}/platescurl "https://api.citoapi.com/api/v1/lol/games/{gameId}/plates" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/games/{gameId}/distributionsGame distributionsGold and damage distribution by role for one game
/api/v1/lol/games/{gameId}/distributionscurl "https://api.citoapi.com/api/v1/lol/games/{gameId}/distributions" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/games/{gameId}/visionGame visionTeam vision totals for one game
/api/v1/lol/games/{gameId}/visioncurl "https://api.citoapi.com/api/v1/lol/games/{gameId}/vision" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/games/{gameId}/jungle-shareGame jungle shareJungle CS share data by role for one game
/api/v1/lol/games/{gameId}/jungle-sharecurl "https://api.citoapi.com/api/v1/lol/games/{gameId}/jungle-share" \
-H "x-api-key: YOUR_CITO_API_KEY"Schedule & Standings
Today, upcoming schedule, and published league standings.
GET/api/v1/lol/schedule/todayToday ScheduleToday’s match schedule for LoL esports apps
/api/v1/lol/schedule/todaycurl "https://api.citoapi.com/api/v1/lol/schedule/today" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/schedule/upcomingUpcoming ScheduleUpcoming LoL esports schedule
/api/v1/lol/schedule/upcomingcurl "https://api.citoapi.com/api/v1/lol/schedule/upcoming" \
-H "x-api-key: YOUR_CITO_API_KEY"GET/api/v1/lol/leagues/{leagueId}/standingsLeague StandingsLeague standings, returning an empty rankings array when standings are not published yet
/api/v1/lol/leagues/{leagueId}/standingscurl "https://api.citoapi.com/api/v1/lol/leagues/{leagueId}/standings" \
-H "x-api-key: YOUR_CITO_API_KEY"Webhooks
Supported webhook event names for production push workflows.
GET/api/v1/lol/webhooks/eventsWebhook EventsSupported LoL webhook events for paid plans
/api/v1/lol/webhooks/eventscurl "https://api.citoapi.com/api/v1/lol/webhooks/events" \
-H "x-api-key: YOUR_CITO_API_KEY"Player Earnings
[
{
"tournamentName": "LCK 2026 Season Opening",
"tournamentDate": "2026-01-09T00:00:00.000Z",
"placement": 1,
"earnings": 0,
"league": "LCK",
"orgSlugAtTime": "east-3"
},
{
"tournamentName": "2025 World Championship",
"tournamentDate": "2025-11-09T00:00:00.000Z",
"placement": 1,
"earnings": 200000,
"prizePool": 1000000,
"tier": "S-Tier",
"league": "Worlds",
"orgSlugAtTime": "east-3"
}
]Org and Roster History
{
"success": true,
"data": {
"playerId": "c76dc4df-1a6f-4c83-b7ba-44cf213e0291",
"playerName": "Faker",
"teams": [
{
"teamSlug": "t1",
"teamName": "T1",
"role": "MID",
"startedAt": "2026-02-01T00:00:00.000Z",
"endedAt": null
},
{
"teamSlug": "lck-allstars",
"teamName": "LCK All-Stars",
"role": "MID",
"startedAt": "2026-02-01T00:00:00.000Z",
"endedAt": null
}
],
"transfersEndpoint": "/api/v1/lol/transfers/player/{playerId}"
}
}