Steam price API for item quotes, batches and history

Export WOK_API_KEY and WOK_MARKET_HASH_NAME as environment variables on your server before running these examples. Copy the full CS2 name from items[].markethashname in an actual inventory or market_hash_name in a catalog result, including exterior and StatTrak or Souvenir variant. This example requests only Skinport's saved CS2 listing floor; it does not assume that source covers every game or item.

umask 077
curl --disable --fail-with-body --max-time 30 --max-filesize 262144 \
  -H "Authorization: Bearer $WOK_API_KEY" \
  --get "https://woksteamapi.com/v1/price" \
  --data-urlencode "game=cs2" \
  --data-urlencode "name=$WOK_MARKET_HASH_NAME" \
  --data-urlencode "price_source=skinport" \
  --data-urlencode "price_stat=min" \
  --data-urlencode "strict=1" \
  --output quote.json --write-out '\nHTTP %{http_code}\n'

The command makes one bounded request and saves its body as quote.json. It prints the HTTP status. Run the Python check below only after curl succeeds with HTTP 200; a failed capture can leave an incomplete file. The request consumes one WOK quota unit when admitted, including an unavailable quote. It makes no Steam inventory scan or on-demand marketplace refresh. The first curl option, --disable, ignores the default curl configuration file; redirects and retries are not enabled.

Check the saved quote without another API call

Save the following as quote_check.py, then run python3 quote_check.py in the directory containing the successful response. The one-hour limit is an illustrative application setting. Choose the age your workflow accepts; WOK does not guarantee that every source updates within it. The checker requires this exact game, name, USD, statistic and provider, rejects unknown or future times, and never substitutes another price.

# Save as quote_check.py. Python 3.10+, standard library only.
import json
import math
import os
import time

MAX_AGE_SECONDS = 3600  # Example application policy, not a WOK freshness promise.


def positive_number(value):
    try:
        return (isinstance(value, (int, float)) and not isinstance(value, bool)
                and math.isfinite(value) and value > 0)
    except OverflowError:
        return False


def check_quote(quote, expected_name, now):
    if not isinstance(quote, dict):
        raise ValueError("Unexpected quote response")
    if (quote.get("game") != "cs2" or quote.get("name") != expected_name
            or quote.get("currency") != "USD" or quote.get("price_stat") != "min"):
        raise ValueError("Unexpected game, exact name, currency or statistic")
    price = quote.get("price")
    if quote.get("price_status") != "available" or not positive_number(price):
        raise ValueError("No usable selected price; keep the value unavailable")
    if quote.get("source") != "skinport":
        raise ValueError("The quote is not from the required source")
    observed_at = quote.get("updated_at")
    if not positive_number(observed_at) or observed_at > now:
        raise ValueError("Unknown or future source time; do not label it fresh")
    age = now - observed_at
    if age > MAX_AGE_SECONDS:
        raise ValueError("Source quote is older than this application's age policy")
    return price, age


if __name__ == "__main__":
    with open("quote.json", "rb") as saved:
        raw = saved.read(262145)
    if len(raw) > 262144:
        raise SystemExit("Quote file exceeds the example's size limit")
    try:
        quote = json.loads(raw)
        price, age = check_quote(quote, os.environ["WOK_MARKET_HASH_NAME"], time.time())
    except (ValueError, KeyError) as error:
        raise SystemExit(str(error))
    print(f"{price:.2f} USD; Skinport listing floor; source age {age:.0f}s")

To investigate broader gaps, request GET /v1/prices/coverage?game=cs2&source=skinport with Bearer authentication. This is a separate quota-bearing request. Its quote_age_p50_seconds, quote_age_p95_seconds and missing-name counts summarize saved source rows and can be cached for five minutes. They do not prove that this exact item meets your age policy or that all Steam items are covered. A repeated quote read, source change or inventory refresh_prices=1 reads local observations; none forces a new provider observation.

A positive listing-floor quote remains a name-level observation. It does not establish current ownership, live stock, the value of an individual float or sticker craft, or sale proceeds after fees. For inventory values, retain null item prices, unpriced, quantities and sellable-state rules instead of treating missing coverage as zero.

Revalue an active inventory snapshotAudit inventory quantities and unpriced valueHandle access and API errorsSaved coverage and freshness reference

CSFloat pricesYouPin898 pricesSkinport pricesWaxpeer pricesMarket.CSGO prices

GET /v1/price accepts price_source, strict=1 and price_stat for one exact market hash name, while its sources map shows available saved quotes. Use GET /v1/items?game=cs2&source=waxpeer to page exact-source catalog rows. Explicit price_source=auto overrides a key's saved source. Omit price_source to preserve the key's saved selection; when none is set, the server default applies. mix can use fresh opt-in marketplace observations after a coarse outlier check. A selectable mode does not prove fresh coverage for a particular item. Compare each source's timestamp before treating quotes as simultaneous.

price_stat=selected|min|max|avg|median works across price, catalog and inventory endpoints. Without price_source, the statistics compare one recent lowest selling ask per marketplace; they do not summarize all seller lots. With price_source, WOK uses that provider's reported measure and returns null when the provider has no real maximum, average or median. price_statistics.basis, source_count and coverage make the scope explicit. To calculate min, max, average or median over actual CS2 Steam Market lots, use /v1/cs2/market-listings, follow its pages and keep native currencies separate. Its statistics cover observed matching lots on each returned page and include Steam fees.

GET /v1/cs2/market-prices provides a separate short-lived CS2 comparison snapshot where its upstream source has a fresh quote, including observed CSFloat and Youpin entries when available. It does not guarantee either market for every item. WOK does not currently promise DMarket coverage. Market-name quotes also cannot appraise an individual float, pattern, sticker combination, fees or actual sale proceeds.