MLBB API Web v4.0.8
MLBB Card Install OpenMLBB Tutorial GitHub Stars
Home User MLBB Academy Addon

OpenMLBB SDK Docs

OpenMLBB Endpoint

SDK call mapping, request requirements, and Python example.

Every card documents the SDK call from OpenMLBB and mirrors API path/query/body requirements.

Jump to SDK endpoint

GET /openmlbb/academy/meta/version GET /openmlbb/academy/heroes/catalog GET /openmlbb/academy/roles GET /openmlbb/academy/equipment GET /openmlbb/academy/equipment/expanded GET /openmlbb/academy/spells GET /openmlbb/academy/emblems GET /openmlbb/academy/ranks GET /openmlbb/academy/ranks/{rank_id} GET /openmlbb/academy/recommended GET /openmlbb/academy/recommended/{recommended_id} GET /openmlbb/academy/heroes GET /openmlbb/academy/heroes/{hero_identifier}/stats GET /openmlbb/academy/heroes/{hero_identifier}/lane GET /openmlbb/academy/heroes/{hero_identifier}/win-rate/timeline GET /openmlbb/academy/heroes/{hero_identifier}/builds GET /openmlbb/academy/heroes/{hero_identifier}/counters GET /openmlbb/academy/heroes/{hero_identifier}/teammates GET /openmlbb/academy/heroes/{hero_identifier}/trends GET /openmlbb/academy/heroes/{hero_identifier}/recommended GET /openmlbb/academy/heroes/ratings GET /openmlbb/academy/heroes/ratings/{subject}

GET Emblems

/openmlbb/academy/emblems

Open Only This

API Path: /api/academy/emblems

List all emblems with details. Supports query parameters for pagination and localization.

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 emblem data:

  • records: Array of emblem entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • giftid: Emblem ID.
          • gifttiers: Emblem tier level.
          • emblemskill: Associated skill details:
              • skillid: Skill ID.
              • skillid_lv: Skill ID with level reference.
              • skillname: Skill name (e.g., 'Weapons Master').
              • skillicon: Skill icon URL.
              • skilldesc: Full description of skill effects.
              • skilldesc_text: Template-based description with placeholders.
              • skilldescemblem: Emblem-specific description.
              • numdescribe: Numeric effect values (e.g., '5%').
      • id: Internal record ID.
      • sourceId: Source reference ID.

This endpoint is useful for:

  • Displaying the full emblem catalog.
  • Explaining emblem effects and associated skills.
  • Guiding players in emblem selection and optimization.

Python Example

from OpenMLBB import OpenMLBB

client = OpenMLBB()
response = client.academy.emblems(size=20, index=1, lang="en")
print(response)

Path and Query Parameters

Name In Type Required Default
size query integer no 20
index query integer no 1
lang query string no en