GET /v1/liquidity/items

本页内容

GET /v1/liquidity/items
访问
流动性分档
变体
请求
响应
响应字段
饰品数据
错误

返回每件饰品最新的流动性分档和预估售出时间。

流动性每天重新计算，依据滚动 30 天和 90 天窗口内的成交量与成交额，并更重视近期活动。变体与基础饰品分别评分。

访问#

需要 Scale 或 Enterprise API 密钥。

流动性分档#

分档	含义
`unknown`	近期成交太少，无法分类。
`extremely_illiquid`	几乎没有成交。
`very_illiquid`	成交量很低。
`illiquid`	成交量较低。
`moderate`	成交量中等。
`liquid`	成交量稳定。
`very_liquid`	成交量较高。
`extremely_liquid`	成交量很高，属于交易最活跃的饰品。

变体#

支持的 Doppler、Gamma Doppler 和 Case Hardened 变体会返回在基础饰品的 variants 下。变体映射以显示名称作为键，例如 Phase 1、Ruby 或 Tier 1。在变体对象中，market_hash_name 是基础饰品名称，name 是完整变体名称，version 是稳定代码。

请求#

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_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"
    }
  }
}

响应字段#

ItemLiquidityGetResponse 字段:

字段	类型	必需	描述
`response_time`	`string (date-time)`	是	快照计算时间。
`run_date`	`string (date)`	是	每日计算对应的 UTC 日期。
`items`	`Record<string, ItemLiquidityItem>`	是	`market_hash_name` 到饰品流动性数据的映射。

饰品数据#

字段	描述
`items.<name>.liquidity`	流动性分档，从 `extremely_illiquid` 到 `extremely_liquid`。
`items.<name>.estimated_sale_time`	估计售出时间范围，假设挂单定价具有竞争力。
`items.<name>.variants`	逐变体的流动性条目，独立评分。

返回的饰品上都存在 market_hash_name、liquidity 和 estimated_sale_time。
variants 仅在饰品具有变体流动性数据时出现。

完整结构：ItemLiquidityItem。

错误#

503 service_unavailable 表示当前流动性快照尚未就绪。共有错误见请求错误。