REST

Historia sprzedaży

Ostatnie zakończone sprzedaże pojedynczego przedmiotu na jednym marketplace, w tym metadane każdej sprzedaży.

Endpoint

Zwraca ostatnie zakończone sprzedaże pojedynczego przedmiotu na jednym marketplace, w tym metadane każdej sprzedaży, takie jak float, wzór i naklejki, jeśli są dostępne.

GET   /v2/sales

Zakres

Tylko część marketplace'ów udostępnia historię sprzedaży. Lista poniżej jest pobierana na żywo z API i pokazuje, które marketplace'y obecnie mają dostępne dane sprzedażowe.

Ładowanie dostępności marketplace'ów…

Parametry zapytania

marketplace
string
Nazwa marketplace'u. Musi być marketplace'em udostępniającym sprzedaże — zobacz tabelę powyżej.
game
string
Kod gry (np. CS2, Dota2, Rust, TF2).
name
string
Pełna rynkowa nazwa przedmiotu.
days
number
Ile dni historii sprzedaży zwrócić. Domyślnie 30.

Uwierzytelnianie

Zobacz Przegląd REST po bazowy URL, uwierzytelnianie i format błędów.

Pola odpowiedzi

PoleTypOpis
namestringRynkowa nazwa przedmiotu
marketplacestringMarketplace, z którego pochodzą sprzedaże
gamestringGra, do której należy przedmiot
salesarrayTablica rekordów sprzedaży

Rekord sprzedaży

PoleTypOpis
timestampnumberUnix timestamp sprzedaży
priceUSDnumber|nullCena sprzedaży w USD
priceEURnumber|nullCena sprzedaży w EUR
priceCNYnumber|nullCena sprzedaży w CNY
priceRUBnumber|nullCena sprzedaży w RUB
floatnumber|nullWartość zużycia między 0.0 a 1.0 (tylko CS2)
paintIndexnumber|nullID wzoru skina (tylko CS2)
paintSeednumber|nullNumer seed wzoru (tylko CS2)
stickersarray|nullNaklejone naklejki (tylko CS2)
raritystring|nullRzadkość przedmiotu (tylko Dota 2)
herostring|nullPowiązana nazwa bohatera (tylko Dota 2)

Przykład odpowiedzi

response.json
{
  "name": "AK-47 | Redline (Field-Tested)",
  "marketplace": "Buff163",
  "game": "CS2",
  "sales": [
    {
      "timestamp": 1711150800,
      "priceUSD": 45.50,
      "priceEUR": 42.10,
      "priceCNY": 322.00,
      "priceRUB": 4160.00,
      "float": 0.2341,
      "paintIndex": 282,
      "paintSeed": 123,
      "stickers": [],
      "rarity": null,
      "hero": null
    }
  ]
}