# CSBoard API ## Docs - [Account balance and trading status](https://api.csboard.com/api-reference/account/account-balance-and-trading-status.md): Your current balance in USD, plus how much of it is settled (reversal-safe) versus held. Use `settled_balance_usd` to know what is available for reversal-safe spending, and `trading_enabled` to check whether buying is turned on for this key. - [GET /v1/balance — Account Balance and Trading Status](https://api.csboard.com/api-reference/get-balance.md): Check your CSBoard balance in USD, how much is settled versus held, and whether trading is enabled for your API key. - [GET /v1/currency — FX Rates for USD Price Conversion](https://api.csboard.com/api-reference/get-currency.md): Retrieve the USD-base FX rate table used by CSBoard payment flows. Multiply any price_usd by the target currency rate for a local-currency price. - [GET /v1/health — CSBoard API Liveness and Freshness Probe](https://api.csboard.com/api-reference/get-health.md): Check whether the CSBoard API is reachable and how stale the price list is. The only endpoint that works without an API key — safe to poll unauthenticated. - [GET /v1/listings — Browse Live CS2 Marketplace Listings](https://api.csboard.com/api-reference/get-listings.md): Fetch live, buyable CS2 skin listings with float, paint seed, stickers, and USD asking price. Filter by wear, category, rarity, float range, and more. - [GET /v1/listings/availability — Bulk Availability Check](https://api.csboard.com/api-reference/get-listings-availability.md): Check whether up to 100 CSBoard listings are still buyable in a single request, with per-id available counts and a list of unavailable ids. - [GET /v1/orders/{id} — Fetch a Single Order](https://api.csboard.com/api-reference/get-order.md): Retrieve one CSBoard order by its order id, including per-item delivery status and Steam trade offer details. - [GET /v1/orders — List Your Purchase History](https://api.csboard.com/api-reference/get-orders.md): Page through your CSBoard purchase history with keyset pagination. Filter by time window and status; each order includes per-item delivery details. - [GET /v1/orders/info — Batch Order Lookup](https://api.csboard.com/api-reference/get-orders-info.md): Look up the status of many CSBoard orders at once by custom_ids and/or order_ids, up to 200 ids per request. - [GET /v1/prices — CS2 minAsk Price List by Item Group](https://api.csboard.com/api-reference/get-prices.md): Retrieve a paginated minAsk price snapshot grouped by market hash name, wear, and Doppler phase, with cheapest ask and listing count per row. - [GET /v1/prices/snapshot.ndjson.gz — Full Price Snapshot](https://api.csboard.com/api-reference/get-prices-snapshot.md): Download the full CSBoard price catalog as a gzipped NDJSON file. One PriceRow per line. Designed for bulk ingestion with ETag-based conditional fetching. - [Bulk availability check](https://api.csboard.com/api-reference/market-data/bulk-availability-check.md): Check whether specific listings are still buyable, in one request. Pass up to 100 listing ids as a comma-separated `ids` query parameter. Returns how many of each id are available, plus the ids that are no longer available. - [Full price-list snapshot (gzipped NDJSON)](https://api.csboard.com/api-reference/market-data/full-price-list-snapshot-gzipped-ndjson.md): Full gzipped NDJSON dump of the price list — one price row JSON per line. Use this for full-catalog ingestion (e.g. comparison sites), not pagination. Rate limited to 1 request/minute. Supports ETag / If-None-Match: an unchanged snapshot returns 304 Not Modified. - [FX rates (USD base)](https://api.csboard.com/api-reference/market-data/fx-rates-usd-base.md): FX rates with USD as the base. Every price in this API is USD — use this to convert to a local currency. Same rate table the site and payment flows use (cached ~1h). - [Live buyable listings](https://api.csboard.com/api-reference/market-data/live-buyable-listings.md): Live buyable listings across the marketplace — each with float, paint seed, stickers, and the asking price in USD. Use keyset pagination via `cursor`. - [minAsk price list](https://api.csboard.com/api-reference/market-data/minask-price-list.md): The minAsk price list — one row per market hash name (+ wear + Doppler phase), with the cheapest current ask and how many are listed. Indicative grouped snapshot; can lag the live listing price. - [POST /v1/market/buy — Buy and Deliver to a Steam Trade URL](https://api.csboard.com/api-reference/post-market-buy.md): Buy up to 100 items and deliver them straight to any Steam trade URL you supply, paid from your settled balance. Built for wholesale and automated delivery. - [POST /v1/orders — Buy CS2 Listings from Your Balance](https://api.csboard.com/api-reference/post-orders.md): Buy 1–10 CS2 listings by ID in a single atomic request, debited from your CSBoard balance. Requires a trading-enabled API key and linked Steam account. - [Liveness + freshness probe](https://api.csboard.com/api-reference/status/liveness-+-freshness-probe.md): Liveness and price-list freshness probe. No key required — use it to check the API is up and the price list is fresh. This is the only endpoint that works without authentication. - [Batch order lookup](https://api.csboard.com/api-reference/trading/batch-order-lookup.md): Look up the status of many orders at once by `custom_ids` and/or `order_ids` (comma-separated). Supply at least one of the two; up to 200 ids in total across both parameters. - [Buy and deliver to a Steam trade URL](https://api.csboard.com/api-reference/trading/buy-and-deliver-to-a-steam-trade-url.md): Buy up to 100 items and deliver them straight to any Steam trade URL you supply (built from `partner` + `token`), paid from your **settled** (reversal-safe) balance. Built for wholesale and automated delivery. Idempotent via the `custom_id` body field — a retry with the same `custom_id` replays the… - [Buy listings from your balance](https://api.csboard.com/api-reference/trading/buy-listings-from-your-balance.md): Buy 1–10 listings by id, debited from your CSBoard balance. Requires trading enabled on the key + a linked Steam account and trade URL. Buys are charged at the LIVE price at execution; always send `max_price_usd` as an atomic overcharge ceiling. Idempotent via the `Idempotency-Key` header or `idempo… - [Get a single order](https://api.csboard.com/api-reference/trading/get-a-single-order.md): Fetch one order by its CSBoard order id, including per-item delivery status. - [List purchase history](https://api.csboard.com/api-reference/trading/list-purchase-history.md): Your purchase history, newest first, with keyset pagination. Filter by time window and status. Pass `meta.next_cursor` back as `cursor` to walk older pages; `next_cursor` is null on the last page. - [Authenticate with the CSBoard API Using Bearer Tokens](https://api.csboard.com/authentication.md): Generate a csb_pub_ API key at your profile page, pass it as a Bearer token or query parameter, and understand read vs. trading key capabilities. - [Automate CS2 Skin Trading Bots with the CSBoard API](https://api.csboard.com/guides/automation.md): Build bots, price monitors, and data pipelines on top of the CSBoard API — from polling new listings to safe automated buying and full-catalog ingestion. - [Buy CS2 Skins Automatically from Your CSBoard Balance](https://api.csboard.com/guides/buying.md): Place automated orders against your CSBoard balance, protect against price moves, and guarantee idempotent delivery using POST /v1/orders. - [Query Live CS2 Listings and Prices with CSBoard API](https://api.csboard.com/guides/market-data.md): Browse live buyable listings, look up minAsk prices, download full-catalog snapshots, and convert prices to any currency with the CSBoard API. - [CSBoard API — market data & trading](https://api.csboard.com/introduction.md): Access live CS2 skin listings, floats, sticker data, and min-ask prices — plus opt-in automated buying — through a single REST API. - [CSBoard API Rate Limits and How to Handle 429 Errors](https://api.csboard.com/rate-limits.md): Understand per-key request limits across all CSBoard API endpoints, read the Retry-After header, and implement correct 429 back-off logic. ## OpenAPI Specs - [openapi](https://api.csboard.com/openapi.json)