Docs / API reference

Price history

A card's sold history over 7 days to a year, per printing, condition and language.

Request

GEThttps://tcgpriceapi.com/v1/cards/{card_id}/history

Name	Type	Description
`card_id`required	string	The card's `card_id`.
`timeframe`	string	`7d` or `30d` (one row per day), `3m` (3 days per row), `6m` or `1y` (one week per row). Defaults to `30d`. Free includes `7d`, Starter up to `30d`, and Pro and up every time frame.
`printing`	string	Only this printing, such as `Holofoil`.
`condition`	string	Only this condition, such as `Near Mint`.
`language`	string	Only this language, such as `English`.

Counts as one request for 7d or 30d. For 3m, 6m or 1y, each card counts as one request.

Request

curl "https://tcgpriceapi.com/v1/cards/card_1c3aaea45434413c/history?timeframe=7d&printing=Holofoil&condition=Near%20Mint" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://tcgpriceapi.com/v1/cards/card_1c3aaea45434413c/history?timeframe=7d&printing=Holofoil&condition=Near%20Mint",
    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/history?timeframe=7d&printing=Holofoil&condition=Near%20Mint", {
  headers: { "X-API-Key": process.env.TCGPRICEAPI_KEY },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

Response

Response 200

{
  "timeframe": "7d",
  "cards": [
    {
      "card_id": "card_1c3aaea45434413c",
      "name": "Charizard",
      "set": "Base Set",
      "skus": [
        {
          "sku_id": "sku_4687030dac764c67",
          "printing": "Holofoil",
          "condition": "Near Mint",
          "language": "English",
          "average_daily_quantity_sold": 0,
          "history": [
            {
              "date": "2026-11-11",
              "market_price": 987.13,
              "sale_price_low": 0,
              "sale_price_low_with_shipping": 0,
              "sale_price_high": 0,
              "sale_price_high_with_shipping": 0,
              "quantity_sold": 0
            },
            {
              "date": "2026-11-10",
              "market_price": 922.32,
              "sale_price_low": 0,
              "sale_price_low_with_shipping": 0,
              "sale_price_high": 0,
              "sale_price_high_with_shipping": 0,
              "quantity_sold": 0
            },
            {
              "date": "2026-11-09",
              "market_price": 987.13,
              "sale_price_low": 0,
              "sale_price_low_with_shipping": 0,
              "sale_price_high": 0,
              "sale_price_high_with_shipping": 0,
              "quantity_sold": 0
            }
          ]
        }
      ],
      "averages": [
        {
          "printing": "Holofoil",
          "date": "2026-11-11",
          "average_sale_price": 0
        },
        {
          "printing": "Holofoil",
          "date": "2026-11-10",
          "average_sale_price": 207.3
        }
      ]
    }
  ],
  "not_found": []
}

A real answer from our database, shortened to the first rows.

Rows are newest first. See History for every field.