GET /v1/listings — просмотр актуальных листингов маркетплейса CS2

GET

listings

Live buyable listings

curl --request GET \
  --url https://csboard.com/v1/listings \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://csboard.com/v1/listings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://csboard.com/v1/listings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://csboard.com/v1/listings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://csboard.com/v1/listings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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",
      "refund_percent": 100,
      "listed_at": "2026-06-29T08:41:17.000Z"
    }
  ],
  "next_cursor": "eyJpZCI6Iml0bV84ODQxMjAxIn0="
}

Эндпоинт listings возвращает все товары, доступные для покупки на маркетплейсе CSBoard прямо сейчас. Каждая запись содержит полные данные для оценки — значение float, paint seed, наклеенные стикеры с их износом — вместе с авторитетной ценой продажи в USD. Результаты разбиваются на страницы при помощи keyset-курсора, что позволяет надёжно пройти весь каталог даже по мере появления новых листингов. Требуется аутентификация. Отправьте ключ как Authorization: Bearer csb_pub_....

Передайте appId=570 для Dota 2 или appId=252490 для Rust. У таких строк те же ключи; поля, которые есть только в CS2 (wear, doppler_phase, float_value, paint_seed, inspect_link, tradable_at, listed_at), равны null, а stickers — []. См. Игры.

Query-параметры

integer

по умолчанию:"730"

Игра: 730 — CS2, 570 — Dota 2, 252490 — Rust. Не передавайте параметр, чтобы получить CS2. Игры, доступные вашему ключу, — в GET /v1/games.

string

Нечёткое совпадение по 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, Pistol.

string

Фильтр по диапазону износа. Одно из: Factory New, Minimal Wear, Field-Tested, Well-Worn, Battle-Scarred. Только для CS2 — с другим appId вернёт 400 invalid_param.

string

Фильтр по уровню редкости, например Classified, Covert, Extraordinary.

number

Минимальная цена продажи в USD (включительно).

number

Максимальная цена продажи в USD (включительно).

number

Минимальное значение float (включительно). Принимает значения от 0.0 до 1.0. Только для CS2 — с другим appId вернёт 400 invalid_param.

number

Максимальное значение float (включительно). Принимает значения от 0.0 до 1.0. Только для CS2 — с другим appId вернёт 400 invalid_param.

string

Срок доставки — те же три группы, что показывает сетка на сайте. Одно из:

instant — доставка ботом. От нескольких секунд до нескольких минут.
up_to_12h — трейд должен отправить продавец-человек на площадке-источнике. На сайте отображается как ≤12 ч.
hold — внутри trade lock в Steam до tradable_at предмета.

Используйте delivery=instant для любого сценария, где доставка нужна сейчас — вывод, выплата ботом, пользователь, ждущий на экране. Любое другое значение вернёт 400, поэтому опечатка проявится сразу, а не расширит выдачу незаметно.

number

Только листинги, у которых refund_percent не меньше заданного (0–100). Листинги без опубликованного значения исключаются, а не считаются подходящими.?delivery=instant&min_refund_percent=100 — тот пул, который нужен сценарию вывода: доставка сразу, а откат трейда в Steam никому ничего не стоит.

string

Фильтр StatTrak™. only возвращает только предметы StatTrak™; exclude исключает их из результатов. Только для CS2 — с другим appId вернёт 400 invalid_param.

string

Фильтр Souvenir. only возвращает только сувенирные предметы; exclude исключает их из результатов. Только для CS2 — с другим appId вернёт 400 invalid_param.

string (ISO 8601)

Возвращать только листинги, попавшие в каталог после этой временной метки — параметр для чтения дельты. В паре с sort=newest обычный ответ — пустая страница, и именно это делает частый опрос дешёвым вместо полного перечитывания на каждом тике.Перекрывайте свою вотермарку примерно на 60 секунд и дедуплицируйте по id. Отправляйте max(listed_at) - 60s, а не голый максимум. Временные метки берутся из момента НАЧАЛА транзакции БД, опубликовавшей листинг, поэтому большая транзакция может закоммитить строки со штампом раньше, чем строки меньшей и более поздней транзакции, уже закоммиченные. Вотермарка, сдвинутая ровно на максимум, перешагнёт такие листинги навсегда.Только для CS2 — с другим appId вернёт 400 invalid_param.

string

по умолчанию:"id"

Порядок сортировки. Одно из: id (стабильный по умолчанию), newest, price_asc, price_desc. newest сортирует по listed_at, поэтому перевыставленные предметы всплывают наравне с действительно новыми. newest — только для CS2: с другим appId вернёт 400 invalid_param.

string

Keyset-курсор пагинации. Передайте значение next_cursor из предыдущего ответа, чтобы получить следующую страницу.

integer

по умолчанию:"50"

Количество результатов на странице. Минимум 1, максимум 200.

Поля ответа

Listing[]

обязательно

Массив объектов листингов для этой страницы.

Показать Listing object

string

обязательно

Стабильный идентификатор листинга. Передайте его в POST /v1/orders, чтобы купить предмет.

string

обязательно

Steam market hash name, например AK-47 | Redline (Minimal Wear).

string | null

Диапазон износа: Factory New, Minimal Wear, Field-Tested, Well-Worn или Battle-Scarred. null для предметов без износа (например, некоторые ножи или перчатки).

string | null

Фаза Doppler или Gamma Doppler, например "Phase 2", "Ruby", "Emerald". null для предметов, не относящихся к Doppler.

number | null

Значение float от 0.0 до 1.0. null, если неприменимо.

integer | null

Paint seed (индекс паттерна). null, если неприменимо.

Sticker[]

обязательно

Наклеенные стикеры. Пустой массив, если их нет.

Показать Sticker object

string

Название стикера, например Crown (Foil).

string (URI)

URL изображения стикера на CDN.

integer

Номер слота стикера, от 0 до 4.

number | null

Износ стикера от 0.0 до 1.0. null, если износ стикера не был получен.

number

обязательно

Авторитетная цена продажи в USD. Это ровно та сумма, которая будет списана при покупке этого листинга через POST /v1/orders.

string

обязательно

Категория предмета, например Rifle, Knife, Gloves.

string

Уровень редкости, например Classified, Covert.

string (URI)

URL изображения предмета на CDN.

string

Ссылка для осмотра в Steam (steam://rungame/...) для этого предмета.

boolean

обязательно

Можно ли сейчас обменивать предмет. false означает, что он находится в торговом холде.

datetime | null

Временная метка ISO 8601, когда предмет выйдет из торгового холда. null, если предмет уже доступен для обмена.

string

обязательно

Ожидаемый режим доставки: instant (бот, от секунд до минут), up_to_12h (трейд должен отправить продавец-человек на площадке-источнике) или hold (внутри trade lock в Steam до tradable_at).

number | null

Какая часть покупки вернётся, если Valve откатит трейд в Steam. Это свойство площадки, с которой пришёл листинг, а не политика поддержки; по нашим источникам значение лежит в диапазоне от 0 до 100.null означает, что опубликованного значения для этого листинга нет — считайте его неизвестным, а не равным 100. Фильтруйте через min_refund_percent, чтобы собрать пул, где любой откат полностью компенсируется.

datetime | null

Когда предмет попал в каталог. Не то же самое, что момент создания записи: предметы возвращаются в каталог постоянно — отменённые заказы, истёкшие трейд-офферы, снятые холды — и перевыставленный предмет для вас новый, даже если существовал раньше. Именно это значение нужно передавать обратно в available_after.

string | null

обязательно

Непрозрачный keyset-курсор. Передайте его как query-параметр cursor, чтобы получить следующую страницу. null на последней странице.

Пагинация

Этот эндпоинт использует keyset-пагинацию. Чтобы пройти все страницы:

Выполните первый запрос (без cursor).
Если next_cursor не равен null, повторите запрос с cursor=<next_cursor>.
Остановитесь, когда 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",
      "refund_percent": 100,
      "listed_at": "2026-06-29T08:41:17.000Z"
    }
  ],
  "next_cursor": "eyJpZCI6Iml0bV84ODQxMjAxIn0="
}

Коды ошибок

HTTP-статус	Код	Значение
400	`invalid_param`	Некорректный параметр или фильтр только для CS2, переданный с другим `appId`.
400	`unsupported_game`	Ваш ключ не может использовать этот `appId`. Доступные перечислены в `supported_app_ids`.
401	`missing_api_key`, `invalid_api_key`	Отсутствует или некорректный API-ключ.
429	`rate_limit_exceeded`	Превышен поминутный лимит вашего ключа (по умолчанию 100/мин). Подождите количество секунд, указанное в заголовке `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. Calls made with a key are metered only by that key's own limits — there is no per-IP limit on top — and every answer carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and X-RateLimit-Bucket for the bucket the call spent. See Rate limits.

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

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

string

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.

Ответ

A page of listings.

items

object[]

обязательно

Show child attributes

next_cursor

string | null

обязательно

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

Live buyable listings

curl --request GET \
  --url https://csboard.com/v1/listings \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://csboard.com/v1/listings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://csboard.com/v1/listings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://csboard.com/v1/listings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://csboard.com/v1/listings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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",
      "refund_percent": 100,
      "listed_at": "2026-06-29T08:41:17.000Z"
    }
  ],
  "next_cursor": "eyJpZCI6Iml0bV84ODQxMjAxIn0="
}

Рыночные данные

Торговля

P2P

Аккаунт

Статус

GET /v1/listings — просмотр актуальных листингов маркетплейса CS2

Query-параметры

Поля ответа

Пагинация

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

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

Коды ошибок

Авторизации

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

Ответ