REST

История цен

Временной ряд истории цен для одного предмета на одной торговой площадке.

Эндпоинт

Возвращает временной ряд исторических цен для одного предмета на одной торговой площадке. Полезно для графиков и анализа трендов.

GET   /v2/price-history

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

marketplace
string
Название торговой площадки.
game
string
Код игры (например, CS2, Dota2, Rust, TF2).
name
string
Полное рыночное название предмета.
days
number
Сколько дней истории вернуть. По умолчанию 15.
dataPoints
number
Максимальное количество возвращаемых точек данных. Сервер равномерно прореживает по всему окну. По умолчанию 100.

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

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

Поля ответа

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

Точка цены

ПолеТипОписание
timestampnumberUnix-время точки данных
priceUSDnumber|nullЦена в USD
priceEURnumber|nullЦена в EUR
priceCNYnumber|nullЦена в CNY
priceRUBnumber|nullЦена в RUB

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

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