Prices on singles move every day, and most shops can't recheck thousands of cards by hand. A small repricing job does it overnight: it reads current prices for everything you stock, applies your rules and updates your listings before you open.
This guide works whether you sell on Shopify, another online cart, a marketplace of your own or only at the counter.
Step 1: match your stock to cards, once
Every item you sell needs a card_id and the condition and printing of your copy. Do this once and store it next to your own product or SKU.
The fastest way is by set and collector number, which most inventory files already have:
GET /v1/cards?game=Pokemon&set=Base Set&number=4/102
GET /v1/cards?game=Magic: The Gathering&name=Lightning Bolt
Then pick the SKU that matches your copy from the card's prices (printing, condition, language) and store its sku_id. IDs never change, so you never have to match a card twice. Cards you add later only need matching when they arrive.
Step 2: look up prices in bulk every night
Send your card_id values in batches with POST /v1/cards/lookup. Each batch counts as one request.
import csv
import os
import requests
API = "https://tcgpriceapi.com"
HEADERS = {"X-API-Key": os.environ["TCGPRICEAPI_KEY"]}
BATCH = 100 # your plan's cards per request
with open("inventory.csv", newline="", encoding="utf-8") as file:
stock = list(csv.DictReader(file)) # columns: your_sku, card_id, sku_id, quantity
card_ids = sorted({row["card_id"] for row in stock})
prices = {}
for start in range(0, len(card_ids), BATCH):
answer = requests.post(f"{API}/v1/cards/lookup", headers=HEADERS, timeout=60,
json={"card_ids": card_ids[start:start + BATCH]})
answer.raise_for_status()
for card in answer.json()["cards"]:
for sku in card["skus"]:
prices[sku["sku_id"]] = sku
Market prices refresh every 6 hours, so a job that runs once a night always reads fresh numbers.
Step 3: apply your own rules
The API gives you the numbers exactly as reported. The pricing decisions stay yours. A common set of rules:
- Start from the market price of the exact SKU you hold.
- Check the cheapest listing.
listing_price_lowpluslisting_price_low_shippingis what a buyer would pay elsewhere today. Pricing far above it slows sales. - Set a floor so bulk cards never drop below what it costs you to list and ship them.
- Round the way you like, such as to the nearest .49 or .99.
- Skip big swings for review. If a price moves more than, say, 30% overnight, flag it for a person to check before it goes live.
def new_price(sku, floor=0.25, margin=1.0):
market = sku["market_price"]
if market is None:
return None # no recent sales: keep your current price
return max(floor, round(float(market) * margin, 2))
Step 4: update your store
Send the new prices to wherever you sell:
- Shopify and other carts: update each product variant's price through the cart's admin API, matching on the product ID you stored in step 1.
- Marketplaces: most accept a price file upload or have their own API.
- The counter: print an updated price list or new tags for the cases that changed most.
Keep a log of old and new prices. It lets you undo a bad run and shows you which cards are moving.
How many requests this takes
One price lookup per batch of cards, once a day. For a store with 5,000 cards in stock:
| Plan | Cards per request | Requests a night for 5,000 cards | Daily card limit |
|---|---|---|---|
| Starter | 20 | 250 | 1,000 cards a day |
| Pro | 100 | 50 | none |
| Business | 200 | 25 | none |
Starter allows business use and suits a shop that reprices up to 1,000 cards a day, for example its most valuable cards or one game at a time. A shop that reprices its whole stock every night usually wants Pro, which has no daily card limit and leaves plenty of requests for counter lookups during the day.
Going further
- Buy prices too. The same data powers a buylist. See how to build a buylist tool for your game shop.
- Watch your best sellers. Pull 30 days of sold history for your top cards to see how many copies sell a day (
quantity_sold) before you restock. - Price new arrivals at the counter. Search or scan a card, and look up its prices in the same minute.
Every paid plan allows commercial use, from Starter up. Compare them on the pricing table.