Changelog

Added 1y as a new allowed value for the priceHistoryDuration query parameter on the GET /cards endpoint. When requested, the priceHistory array on each variant returns one data point per day over the trailing 365 days, sourced from a daily materialized aggregate. Existing values (7d, 30d, 90d, 180d) are unchanged, and the default remains 7d.

Added the min_price optional query parameter to the GET /cards endpoint. This allows users to filter results by a minimum market price (e.g., min_price=1.00), significantly reducing noise from low-value cards in analytics and trending lists.

The MCP endpoint provides comprehensive pricing data to your agentic workflows.

Added support for UniVersus. Use universus as the game query parameter to access UniVersus card data.

Added support for Sorcery: Contested Realm. Use sorcery-contested-realm as the game query parameter to access Sorcery card data.

Added support for 90d and 180d price history. Deprecated priceHistory30d in the process. Use query param priceHistoryDuration to select desired durations (7d, 30d, 90d, 180d). Defaults to 7d. priceHistory30d will be removed in a future major release.

Added support for two new games: hololive OFFICIAL CARD GAME (hololive-official-card-game) and Dragon Ball Super: Fusion World (dragon-ball-super-fusion-world).

Added game_value_usd to /games and set_value_usd to /sets. These represent the total value of all cards in the game/set, calculated by taking the highest price of any variant for each card.

Added the include_null_prices boolean query parameter to /cards. When true, the response includes cards that don't have any pricing data. Default false.

Added the number query parameter to /cards so you can filter cards by their specific card number within a set.

Fixed card counts in /sets and /games to exclude sealed products. Introduced sealed_count on both endpoints and variants_count on /sets.

Added updated_after to both GET /cards and POST /cards (Batch). Filters results to variants whose pricing was updated at or after the provided Unix timestamp. Cannot be combined with the search query parameter (q).

Added support for querying cards by MTGJSON and Scryfall IDs. Variants can be queried using TCGplayer SKU IDs.

The /sets endpoint now includes the release date of each set.

Set IDs standardized to lowercase-hyphenated format including the game name. Added set_name to the card object.

Added include_price_history and include_statistics query parameters to /cards. Available windows: 7d, 30d, 90d, allTime.

Released the official JS / TS SDKs. Install via npm: npm install justtcg-js.

Added a suite of 90-day statistical fields for deeper quarterly market analysis.

Added language to the variant object.

Added support for Grand Archive TCG (grand-archive-tcg) and Pokemon Japan (pokemon-japan).

The /cards endpoint now accepts condition and printing query parameters with multiple comma-separated values, e.g. /cards?condition=NM,LP&printing=First Edition,Unlimited.

The id format for cards and variants now includes the card's rarity. Old format game-set-name, new format game-set-name-rarity. All previously stored IDs are invalid and must be re-fetched.

Added orderBy (price, 24h, 7d, 30d) and order (asc, desc) for sorting.

Card IDs now include the full game name. Some IDs with invalid characters have been standardized.

API rate limits adjusted for free users. See the Rate Limits page for details.

Their functionality is merged into /cards.

Version 1 introduces initial endpoints and card structure.