BinderDex API

BinderDex API

Overview

What the API returns and where to begin.

A read-only Pokemon and One Piece price API

BinderDex API is live. It gives you search, card detail, daily price history, batch pricing, sets, and market movers for BinderDex's Pokemon and One Piece catalog and display prices, protected by a bearer API key. Filter any of those by game with ?game=pokemon or ?game=one-piece.

Every operation returns integer USD cents with an explicit currency, UTC timestamps, explicit null for missing data, and a stable opaque id for every card and set. Errors use the RFC 9457 application/problem+json envelope described in rate limits and errors.

Eleven operations

  • Search cards: GET /v1/cards. Name, set, number, rarity, condition, variant, or price range, paginated with a cursor. Sort by relevance, price, recency, or 7-day price change.
  • Get a card: GET /v1/cards/{id}. Full detail with prices by variant and condition, plus 7-day and 30-day change.
  • Get a card's price history: GET /v1/cards/{id}/prices. A daily series, up to full history depending on your plan.
  • Get a card's price statistics: GET /v1/cards/{id}/price-stats. Min, max, average, first/last price, and percent change over a 7, 30, or 90 day window, broken out per variant. Starter plan and above.
  • Batch cards: POST /v1/cards/batch. Full card detail for up to 200 cards in one call.
  • Batch prices: POST /v1/prices/batch. Current price for up to 200 cards in one call, depending on your plan.
  • List games: GET /v1/games. The games BinderDex serves, with set and card counts.
  • List sets: GET /v1/sets. Series, release date, card count.
  • Get a set: GET /v1/sets/{id}. Plus its 10 highest-value cards.
  • Market movers: GET /v1/market/movers. Biggest 7-day gainers or decliners.
  • Usage: GET /v1/usage. Your remaining rate limit and daily quota. Free to call.

Start with the quickstart, then read authentication and conventions. The full machine-readable contract is at /openapi.json; an AI agent should read Use with AI assistants. See pricing for plan limits and cost.

Scope

Prices are BinderDex display prices: USD market estimates per variant and condition, for BinderDex's own Pokemon and One Piece catalog. Sold listings, graded prices, sealed products, and user data are not part of /v1. See the API Terms for attribution, caching, and redistribution rules.

Questions

Contact us with integration questions, or email [email protected].