Перейти к основному содержанию
GET
/
prices
minAsk price list
curl --request GET \
  --url https://csboard.com/v1/prices \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "wear": "Field-Tested",
      "doppler_phase": null,
      "min_price_usd": 11.92,
      "qty": 73
    }
  ],
  "next_cursor": null
}
Эндпоинт prices возвращает сгруппированный снимок цен маркетплейса CSBoard. Каждая строка представляет уникальную комбинацию market_hash_name, wear и doppler_phase и содержит самую дешёвую текущую цену продажи и количество выставленных копий. Это удобно для построения таблиц сравнения цен, систем оповещений или оценки портфеля — вы можете получить цены тысяч предметов, не запрашивая отдельные листинги. Требуется аутентификация. Отправьте ключ как Authorization: Bearer csb_pub_....

​
Query-параметры

​
search
string
Полнотекстовое совпадение по market_hash_name, например AK-47 | Redline.
​
category
string
Фильтр по категории товара, например Rifle, Knife, Gloves.
​
wear
string
Фильтр по диапазону износа. Одно из: Factory New, Minimal Wear, Field-Tested, Well-Worn, Battle-Scarred.
​
rarity
string
Фильтр по уровню редкости, например Classified, Covert.
​
min_price
number
Минимальный min_price_usd в USD (включительно).
​
max_price
number
Максимальный min_price_usd в USD (включительно).
​
cursor
string
Keyset-курсор пагинации. Передайте значение next_cursor из предыдущего ответа.
​
limit
integer
по умолчанию:"100"
Количество строк на странице. Минимум 1, максимум 500.

​
Поля ответа

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

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

curl "https://csboard.com/v1/prices?category=Rifle&wear=Field-Tested&limit=50" \
  -H "Authorization: Bearer csb_pub_..."

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

{
  "items": [
    {
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "wear": "Field-Tested",
      "doppler_phase": null,
      "min_price_usd": 11.92,
      "qty": 73
    }
  ],
  "next_cursor": null
}

​
Коды ошибок

HTTP-статусКодЗначение
401unauthorizedОтсутствует или некорректный API-ключ.
429rate_limit_exceededБолее 30 запросов/мин. Перед повтором подождите время, указанное в заголовке Retry-After.
Эндпоинт 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.

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

​
search
string

Full-text match on market hash name.

​
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
обязательно