REST

Kaufaufträge

Listet offene Kaufaufträge von Marktplätzen auf, die Kaufauftragsdaten bereitstellen.

Endpunkt

Gibt offene Kaufaufträge von Marktplätzen zurück, die Kaufauftragsdaten bereitstellen. Jeder Auftrag enthält seinen Artikelkontext (Name, Marktplatz, Spiel), sodass du mit der Antwort als flacher Liste arbeiten kannst.

GET   /v2/buy-orders

Abdeckung

Nur ein Teil der Marktplätze stellt Kaufauftragsdaten bereit. Die untenstehende Liste wird live von der API abgerufen und zeigt, welche Marktplätze derzeit Kaufaufträge anbieten.

Marktplatzverfügbarkeit wird geladen…

Queryparameter

game
string
Spielcode (z. B. CS2, Dota2, Rust, TF2).
marketplace
string
Optionaler Marktplatz-Filter. Muss ein Marktplatz sein, der Kaufaufträge bereitstellt — siehe Tabelle oben.
name
string
Optionaler Filter für Artikelnamen. Treffer ist exakt.
limit
number
Maximale Anzahl zurückgegebener Aufträge. Standard ist 500.

Authentifizierung

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

Antwortfelder

Die Antwort ist ein Array von Kaufauftrags-Objekten.

FeldTypBeschreibung
namestringMarktname des Artikels
marketplacestringMarktplatz, auf dem der Auftrag platziert wurde
gamestringSpiel, zu dem der Artikel gehört
orderIdstring|nullMarktplatz-spezifische Auftrags-ID
quantitynumber|nullAnzahl angefragter Einheiten
priceUSDnumber|nullGebotspreis in USD
priceEURnumber|nullGebotspreis in EUR
priceCNYnumber|nullGebotspreis in CNY
priceRUBnumber|nullGebotspreis in RUB
itemPhasestring|nullArtikelphase oder Variante (CS2-Doppler-Phasen usw.)
updatedAtnumberUnix-Zeitstempel der letzten Aktualisierung

Antwortbeispiel

response.json
[
  {
    "name": "AK-47 | Redline (Field-Tested)",
    "marketplace": "Buff163",
    "game": "CS2",
    "orderId": "order-xyz",
    "quantity": 5,
    "priceUSD": 43.00,
    "priceEUR": 39.80,
    "priceCNY": 305.00,
    "priceRUB": 3950.00,
    "itemPhase": null,
    "updatedAt": 1711151800
  }
]