Skip to content
Prepaid, no subscription trap. Top up a balance and we draw the monthly fee from it.
tcggraph

Bandai · since 2022

One Piece Card Game API

Leaders, characters, events and stages with cost, power, counter, life, attribute and trigger data.

1,377
Cards
5,538
Printings
65
Sets
6
Languages
English, French, Japanese, Traditional Chinese, Simplified Chinese and Korean

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 the Japanese, French, Traditional and Simplified Chinese and Korean printings — including alternate-art, manga-art and Special-rare treatments — to the English printing they share a card number with.

The Japanese, French, Chinese and Korean printings of a card are linked to its English printing, so a card found in any of the six languages returns the same record.

Formats

  • Standard
  • Japanese Standard

Price sources

  • Cardmarket
  • TCGplayer
REST
curl -G "https://api.tcggraph.com/v1/cards" \
  -d game=one-piece \
  -d limit=5 \
  -H "Authorization: Bearer $TCGGRAPH_KEY"
GraphQL
{
  cards(
    filter: { game: ONE_PIECE, gameData: { colors: "Red", cardType: "LEADER" } }
  ) {
    nodes {
      name
      gameData
    }
  }
}

Schema

One Piece-specific fields

Every card carries the shared core fields. These live under gameData, in REST and GraphQL alike, and each is a filter: ?cost=2 in REST, gameData: { cost: 2 } in GraphQL.

FieldTypeDescription
cardTypeEnumLEADER, CHARACTER, EVENT, STAGE or DON.
colors[String]Red, Green, Blue, Purple, Black or Yellow.
costIntDON!! cost to play. Null for Leaders.
powerIntBattle power.
counterIntCounter value playable from hand.
lifeIntLeader life total.
attributeEnumSlash, Strike, Ranged, Wisdom or Special; a card with two reads Slash/Special. Japanese printings carry the printed kanji (斬, 打, 射, 特, 知).
types[String]Crew and archetype traits.
triggerStringTrigger effect text when flipped from life.

Plus 26 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.

CardSetNumberRarityTCGplayerCardmarket
Monkey.D.LuffyAnime 25th CollectionEB02-061_p2SEC$5,108€4,650
SaboCARRYING ON HIS WILLOP13-120_p4SP CARD$122.88€5,559
FullbodyLEGACY OF THE MASTEROP12-052_r1C$0.32—
St. Marcus MarsCARRYING ON HIS WILLOP13-091R$0.24€0.36
Little SadiPARAMOUNT WAROP02-073R$0.21€5.27
DollA FIST OF DIVINE SPEEDOP11-008R$0.13€0.10
IsukaPARAMOUNT WAROP02-094UC$0.12€0.05
Speed JilTHE TIME OF BATTLEOP16-009C$0.08€0.03

The most valuable One Piece cards and their prices — each printing with Cardmarket and TCGplayer quotes, per language and grade.

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 printed number

    OP05-119 is printed on the standard card and on every parallel and manga art of it, which differ in price by an order of magnitude. Each is its own record, told apart by a suffix: op_op05_119_p2 has collectorNumber OP05-119_p2. collectorNumber=OP05-119 returns all of them; the suffixed number returns one.

  • Counter is not a universal field

    Counter is set only on Characters, and not on all of them: about a quarter have none. It is null on every Leader, Event, Stage and DON!! card, so read it with a null check.

  • Numbers carry the set prefix

    The collector number is the whole printed code, OP05-119, not 119. set=OP05&collectorNumber=119 matches nothing; collectorNumber=OP05-119 on its own finds the card. Starter decks reprint main-set cards under their own code, so the same card can appear under two numbers.

Recipes

Common One Piece queries

Three requests that cover most of what applications in this game actually ask for.

Every red leader

Deck builders start by choosing a leader, which then constrains everything else.

colors is a list, so two-colour leaders with red in them come back too; read colors on each to split them.

GET /v1/cards
  ?game=one-piece
  &cardType=LEADER
  &colors=Red

Cheap characters with a high counter

A common deckbuilding query: low cost and a useful counter value.

Every numeric game field takes min and max bounds, on every game.

GET /v1/cards
  ?game=one-piece
  &cardType=CHARACTER
  &maxCost=3
  &minCounter=2000

SP cards, most valuable first

Collection and singles tools usually want the chase printings separated out.

rarity takes one value per request, as the card shows it: C, UC, R, SR, SEC, L, P, SP CARD or TR.

GET /v1/cards
  ?game=one-piece
  &rarity=SP CARD
  &sort=-price

Glossary

One Piece terms, and the fields that hold them

What players call a thing on the left, what you query on the right.

TermFieldNotes
LifegameData.lifeLeaders only. The number of cards in the life area at the start of play.
PowergameData.powerThe printed number, such as 5000. Null on Events and Stages.
CountergameData.counterValue when discarded to boost a defender, such as 2000. Null where the card has none.
AttributegameData.attributeSlash, Strike, Ranged, Special or Wisdom. Referenced by many card effects.
TypegameData.types[]Crew and affiliation tags such as Straw Hat Crew. Most tribal effects key on these.
CostgameData.costDON!! needed to play the card. Null on Leaders.
Card typegameData.cardTypeLEADER, CHARACTER, EVENT, STAGE or DON. Determines which other fields are set.

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.