> ## Documentation Index
> Fetch the complete documentation index at: https://api.csboard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CSBoard API — рыночные данные и торговля

> Доступ к актуальным листингам CS2-скинов, float-значениям, данным о стикерах и ценам min-ask — а также к опциональной автоматической покупке — через единый REST API.

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

## Базовый URL

```
https://csboard.com/v1
```

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

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

Пагинация во всех эндпоинтах со списками использует **keyset-курсор** — передайте значение `cursor` из одного ответа как параметр запроса `cursor` в следующем запросе.

## Быстрый старт

Только [`GET /v1/health`](/api-reference/get-health) работает без ключа. Каждый другой эндпоинт требует Bearer-токен `csb_pub_` в заголовке `Authorization`:

```bash theme={null}
curl https://csboard.com/v1/listings \
  -H "Authorization: Bearer csb_pub_..."
```

Сгенерируйте ключ на [csboard.com/profile?tab=api](https://csboard.com/profile?tab=api) и см. страницу [Аутентификация](/authentication) для подробной информации о типах ключей и обработке ошибок.

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

<CardGroup cols={2}>
  <Card title="Аутентификация" icon="key" href="/authentication">
    Узнайте, как сгенерировать ключ, передавать его в запросах и в чём разница между ключами чтения и торговли.
  </Card>

  <Card title="Лимиты запросов" icon="gauge" href="/rate-limits">
    Разберитесь в лимитах запросов на ключ, заголовке `Retry-After` и обработке ответов 429.
  </Card>

  <Card title="Руководство по рыночным данным" icon="chart-line" href="/guides/market-data">
    Запрашивайте актуальные листинги, получайте цены min-ask и скачивайте массовые снапшоты.
  </Card>

  <Card title="Руководство по покупке" icon="cart-shopping" href="/guides/buying">
    Размещайте ордера с использованием баланса CSBoard, применяя ключ с включённой торговлей.
  </Card>
</CardGroup>