> ## 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 — market data & trading

> Access live CS2 skin listings, floats, sticker data, and min-ask prices — plus opt-in automated buying — through a single REST API.

The CSBoard API is a developer- and AI-agent-friendly REST interface over the CSBoard marketplace. Whether you're building a price tracker, powering an AI trading agent, or automating purchases from your balance, the API delivers live listings, float values, sticker details, minAsk prices, and FX conversion rates — plus opt-in buying straight from your CSBoard balance. All endpoints are key-gated except the health check, and buying capability requires a separately enabled trading key.

## Base URL

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

## Key concepts

* **Health** — [`GET /v1/health`](/api-reference/get-health) is the only unauthenticated endpoint. Use it to verify the API is up and the price list is fresh before starting a session.
* **Listings** — [`GET /v1/listings`](/api-reference/get-listings) returns live buyable items with float, paint seed, stickers, and ask price in USD. Supports keyset pagination and rich filters.
* **Prices** — [`GET /v1/prices`](/api-reference/get-prices) delivers grouped minAsk prices per skin group. [`GET /v1/prices/snapshot.ndjson.gz`](/api-reference/get-prices-snapshot) provides a full gzipped NDJSON dump for bulk catalog ingestion.
* **Orders** — [`POST /v1/orders`](/api-reference/post-orders) places buy orders debited from your CSBoard balance. Requires a trading-enabled key.
* **FX rates** — All prices in this API are **USD**. Use [`GET /v1/currency`](/api-reference/get-currency) to convert to a local currency using the same rate table the site uses.

Pagination across all list endpoints uses a **keyset cursor** — pass the `cursor` value returned in one response as the `cursor` query parameter of the next request.

## Quick start

Only [`GET /v1/health`](/api-reference/get-health) works without a key. Every other endpoint requires a `csb_pub_` Bearer token in the `Authorization` header:

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

Generate your key at [csboard.com/profile?tab=api](https://csboard.com/profile?tab=api) and see the [Authentication](/authentication) page for full details on key types and error handling.

## Explore the docs

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    Learn how to generate a key, pass it on requests, and understand the difference between read and trading keys.
  </Card>

  <Card title="Rate Limits" icon="gauge" href="/rate-limits">
    Understand per-key request limits, the `Retry-After` header, and how to handle 429 responses.
  </Card>

  <Card title="Market Data Guide" icon="chart-line" href="/guides/market-data">
    Query live listings, retrieve min-ask prices, and download bulk snapshots.
  </Card>

  <Card title="Buying Guide" icon="cart-shopping" href="/guides/buying">
    Place orders against your CSBoard balance using a trading-enabled key.
  </Card>
</CardGroup>