Skip to content

Riot Games · Python SDK

Build with the
Riot Games API.

Typed clients for your applications. A live-game terminal for your next match. A local MCP server for your AI tools.

Get started Explore the API

Async + sync Typed responses Open source

Start with a Riot IDPython
import asyncio

from riotskillissue import PlatformRoute, RiotClient

async def main():
    async with RiotClient(
        default_route=PlatformRoute.EUW1
    ) as riot:
        player = await riot.lol.player_profile("Player#EUW")
        print(player)

asyncio.run(main())
from riotskillissue import PlatformRoute, SyncRiotClient

with SyncRiotClient(
    default_route=PlatformRoute.EUW1
) as riot:
    player = riot.lol.player_profile("Player#EUW")
    print(player)

Set RIOT_API_KEY in your environment, then run. Get your first response

Choose your starting point

  • Python SDK


    Resolve players, fetch match history, and call individual endpoints with typed asynchronous or synchronous clients.

    Build an integration

  • Live game TUI


    See teams, champions, ranks, and bans in your terminal, with automatic refreshes and visible data-quality warnings.

    Open the dashboard

  • MCP server


    Connect a local AI client to Riot data and League analysis tools that return structured match and player evidence.

    Connect your AI client

Find the right level of detail

Work with a player or a match

Use game workflows when you want a complete task, such as a profile or a short match history. Start from runnable examples and choose the route for your game.

Browse examples · Understand routing

Call a specific endpoint

Use riot.raw for individual Riot operations. The reference lists Python accessors, HTTP methods, authentication, and supported route families.

Browse the operation reference · Configure your client

About API coverage

The generated API follows a community-maintained OpenAPI feed, not an official Riot specification. Available endpoints depend on your key's game access and permissions. See coverage and authentication.

Upgrading an existing project? Read the migration guide or check the release notes.