Strength above all · Noxus shall reign
Ambessa Bot automatically monitors your allies' Solo Queue ranked games and delivers real-time battle reports directly in your Discord server — LP tracking, rank history, weekly recaps and detailed match analysis.
Ambessa Bot is a Discord bot built to help friend groups and gaming communities automatically follow the ranked progression of their members on League of Legends (EUW server for now). Instead of manually checking third-party sites like OP.GG or DPM, the bot does it for you — every 2 minutes — and posts a rich notification card whenever a tracked player finishes a ranked game.
Every 2 minutes, the bot polls the Riot Games API to detect new Solo Queue games for every tracked player and posts a result embed instantly in your Discord channel.
Access in-depth stats for any tracked player: KDA, winrate, champion pool, LP gain/loss history, rank evolution graph, performance score and server leaderboard position.
Every Friday at 6 PM, the bot automatically posts a weekly summary for your server — ranking players by LP gained, showing winrates, most played champions and KDA averages.
Visual rank evolution chart generated on demand — displaying the LP curve over the last 200 games, with tier bands, win/loss color-coded dots and statistical summary.
Discord users can link their Riot account to their Discord profile, enabling quick access to personal stats without specifying a rank number each time.
Browse the last N ranked games for any tracked player with champion, KDA, LP change and time elapsed — all displayed in a clean embed directly in Discord.
A server admin uses /add RiotID#TAG to start
monitoring a League of Legends account in a specific channel.
Every 2 minutes, the bot calls the official Riot Games Match v5 and League v4 APIs to check for new Solo Queue games.
A rich embed is sent to the configured channel with win/loss, champion, KDA, LP change, current rank and a "Detailed Stats" button.
Members can use slash commands at any time to query player stats, view the server leaderboard, generate LP graphs or browse match history.
Ambessa Bot uses the official Riot Games Developer API exclusively to retrieve publicly available ranked data. We strictly respect Riot's rate limits, usage policies and developer guidelines.
| Endpoint | Purpose | Frequency |
|---|---|---|
account-v1by-riot-id |
Resolve a Riot ID (GameName#TAG) to a PUUID when a player is added | Once on /add |
match-v5matchlist by puuid |
Fetch the latest Solo Queue match IDs for each tracked player | Every 2 min per player |
match-v5match by id |
Retrieve full match data (participants, stats, duration) for new games | On new game detection |
match-v5timeline by id |
Get frame-by-frame timeline for gold/CS diff at 15 minutes | On demand (detailed stats button) |
league-v4entries by puuid |
Get current rank, LP, wins and losses for accurate LP tracking | On new game detection |
summoner-v4by puuid |
Retrieve summoner profile icon for display in stats embeds | On /stats (10 min cache) |
champion-mastery-v4by puuid |
Display mastery points for top played champions in stats | On /stats (30 min cache) |
lol-status-v4platform-data |
Monitor API availability and alert the bot owner if the key is down | Every 30 min |
Rate Limit Compliance: All API calls go through a centralized
retry handler that respects Retry-After headers on 429 responses
and applies exponential back-off on server errors.
Caching: Match data is cached in memory for 48 hours, stats for 10 minutes and mastery data for 30 minutes to minimize unnecessary API calls.
No Data Selling: Retrieved data is only used to power Discord notifications and on-demand commands. We never sell, share or monetize player data.
Additionally, interactive buttons are available after game notifications: 📊 Detailed Stats, 📈 LP Graph and 📜 Match History.
Ambessa Bot is not endorsed by Riot Games and does not 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.
For bug reports, data removal requests or general questions:
