tcgdex

Read one whole card by its `id`, or by its `set` and the number printed on it, `localId` — not both. The set may be an id or a printed name, ignoring case, and leading zeros in the number are optional. Returns the shape search_cards gives at `detail` 'full'. A card that does not exist is an error saying whether the set or the number was wrong.

Price up to 50 cards in EUR, USD or GBP, from Cardmarket (EUR) and TCGplayer (USD) side by side, with one total per market — never blended, since one is a trend and the other a market price. Name each card by `id`, or by `set` and `localId`, with an optional `variant` and `quantity`. Each line's `status` is `priced`; `unpriced`; `ambiguous`, when no `variant` was named and the copy held is unclear — name one of its `variants`; or `unavailable`, when the card could not be read or the line is malformed, which never fails the call. A missing price gives a `reason`: `no_listing`, `variant_unpriced`, `variant_not_printed`, `separate_product` (sold as a product of its own and unpriced here, like Base Set's 1st Edition or a Poké Ball reverse), `window_unavailable`, `platform_unpriced`, `unavailable` or `unrecognised_shape`. `approximateVariant` marks a price that may cover more than the printing named, and `separatelyListedPrintings` counts printings sold separately. Each price has its native `amount` and a `convertedAmount` at the ECB rate in `exchangeRates.rates`. A total is `complete` only when every line is priced. `warnings` flag markets more than 10× apart for a printing, and stale rates. Prices are for one copy in unspecified condition, before fees, and the same in every language.

Read one set by id or printed name: its series, release date, platform and card counts, with a page of its cards in printed order as checklist lines of `id`, `localId`, `name` and `rarity`. Call get_card for a card that matters. Legality is per card, from get_card: upstream's set-level flag is wrong for every current set.

List the values a card `field` accepts in a language, which search_cards' filters take. `contains` filters them case-insensitively before paging; read further pages while `hasMore` is true. Values come from upstream as they are, so near-identical spellings of one artist can both appear.

List a language's sets, each with its `id`, `name`, `platform`, `releaseDate`, `serie` and card counts — the values a `set` filter takes. Oldest first unless `sort` or `order` say otherwise: `order` 'desc' lists the newest first. `contains` and `platform` filter the whole catalogue before paging.

Rank the cards matching `name`, `pokemon`, `pokedex`, `set` or `rarity` — at least one, matched as in search_cards — by one market's price, most valuable first unless `order` is 'asc'. Each card is ranked once, by its highest-priced printing in `rankMarket`: a row in `cards` gives that `variant`, its `price`, and the other market's price as `otherMarket`. Upstream cannot sort by price, so the first 300 matches are read; `truncated` says more matched, and `coverage` accounts for every card read, counting unpriced ones by the same `reason` codes get_card_pricing uses. `separatelyListedPrintings` counts printings sold separately and not ranked. A row's `warnings` flag markets more than 10× apart; the order still follows `rankMarket`. Prices show the native `amount` and a `convertedAmount` at the rate in `exchangeRates.rates`, for one copy in unspecified condition, before fees.

Search the card catalogue; every filter is optional and they combine with AND. Exact filters (`type`, `energy`, `category`, `trainer`, `stage`, `rarity`, `illustrator`, `variant`, `suffix`, `regulation`) take values from list_card_field_values and match whole, with letter case corrected to the catalogue's — unless two values differ only by case, like suffixes 'EX' and 'ex', which is an error naming both. An unknown value is an error too, so an empty page means real values matched nothing. `name` and `effect` match substrings; `pokemon` finds every card depicting a Pokémon; `attack` and `ability` text is checked over the first 300 matches of the other filters, as `textSearch` reports. Results come in a fixed `sort` order, and `detail` sets how much of each card is returned. Read further pages while `hasMore` is true. Prices come from get_card_pricing, not from cards.