Docs / API reference
Graded sales
Every recent sale of a graded slab of a card: PSA, CGC, BGS (Beckett), SGC and TAG, grouped by grade. Business and Enterprise.
Request
GET
https://tcgpriceapi.com/v1/cards/{card_id}/graded| Name | Type | Description |
|---|---|---|
card_idrequired | string | The card's card_id. |
days | integer | How many days back to go, from 1 to 365. Defaults to 90: graded cards sell less often than raw ones, so 30 days is often empty. |
grader | string | Only one grading company: PSA, CGC, BGS, SGC or TAG. |
grade | string | Only one grade, such as 10 or 9.5. Special 10s and qualifier grades of it come back too, each in its own group. |
Note
Included on the Business and Enterprise plans. Other plans get a
403 with a note to upgrade. See plans.Counts as one request and one card.
curl "https://tcgpriceapi.com/v1/cards/card_1c3aaea45434413c/graded?days=90" \
-H "X-API-Key: YOUR_API_KEY"import requests
response = requests.get(
"https://tcgpriceapi.com/v1/cards/card_1c3aaea45434413c/graded?days=90",
headers={"X-API-Key": "YOUR_API_KEY"},
timeout=30,
)
response.raise_for_status()
print(response.json())const response = await fetch("https://tcgpriceapi.com/v1/cards/card_1c3aaea45434413c/graded?days=90", {
headers: { "X-API-Key": process.env.TCGPRICEAPI_KEY },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());Response
{
"card": {
"card_id": "card_1c3aaea45434413c",
"name": "Charizard",
"set": "Base Set",
"number": "004/102",
"game": "Pokemon"
},
"days": 90,
"sales_count": 35,
"grades": [
{
"grader": "PSA",
"grade": "8",
"special": null,
"qualifier": null,
"label": "PSA 8",
"sales_count": 1,
"sales": [
{
"price": 1275.00,
"shipping": 5.75,
"currency": "USD",
"sold_on": "2026-11-18",
"sold_at": null,
"sale_type": "buy_it_now",
"best_offer": true,
"printing": null
}
]
},
{
"grader": "CGC",
"grade": "9",
"special": null,
"qualifier": null,
"label": "CGC 9",
"sales_count": 2,
"sales": [
{
"price": 1750.00,
"shipping": 5.65,
"currency": "USD",
"sold_on": "2026-11-15",
"sold_at": null,
"sale_type": "buy_it_now",
"best_offer": false,
"printing": null
},
{
"price": 2000.00,
"shipping": 5.48,
"currency": "USD",
"sold_on": "2026-11-14",
"sold_at": null,
"sale_type": "buy_it_now",
"best_offer": false,
"printing": null
}
]
},
{
"grader": "BGS",
"grade": "9.5",
"special": null,
"qualifier": null,
"label": "BGS 9.5",
"sales_count": 1,
"sales": [
{
"price": 305.00,
"shipping": 5.85,
"currency": "USD",
"sold_on": "2026-10-13",
"sold_at": null,
"sale_type": "buy_it_now",
"best_offer": true,
"printing": null
}
]
}
]
}A real answer from our database for Base Set Charizard, shortened to one grade per company and two sales each.
| Field | Type | Description |
|---|---|---|
card | card object | The card these sales are for. |
days | integer | How many days back the sales go. |
sales_count | integer | How many sales there are in the window, across every grade. |
grades | array of grade objects | One entry per grade with sales, by grading company (PSA, CGC, BGS, SGC, TAG) and then highest grade first. Empty when nothing sold in the window. |
Grade
| Field | Type | Description |
|---|---|---|
grader | string | The grading company: "PSA", "CGC", "BGS", "SGC" or "TAG". |
grade | string | The grade, such as "10" or "9.5". |
special | string or null | A special 10, kept apart from a plain 10: "Black Label" or "Pristine" (BGS), "Pristine" or "Perfect" (CGC), "Pristine" (SGC, TAG). Null for a plain grade. |
qualifier | string or null | A qualifier on the grade, such as "OC" (off center) or "MK" (marks), kept apart from the plain grade. Null when there is none. |
label | string | The grade as one label, such as "PSA 10", "BGS 10 Black Label" or "PSA 9 OC". |
sales_count | integer | How many sales of this grade are in the window. |
sales | array of sale objects | Each sale, newest first. |
Sale
| Field | Type | Description |
|---|---|---|
price | number | What the slab sold for, without shipping, in currency. Passed on exactly as sold: never rounded, averaged or estimated by us. |
shipping | number or null | The shipping the buyer paid, kept apart from the price. 0 for free shipping, null when unknown. |
currency | string | The currency of price and shipping, such as "USD". |
sold_on | string | The day it sold (YYYY-MM-DD). |
sold_at | string or null | The exact time it sold (ISO 8601, UTC), when known. Null when only the day is known. |
sale_type | string | "auction" or "buy_it_now". |
best_offer | boolean | True when a Best Offer was accepted. The shown price may then be the listed price, not what was paid. |
printing | string or null | The printing the sale named, such as "1st Edition", "Unlimited" or "Reverse Holofoil". Null when it didn't say. |
About the data
Each entry is one real sale of a slab on eBay, with the price it sold for and the shipping kept apart. We never average sales or make up a value for a grade, so a grade with no sales in the window is simply left out.
- Special 10s are their own grades, never mixed with a plain 10: BGS Black Label and Pristine, CGC Pristine and Perfect, SGC and TAG Pristine.
- Qualifier grades such as PSA 9 OC (off center) or MK (marks) are their own grades too.
- Lots, raw cards, "PSA 10 candidate" listings, autographed, cracked or resealed slabs, and slabs from other grading companies are left out. So are 10s that sold for far less than the raw card, which are almost always fake slabs.
best_offeris true when a Best Offer was accepted. The shown price can then be the listed price, not what the buyer paid.- A sale is only listed under a card when it is clearly that card. Sales we can't place for certain are left out rather than guessed.
- Pokémon cards in English and Japanese for now. Sales go back to August 20, 2026, and build up from there.