Skip to content
← 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_ref from a candidate into the next request; never parse canonical_id.
  • Cache validators are live. Price, batch, and history honor If-None-Match and can return 304.

Supported now

MethodPathUse
GET/api/v0/healthKeyed health
GET/api/v0/priceSingle-card resolution and pricing
POST/api/v0/price/batchOrdered batch lookup
GET/api/v0/price/historyAggregate price history

/api/v0/coverage and catalog-wide coverage discovery are excluded from this beta.

API Basehttps://api.jkindex.io
Status

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&currency=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.