# Rone Arena API

> Free, unofficial REST API for Mobile Legends: Bang Bang game data: heroes, win rates, builds, counters, academy guides, player records and pro league results, returned as JSON, with an interactive web playground.

Rone Arena is a community-maintained project. It is not affiliated with or endorsed by Moonton; the game is named only to describe the data. Data comes from publicly accessible game services and is provided for informational and educational use.

## How to call it

- Base URL: `https://arena.rone.dev/api`. Every endpoint is a GET or POST under `/api/` and answers JSON.
- No API key. Public endpoints need no sign-in; `user` endpoints need `Authorization: Bearer <jwt>`, obtained by `POST /api/user/auth/send-vc` (a code sent to the player's in-game mail) then `POST /api/user/auth/login`.
- Heroes are addressed by numeric ID or by name (`hero_identifier`, for example `1` or `miya`).
- Image URLs in responses go through the wsrv.nl image proxy.
- A 503 response means maintenance or high traffic; read `alternative_endpoint` in the body for a fallback host.
- A 429 `UPSTREAM_RATE_LIMITED` means the game service is throttling; back off for a few minutes instead of retrying in parallel.
- If `arena.rone.dev` answers 5xx or times out, the same API is served by the backup host at `https://arena.fastapicloud.dev/api`.
- The full machine-readable schema is the OpenAPI document at `https://arena.rone.dev/api/openapi.json`.

Example:

```bash
curl https://arena.rone.dev/api/heroes/rank
```

## Pages

- Playground: https://arena.rone.dev/web/heroes (forms for every endpoint, with readable responses and code in eight languages)
- API docs: https://arena.rone.dev/api/docs
- Standings simulator: https://arena.rone.dev/tools/standings.md
- Showcase: https://arena.rone.dev/showcase.md
- Patch notes: https://arena.rone.dev/patch-notes.md
- Blog: https://arena.rone.dev/blog.md
- Python SDK: `pip install rone-arena`

## Endpoints (57 in 5 groups)

### User

Authentication and player profile APIs.

- [POST /api/user/auth/send-vc](https://arena.rone.dev/web/user/auth/send-vc.md): Send Verification Code. Send an in-game verification code to the player's account, valid for 5 mins.
- [POST /api/user/auth/login](https://arena.rone.dev/web/user/auth/login.md): Login with Verification Code. Authenticate the player using a verification code to obtain a JWT and session token.
- [POST /api/user/auth/logout](https://arena.rone.dev/web/user/auth/logout.md): Logout (sign-in required). Invalidate the player's session using the JWT obtained from `/api/user/auth/login`.
- [GET /api/user/info](https://arena.rone.dev/web/user/info.md): User Info (sign-in required). Retrieve the authenticated player's base profile information using a valid JWT.
- [GET /api/user/stats](https://arena.rone.dev/web/user/stats.md): User Statistics (sign-in required, deprecated). Retrieve the authenticated player's overall statistics using a valid JWT.
- [GET /api/user/privacy/settings](https://arena.rone.dev/web/user/privacy/settings.md): User Privacy Settings (sign-in required, deprecated). Retrieve the authenticated player's privacy settings using a valid JWT.
- [POST /api/user/privacy/settings](https://arena.rone.dev/web/user/privacy/settings.md): Update User Privacy Settings (sign-in required, deprecated). Update the authenticated player's privacy settings using a valid JWT.
- [GET /api/user/season](https://arena.rone.dev/web/user/season.md): User Season List (sign-in required, deprecated). Retrieve the authenticated player's season information using a valid JWT.
- [GET /api/user/matches](https://arena.rone.dev/web/user/matches.md): User Matches (sign-in required, deprecated). Retrieve the authenticated player's recent matches information using a valid JWT.
- [GET /api/user/matches/{match_id}](https://arena.rone.dev/web/user/matches/{match_id}.md): User Match Details (sign-in required, deprecated). Retrieve the authenticated player's detailed match information using a valid JWT.
- [GET /api/user/heroes/frequent](https://arena.rone.dev/web/user/heroes/frequent.md): User Frequent Heroes (sign-in required, deprecated). Retrieve the authenticated player's frequent heroes information using a valid JWT.
- [GET /api/user/matches/hero/{hero_identifier}](https://arena.rone.dev/web/user/matches/hero/{hero_identifier}.md): User Matches by Hero (sign-in required, deprecated). Retrieve the authenticated player's recent matches filtered by a specific hero using a valid JWT.
- [GET /api/user/friends](https://arena.rone.dev/web/user/friends.md): User Friends (sign-in required, deprecated). Retrieve the authenticated player's friends information using a valid JWT.

### Heroes

Hero analytics and gameplay data APIs.

- [GET /api/heroes](https://arena.rone.dev/web/heroes/heroes.md): List Heroes. Retrieve a paginated list of all heroes with basic information.
- [GET /api/heroes/rank](https://arena.rone.dev/web/heroes/heroes/rank.md): Hero Rank Statistics. Fetch rank statistics for heroes over a specified time window.
- [GET /api/heroes/positions](https://arena.rone.dev/web/heroes/heroes/positions.md): Hero Position Filters. Filter heroes by their position on the map using role and lane criteria.
- [GET /api/heroes/wallpapers](https://arena.rone.dev/web/heroes/heroes/wallpapers.md): Wallpaper Gallery. Browse the full official wallpaper gallery across all heroes, newest first, for desktop or mobile screens.
- [GET /api/heroes/{hero_identifier}](https://arena.rone.dev/web/heroes/heroes/{hero_identifier}.md): Hero Detail. Get detailed information for a specific hero by ID or name.
- [GET /api/heroes/{hero_identifier}/stats](https://arena.rone.dev/web/heroes/heroes/{hero_identifier}/stats.md): Hero Detail Statistics. Get detailed statistics for a specific hero by ID or name.
- [GET /api/heroes/{hero_identifier}/skill-combos](https://arena.rone.dev/web/heroes/heroes/{hero_identifier}/skill-combos.md): Hero Skill Combos. Get the most effective skill combos for a specific hero by ID or name.
- [GET /api/heroes/{hero_identifier}/wallpapers](https://arena.rone.dev/web/heroes/heroes/{hero_identifier}/wallpapers.md): Hero Wallpapers. Get official wallpapers for a specific hero by ID or name, for desktop or mobile screens.
- [GET /api/heroes/{hero_identifier}/trends](https://arena.rone.dev/web/heroes/heroes/{hero_identifier}/trends.md): Hero Performance Trends. Get rate trends for a specific hero by ID or name over a specified time window.
- [GET /api/heroes/{hero_identifier}/relations](https://arena.rone.dev/web/heroes/heroes/{hero_identifier}/relations.md): Hero Relations. Get information about the relations of a specific hero by ID or name.
- [GET /api/heroes/{hero_identifier}/counters](https://arena.rone.dev/web/heroes/heroes/{hero_identifier}/counters.md): Hero Counters. Get information about heroes that counter a specific hero by ID or name.
- [GET /api/heroes/{hero_identifier}/compatibility](https://arena.rone.dev/web/heroes/heroes/{hero_identifier}/compatibility.md): Hero Compatibility. Get compatibility information for a specific hero by ID or name.

### Academy

Guide, build, emblem, and meta resources.

- [GET /api/academy/meta/version](https://arena.rone.dev/web/academy/meta/version.md): Game Version Info. Fetch a list of game versions with their release dates.
- [GET /api/academy/heroes/catalog](https://arena.rone.dev/web/academy/heroes/catalog.md): Hero Catalog. Supports query parameters for pagination and localization.
- [GET /api/academy/roles](https://arena.rone.dev/web/academy/roles.md): Roles. List all hero roles available in the game (Tank, Fighter, Assassin, Mage, Marksman, Support).
- [GET /api/academy/equipment](https://arena.rone.dev/web/academy/equipment.md): Equipment (Items). List all equipment (items).
- [GET /api/academy/equipment/expanded](https://arena.rone.dev/web/academy/equipment/expanded.md): Equipment Expanded. Get detailed information about a specific equipment item.
- [GET /api/academy/spells](https://arena.rone.dev/web/academy/spells.md): Battle Spells. List all battle spells with details.
- [GET /api/academy/emblems](https://arena.rone.dev/web/academy/emblems.md): Emblems. List all emblems with details.
- [GET /api/academy/ranks](https://arena.rone.dev/web/academy/ranks.md): Ranks List. Retrieve all rank information for Mobile Legends: Bang Bang.
- [GET /api/academy/ranks/{rank_id}](https://arena.rone.dev/web/academy/ranks/{rank_id}.md): Ranks Details. Retrieve details for a specific rank in Mobile Legends: Bang Bang by rank ID.
- [GET /api/academy/recommended](https://arena.rone.dev/web/academy/recommended.md): Recommended Content. List recommended content for players.
- [GET /api/academy/recommended/{recommended_id}](https://arena.rone.dev/web/academy/recommended/{recommended_id}.md): Recommended Detail. Get details for a specific recommended content item by its identifier.
- [GET /api/academy/heroes](https://arena.rone.dev/web/academy/heroes.md): Hero Filters. Retrieve a list of heroes with filtering options for role and lane.
- [GET /api/academy/heroes/{hero_identifier}/stats](https://arena.rone.dev/web/academy/heroes/{hero_identifier}/stats.md): Hero Statistics. Retrieve performance statistics for a specific hero by rank.
- [GET /api/academy/heroes/{hero_identifier}/lane](https://arena.rone.dev/web/academy/heroes/{hero_identifier}/lane.md): Hero Lane Distribution. Retrieve lane distribution information for a specific hero.
- [GET /api/academy/heroes/{hero_identifier}/win-rate/timeline](https://arena.rone.dev/web/academy/heroes/{hero_identifier}/win-rate/timeline.md): Hero Lane Time-based Win Rate. Retrieve time-based win rate statistics for a specific hero in a given lane.
- [GET /api/academy/heroes/{hero_identifier}/builds](https://arena.rone.dev/web/academy/heroes/{hero_identifier}/builds.md): Hero Recommended Builds. Hero Recommended Builds
- [GET /api/academy/heroes/{hero_identifier}/counters](https://arena.rone.dev/web/academy/heroes/{hero_identifier}/counters.md): Hero Counters. Retrieve counter information for a specific hero.
- [GET /api/academy/heroes/{hero_identifier}/teammates](https://arena.rone.dev/web/academy/heroes/{hero_identifier}/teammates.md): Hero Teammates. Retrieve teammate information for a specific hero.
- [GET /api/academy/heroes/{hero_identifier}/trends](https://arena.rone.dev/web/academy/heroes/{hero_identifier}/trends.md): Hero Performance Trends. Retrieve trend information for a specific hero over a selected time window.
- [GET /api/academy/heroes/{hero_identifier}/recommended](https://arena.rone.dev/web/academy/heroes/{hero_identifier}/recommended.md): Hero Recommended Content. Retrieve recommended content for a specific hero.
- [GET /api/academy/heroes/ratings](https://arena.rone.dev/web/academy/heroes/ratings.md): Hero Ratings Index (deprecated). Retrieve a list of all hero ratings and community polls.
- [GET /api/academy/heroes/ratings/{subject}](https://arena.rone.dev/web/academy/heroes/ratings/{subject}.md): Hero Ratings by Subject (deprecated). Retrieve hero ratings for a specific subject from the ratings index.

### Addon

Utility APIs such as calculators and IP tools.

- [GET /api/addon/win-rate-calculator](https://arena.rone.dev/web/addon/win-rate-calculator.md): Win Rate Calculator for Consecutive Wins. Calculate the number of consecutive wins required to reach a target win rate based on current matches and current win rate.
- [GET /api/addon/ip](https://arena.rone.dev/web/addon/ip.md): Check IP address location details. Retrieves geographic information associated with a given IP address.

### Esports

Professional league schedules, standings, and match details.

- [GET /api/esports/id/schedule](https://arena.rone.dev/web/esports/id/schedule.md): Indonesia Regular Season Schedule. Regular-season schedule of the Indonesian professional league, grouped by week and day.
- [GET /api/esports/id/standings](https://arena.rone.dev/web/esports/id/standings.md): Indonesia Regular Season Standings. Regular-season standings of the Indonesian professional league: rank, team, match point, match win-lose, net game win and game win-lose.
- [GET /api/esports/id/matches/{match_id}](https://arena.rone.dev/web/esports/id/matches/{match_id}.md): Indonesia Match Details. Full match history of one match of the Indonesian professional league: every game with both teams and all players (hero, KDA, items, emblem, talents, gold, damage dealt, damage taken and tower damage).
- [GET /api/esports/ph/schedule](https://arena.rone.dev/web/esports/ph/schedule.md): Philippines Regular Season Schedule. Regular-season schedule of the Philippine professional league, grouped by week and day.
- [GET /api/esports/ph/standings](https://arena.rone.dev/web/esports/ph/standings.md): Philippines Regular Season Standings. Regular-season standings of the Philippine professional league: rank, team, match point, match win-lose, net game win and game win-lose.
- [GET /api/esports/ph/matches/{match_slug}](https://arena.rone.dev/web/esports/ph/matches/{match_slug}.md): Philippines Match Details. Full match history of one match of the Philippine professional league: every game with both teams and all players (hero, KDA, items, emblem, talents, gold, damage dealt, damage taken and tower damage).
- [POST /api/esports/{league}/standings/simulate](https://arena.rone.dev/web/esports/{league}/standings/simulate.md): Simulate League Standings. Re-rank a professional league's regular season after changing match results, to see what a different result would do to the table and the playoff line.
- [POST /api/esports/standings/calculate](https://arena.rone.dev/web/esports/standings/calculate.md): Calculate Custom League Standings. The same calculator for any league: give the team names (or just a count) and enter match results.