CardNexus Public API
Programmatic access to the CardNexus marketplace and catalogue.
The Public API exposes accounts, inventory, listings, orders, payouts, and the catalogue spanning Magic: The Gathering, Pokémon, One Piece, and the rest of the games CardNexus supports.
What this documentation covers
- Quickstart. Mint a key, make your first request.
- Guides. Authentication, API keys, rate limits, error handling, pagination, webhooks.
- Recipes. End-to-end worked examples — start with Sync inventory.
- API Reference. Every endpoint and its full request/response schema, with a built-in request playground.
Conventions
- All endpoints sit under
/v1/. The base URL ishttps://public-api.cardnexus.com/v1. - Authentication is a single bearer token (an API key) in the
Authorizationheader. See Authentication. - Request and response bodies are JSON. Dates are ISO 8601 in UTC. Money is an
{ amount, currency }pair whereamountis the decimal value in the currency's major unit (e.g.5.23for €5.23, two decimal places for EUR/USD/GBP). - Errors come back in a single envelope:
{ code, status, message, data }. See Error handling.
Getting started
- Open API keys — mint a key from your CardNexus account.
- Run through the Quickstart — your first authenticated call in under five minutes.
- Browse the API Reference — interactive request playground, full schema docs.