# Onepiece Cardgame — 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.

> 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/onepiece-cardgame/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/onepiece-cardgame/get-card-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/onepiece-cardgame/get-card-series \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/onepiece-cardgame/get-cards \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/onepiece-cardgame/get-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/onepiece-cardgame/get-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/onepiece-cardgame/get-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/onepiece-cardgame/get-recommended-decks \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

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