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

Weebs of the Shore · since 2022

Grand Archive API

Separate memory and reserve costs, champion level, power, life, durability, speed, elements and classes.

2,478
Cards
4,796
Printings
63
Sets
1
Languages
English

Overview

What the Grand Archive dataset covers

Grand Archive combines anime art direction with a genuinely novel resource system built on memory and reserve costs. TCGGraph exposes both cost tracks, champion level, power, life, durability, speed, elements and classes as filterable fields, so a champion's progression is a name search with minLevel=0 rather than a parse of the rules text.

Both resource tracks — memory and reserve — are modelled as distinct costs, and level is set only on champions, so champion progression can be listed with a filter rather than parsed.

Formats

  • Standard
  • Unlimited
  • Sealed

Price sources

  • TCGplayer
REST
curl -G "https://api.tcggraph.com/v1/cards" \
  -d game=grand-archive \
  -d limit=5 \
  -H "Authorization: Bearer $TCGGRAPH_KEY"
GraphQL
{
  cards(
    filter: { game: GRAND_ARCHIVE, gameData: { elements: "Fire", level: 2 } }
  ) {
    nodes {
      name
      gameData
    }
  }
}

Schema

Grand Archive-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
memoryCostIntMemory required to play.
reserveCostIntReserve required to play.
levelIntChampion level.
powerIntAttack power.
lifeIntHealth for champions and allies.
durabilityIntWeapon durability.
elements[String]NORM, FIRE, WATER, WIND, ARCANE, ASTRA, CRUX, EXALTED, EXIA, LUXEM, NEOS, TERA or UMBRA.
classes[String]CLERIC, MAGE, WARRIOR, TAMER, ASSASSIN, GUARDIAN, RANGER, SPIRIT or ANOMALY.
speedEnumFAST or SLOW.

Plus 26 core fields shared by every game — see the full reference.

Live data

Grand Archive 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
Labyrinth, Jeweled OpusPhantom Monarchs First Edition119Ultra Rare$14.44—
Windmill EngineerMercurial Heart160Uncommon$2.68—
Bedlam Borough.asphodel/paradise032Uncommon$0.56—
Illuminating ChargeMortal Ambition217Super Rare$0.38—
Diana, Keen HuntressAlchemical Revolution008Common$0.23—
Arisanna, Lucent ArbiterAlchemical Revolution007Common$0.18—
Arisanna, Herbalist ProdigyAlchemical Revolution004Common$0.17—
Arisanna, Master AlchemistAlchemical Revolution005Common$0.16—

Sets

Notable Grand Archive sets

  • ALC

    Alchemical Revolution

    253 cards · 2022-11-04

  • MRC

    Mercurial Heart

    226 cards · 2024-05-24

  • SUR

    Silvie's Uprising

    218 cards · 2026-02-13

Modelling

Working with Grand Archive data

The decisions that catch people out when they first integrate Grand Archive. Each of these is a bug we have watched somebody ship.

  • Champions level up mid-game

    You start with a level 0 champion and play higher-level versions of the same character on top as the game progresses, so a level 2 Silvie can only be played over an earlier Silvie. level is set only on champions, which makes minLevel=0 the way to list them; there is no card type field.

  • Two resources, two costs

    Reserve cost and memory cost are separate currencies paid from separate pools. Most cards cost reserve (3,687 of them); memory is the cost of every champion and of about 750 other cards. No card has both, so a curve has to read whichever one is set.

  • Speed decides when you may act

    FAST cards can be played in response; SLOW ones cannot. speed is null on the cards that have neither. It changes how a card plays far more than its cost does, which makes it a much more useful filter than most people expect.

  • First Edition is its own set

    A set's First Edition and its later print are separate sets with their own records and prices: gau_doa_1st_010 is Silvie, Wilds Whisperer in Dawn of Ashes First Edition (set DOA 1st). Group by name when you mean the card and keep editions apart when you mean a specific copy.

Recipes

Common Grand Archive queries

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

Every Silvie, oldest first

Deck builders need every version of one character.

name matches a part of the name, so this returns every card with Silvie in it. Add minLevel=0 for the champions alone.

GET /v1/cards
  ?game=grand-archive
  &name=silvie
  &sort=released

Cheap fast Water cards for a reactive deck

Speed plus cost is the filter pair that actually matters here.

Elements and classes are stored upper case; filters ignore case, so elements=water works too.

GET /v1/cards
  ?game=grand-archive
  &speed=FAST
  &maxReserveCost=2
  &elements=WATER

Assassin cards above a power threshold

Your champion's class constrains what the rest of the deck may contain.

classes is a list, so cards shared between two classes match either filter.

GET /v1/cards
  ?game=grand-archive
  &classes=ASSASSIN
  &minPower=3

Glossary

Grand Archive terms, and the fields that hold them

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

TermFieldNotes
Reserve costgameData.reserveCostPaid from reserve. The cost on most cards.
Memory costgameData.memoryCostPaid from memory. A separate pool, not interchangeable with reserve.
LevelgameData.levelChampions only. You play higher levels over lower ones of the same character.
SpeedgameData.speedFAST or SLOW, or null. Whether the card can be played in response.
ElementsgameData.elements[]NORM, FIRE, WATER, WIND, and the advanced elements such as ARCANE, CRUX, TERA and UMBRA.
ClassesgameData.classes[]CLERIC, MAGE, WARRIOR, TAMER, ASSASSIN, GUARDIAN, RANGER, SPIRIT or ANOMALY.
Life / DurabilitygameData.lifeLife on champions and allies; gameData.durability where the card has one, as weapons do.

FAQ

Grand Archive API questions

Anything not covered here, email hello@tcggraph.com and a human who knows Grand Archive answers.

Also available

Add another game without another integration

Your Grand Archive key already works for every other game in the catalog. Change the GRAND_ARCHIVE enum and the rest of your code stays as it is.