# PokéWallet

> PokéWallet is a REST API for real-time Pokémon Trading Card Game (TCG) data: a 50,000+ card database with live pricing from TCGPlayer and CardMarket. It also powers BerryWallet, the equivalent REST API for the One Piece Card Game (OPCG), under the same account and API key. The same key also covers ten more trading card games, from Magic: The Gathering and Yu-Gi-Oh! to Disney Lorcana.

PokéWallet is not affiliated with, endorsed by, or connected to Nintendo, Creatures Inc., Game Freak, The Pokémon Company, Bandai, or Shueisha. It is an independent third-party data aggregation service.

## Product facts

- **API base URL:** `https://api.pokewallet.io` (separate from the pokewallet.io marketing/docs site).
- **API style:** REST only (no GraphQL).
- **Free tier:** 100 requests/hour, 1,000 requests/day, forever. No credit card required.
- **Coffee Addicted plan:** pay-what-you-want via Ko-fi. Base 1,000 req/hour, 10,000 req/day; each coffee adds +25% for 1 month.
- **Pro plan:** €20/month, 5,000 requests/hour, 50,000 requests/day, priority support.
- **Ultra plan:** €29/month, 7,000 requests/hour, 70,000 requests/day, priority support. Everything in Pro plus the paid endpoints of the ten other games.
- **Business plan:** custom rate limits, dedicated support, custom integrations, webhook events — contact via Discord. See /pricing for current details and full feature breakdown.
- **Price data sources:** TCGPlayer (USD) and CardMarket (EUR). No other marketplaces (e.g. eBay) or grading data (PSA/CGC) are integrated yet.
- **Card game coverage:** Pokémon TCG (all sets), One Piece Card Game / OPCG (all English and Japanese sets, from OP01 Romance Dawn onward), and ten more TCGs under the same API key: Magic: The Gathering, Yu-Gi-Oh!, Cardfight!! Vanguard, Dragon Ball Super, Flesh and Blood, Digimon, Star Wars Unlimited, Disney Lorcana, Riftbound, Cyberpunk.
- **Other TCGs endpoints:** GET /games (public), and for each game code (mtg, ygo, cfv, dbs, fab, dgm, swu, lor, rft, cpk): GET /{game}/sets, GET /{game}/sets/:set, GET /{game}/cards/:id, GET /{game}/search, GET /{game}/images/:id. Ultra plan (or 7-day trial; Pro is not enough): GET /{game}/prices/:set, GET /{game}/sets/:set/statistics, GET /{game}/sets/:set/completion-value, GET /{game}/sets/trending, GET /{game}/analytics/top-cards. TCGPlayer and CardMarket prices refreshed daily; CardMarket prices per finish (normal, foil); updated_at is the last price change.
- **Plans:** Pro unlocks the paid endpoints of Pokémon and One Piece; Ultra unlocks those of every game, Pokémon and One Piece included.
- **Code examples:** JavaScript, Python, Node.js, and Go snippets are provided in the docs.
- **Official SDKs:** `@pokewallet/sdk` for TypeScript (npm, Node 18+) and `pokewallet` for Python (PyPI, 3.9+, sync and async), MIT licensed. One interface for all twelve games, typed results and errors, automatic pagination. Guide: https://pokewallet.io/developers/sdk
- **MCP server:** hosted at `https://mcp.pokewallet.io/mcp` (Streamable HTTP, `Authorization: Bearer <API key>`), ten read-only tools for MCP clients such as Claude Code, Cursor, VS Code and Gemini CLI. It forwards the caller's own key and stores nothing. Setup: https://pokewallet.io/developers/mcp
- **OpenAPI:** OpenAPI 3.1 specification of the public API at https://pokewallet.io/openapi.json
- **Core Pokémon endpoints:** GET /health, GET /search, GET /cards/:id, GET /cards/:id/price-history (Pro), GET /cards/:id/price-comparison (Pro), GET /cards/:id/variants (Pro), GET /sets, GET /sets/:setCode, GET /sets/:setCode/image, GET /sets/:setCode/statistics (Pro), GET /sets/trending (Pro), GET /sets/:setCode/completion-value (Pro), GET /prices/:setCode (Pro), GET /analytics/top-cards (Pro), GET /images/:id.
- **Core One Piece (BerryWallet) endpoints:** GET /op/sets, GET /op/sets/:setCode, GET /op/cards/:id, GET /op/search, GET /images/:id (shared with Pokémon). Pro: GET /op/prices, GET /op/sets/:set/statistics, GET /op/sets/:set/completion-value, GET /op/sets/trending, GET /op/analytics/top-cards. Price history is Pokémon-only.

## Docs

- [Pokémon TCG API documentation](https://pokewallet.io/api-docs)
- [One Piece Card Game (BerryWallet) API documentation](https://pokewallet.io/api-docs/one-piece)
- [Magic: The Gathering API documentation](https://pokewallet.io/api-docs/magic-the-gathering)
- [Yu-Gi-Oh! API documentation](https://pokewallet.io/api-docs/yugioh)
- [Disney Lorcana API documentation](https://pokewallet.io/api-docs/lorcana)
- [Flesh and Blood API documentation](https://pokewallet.io/api-docs/flesh-and-blood)
- [Dragon Ball Super API documentation](https://pokewallet.io/api-docs/dragon-ball-super)
- [Digimon API documentation](https://pokewallet.io/api-docs/digimon)
- [Star Wars Unlimited API documentation](https://pokewallet.io/api-docs/star-wars-unlimited)
- [Cardfight!! Vanguard API documentation](https://pokewallet.io/api-docs/cardfight-vanguard)
- [Riftbound API documentation](https://pokewallet.io/api-docs/riftbound)
- [Cyberpunk API documentation](https://pokewallet.io/api-docs/cyberpunk)
- [Pricing](https://pokewallet.io/pricing)
- [Card catalog](https://pokewallet.io/catalog)

## Developers

- [TypeScript and Python SDKs](https://pokewallet.io/developers/sdk): install, quickstart, every method, errors and retries
- [MCP server](https://pokewallet.io/developers/mcp): connect Claude Code, Cursor, VS Code, Gemini CLI and other MCP clients
- [OpenAPI 3.1 specification](https://pokewallet.io/openapi.json)
- [Source code](https://github.com/pokewallet-lab/pokewallet-sdk): SDKs, MCP server and OpenAPI file

## Docs for agents

- [Full documentation in one file](https://pokewallet.io/llms-full.txt): every game's endpoints, parameters, errors and example responses, plus the SDK and MCP pages, in Markdown
- Markdown version of each docs page: add `.md` to its URL, e.g. https://pokewallet.io/api-docs/magic-the-gathering.md (Pokémon: https://pokewallet.io/api-docs.md, SDKs: https://pokewallet.io/developers/sdk.md, MCP: https://pokewallet.io/developers/mcp.md)

## Games

The ten trading card games beyond Pokémon and One Piece, each under its own path (`https://api.pokewallet.io/{code}/…`):

- **Magic: The Gathering** — code `mtg`, 514 sets, TCGPlayer and CardMarket prices refreshed daily. Docs: https://pokewallet.io/api-docs/magic-the-gathering
- **Yu-Gi-Oh!** — code `ygo`, 706 sets, TCGPlayer and CardMarket prices refreshed daily. Docs: https://pokewallet.io/api-docs/yugioh
- **Disney Lorcana** — code `lor`, 24 sets, TCGPlayer and CardMarket prices refreshed daily. Docs: https://pokewallet.io/api-docs/lorcana
- **Flesh and Blood** — code `fab`, 128 sets, TCGPlayer and CardMarket prices refreshed daily. Docs: https://pokewallet.io/api-docs/flesh-and-blood
- **Dragon Ball Super** — code `dbs`, 198 sets, TCGPlayer and CardMarket prices refreshed daily. Docs: https://pokewallet.io/api-docs/dragon-ball-super
- **Digimon** — code `dgm`, 106 sets, TCGPlayer and CardMarket prices refreshed daily. Docs: https://pokewallet.io/api-docs/digimon
- **Star Wars Unlimited** — code `swu`, 34 sets, TCGPlayer and CardMarket prices refreshed daily. Docs: https://pokewallet.io/api-docs/star-wars-unlimited
- **Cardfight!! Vanguard** — code `cfv`, 420 sets, TCGPlayer and CardMarket prices refreshed daily. Docs: https://pokewallet.io/api-docs/cardfight-vanguard
- **Riftbound** — code `rft`, 15 sets, TCGPlayer and CardMarket prices refreshed daily. Docs: https://pokewallet.io/api-docs/riftbound
- **Cyberpunk** — code `cpk`, 15 sets, TCGPlayer and CardMarket prices refreshed daily. Docs: https://pokewallet.io/api-docs/cyberpunk

## Product pages

- [PokéWallet — Pokémon TCG API](https://pokewallet.io/)
- [BerryWallet — One Piece Card Game API](https://pokewallet.io/api-docs/one-piece)

## Guides

- [Blog: Pokémon TCG and One Piece TCG market guides, set analyses, and API tutorials](https://pokewallet.io/blog)

## Optional

- [Privacy Policy](https://pokewallet.io/privacy-policy)
- [Terms and Conditions](https://pokewallet.io/terms-conditions)