REST

Fiyat Geçmişi

Tek bir pazar yerindeki tek bir ürün için zaman serisi fiyat geçmişi.

Endpoint

Tek bir pazar yerindeki tek bir ürün için tarihsel fiyatların zaman serisini döndürür. Grafikler ve trend analizi için kullanışlıdır.

GET   /v2/price-history

Sorgu parametreleri

marketplace
string
Pazar yeri adı.
game
string
Oyun kodu (ör. CS2, Dota2, Rust, TF2).
name
string
Ürünün tam pazar adı.
days
number
Kaç günlük geçmiş döndürüleceği. Varsayılan 15.
dataPoints
number
Döndürülecek maksimum veri noktası sayısı. Sunucu, pencere boyunca eşit olarak örnekleme sıklığını azaltır. Varsayılan 100.

Kimlik doğrulama

Temel URL, kimlik doğrulama ve hata formatı için REST Genel Bakış sayfasına bakın.

Yanıt alanları

AlanTipAçıklama
namestringÜrünün pazar adı
marketplacestringGeçmişin alındığı pazar yeri
gamestringÜrünün ait olduğu oyun
historyarrayFiyat noktaları dizisi

Fiyat noktası

AlanTipAçıklama
timestampnumberVeri noktasının Unix zaman damgası
priceUSDnumber|nullUSD cinsinden fiyat
priceEURnumber|nullEUR cinsinden fiyat
priceCNYnumber|nullCNY cinsinden fiyat
priceRUBnumber|nullRUB cinsinden fiyat

Yanıt örneği

response.json
{
  "name": "AK-47 | Redline (Field-Tested)",
  "marketplace": "Buff163",
  "game": "CS2",
  "history": [
    {
      "timestamp": 1710547200,
      "priceUSD": 44.10,
      "priceEUR": 40.80,
      "priceCNY": 312.00,
      "priceRUB": 4025.00
    },
    {
      "timestamp": 1710633600,
      "priceUSD": 45.99,
      "priceEUR": 42.50,
      "priceCNY": 325.00,
      "priceRUB": 4200.00
    }
  ]
}