Предметы
Гистограммы предмета
Получи пагинированные снапшоты гистограммы ордеров покупки/продажи для конкретного Steam-предмета рынка.
Эндпоинт
Этот endpoint возвращает пагинированный список исторических снапшотов гистограммы ордеров на покупку/продажу для конкретного предмета.
GET /v2/steam/items/{itemId}/histograms
Обязательные параметры
itemId
string
ID документа предмета (поле
_id из endpoint'ов списка предметов или деталей предмета).Query-параметры
cursor
string
Cursor пагинации. Передай значение
cursor из предыдущего ответа, чтобы получить следующую страницу.Аутентификация
Включи свой API-ключ в request header x-api-key.
x-api-key: YourSecretAPIKey
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
results | array | Массив объектов снапшотов гистограммы |
cursor | string|null | Cursor для следующей страницы или null, если больше результатов нет |
hasMore | boolean | Есть ли ещё результаты для получения |
Объект histogram
| Поле | Тип | Описание |
|---|---|---|
buyOrders | array | Массив ценовых уровней ордеров на покупку |
buyOrders[].price | number | Цена ордера на покупку |
buyOrders[].quantity | number | Количество ордеров на покупку по этой цене |
sellOrders | array | Массив ценовых уровней листингов на продажу |
sellOrders[].price | number | Цена листинга на продажу |
sellOrders[].quantity | number | Количество листингов на продажу по этой цене |
date | string | ISO timestamp записи гистограммы |
Пример ответа
response.json
{
"success": true,
"response": {
"results": [
{
"buyOrders": [
{ "price": 1050, "quantity": 245 },
{ "price": 1049, "quantity": 12 }
],
"sellOrders": [
{ "price": 1089, "quantity": 3 },
{ "price": 1090, "quantity": 7 }
],
"date": "2025-01-15T12:00:00.000Z"
}
],
"cursor": "6789abcdef012345",
"hasMore": true
}
}
Этот endpoint возвращает до 100 результатов за запрос. Используй пагинацию на основе cursor, чтобы получить больше снапшотов гистограммы.