Every card response carries a prices object. This page explains how it's structured — by raw condition and by graded slab — and what every field means.
The object has two sections. raw is keyed by card condition; graded is keyed by grader, then by grade. Inside each, prices are grouped by source — tcgplayer and ebay.
"prices": {
"raw": {
"near_mint": {
"tcgplayer": { "market": 48.97, "low": 42.50, "mid": 49.99, "high": 64.99 },
"ebay": { "avg_1d": 52.30, "avg_7d": 50.75, "avg_30d": 49.20 }
},
"lightly_played": {
"tcgplayer": { "market": 41.50, "low": 36.00, "mid": 42.00, "high": 50.00 },
"ebay": { "avg_1d": 41.80, "avg_7d": 41.50, "avg_30d": 40.10 }
}
},
"graded": {
"psa": {
"10": { "ebay": { "avg_1d": 425.00, "avg_7d": 418.50, "avg_30d": 410.00 } },
"9": { "ebay": { "avg_1d": 125.00, "avg_7d": 122.00, "avg_30d": 119.50 } }
},
"bgs": {
"10": { "ebay": { "avg_1d": 650.00, "avg_7d": 640.00, "avg_30d": 625.00 } }
}
}
}tcgplayer — listing pricesLive TCGplayer listing data: a market price plus the low/mid/high spread of active listings. Best for a quick “what does this sell for now” read.
ebay — sold averagesRolling averages of actual eBay sold listings over 1d, 7d and 30d. Best for smoothing auction noise and reading real-world demand.
| Field | Source | Meaning |
|---|---|---|
| market | TCGplayer | Current TCGplayer market price. |
| low | TCGplayer | Lowest current listing price. |
| mid | TCGplayer | Mid-point of current listings. |
| high | TCGplayer | Highest current listing price. |
| avg_1d | eBay | 1-day rolling average of sold listings. |
| avg_7d | eBay | 7-day rolling average of sold listings. |
| avg_30d | eBay | 30-day rolling average of sold listings. |
Any field can be null when there isn't enough data for that card, condition, or grade.
Keys under raw use these condition slugs, from best to worst:
| Slug | Condition |
|---|---|
| near_mint | Near Mint |
| mint | Mint |
| lightly_played | Lightly Played |
| moderately_played | Moderately Played |
| heavily_played | Heavily Played |
| damaged | Damaged |
| unopened | Sealed / Unopened |
The graded section is keyed by grader, then by grade value (e.g. "10", "9.5", "9"). Compare spreads by grade — the jump from a 9 to a 10 is often where most of a slab's value sits. Supported graders:
psabgscgcsgcacepcataggmamntThe Free plan returns TCGplayer raw prices only — the ebay and graded sections are omitted entirely (not nulled). Paid plans add eBay sold averages and the full graded breakdown. See rate limits and pricing for the per-plan matrix.
tcgplayer.market as your raw baseline, and eBay rolling averages to validate it against real sales.avg_30d) for stable valuations and shorter windows (avg_1d) to spot momentum.null fields for thinly-traded cards.