# Pred — 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 all gaming assets from the Pred.gg platform including hero icons, ability icons, skin portraits, item icons, perk icons, and rank icons. Use these images to build gaming apps, guides, or community tools with official Pred.gg graphics.

**Category:** Entertainment | **Website:** [pred.gg/gql](https://pred.gg/gql) | **Docs:** [parse.bot/marketplace/7d714dfc-630c-406e-9efe-7d77a382eaac/pred-gg-api](https://parse.bot/marketplace/7d714dfc-630c-406e-9efe-7d77a382eaac/pred-gg-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/pred/`
**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 all images

Retrieve all deduplicated image URLs across heroes, items, perks, and ranks with metadata about their source category and field type. Makes multiple GraphQL calls internally to collect images from all entity types. Returns a flat list of unique image URLs with provenance metadata.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/pred/get-all-images \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get hero

Retrieve a single hero by slug with full ability details, skins, perks, roles, and classes. Returns the same hero shape as the list endpoint but for one specific hero identified by its URL slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Hero slug identifier as used in the URL path (e.g., 'feng-mao', 'grux', 'sparrow', 'narbash'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/pred/get-hero \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get heroes

Retrieve all heroes with their abilities, default skins, perks, roles, classes, and descriptions. Icon hashes are resolved to full image URLs. Returns the complete hero roster in a single request.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/pred/get-heroes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get item

Retrieve a single item by slug with full stats, effects, and build path details. Returns the same item shape as the list endpoint but for one specific item identified by its URL slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Item slug identifier as used in the URL path (e.g., 'soul-chalice', 'heroic-guard', 'demolisher'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/pred/get-item \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get items

Retrieve all items with stats, effects, build paths, pricing, rarity, and slot type. Hidden items are excluded by default unless show_hidden is set to true. Returns the full item catalog in a single request.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `show_hidden` | boolean | No | Include hidden/deprecated items in the results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/pred/get-items \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"show_hidden":"<boolean>"}'
```

### Get perks

Retrieve all hero perks with descriptions, slot info, and associated hero data. Each perk is linked to its owning hero. Returns the full perk catalog in a single request.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/pred/get-perks \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get ranks

Retrieve all rating seasons and their rank tiers (Bronze through Paragon) with rating thresholds and icons. Each season contains a full set of rank tiers with min/max rating boundaries.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/pred/get-ranks \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get versions

Retrieve all game patch versions with release dates, patch types, and patch notes URLs. Covers the full version history from early access through the current release.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/pred/get-versions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

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