Skip to main content
The CS2Cap API gives you programmatic access to CS2 market prices, buy orders, recent sales, and item catalog data. All endpoints are served from a single base URL, secured with a Bearer token, and return JSON (or NDJSON for streaming endpoints). This page covers everything you need to start making requests: authentication, rate limits, response conventions, and error handling.

​
Base URL

​
Authentication

Every market-data endpoint requires your API key in the Authorization header:

​
Getting an API key

1

Sign up with OAuth

Create a CS2Cap account using OAuth.
2

Verify your email

Add and verify an email address on the account. Verification is required before a key is issued or reissued.
3

Save your API key

Copy your initial API key from the account dashboard, or reissue a new one at any time from the account flow.
4

Send the key with requests

Include Authorization: Bearer {api_key} in every request to a market-data endpoint.
You can have at most one active API key per account. Reissuing a key immediately invalidates the previous one.

​
Rate limits

Rate limits are enforced per API key based on your subscription tier:

​
Rate limit response headers

When you hit a rate limit you receive a 429 response. The following headers tell you when you can retry and how much quota remains:
Monthly quota applies only to public core market-data endpoints. Account, billing, verification, recovery, and alert routes are still rate-limited, but they do not consume your advertised monthly quota.

​
Response conventions

  • Most list endpoints return an items array, plus meta and pagination objects when relevant.
  • GET /items returns all matches in a single response when you omit the limit parameter.
  • Cursor-paginated endpoints always return pagination.total = -1. Use has_next and next_cursor to paginate.
  • Price fields—lowest_ask, highest_bid, and price—are always returned in minor units of the response currency. For example, 531143 in USD means $5,311.43. Divide by 100 for display.
  • providers, providers_buy, and providers_sell are repeatable query parameters. Pass them multiple times to include more than one provider: providers=steam&providers=buff163.
  • provider (singular) always accepts a single provider key.

​
Error handling

Every error response includes a stable machine-readable code and a human-readable detail string.

​
Status codes

​
Common error codes

​
Explore the API

Prices

Current lowest asks, historical records, OHLCV candles, and full-catalog streaming.

Bids

Highest buy orders across CS2 marketplaces, with streaming and batch lookup.

Sales

Recent transaction history with float, stickers, charms, and inspect links.

Catalog

Item search, provider metadata, and FX rates.

Market Analytics

Aggregated market signals and trend data.

Portfolio

Track and value your CS2 inventory across marketplaces.
Last modified on July 12, 2026