REST

Verkaufsverlauf

Aktuelle abgeschlossene Verkäufe für einen einzelnen Artikel auf einem einzelnen Marktplatz, einschließlich Metadaten pro Verkauf.

Endpunkt

Gibt aktuelle abgeschlossene Verkäufe für einen einzelnen Artikel auf einem einzelnen Marktplatz zurück, einschließlich Metadaten pro Verkauf wie Float, Muster und Sticker, sofern verfügbar.

GET   /v2/sales

Abdeckung

Nur ein Teil der Marktplätze stellt Verkaufsverlaufsdaten bereit. Die untenstehende Liste wird live von der API abgerufen und zeigt, welche Marktplätze derzeit Verkäufe bereitstellen.

Marktplatzverfügbarkeit wird geladen…

Queryparameter

marketplace
string
Marktplatzname. Muss ein Marktplatz sein, der Verkäufe bereitstellt — siehe Tabelle oben.
game
string
Spielcode (z. B. CS2, Dota2, Rust, TF2).
name
string
Vollständiger Marktname des Artikels.
days
number
Wie viele Tage Verkaufsverlauf zurückgegeben werden sollen. Standard ist 30.

Authentifizierung

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

Antwortfelder

FeldTypBeschreibung
namestringMarktname des Artikels
marketplacestringMarktplatz, von dem die Verkäufe stammen
gamestringSpiel, zu dem der Artikel gehört
salesarrayArray von Verkaufsdatensätzen

Verkaufsdatensatz

FeldTypBeschreibung
timestampnumberUnix-Zeitstempel des Verkaufs
priceUSDnumber|nullVerkaufspreis in USD
priceEURnumber|nullVerkaufspreis in EUR
priceCNYnumber|nullVerkaufspreis in CNY
priceRUBnumber|nullVerkaufspreis in RUB
floatnumber|nullVerschleißwert zwischen 0.0 und 1.0 (nur CS2)
paintIndexnumber|nullSkin-Muster-ID (nur CS2)
paintSeednumber|nullMuster-Seed-Nummer (nur CS2)
stickersarray|nullAngebrachte Sticker (nur CS2)
raritystring|nullArtikel-Seltenheit (nur Dota 2)
herostring|nullZugehöriger Heldenname (nur Dota 2)

Antwortbeispiel

response.json
{
  "name": "AK-47 | Redline (Field-Tested)",
  "marketplace": "Buff163",
  "game": "CS2",
  "sales": [
    {
      "timestamp": 1711150800,
      "priceUSD": 45.50,
      "priceEUR": 42.10,
      "priceCNY": 322.00,
      "priceRUB": 4160.00,
      "float": 0.2341,
      "paintIndex": 282,
      "paintSeed": 123,
      "stickers": [],
      "rarity": null,
      "hero": null
    }
  ]
}