REST

История продаж

Недавние завершённые продажи одного предмета на одной торговой площадке, включая метаданные каждой продажи.

Эндпоинт

Возвращает недавние завершённые продажи одного предмета на одной торговой площадке, включая метаданные каждой продажи, такие как float, узор и наклейки, если доступны.

GET   /v2/sales

Покрытие

Только часть торговых площадок предоставляет историю продаж. Список ниже загружается в реальном времени с API и отражает, какие торговые площадки в данный момент имеют доступные продажи.

Загрузка доступности торговых площадок…

Параметры запроса

marketplace
string
Название торговой площадки. Должна быть торговая площадка, предоставляющая продажи — смотрите таблицу выше.
game
string
Код игры (например, CS2, Dota2, Rust, TF2).
name
string
Полное рыночное название предмета.
days
number
Сколько дней истории продаж вернуть. По умолчанию 30.

Аутентификация

Смотрите Обзор REST для базового URL, аутентификации и формата ошибок.

Поля ответа

ПолеТипОписание
namestringРыночное название предмета
marketplacestringТорговая площадка, с которой взяты продажи
gamestringИгра, к которой относится предмет
salesarrayМассив записей о продажах

Запись о продаже

ПолеТипОписание
timestampnumberUnix-время продажи
priceUSDnumber|nullЦена продажи в USD
priceEURnumber|nullЦена продажи в EUR
priceCNYnumber|nullЦена продажи в CNY
priceRUBnumber|nullЦена продажи в RUB
floatnumber|nullЗначение износа от 0.0 до 1.0 (только CS2)
paintIndexnumber|nullID узора скина (только CS2)
paintSeednumber|nullНомер seed узора (только CS2)
stickersarray|nullНанесённые наклейки (только CS2)
raritystring|nullРедкость предмета (только Dota 2)
herostring|nullИмя связанного героя (только Dota 2)

Пример ответа

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
    }
  ]
}