{"uid":"cap_mxZYZv-ZTOpDrbs-3cCq5","slug":"card-hedge-card-search-3ab15ffe","name":"Card Hedge Card Search","description":"Search for cards with flexible filtering options.","url":"https://api.cardhedger.com/v1/agent/cards/card-search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"set":{"type":"string","description":"Filter by set name (e.g., '2025 Topps Baseball')"},"page":{"type":"integer","default":1,"minimum":1,"description":"Page number for pagination"},"number":{"type":"string","description":"Filter by card number within the set (exact match, e.g. '150')"},"player":{"type":"string","description":"Filter by player name"},"rookie":{"type":"string","description":"Filter by rookie status (e.g., 'Rookie')"},"search":{"type":"string","description":"Search query for card name/description"},"subset":{"type":"string","description":"Filter by subset within the set (exact match, e.g. 'Base Set', 'Chrome')"},"category":{"type":"string","description":"Filter by category (e.g., 'Baseball', 'Basketball')"},"page_size":{"type":"integer","default":50,"maximum":100,"minimum":1,"description":"Number of results per page (1-100)"},"raw_images_only":{"type":"boolean","description":"Image preference. Omitted (default): return the raw card photo, falling back to the graded slab image only when no raw photo exists. true: force raw-only (no graded fallback). false: prefer the graded slab image."}}},"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_zk3etKwYWdvKysqJ5_hg4","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":"Search and filter trading cards by player, set, subset, category, card number, rookie status, and more with paginated results.","exampleAgentPrompt":"Search Card Hedger for rookie baseball cards of Shohei Ohtani in the 2025 Topps Baseball set, Base Set subset, and show me the first 25 results with raw card photos.","exampleUseCases":[{"title":"Rookie card discovery for new collector","prompt":"Find all rookie cards for Wander Franco in the baseball category on Card Hedger — show me up to 50 results with raw images."},{"title":"Browsing a specific set and subset","prompt":"Can you search Card Hedger for cards from the 2024 Topps Chrome subset within the 2024 Topps Baseball set and show me page 2 with 25 results per page?"},{"title":"Looking up a card by number","prompt":"I need to find card number 150 from the 2025 Topps Baseball set on Card Hedger — pull it up with graded slab images if available."}],"resultDescription":"Returns a paginated list of trading card records matching the specified filters, including card names, set and subset details, card numbers, images (raw or graded slab based on preference), and other card metadata. Pagination details indicate total results and available pages.","failureModes":["Invalid filter combination returns empty result set","Exact-match fields (number, subset) return no results if spelling differs from database","Page number beyond available pages returns empty list","page_size exceeding maximum of 100 is rejected","Malformed request body returns validation error"],"whenToPreferThis":"Use this endpoint when you need to discover or browse trading cards by flexible criteria such as player name, set, subset, category, or rookie status. It is ideal for exploration and inventory-style queries. Prefer sibling endpoints for fetching prices or comparable sales once a card_id is known from search results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T12:34:11.148Z","isFirstParty":false,"canonicalSlug":"card-hedge-card-search-3ab15ffe"}