REST
Получить предмет
Получить один предмет с определённой торговой площадки, включая его текущие предложения и открытые заявки на покупку.
Эндпоинт
Возвращает полные данные по одному предмету на одной торговой площадке, включая все текущие предложения и все открытые заявки на покупку.
GET /v2/items
Параметры запроса
marketplace
string
Название торговой площадки (например,
Buff163). Регистр не учитывается.game
string
Код игры (например,
CS2, Dota2, Rust, TF2).name
string
Полное рыночное название предмета (например,
AK-47 | Redline (Field-Tested)).Аутентификация
Смотрите Обзор REST для базового URL, аутентификации и формата ошибок.
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
name | string | Рыночное название предмета |
marketplace | string | Торговая площадка, на которой выставлен предмет |
game | string | Игра, к которой относится предмет |
priceUSD | number|null | Наименьшая цена предложения в USD |
priceEUR | number|null | Наименьшая цена предложения в EUR |
priceCNY | number|null | Наименьшая цена предложения в CNY |
priceRUB | number|null | Наименьшая цена предложения в RUB |
offerCount | number | Количество открытых предложений |
condition | string|null | Состояние предмета (например, Field-Tested) |
thumbnail | string|null | URL миниатюры предмета |
updatedAt | number | Unix-время (секунды) последнего обновления |
offers | array | Массив объектов предложения |
buyOrders | array | Массив объектов заявки на покупку |
Объект предложения
| Поле | Тип | Описание |
|---|---|---|
purchaseLink | string|null | Прямая ссылка для покупки предмета на торговой площадке |
inspectLink | string|null | Steam inspect-ссылка (только CS2) |
priceUSD | number|null | Цена предложения в USD |
priceEUR | number|null | Цена предложения в EUR |
priceCNY | number|null | Цена предложения в CNY |
priceRUB | number|null | Цена предложения в RUB |
float | number|null | Значение износа от 0.0 до 1.0 (только CS2) |
paintIndex | number|null | ID узора скина (только CS2) |
paintSeed | number|null | Номер seed узора (только CS2) |
daysTradeLocked | number|null | Дней до того, как предмет станет обмениваемым |
foundAt | number | Unix-время, когда предложение было обнаружено |
updatedAt | number | Unix-время последнего обновления |
stickers | array|null | Нанесённые наклейки (только CS2) |
ownerId | string|null | Идентификатор продавца на торговой площадке |
Объект заявки на покупку
| Поле | Тип | Описание |
|---|---|---|
orderId | string|null | ID заявки, специфичный для торговой площадки |
quantity | number|null | Количество запрошенных единиц |
priceUSD | number|null | Цена ставки в USD |
priceEUR | number|null | Цена ставки в EUR |
priceCNY | number|null | Цена ставки в CNY |
priceRUB | number|null | Цена ставки в RUB |
itemPhase | string|null | Фаза или вариант предмета (doppler-фазы CS2 и т. д.) |
updatedAt | number | Unix-время последнего обновления |
Пример ответа
response.json
{
"name": "AK-47 | Redline (Field-Tested)",
"marketplace": "Buff163",
"game": "CS2",
"priceUSD": 45.99,
"priceEUR": 42.50,
"priceCNY": 325.00,
"priceRUB": 4200.00,
"offerCount": 128,
"condition": "Field-Tested",
"thumbnail": "https://community.cloudflare.steamstatic.com/economy/image/...",
"updatedAt": 1711152000,
"offers": [
{
"purchaseLink": "https://buff.163.com/goods/...",
"inspectLink": "steam://rungame/730/...",
"priceUSD": 45.99,
"priceEUR": 42.50,
"priceCNY": 325.00,
"priceRUB": 4200.00,
"float": 0.2341,
"paintIndex": 282,
"paintSeed": 123,
"daysTradeLocked": 0,
"foundAt": 1711150000,
"updatedAt": 1711152000,
"stickers": [],
"ownerId": "user-abc"
}
],
"buyOrders": [
{
"orderId": "order-xyz",
"quantity": 5,
"priceUSD": 43.00,
"priceEUR": 39.80,
"priceCNY": 305.00,
"priceRUB": 3950.00,
"itemPhase": null,
"updatedAt": 1711151800
}
]
}