pokewallet

Preview: install from the GitHub release files, see Install in the root README, which also has the quickstart, the full method table and the MCP server.

Official Python SDK for the PokeWallet API: Pokémon, One Piece and ten more card games, with TCGPlayer and CardMarket prices. Python 3.9+, sync and async clients, httpx is the only dependency.

from pokewallet import PokeWallet

# Key format: pk_live_xxx. Keep it in the environment, never in source control.
pw = PokeWallet()  # reads POKEWALLET_API_KEY, or pass api_key=...

page = pw.pokemon.search("charizard", limit=10)
op01 = pw.onepiece.set("OP01")
for card in pw.games.mtg.set_cards("FRA"):
    print(card.name)

Async:

from pokewallet import AsyncPokeWallet

async with AsyncPokeWallet() as pw:
    page = await pw.pokemon.search("pikachu")
    async for card in pw.games.mtg.search_all("lotus"):
        ...

Pokémon, One Piece and the ten games (pw.games.mtg, pw.games.ygo, ... or pw.game(code)) share one interface: search, search_all, card, sets, set, set_cards, prices, statistics, completion_value, trending, top_cards. Pokémon adds price_history.

• Typed errors: AuthError, PlanRequiredError (redeem_url / upgrade_url), FeatureNotEnabledError, RateLimitError, AmbiguousSetError (matches), NotFoundError, UnavailableError, ValidationError.
• Retries: only on 429 (when Retry-After is present, within retry_after_cap, default 30 s, and no quota window is exhausted) and on 503 (up to max_retries, default 2). Never on other 4xx or 5xx.
• Validation: limit and page are checked before the request is sent.
• Normalization: prices are float | None; set identifiers are exposed as set_id / set_code; every object keeps the server value in raw. Ambiguous set answers (200, 300 and 409 on the wire) all raise AmbiguousSetError.
• Key safety: the key is held in a closure and shown as pk_*** by repr, str and errors; clients cannot be pickled.
• Images: image_url(card_id) only builds the URL; the image routes need the X-API-Key header.

The client can be created without a key: health() and list_games() are public and work without one (the X-API-Key header is sent only when a key is set); every other call raises ValidationError before any request is made.

Every request carries User-Agent: pokewallet-sdk-py/<version>.

Attribution: if you show data obtained through the PokeWallet API, SDKs or MCP server to other people, credit PokéWallet with visible text "Data by PokéWallet" (or "Powered by PokéWallet") linking to https://pokewallet.io; private use needs no attribution. See the Terms of Use. This concerns the data and the service; the MIT license of the code is separate.