POST /v1/archive/steam

本页内容

POST /v1/archive/steam
访问
支持的间隔
请求
参数
响应
响应字段
分桶
错误

返回 Steam 社区市场原生历史分桶中的成交中位价和购买数量。

日（1d）分桶自 2013 年 4 月 26 日起
小时（1h）分桶自 2026 年 5 月 9 日起

这与 Steam 社区市场饰品页面价格图中显示的数据相同。每天采集约 1-4 次。不支持变体。每次请求最多 100 个饰品。

访问#

需要 Scale 或 Enterprise API 密钥。

支持的间隔#

间隔	最大范围
`1h`	不限
`1d`	不限

请求#

POSTapi.cs2.sh/v1/archive/steam

curl -X POST https://api.cs2.sh/v1/archive/steam \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Accept-Encoding: gzip" --compressed \
  -H "Content-Type: application/json" \
  -d '{
  "items": [
    "USP-S | Printstream (Factory New)"
  ],
  "start": "2025-01-01",
  "end": "2025-02-01",
  "interval": "1d",
  "currency": "USD"
}'

参数#

字段	类型	必需	描述
`items`	`string[]`	是	常规 `market_hash_name` 值列表（最多 100 个）。不支持变体。
`start`	`string`	是	开始日期/时间（YYYY-MM-DD 或 RFC3339），包含。
`end`	`string`	否	结束日期/时间（YYYY-MM-DD 或 RFC3339），不含。默认现在。
`interval`	`string`	是	允许值: `1h`, `1d`. 原生 Steam 分桶间隔。两种间隔的范围均不限。
`currency`	`string`	否	默认值: `USD`. 允许值: `AUD`, `CAD`, `CHF`, `CNY`, `EUR`, `GBP`, `JPY`, `NZD`, `SGD`, `USD`. 响应中所有价格使用的货币。

响应#

{
  "response_time": "2026-08-23T22:00:09.293115Z",
  "currency": "USD",
  "start": "2025-01-01T00:00:00Z",
  "end": "2025-02-01T00:00:00Z",
  "interval": "1d",
  "items": {
    "USP-S | Printstream (Factory New)": {
      "market_hash_name": "USP-S | Printstream (Factory New)",
      "count": 31,
      "data": [
        {
          "bucket": "2025-01-01T00:00:00Z",
          "price": 150.23,
          "volume": 7
        }
      ]
    }
  }
}

响应字段#

ArchiveSteamResponse 字段:

字段	类型	必需	描述
`response_time`	`string (date-time)`	是	响应生成时间。
`currency`	`string`	是	响应中所有价格的货币代码：即请求的 `currency`，默认为 `USD`。
`start`	`string (date-time)`	是	查询区间的有效起点，向下对齐到间隔边界。包含。
`end`	`string (date-time)`	是	查询区间的有效终点，向上对齐到间隔边界。不含。
`interval`	`string`	是	允许值: `1h`, `1d`. 请求的分桶间隔。
`items`	`Record<string, ArchiveSteamItem>`	是	`market_hash_name` 到原生 Steam 成交历史分桶的映射。
`errors`	ItemError[]	否	部分成功响应中按饰品的错误列表。

分桶#

字段	描述
`items.<name>.count`	有数据的分桶数。
`items.<name>.data[]`	原生 Steam 成交历史分桶。
`data[].bucket`	分桶边界。
`data[].price`	Steam 的成交中位价，美元。
`data[].volume`	该分桶内的购买数量。

每个分桶上都存在 bucket。
当 Steam 的原生分桶缺少相应值时，price 或 volume 可以是 null。
不支持变体饰品。
没有 Steam 历史数据的有效请求饰品返回 not_in_archive；如果每个有效饰品都没有，则端点返回 404 not_found。

完整结构：ArchiveSteamItem、ArchiveSteamBucket。

错误#

404 not_found 表示请求中的有效常规饰品均没有 Steam 归档数据。部分结果返回 200 和 errors[]；变体请求使用 unsupported_variant。见部分成功和请求错误。