Przedmioty
Histogramy przedmiotu
Pobierz paginowane snapshoty histogramów zleceń kupna/sprzedaży dla konkretnego przedmiotu rynku Steam.
Endpoint
Ten endpoint zwraca paginowaną listę historycznych snapshotów histogramów zleceń kupna/sprzedaży dla konkretnego przedmiotu.
GET /v2/steam/items/{itemId}/histograms
Wymagane parametry
itemId
string
ID dokumentu przedmiotu (pole
_id z endpointu listy przedmiotów lub szczegółów przedmiotu).Parametry query
cursor
string
Kursor paginacji. Przekaż wartość
cursor z poprzedniej odpowiedzi, aby pobrać kolejną stronę.Uwierzytelnianie
Dołącz swój klucz API jako header x-api-key.
x-api-key: YourSecretAPIKey
Pola odpowiedzi
| Pole | Typ | Opis |
|---|---|---|
results | array | Tablica obiektów snapshotów histogramu |
cursor | string|null | Kursor do następnej strony lub null, jeśli nie ma więcej wyników |
hasMore | boolean | Czy są dostępne kolejne wyniki do pobrania |
Obiekt histogram
| Pole | Typ | Opis |
|---|---|---|
buyOrders | array | Tablica punktów cenowych zleceń kupna |
buyOrders[].price | number | Cena zlecenia kupna |
buyOrders[].quantity | number | Liczba zleceń kupna w tej cenie |
sellOrders | array | Tablica punktów cenowych listingów sprzedaży |
sellOrders[].price | number | Cena listingu sprzedaży |
sellOrders[].quantity | number | Liczba listingów sprzedaży w tej cenie |
date | string | ISO timestamp zarejestrowania histogramu |
Przykład odpowiedzi
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
}
}
Ten endpoint zwraca do 100 wyników na zapytanie. Użyj paginacji opartej na kursorze, aby pobrać więcej snapshotów histogramu.