Items
Item-Histogramme
Rufe paginierte Snapshots der Kauf-/Verkaufsauftrags-Histogramme für ein bestimmtes Steam-Markt-Item ab.
Endpunkt
Dieser Endpunkt gibt eine paginierte Liste historischer Kauf-/Verkaufsauftrags-Histogramm-Snapshots für ein bestimmtes Item zurück.
GET /v2/steam/items/{itemId}/histograms
Erforderliche Parameter
itemId
string
Die Item-Dokument-ID (das
_id-Feld aus dem Endpunkt "Items auflisten" oder den Item-Details).Query-Parameter
cursor
string
Paginierungs-Cursor. Übergib den
cursor-Wert aus einer vorherigen Antwort, um die nächste Seite abzurufen.Authentifizierung
Übergib deinen API-Schlüssel als x-api-key Request-Header.
x-api-key: YourSecretAPIKey
Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
results | array | Array von Histogramm-Snapshot-Objekten |
cursor | string|null | Cursor für die nächste Seite oder null, wenn keine weiteren Ergebnisse vorhanden sind |
hasMore | boolean | Ob weitere Ergebnisse abrufbar sind |
Histogramm-Objekt
| Feld | Typ | Beschreibung |
|---|---|---|
buyOrders | array | Array der Kaufauftrags-Preispunkte |
buyOrders[].price | number | Kaufauftragspreis |
buyOrders[].quantity | number | Anzahl der Kaufaufträge zu diesem Preis |
sellOrders | array | Array der Verkaufslisten-Preispunkte |
sellOrders[].price | number | Verkaufslistenpreis |
sellOrders[].quantity | number | Anzahl der Verkaufslistungen zu diesem Preis |
date | string | ISO-Zeitstempel, wann das Histogramm erfasst wurde |
Antwortbeispiel
response.json
{
"success": true,
"response": {
"results": [
{
"buyOrders": [
{ "price": 1050, "quantity": 245 },
{ "price": 1049, "quantity": 12 }
],
"sellOrders": [
{ "price": 1089, "quantity": 3 },
{ "price": 1090, "quantity": 7 }
],
"date": "2025-01-15T12:00:00.000Z"
}
],
"cursor": "6789abcdef012345",
"hasMore": true
}
}
Dieser Endpunkt gibt bis zu 100 Ergebnisse pro Anfrage zurück. Nutze die Cursor-basierte Paginierung, um weitere Histogramm-Snapshots abzurufen.