Перейти к основному содержанию
API CSBoard — это REST-интерфейс, удобный как для разработчиков, так и для AI-агентов, над маркетплейсом CSBoard. Создаёте ли вы трекер цен, AI-агента для торговли или автоматизируете покупки с баланса — API предоставляет актуальные листинги, float-значения, данные о стикерах, цены minAsk и курсы конвертации валют, а также опциональную покупку прямо с баланса CSBoard. Все эндпоинты требуют ключа, кроме проверки состояния, а возможность покупки требует отдельно включённого торгового ключа.

​
Базовый URL

https://csboard.com/v1

​
Ключевые концепции

  • Health — GET /v1/health — единственный эндпоинт без аутентификации. Используйте его, чтобы убедиться, что API доступен и прайс-лист актуален, перед началом сессии.
  • Listings — GET /v1/listings возвращает актуальные доступные к покупке предметы с float, paint seed, стикерами и ценой ask в USD. Поддерживает keyset-пагинацию и расширенные фильтры.
  • Prices — GET /v1/prices выдаёт сгруппированные цены minAsk по группам скинов. GET /v1/prices/snapshot.ndjson.gz предоставляет полный gzip NDJSON-дамп для массовой загрузки каталога.
  • Orders — POST /v1/orders размещает ордера на покупку со списанием с баланса CSBoard. Требует ключ с включённой торговлей.
  • Курсы валют — все цены в этом API указаны в USD. Используйте GET /v1/currency для конвертации в локальную валюту по тем же курсам, что использует сайт.
Пагинация во всех эндпоинтах со списками использует keyset-курсор — передайте значение cursor из одного ответа как параметр запроса cursor в следующем запросе.

​
Быстрый старт

Только GET /v1/health работает без ключа. Каждый другой эндпоинт требует Bearer-токен csb_pub_ в заголовке Authorization: 
curl https://csboard.com/v1/listings \
  -H "Authorization: Bearer csb_pub_..."
Сгенерируйте ключ на csboard.com/profile?tab=api и см. страницу Аутентификация для подробной информации о типах ключей и обработке ошибок.

​
Изучите документацию

Аутентификация

Узнайте, как сгенерировать ключ, передавать его в запросах и в чём разница между ключами чтения и торговли.

Лимиты запросов

Разберитесь в лимитах запросов на ключ, заголовке Retry-After и обработке ответов 429.

Руководство по рыночным данным

Запрашивайте актуальные листинги, получайте цены min-ask и скачивайте массовые снапшоты.

Руководство по покупке

Размещайте ордера с использованием баланса CSBoard, применяя ключ с включённой торговлей.