Historique des prix

Prix de clôture quotidiens d'une carte ou d'un produit scellé Pokémon, jusqu'à un an en arrière, par état et par impression.

Historique des prix

GET/v1/cards/:id/prices/history1 crédit par élément renvoyé

Agrégats de prix quotidiens d'une carte sur une période. currency choisit la source : USD depuis TCGPlayer, EUR depuis Cardmarket, les deux seules sources d'historique. Pour les ventes eBay individuelles, utilisez plutôt /v1/cards/:id/listings/ebay.

Chaque source regroupe par état et par variante d'impression, donc une même date renvoie plusieurs lignes. avg, low et high sont les agrégats du jour ; GET /v1/cards/:id donne le market_price actuel.

Aucun champ ici n'indique combien d'exemplaires se sont vendus. Chaque ligne est un agrégat de prix, pas un nombre de ventes.

Paramètres

idstringobligatoire

L'ID unique de la carte.

currencystring

Source et devise des prix. "usd" renvoie l'historique TCGPlayer, "eur" l'historique Cardmarket. Sans ce paramètre, vous recevez toutes les devises autorisées par votre offre.

periodstring

Période en jours, de "1d" à "365d". Par défaut : 30d.

conditionstring

Filtrer sur un état, en correspondance exacte. TCGPlayer utilise "Near Mint", "Lightly Played", "Moderately Played", "Heavily Played", "Damaged" ; Cardmarket utilise "Mint", "Near Mint", "Excellent", "Good", "Light Played", "Played", "Poor".

variantstring

Filtrer sur une variante d'impression, en correspondance exacte, p. ex. "Holofoil" ou "Reverse Holofoil".

limitnumber

Lignes par page, pas jours (365 maximum). Une ligne correspond à une combinaison date/source/devise/état/variante : une carte avec cinq états renvoie donc cinq lignes par jour, et la valeur par défaut de 30 couvre environ six jours. Parcourez les pages avec pagination.total_pages, augmentez cette valeur ou affinez le résultat avec condition et variant. Par défaut : 30.

pagenumber

Numéro de page pour la pagination. Par défaut : 1.

Essayer

curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.pkmnprices.com/v1/cards/{id}/prices/history
Réponse
{
  "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
  }
}