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 average (default)
   • Weighted Moving Average (if time_weighted=True), giving recent sales more weight
4. Returns high/low from the filtered sales used in the comp
5. Returns raw_high/raw_low from the unfiltered sales fetched for the request
6. Optionally returns raw price data (if include_raw_prices=True)

Time-Weighting Algorithm (WMA): When time_weighted=True, recent sales are weighted more heavily:

• Most recent sale: weight = n
• Second most recent: weight = n-1
• ...
• Oldest sale: weight = 1
• Formula: (P1n + P2(n-1) + ... + Pn*1) / (n + (n-1) + ... + 1)

Example curl:

# Basic comp (simple average)
curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{
       "card_id": "1587446850514x224832321163624450",
       "count": 10,
       "grade": "PSA 9"
     }' \
     "https://api.cardhedger.com/v1/cards/comps"

# Time-weighted comp with raw prices
curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{
       "card_id": "1587446850514x224832321163624450",
       "count": 10,
       "grade": "PSA 10",
       "time_weighted": true,
       "include_raw_prices": true
     }' \
     "https://api.cardhedger.com/v1/cards/comps"

Returns calculated comp price with anomaly-aware filtering.