Skip to main content
GET
minAsk price list
Эндпоинт prices возвращает сгруппированный снимок цен маркетплейса CSBoard. Каждая строка представляет уникальную комбинацию market_hash_name, wear и doppler_phase и содержит самую дешёвую текущую цену продажи и количество выставленных копий. Это удобно для построения таблиц сравнения цен, систем оповещений или оценки портфеля — вы можете получить цены тысяч предметов, не запрашивая отдельные листинги. Требуется аутентификация. Отправьте ключ как Authorization: Bearer csb_pub_....

Query-параметры

Нечёткое совпадение по market_hash_name — запрос разбивается на слова, и каждое сопоставляется как подстрока. Имя, являющееся словесным подмножеством более длинного имени предмета (например, Spectrum Case и Spectrum 2 Case), нельзя изолировать таким способом; для точного поиска используйте name.
string
Точное market_hash_name (регистр не учитывается) — точный способ найти один предмет. name=Spectrum Case вернёт только группу Spectrum Case, никогда Spectrum 2 Case. Имеет приоритет над search.
string
Фильтр по категории товара, например Rifle, Knife, Gloves.
string
Фильтр по диапазону износа. Одно из: Factory New, Minimal Wear, Field-Tested, Well-Worn, Battle-Scarred.
string
Фильтр по уровню редкости, например Classified, Covert.
number
Минимальный min_price_usd в USD (включительно).
number
Максимальный min_price_usd в USD (включительно).
string
Keyset-курсор пагинации. Передайте значение next_cursor из предыдущего ответа.
integer
по умолчанию:"100"
Количество строк на странице. Минимум 1, максимум 500.

Поля ответа

PriceRow[]
обязательно
Массив строк с ценами для этой страницы.
string | null
обязательно
Keyset-курсор для следующей страницы. Передайте как cursor в следующем запросе. null на последней странице.

Пример запроса

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

Коды ошибок

Эндпоинт prices возвращает индикативный сгруппированный снимок. Данные периодически материализуются и могут отставать от живого маркетплейса. Для авторитетной цены продажи конкретного предмета в реальном времени перед оформлением заказа используйте GET /v1/listings.

Авторизации

Authorization
string
header
обязательно

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.

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

Full-text match on market hash name.

name
string

Exact market_hash_name (case-insensitive) — the precise single-item lookup. Unlike fuzzy search, it isolates one item even when its name is a word-subset of a longer one (e.g. Spectrum Case vs Spectrum 2 Case). Takes precedence over search.

category
string

e.g. Rifle, Knife, Gloves.

wear
enum<string>

Item wear bucket.

Доступные опции:
Factory New,
Minimal Wear,
Field-Tested,
Well-Worn,
Battle-Scarred
rarity
string

e.g. Classified, Covert.

min_price
number

Minimum price in USD.

max_price
number

Maximum price in USD.

cursor
string

Keyset cursor from next_cursor.

limit
integer
по умолчанию:100

1–500. Default 100.

Требуемый диапазон: 1 <= x <= 500

Ответ

A page of price rows.

items
object[]
обязательно
next_cursor
string | null
обязательно