REST

Preisverlauf

Zeitreihen-Preisverlauf für einen einzelnen Artikel auf einem einzelnen Marktplatz.

Endpunkt

Gibt eine Zeitreihe historischer Preise für einen einzelnen Artikel auf einem einzelnen Marktplatz zurück. Nützlich für Diagramme und Trendanalysen.

GET   /v2/price-history

Queryparameter

marketplace
string
Marktplatzname.
game
string
Spielcode (z. B. CS2, Dota2, Rust, TF2).
name
string
Vollständiger Marktname des Artikels.
days
number
Wie viele Tage Verlauf zurückgegeben werden sollen. Standard ist 15.
dataPoints
number
Maximale Anzahl zurückgegebener Datenpunkte. Der Server reduziert gleichmäßig über das Zeitfenster. Standard ist 100.

Authentifizierung

Siehe REST-Übersicht für Basis-URL, Authentifizierung und Fehlerformat.

Antwortfelder

FeldTypBeschreibung
namestringMarktname des Artikels
marketplacestringMarktplatz, von dem der Verlauf stammt
gamestringSpiel, zu dem der Artikel gehört
historyarrayArray von Preispunkten

Preispunkt

FeldTypBeschreibung
timestampnumberUnix-Zeitstempel des Datenpunkts
priceUSDnumber|nullPreis in USD
priceEURnumber|nullPreis in EUR
priceCNYnumber|nullPreis in CNY
priceRUBnumber|nullPreis in RUB

Antwortbeispiel

response.json
{
  "name": "AK-47 | Redline (Field-Tested)",
  "marketplace": "Buff163",
  "game": "CS2",
  "history": [
    {
      "timestamp": 1710547200,
      "priceUSD": 44.10,
      "priceEUR": 40.80,
      "priceCNY": 312.00,
      "priceRUB": 4025.00
    },
    {
      "timestamp": 1710633600,
      "priceUSD": 45.99,
      "priceEUR": 42.50,
      "priceCNY": 325.00,
      "priceRUB": 4200.00
    }
  ]
}