# Wynncraft — 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 detailed Wynncraft game information to look up item metadata and search across the complete item database, retrieve player statistics and character inventories, and browse guild information and global search results. Use this data to compare gear, track player progress, analyze guild rosters, or build tools for the Wynncraft community.

**Category:** Entertainment | **Website:** [wynncraft.com/](https://wynncraft.com/) | **Docs:** [parse.bot/marketplace/bfab0ae5-e080-4872-83be-6be33d44b6cc/wynncraft-com-api](https://parse.bot/marketplace/bfab0ae5-e080-4872-83be-6be33d44b6cc/wynncraft-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-wynncraft-com-api-bfab0ae5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_guild_stats

Returns statistics and member list for a guild. Includes level, wars, territories, season ranks, banner, and members organized by rank (owner, chief, strategist, captain, recruiter, recruit). Each member entry has UUID, online status, contributed XP, joined date, and globalData.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `guild_name` | string | Yes | Guild name (case-insensitive). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wynncraft-com-api-bfab0ae5/get_guild_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"guild_name":"<string>"}'
```

### get_item_database_full

Returns the full item database by iterating all pages. May take up to ~60 seconds to complete.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wynncraft-com-api-bfab0ae5/get_item_database_full \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_item_database_paginated

Returns a paginated list of items from the database. Each page contains 20 items. Pagination metadata is in controller (count, pages, current, next, prev). Items include displayName, type, subType, tier, identifications, base stats, and requirements.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-indexed). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wynncraft-com-api-bfab0ae5/get_item_database_paginated \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_item_metadata

Returns metadata for item filters and identifications. Includes possible values for types, tiers, attack speeds, identification stat names, major IDs, and level ranges.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wynncraft-com-api-bfab0ae5/get_item_metadata \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_player_characters

Returns all characters for a player as a list. Each character includes uuid, type (WARRIOR, ARCHER, MAGE, ASSASSIN, SHAMAN), level, xp, xpPercent, totalLevel, gamemode array, and optional reskin/nickname.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Player username (case-insensitive). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wynncraft-com-api-bfab0ae5/get_player_characters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_player_stats

Returns full statistics for a player by username. Includes online status, current server, guild membership, playtime hours, rank, and globalData containing wars, totalLevel, mobsKilled, chestsFound, dungeons, raids, pvp stats, and completedQuests.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Player username (case-insensitive). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wynncraft-com-api-bfab0ae5/get_player_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### global_search

Global search across players, guilds, and items by query string. Returns matching results organized by type: players (UUID-to-object map), guilds (UUID-to-object map with name/prefix/level/members), guildsPrefix (guilds matched by tag), and items (array of item objects).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query string. |

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

### search_items

Search for items using complex filters. Returns paginated results (20 per page). Filter keys include type (array of: weapon, armour, accessory), tier (array of: common, unique, rare, legendary, fabled, mythic, set), and other item properties. If no items match the criteria, the upstream API returns a 404.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filters` | string | No | JSON string of filter criteria. Supported keys include type (array of: weapon, armour, accessory), tier (array of: common, unique, rare, legendary, fabled, mythic, set), and other item properties. |
| `page` | integer | No | Page number (1-indexed). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-wynncraft-com-api-bfab0ae5/search_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filters":"<string>","page":"<integer>"}'
```