API reference
Base URL https://data.tcghits.io · authenticate with
Authorization: Bearer tk_live_… (or X-Api-Key). All prices GBP.
Rate limits
| Tier | Calls/day | Burst/min |
|---|---|---|
| Free | 250 | 30 |
| Hobby | 5,000 | 120 |
| Shop | 25,000 | 300 |
Every response carries X-RateLimit-Limit and
X-RateLimit-Remaining. Daily counters reset at 00:00 UTC. 429 = slow down.
GET /v1/cards
Card values, paged. Params: set (set code, e.g. 13),
page, per_page (max 200).
curl -H "Authorization: Bearer $KEY" "https://data.tcghits.io/v1/cards?set=13&per_page=5"
Each card: sold_median_gbp + sold_n (realised UK sales, 120 days, raw copies),
from_gbp (cheapest live UK listing), typical_ask_gbp (ask median — context, not a valuation).
GET /v1/cards/:id
One card by id — or by set/number, e.g. 13/224 — plus daily history
(median_gbp, low_gbp, sold_median_gbp per day).
curl -H "Authorization: Bearer $KEY" https://data.tcghits.io/v1/cards/13/224
GET /v1/sealed · GET /v1/sealed/:id/history
Sealed floors per product (booster_box / booster_pack / trove per set), screened for opened/bulk/mislisted junk before any number is computed; plus daily history per product.
GET /v1/sets
All sets with card counts — the id space for set filters. Hobby+.
GET /v1/index · GET /v1/stats/daily
The UK market index and the daily market stats (sold counts, gross, median, auction/BIN split, sale speed). Available on every tier including Free.
GET /v1/cards/export/all (Shop)
The full catalogue with values in one response — built for shop pricing sheets and buylists.
Errors
| Code | Meaning |
|---|---|
| 401 | Missing/invalid key |
| 402 | Endpoint above your tier — upgrade on the dashboard |
| 429 | Rate limit (per-minute or daily) |
| 400 | Bad parameters (e.g. non-integer paging) |
| 404 | Unknown card / product / endpoint |