---
title: "Get Price Estimate for a Card"
method: POST
path: "/v1/cards/price-estimate"
tags: ["Pricing & Valuations"]
---

# Get Price Estimate for a Card

`POST /v1/cards/price-estimate`

## Request

- Base URL: `https://api.cardhedger.com`
- URL: `https://api.cardhedger.com/v1/cards/price-estimate`
- Auth: API key in header `X-API-Key`

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:**
```bash
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.

## Request body

- PriceEstimateRequest: Request parameters for price estimation endpoint.
  - `card_id` string, required: Unique card identifier from CardHedge
  - `grade` string, required: Card grade (e.g., 'PSA 9', 'PSA 10', 'BGS 9.5')

## Response `200`

Successful Response

- PriceEstimateResponse: Response model for price estimation endpoint.
  - `price` number, nullable: Estimated price in USD (null when no data available)
  - `price_low` number, nullable: Lower bound of price estimate (null when no data available)
  - `price_high` number, nullable: Upper bound of price estimate (null when no data available)
  - `confidence` number, required: Confidence score (0-1)
  - `method` string, required: Estimation method used (e.g., 'direct', 'correlated', 'segment_fallback')
  - `freshness_days` integer, nullable: Age of data used for estimation in days (null for fallback methods)
  - `support_grades` integer, required: Number of supporting grade data points
  - `grade_label` string, required: Grade label used for estimation
  - `provider` string, required: Grading provider (e.g., 'PSA', 'BGS', 'AGS')
  - `grade_value` number, required: Numeric grade value

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cardhedger/apis/card-hedge-api.md) - [All operations](https://skmtc.dev/cardhedger/apis/card-hedge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cardhedger/apis/card-hedge-api/revisions/6de42f192a4d?raw)