CAcardhedger
Pricing & Valuations

Get Fair Market Value (FMV) for Multiple Cards

Get the Fair Market Value (FMV) for multiple cards in a single request.

Supports up to 100 card/grade combinations per call. Each item is valued independently and the results array preserves request order.

See card-fmv for full documentation of the per-item response, including the 11 possible method values, the movement-index cascade, confidence grading, and how to interpret raw_price vs price.

Error handling

  • A per-item error is returned ONLY when an individual item could not be parsed (e.g., invalid grade format). Other items in the batch are still processed.
  • Items with no underlying sale data return a well-formed result with method: "no_data" and price: null — NOT an error.
  • total_requested and total_successful summarize the batch: total_successful counts items with a non-null price, so no_data items are excluded from that count.

Example curl:

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

Maximum 100 items per request.

post/v1/cards/card-fmv-batch

Request

  • Base URL
    https://api.cardhedger.com
  • Auth
    API key in header X-API-Key

Request body

Response

Successful Response

total_requestedinteger required

Number of items requested

total_successfulinteger required

Number of successful FMV lookups

Example response

{
  "results": [
    {
      "card_id": "1586812246197x228181943611293700",
      "confidence": 0.6616,
      "confidence_grade": "A",
      "fmv_sample_count": 3,
      "fmv_window_days": 7,
      "freshness_days": 1,
      "grade": "PSA 9",
      "grade_label": "PSA 9",
      "grade_value": 9,
      "index_truncated": false,
      "method": "direct",
      "price": 416.25,
      "price_explanation": "Used 7d FMV ($416.25, Winsorized median of 3 daily prints) in place of latest_price $416.25. Fresh (1d) — no movement adjustment applied.",
      "price_high": 435.24,
      "price_low": 397.26,
      "provider": "PSA",
      "raw_price": 416.25,
      "support_grades": 1
    },
    {
      "card_id": "1587446850514x224832321163624450",
      "confidence": 0.9772,
      "confidence_grade": "A",
      "freshness_days": 3,
      "grade": "BGS 9.5",
      "grade_label": "BGS 9.5",
      "grade_value": 9.5,
      "index_truncated": false,
      "method": "direct",
      "price": 2000,
      "price_explanation": "Used latest_price $2000.00 (card_grade_prints direct lookup). Fresh (3d) — no movement adjustment applied.",
      "price_high": 2091.95,
      "price_low": 1908.05,
      "provider": "BGS",
      "support_grades": 1
    }
  ],
  "total_requested": 2,
  "total_successful": 2
}

Changes

No recorded changes to this operation across all 14 revisions of this API.