# Mlbb (British Indian Ocean Territory) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access real-time Mobile Legends hero statistics, tier rankings, optimal builds, and emblem recommendations to make informed gameplay decisions. Search for specific heroes and view comprehensive data including item lists and competitive tier placements to optimize your strategy.

**Category:** Sports | **Website:** [mlbb.io/](https://mlbb.io/) | **Docs:** [parse.bot/marketplace/879b30c0-0d94-42ed-b8c3-627077b98d25/mlbb-io-api](https://parse.bot/marketplace/879b30c0-0d94-42ed-b8c3-627077b98d25/mlbb-io-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-mlbb-io-api-879b30c0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_emblem_list

Retrieve the list of all main emblems (with attributes) and ability emblems (with benefits, descriptions, and cooldowns). Main emblems provide base stat bonuses while ability emblems grant unique passive effects.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mlbb-io-api-879b30c0/get_emblem_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_hero_builds

Get community-created item builds for a specific hero. Returns builds with item IDs, emblem selections, battle spells, and user descriptions sorted by popularity.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `hero_name` | string | Yes | Hero name (case sensitive, e.g. Gloo, Layla, Harley). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mlbb-io-api-879b30c0/get_hero_builds \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hero_name":"<string>"}'
```

### get_hero_overview

Retrieve full overview for a specific hero including statistics across ranks and timeframes, counter matchups, heroes weak against, synergies, and skill descriptions with scaling data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `hero_name` | string | Yes | Hero name (case sensitive, e.g. Gloo, Layla, Harley). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mlbb-io-api-879b30c0/get_hero_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hero_name":"<string>"}'
```

### get_hero_statistics

Retrieve hero performance statistics (win rate, pick rate, ban rate) for all heroes filtered by rank and timeframe. Returns one entry per hero for the selected rank/timeframe combination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `rank_id` | integer | No | Rank filter ID. 1=All, 2=Mythic, 3=Legend, 4=Epic. |
| `timeframe_id` | integer | No | Timeframe filter ID. 1=Past 1 day, 2=Past 3 days, 3=Past 7 days. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mlbb-io-api-879b30c0/get_hero_statistics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rank_id":"<integer>","timeframe_id":"<integer>"}'
```

### get_hero_tier_list

Retrieve the full hero tier list ranked by tier (SS through D). Supports filtering by role and lane. Returns all heroes with their scores, roles, lanes, and tier rankings. The list is pre-sorted by tier priority then score descending.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lane` | string | No | Filter by lane. Accepted values: Exp Lane, Gold Lane, Mid Lane, Roam, Jungle. |
| `role` | string | No | Filter by role. Accepted values: Tank, Fighter, Mage, Assassin, Marksman, Support. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mlbb-io-api-879b30c0/get_hero_tier_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lane":"<string>","role":"<string>"}'
```

### get_item_list

Retrieve the complete list of all purchasable game items (~89 items) in a single response. Each item includes stats (physical attack, magic power, HP, defenses, etc.), passive abilities, pricing, category, and availability information.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mlbb-io-api-879b30c0/get_item_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_top_heroes

Get all heroes from the tier list sorted by score descending (strongest first). Use the SDK limit parameter to control how many heroes are returned.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mlbb-io-api-879b30c0/get_top_heroes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_heroes

Search for heroes by name keyword. Returns matching heroes with their basic info including roles, lanes, and tier. The search is case-insensitive and matches partial names.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against hero names. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mlbb-io-api-879b30c0/search_heroes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```