# Onepiece Cardgame — 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 and explore One Piece trading card data across all series, view detailed card information including stats, abilities, and artwork, and stay up to date with the latest news, events, and product releases from the official game site. Browse recommended deck strategies and discover upcoming tournaments and expansions.

**Category:** Entertainment | **Website:** [en.onepiece-cardgame.com/](https://en.onepiece-cardgame.com/) | **Docs:** [parse.bot/marketplace/8c71e8aa-ce2c-4114-bf6e-d554df72adf9/en-onepiece-cardgame-com-api](https://parse.bot/marketplace/8c71e8aa-ce2c-4114-bf6e-d554df72adf9/en-onepiece-cardgame-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-en-onepiece-cardgame-com-api-8c71e8aa/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_card_detail

Retrieves full details for a single card by its ID. Searches for the card upstream and returns the exact match. Returns card attributes including name, rarity, category, cost, attribute, power, counter, color, block_icon, type, effect text, associated card sets, and image URL. Returns stale_input if the card is not found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `card_id` | string | Yes | Card ID in the format PREFIX-NUMBER (e.g. OP01-001, EB04-011, ST01-012). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-en-onepiece-cardgame-com-api-8c71e8aa/get_card_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"card_id":"<string>"}'
```

### get_card_series

Retrieves all available card sets (series) with their unique IDs. Each series entry contains a numeric series_id (used as a filter value in get_cards) and a human-readable series_name. The list is ordered newest-first and includes booster packs, starter decks, promo cards, and other product cards.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-en-onepiece-cardgame-com-api-8c71e8aa/get_card_series \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_cards

Searches and filters cards from the One Piece Card Game database. Supports filtering by series, color, category, block icon, illustration type, and free-text keyword. The upstream site returns all matching cards in one request; this endpoint paginates the results locally via page and limit parameters. Returns an object with a cards array, total match count, current page, and limit.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `block_icon` | string | No | Block icon number. |
| `categories` | string | No | Comma-separated card types. |
| `colors` | string | No | Comma-separated colors to filter by. |
| `freewords` | string | No | Keyword search text to match against card names and text. |
| `illustrations` | string | No | Comma-separated illustration types. |
| `limit` | integer | No | Maximum number of cards per page. |
| `page` | integer | No | Page number for paginated results. |
| `reprintsFlag` | string | No | 'on' to hide reprints, empty string to show them. |
| `series` | string | No | Series ID from get_card_series (e.g. '569101'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-en-onepiece-cardgame-com-api-8c71e8aa/get_cards \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"block_icon":"<string>","categories":"<string>","colors":"<string>","freewords":"<string>","illustrations":"<string>","limit":"<integer>","page":"<integer>","reprintsFlag":"<string>","series":"<string>"}'
```

### get_events

Retrieves upcoming and past events from the official One Piece Card Game site. Returns an array of event objects each with a title, date range, category tag, detail URL, and thumbnail image URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-en-onepiece-cardgame-com-api-8c71e8aa/get_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_news

Retrieves the latest news and announcements from the official One Piece Card Game site. Returns an array of news items each containing a title, publication date, category label, and URL to the full article.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-en-onepiece-cardgame-com-api-8c71e8aa/get_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_products

Retrieves official product listings from the One Piece Card Game site including booster packs, starter decks, card sleeves, and other accessories. Returns an array of products each with a name, category, release date, and product image URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-en-onepiece-cardgame-com-api-8c71e8aa/get_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_recommended_decks

Retrieves recommended deck recipes and strategies from the official One Piece Card Game site. Returns an array of deck objects each with a name, short description, URL to the full deck page, and a thumbnail image URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-en-onepiece-cardgame-com-api-8c71e8aa/get_recommended_decks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```