TickerMint

Use this when the user asks which cards in one game are at a record price. Returns cards that set their highest market price since TickerMint began tracking the game (February 2024 for Pokemon, One Piece and Lorcana; later for the others, see `tracked_since`) in the last 7 days and still hold it, with the date of the high, in USD. For a card released before that day it is not an all-time high: each card's `high_is_all_time` and `high_scope` say which it is.

Use this when the user asks which cards in one game are at their lowest price or have crashed. Returns cards worth $5+ sitting at their lowest market price since TickerMint began tracking (all-time for cards released after that day, see each card's `low_scope`) after falling at least 50% from their high, with the high and the percent below it, in USD.

Use this when the user asks what one specific card or sealed product is worth today. Returns the latest daily TCGplayer market price and lowest listed price per printing (Normal, Holofoil, Reverse Holofoil, 1st Edition...) with the date of the price, in USD, plus `headline` (the printing and price the TickerMint page leads with) and the page URL. Raw (ungraded) prices only; not an appraisal of a particular copy. When PriceCharting has the card, `graded` adds its PSA 10 and Grade 9 values from sold listings with the PriceCharting credit and link (every grade: graded_price). Needs a product_id from search_cards.

Use this after `search` to read one product: today's market price per printing (USD), its move over the last 90 days and the page URL.

Use this when the user asks what a graded (slabbed) copy of one card is worth, or how much more a PSA 10 sells for than a raw copy. Returns PriceCharting's values from sold listings for each grade it has (PSA 10, BGS 10, CGC 10, SGC 10, TAG 10 and grades 7, 8, 9 and 9.5 from any grader), its ungraded value, how many times the ungraded value a PSA 10 sells for, the date, and the credit 'Prices from PriceCharting' with a link to the card's PriceCharting page, which goes with any value quoted. Singles only; needs a product_id from search_cards.

Use this when the user asks how one game's card market as a whole is doing, or for the TickerMint index (for example the TickerMint Pokemon 100). Returns the index level with its date, its 1-day, 7-day, 30-day and year-to-date change in percent, its all-time high, the largest constituents, the latest dated facts from the TickerMint wire, and a citation line. The index is an equal-weighted average of the raw TCGplayer market prices of the game's priciest singles that trade, rebalanced monthly, base 1,000. Past prices only; not a forecast.

Use this when the user asks for the most expensive or most valuable cards in one game right now. Returns up to 25 singles ranked by today's raw market price (USD) with set and printing. Raw prices only, not graded values.

Use this when the user asks which cards in one game rose or fell the most recently. Returns the biggest percentage moves over the last `days` (1 to 90) for cards worth $5 or more, with the start and end market price in USD. Describes past moves only; not a prediction.

Use this when the user asks whether a card's price is going up or down, how it moved over a period, or what it was worth on a past date. Returns the daily market price per printing for the last `days` days (7 to 1000; history starts February 2024, later for newer cards) in USD. Past prices only, no forecasts.

Use this when the user asks about sealed product prices in one game: booster boxes, elite trainer boxes, bundles, packs, tins and cases. Returns today's market price (USD) and 30-day percent change per product, most expensive first. For one named product, search_cards plus card_price is more direct.

Use this to look up trading cards or sealed products (Pokemon, One Piece, Disney Lorcana, Riftbound, Yu-Gi-Oh, Gundam and Dragon Ball Super Fusion World) by name. Returns up to 10 matches with ids to pass to `fetch`.

Use this when the user names a trading card or sealed product and you need its TickerMint product_id (required by card_price and price_history) or its set id (group_id, required by set_prices). Returns up to 25 matches with name, set, collector number, the latest raw market price in USD and the page URL. Covers Pokemon, One Piece, Disney Lorcana, Riftbound, Yu-Gi-Oh, Gundam and Dragon Ball Super Fusion World only.

Use this when the user asks what a set is worth, what it costs to complete, or which cards in one set are the most valuable. Returns the cost to complete the set in singles today (one copy of each collector number at its cheapest printing, USD, the same figure as the set page), the master set total (every printing we price, labeled separately), the 25 most valuable singles and the 10 priciest sealed products of the set, plus companion sets that ship in the same packs but are catalogued separately (for example a Classic Collection or Trainer Gallery subset) with their own totals. Needs a group_id from search_cards.