Get a card's price history

GET/v1/cards/{id}/prices

Get a daily price series for one card (BinderDex's own display-price history, not a raw upstream feed), optionally filtered to one variant. Use this to answer 'is it going up' questions; cards_get only has the current price plus 7d/30d deltas.

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[].currency`	`string`	—	Always USD today. "USD" const: USD
`data[].date`	`string`	—	format: date
`data[].market_price_cents`	`integer`	—	—
`data[].variant`	`string`	—	—
`days`	`integer`	—	—
`id`	`string`	—	—
`name`	`string`	—	—
`url`	`string \| null`	—	—

Parameters

Name	In	Type	Required	Description
`id`	path	`string`	Yes	Card id or slug.
`days`	query	`integer`	—	Number of trailing days of history to return, 1-365. minimum: 1 · maximum: 365 · default: 90
`variant`	query	`string`	—	Restrict to one variant, e.g. Holofoil. Defaults to every variant BinderDex tracks for the card. minLength: 1 · maxLength: 64

Example

Example responsejson

{
  "data": [
    {
      "currency": "USD",
      "date": "2026-09-17",
      "market_price_cents": 1250,
      "variant": "Holofoil"
    },
    {
      "currency": "USD",
      "date": "2026-09-18",
      "market_price_cents": 1299,
      "variant": "Holofoil"
    }
  ],
  "days": 90,
  "id": "card_9f2c1b7a",
  "name": "Pikachu ex",
  "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.