CS2 inventory API with prices and inspect links

CS2 uses Steam AppID 730, context 2. Start without include_inspect if your key has no Inspect capability. The optional Inspect workflow requires that capability. Inventory metadata and a market-name price are not an instance-level float or sticker appraisal.

Always read status, unpriced, items[].pricesource and items[].priceupdatedat. For a priced item, pricemedian × count is its grouped value; volume is market metadata, not inventory quantity. Keep total, untradable_value and tradelocked_value separate rather than adding them into an unlabeled estimate.

Normal OK/EMPTY cache hits reapply current local prices while keeping the existing inventory snapshot and TTL. Changing price_source does not request a provider refresh. A recent inventory scan can still have an older price observation; show those two ages separately.

Quote items without a SteamIDRefresh only cached inventory pricesCompare WOK with SteamWebAPIValidate your existing integration

1. Read the inspect actions supplied by Steam

curl --fail-with-body \
  -H "Authorization: Bearer $WOK_API_KEY" \
  "https://woksteamapi.com/v1/inventory?steam_id=76561198090744629&game=cs2&top=0&include_inspect=1"

When available, items[].inspect_items[] pairs a string assetid with its inspect_link and optional paint_index or doppler_phase. This list is not a complete asset roster: instances without inspect metadata can be absent. A grouped row can contain different finishes, so do not apply one instance's phase to every item in the group.

Need one row per asset instead? Use GET /steam/api/inventory with game=cs2&group=0. That compatibility route returns a flat array with string assetid values, not the native totals object. Add include_inspect=1 only with the add-on. group is not a parameter of /v1/inventory. See the response mapping before switching routes.

2. Decode a supported inspect link on your server

Set CS2_INSPECT_LINK to an actual link from the result. POST /v1/cs2/inspect decodes modern self-encoded previews locally. A resolved item can include float, paint seed/index, stickers and keychains; it does not price their individual premiums.

import os
import requests

# Requires the Inspect add-on; use an inspect link actually supplied by Steam.
response = requests.post(
    "https://woksteamapi.com/v1/cs2/inspect",
    headers={"Authorization": f"Bearer {os.environ['WOK_API_KEY']}"},
    json={"inspect_link": os.environ["CS2_INSPECT_LINK"]},
    timeout=30,
)
response.raise_for_status()
inspection = response.json()
if inspection.get("status") != "resolved" or not inspection.get("item"):
    reason = (inspection.get("error") or {}).get("code", "unavailable")
    raise RuntimeError(f"Inspect data unavailable: {reason}")
item = inspection["item"]
# A missing field is unknown, never a float of zero.
print({"float_value": item.get("float_value"),
       "paint_index": item.get("paint_index"),
       "paint_seed": item.get("paint_seed")})

A legacy S/M link returns HTTP 200 with status="unavailable", item=null and error.code="legacy_gc_required". WOK does not query the Game Coordinator to fill that gap. Keep the value unknown; repeatedly submitting the same legacy link will not make it decodable. Check the returned capabilities before relying on optional fields.

Resolve new CS2 item names from a Steam class ID

GET /v1/cs2/item-preview?classid=...&instanceid=0 reads Valve's class metadata directly and can return the market hash name, image and tags before WOK's local catalog has that class. It uses a normal WOK API key and one request unit, without residential inventory traffic. This describes an item class, not an owned asset: the response cannot establish an individual float, paint seed, attachments or trade protection. A class that Steam has not indexed yet returns 404. See the CS2 class preview guide for request and response examples.

3. Resolve a phase only when paint metadata supports it

POST /v1/cs2/doppler-phase accepts exactly one inspect_link or paint_index in its JSON body. A non-Doppler paint index returns status="not_doppler" and doppler_phase=null, not a guessed phase. Both CS2 metadata endpoints require Inspect and consume request quota, even though decoding does not fetch Steam.

Complete CS2 API mapCurrent Market listing floatsCS2 request and response referenceOpenAPI schemasBUFF163 baseline item pricesMulti-game inventory integration

For production polling, read GET /v1/key for the key's effective quota and reset times; that lookup does not consume quota. A successful inventory cache hit still consumes a request unit. Group a roster with batch inventory requests, remembering that quota is counted per unique player-game pair, not once per batch.

Use price-only refresh when you only need to revalue an active cached snapshot. It does not prove the player still owns the items. Before an ownership-sensitive action, decide whether the reported inventory age is acceptable; no_cache=1 requests a fresh scan but cannot bypass Steam privacy or availability.

Detailed retry and rate-limit handlingCompatibility endpoint status mappingIntegration support