BinderDex API
Market movers
GET /v1/market/movers
GET/v1/market/movers
Find the cards with the biggest 7-day price gains or drops, optionally restricted to one game. Use for 'what's spiking' or 'what's crashing' questions. Note: only a 7-day price change is stored today, so period=1 and period=30 currently return the same 7-day figure as period=7; this will change as more history accrues.
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[].market_price_cents | integer | null | — | Integer cents. Divide by 100 for a dollar amount. null when BinderDex has no current price. |
data[].game | string | null | — | Stable game slug, e.g. pokemon or one-piece. |
data[].game_name | string | null | — | Display name, e.g. Pokémon TCG. |
data[].id | string | — | — |
data[].name | string | — | — |
data[].number | string | null | — | — |
data[].price_change_cents | integer | null | — | — |
data[].price_change_percent | number | null | — | — |
data[].price_updated_at | string | — | format: date-time |
data[].set | object | null | — | — |
data[].set.id | string | — | — |
data[].set.name | string | — | — |
data[].url | string | null | — | — |
direction | string | — | ["up","down"] enum: ["up","down"] |
period_days | integer | — | 7 const: 7 |
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
direction | query | string | Yes | up for gainers, down for decliners. enum: ["up","down"] |
period | query | number | number | number | — | Comparison window in days: 1, 7, or 30. Only 7-day change is stored today; all values currently return the 7-day figure. default: 7 |
min_price_cents | query | integer | — | Excludes low-value cards whose percent moves are noisy. Defaults to $5.00. minimum: 0 · maximum: 100000000 · default: 500 |
set | query | string | — | Restrict to one set id or slug. minLength: 1 · maxLength: 200 |
game | query | string | — | Filter to one game by slug, e.g. pokemon or one-piece. minLength: 1 · maxLength: 64 |
limit | query | integer | — | Rows to return, 1-50. minimum: 1 · maximum: 50 · default: 20 |
Example
{
"data": [
{
"currency": "USD",
"game": "pokemon",
"game_name": "Pokemon TCG",
"id": "card_9f2c1b7a",
"market_price_cents": 1299,
"name": "Pikachu ex",
"number": "025",
"price_change_cents": 300,
"price_change_percent": 30,
"price_updated_at": "2026-09-18T04:00:00Z",
"set": {
"id": "set_ssp",
"name": "Surging Sparks"
},
"url": "https://binderdex.com/cards/pikachu-ex-ssp-025"
}
],
"direction": "up",
"period_days": 7
}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.