# Current prices > Every live price series for one card — one row per source, variant, printing and grade — plus the composite index in EUR. - **Endpoint**: `GET /v1/cards/{id}/prices` - **Cost**: 2 credits - **Minimum plan**: free - **Cache-Control**: `public, max-age=300` Source: https://pokemontcgapi.com/docs/api/prices/current `data.index` is our composite: the median across sources for each locale and printing, converted to EUR, with `sample_n` saying how many sources agreed. `data.quotes` are the observations behind it, each in the currency it was seen in, each with its own `as_of` and a printable `provenance` string. What you see depends on the plan. The trial returns English-locale, ungraded rows; paid plans return every locale and the graded rows (`MEDIAN_GRADED` with `grading.company` and `grading.score`), which is where a PSA 10 and a raw copy stop being the same number. `meta.plan_notes` says what was withheld, so a missing row is never a mystery. `index` is computed before the filters, on everything the plan allows: narrowing to one source changes the rows you see, never the composite value of the card. A card with no observations is a `200` with `index: null` and an empty `quotes` — thousands of cards are in that state, and it is not an error. The same rows are also available on the card itself through `GET /v1/cards/{id}?include=prices`, which costs one credit instead of two and is the right call when you are rendering the card anyway. > **This sample is trimmed** > > The full response for this card carries 109 rows; 5 are shown, one per source. ## Path parameters | Name | Type | Default | Description | | --- | --- | --- | --- | | `id` **required** | string | — | Card id (`bs-4`) or alternate id (`base1-4`). Both resolve. | ## Query parameters | Name | Type | Default | Description | | --- | --- | --- | --- | | `source` | string | — | Keep only rows from one source, as listed by `GET /v1/prices/sources`. A card can carry over a hundred rows once graded medians are included, so this is usually the difference between a response you parse and one you filter. An unknown value is `INVALID_PARAMETER` with the valid list in `details`, never a silently unfiltered page. | | `variant` | string | — | Keep only one variant: `LOW`, `MARKET`, `TREND`, `AVG_1D`, `AVG_7D`, `AVG_30D`, `MEDIAN_GRADED`, `INDEX`. | | `locale` | string | — | Keep only rows for one printing language. Rows that do not state a language are excluded rather than assumed to match. | ## Headers | Name | Type | Default | Description | | --- | --- | --- | --- | | `X-Api-Key` **required** | string | — | Your API key. `Authorization: Bearer ` is accepted as an alias. | | `If-None-Match` | string | — | Send back the `ETag` you stored. The API returns a strong ETag on every catalogue response, and a 304 is a header exchange: no body, no database row read. | ## Example request **curl** ```bash curl -s "https://api.pokemontcgapi.com/v1/cards/base1-4/prices" \ -H "X-Api-Key: $PTCG_API_KEY" ``` **TypeScript** `request.ts` ```ts const url = new URL("https://api.pokemontcgapi.com/v1/cards/base1-4/prices"); const res = await fetch(url, { headers: { "X-Api-Key": process.env.PTCG_API_KEY ?? "" }, }); if (!res.ok) { const { error } = await res.json(); throw new Error(`${error.code}: ${error.message} (${error.request_id})`); } const { data, meta } = await res.json(); ``` **Python** `request.py` ```python import os, httpx res = httpx.get( "https://api.pokemontcgapi.com/v1/cards/base1-4/prices", headers={"X-Api-Key": os.environ["PTCG_API_KEY"]}, ) res.raise_for_status() payload = res.json() ``` ## Example response `200 OK` · `Cache-Control: public, max-age=300` `response.json` ```json { "data": { "card_id": "base1-4", "index": { "eur": 556.23, "as_of": "2026-09-02", "sample_n": 16, "by_locale": [ { "locale": "en", "printing": null, "eur": 556.23, "as_of": "2026-09-02", "sample_n": 16 }, { "locale": "fr", "printing": null, "eur": 900.58, "as_of": "2026-09-02", "sample_n": 3 }, { "locale": "de", "printing": null, "eur": 399.95, "as_of": "2026-09-02", "sample_n": 5 }, { "locale": "es", "printing": null, "eur": 1313.14, "as_of": "2026-09-02", "sample_n": 8 }, { "locale": "it", "printing": null, "eur": 400.64, "as_of": "2026-09-02", "sample_n": 11 } ] }, "quotes": [ { "source": "CARDMARKET", "variant": "LOW", "basis": "ASKING", "amount": 599.9, "currency": "EUR", "locale": "en", "condition": "NEAR_MINT", "printing": null, "grading": null, "as_of": "2026-09-01", "sample_n": null, "provenance": "Cardmarket" }, { "source": "CARDTRADER", "variant": "LOW", "basis": "ASKING", "amount": 1250.64, "currency": "EUR", "locale": "en", "condition": "NEAR_MINT", "printing": null, "grading": null, "as_of": "2026-09-01", "sample_n": 4, "provenance": "CardTrader" }, { "source": "TCGPLAYER", "variant": "LOW", "basis": "GUIDE", "amount": 510, "currency": "USD", "locale": "en", "condition": null, "printing": "HOLOFOIL", "grading": null, "as_of": "2026-07-30", "sample_n": null, "provenance": "TCGplayer" }, { "source": "EBAY", "variant": "MEDIAN_GRADED", "basis": "ASKING", "amount": 400, "currency": "USD", "locale": "en", "condition": null, "printing": null, "grading": { "company": "PSA", "score": "1" }, "as_of": "2026-08-26", "sample_n": 7, "provenance": "eBay" }, { "source": "PRICECHARTING", "variant": "MEDIAN_GRADED", "basis": "GUIDE", "amount": 20061.4, "currency": "USD", "locale": "en", "condition": null, "printing": null, "grading": { "company": "PSA", "score": "10" }, "as_of": "2026-08-24", "sample_n": null, "provenance": "PriceCharting" } ] }, "meta": { "quotes": 5, "delayed_hours": 0 } } ``` ## Errors Every error body carries `error.code`, `error.message` and `error.request_id`. Switch on the code, never on the message. | Status | Code | When | | --- | --- | --- | | 401 | `MISSING_API_KEY` | No `X-Api-Key` header and no bearer token on a route that requires one. | | 401 | `INVALID_API_KEY` | The key does not match any account. | The full taxonomy, with what to do about each code, is on the [errors](https://pokemontcgapi.com/docs/errors) page.