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

> Search for in-game accounts and currency listings on Eldorado.gg, view seller profiles with reviews, and check offer details and pricing. Browse featured games, explore account inventories by game, and research seller history to make informed purchases on the marketplace.

**Category:** Marketplaces | **Website:** [eldorado.com/](https://eldorado.com/) | **Docs:** [parse.bot/marketplace/f9fc3c5a-c9c5-4a5a-bb98-0d4ad006a0f3/eldorado-com-api](https://parse.bot/marketplace/f9fc3c5a-c9c5-4a5a-bb98-0d4ad006a0f3/eldorado-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-eldorado-com-api-f9fc3c5a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_account_listings

Returns paginated seller listings for game accounts. Page size is 24 results per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | string | Yes | Game ID (e.g. '16' for Fortnite, '25' for GTA 5). |
| `page` | integer | No | Page index for pagination (1-based). |

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

### get_account_offer_detail

Returns full detail of a single Account or CustomItem offer, including seller info and similar offers. Only supports Account and CustomItem category offers; Currency offer IDs will return a not-found error. Use offer IDs from get_account_listings results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offer_id` | string | Yes | Offer ID (UUID format) from get_account_listings results. |

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

### get_boosting_listings

Returns paginated boosting service requests for a given game. Use get_game_page with category 'RequestedBoosting' to discover available trade environment filter values. Page size is 24 results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | string | Yes | Game ID (e.g. '132' for Diablo 4, '0' for World of Warcraft). |
| `page` | integer | No | Page index for pagination (1-based). |
| `te0` | string | No | Filter for top-level trade environment (e.g. Region). Available values from get_game_page with category 'RequestedBoosting'. |
| `te1` | string | No | Filter for second-level trade environment (e.g. Server). Available values from get_game_page. |
| `te2` | string | No | Filter for third-level trade environment (e.g. Faction). Available values from get_game_page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-eldorado-com-api-f9fc3c5a/get_boosting_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_id":"<string>","page":"<integer>","te0":"<string>","te1":"<string>","te2":"<string>"}'
```

### get_currency_listings

Returns paginated seller offers for in-game currency with optional trade environment filters. Use get_game_page with category 'Currency' to discover available filter values for te0, te1, and te2. Page size is 150 results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | string | Yes | Game ID from the library (e.g. '0' for World of Warcraft, '10' for OSRS). |
| `page` | integer | No | Page index for pagination (1-based). |
| `te0` | string | No | Filter for top-level trade environment, typically Region (e.g. 'EU', 'NA'). Available values from get_game_page tradeEnvironments. |
| `te1` | string | No | Filter for second-level trade environment, typically Server/Realm. Available values from get_game_page tradeEnvironments. |
| `te2` | string | No | Filter for third-level trade environment, typically Faction. Available values from get_game_page tradeEnvironments. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-eldorado-com-api-f9fc3c5a/get_currency_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_id":"<string>","page":"<integer>","te0":"<string>","te1":"<string>","te2":"<string>"}'
```

### get_game_page

Returns a game's landing page data including available trade environments (regions, servers, factions), attribute filters, and metadata. Trade environments may be deeply nested for Currency games (Region→Server→Faction) or flat for Account games (Device only).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category (e.g. 'Currency', 'Account', 'CustomItem', 'TopUp', 'RequestedBoosting', 'GiftCard'). |
| `game_id` | string | Yes | Game ID (e.g. '0' for World of Warcraft, '16' for Fortnite). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-eldorado-com-api-f9fc3c5a/get_game_page \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","game_id":"<string>"}'
```

### get_homepage_featured

Returns trending games and popular offers from the Eldorado.gg homepage. Popular games are sorted by popularGameSortOrder, trending games by trendingRatio descending. Up to 20 results per category.

**Estimated cost:** Metered

_No parameters required._

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

### get_seller_profile

Returns a seller's public profile summary and rating stats.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `user_id` | string | Yes | User ID of the seller (e.g. 'auth0\|60c56ad815589d0069348b4b' or 'google-oauth2\|110943613169310152913'). |

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

### get_seller_reviews

Returns paginated buyer reviews for a specific seller, filtered by category. Returns 5 reviews per page. If the seller has no reviews in the specified category, an empty results array is returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Review category filter. Accepted values: 'Currency', 'Account', 'CustomItem', 'TopUp'. |
| `cursor` | string | No | Pagination cursor from nextPageCursor in the previous response. |
| `user_id` | string | Yes | User ID of the seller. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-eldorado-com-api-f9fc3c5a/get_seller_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","cursor":"<string>","user_id":"<string>"}'
```

### get_user_by_username

Returns a user's public profile information given their username. Makes up to 3 requests: resolves the username to a user ID, fetches seller order stats (rating, feedback score), and checks online status. Returns a combined profile object. Returns input_not_found when the username does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | The Eldorado.gg username to look up (e.g. 'FocusStash', 'AladdinMarkt'). Case-sensitive. |

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

### list_account_games

Returns all games available in the Accounts category from the Eldorado.gg library.

**Estimated cost:** Metered

_No parameters required._

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

### list_currency_games

Returns all games available in the Currency category from the Eldorado.gg library.

**Estimated cost:** Metered

_No parameters required._

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

### search_listings

Search for games and services by keyword. Matches against gameName, title, and synonymNames fields. Returns up to 50 matching entries. The same gameId may appear multiple times across different categories (Currency, Account, TopUp, etc.).

**Estimated cost:** Metered

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

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