Back to App

Frequently Asked Questions

How does the wishlist "Buy these" feature work?

The Buy these button on your wishlist runs a cart optimiser across the AU retailers we track. It checks current prices and stock, then groups your wishlist items into the fewest, cheapest carts, factoring in each retailer's shipping costs.

How the optimiser works

We look at your filtered wishlist items and find the best combination of AU retailer carts that minimises the total cost including shipping. The algorithm explores up to 10,000 potential moves to find a near-optimal result, so it completes in under a second even for large lists.

Which retailers are included?

We currently check Gameology, Good Games, Mint Collectables, Pokebox, and Fluke & Box. We aim to expand coverage as more AU retailers join our pricing network.

What happens if some cards aren't available?

Items that can't be sourced are grouped by reason: not in our index, currently out of stock, condition requirements not met, finishing preference not available, or a specific printing that isn't stocked. Each group shows you what to adjust on your wishlist item to improve your chances next time.

Do the outbound cart links track anything?

Yes. When you click "Open cart at a retailer", the link includes a ref=gradely.io and utm_source=gradely.io tag so retailers can see that customers are coming from Gradely. We also record the click internally so we can track which retailers are most useful to our community. We do not earn affiliate commission from these referrals.

Is this a Premium feature?

No. Cart optimisation is free for all logged-in Gradely users.

How does "Buy this card" / "Where to buy" work?

Where the wishlist Buy these optimiser sources a whole list at once, Buy this card is the quick path for a single card. The cart icon on any card (in the catalogue or your wishlist) and the Where to buy section on a card's detail page show the AU retailers that currently stock it, cheapest first, each with a link straight to a prefilled cart at that retailer. We always include an eBay (AU) search as well, so there's a fallback even when none of the shops we track have it in stock.

Which price do we show?

For each retailer we show the cheapest near-mint (or better) listing we last verified, with the condition labelled. We also show how recently we checked it (for example "checked 3h ago") so you know how fresh the figure is. We read retailer prices on a schedule rather than in real time, so always treat the retailer's own checkout as the source of truth.

Why might I see different prices for the same card?

Three numbers can all be correct at the same time, because they measure different things:

  • The catalogue (market) price is an average across all the retailers and conditions we track, in other words what the card is broadly worth. It is not any single shop's price.
  • The Where to buy price is the most recent price we recorded at that specific retailer.
  • The price in the retailer's cart is their live price at the moment you click through.

For fast-moving cards the live price can change between our last check and your click, which is exactly why we show the "checked X ago" hint. If our figure looks off, the retailer's checkout is always the final word.

How does the eBay option work?

The eBay (AU) option runs a search (not a single fixed listing) built from the card's game, name, set, number, treatment and finishing, so it lands on the right card rather than unrelated merch. It is an affiliate link: Gradely may earn a small commission if you buy through it, at no extra cost to you. The deep links to other AU retailers are tagged so shops can see the traffic came from Gradely, but we earn no commission on those.

How does Gradely calculate price confidence?

How we source prices

We combine data from several external AU retailers with, where available, sales intermediated on Gradely. We do not display individual retailer names.

What Gradely as a source means

When a product's data includes a Gradely-intermediated sale, it carries the highest confidence because it reflects an actual transaction on our platform. All other data points carry lower weight.

High

At least 3 external AU sources agree within 20%, and the newest reading is under 48 hours old. When a Gradely-intermediated sale exists recently, it carries extra weight.

Medium

2 or more external AU sources within the last week, or 1 recent source plus older-but-consistent data.

Low / Stale

Only one source is available, the available data is older than a week, or sources disagree by more than 40%.

Unavailable

We do not yet have reliable AU pricing for this product. Coming soon as coverage expands.

Official Precon Decks

Preconstructed (precon) decks are official deck lists automatically imported from manufacturer product data and maintained by Gradely. You can identify them by the blue verified badge that appears next to the deck name on the detail page.

Found a discrepancy?

If you notice any errors in a precon deck list (wrong cards, incorrect quantities, missing entries), please let us know through our support portal.

To help us fix issues quickly, please include:

  • The name of the precon and which set it belongs to
  • A clear description of what's wrong and what it should be
  • The GID (Gradely ID) of any affected cards - you can find this on any card's detail page using the copy button next to the card ID
  • Screenshots or links to official sources, if available

Unverified Decks

Some precon decks carry an unverified badge (an amber warning triangle next to the deck name). This means the deck was imported from the manufacturer's public deck list because the full card data for that specific product has not yet been published through their official API.

The card names and quantities are sourced from the manufacturer's own decklist page, so they are almost certainly correct. The cards themselves are real cards that exist in our catalogue, matched by name and by image where possible, and they are functionally identical to what you'd find in the physical product.

What we can't guarantee yet is the exact printing of each card. The canonical card IDs in an unverified deck may point to reprints or earlier editions rather than the specific set the physical product uses. Once the manufacturer publishes that data, the deck gets re-imported automatically and the unverified badge goes away.

What this changes for you

  • Add to Wishlist still works, because it tracks what you want to get, regardless of the specific printing.
  • Add to Collection is disabled on unverified decks. We don't want to record that you own a specific printing when the deck might actually ship a different one. You can always add the cards manually to your collection if you want to.
  • You can still browse the deck, price it, export it, and compare it against your collection normally.

If you spot a card in an unverified deck that looks wrong (a different name, a token mislabelled as a real card, anything odd), please flag it through our support portal. The sooner we know, the sooner we can promote the deck to verified.

Assigning cards to decks

What is a deck assignment?

A deck assignment links a specific physical copy you own to a deck, so you can see where your cards actually live. Each physical copy can be assigned to at most one deck at a time, a copy that's in one deck isn't available to another until you release it. You can only assign a copy to a deck whose list already contains that exact card (printing); assigning never silently adds cards to a deck.

Where do I assign and see them?

  • In the deck builder, open a card's "Variants and Assignments" drawer to assign, release, or move copies between decks.
  • In your collection, open a card's detail and use the "Decks" section to assign a copy to any of your decks that already include it.
  • Assigned cards show an amber deck chip in your collection (list and grid) that links straight to the deck.

Auto-assign owned copies when building decks

With this setting on (the default), adding a card to a deck automatically reserves a free owned copy for it, so you don't have to assign cards one by one. Turn it off in Profile → Decks if you'd rather assign manually. Removing a card from a deck always releases any copies that were assigned to it.

Reservation vs Informational mode

The Deck assignment mode (in Profile → Decks) controls how assignments affect the ownership badges shown on cards inside a deck:

  • Reservation (default): copies assigned to other decks don't count as available here. If your only copy is reserved by another deck, this deck shows the card as still needed, useful when you don't want to double-count a single physical card across multiple decks.
  • Informational: badges count every copy you own. A card you own still shows as "owned" in a deck even if your only copy is assigned elsewhere. Assignments are purely for tracking and organisation.

Either way the underlying data is identical, so you can switch modes any time without losing assignments.

How can I upgrade my account?

Gradely is still in Beta and upgrades aren't possible at the moment. Please get in touch via contact or support us with a message. We'll capture interest and notify everyone when we're ready to go.

Gradely Exchange Format (GXF)

The Gradely Exchange Format is a simple, human-readable text format for describing lists of cards. It works across all supported TCGs (MTG, Pokemon, One Piece, Flesh and Blood, Sorcery, Riftbound) and is used for importing decks, preconstructed products, and bulk-adding cards to your collection.

Line Types

A GXF file has four kinds of lines:

LinePrefixDescription
Comment#Ignored entirely
Directive@Sets defaults and metadata
Zone header##Names a zone for subsequent cards
Card linenumberA card entry with quantity

Directives

Directives set metadata and defaults. File-level directives appear once and describe the file:

DirectiveDescriptionExample
@nameHuman-readable name@name "Eldrazi Unbound"
@typeList type@type precon
@formatGame format@format commander
@releasedRelease date@released 2023-08-04

Block-level directives can be redeclared anywhere. Each declaration changes the default for all subsequent card lines:

DirectiveDescriptionExample
@tcgDefault TCG@tcg mtg
@setDefault set code@set cmm
@tagsTags for subsequent cards@tags precon, eldrazi
@conditionDefault condition@condition near_mint
@finishingDefault finishing@finishing foil
@treatmentDefault treatment@treatment cold_foil

Row-level tags on a card line merge with the active @tags directive; duplicates are removed case-insensitively.

Card Lines

Each card line starts with a quantity, followed by an identifier and optional pipe-delimited fields:

<quantity> <identifier> [| set_code] [| card_number] [| finishing] [| condition] [| treatment] [| tags]

Identifier forms:

FormSyntaxMeaning
Card nameSol RingResolve by name (uses @tcg + @set defaults)
TCG-prefixedmtg:Sol RingResolve by name with explicit TCG (overrides @tcg)
Gradely IDgid:abc123Exact card by Gradely ID
Canonical IDcid:abc123Any printing of this card (newest selected)

Fields can be skipped by leaving them empty between pipes:

# Just foil, no set or number
1 Sol Ring | | | foil

# Set and number, skip finishing, set condition
1 Sol Ring | cmm | 5 | | lightly_played

# All five fields
1 Enlightened Strike | evr | 027 | foil | near_mint | cold_foil

# Row-level tags applied to this card (merged with any active @tags directive)
1 Sol Ring | cmm | 5 | foil | near_mint | showcase | binder, trade

Zone Headers

Use ## to group cards into zones. If no zone header appears, all cards go to the main zone.

## Main Deck
1 Sol Ring
1 Arcane Signet

## Sideboard
1 Rest in Peace

## Commander
1 Zhulodok, Void Gorger

Full Example

@tcg mtg
@name "Eldrazi Unbound"
@type precon
@format commander
@set cmm

## Commander
1 Zhulodok, Void Gorger | cmm | 5

## Main Deck
1 Sol Ring
1 Arcane Signet
1 Ulamog, the Ceaseless Hunger | bfz | 15
1 Thought-Knot Seer | ogw | 9 | foil

## Sideboard
1 Rest in Peace | akh | 18

Supported TCG Values

mtgpokemononepiecefabsorceryriftbound

Condition Values

mintnear_mintlightly_playedmoderately_playedheavily_playeddamaged

Finishing Values

normalfoiletched

Importing your collection

How do I import my collection?

There are three ways to bring your cards into Gradely:

Spreadsheet (recommended)

Create a Google Sheet or Excel workbook with these columns in order:

count | name | set | number | finishing | condition | treatment

In Google Sheets: File > Download > Tab-separated values (.tsv). Then change the delimiter to | before exporting, or use File > Download > Comma-separated values and let Gradely detect commas automatically.

In Excel: Save As > CSV UTF-8. Gradely accepts comma or tab delimiters.

A spreadsheet with pipe-separated columns is already valid GXF.

GXF file

Paste or upload a Gradely Exchange Format file directly. GXF gives you the most control over set codes, finishings, conditions, and tags.

CSV export from another tool

Copy-paste any comma- or tab-separated export with a header row. Gradely maps these column headers automatically (case-insensitive):

Column headerMapped to
count, quantity, qty, tradelist countquantity
name, card, card namename
set, edition, set code, expansionsetCode
number, card number, collector number, cncardNumber
foil, finish, finishingfinishing
condition, condcondition
treatment, frame, varianttreatment
tagstags (semicolon-split), merged with any @tags directive

TCG requirement: every import must target one TCG. Files containing cards from multiple TCGs will get an error at parse time.

How does Gradely pick the right printing?

We never pick for you. Every card shows a gallery of every printing that matches your entry. You choose the exact one you own, including foil, showcase, extended art, borderless, and any other treatment.

Bulk helpers let you resolve many cards at once:

  • Prefer newest and Prefer oldest auto-select the most or least recent printing.
  • Match my collection prefers printings you already own.
  • All from set X selects every card from a single set (great for booster-box tracking).

If a card has 200+ reprints, the gallery supports infinite scroll and filtering so you can always find the exact one.

How does the import lookup quota work?

Looking up your card lines against our database is the expensive part of an import (we cross-reference set, name, collector number, treatment, etc. across millions of printings). To keep the platform fast for everyone, each plan gets a rolling 24-hour lookup budget:

PlanLookups per 24h
Free500
Premium5,000
Pro25,000

We count lines, not card quantities. A line like 4 Lightning Bolt counts as 1 lookup, regardless of how many copies the line includes. Four separate 1 Lightning Bolt lines would count as 4.

Lookups are spent at resolve time, not import time. Once we've looked a line up, it's paid for, even if you later choose to skip it or fail to commit. Importing the resolved cards into your collection is free.

On the Free plan and hitting the cap? Upgrade your account for a higher limit.

What TCGs does Gradely support?

Gradely currently supports Magic: The Gathering, Pokemon, One Piece TCG, Flesh and Blood, Sorcery, and Riftbound. We're focused on the Australian and New Zealand market, with pricing in AUD and NZD.

Where does the /news content come from?

The /news feed pulls from a curated list of trusted TCG sources across RSS feeds and YouTube channels. Every source is hand-selected by the Gradely team for relevance and quality.

Each article and video is processed once by an AI model (Amazon Bedrock Nova Micro) to generate a concise summary, tag it with the relevant games and formats, and score its relevance. The original source is always attributed clearly on every item, with a direct link to read or watch the full content at its origin.

Gradely does not rewrite, rehost, or republish the original content. Every item links directly to the source so you can support the creator.