GET Hero Rank Statistics
/openmlbb/mlbb/heroes/rank
API Path: /api/heroes/rank
Fetch rank statistics for heroes over a specified time window. Supports query parameters for filtering by past days, rank tier, sorting, pagination, and localization.
Query parameters:
- days: Past day window. Allowed values:
1,3,7,15,30. - rank: Rank filter. Allowed values:
all,epic,legend,mythic,honor,glory. - sort_field: Sort field. Allowed values:
pick_rate,ban_rate,win_rate. - sort_order: Sort order for results. Allowed values:
asc,desc. - size: Number of items per page (minimum: 1).
- index: Page index (starting from 1).
- lang: Language code for localized content (default:
en).
The response includes hero rank statistics:
- records: Array of hero entries, each containing:
- data:
- main_hero:
- data:
- head: Hero head image URL.
- name: Hero name.
- data:
- main_heroid: Unique hero identifier.
- main_hero_channel:
- id: Channel ID reference.
- main_hero_appearance_rate: Hero pick rate (appearance frequency).
- main_hero_ban_rate: Hero ban rate.
- main_hero_win_rate: Hero win rate.
- sub_hero: Array of related sub-heroes, each containing:
- hero:
- data:
- head: Sub-hero head image URL.
- data:
- heroid: Sub-hero ID.
- hero_channel:
- id: Channel ID reference.
- increase_win_rate: Impact of sub-hero on win rate.
- hero:
- main_hero:
- data:
This endpoint is useful for:
- Analyzing hero performance trends across different ranks.
- Tracking pick, ban, and win rates over time.
- Understanding synergies and counters via sub-hero relationships.
Python Example
from OpenMLBB import OpenMLBB
client = OpenMLBB()
response = client.mlbb.heroes_rank(days="1", rank="all", sort_field="win_rate", sort_order="desc", size=20, index=1, lang="en")
print(response)Path and Query Parameters
| Name | In | Type | Required | Default |
|---|---|---|---|---|
| days | query | string | no | 1 |
| rank | query | string | no | all |
| sort_field | query | string | no | win_rate |
| sort_order | query | string | no | desc |
| size | query | integer | no | 20 |
| index | query | integer | no | 1 |
| lang | query | string | no | en |