Preisverlauf
Tägliche Schlusspreise für eine Pokémon-Karte oder ein Sealed-Produkt, bis zu einem Jahr zurück, pro Zustand und Druck.
Preisverlauf
/v1/cards/:id/prices/history1 Credit pro zurückgegebenem EintragTägliche Preisaggregate für eine Karte über ein Zeitfenster. currency wählt die Quelle: USD von TCGPlayer, EUR von Cardmarket. Das sind die einzigen beiden Quellen für den Preisverlauf. Einzelne eBay-Verkäufe bekommst du stattdessen über /v1/cards/:id/listings/ebay.
Jede Quelle gruppiert nach Zustand und Druckvariante, ein Datum liefert also mehrere Zeilen. avg, low und high sind die Aggregate des jeweiligen Tages; den einzelnen aktuellen market_price liefert GET /v1/cards/:id.
Kein Feld hier gibt an, wie viele Exemplare verkauft wurden. Jede Zeile ist ein Preisaggregat, keine Verkaufszahl.
Parameter
idstringPflichtDie eindeutige Karten-ID.
currencystringPreisquelle/Währung. "usd" liefert den TCGPlayer-Verlauf, "eur" den Cardmarket-Verlauf. Lässt du den Parameter weg, bekommst du alle Währungen, die dein Tarif erlaubt.
periodstringZeitraum in Tagen, von "1d" bis "365d". Standard: 30d.
conditionstringAuf einen Zustand filtern, exakter Abgleich. TCGPlayer verwendet "Near Mint", "Lightly Played", "Moderately Played", "Heavily Played", "Damaged"; Cardmarket verwendet "Mint", "Near Mint", "Excellent", "Good", "Light Played", "Played", "Poor".
variantstringAuf eine Druckvariante filtern, exakter Abgleich, z. B. "Holofoil" oder "Reverse Holofoil".
limitnumberZeilen pro Seite, nicht Tage (max. 365). Eine Zeile ist eine Kombination aus Datum, Quelle, Währung, Zustand und Variante. Eine Karte mit fünf Zuständen liefert also fünf Zeilen pro Tag, und der Standardwert 30 deckt etwa sechs Tage ab. Blättere mit pagination.total_pages weiter, erhöhe den Wert oder grenze das Ergebnis mit condition und variant ein. Standard: 30.
pagenumberSeitennummer für die Paginierung. Standard: 1.
Ausprobieren
curl -H "X-API-Key: YOUR_API_KEY" \https://api.pkmnprices.com/v1/cards/{id}/prices/history