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 — 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 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: 
curl https://csboard.com/v1/listings \
  -H "Authorization: Bearer csb_pub_..."
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.