Skip to main content
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. It also supports 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

​
Key concepts

  • Health — GET /v1/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 returns live buyable items with float, paint seed, stickers, and ask price in USD. Supports keyset pagination and rich filters.
  • Prices — GET /v1/prices delivers grouped minAsk prices per skin group. GET /v1/prices/snapshot.ndjson.gz provides a full gzipped NDJSON dump for bulk catalog ingestion.
  • Orders — POST /v1/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 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 works without a key. Every other endpoint requires a csb_pub_ Bearer token in the Authorization header:
Generate your key at csboard.com/profile?tab=api and see the Authentication page for full details on key types and error handling.

​
Explore the docs

Authentication

Learn how to generate a key, pass it on requests, and understand the difference between read and trading keys.

Rate Limits

Understand per-key request limits, the Retry-After header, and how to handle 429 responses.

Market Data Guide

Query live listings, retrieve min-ask prices, and download bulk snapshots.

Buying Guide

Place orders against your CSBoard balance using a trading-enabled key.