Prices

Price endpoints for market movers, trends, and analytics. All prices are tracked per printing type (Normal and Foil/Holofoil).

Top Price Movers

GET /v1/prices/top-movers

Authentication: API key required

Returns cards with the biggest price changes.

Query Parameters:

Parameter	Type	Description
`game`	string	Filter by game slug
`direction`	string	`up` or `down` (default: `up`)
`period`	string	`24h`, `7d`, or `30d` (default: `24h`)
`printing`	string	Filter by `Normal` or `Foil` (optional)
`type`	string	Filter by `Cards` or `Sealed Products` (optional)
`limit`	integer	Number of results (default: 20, max: 50)

Example:

# Top gainers in Pokemon today
curl "https://api.tcgapi.dev/v1/prices/top-movers?game=pokemon&direction=up" \
  -H "X-API-Key: YOUR_KEY"

# Biggest drops in Foil cards this week
curl "https://api.tcgapi.dev/v1/prices/top-movers?direction=down&period=7d&printing=Foil" \
  -H "X-API-Key: YOUR_KEY"

Response:

{
  "data": [
    {
      "card_id": 12345,
      "name": "Charizard ex",
      "set_name": "Obsidian Flames",
      "game_name": "Pokemon",
      "product_type": "Cards",
      "foil_only": 0,
      "printing": "Normal",
      "market_price": 24.99,
      "price_change": 15.5,
      "image_url": "https://..."
    }
  ]
}

Printing / Variant Types

Each card can have multiple printing variants with separate pricing. The variant names vary by game:

Pokemon:

Variant	Description
`Normal`	Standard non-foil
`Holofoil`	Holographic foil
`Reverse Holofoil`	Reverse holographic pattern
`1st Edition`	First edition printing
`Unlimited`	Unlimited run printing

Yu-Gi-Oh!:

Variant	Description
`1st Edition`	First edition printing
`Unlimited`	Unlimited run printing
`Limited`	Limited edition printing

Magic: The Gathering:

Variant	Description
`Normal`	Standard non-foil
`Foil`	Foil printing

Flesh and Blood:

Variant	Description
`Normal`	Standard non-foil
`Rainbow Foil`	Rainbow foil finish
`Cold Foil`	Cold foil finish
`1st Edition Normal`	First edition, non-foil
`1st Edition Rainbow Foil`	First edition, rainbow foil
`1st Edition Cold Foil`	First edition, cold foil
`Unlimited Edition Normal`	Unlimited, non-foil
`Unlimited Edition Rainbow Foil`	Unlimited, rainbow foil

Lorcana:

Variant	Description
`Normal`	Standard non-foil
`Holofoil`	Holographic foil
`Reverse Holofoil`	Reverse holographic

Use ?printing= on any price endpoint to filter by variant name (exact match).

Price Data Fields

Every price object includes:

Field	Type	Description
`printing`	string	`Normal` or `Foil`
`market_price`	number	TCGPlayer market price (median of recent sales)
`low_price`	number	Lowest verified listing price
`median_price`	number	Median listing price across all sellers
`lowest_with_shipping`	number	Lowest price including shipping
`buylist_price`	number	Buylist market price (what stores pay)
`price_change_24h`	number	Percentage change vs. yesterday
`price_change_7d`	number	Percentage change vs. 7 days ago
`price_change_30d`	number	Percentage change vs. 30 days ago
`last_updated_at`	string	ISO timestamp of last price update

Price change values are percentages (e.g., 15.5 means +15.5%). A null value means insufficient data to compute the change.

Sealed Products

Sealed products (booster boxes, tins, ETBs, cases) have their own pricing tracked separately. Filter with ?type=Sealed Products on search and set endpoints.

Sealed products are identified by:

product_type: "Sealed Products"
shipping_category_id: 3 (box) or 4 (case)
Listings show condition: "Unopened" instead of Near Mint, etc.

Update Frequency

Game Tier	Update Schedule
Tier 3 (Pokemon, Magic, Yu-Gi-Oh)	Daily at 2 AM EST
Tier 2 (One Piece, Lorcana, etc.)	Daily at 3 AM EST
Tier 1 (Dragon Ball, Vanguard, etc.)	Monday + Thursday
Tier 0 (niche games)	Weekly (Sunday)