# Mabucket — 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.

> Discover current hero tier list ratings and detailed metadata for Watcher of Realms to build your optimal team composition. Compare hero rankings from MaBucket's expert community assessments and make informed decisions about which characters to prioritize in your gameplay.

**Category:** Entertainment | **Website:** [mabucket.com/tier-lists/heroes](https://mabucket.com/tier-lists/heroes) | **Docs:** [parse.bot/marketplace/0ec1c0dd-3de0-45f5-a362-338212111246/mabucket-com-api](https://parse.bot/marketplace/0ec1c0dd-3de0-45f5-a362-338212111246/mabucket-com-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-mabucket-com-api-0ec1c0dd/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_hero_tier_list

Returns all heroes with their tier ratings across 16 game modes and metadata (rarity, class, faction). Optionally filter by hero name search, rarity, class, or faction. Returns the complete list when no filters are applied. Each hero includes ratings for: overall, early, gear_raid_1, gear_raid_2, gear_raid_3, guild_boss, guild_war, void_rift, single_arena, aoe_arena, air_arena, sustain_arena, basic_trial, artifact, gold_exp, and tide.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `class` | string | No | Filter by hero class. Omitted returns all classes. |
| `faction` | string | No | Filter by faction name (case-insensitive). Heroes belonging to the specified faction are returned. Omitted returns all factions. |
| `rarity` | string | No | Filter by hero rarity. Omitted returns all rarities. |
| `search` | string | No | Case-insensitive substring search on hero name (e.g. 'elowyn', 'ajax'). Omitted returns all heroes. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mabucket-com-api-0ec1c0dd/get_hero_tier_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"class":"<string>","faction":"<string>","rarity":"<string>","search":"<string>"}'
```