LoL esports WebSocket API: live games, pushed.
Open one socket, subscribe to the matches and games you care about, and every live update arrives as it lands: series score, game state, kills and gold, with a snapshot the moment you subscribe and a ping every 15 seconds. Up to 32 rooms per connection.
- wss://api.citoapi.com/api/v1/lol/live/ws
- Up to 32 rooms per socket
- Ping every 15 s
{ "action": "subscribe", "rooms": [ "match:lol-match-115548147900619033", "game:…" ]}Seamless Integration with our MCP Server
Give Claude, Cursor and ChatGPT the League of Legends esports data. One command writes the MCP config; agents call live match, team, player and schedule tools with real ids instead of guessing them, and your key stays on your machine.
MCPInstall the Cito MCP server
Live LoL, three ways
Pick the delivery your app needs; all carry the same live data.
WebSocket
wss://api.citoapi.com/api/v1/lol/live/ws: subscribe to match: and game: rooms, receive updates as they change.
Snapshot on subscribe
The current state arrives first, so a late joiner never starts blank.
Webhooks
Match events POSTed to your URL, for servers that should not hold a socket open.
Polling
GET /lol/live-matches for every live series, on every plan.
Same key
The socket authenticates with your API key (header, bearer or query).
Heartbeat
A ping every 15 seconds keeps idle connections alive through proxies.
Connect
| Step | What to send |
|---|---|
| Open the socket | wss://api.citoapi.com/api/v1/lol/live/ws with x-api-key (or ?apiKey=) |
| Subscribe | {"action":"subscribe","rooms":["match:<matchId>","game:<gameId>"]} |
| Unsubscribe | {"action":"unsubscribe","rooms":["match:<matchId>"]} |
Which plans
Polling live matches works on every plan, with live data on a delay on Free and Starter and in real time on Pro and above. The WebSocket needs a plan with Live WebSockets (Scale, or Pro with the add-on); the pricing page has the details.
More LoL esports APIs
Every page names the endpoint behind it.
- LoL live score APISeries score and live game state.
- LoL webhooks APIMatch events pushed to your URL.
- LoL team stats APIWin rates, side splits and head-to-head per team.
- LoL esports historical dataEvery completed series since 2023 for models.
- League of Legends APIThe whole LoL esports API on one page.
- LoL match stats APIGame and player stats per match.
Stream live games
Start polling on a free key; open the socket on Scale.