Skip to main content
GET
minAsk price list
Эндпоинт prices возвращает сгруппированный снимок цен маркетплейса CSBoard. Каждая строка представляет уникальную комбинацию market_hash_name, wear и doppler_phase и содержит самую дешёвую текущую цену продажи и количество выставленных копий. Это удобно для построения таблиц сравнения цен, систем оповещений или оценки портфеля — вы можете получить цены тысяч предметов, не запрашивая отдельные листинги. Требуется аутентификация. Отправьте ключ как Authorization: Bearer csb_pub_....
Передайте appId=570 для Dota 2 или appId=252490 для Rust. Для этих игр каждая строка — один market_hash_name, а wear и doppler_phase равны null. См. Игры. Нужно одно число на название? GET /v1/public/prices работает без ключа.

Query-параметры

integer
по умолчанию:"730"
Игра: 730 — CS2, 570 — Dota 2, 252490 — Rust. Не передавайте параметр, чтобы получить CS2. Игры, доступные вашему ключу, — в GET /v1/games.
Нечёткое совпадение по 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. Только для CS2 — с другим appId вернёт 400 invalid_param.
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.

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

appId
enum<integer>
по умолчанию:730

Steam appId of the game. 730 = CS2 (the default), 570 = Dota 2, 252490 = Rust. Omit it and the endpoint answers for CS2 exactly as before. An appId this key may not use answers 400 unsupported_game, whose supported_app_ids lists the ones it may — see GET /games.

Доступные опции:
730,
570,
252490

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. CS2 only — sent with another appId it answers 400 invalid_param.

Доступные опции:
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
обязательно