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
• price_low: Lower bound of price estimate
• price_high: Upper bound of price estimate
• confidence: Confidence score (0-1)
• method: Estimation method used ('direct' or 'correlated')
• freshness_days: Age of data used for estimation in days
• support_grades: Number of supporting grade data points
• grade_label: Grade label used for estimation
• provider: Grading provider (e.g., 'PSA', 'BGS')
• grade_value: Numeric grade value

Example curl:

curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{
       "card_id": "1586812246197x228181943611293700",
       "grade": "PSA 9"
     }' \
     "https://api.cardhedger.com/v1/cards/price-estimate"

Returns price estimate with confidence bounds and metadata.

{
  "confidence": 0.3809,
  "freshness_days": 2,
  "grade_label": "PSA 9",
  "grade_value": 9,
  "method": "direct",
  "price": 385,
  "price_high": 407.92,
  "price_low": 362.08,
  "provider": "PSA",
  "support_grades": 1
}