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 days window into the past and page backwards, one window at a time. Each response covers (end_date - days, end_date] — exclusive start, inclusive end — so consecutive pages are contiguous and never overlap or skip a day.

Paging by calendar year:

Stop paging when a response returns an empty prices list — you have reached the start of the card's history (price coverage generally begins around spring 2020). Use days: 366 for leap years so the page covers the full calendar year; end_date may not be in the future.

Windows that end in the past are immutable, so they are cached longer (24 hours) than live windows (1 hour) — historical pages are fast and cheap to re-request.

Example curl:

# Default: 180 days of price history
curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{
       "card_id": "1587446850514x224832321163624450",
       "grade": "PSA 9"
     }' \
     "https://api.cardhedger.com/v1/cards/prices-by-card"

# Custom: 30 days of price history
curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{
       "card_id": "1587446850514x224832321163624450",
       "grade": "PSA 9",
       "days": 30
     }' \
     "https://api.cardhedger.com/v1/cards/prices-by-card"

# Historical: calendar year 2024 (366 days, leap year)
curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{
       "card_id": "1587446850514x224832321163624450",
       "grade": "PSA 9",
       "days": 366,
       "end_date": "2024-12-31"
     }' \
     "https://api.cardhedger.com/v1/cards/prices-by-card"

Returns price history (default window: 180 days; max: 366 days per window).

{
  "card_id": "1587446850514x224832321163624450",
  "days": 180,
  "grade": "PSA 9"
}

{
  "prices": [
    {
      "Grade": "PSA 9",
      "card_id": "1587446850514x224832321163624450",
      "closing_date": "2025-10-26T23:59:00.000Z",
      "price": "337.67"
    },
    {
      "Grade": "PSA 9",
      "card_id": "1587446850514x224832321163624450",
      "closing_date": "2025-10-25T23:59:00.000Z",
      "price": "337.00"
    },
    {
      "Grade": "PSA 9",
      "card_id": "1587446850514x224832321163624450",
      "closing_date": "2025-10-24T23:59:00.000Z",
      "price": "331.29"
    }
  ]
}