Eşyalar
Öğe Histogramları
Belirli bir Steam pazar öğesi için sayfalı alış/satış emri histogram snapshot'larını al.
Endpoint
Bu endpoint, belirli bir öğe için geçmiş alış/satış emri histogram snapshot'larının sayfalı listesini döndürür.
GET /v2/steam/items/{itemId}/histograms
Gerekli parametreler
itemId
string
Öğe belge ID'si (list items veya item details endpoint'inden gelen
_id alanı).Query parametreleri
cursor
string
Sayfalama cursor'u. Sonraki sayfayı almak için önceki yanıttaki
cursor değerini geç.Kimlik Doğrulama
API anahtarını x-api-key request header'ı olarak ekle.
x-api-key: YourSecretAPIKey
Yanıt alanları
| Alan | Tip | Açıklama |
|---|---|---|
results | array | Histogram snapshot nesneleri dizisi |
cursor | string|null | Sonraki sayfanın cursor'u veya daha fazla sonuç yoksa null |
hasMore | boolean | Alınacak daha fazla sonuç olup olmadığı |
Histogram nesnesi
| Alan | Tip | Açıklama |
|---|---|---|
buyOrders | array | Alış emri fiyat noktalarının dizisi |
buyOrders[].price | number | Alış emri fiyatı |
buyOrders[].quantity | number | Bu fiyattaki alış emri sayısı |
sellOrders | array | Satış listelemesi fiyat noktalarının dizisi |
sellOrders[].price | number | Satış listeleme fiyatı |
sellOrders[].quantity | number | Bu fiyattaki satış listelemesi sayısı |
date | string | Histogramın kaydedildiği zamanın ISO timestamp'i |
Yanıt örneği
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
}
}
Bu endpoint istek başına en fazla 100 sonuç döndürür. Daha fazla histogram snapshot'ı almak için cursor tabanlı sayfalamayı kullan.