# Mabucket — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/mabucket/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/mabucket/get-hero-tier-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"class":"<string>","faction":"<string>","rarity":"<string>","search":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.