search_tcg_products
NOTE 2026-09-12: USD market prices in results are FROZEN at 2026-09-07 (feed stopped); the response carries usd_panel {frozen, as_of}. Names/ids are current. Search 456K+ TCG products across 25+ card games.
FRESHNESS: USD prices are currently FROZEN at their last good date — the
upstream feed is unavailable. Every price carries its own as-of date and
the oracle root publishes live panel state under panels. A Japanese-print
panel (24 games, ~364K cards, ~167K with BOTH an ask and a dealer buyback
bid) refreshes every morning. Do not present a USD price as current.
Returns card names and IDs, plus current market prices.
FREE — no payment required.
Use this when: a user asks about a specific card, wants to find cards, or needs current pricing for any trading card game product.
HOW TO SEARCH (card name AND set name are both searchable): • Card name alone casts the widest net: "Charizard", "Black Lotus". • Add the SET to pin down a printing: "Base Set Charizard" returns the Base Set, Base Set 2 and Shadowless Charizards as separate entries. This matters — printings of the "same" card differ wildly in value. • Every result carries a "set" field. Use it to choose, then pass that result's product_id to the other tools (card_forecast, grade_or_not, simulate_price) — exact, and avoids re-searching. • Do NOT include rarity or condition words: "Holo", "1st Edition", "Shadowless", "PSA 10" are not indexed and will sink an otherwise-good query. "Base Set Charizard Holo" → drop "Holo". • Got nothing? Remove the rarity words first, then fall back to the plain card name.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| game | No | ||
| limit | No | ||
| query | Yes |