Game APIs/League of Legends API

League of Legends API

Player earnings, org history, transfers, live matches, and esports data

BASEhttps://api.citoapi.com/api/v1

API RootAppend any League of Legends endpoint path below.

LoL 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 webhooks

Live coverage pre-check

Before treating a LoL match as decision-grade live state, check coverage. Use/lol/coveragefor the league matrix and/lol/matches/{matchId}/coveragefor a specific match. For LCK CL / Academy, treat live-state coverage as opportunistic untilnumeric_live_stateis true.

curl "https://api.citoapi.com/api/v1/lol/matches/lol-match-116520394663535912/coverage" \
  -H "x-api-key: YOUR_CITO_API_KEY"

{
  "match_id": "lol-match-116520394663535912",
  "coverage": {
    "schedule_metadata": true,
    "live_row": false,
    "numeric_live_state": false,
    "webhook_event": false,
    "coverage_level": "metadata_only",
    "expected_live_state": false,
    "expected_webhooks": false
  },
  "league": {
    "slug": "lck_challengers",
    "live_state_policy": "opportunistic_live_state"
  }
}

LoL Webhook Events

Push events available for live match and score automation.

EVENTlol.match.started

startedDelivered to configured webhook destinations on paid plans.

EVENTlol.live.game_started

game startedDelivered to configured webhook destinations on paid plans.

EVENTlol.live.state

stateDelivered to configured webhook destinations on paid plans.

EVENTlol.live.gold_swing

gold swingDelivered to configured webhook destinations on paid plans.

EVENTlol.live.objective

objectiveDelivered to configured webhook destinations on paid plans.

EVENTlol.live.kill_update

kill updateDelivered to configured webhook destinations on paid plans.

EVENTlol.live.tower_destroyed

tower destroyedDelivered to configured webhook destinations on paid plans.

EVENTlol.score.updated

updatedDelivered to configured webhook destinations on paid plans.

EVENTlol.match.completed

completedDelivered to configured webhook destinations on paid plans.

Players

Player stats, form, champion pools, earnings, and team history.

GET/api/v1/lol/players/{playerId}/earnings

Player earningsPlayer prize pool earnings with tournament rows

curl "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/summary

Player Earnings SummaryPlayer earnings totals, placement counts, and sync metadata

curl "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}/teams

Player teamsPlayer org history and team timeline

curl "https://api.citoapi.com/api/v1/lol/players/{playerId}/teams" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/players/{playerId}/stats

Player statsPlayer statistics and recent performance rows

curl "https://api.citoapi.com/api/v1/lol/players/{playerId}/stats" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/players/{playerId}/form

Player formSliding-window player form for last 10, 20, and 50 matches with optional league and role filters

curl "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-pool

Player Champion PoolRecent champion picks, pick rates, and decided-game win rates over the player's last N matches

curl "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}/teams

Player teamsPlayer org history and team timeline

curl "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/history

Team Roster HistoryHistorical team rosters and date ranges

curl "https://api.citoapi.com/api/v1/lol/teams/{slug}/roster/history" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/teams

List TeamsProfessional LoL teams

curl "https://api.citoapi.com/api/v1/lol/teams" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/teams/{slug}/objectives

Team ObjectivesTeam objective control rates over recent matches with optional league filter

curl "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/transfers

Recent TransfersRecent player transfers with filters

curl "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

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

curl "https://api.citoapi.com/api/v1/lol/transfers/team/{slug}" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Live Matches

Active matches, live coverage pre-checks, live series state, visual state, and live aliases.

GET/api/v1/lol/coverage

Coverage MatrixLeague-level live coverage matrix and live-state pre-check rules

curl "https://api.citoapi.com/api/v1/lol/coverage" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/live

Live MatchesCurrently active in-progress LoL esports matches only. Use schedule endpoints for upcoming games.

curl "https://api.citoapi.com/api/v1/lol/live" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/matches/live

Live MatchesAlias for currently active pro matches

curl "https://api.citoapi.com/api/v1/lol/matches/live" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/matches/{matchId}/coverage

Match Coverage Pre-checkPre-check whether a match has schedule metadata, a live row, numeric live state, and live-state webhook eligibility

curl "https://api.citoapi.com/api/v1/lol/matches/{matchId}/coverage" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/live/{matchId}/series

Live SeriesLive series state with completed games, score, and current game context

curl "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-state

Live Visual StateAccepted near-live visual reads for game time, gold, kills, towers, dragons, and barons

curl "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/live

Live MatchesAlias for currently active pro matches

curl "https://api.citoapi.com/api/v1/lol/matches/live" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/matches/{matchId}/coverage

Match Coverage Pre-checkPre-check whether a match has schedule metadata, a live row, numeric live state, and live-state webhook eligibility

curl "https://api.citoapi.com/api/v1/lol/matches/{matchId}/coverage" \
  -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

curl "https://api.citoapi.com/api/v1/lol/matches/{id}" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/matches/{id}/games

Match GamesGames inside a match, including raw game IDs where available

curl "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

curl "https://api.citoapi.com/api/v1/lol/games/{gameId}" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/games/{gameId}/stats

Game statsStored per-player stats for a specific game

curl "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-stats

Game Player StatsAlias for game-level player stat rows

curl "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}/postgame

Game postgameCompleted-game gold graph, timeline, plates, role distributions, vision, and jungle share

curl "https://api.citoapi.com/api/v1/lol/games/{gameId}/postgame" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/games/{gameId}/plates

Game platesVoidgrubs, tower plates, and lane plate counts for one game

curl "https://api.citoapi.com/api/v1/lol/games/{gameId}/plates" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/games/{gameId}/distributions

Game distributionsGold and damage distribution by role for one game

curl "https://api.citoapi.com/api/v1/lol/games/{gameId}/distributions" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/games/{gameId}/vision

Game visionTeam vision totals for one game

curl "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-share

Game jungle shareJungle CS share data by role for one game

curl "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/today

Today ScheduleToday’s match schedule for LoL esports apps

curl "https://api.citoapi.com/api/v1/lol/schedule/today" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/schedule/upcoming

Upcoming ScheduleUpcoming LoL esports schedule

curl "https://api.citoapi.com/api/v1/lol/schedule/upcoming" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/leagues/lol-lck/schedule

lol lck scheduleLCK match schedule. The slug lck also works.

curl "https://api.citoapi.com/api/v1/lol/leagues/lol-lck/schedule" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/leagues/lol-lpl/schedule

lol lpl scheduleLPL match schedule. The slug lpl also works.

curl "https://api.citoapi.com/api/v1/lol/leagues/lol-lpl/schedule" \
  -H "x-api-key: YOUR_CITO_API_KEY"

GET/api/v1/lol/leagues/{leagueId}/standings

League StandingsLeague standings, returning an empty rankings array when standings are not published yet

curl "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/events

Webhook EventsSupported LoL webhook events for paid plans

curl "https://api.citoapi.com/api/v1/lol/webhooks/events" \
  -H "x-api-key: YOUR_CITO_API_KEY"

Other LoL Endpoints

Additional schedule, standings, and compatibility paths.

GET/api/v1/lol/leagues

lol leaguesLeague list with aliases and direct schedule endpoints. LCK is lol-lck/lck; LPL is lol-lpl/lpl.

curl "https://api.citoapi.com/api/v1/lol/leagues" \
  -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}"
  }
}

Call of Duty API

Apex Legends API