{"uid":"cap_oCf0k7dh-YJnhSv8IkxGa","slug":"cardhedge-card-match-a99c899e","name":"CardHedge Card Match","description":"Match a natural language card description to the best card in the CardHedge database.","url":"https://api.cardhedger.com/v1/agent/cards/card-match?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","maxLength":500,"minLength":3,"description":"Natural language description of the card to match (e.g., '2018 Topps Chrome Shohei Ohtani rookie base')"},"category":{"type":"string","description":"Optional category filter to narrow search (e.g., 'Baseball', 'Pokemon')"},"max_candidates":{"type":"integer","default":10,"maximum":10,"minimum":1,"description":"Number of search results to evaluate (1-10, more = slower but potentially more accurate)"},"raw_images_only":{"type":"boolean","default":true,"description":"If true, only return actual card photos (not graded slab images). Defaults to true."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0pkZ0P63rm-_VpIxGuawX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Matches a natural language card description to the best matching card in the CardHedge trading card database.","exampleAgentPrompt":"Can you find the best match in the CardHedge database for a '2019 Topps Chrome Shohei Ohtani Rookie Autograph' in the Baseball category, checking the top 5 candidates and only showing raw card images?","exampleUseCases":[{"title":"Identify card before pricing lookup","prompt":"I have a card described as '2003 Topps LeBron James rookie base' — can you match it to the right card in CardHedge so I can look up its current price?"},{"title":"Pokémon card disambiguation","prompt":"I'm trying to figure out which exact card 'Charizard Base Set 1st Edition holo' maps to in the CardHedge database — can you match it under the Pokémon category with 10 candidates for best accuracy?"},{"title":"Bulk listing card resolution","prompt":"I'm listing cards for sale and need to resolve '2017 Panini Prizm Patrick Mahomes rookie' to the correct CardHedge card entry — can you match it and give me the card details?"}],"resultDescription":"Returns the best-matching card record from the CardHedge database, including the card ID, name, set, and associated metadata. The card ID can then be used to fetch pricing, comparable sales, or graded values via other CardHedge endpoints.","failureModes":["No match found if the description is too vague or misspelled","Low-confidence match if multiple similar cards exist in the database","Timeout or slower response when max_candidates is set to 10","Category filter mismatch if the wrong category is specified, excluding the correct card","Query too short (under 3 characters) returns a validation error"],"whenToPreferThis":"Use this endpoint when you have a human-readable card description and need to resolve it to a structured CardHedge card record or card ID. It is the recommended first step before calling any other CardHedge endpoint that requires a card_id. Prefer this over the general search endpoint when the goal is to identify the single best matching card rather than browse a filtered list.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:30:18.590Z","isFirstParty":false,"canonicalSlug":"cardhedge-card-match-a99c899e"}