Get current prices for a card
GET/v1/cards/:card_id/prices
The card's current market price per grade bucket, in
integer USD cents (1850 = $18.50). Requires hobby tier or higher.
How prices are computed. Prices are derived from real, reviewed eBay sales
of the Chinese card. Each grade bucket is the average sale price over the
trailing 7 days; a bucket with no sales that week falls back to its most
recent sale. recent_sale_count is the number of sales seen in the last 7
days across all buckets, and updated_at is when the summary was last
recomputed — prices refresh on an ingestion cadence, not in real time, so
poll updated_at rather than hammering the endpoint.
Buckets. raw (ungraded) plus psa8/psa9/psa10 (PSA-graded) and
other8/other9/other10 (graded by any other company). Hobby keys see
raw with the six graded cells null; pro keys see all seven. Within a
populated cell, price_cents is still null when that bucket has never had
a sale.
404 price_not_found means the card has no price record at all — common for
low-rarity cards, which rarely sell individually on eBay.
Request
Responses
- 200
- 422
Successful Response
Validation Error