Eşyalar

Uygulama fiyat listesi

Belirli bir Steam uygulamasının tüm market item'larının tam fiyat listesini al. İçeriği history planına göre değişen, önceden oluşturulmuş bir dosyaya yönlendirir.

Endpoint

Bu endpoint, belirli bir Steam uygulaması için takip edilen her market item'ı için kapsamlı, önceden oluşturulmuş bir fiyat listesi döndürür — güncel fiyat özetleri, hacim, order book derinliği, signals ve flags dahil. Toplu tüketiciler için tasarlanmıştır (örneğin, bir uygulamanın tüm market'ine ait yerel bir fiyat önbelleğini senkronize etmek için).

Endpoint, SteamApis CDN'inde barındırılan önceden oluşturulmuş bir JSON dosyasına yönlendirir (HTTP 302). Bu dosyanın tam içeriği, aktif history planına bağlıdır — daha geniş history'ye sahip planlar daha derin prices pencerelerini (örneğin 180d ve all) ortaya çıkarır. HTTP istemcin yönlendirmeleri otomatik olarak takip etmelidir.

Payload önceden oluşturulmuş ve düz bir dosya olarak döndürüldüğü için yanıt, olağan{ "success": true, "result": {...} } envelope'una sarılmaz. Yönlendirilen dosyanın en üst seviyesi doğrudan { metadata, items } şeklindedir.

GET /v2/steam/items/{appid}/list

Gerekli parametreler

appid

number

Item fiyat listesini getirmek istediğin Steam application ID.

Kimlik Doğrulama

API anahtarını x-api-key request header'ı olarak ekle.

x-api-key: YourSecretAPIKey

Yanıt yapısı

Yönlendirilen dosyanın iki üst düzey anahtarı vardır:

Alan	Tip	Açıklama
`metadata`	object	Snapshot hakkında bilgi. Aşağıdaki alanlara bak.
`items`	array	Item kayıtlarının listesi. Aşağıdaki alanlara bak.

Metadata alanları

Alan	Tip	Açıklama
`appId`	number	Listenin oluşturulduğu Steam application ID.
`itemCount`	number	`items` içindeki kayıt sayısı.
`generatedAt`	number	Snapshot'ın oluşturulduğu Unix timestamp (ms).
`version`	number	Snapshot şema sürümü.

Item alanları

Alan	Tip	Açıklama
`nameId`	number	SteamApis'nin dahili sayısal item kimliği.
`marketName`	string	Item'ın market'teki görüntü adı.
`marketHashName`	string	Item'ın market hash name'i (URL güvenli kanonik form).
`firstSeen`	number	Item'ın market'te ilk görüldüğü Unix timestamp (ms).
`lastSale`	number	En son kaydedilen satışın Unix timestamp'i (ms).
`prices`	object	Çeşitli zaman pencereleri için fiyat özetleri. Aşağıya bak.
`volume`	object	Çeşitli zaman pencereleri için satış sayıları. Aşağıya bak.
`orderBook`	object	Mevcut order book'un snapshot'ı. Aşağıya bak.
`signals`	object	Item'ın piyasa durumuna ilişkin türetilmiş signals. Aşağıya bak.
`flags`	object	Item'ı tanımlayan boolean flag'ler. Aşağıya bak.
`updatedAt`	number	Bu kaydın en son yenilendiği Unix timestamp (ms).

`prices`

Zaman penceresine göre anahtarlanır: recent, 7d, 30d, 90d, 180d, all. Daha uzun pencerelerin kullanılabilirliği history planına bağlıdır. Her pencere bir objedir:

Alan	Tip	Açıklama
`min`	number \| null	Penceredeki en düşük satış fiyatı. Satış yoksa `null`.
`max`	number \| null	Penceredeki en yüksek satış fiyatı.
`median`	number \| null	Penceredeki medyan satış fiyatı.
`safe`	number \| null	Temkinli "güvenli" fiyat tahmini (aykırı değerlere dayanıklı, filtrelenmiş medyan).
`ewma`	number	Üstel ağırlıklı hareketli ortalama. `recent` dışındaki çoğu pencerede mevcuttur.
`avg`	number	Ortalama satış fiyatı. `all` penceresinde mevcuttur.
`latest`	number	En son gözlemlenen satış fiyatı. `all` penceresinde mevcuttur.

`volume`

Her pencere için gözlemlenen satış sayısı:

Alan	Tip	Açıklama
`recent`	number	En son tick'teki satışlar.
`7d` / `30d` / `90d` / `180d`	number	Her kayan penceredeki satışlar.
`all`	number	Tüm zamanlardaki gözlemlenen satışlar.

`orderBook`

Alan	Tip	Açıklama
`highestBuy`	number	En yüksek mevcut buy order fiyatı.
`lowestSell`	number	En düşük mevcut sell order fiyatı.
`spread`	number	`lowestSell - highestBuy`.
`spreadPct`	number	`lowestSell`'e göre spread yüzdesi.
`buyDepth`	number	Tüm buy order'lardaki toplam birim sayısı.
`sellDepth`	number	Tüm sell order'lardaki toplam birim sayısı.
`buyOrdersTop10`	array	En yüksek fiyatlı 10 adede kadar buy order; `{ price, quantity }` olarak.
`sellOrdersTop10`	array	En düşük fiyatlı 10 adede kadar sell order; `{ price, quantity }` olarak.
`imbalanceRatio`	number	`buyDepth / sellDepth`.
`histogramAgeSeconds`	number	Alttaki order book histogramının saniye cinsinden yaşı.

`signals`

Alan	Tip	Açıklama
`confidence`	string	`low`, `medium` ya da `high`.
`confidenceScore`	number	`[0, 1]` aralığında sayısal güven değeri.
`stale`	boolean	Verinin stale (bayat) sayılıp sayılmadığı.
`unstable`	boolean	Signal'in şu anda kararsız olup olmadığı.
`unstableReasons`	array	String kodlar (örneğin `"LOW_VOLUME"`).
`volatility`	number	Güncel volatilite ölçümü.
`volatility30d`	number	30 günlük volatilite ölçümü.
`liquidity`	string	`low`, `medium` ya da `high`.
`manipulationRisk`	string	`none`, `low`, `medium` ya da `high`.
`manipulationFlags`	array	String kodlar (örneğin `"PRICE_DROP"`, `"WIDE_SPREAD"`).
`priceMomentum7d`	number	7 günlük fiyat momentumu.
`volumeTrend`	string	`stable`, `declining`, `rising`.

`flags`

Alan	Tip	Açıklama
`commodity`	boolean	Steam'in item'ı commodity (fungible stack) olarak değerlendirip değerlendirmediği.
`tradable`	boolean	Item'ın takas edilebilir olup olmadığı.
`marketable`	boolean	Item'ın market'e listelenebilir olup olmadığı.

Yanıt örneği

Bu endpoint için örnek çıktı. Kısalık için çoğu item atlanmış ve her item'daki bazı pencereler kısaltılmıştır.

response.json

{
  "metadata": {
    "appId": 252490,
    "itemCount": 5215,
    "generatedAt": 1776562202287,
    "version": 2
  },
  "items": [
    {
      "nameId": 74287236,
      "marketName": "60's Army Jacket",
      "marketHashName": "60's Army Jacket",
      "firstSeen": 1444341600000,
      "lastSale": 1776459600000,
      "prices": {
        "recent": { "min": 14.89, "max": 14.89, "median": 14.89, "safe": 12.65 },
        "7d": { "min": 12.548, "max": 15.887, "median": 14.9, "safe": 13.07, "ewma": 15.01 },
        "30d": { "min": 1.49, "max": 17.22, "median": 14.87, "safe": 12.74, "ewma": 14.5 },
        "all": { "latest": 14.89, "min": 1.49, "max": 21.369, "avg": 7.23, "median": 5.55, "safe": 5.31, "ewma": 14.91 }
      },
      "volume": { "recent": 1, "7d": 9, "30d": 43, "90d": 114, "180d": 238, "all": 9513 },
      "orderBook": {
        "highestBuy": 12.62,
        "lowestSell": 15.96,
        "spread": 3.34,
        "spreadPct": 23.37,
        "buyDepth": 9853,
        "sellDepth": 110,
        "buyOrdersTop10": [
          { "price": 12.62, "quantity": 1 },
          { "price": 12.58, "quantity": 2 }
        ],
        "sellOrdersTop10": [
          { "price": 15.96, "quantity": 1 },
          { "price": 16, "quantity": 2 }
        ],
        "imbalanceRatio": 89.57,
        "histogramAgeSeconds": 4048
      },
      "signals": {
        "confidence": "medium",
        "confidenceScore": 0.5,
        "stale": false,
        "unstable": false,
        "unstableReasons": [],
        "volatility": 0.12,
        "volatility30d": 0.12,
        "liquidity": "medium",
        "manipulationRisk": "low",
        "manipulationFlags": ["PRICE_DROP"],
        "priceMomentum7d": 0,
        "volumeTrend": "stable"
      },
      "flags": { "commodity": true, "tradable": true, "marketable": true },
      "updatedAt": 1776562229774
    }
  ]
}

Öğe Değişiklikleri

Belirli bir Steam pazar öğesi için izlenen değişikliklerin sayfalı changelog'unu al.

Referans

Pazar Verileri API'si için desteklenen pazar yerleri ve oyunlar, hem WebSocket hem de REST aktarımlarında.