Quickstart
Make your first API request in under 5 minutes.
1. Create an Account
Go to dashboard.cardprices.io/signup and create a free or paid account.
2. Create an API Key
In your dashboard, navigate to API Keys and click New Key. Copy the key — it's only shown once.
Your key will look like:
pub_live_a1b2c3d4e5f6...3. Make Your First Request
curl "https://api.cardprices.io/public/v1/cards?game=yugioh&limit=5" \
-H "X-API-Key: pub_live_YOUR_KEY_HERE"Response
List endpoints return a flat envelope with the results under a named array (cards here).
{
"game": "yugioh",
"total": 12847,
"page": 1,
"limit": 5,
"totalPages": 2570,
"cards": [
{
"_id": "60f1a0b2c3d4e5f6a7b8c9d0",
"name": "Blue-Eyes White Dragon",
"rarity": "Ultra Rare",
"number": "LOB-001",
"productId": 100042,
"image": "https://assets.yugioh.cardprices.io/100042.jpg"
}
]
}4. Handle Errors
Errors return a machine-readable error code plus a human-readable message:
{
"error": "CREDITS_EXHAUSTED",
"message": "Monthly credits exhausted. Upgrade your plan or wait for the next billing cycle."
}| Status | Common codes | Meaning |
|---|---|---|
400 | INVALID_GAME, INVALID_PERIOD, INVALID_DIRECTION, INVALID_CARD_ID, VALIDATION_ERROR, KEY_LIMIT_REACHED | Bad request / invalid parameters |
401 | MISSING_API_KEY, INVALID_API_KEY | Missing, invalid, or revoked API key |
403 | SUBSCRIPTION_INACTIVE, INSUFFICIENT_PLAN | Subscription inactive, or plan lacks this endpoint |
404 | NOT_FOUND | Resource not found |
429 | RATE_LIMIT_EXCEEDED, CREDITS_EXHAUSTED | Rate limit hit, or monthly credits used up |
500 | — | Server error |
There is no 402. When your monthly credits run out the API returns 429 CREDITS_EXHAUSTED —
check the error code, not just the status, to distinguish it from a rate-limit 429.