Founder's PriceUp to 53% off Pro, Business and Enterprise for our first customers, locked in while you stay subscribed paid plansEnds in 8d 05h 08m 57s27 spots leftClaim your spot
DocsGraded sales

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

GEThttps://tcgpriceapi.com/v1/cards/{card_id}/graded
NameTypeDescription
card_idrequiredstringThe card's card_id.
daysintegerHow 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.
graderstringOnly one grading company: PSA, CGC, BGS, SGC or TAG.
gradestringOnly 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.

Request
curl "https://tcgpriceapi.com/v1/cards/card_1c3aaea45434413c/graded?days=90" \
  -H "X-API-Key: YOUR_API_KEY"

Response

Response 200
{
  "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.

FieldTypeDescription
cardcard objectThe card these sales are for.
daysintegerHow many days back the sales go.
sales_countintegerHow many sales there are in the window, across every grade.
gradesarray of grade objectsOne 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

FieldTypeDescription
graderstringThe grading company: "PSA", "CGC", "BGS", "SGC" or "TAG".
gradestringThe grade, such as "10" or "9.5".
specialstring or nullA 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.
qualifierstring or nullA qualifier on the grade, such as "OC" (off center) or "MK" (marks), kept apart from the plain grade. Null when there is none.
labelstringThe grade as one label, such as "PSA 10", "BGS 10 Black Label" or "PSA 9 OC".
sales_countintegerHow many sales of this grade are in the window.
salesarray of sale objectsEach sale, newest first.

Sale

FieldTypeDescription
pricenumberWhat the slab sold for, without shipping, in currency. Passed on exactly as sold: never rounded, averaged or estimated by us.
shippingnumber or nullThe shipping the buyer paid, kept apart from the price. 0 for free shipping, null when unknown.
currencystringThe currency of price and shipping, such as "USD".
sold_onstringThe day it sold (YYYY-MM-DD).
sold_atstring or nullThe exact time it sold (ISO 8601, UTC), when known. Null when only the day is known.
sale_typestring"auction" or "buy_it_now".
best_offerbooleanTrue when a Best Offer was accepted. The shown price may then be the listed price, not what was paid.
printingstring or nullThe 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_offer is 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.