Card Hedge

Get Top Movers

Get Top Movers (Weekly Price Gainers) Get the cards with the largest price gains over the past week. Gains of 500% or more are filtered out as likely data errors, so results reflect realistic market movement. Results are cached for 1 hour. **Example curl:** ```bash # All categories curl -H "X-API-Key: your-api-key-here" \ "{base_url}/v1/cards/top-movers?count=20" # Baseball only curl -H "X-API-Key: your-api-key-here" \ "{base_url}/v1/cards/top-movers?count=20&category=Baseball" ```

Search Cards

Search Cards Search for cards with flexible filtering options. Searches CardHedge database with optional filters for search query, set, category, player, card number, subset, and rookie status. Supports pagination to iterate through large result sets. **Response includes:** - `pages`: Total number of pages available - `count`: Total number of matching cards - `cards`: Array of card objects for the current page **Example curl:** ```bash curl -X POST -H "X-API-Key: your-api-key-here" \ -H

Match Card

Match a Card from a Text Description (AI) Match a natural language card description to the best card in the CardHedge database. Uses AI to evaluate search results and return the single best match with a confidence score. **How it works:** 1. Your query is sent to the card search API to find candidates 2. An LLM evaluates each candidate against your description 3. The best match is returned with a confidence score (0.0 - 1.0) **Confidence levels:** - **0.9 - 1.0**: Very high confidence — near

Search Sets

Search Card Sets Search for card sets with optional name and category filters. Search the CardHedge database for sets by name and/or category. Useful for populating set dropdowns, browsing available sets, or finding specific product lines. **Parameters:** - `search`: Optional text query matched against set names (e.g., "Topps Chrome", "Pokemon 151") - `category`: Optional category filter (e.g., "Baseball", "Basketball", "Pokemon", "Football") - `count`: Number of results to return (1-100, def

Search Cards Sorted

Search Cards with Sorting Search for cards from the database with full-text search, filtering, sorting, and pagination. **⚠️ Required:** At least one filter parameter (`search`, `set`, `category`, or `player`) is required. **Search Parameter:** - `search`: Full-text fuzzy search across card description and player names - Supports multiple keywords: "Shohei Ohtani rookie" matches cards containing all terms **Filter Parameters (exact match):** - `player`: Exact player name match (e.g., "Mike T

Get Card Details

Get Card Details by ID Get detailed information for a specific card by its ID. Requires a card_id. If you only have a card name/description, call `card-match` or `card-search` first to get the card_id, then use it here. Fetches card details from CardHedge database using the card's unique identifier. Returns the same data structure as card search endpoint. **Example curl:** ```bash curl -X POST -H "X-API-Key: your-api-key-here" \ -H "Content-Type: application/json" \ -d '{"card_id":

Get Prices By Cert

Get Price History by Certificate Number Get card information and pricing by grader certificate number. This endpoint performs a multi-step lookup: 1. Checks the persistent validated-certificate cache; queries GemRate only when that certificate has not been successfully retrieved before 2. Fetches card details from CardHedge using GemRate IDs 3. Fallback: if step 2 finds no card, matches the GemRate description against the AI `card-match` endpoint 4. Retrieves price history for the card a

Get Details By Certs

Get Card Details by Certificate Numbers (Batch) Get card details for multiple certificate numbers in a single request. This endpoint performs batch lookups without price history: 1. Checks the persistent validated-certificate cache for each certificate; queries GemRate only for certificates not successfully retrieved before 2. Fetches card details from CardHedge using GemRate IDs 3. Fallback: if step 2 finds no card, matches the GemRate description against the AI `card-match` endpoint 4.

Get Price History

Get Price History for a Card Get price history for a specific card and grade. Requires a card_id. If you only have a card name/description, call `card-match` or `card-search` first to get the card_id, then use it here. Returns daily price points for the card at the requested grade. By default the window ends today, so `days` alone reaches back at most one year (366 days). Results are cached for improved performance. ## Getting price history older than one year Set `end_date` to shift the `d

Get Comps

Get Comparable Sales (Comps) Get comparable sales (comps) for a card, with anomaly filtering and optional time-weighting. Requires a card_id. If you only have a card name/description, call `card-match` or `card-search` first to get the card_id, then use it here. This endpoint: 1. Fetches the most recent sales for the card at the requested grade 2. Filters only statistical price anomalies using IQR fences (keeps non-anomalous highs/lows) 3. Calculates comp price using either: - Simple avera

Get All Prices

Get Latest Prices Across All Grades Get all latest prices for a card across all available grades. Requires a card_id. If you only have a card name/description, call `card-match` or `card-search` first to get the card_id, then use it here. This endpoint returns the most recent price for each grade/grader combination available for the specified card. Includes prices from all major grading companies (PSA, BGS, SGC, CGC, CSG, HGA) plus raw (ungraded) prices. The response includes: - Grade and gr

Estimate Price

Get Price Estimate for a Card Get a price estimate for a card at a specific grade. Requires a card_id. If you only have a card name/description, call `card-match` or `card-search` first to get the card_id, then use it here. This endpoint uses CardHedge's correlated price estimation service to provide price estimates with confidence intervals. The estimation can use either direct sales data or correlated pricing from similar cards. **Response Fields:** - `price`: Estimated price in USD - `pri

Get Card Fmv

Get Fair Market Value (FMV) for a Card Get the Fair Market Value (FMV) for a card at a specific grade. Requires a `card_id`. If you only have a card name/description, call `match-card` or `card-search` first to resolve it. ## What FMV is FMV is CardHedge's smoothed valuation for a card at a specific grade, computed by an underlying pricing service that: 1. Looks for a direct price for this card+grade, and if found, replaces the raw `latest_price` with a **Winsorized-median FMV** computed

Get Fmv By Cert

Get Fair Market Value (FMV) by Certificate Number Get the Fair Market Value (FMV) for a card by grader certificate number. Convenience wrapper that chains a certificate lookup into an FMV valuation, so callers holding only a cert number do not need to resolve the card themselves. ## How it works 1. Checks the persistent validated-certificate cache; queries GemRate only when that certificate has not been successfully retrieved before. 2. Resolves the card in CardHedge using the GemRate IDs

Get Total Sales By Player

Get Total Sales Count by Player Get total sales counts per player/character over a recent window. Counts sales records from the last N days that mention each player or character name. Returns only the counts — no individual sale records — so it stays fast even for high-volume players. **Parameters:** - `players`: List of player/character names (max 25) - `days`: Look-back window in days (default: 30, max: 365) ### Responses: **200**: Successful Response (Success Response) Content-Type: appl