{"slug":"api-cardhedger-com-v1-agent-cards-card-match-a73fe7","title":"Match a natural language card description to the best card in the CardHedge data","host":"api.cardhedger.com","method":"POST","resource":"https://api.cardhedger.com/v1/agent/cards/card-match","category":"other","description":"Match a natural language card description to the best card in the CardHedge database.","price_listed":0.01,"price_asked":0.01,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":1628,"reported_calls_30d":0,"reported_payers_30d":0,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"category":"Baseball","max_candidates":10,"query":"2018 Topps Chrome Shohei Ohtani #150"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"category":{"description":"Optional category filter to narrow search (e.g., 'Baseball', 'Pokemon')","type":"string"},"max_candidates":{"default":10,"description":"Number of search results to evaluate (1-10, more = slower but potentially more accurate)","maximum":10,"minimum":1,"type":"integer"},"query":{"description":"Natural language description of the card to match (e.g., '2018 Topps Chrome Shohei Ohtani rookie base')","maxLength":500,"minLength":3,"type":"string"},"raw_images_only":{"default":true,"description":"If true, only return actual card photos (not graded slab images). Defaults to true.","type":"boolean"}},"required":["query"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.01,"price_match":true,"latency_ms":1628,"error":null}],"description_full":"Match a natural language card description to the best card in the CardHedge database.","last_updated":"2026-10-24T02:17:06.424Z","schemes":["exact"]}