Bandai · since 2022
One Piece Card Game API
Leaders, characters, events and stages with cost, power, counter, life, attribute and trigger data.
- 3,180
- Cards
- 9,640
- Printings
- 46
- Sets
- 5
- Languages
Overview
What the One Piece dataset covers
The One Piece Card Game is the fastest-growing TCG of the decade, overtaking Magic and Yu-Gi-Oh! in tracked volume within four years of launch. TCGGraph structures every Leader, Character, Event, Stage and DON!! card with colour, cost, power, counter value, life, attribute and trigger text, and links English and Japanese printings — including alternate-art, manga-art and Special-rare treatments — to a shared identity.
Sourced from Bandai official card list, OPTCG API and TCGplayer.
Formats
- Standard
- Japanese Standard
Price sources
- TCGplayer
- Cardmarket
- Yahoo! Auctions JP
curl -G "https://api.tcggraph.com/v1/cards" \
-d game=one-piece \
-d limit=5 \
-H "Authorization: Bearer $TCGGRAPH_KEY"{
cards(
game: ONE_PIECE
filter: { colors: ["Red"], cardType: LEADER }
) {
nodes {
name
onePiece { life power attribute types }
}
}
}Schema
One Piece-specific fields
Every card carries the shared core fields. These live under gameData in REST, and under the typed onePiece field in GraphQL.
| Field | Type | Description |
|---|---|---|
| cardType | Enum | LEADER, CHARACTER, EVENT, STAGE or DON. |
| colors | [String] | Red, Green, Blue, Purple, Black or Yellow. |
| cost | Int | DON!! cost to play. Null for Leaders. |
| power | Int | Battle power. |
| counter | Int | Counter value playable from hand. |
| life | Int | Leader life total. |
| attribute | Enum | Slash, Strike, Ranged, Wisdom or Special. |
| types | [String] | Crew and archetype traits. |
| trigger | String | Trigger effect text when flipped from life. |
Plus 21 core fields shared by every game — see the full reference.
Live data
One Piece cards in the public dataset
Real records returned by the API right now, sorted by market value, with both the American and the European quote.
| Card | Set | Number | Rarity | TCGplayer | Cardmarket |
|---|---|---|---|---|---|
| Yamato | Romance Dawn | OP01-121 | SEC | $5.87 | €5.18 |
| Nami | Romance Dawn | OP01-016 | R | $4.56 | €4.98 |
| Monkey.D.Luffy (024) | Romance Dawn | OP01-024 | SR | $2.40 | €2.46 |
| Roronoa Zoro (001) | Romance Dawn | OP01-001 | L | $2.37 | €2.16 |
| Boa Hancock | Romance Dawn | OP01-078 | SR | $1.50 | €1.23 |
| Sanji | Romance Dawn | OP01-013 | R | $0.59 | €0.52 |
| Donquixote Doflamingo (060) | Romance Dawn | OP01-060 | L | $0.32 | €0.30 |
| King (091) | Romance Dawn | OP01-091 | L | $0.29 | €0.31 |
The European market for One Piece
Bandai's European rollout trailed Japan by more than a year and allocations were thin for the first several sets, so early European stock is scarcer than the print numbers suggest. Spreads against the American market on OP-01 and OP-02 alternate arts remain some of the widest we track.
Traded on Cardmarket in German, French, Italian, Spanish beyond English. How European pricing works.
Sets
Notable One Piece sets
OP-01
Romance Dawn
121 cards · 2022-12-02
OP-09
Emperors in the New World
127 cards · 2024-11-29
PRB-02
The Azure Sea's Seven
148 cards · 2026-02-27
OP-14
Adventure on Kami's Island
132 cards · 2026-07-31
Modelling
Working with One Piece data
The decisions that catch people out when they first integrate One Piece. Each of these is a bug we have watched somebody ship.
Leaders are a different kind of card
A Leader is not a character you play from hand — it sits face up from the start, carries life and its colours dictate what the other fifty cards in your deck may be. Deck validation therefore starts with the leader, not with the deck list. Filter cardType=LEADER to build a leader picker.
Parallel art shares the card number
The same number, say OP01-121, covers the standard print, the parallel alternate art and any manga rare. They differ in rarity and in price by an order of magnitude. Number alone is not unique — pair it with rarity, or use the card id.
Counter is not a universal field
Counter values exist on characters and events and are absent everywhere else. Reading counter as a number without a null check will bite you the first time you touch a Stage or a Leader.
Set prefixes carry meaning
OP is a main booster, ST a starter deck, EB an extra booster and P a promo. Starter decks reprint main-set cards with a different number, so the same card can appear under two codes. Group on the card's name and effect if you want one logical entry.
Recipes
Common One Piece queries
Three requests that cover most of what applications in this game actually ask for.
Every leader in a colour pair
Deck builders start by choosing a leader, which then constrains everything else.
colors matches any of the listed values, so this returns mono-red and mono-green leaders too.
GET /v1/cards
?game=one-piece
&cardType=Leader
&colors=Red,Green
&include=pricesCheap blockers with a high counter
A common deckbuilding query: low cost, useful counter value, has the Blocker keyword.
Numeric filters use min/max prefixes throughout the API, on every game.
GET /v1/cards
?game=one-piece
&maxCost=3
&minCounter=2000
&keyword=Blocker
&sort=cost:ascAlternate art only, sorted by value
Collection and singles tools usually want the chase printings separated out.
Comma-separated values are an OR within a single filter.
GET /v1/cards
?game=one-piece
&rarity=Special Rare,Manga Rare
&include=prices
&sort=prices.market:descGlossary
One Piece terms, and the fields that hold them
What players call a thing on the left, what you query on the right.
| Term | Field | Notes |
|---|---|---|
| Life | onePiece.life | Leaders only. The number of cards in the life area at the start of play. |
| Power | onePiece.power | Integer in thousands. Absent on Events and most Stages. |
| Counter | onePiece.counter | Value when discarded to boost a defender. Null where the card has none. |
| Attribute | onePiece.attribute | Slash, Strike, Ranged, Special, Wisdom. Referenced by many card effects. |
| Type | onePiece.subtypes[] | Crew and affiliation tags such as Straw Hat Crew. Most tribal effects key on these. |
| Cost | onePiece.cost | DON!! needed to play the card. Leaders have no cost. |
| Card type | onePiece.cardType | LEADER, CHARACTER, EVENT or STAGE. Determines which other fields are present. |
FAQ
One Piece API questions
Anything not covered here, email hello@tcggraph.com and a human who knows One Piece answers.
Also available
Add another game without another integration
Your One Piece key already works for every other game in the catalog. Change the ONE_PIECE enum and the rest of your code stays as it is.