Перейти к основному содержанию
GET
/
listings
Live buyable listings
curl --request GET \
  --url https://csboard.com/v1/listings \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "itm_8841201",
      "market_hash_name": "AK-47 | Redline (Minimal Wear)",
      "wear": "Minimal Wear",
      "doppler_phase": null,
      "float_value": 0.0912,
      "paint_seed": 412,
      "stickers": [
        {
          "name": "Crown (Foil)",
          "image": "https://cdn.csboard.com/stickers/crown_foil.png",
          "slot": 0,
          "wear": 0
        }
      ],
      "price_usd": 14.37,
      "category": "Rifle",
      "rarity": "Classified",
      "image": "https://cdn.csboard.com/items/ak47_redline_mw.png",
      "inspect_link": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20...",
      "tradable": false,
      "tradable_at": "2026-07-06T12:00:00Z",
      "delivery": "hold"
    }
  ],
  "next_cursor": "eyJpZCI6Iml0bV84ODQxMjAxIn0="
}
Эндпоинт listings возвращает все товары, доступные для покупки на маркетплейсе CSBoard прямо сейчас. Каждая запись содержит полные данные для оценки — значение float, paint seed, наклеенные стикеры с их износом — вместе с авторитетной ценой продажи в USD. Результаты разбиваются на страницы при помощи keyset-курсора, что позволяет надёжно пройти весь каталог даже по мере появления новых листингов. Требуется аутентификация. Отправьте ключ как Authorization: Bearer csb_pub_....

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

​
search
string
Полнотекстовое совпадение по market_hash_name товара, например AK-47 | Redline.
​
category
string
Фильтр по категории товара, например Rifle, Knife, Gloves, Pistol.
​
wear
string
Фильтр по диапазону износа. Одно из: Factory New, Minimal Wear, Field-Tested, Well-Worn, Battle-Scarred.
​
rarity
string
Фильтр по уровню редкости, например Classified, Covert, Extraordinary.
​
min_price
number
Минимальная цена продажи в USD (включительно).
​
max_price
number
Максимальная цена продажи в USD (включительно).
​
min_float
number
Минимальное значение float (включительно). Принимает значения от 0.0 до 1.0.
​
max_float
number
Максимальное значение float (включительно). Принимает значения от 0.0 до 1.0.
​
stat_trak
string
Фильтр StatTrak™. only возвращает только предметы StatTrak™; exclude исключает их из результатов.
​
souvenir
string
Фильтр Souvenir. only возвращает только сувенирные предметы; exclude исключает их из результатов.
​
sort
string
по умолчанию:"id"
Порядок сортировки. Одно из: id (стабильный по умолчанию), newest, price_asc, price_desc.
​
cursor
string
Keyset-курсор пагинации. Передайте значение next_cursor из предыдущего ответа, чтобы получить следующую страницу.
​
limit
integer
по умолчанию:"50"
Количество результатов на странице. Минимум 1, максимум 200.

​
Поля ответа

​
items
Listing[]
обязательно
Массив объектов листингов для этой страницы.
​
next_cursor
string | null
обязательно
Непрозрачный keyset-курсор. Передайте его как query-параметр cursor, чтобы получить следующую страницу. null на последней странице.

​
Пагинация

Этот эндпоинт использует keyset-пагинацию. Чтобы пройти все страницы:
  1. Выполните первый запрос (без cursor).
  2. Если next_cursor не равен null, повторите запрос с cursor=<next_cursor>.
  3. Остановитесь, когда next_cursor станет null — вы дошли до последней страницы.
Keyset-пагинация стабильна: новые листинги, появляющиеся во время итерации, не приводят к дубликатам или пропущенным строкам.

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

curl "https://csboard.com/v1/listings?category=Rifle&wear=Minimal+Wear&min_float=0.07&max_float=0.12&sort=price_asc&limit=20" \
  -H "Authorization: Bearer csb_pub_..."

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

{
  "items": [
    {
      "id": "itm_8841201",
      "market_hash_name": "AK-47 | Redline (Minimal Wear)",
      "wear": "Minimal Wear",
      "doppler_phase": null,
      "float_value": 0.0912,
      "paint_seed": 412,
      "stickers": [
        {
          "name": "Crown (Foil)",
          "image": "https://cdn.csboard.com/stickers/crown_foil.png",
          "slot": 0,
          "wear": 0.0
        }
      ],
      "price_usd": 14.37,
      "category": "Rifle",
      "rarity": "Classified",
      "image": "https://cdn.csboard.com/items/ak47_redline_mw.png",
      "inspect_link": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20...",
      "tradable": false,
      "tradable_at": "2026-07-06T12:00:00Z",
      "delivery": "hold"
    }
  ],
  "next_cursor": "eyJpZCI6Iml0bV84ODQxMjAxIn0="
}

​
Коды ошибок

HTTP-статусКодЗначение
401unauthorizedОтсутствует или некорректный API-ключ.
429rate_limit_exceededБолее 30 запросов/мин. Подождите количество секунд, указанное в заголовке Retry-After.
Значение price_usd у каждого листинга — это авторитетная цена покупки: оно отражает текущую цену продажи на момент запроса и ровно столько с вас спишут. Не используйте min_price_usd из эндпоинта /prices как оценку цены покупки — это значение может отставать.

Авторизации

​
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.

​
min_float
number

Minimum float value.

​
max_float
number

Maximum float value.

​
stat_trak
enum<string>

Filter StatTrak™ items.

Доступные опции:
only,
exclude
​
souvenir
enum<string>

Filter Souvenir items.

Доступные опции:
only,
exclude
​
sort
enum<string>
по умолчанию:id

Sort order. Default id.

Доступные опции:
id,
newest,
price_asc,
price_desc
​
cursor
string

Keyset cursor from next_cursor.

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

1–200. Default 50.

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

Ответ

A page of listings.

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

Pass back as cursor to fetch the next page. Null on the last page.