BinderDex API
Get a set
GET /v1/sets/{id}
GET/v1/sets/{id}
Get one set by id or slug, including its 10 highest-value cards by current display price. Use sets_list to find the id first.
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 |
|---|---|---|---|
card_count | integer | null | — | — |
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 | — | — |
name | string | — | — |
release_date | string | null | — | format: date |
series | string | null | — | — |
top_cards | array<object> | — | — |
top_cards[].currency | string | — | Always USD today. "USD" const: USD |
top_cards[].id | string | — | — |
top_cards[].market_price_cents | integer | null | — | Integer cents. Divide by 100 for a dollar amount. null when BinderDex has no current price. |
top_cards[].name | string | — | — |
top_cards[].number | string | null | — | — |
top_cards[].url | string | null | — | — |
url | string | null | — | — |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Set id or slug. |
Example
{
"card_count": 200,
"game": "pokemon",
"game_name": "Pokemon TCG",
"id": "set_ssp",
"name": "Surging Sparks",
"release_date": "2024-11-08",
"series": "Scarlet & Violet",
"top_cards": [
{
"currency": "USD",
"id": "card_9f2c1b7a",
"market_price_cents": 1299,
"name": "Pikachu ex",
"number": "025",
"url": "https://binderdex.com/cards/pikachu-ex-ssp-025"
}
],
"url": "https://binderdex.com/sets/surging-sparks"
}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.