Get Sales Trends by Category (Matched Sales Only)
Changed onMatched sales only. A matched sale is a sale Card Hedge has linked to a specific card in its catalog. This endpoint includes only matched sales whose linked card has a known category. Unmatched sales are excluded from every count, total amount, and average price. These statistics do not represent all marketplace sales in a category.
Return daily, weekly, or monthly sale counts, total amounts (USD), and average sale prices grouped by the linked card's category. Category names match exactly, ignoring case and surrounding whitespace. A category word appearing in a sale title does not qualify that sale for inclusion.
A zero count means no qualifying matched sales were found for the category and period; it does not mean no marketplace sales occurred. Unknown categories also return zero statistics.
Like sales-stats-by-player, buckets are UTC calendar days, ISO weeks (Monday–Sunday), or months, ordered oldest to newest. periods includes the current partial bucket when include_current is true. The response's scope: matched_only distinguishes these statistics from all-market sales.
Completed buckets are cached for 24 hours; the current partial bucket for 5 minutes. Day and period boundaries use separate cache keys. Results reflect indexed card links and may lag changes by the cache TTL. Redis failures fall back to querying OpenSearch. Limits: 25 categories, day ≤ 90 / week ≤ 52 / month ≤ 24 periods, and 150 total buckets.
Request
- Base URLhttps://api.cardhedger.com
- AuthAPI key in header X-API-Key
Request body
Response
Successful Response
Changes
- info
endpoint added
- info