# Card Hedge - Prices by Grader Certificate

> Card Hedge - Prices by Grader Certificate is a paid API for AI agents from api.cardhedger.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-27).

Looks up trading card information and historical sale pricing by a grader certificate number (e.g. PSA cert).

## Facts

- Endpoint: POST https://api.cardhedger.com/v1/agent/cards/prices-by-cert?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-27
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/card-hedge-prices-by-grader-certificate-e72e7a95
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hsnA1RfCB3A6cHw_9PbSd

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-prices-by-grader-certificate-e72e7a95 -d '<json body>'
```

Example prompt: Can you look up the card info and last 90 days of sale prices for PSA certificate number 12345678?

## When to prefer this

Use this endpoint when you have a specific grader certificate number and need to retrieve verified card identity and pricing history directly tied to that certified copy. It is more precise than keyword-based card searches because it identifies the exact graded card instance, not just a card title or set.

## Known failure modes

- Certificate number not found — grader does not have a record for that cert
- Invalid grader name — only supported grading companies accepted
- Days parameter out of range (must be 1–365)
- No sales data available for the certificate in the requested time window
- API authentication or payment failure

## How this service works

Get card information and pricing by grader certificate number.

## Output

Returns card identification details (name, year, grade, set, etc.) and historical sale price data for the specified certificate number over the requested time window, drawn from the specified grading company's records.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cert": {
   "type": "string",
   "description": "Certificate number to lookup"
  },
  "days": {
   "type": "integer",
   "default": 180,
   "maximum": 365,
   "minimum": 1,
   "description": "Number of days of price history to retrieve (1-365, defaults to 180)"
  },
  "grader": {
   "type": "string",
   "default": "PSA",
   "description": "Grading company (defaults to PSA)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/card-hedge-prices-by-grader-certificate-e72e7a95/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)
