Skip to content
rarixsmart binders
B2B · Overview

The Rarix v1 API

A public read-only catalog of every card, figure, and price observation Rarix ingests. Bearer-key auth. Per-tenant rate limits. Image-licensing-clean by default for B2B subjects. Built for the integrations engineer who wants to ship in an afternoon, not negotiate a contract first.

What you can build

  • Price terminals — pull headline + multi-currency prices for any printing, including MTG, Pokemon TCG, Lorcana, One Piece, and figures. USD-canonical, with EUR via Cardmarket where applicable.
  • Catalog mirrors — every canonical card + figure row, every external_ids binding (Scryfall, Pokemon TCG, TCGplayer, Cardmarket, MFC, Pop Mart, …), every set checklist.
  • Grading + grade-candidate intel — image-based centering / corner heuristics on a per-card basis. Submission planner inputs.
  • Pull-rate research — community pulls aggregated across the Rarix user base with Bayesian smoothing. Distinct from vendor-reported rates.
  • Trend / velocity feeds — 24h / 7d / 30d percentage-change rollups per card and per set.

Three rules

1. Bearer auth. Every B2B call carries a Authorization: Bearer rxk_… header. Keys are minted by the Rarix ops team after a partner contract. No self-serve key issuance in v1. See Authentication.

2. Rate limits are per-tenant. Each key carries a tier (default 60 rpm + 2,400 rph). Burst over → 429 with a Retry-After header. See Rate limits.

3. B2B responses are redacted.Pokémon imagery (TPCi fan-content licensed) is stripped from every B2B response. The aggregate social-counts strip (collectors-own / for-trade / wishlisted) is zeroed for B2B subjects — community signal isn’t part of the catalog license. TCGplayer + Cardmarket price ticks are removed (you have your own contracts there). See Redaction & licensing.

Five-line warm-up

A curl-shaped sanity check once you have a key. /v1/cards/:idis the most-hit endpoint. Substitute any printing canonical id.

curl -H "Authorization: Bearer rxk_…" \
  https://api.rarix.app/v1/cards/mtg:lea:232:en:nonfoil

# Returns the canonical card + price + history + altCurrencies +
# rulings + flags + siblings. ~2-5kb payload depending on history
# range. Default 30-day history; pass ?range=3mo|6mo|12mo|all to
# widen.

The full surface area is at Endpoints.

What's not in scope (yet)

  • Write endpoints. v1 is read-only. No POST/PUT/DELETE in the public surface.
  • Webhooks. No push-based price-change subscriptions yet. Poll the trending + velocity feeds for now.
  • OAuth + self-serve. Bearer-only in v1. OAuth scopes are on the roadmap behind the v2 surface.
  • User-PII data. Showcase URLs are public-readable, the underlying user records are not — there’s no user-list endpoint. Discover feeds aggregate-only.

Getting a key

Email b2b@rarix.appwith your company, intended use, and expected request volume. Partner-tier assignment is manual in v1 — we want to know who’s using the surface before higher-tier rate limits land.