Rone Arena API
v1.2.3

Heroes Endpoints

Hero analytics and gameplay data APIs.

Requests go to https://arena.rone.dev/api. Forms are generated from the OpenAPI schema.

Jump to endpoint

GET /api/heroes

List Heroes

Open on its own page

Retrieve a paginated list of all heroes with basic information. Supports query parameters for pagination (size, index), sorting (order), and localization (lang).

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • order: Sort order for results. Allowed values: asc, desc.
  • lang: Language code for localized content (default: en).

The response includes hero records:

  • records: Array of hero entries, each containing:
      • data:
          • hero:
              • data:
                  • head: Hero head image URL.
                  • name: Hero name.
                  • smallmap: Hero smallmap image URL.
          • hero_id: Unique hero identifier.
          • relation:
              • assist:
                  • target_hero_id: Array of hero IDs assisted.
              • strong:
                  • target_hero_id: Array of hero IDs this hero is strong against.
              • weak:
                  • target_hero_id: Array of hero IDs this hero is weak against.

This endpoint is useful for:

  • Displaying hero collections.
  • Browsing hero details.
  • Analyzing hero relationships (assist, strong, weak).
Example response 
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "data": {
          "hero": {
            "data": {
              "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage_2_1_42%2F100_df7603c292198bf4aa7b551d401ea5c1.png",
              "name": "Marcel",
              "smallmap": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage_2_1_42%2F100_82e5c2646276cd907f69cc800057c737.png"
            }
          },
          "hero_id": 132,
          "relation": {
            "assist": {
              "target_hero_id": [
                60,
                121
              ]
            },
            "strong": {
              "target_hero_id": [
                18,
                38
              ]
            },
            "weak": {
              "target_hero_id": [
                84,
                83
              ]
            }
          }
        }
      }
    ],
    "total": 132
  }
}
size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

order · query

Sort order by hero ID.

lang · query

Language code for localized content.

GET /api/heroes

GET /api/heroes/rank

Hero Rank Statistics

Open on its own page

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.
          • 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.
              • heroid: Sub-hero ID.
              • hero_channel:
                  • id: Channel ID reference.
              • increase_win_rate: Impact of sub-hero on win rate.

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.
Example response 
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "data": {
          "main_hero": {
            "data": {
              "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage_2_1_40%2F100_8143d7bbd4318d7c699908e808de885e.png",
              "name": "Sora"
            }
          },
          "main_hero_appearance_rate": 0.014228,
          "main_hero_ban_rate": 0.834702,
          "main_hero_channel": {
            "id": 3245715
          },
          "main_hero_win_rate": 0.506002,
          "main_heroid": 131,
          "sub_hero": [
            {
              "hero": {
                "data": {
                  "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_6495be044c2d28106e200f6918391d54.png"
                }
              },
              "hero_channel": {
                "id": 2678835
              },
              "heroid": 99,
              "increase_win_rate": 0.061114
            }
          ]
        }
      }
    ],
    "total": 132
  }
}
days · query

Past day window for rank statistics.

rank · query

Rank filter for hero statistics.

sort_field · query

Field to sort hero statistics.

sort_order · query

Sort order by field.

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/heroes/rank

GET /api/heroes/positions

Hero Position Filters

Open on its own page

Filter heroes by their position on the map using role and lane criteria. Supports multiple query parameters for roles and lanes, along with pagination, sorting, and localization.

Query parameters:

  • role: Role filter (multi allowed). Values: tank, fighter, assassin, mage, marksman, support.

Example: role=tank&role=fighter

  • lane: Lane filter (multi allowed). Values: exp, mid, roam, jungle, gold.

Example: lane=exp&lane=mid

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • order: Sort order for results. Allowed values: asc, desc.
  • lang: Language code for localized content (default: en).

The response includes hero position data:

  • records: Array of hero entries, each containing:
      • data:
          • hero:
              • data:
                  • name: Hero name.
                  • smallmap: Hero smallmap image URL.
                  • roadsort: Array of lane metadata objects:
                      • _id: Unique identifier.
                      • caption: Lane caption (localized).
                      • configId: Configuration ID.
                      • createdAt: Creation timestamp.
                      • createdUser: Creator username.
                      • data:
                          • _object: Object reference ID.
                          • road_sort_icon: Lane icon URL.
                          • road_sort_id: Lane ID.
                          • road_sort_title: Lane title (e.g., Roam).
                      • updatedAt: Last update timestamp.
                      • updatedUser: Last updater username.
                  • sortid: Array of role metadata objects:
                      • _id: Unique identifier.
                      • caption: Role caption (localized).
                      • configId: Configuration ID.
                      • createdAt: Creation timestamp.
                      • createdUser: Creator username.
                      • data:
                          • _object: Object reference ID.
                          • sort_icon: Role icon URL.
                          • sort_id: Role ID.
                          • sort_title: Role title (e.g., Support).
                      • updatedAt: Last update timestamp.
                      • updatedUser: Last updater username.
          • hero_id: Unique hero identifier.
          • relation:
              • assist:
                  • target_hero_id: Array of hero IDs assisted.
              • strong:
                  • target_hero_id: Array of hero IDs this hero is strong against.
              • weak:
                  • target_hero_id: Array of hero IDs this hero is weak against.
      • id: Record identifier.

This endpoint is useful for:

  • Building filtered hero lists.
  • Analyzing hero roles and lane assignments.
  • Understanding hero relationships (assist, strong, weak).
Example response 
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "data": {
          "hero": {
            "data": {
              "name": "Marcel",
              "roadsort": [
                {
                  "_id": "66854202aa8e7f6ec4703d8f",
                  "caption": "\u8f85\u52a9",
                  "configId": 144237,
                  "createdAt": 1720009218480,
                  "createdUser": "nickjin",
                  "data": {
                    "_object": 2732073,
                    "road_sort_icon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fa3dbb075b4d8186c29f02f7d47da236a.svg",
                    "road_sort_id": "3",
                    "road_sort_title": "Roam"
                  },
                  "id": 2732083,
                  "linkId": [
                    2732073
                  ],
                  "sort": 0,
                  "updatedAt": 1723022949109,
                  "updatedUser": "nickjin"
                },
                ""
              ],
              "smallmap": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage_2_1_42%2F100_82e5c2646276cd907f69cc800057c737.png",
              "sortid": [
                {
                  "_id": "6698c06a613093b976b4a97c",
                  "caption": "6\u8f85\u52a9",
                  "configId": 144237,
                  "createdAt": 1721286762785,
                  "createdUser": "nickjin",
                  "data": {
                    "_object": 2740651,
                    "sort_icon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2F1e4609b25a4cd63ee5a13015d4058159.png",
                    "sort_id": "6",
                    "sort_title": "support"
                  },
                  "id": 2740666,
                  "linkId": [
                    2740651
                  ],
                  "sort": 0,
                  "updatedAt": 1723023113317,
                  "updatedUser": "nickjin"
                },
                ""
              ]
            }
          },
          "hero_id": 132,
          "relation": {
            "assist": {
              "target_hero_id": [
                60,
                121
              ]
            },
            "strong": {
              "target_hero_id": [
                18,
                38
              ]
            },
            "weak": {
              "target_hero_id": [
                84,
                83
              ]
            }
          }
        },
        "id": 3280483
      }
    ],
    "total": 132
  }
}
Role role · query

Filter heroes by role.

Lane lane · query

Filter heroes by lane.

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

order · query

Sort order by hero ID.

lang · query

Language code for localized content.

GET /api/heroes/positions

GET /api/heroes/wallpapers

Wallpaper Gallery

Open on its own page

Browse the full official wallpaper gallery across all heroes, newest first, for desktop or mobile screens. Supports query parameters for device, pagination, and localization. For one hero's wallpapers, use /api/heroes/{hero_identifier}/wallpapers.

Query parameters:

  • device: Target device: desktop (landscape, 1920x1080) or mobile (portrait, 1080x1920). Default: desktop.
  • 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 wallpaper details:

  • records: Array of wallpaper entries, each containing:
      • id: Wallpaper record ID.
      • caption: Internal wallpaper caption.
      • data:
          • heroid: Array of hero IDs shown in the wallpaper. Absent on event artwork without a hero.
          • pictures: Array of image variants, each with resolution, url, and md5. Records may carry more resolutions than the requested device (e.g., 2560x1440 or 1080x2400).
          • skinid: Skin label associated with the wallpaper.
          • author: Publisher metadata, when present.
          • update_time: Last content update time (epoch milliseconds or a date string).
      • createdAt / updatedAt: Record timestamps.
  • total: Total number of wallpapers for the device.

This endpoint is useful for:

  • Building a wallpaper gallery with paging.
  • Offering desktop and phone wallpaper downloads.
  • Tracking newly published artwork.
Example response 
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_id": "6aa8c56cc5792903680baff5",
        "caption": "062_kaja_skin00_\u58c1\u7eb83",
        "configId": 144237,
        "createdAt": 1789445484579,
        "createdUser": "keiralin",
        "data": {
          "_object": 3254983,
          "channel": [
            {
              "_object": 2677469,
              "id": 3255313,
              "parent": {
                "_object": 2677469,
                "id": 3255311
              },
              "sort": 1,
              "title": "Wallpaper"
            }
          ],
          "heroid": [
            111,
            59
          ],
          "pictures": [
            {
              "md5": "b204f61d508825f758a02bfb8ddb01d9",
              "resolution": "1920x1080",
              "url": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fb204f61d508825f758a02bfb8ddb01d9.jpg"
            },
            {
              "md5": "32de04e29c927e5cabf2eaaefc05e94a",
              "resolution": "2560x1440",
              "url": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2F32de04e29c927e5cabf2eaaefc05e94a.jpg"
            },
            {
              "md5": "dfbd033880bdd0dfbf12f250b8d8b1ca",
              "resolution": "1080x1920",
              "url": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fdfbd033880bdd0dfbf12f250b8d8b1ca.jpg"
            }
          ],
          "skinid": "\u9ed8\u8ba4",
          "update_time": 1786075207000
        },
        "id": 3503336,
        "linkId": [
          3254983,
          3255313
        ],
        "sort": 0,
        "updatedAt": 1789445923840,
        "updatedUser": "keiralin"
      }
    ],
    "total": 1143
  }
}
device · query

Target device: desktop (1920x1080) or mobile (1080x1920).

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/heroes/wallpapers

GET /api/heroes/{hero_identifier}

Hero Detail

Open on its own page

Get detailed information for a specific hero by ID or name. Supports query parameters for pagination and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • 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 details:

  • records: Array of hero entries, each containing:
      • _id: Unique record identifier.
      • caption: Caption or localized label.
      • configId: Configuration ID.
      • createdAt: Creation timestamp.
      • createdUser: Creator username.
      • data:
          • head: Hero portrait image URL.
          • head_big: Larger hero portrait image URL.
          • hero:
              • data:
                  • heroid: Hero ID.
                  • name: Hero name.
                  • story: Hero lore or background story.
                  • painting: Hero splash art image URL.
                  • speciality: Array of hero specialties (e.g., Support, Crowd Control).
                  • abilityshow: Array of ability stats.
                  • difficulty: Difficulty rating.
                  • heroskilllist: Array of skill sets, each containing:
                      • skilllist: Array of skills:
                          • skillid: Skill ID.
                          • skillname: Skill name.
                          • skilldesc: Skill description.
                          • skillicon: Skill icon URL.
                          • skillcd&cost: Cooldown and mana cost.
                          • skilltag: Array of tags:
                              • tagid: Tag ID.
                              • tagname: Tag name (e.g., Burst, CC).
                              • tagrgb: Tag color.
                          • skillvideo: Skill video URL (if available).
                  • roadsort: Lane assignment metadata:
                      • road_sort_id: Lane ID.
                      • road_sort_title: Lane title (e.g., Mid Lane).
                      • road_sort_icon: Lane icon URL.
                  • sortid: Role assignment metadata:
                      • sort_id: Role ID.
                      • sort_title: Role title (e.g., Mage).
                      • sort_icon: Role icon URL.
                  • smallmap: Hero smallmap image URL.
                  • squarehead: Square portrait image URL.
                  • squareheadbig: Larger square portrait image URL.
          • hero_id: Unique hero identifier.
          • relation:
              • assist:
                  • desc: Description of assist synergy.
                  • target_hero_id: Array of hero IDs assisted.
                  • target_hero: Array of assisted hero metadata (images).
              • strong:
                  • desc: Description of heroes countered.
                  • target_hero_id: Array of hero IDs countered.
                  • target_hero: Array of countered hero metadata (images).
              • weak:
                  • desc: Description of heroes that counter this hero.
                  • target_hero_id: Array of hero IDs that counter.
                  • target_hero: Array of counter hero metadata (images).
          • url: Official lore or profile URL.

This endpoint is useful for:

  • Displaying comprehensive hero profiles.
  • Analyzing hero abilities and skill tags.
  • Understanding hero synergies and counters.
  • Linking lane and role assignments to gameplay analysis.
Example response 
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_id": "65f2e280fd1bb8e47d25e07b",
        "caption": "096\u73de\u7fca",
        "configId": 144237,
        "createdAt": 1710416512439,
        "createdUser": "nickjin",
        "data": {
          "_object": 2667538,
          "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fcommunity%2F100_9dc55ccd4a972b721dfb8fadfb22fa34.png",
          "head_big": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Ffile%2Fmlbb%2Fhomepage%2F100_52c14752b29b6f9039da26a50e860c5c.jpg",
          "hero": {
            "_createdAt": 1724837697935,
            "_id": "66ceef41af5771f18c5009e1",
            "_updatedAt": 1773205501411,
            "data": {
              "abilityshow": [
                "20",
                "100",
                "40",
                "50"
              ],
              "difficulty": "50",
              "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_103541726507f5ce102689f04fe215e8.png",
              "heroid": 96,
              "heroskilllist": [
                {
                  "skilllist": [
                    {
                      "skillcd&cost": "",
                      "skilldesc": "Luo Yi's skills can create <font color=\"a6aafb\">Sigils of Yin/Yang</font> on the battlefield. Each Sigil lasts up to 6s.\nSigils of opposite attributes will trigger <font color=\"a6aafb\">Yin-Yang Reaction</font> when they are within a certain distance, dealing 300 (+25*Hero Level) <font color=\"62f8fe\">(+190% Total Magic Power)</font> <font color=\"7f62fe\">Magic Damage</font> to the marked enemies, stunning them for 0.3s, and pulling them toward each other.\nEach time Luo Yi applies a new Sigil to a marked enemy, she gains a 300 (+10*Hero Level) <font color=\"62f8fe\">(+150% Total Magic Power)</font> shield (up to 3 stacks) and 50% extra Movement Speed that decays over 2s.",
                      "skillicon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_55ccda55cadbf28d972b7878c6ed14fe.png",
                      "skillid": 9650,
                      "skillname": "Duality",
                      "skilltag": [
                        {
                          "tagid": 31,
                          "tagname": "Burst",
                          "tagrgb": "199,121,85"
                        },
                        {
                          "tagid": 21,
                          "tagname": "CC",
                          "tagrgb": "205,93,109"
                        }
                      ],
                      "skillvideo": ""
                    }
                  ],
                  "skilllistid": "961"
                }
              ],
              "name": "Luo Yi",
              "painting": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_e8f1e6dd0d7864b66bda10ef65242dd6.png",
              "recommendlevel": [
                "3",
                "1",
                "2"
              ],
              "recommendlevellabel": "3-1-2",
              "recommendmasterplan": [],
              "roadsort": [
                {
                  "_id": "66854225aa8e7f6ec4703d93",
                  "caption": "\u4e2d\u8def",
                  "configId": 144237,
                  "createdAt": 1720009253985,
                  "createdUser": "nickjin",
                  "data": {
                    "_object": 2732073,
                    "road_sort_icon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Ffacab1eacb218d767b5acb80304bfafd.svg",
                    "road_sort_id": "2",
                    "road_sort_title": "Mid Lane"
                  },
                  "id": 2732084,
                  "linkId": [
                    2732073
                  ],
                  "sort": 0,
                  "updatedAt": 1723022943932,
                  "updatedUser": "nickjin"
                },
                ""
              ],
              "roadsorticon1": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_1b414d1631fc57199315b998064c6722.png",
              "roadsorticon2": "",
              "roadsortlabel": [
                "Mid Lane",
                ""
              ],
              "smallmap": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_74fe63bd31cc092aed923543a115b7bd.png",
              "sorticon1": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_50fbe091cc66ff01cef0fa6b82872510.png",
              "sorticon2": "",
              "sortid": [
                {
                  "_id": "6698c015613093b976b4a974",
                  "caption": "4\u6cd5\u5e08",
                  "configId": 144237,
                  "createdAt": 1721286677393,
                  "createdUser": "nickjin",
                  "data": {
                    "_object": 2740651,
                    "sort_icon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2F1c6985dd0caec2028ccb6d1b8ca95e0f.png",
                    "sort_id": "4",
                    "sort_title": "mage"
                  },
                  "id": 2740663,
                  "linkId": [
                    2740651
                  ],
                  "sort": 0,
                  "updatedAt": 1723023128824,
                  "updatedUser": "nickjin"
                },
                ""
              ],
              "sortlabel": [
                "Mage",
                ""
              ],
              "speciality": [
                "Support",
                "Crowd Control"
              ],
              "squarehead": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Ffile%2Fmlbb%2Fhomepage%2F100_45ed52f05d2288e0c87ca858d7f66f23.jpg",
              "squareheadbig": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Ffile%2Fmlbb%2Fhomepage%2F100_52c14752b29b6f9039da26a50e860c5c.jpg",
              "story": "Seeking to revive an ancient past, she is the sole being who has mastered the secrets of Yin and Yang.",
              "tale": ""
            },
            "id": 100465,
            "sourceId": 2756563
          },
          "hero_id": 96,
          "relation": {
            "assist": {
              "desc": "Luo Yi works best with Junglers who are often looking for fights around the map, such as Aamon and Karina, because she can use her Ultimate to cut down their travel time.",
              "target_hero": [
                {
                  "data": {
                    "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_b3a7602fe7ffd1e54bf8ea79ceadfa72.png"
                  }
                }
              ],
              "target_hero_id": [
                109,
                8,
                0
              ]
            },
            "strong": {
              "desc": "Luo Yi counters heroes with low mobility such as Eudora and Gord because they are easy targets for her Sigils and Yin-Yang Reactions.",
              "target_hero": [
                {
                  "data": {
                    "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage_2_1_42%2F100_87b2a655b254c136dce8976e21935a80.png"
                  }
                }
              ],
              "target_hero_id": [
                15,
                23,
                0,
                0
              ]
            },
            "weak": {
              "desc": "Luo Yi is countered by Fighters or Tanks with high HP recovery like Uranus and Fredrinn because she can't deal enough damage to finish them off quickly.",
              "target_hero": [
                {
                  "data": {
                    "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_2e15a0a506aaecd9b3de40a8cc9f7ec7.png"
                  }
                }
              ],
              "target_hero_id": [
                59,
                117,
                0,
                0
              ]
            }
          },
          "url": "https://play.mobilelegends.com/lore/hero/LuoYi"
        },
        "id": 2678832,
        "linkId": [
          2667538
        ],
        "sort": 0,
        "updatedAt": 1726805352355,
        "updatedUser": "nickjin"
      }
    ],
    "total": 1
  }
}
hero_identifier · path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Name matching ignores spaces/symbols and is case-insensitive (e.g., Luo Yi to luoyi).

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/heroes/{hero_identifier}

GET /api/heroes/{hero_identifier}/stats

Hero Detail Statistics

Open on its own page

Get detailed statistics for a specific hero by ID or name. Supports query parameters for rank tier, pagination, and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • rank: Rank filter. Allowed values: all, epic, legend, mythic, honor, glory.
  • 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 statistics:

  • records: Array of hero entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • main_hero:
              • data:
                  • head: Hero portrait image URL.
                  • name: Hero name.
          • main_heroid: Hero ID.
          • 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 synergy heroes, each containing:
              • heroid: Sub-hero ID.
              • hero_win_rate: Sub-hero win rate.
              • hero_appearance_rate: Sub-hero pick rate.
              • increase_win_rate: Impact of sub-hero on win rate.
              • hero_channel:
                  • id: Channel ID reference.
              • hero:
                  • data:
                      • head: Sub-hero portrait image URL.
              • min_win_rate6: Win rate in matches ≤ 6 minutes, (min_win_rate6*100%).
              • min_win_rate6_8: Win rate in matches 6-8 minutes, (min_win_rate6_8*100%).
              • min_win_rate8_10: Win rate in matches 8-10 minutes, (min_win_rate8_10*100%).
              • min_win_rate10_12: Win rate in matches 10-12 minutes, (min_win_rate10_12*100%).
              • min_win_rate12_14: Win rate in matches 12-14 minutes, (min_win_rate12_14*100%).
              • min_win_rate14_16: Win rate in matches 14-16 minutes, (min_win_rate14_16*100%).
              • min_win_rate16_18: Win rate in matches 16-18 minutes, (min_win_rate16_18*100%).
              • min_win_rate18_20: Win rate in matches 18-20 minutes, (min_win_rate18_20*100%).
              • min_win_rate20: Win rate in matches ≥ 20 minutes, (min_win_rate20*100%).
          • sub_hero_last: Array of negative synergy heroes, each containing:
              • heroid: Sub-hero ID.
              • hero_win_rate: Sub-hero win rate.
              • hero_appearance_rate: Sub-hero pick rate.
              • increase_win_rate: Negative impact on win rate.
              • min_win_rate6 through min_win_rate20: Win rate breakdown across match durations.

This endpoint is useful for:

  • Analyzing hero performance trends across different ranks.
  • Tracking pick, ban, and win rates.
  • Understanding synergy with other heroes.
  • Identifying counters and negative synergies across match durations.
Example response 
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1724837698515,
        "_id": "66ceef43af5771f18c501841",
        "_updatedAt": 1774970102297,
        "data": {
          "bigrank": "101",
          "camp_type": "1",
          "main_hero": {
            "data": {
              "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_da894b37bfb5cadb32307f371f31918a.png",
              "name": "Miya"
            }
          },
          "main_hero_appearance_rate": 0.024029,
          "main_hero_ban_rate": 0.030362,
          "main_hero_channel": {
            "id": 2667597
          },
          "main_hero_win_rate": 0.501098,
          "main_heroid": 1,
          "match_type": "1",
          "sub_hero": [
            {
              "hero": {
                "data": {
                  "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage_1_9_642%2F100_c472fe0233e5ef84a3ac9ba4a229d09f.png"
                }
              },
              "hero_appearance_rate": 0.005875,
              "hero_channel": {
                "id": 2678840
              },
              "hero_index": 1,
              "hero_win_rate": 0.559063,
              "heroid": 104,
              "increase_win_rate": 0.023307,
              "min_win_rate10_12": 0.597996,
              "min_win_rate12_14": 0.587859,
              "min_win_rate14_16": 0.588737,
              "min_win_rate16_18": 0.586709,
              "min_win_rate18_20": 0.588967,
              "min_win_rate20": 0.565267,
              "min_win_rate6": 1,
              "min_win_rate6_8": 0.481586,
              "min_win_rate8_10": 0.519894
            }
          ],
          "sub_hero_last": [
            {
              "hero_appearance_rate": 0.001634,
              "hero_index": 1,
              "hero_win_rate": 0.473376,
              "heroid": 89,
              "increase_win_rate": -0.088744,
              "min_win_rate10_12": 0.356784,
              "min_win_rate12_14": 0.345992,
              "min_win_rate14_16": 0.348178,
              "min_win_rate16_18": 0.433333,
              "min_win_rate18_20": 0.505051,
              "min_win_rate20": 0.50289,
              "min_win_rate6": 1,
              "min_win_rate6_8": 0.1,
              "min_win_rate8_10": 0.18
            }
          ]
        },
        "id": 103638,
        "sourceId": 2756567
      }
    ],
    "total": 1
  }
}
hero_identifier · path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Name matching ignores spaces/symbols and is case-insensitive (e.g., Luo Yi to luoyi).

rank · query

Rank filter for hero statistics.

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/heroes/{hero_identifier}/stats

GET /api/heroes/{hero_identifier}/skill-combos

Hero Skill Combos

Open on its own page

Get the most effective skill combos for a specific hero by ID or name. Supports query parameters for pagination and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • 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 skill combo details:

  • records: Array of combo entries, each containing:
      • _id: Unique record identifier.
      • caption: Caption or localized label (e.g., laning, teamfight).
      • configId: Configuration ID.
      • createdAt: Creation timestamp.
      • createdUser: Creator username.
      • data:
          • hero_id: Hero ID.
          • title: Combo title (e.g., 'TEAMFIGHT COMBOS').
          • desc: Descriptive instructions on how to execute the combo (e.g., laning phase or teamfight scenarios).
          • skill_id: Array of skills in recommended sequence, each containing:
              • skillid: Skill ID.
              • skillicon: Skill icon URL.
              • _id, _createdAt, _updatedAt: Metadata fields.
      • updatedAt: Last update timestamp.
      • updatedUser: Last updater username.

This endpoint is useful for:

  • Guiding players on optimal skill usage patterns.
  • Teaching effective combos for laning and teamfight scenarios.
  • Helping maximize hero performance in different situations.
Example response 
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_id": "661fffbc17071f48448b1f76",
        "caption": "\u5f25\u4e9a",
        "configId": 144237,
        "createdAt": 1713373116184,
        "createdUser": "rubickguo",
        "data": {
          "_object": 2684183,
          "desc": "In teamfights, use Miya's Ultimate first to conceal herself, then find an ideal position to attack the enemy and quickly stack her Passive. Utilize her 2nd Skill to immobilize the enemy and activate her 1st Skill to enhance her Basic Attacks to hit multiple targets at once.",
          "hero_id": 1,
          "skill_id": [
            {
              "_createdAt": 1730960697288,
              "_id": "672c5d399d856a6db37d936a",
              "_updatedAt": 1758787887535,
              "data": {
                "skillicon": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_361546d795e6df7029a1cf1252e57ac8.png",
                "skillid": 130
              },
              "id": 109690,
              "sourceId": 2674712
            }
          ],
          "title": "TEAMFIGHT COMBOS"
        },
        "id": 2694856,
        "linkId": [
          2684183
        ],
        "sort": 0,
        "updatedAt": 1713373219943,
        "updatedUser": "rubickguo"
      }
    ],
    "total": 2
  }
}
hero_identifier · path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Name matching ignores spaces/symbols and is case-insensitive (e.g., Luo Yi to luoyi).

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/heroes/{hero_identifier}/skill-combos

GET /api/heroes/{hero_identifier}/wallpapers

Hero Wallpapers

Open on its own page

Get official wallpapers for a specific hero by ID or name, for desktop or mobile screens. Supports query parameters for device, pagination, and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 133, Hirara, or hirara.

Query parameters:

  • device: Target device: desktop (landscape, 1920x1080) or mobile (portrait, 1080x1920). Default: desktop.
  • 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 wallpaper details:

  • records: Array of wallpaper entries, each containing:
      • _id: Unique record identifier.
      • caption: Internal wallpaper caption.
      • configId: Configuration ID.
      • createdAt: Creation timestamp.
      • createdUser: Creator username.
      • data:
          • heroid: Array of hero IDs shown in the wallpaper (all heroes for event artwork).
          • pictures: Array of image variants, each with resolution, url, and md5. Records may carry more resolutions than the requested device (e.g., 2560x1440 or 1080x2400).
          • skinid: Skin label associated with the wallpaper.
          • channel: Wallpaper channel metadata.
          • update_time: Last content update time.
      • updatedAt: Last update timestamp.
      • updatedUser: Last updater username.
  • total: Total number of matching wallpapers.

This endpoint is useful for:

  • Building hero galleries and fan sites.
  • Offering desktop and phone wallpaper downloads.
  • Showcasing hero artwork in apps and dashboards.
Example response 
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_id": "6a916bf0ccf5de989be67a72",
        "caption": "133_hirara_\u58c1\u7eb81",
        "configId": 144237,
        "createdAt": 1787915248833,
        "createdUser": "v_zhoujie",
        "data": {
          "_object": 3254983,
          "channel": [
            {
              "_object": 2677469,
              "id": 3255313,
              "parent": {
                "_object": 2677469,
                "id": 3255311
              },
              "sort": 1,
              "title": "Wallpaper"
            }
          ],
          "heroid": [
            133
          ],
          "pictures": [
            {
              "md5": "a8ab2694c67a5eb081d4cd19d727e4b3",
              "resolution": "1920x1080",
              "url": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fa8ab2694c67a5eb081d4cd19d727e4b3.jpg"
            },
            {
              "md5": "bbf9cd2d3e8fa721f98e2084f9160bd7",
              "resolution": "2560x1440",
              "url": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fbbf9cd2d3e8fa721f98e2084f9160bd7.jpg"
            }
          ],
          "skinid": "\u58c1\u7eb81",
          "update_time": "2026-06-24 20:10:04"
        },
        "id": 3497973,
        "linkId": [
          3254983,
          3255313
        ],
        "sort": 0,
        "updatedAt": 1787915248833,
        "updatedUser": "v_zhoujie"
      }
    ],
    "total": 6
  }
}
hero_identifier · path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Name matching ignores spaces/symbols and is case-insensitive (e.g., Luo Yi to luoyi).

device · query

Target device: desktop (1920x1080) or mobile (1080x1920).

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/heroes/{hero_identifier}/wallpapers

GET /api/heroes/{hero_identifier}/trends

Hero Performance Trends

Open on its own page

Get rate trends for a specific hero by ID or name over a specified time window. Supports query parameters for rank tier, past days window, pagination, and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • rank: Rank filter. Allowed values: all, epic, legend, mythic, honor, glory.
  • past-days: Rate window in days. Allowed values: 7, 15, 30.
  • 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 rate trend data:

  • records: Array of hero entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • main_heroid: Hero ID.
          • bigrank: Rank tier identifier.
          • camp_type: Camp type indicator.
          • match_type: Match type indicator.
          • win_rate: Array of daily statistics, each containing:
              • date: Date of record.
              • app_rate: Appearance rate (pick frequency).
              • ban_rate: Ban rate.
              • win_rate: Win rate.

This endpoint is useful for:

  • Tracking hero performance trends over time.
  • Monitoring hero popularity and ban frequency.
  • Comparing win rates across different ranks and time periods.
Example response 
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1719822297335,
        "_id": "668267db061f5179ffb909ac",
        "_updatedAt": 1774965307951,
        "data": {
          "bigrank": "101",
          "camp_type": "1",
          "main_heroid": 17,
          "match_type": "1",
          "win_rate": [
            {
              "app_rate": 0.00695,
              "ban_rate": 0.045781,
              "date": "2026-03-30",
              "win_rate": 0.439798
            }
          ]
        },
        "id": 158321,
        "sourceId": 2674709
      }
    ],
    "total": 1
  }
}
hero_identifier · path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Name matching ignores spaces/symbols and is case-insensitive (e.g., Luo Yi to luoyi).

rank · query

Rank filter for hero statistics.

past-days · query

Rate window in days.

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/heroes/{hero_identifier}/trends

GET /api/heroes/{hero_identifier}/relations

Hero Relations

Open on its own page

Get information about the relations of a specific hero by ID or name. Supports query parameters for pagination and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • 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 relation data:

  • records: Array of hero entries, each containing:
      • data:
          • hero:
              • data:
                  • name: Hero name.
          • hero_id: Unique hero identifier.
          • relation:
              • assist:
                  • target_hero_id: Array of hero IDs that synergize well.
              • strong:
                  • target_hero_id: Array of hero IDs that are countered.
              • weak:
                  • target_hero_id: Array of hero IDs that counter this hero.

This endpoint is useful for:

  • Understanding hero synergies (assist).
  • Identifying heroes that are countered (strong).
  • Recognizing heroes that counter the selected hero (weak).
  • Building balanced team compositions.
Example response 
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "data": {
          "hero": {
            "data": {
              "name": "Miya"
            }
          },
          "hero_id": 1,
          "relation": {
            "assist": {
              "target_hero_id": [
                6,
                70,
                0
              ]
            },
            "strong": {
              "target_hero_id": [
                3,
                15,
                27
              ]
            },
            "weak": {
              "target_hero_id": [
                52,
                101,
                0
              ]
            }
          }
        }
      }
    ],
    "total": 1
  }
}
hero_identifier · path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Name matching ignores spaces/symbols and is case-insensitive (e.g., Luo Yi to luoyi).

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/heroes/{hero_identifier}/relations

GET /api/heroes/{hero_identifier}/counters

Hero Counters

Open on its own page

Get information about heroes that counter a specific hero by ID or name. Supports query parameters for rank tier, pagination, and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • days: Time window for counter data. Allowed values: 1, 3, 7, 15, 30.
  • rank: Rank filter. Allowed values: all, epic, legend, mythic, honor, glory.
  • 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 counter data:

  • records: Array of hero entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • main_hero:
              • data:
                  • head: Main hero portrait image URL.
                  • name: Main hero name.
          • main_heroid: Main hero ID.
          • main_hero_channel:
              • id: Channel ID reference.
          • main_hero_appearance_rate: Pick rate of the main hero.
          • main_hero_ban_rate: Ban rate of the main hero.
          • main_hero_win_rate: Win rate of the main hero.
          • sub_hero: Array of counter heroes, each containing:
              • heroid: Counter hero ID.
              • hero_win_rate: Counter hero win rate.
              • hero_appearance_rate: Counter hero pick rate.
              • increase_win_rate: Impact of counter hero on win rate.
              • hero_channel:
                  • id: Channel ID reference.
              • hero:
                  • data:
                      • head: Counter hero portrait image URL.
              • min_win_rate6 through min_win_rate20: Win rate breakdown across match durations.
          • sub_hero_last: Array of negative synergy heroes, each containing:
              • heroid: Sub-hero ID.
              • hero_win_rate: Sub-hero win rate.
              • hero_appearance_rate: Sub-hero pick rate.
              • increase_win_rate: Negative impact on win rate.
              • min_win_rate6 through min_win_rate20: Win rate breakdown across match durations.

This endpoint is useful for:

  • Identifying which heroes are effective counters.
  • Analyzing matchup dynamics.
  • Understanding performance trends across different ranks and match durations.
Example response 
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1724837698334,
        "_id": "66ceef42af5771f18c500da2",
        "_updatedAt": 1774890906262,
        "data": {
          "bigrank": "9",
          "camp_type": "0",
          "main_hero": {
            "data": {
              "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_3391df36d6dcc54dd1c417098e15ec59.png",
              "name": "Fanny"
            }
          },
          "main_hero_appearance_rate": 0.009896,
          "main_hero_ban_rate": 0.073593,
          "main_hero_channel": {
            "id": 2678753
          },
          "main_hero_win_rate": 0.458363,
          "main_heroid": 17,
          "match_type": "0",
          "sub_hero": [
            {
              "hero": {
                "data": {
                  "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_474cea36a4bfdc7bf7d94530853a99b2.png"
                }
              },
              "hero_appearance_rate": 0.002274,
              "hero_channel": {
                "id": 2678756
              },
              "hero_index": 1,
              "hero_win_rate": 0.553658,
              "heroid": 20,
              "increase_win_rate": 0.048121,
              "min_win_rate10_12": 0.452088,
              "min_win_rate12_14": 0.439306,
              "min_win_rate14_16": 0.426901,
              "min_win_rate16_18": 0.493865,
              "min_win_rate18_20": 0.465217,
              "min_win_rate20": 0.486553,
              "min_win_rate6": 0.333333,
              "min_win_rate6_8": 0.5,
              "min_win_rate8_10": 0.355263
            }
          ],
          "sub_hero_last": [
            {
              "hero": {
                "data": {
                  "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_ff39deb9c6afec3d977fdbe9d86f78cb.png"
                }
              },
              "hero_appearance_rate": 0.002147,
              "hero_channel": {
                "id": 2678748
              },
              "hero_index": 1,
              "hero_win_rate": 0.476658,
              "heroid": 12,
              "increase_win_rate": -0.045228,
              "min_win_rate10_12": 0.384454,
              "min_win_rate12_14": 0.456767,
              "min_win_rate14_16": 0.435701,
              "min_win_rate16_18": 0.459155,
              "min_win_rate18_20": 0.420792,
              "min_win_rate20": 0.450402,
              "min_win_rate6": 1,
              "min_win_rate6_8": 0.315789,
              "min_win_rate8_10": 0.5
            }
          ]
        },
        "id": 103076,
        "sourceId": 2756569
      }
    ],
    "total": 1
  }
}
hero_identifier · path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Name matching ignores spaces/symbols and is case-insensitive (e.g., Luo Yi to luoyi).

days · query

Past day window for rank statistics.

rank · query

Rank filter for hero statistics.

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/heroes/{hero_identifier}/counters

GET /api/heroes/{hero_identifier}/compatibility

Hero Compatibility

Open on its own page

Get compatibility information for a specific hero by ID or name. Supports query parameters for rank tier, pagination, and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • days: Time window for compatibility data. Allowed values: 1, 3, 7, 15, 30.
  • rank: Rank filter. Allowed values: all, epic, legend, mythic, honor, glory.
  • 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 compatibility data:

  • records: Array of hero entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • main_hero:
              • data:
                  • head: Main hero portrait image URL.
                  • name: Main hero name.
          • main_heroid: Main hero ID.
          • main_hero_channel:
              • id: Channel ID reference.
          • main_hero_appearance_rate: Pick rate of the main hero.
          • main_hero_ban_rate: Ban rate of the main hero.
          • main_hero_win_rate: Win rate of the main hero.
          • sub_hero: Array of compatible heroes, each containing:
              • heroid: Compatible hero ID.
              • hero_win_rate: Compatible hero win rate.
              • hero_appearance_rate: Compatible hero pick rate.
              • increase_win_rate: Positive synergy impact on win rate.
              • hero_channel:
                  • id: Channel ID reference.
              • hero:
                  • data:
                      • head: Compatible hero portrait image URL.
              • min_win_rate6 through min_win_rate20: Win rate breakdown across match durations.
          • sub_hero_last: Array of negative synergy heroes, each containing:
              • heroid: Sub-hero ID.
              • hero_win_rate: Sub-hero win rate.
              • hero_appearance_rate: Sub-hero pick rate.
              • increase_win_rate: Negative impact on win rate.
              • min_win_rate6 through min_win_rate20: Win rate breakdown across match durations.

This endpoint is useful for:

  • Identifying which heroes pair well with the selected hero.
  • Analyzing synergy and team composition effectiveness.
  • Recognizing combinations that reduce performance.
  • Understanding matchup dynamics across ranks and match durations.
Example response 
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1724837698334,
        "_id": "66ceef42af5771f18c500d18",
        "_updatedAt": 1774890906262,
        "data": {
          "bigrank": "9",
          "camp_type": "1",
          "main_hero": {
            "data": {
              "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_3391df36d6dcc54dd1c417098e15ec59.png",
              "name": "Fanny"
            }
          },
          "main_hero_appearance_rate": 0.009896,
          "main_hero_ban_rate": 0.073593,
          "main_hero_channel": {
            "id": 2678753
          },
          "main_hero_win_rate": 0.458363,
          "main_heroid": 17,
          "match_type": "1",
          "sub_hero": [
            {
              "hero": {
                "data": {
                  "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_6495be044c2d28106e200f6918391d54.png"
                }
              },
              "hero_appearance_rate": 0.001064,
              "hero_channel": {
                "id": 2678835
              },
              "hero_index": 1,
              "hero_win_rate": 0.487066,
              "heroid": 99,
              "increase_win_rate": 0.080441,
              "min_win_rate10_12": 0.536232,
              "min_win_rate12_14": 0.616162,
              "min_win_rate14_16": 0.483333,
              "min_win_rate16_18": 0.534247,
              "min_win_rate18_20": 0.469388,
              "min_win_rate20": 0.525424,
              "min_win_rate6": 0,
              "min_win_rate6_8": 0,
              "min_win_rate8_10": 0.363636
            }
          ],
          "sub_hero_last": [
            {
              "hero": {
                "data": {
                  "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage_1_9_47%2F100_d2d28d2fcb060726fa27553920ca1a33.png"
                }
              },
              "hero_appearance_rate": 0.003218,
              "hero_channel": {
                "id": 2678805
              },
              "hero_index": 1,
              "hero_win_rate": 0.447087,
              "heroid": 69,
              "increase_win_rate": -0.125309,
              "min_win_rate10_12": 0.096154,
              "min_win_rate12_14": 0.22973,
              "min_win_rate14_16": 0.25,
              "min_win_rate16_18": 0.342857,
              "min_win_rate18_20": 0.526316,
              "min_win_rate20": 0.531915,
              "min_win_rate6": 0,
              "min_win_rate6_8": 0,
              "min_win_rate8_10": 0.0625
            }
          ]
        },
        "id": 102938,
        "sourceId": 2756569
      }
    ],
    "total": 1
  }
}
hero_identifier · path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Name matching ignores spaces/symbols and is case-insensitive (e.g., Luo Yi to luoyi).

days · query

Past day window for rank statistics.

rank · query

Rank filter for hero statistics.

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/heroes/{hero_identifier}/compatibility