# Card Hedge Comparable Sales (Comps)

> Card Hedge Comparable Sales (Comps) is a paid API for AI agents from api.cardhedger.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-28).

Returns comparable sales prices for a specific trading card, with anomaly filtering and optional time-weighting via WMA algorithm.

## Facts

- Endpoint: POST https://api.cardhedger.com/v1/agent/cards/comps?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/card-hedge-comparable-sales-comps-11bcb315
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x9AlhsZbqrWVteRoXpHbd

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability card-hedge-comparable-sales-comps-11bcb315 -d '<json body>'
```

Example prompt: What are the top 10 comps for card ID abc123 graded PSA 10, with time-weighting turned on so recent sales count more?

## When to prefer this

Use this endpoint when you need market-calibrated, anomaly-filtered comparable sales for a specific card and grade — ideal for pricing decisions, valuation, or buy/sell analysis. Prefer this over the raw latest-prices endpoint when you want cleaner, statistically sound comp data rather than all raw prices across grades.

## Known failure modes

- Invalid or unknown card_id — must be resolved first via card-search, card-match, or image-match
- Grade string not recognized or unavailable for that card — returns empty or error
- Count out of range (must be 1–100) — returns validation error
- No sales data available for the requested grade — returns empty comps array
- Payment failure or insufficient USDC balance — request rejected before processing

## How this service works

Get comparable sales (comps) for a card, with anomaly filtering and optional time-weighting. · needs a card_id (resolve via card-search, card-match, or image-match)

## Output

Returns a list of comparable sale prices for the specified card and grade, cleaned of anomalies. If time_weighted is true, recent sales are emphasized using a Weighted Moving Average (WMA) algorithm. If include_raw_prices is true, the unfiltered raw sale data is also returned alongside the comps.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "count": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "Number of comp prices (1-100)"
  },
  "grade": {
   "type": "string",
   "description": "Card grade (e.g., 'PSA 10', 'BGS 9.5')"
  },
  "card_id": {
   "type": "string",
   "description": "Card ID — resolve one via card-search, card-match, or image-match."
  },
  "time_weighted": {
   "type": "boolean",
   "default": false,
   "description": "If true, weight recent sales more heavily using WMA algorithm"
  },
  "include_raw_prices": {
   "type": "boolean",
   "default": false,
   "description": "If true, include raw price data in response"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/card-hedge-comparable-sales-comps-11bcb315/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.cardhedger.com](https://www.zero.xyz/host/api.cardhedger.com/llms.txt)
