Historical Data

TCG Sales History API

Access complete trading card sales history. Track price trends, analyze market movements, and make data-driven decisions with historical sales data.

What Data Do You Get?

Complete information about every sale, giving you the context you need for accurate analysis.

Sale Date & Time

Exact timestamp of when each card was sold on the marketplace.

Sale Price

The actual price the card sold for, not listing price.

Card Condition

The condition of the sold card (NM, LP, MP, HP, Damaged).

Quantity Sold

How many copies were sold in each transaction.

Variant Info

Which variant was sold - foil, 1st edition, special treatment, etc.

Seller Data

Information about the seller for context on pricing.

Two endpoints, two use cases

Live recent sales · Full historic archive

Pick the surface that matches your job. Both are Business+.

Live Recent Sales

GET /api/v2/sales-history/:productId

Pulled live from the TCGPlayer marketplace transaction feed on every call. Returns roughly the most recent ~100 sales with date, condition, variant, and price paid.

Best for:

  • "What just sold" tickers and dashboards
  • Short-window statistics and price-spike detection
  • Up-to-the-minute valuation reads
New

Full Historic Sales (Filterable)

GET /api/v2/sales-history/:productId/full

Reads from our stored archive — 90+ days of 3-day rolling buckets per (condition, variant, language) SKU. Server-side filters by condition, variant, language, from/to dates, and salesOnly.

Best for:

  • Long-term trend charts (multi-month rolling averages)
  • Per-condition inventory pricing (NM vs LP vs MP)
  • Per-variant analysis (Foil vs Normal sale prices)
  • CSV exports of the full archive in one call
Developer Ready

Simple API Integration

Get sales history data with a simple API call. Here's an example response:

API Response - Sales History
{
  "productId": 85764,
  "name": "Charizard",
  "set": "Base Set",
  "salesHistory": [
    {
      "saleDate": "2024-12-15T14:32:00Z",
      "price": 285.00,
      "condition": "Near Mint",
      "printing": "Holofoil",
      "quantity": 1,
      "seller": "CardShopPro"
    },
    {
      "saleDate": "2024-12-14T09:15:00Z",
      "price": 245.00,
      "condition": "Lightly Played",
      "printing": "Holofoil",
      "quantity": 1,
      "seller": "TCGDeals"
    },
    {
      "saleDate": "2024-12-13T16:48:00Z",
      "price": 299.99,
      "condition": "Near Mint",
      "printing": "Holofoil",
      "quantity": 1,
      "seller": "VintageCards"
    }
  ],
  "totalSales": 156,
  "averagePrice": 267.50
}
Use Cases

What Can You Build?

Sales history data enables powerful analytics and decision-making tools.

Price Trend Analysis

Track how card prices change over time. Identify spikes, drops, and seasonal patterns.

Market Research

Understand market dynamics, trading volumes, and price movements for informed decisions.

Fair Trade Valuation

Use actual sales data to ensure fair prices in trades and purchases.

Investment Tracking

Monitor the performance of cards in your collection as investments over time.

Frequently Asked Questions

Common questions about our Sales History API.

What sales history data does the API provide?

Our Sales History API provides complete sold listing data including sale date, price, card condition, quantity, and seller information for cards sold on TCGPlayer across all supported games.

How far back does the sales history go?

TCGAPIs maintains extensive sales history data going back several years, allowing you to analyze long-term price trends and market movements for any trading card.

Can I filter sales history by condition?

Yes, you can filter sales history by card condition (Near Mint, Lightly Played, etc.), date range, price range, and other parameters to get exactly the data you need.

How often is sales history updated?

Sales history data is updated multiple times daily as new transactions are recorded on TCGPlayer. Recent sales are typically available within hours.

Which trading card games have sales history?

Sales history is available for all 80+ trading card games we support, including Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Flesh and Blood, One Piece, and more.

Related API Features

Combine sales history with other data for complete market insights.

Ready to Analyze Price History?

Get access to comprehensive sales history data for all supported trading card games.