MatchLens

MatchLens is a Python project that uses the Riot Games API to explore League of Legends match data and research a match performance rating.

The project is currently in its early research stage. Its goal to study the context of an individual match and produce an explainable rating.

Current progress

• Retrieves a Riot account using its game name and tagline
• Extracts the player's PUUID
• Retrieves recent League of Legends match IDs
• Retrieves the complete MATCH-V5 payload for the latest match
• Pretty-prints and exports match data as formatted JSON for research

Current data flow

Riot ID
  -> ACCOUNT-V1
  -> PUUID
  -> MATCH-V5 match IDs
  -> latest match details

Setup

1. Clone or download the repository.
2. Create a .env file in the project directory.
3. Add your Riot development API key:

RIOT_API_KEY=your_key_here

4. Run the project:

python main.py

Development API keys expire regularly. Generate a new key in the Riot Developer Portal and replace the value in .env when required.

Security

Never commit or publish the .env file.

Planned work

• Complete the refactor into reusable API functions
• Catalogue relevant MATCH-V5 participant, team, and game fields
• Extract a player's data from the ten match participants
• Calculate normalized statistics
• Compare players with their direct role opponents
• Design, test, document, and revise a custom post-match rating
• Analyze multiple matches instead of only the latest match
• Add automated tests and clearer API error handling
• Explore FastAPI and persistent storage after the rating research is stable

Riot Games disclaimer

MatchLens isn't endorsed by Riot Games and doesn't reflect the views or opinions of Riot Games or anyone officially involved in producing or managing Riot Games properties. Riot Games, and all associated properties are trademarks or registered trademarks of Riot Games, Inc.