LoL Discord bot API

LoL Discord bot API for schedules, live matches, teams, and player cards.

Power slash commands for League of Legends esports servers using endpoints for live matches, schedules, standings, teams, players, and game stats.

Get Free API Key View LoL Docs

/lol-live

/lol-schedule

/lol-player

/lol-team

API response preview

LoL API data for product pages, bots, and dashboards

JSON

Useful endpoints

/api/v1/lol/live

Live matches

/api/v1/lol/schedule/today

Today's schedule

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

Player stats

Run the request

X-API-Key

curl "https://api.citoapi.com/api/v1/lol/live" \
  -H "X-API-Key: $CITO_API_KEY"

{
  "success": true,
  "data": [],
  "meta": {
    "source": "Cito API",
    "game": "league-of-legends"
  }
}

Primary endpoint: /api/v1/lol/schedule/today

Power slash commands for League of Legends esports servers using endpoints for live matches, schedules, standings, teams, players, and game stats.

/lol-live/lol-schedule/lol-player/lol-team

Endpoint chain

Start with /api/v1/lol/schedule/today, 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.

GET

/api/v1/lol/schedule/today

Today's matches, upcoming schedule, and live state.

Today's pro matches

/api/v1/lol/schedule/today

Use this first when the page needs today's matches, upcoming schedule, and live state.

Upcoming matches

/api/v1/lol/schedule/upcoming

Upcoming matches fills in the detail around the primary response.

League schedule

/api/v1/lol/leagues/{leagueId}/schedule

League schedule fills in the detail around the primary response.

Returned data

Power slash commands for League of Legends esports servers using endpoints for live matches, schedules, standings, teams, players, and game stats.

Best first request

Call /api/v1/lol/schedule/today 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.

Live matches and schedules

Pick/ban and game stats where published

Tournament brackets and standings

Player earnings and org history

Transfer tracking

Roster history

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.

Live API docs

Human-readable LoL endpoint reference

Postman collection

Import requests with variables

Endpoint manifest

Machine-readable endpoint list

Changelog

Recent API and data updates

Status

Operational status and uptime history

AI agent skill

Instructions for AI coding agents

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/schedule/today. Add supporting endpoints only when your page needs more context.

GET

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

Career prize pool earnings with tournament-by-tournament rows.

GET

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

Player earnings totals, event counts, placements, and tracked history.

GET

/api/v1/lol/players/{playerId}/teams

Team history for org changes, roles, and date ranges.

GET

/api/v1/lol/teams/{slug}/roster/history

Historical rosters with roster membership periods.

GET

/api/v1/lol/transfers

Recent transfer activity across tracked LoL teams and players.

GET

/api/v1/lol/teams/{slug}/earnings

Organization-level earnings and tournament results where tracked.

GET

/api/v1/lol/live

Active League of Legends esports matches and live state.

GET

/api/v1/lol/schedule/today

Today's LoL esports schedule for match-day apps.

GET

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

Game-level player stats after source publication.

GET

/api/v1/lol/analytics/drafts/{matchId}

Champion picks, bans, player roles, and side context.

GET

/api/v1/lol/live/{gameId}/visual-state

Live gold, score, objective, and game-time reads where available.

GET

/api/v1/lol/games/{gameId}/timeline

Timeline events, objective timings, and gold snapshots where available.

GET

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

Sliding-window player performance over recent matches.

GET

/api/v1/lol/players/{playerId}/champion-pool

Champion picks and win rates over the requested match window.

GET

/api/v1/lol/matches/{matchId}/media

Live stream and replay links where available.

GET

/api/v1/lol/webhooks/events

Supported LoL webhook events for paid plans.

Use cases