GET /v1/liquidity/items

On this page

GET /v1/liquidity/items
Access
Liquidity buckets
Variants
Request
Response
Response fields
Item data
Errors

Returns the latest liquidity bucket and estimated sale time for every item.

Liquidity is recomputed daily from sale volume and traded value over rolling 30- and 90-day windows, weighted toward recent activity. Variants are scored independently from their base item.

Access#

Requires a Scale or Enterprise API key.

Liquidity buckets#

Bucket	Meaning
`unknown`	Too few recent sales to classify.
`extremely_illiquid`	Almost no sales.
`very_illiquid`	Very low sale volume.
`illiquid`	Low sale volume.
`moderate`	Moderate sale volume.
`liquid`	Consistent sale volume.
`very_liquid`	High sale volume.
`extremely_liquid`	Very high sale volume; among the most-traded items.

Variants#

Supported Doppler, Gamma Doppler, and Case Hardened variants are returned under the base item in variants. Variant maps are keyed by display name, such as Phase 1, Ruby, or Tier 1. In a variant object, market_hash_name is the base item name, name is the full variant name, and version is the stable code.

Request#

GETapi.cs2.sh/v1/liquidity/items

curl https://api.cs2.sh/v1/liquidity/items \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Accept-Encoding: gzip" --compressed

Response#

{
  "response_time": "2026-07-26T00:00:29.508Z",
  "run_date": "2026-07-26",
  "items": {
    "USP-S | Printstream (Factory New)": {
      "market_hash_name": "USP-S | Printstream (Factory New)",
      "liquidity": "extremely_liquid",
      "estimated_sale_time": "1 - 2 hours"
    }
  }
}

Response fields#

ItemLiquidityGetResponse fields:

Field	Type	Required	Description
`response_time`	`string (date-time)`	Yes	When the snapshot was computed.
`run_date`	`string (date)`	Yes	UTC date for the daily computation.
`items`	`Record<string, ItemLiquidityItem>`	Yes	Map of `market_hash_name` to item liquidity data.

Item data#

Field	Description
`items.<name>.liquidity`	Liquidity bucket, from `extremely_illiquid` to `extremely_liquid`.
`items.<name>.estimated_sale_time`	Estimated sale time range, assuming a competitive listing price.
`items.<name>.variants`	Per-variant liquidity entries, scored independently.

market_hash_name, liquidity, and estimated_sale_time are present on returned items.
variants appears only for items with variant liquidity data.

Full schema: ItemLiquidityItem.

Errors#

503 service_unavailable means the current liquidity snapshot is not ready. See Request errors for shared errors.