Historial de precios

Precios de cierre diarios de una carta o un producto sellado Pokémon, hasta un año atrás, por estado e impresión.

Historial de precios

GET/v1/cards/:id/prices/history1 crédito por elemento devuelto

Agregados diarios de precio de una carta en un intervalo de tiempo. currency elige la fuente: USD de TCGPlayer, EUR de Cardmarket, las dos únicas fuentes de historial. Para ventas individuales de eBay, usa /v1/cards/:id/listings/ebay.

Cada fuente agrupa por estado y variante de impresión, así que una fecha devuelve varias filas. avg, low y high son los agregados de ese día; GET /v1/cards/:id tiene el market_price actual.

Ningún campo indica cuántas copias se vendieron. Cada fila es un agregado de precio, no un recuento de ventas.

Parámetros

idstringobligatorio

El ID único de la carta.

currencystring

Fuente y moneda del precio. "usd" devuelve el historial de TCGPlayer, "eur" el de Cardmarket. Si lo omites, recibes todas las monedas que permite tu plan.

periodstring

Periodo en días, de "1d" a "365d". Por defecto: 30d.

conditionstring

Filtra por un estado, con coincidencia exacta. TCGPlayer usa "Near Mint", "Lightly Played", "Moderately Played", "Heavily Played", "Damaged"; Cardmarket usa "Mint", "Near Mint", "Excellent", "Good", "Light Played", "Played", "Poor".

variantstring

Filtra por una variante de impresión, con coincidencia exacta, p. ej. "Holofoil" o "Reverse Holofoil".

limitnumber

Filas por página, no días (máximo 365). Una fila es una combinación de fecha/fuente/moneda/estado/variante, así que una carta con cinco estados devuelve cinco filas por día y el valor por defecto de 30 cubre unos seis días. Recorre las páginas con pagination.total_pages, sube este valor o acota el resultado con condition y variant. Por defecto: 30.

pagenumber

Número de página para la paginación. Por defecto: 1.

Pruébalo

curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.pkmnprices.com/v1/cards/{id}/prices/history
Respuesta
{
  "data": [
    {
      "date": "2026-08-10",
      "source": "tcgplayer",
      "currency": "USD",
      "condition": "Near Mint",
      "variant": "Holofoil",
      "avg": 42.5,
      "low": 40,
      "high": 45
    },
    {
      "date": "2026-08-10",
      "source": "cardmarket",
      "currency": "EUR",
      "condition": "Near Mint",
      "variant": "Holofoil",
      "avg": 37.25,
      "low": 35,
      "high": 39.5
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 30,
    "total": 177,
    "total_pages": 6
  }
}