← Back to Homepage
Private controlled beta
Known-card USD pricing API v0
Bring a TCG, set, and collector number. Receive deterministic identity resolution, printing candidates, USD price snapshots, batch results, or aggregate history.
The beta contract
- Known cards, not discovery. Inputs are structured identifiers; v0 does not provide fuzzy search or catalog enumeration.
- USD only. Raw NM/LP/MP and PSA 7–10 are the supported price segments. Non-USD and CGC/BGS requests fail closed.
- Ambiguity is actionable. Copy the opaque
candidate_reffrom a candidate into the next request; never parsecanonical_id. - Cache validators are live. Price, batch, and history honor
If-None-Matchand can return304.
Supported now
| Method | Path | Use |
|---|---|---|
| GET | /api/v0/health | Keyed health |
| GET | /api/v0/price | Single-card resolution and pricing |
| POST | /api/v0/price/batch | Ordered batch lookup |
| GET | /api/v0/price/history | Aggregate price history |
/api/v0/coverage and catalog-wide coverage discovery are excluded from this beta.
If you see 404 on /api/v0/*, you're likely calling jkindex.io instead of api.jkindex.io.
First request
curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://api.jkindex.io/api/v0/price?tcg=pokemon&set=jungle&number=64&segment=raw_nm¤cy=usd"
Integration source of truth
The full consumer documentation covers exact outcomes, batch and history schemas, One Piece normalization, freshness, errors, quotas, and conditional caching.