Changelog: Releases and Breaking Changes

​

2026-10 — Partial results when a provider is unavailable

• POST /v1/prices and POST /v1/bids stream the available providers and name the missing ones in a new X-Snapshot-Unavailable-Providers response header (comma-separated). Previously the stream returned 503 when the first requested provider had no data.
• GET /v1/prices and GET /v1/bids listings (no item_id or market_hash_name) return the available providers and list the missing ones in a new meta.unavailable_providers field. Previously any missing provider returned 503.
• 503 is still returned when none of the requested providers are available.

​

2026-09 — stale flag on prices and bids

• Every row from GET /v1/prices, POST /v1/prices, POST /v1/prices/batch, GET /v1/bids, POST /v1/bids, and POST /v1/bids/batch includes stale. It is true when the provider’s most recent scan did not include the listing or buy order, so the price shown is the last one observed and may already be gone.
• New exclude_stale option (query parameter on the list and stream endpoints, body field on the batch endpoints) leaves those rows out. It defaults to false, so existing integrations see the same rows as before.
• With exclude_stale=true, pagination.total on broad listings (no item_id or market_hash_name) and X-Snapshot-Total on the streams still count stale rows, so a page can contain fewer than limit items.

​

2026-08 — SDK v3.1.0: feed streaming and portfolio value fields

• Python: pip install cs2cap==3.1.0
• Node/TypeScript: npm install cs2cap@3.1.0

• FeedStream, a streaming client for the real-time feeds. It handles the SSE connection, skips heartbeats, and yields decoded events with typed item changes.
• skinswap_t joins the provider enum.
• currency, price_provider, total_value, and change_24h_pct on the portfolio list model, plus the include parameter that fills the last two in.
• prices on the Steam import request, so an import can carry cost basis.
• Liquidity score field descriptions now match the current scoring model.

feed = cs2cap.FeedStream(client)

for event in feed.stream_prices(providers=["steam"], item_ids=[17464]):
    for item in event.items:
        print(event.provider, item.item_id, item.change, item.price)

const feed = new FeedStream(new Configuration({ accessToken }));

for await (const event of feed.streamPrices({ providers: ["steam"], itemIds: [17464] })) {
  for (const item of event.items) {
    console.log(event.provider, item.itemId, item.change, item.price);
  }
}

​

2026-08 — Portfolio list valuation and import cost basis

​

2026-08 — Liquidity score rebalanced around confirmed sales

​

2026-07 — Best bid excludes same-provider bids above the ask

​

2026-07 — Real-time price and bid feeds

• GET /feed/prices — price changes as providers refresh
• GET /feed/bids — buy-order changes

​

2026-07 — New provider: SkinSwap Trade

​

2026-07 — SDK v3.0.0: new repositories and renamed methods

• Python: CS2Cap/cs2cap-python — pip install cs2cap==3.0.0
• Node/TypeScript: CS2Cap/cs2cap-node — npm install cs2cap@3.0.0
• The former CS2Cap/SDKs repository is archived.