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 is https://public-api.cardnexus.com/v1.
  • Authentication is a single bearer token (an API key) in the Authorization header. See Authentication.
  • Request and response bodies are JSON. Dates are ISO 8601 in UTC. Money is an { amount, currency } pair where amount is the decimal value in the currency's major unit (e.g. 5.23 for €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

  1. Open API keys — mint a key from your CardNexus account.
  2. Run through the Quickstart — your first authenticated call in under five minutes.
  3. Browse the API Reference — interactive request playground, full schema docs.