BinderDex API
Get a card
GET /v1/cards/{id}
GET/v1/cards/{id}
Get one card by id or slug: identity, set, image, public URL, and current prices for every variant/condition BinderDex tracks, each with 7-day and 30-day change. Use this after cards_search resolves the right card.
Auth: send Authorization: Bearer bdx_live_... (or X-API-Key) from a server-side integration. Sandbox keys get 403 sandbox_key.
Response shape
| Field | Type | Required | Description |
|---|---|---|---|
game | string | null | — | Stable game slug, e.g. pokemon or one-piece. |
game_name | string | null | — | Display name, e.g. Pokémon TCG. |
id | string | — | Opaque, stable card id. |
image_url | string | null | — | BinderDex-hosted image URL (assets.binderdex.com or binderdex.com). null when no hosted image exists. |
name | string | — | — |
number | string | null | — | — |
prices | array<object> | — | — |
prices[].change_30d_cents | integer | null | — | — |
prices[].change_30d_percent | number | null | — | — |
prices[].change_7d_cents | integer | null | — | — |
prices[].change_7d_percent | number | null | — | — |
prices[].condition | string | — | — |
prices[].currency | string | — | Always USD today. "USD" const: USD |
prices[].market_price_cents | integer | — | — |
prices[].price_updated_at | string | — | format: date-time |
prices[].variant | string | — | — |
rarity | string | null | — | — |
set | object | null | — | — |
set.id | string | — | — |
set.name | string | — | — |
url | string | null | — | — |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Card id or slug. |
Example
{
"game": "pokemon",
"game_name": "Pokemon TCG",
"id": "card_9f2c1b7a",
"image_url": "https://assets.binderdex.com/cards/card_9f2c1b7a.png",
"name": "Pikachu ex",
"number": "025",
"prices": [
{
"change_30d_cents": -50,
"change_30d_percent": -3.71,
"change_7d_cents": 10,
"change_7d_percent": 0.78,
"condition": "Near Mint",
"currency": "USD",
"market_price_cents": 1299,
"price_updated_at": "2026-09-18T04:00:00Z",
"variant": "Holofoil"
}
],
"rarity": "Double Rare",
"set": {
"id": "set_ssp",
"name": "Surging Sparks"
},
"url": "https://binderdex.com/cards/pikachu-ex-ssp-025"
}Possible errors
Every error below uses the Error envelope with a request ID. Retry only when the response’s documented semantics identify a temporary condition; see errors and versioning for the detailed guidance.