BinderDex API
Batch prices
POST /v1/prices/batch
POST/v1/prices/batch
Get current display prices for up to 100 cards in one call, counted as a single request against your rate limit and quota. Use this instead of repeated cards_get calls when pricing a list, binder, or collection.
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 |
|---|---|---|---|
data | array<object> | — | — |
data[].id | string | — | — |
data[].currency | string | — | Always USD today. "USD" const: USD |
data[].market_price_cents | integer | null | — | Integer cents. Divide by 100 for a dollar amount. null when BinderDex has no current price. |
not_found | array<string> | — | Requested ids that do not match any card. |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
ids | array<string> | Yes | 1-100 card ids or slugs. Counts as a single request against your rate limit and quota regardless of how many ids you send. minItems: 1 · maxItems: 100 |
{
"ids": [
"card_9f2c1b7a",
"pikachu-ex-ssp-025",
"card_unknown"
]
}Example
{
"data": [
{
"currency": "USD",
"id": "card_9f2c1b7a",
"market_price_cents": 1299,
"price_updated_at": "2026-09-18T04:00:00Z"
}
],
"not_found": [
"card_unknown"
]
}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.