Quickstart: Make Your First CS2Cap API Call

This guide walks you through everything you need to make a live CS2 item price request with the CS2Cap SDK. You’ll set up your credentials, send a request, read the response, and know how to handle the most common errors — all before you write a single line of production code.

Install the SDK

Install the SDK for the language you are using.

pip install cs2cap

npm install cs2cap

Set up environment variables

Store your base URL and API key as environment variables so you never hardcode credentials into your code.

export CS2C_API_BASE="https://api.cs2c.app/v1"
export CS2C_API_KEY="your_api_key_here"

Generate your API key from the Account page at cs2cap.com after verifying your email address.

Make your first request

Query the /prices endpoint for an AK-47 | Redline (Field-Tested) across the Steam marketplace. This is the fastest way to confirm your key is working and to see what a real response looks like.

curl -sS \
  -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/prices?market_hash_name=AK-47%20%7C%20Redline%20(Field-Tested)&providers=steam&currency=USD"

import os

import cs2cap

configuration = cs2cap.Configuration(
    access_token=os.environ["CS2C_API_KEY"],
)

with cs2cap.ApiClient(configuration) as client:
    prices_api = cs2cap.PricesApi(client)
    response = prices_api.list_prices(
        market_hash_name="AK-47 | Redline (Field-Tested)",
        providers=["steam"],
        currency="USD",
    )

print(response.to_dict())

import { Configuration, PricesApi } from "cs2cap";

const accessToken = process.env.CS2C_API_KEY;

if (!accessToken) {
  throw new Error("Set CS2C_API_KEY before running this example.");
}

const pricesApi = new PricesApi(new Configuration({ accessToken }));
const response = await pricesApi.listPrices({
  marketHashName: "AK-47 | Redline (Field-Tested)",
  providers: ["steam"],
  currency: "USD",
});

console.log(response);

Understand the response

Every list endpoint returns three top-level fields:

items — the records you asked for, one object per provider result
meta — response context: the currency you requested, your filter parameters, and which providers actually returned data
pagination — total record count and paging state (limit, offset, has_next, has_prev)

{
  "meta": {
    "currency": "USD",
    "filters": {
      "market_hash_name": "★ Falchion Knife | Doppler (Minimal Wear)",
      "phase": "Phase 1",
      "requested_providers": [
        "steam",
        "marketcsgo"
      ]
    },
    "returned_providers": [
      "marketcsgo"
    ]
  },
  "items": [
    {
      "provider": "marketcsgo",
      "item_id": 3739,
      "market_hash_name": "★ Falchion Knife | Doppler (Minimal Wear)",
      "phase": "Phase 1",
      "lowest_ask": 58915,
      "quantity": 1,
      "link": "https://cs2c.app/r/marketcsgo/3739",
      "url": "https://market.csgo.com/...",
      "timestamp": "2026-03-18T16:14:41.493719Z",
      "last_updated": "2026-03-18T16:54:58.782196Z"
    }
  ],
  "pagination": {
    "limit": 1000,
    "offset": 0,
    "total": 2,
    "has_next": false,
    "has_prev": false
  }
}

All price fields use minor units (integer cents). A lowest_ask of 2550 with currency: USD means $25.50. Divide by 100 to convert to the major unit for any two-decimal currency.

Common next requests

Once you have a working /prices call, these four requests cover the most frequent follow-up queries. The item_id lookup is a good second step — it gives you the stable numeric ID you can reuse across endpoints without passing the full item name each time.

# Resolve a market_hash_name to its stable item_id
curl -sS -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/items?market_hash_name=AK-47%20%7C%20Redline%20(Field-Tested)"

# Highest buy orders across buy-order-enabled providers (Starter/Pro/Quant)
curl -sS -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/bids?market_hash_name=AK-47%20%7C%20Redline%20(Field-Tested)&providers=steam"

# Completed sale transactions from a specific provider (Pro/Quant)
curl -sS -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/sales?market_hash_name=AK-47%20%7C%20Redline%20(Field-Tested)&providers=csfloat&limit=10"

# Historical price snapshots for trend analysis (Pro/Quant)
curl -sS -H "Authorization: Bearer $CS2C_API_KEY" \
  "https://api.cs2c.app/prices/history?market_hash_name=AK-47%20%7C%20Redline%20(Field-Tested)&provider=steam&limit=50"

with cs2cap.ApiClient(configuration) as client:
    items_api = cs2cap.ItemsApi(client)
    bids_api = cs2cap.BidsApi(client)
    sales_api = cs2cap.SalesApi(client)
    prices_api = cs2cap.PricesApi(client)

    item = items_api.list_items(
        market_hash_name="AK-47 | Redline (Field-Tested)",
    )

    bids = bids_api.list_bids(
        market_hash_name="AK-47 | Redline (Field-Tested)",
        providers=["steam"],
        currency="USD",
    )

    sales = sales_api.list_recent_sales(
        market_hash_name="AK-47 | Redline (Field-Tested)",
        providers=["csfloat"],
        currency="USD",
        limit=10,
    )

    history = prices_api.get_price_history(
        market_hash_name="AK-47 | Redline (Field-Tested)",
        provider="steam",
        currency="USD",
        limit=50,
    )

import { BidsApi, Configuration, ItemsApi, PricesApi, SalesApi } from "cs2cap";

const configuration = new Configuration({ accessToken });
const itemsApi = new ItemsApi(configuration);
const bidsApi = new BidsApi(configuration);
const salesApi = new SalesApi(configuration);
const pricesApi = new PricesApi(configuration);

const item = await itemsApi.listItems({
  marketHashName: "AK-47 | Redline (Field-Tested)",
});

const bids = await bidsApi.listBids({
  marketHashName: "AK-47 | Redline (Field-Tested)",
  providers: ["steam"],
  currency: "USD",
});

const sales = await salesApi.listRecentSales({
  marketHashName: "AK-47 | Redline (Field-Tested)",
  providers: ["csfloat"],
  currency: "USD",
  limit: 10,
});

const history = await pricesApi.getPriceHistory({
  marketHashName: "AK-47 | Redline (Field-Tested)",
  provider: "steam",
  currency: "USD",
  limit: 50,
});

Buy orders require Starter or higher. Sales and raw history require Pro or higher. If your tier does not include an endpoint, the request returns 403 until you upgrade. See Pricing & Plans for a full endpoint-by-tier breakdown.

Handle common failures

The table below covers the errors you’re most likely to encounter while integrating. Treat these as your first-line debugging checklist before opening a support ticket.

Status	Code	What it means
`401`	`AUTH_INVALID_API_KEY`	Your `Authorization: Bearer` header is missing, malformed, or the key has been revoked. Check the header format and regenerate your key if needed.
`429`	`RATE_LIMIT_EXCEEDED`	You’re sending requests faster than your plan allows. Back off and respect the `Retry-After` response header before retrying.
`429`	`RATE_LIMIT_MONTHLY_QUOTA_EXCEEDED`	You’ve exhausted your plan’s monthly request quota. Upgrade your plan or wait for the quota to reset.
`503`	`PRICES_INDEX_UNAVAILABLE` or `BIDS_INDEX_UNAVAILABLE`	A data index is temporarily unavailable due to a refresh cycle or upstream issue. Retry with exponential backoff — this resolves quickly.
`422`	`VALIDATION_ERROR`	One or more query parameters are missing, have the wrong type, or contain an invalid value. Check the response body for a `details` field that identifies the offending parameter.

Do not retry 401 or 422 errors without first fixing the underlying issue — they will not self-resolve. Only 503 and 429 errors are safe to retry automatically.

Next steps

Authentication

Learn how API keys work, how to rotate them, and how to use sub-keys to scope access per application.

Core concepts

Understand providers, minor units, pagination, and the data model before you build.

API reference

Browse every endpoint: prices, bids, sales, analytics, portfolio, and account management.

Pricing & plans

Compare Free, Starter, Pro, and Quant tiers by endpoint access, rate limits, and monthly quotas.

Get Started

Guides

Reference

Quickstart: Make Your First CS2Cap API Call

Next steps

Authentication

Core concepts

API reference

Pricing & plans

​Next steps

Authentication

Core concepts

API reference

Pricing & plans

Next steps