POST /v1/archive/steam

本页内容

访问
支持的间隔
请求
参数
响应字段
错误
响应

返回 Steam 社区市场成交中位价与成交量历史。

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

这与 Steam 在任意社区市场饰品页面的价格走势图中所展示的数据相同。每次请求最多 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": [
    "AK-47 | Redline (Field-Tested)"
  ],
  "start": "2025-01-01",
  "end": "2025-02-01",
  "interval": "1d"
}'

参数#

字段	类型	必需	描述
`items`	`string[]`	是	常规 `market_hash_name` 值列表（最多 100 个）。不支持变体。
`start`	`string`	是	开始日期/时间（YYYY-MM-DD 或 RFC3339），包含。
`end`	`string`	否	结束日期/时间（YYYY-MM-DD 或 RFC3339），不含。默认现在。
`interval`	`string`	是	允许：`1h`、`1d`。原生 Steam 分桶间隔。无公开最大日期范围。

响应字段#

每件饰品包含 count 以及一个分桶的 data[] 数组。每个分桶携带其 bucket 边界、price（Steam 的成交中位价）和 volume（购买数量）。

每个分桶上都存在 bucket。
不支持变体饰品。
没有 Steam 历史数据的有效请求饰品返回 not_in_archive；如果每个有效饰品都没有，则端点返回 404 not_found。

完整结构：ArchiveSteamItem、ArchiveSteamBucket。

错误#

状态	触发条件
`400 validation_error`	请求体或查询未通过校验（例如 JSON 格式错误、缺少 `items`/`start`、超过 100 个饰品，或 `interval` 或日期区间错误）。
`401` / `403`	缺少密钥、密钥无效或套餐无权访问。
`404 not_found`	每个合法常规饰品都没有 Steam 归档行。
`429`	触发限流。
`5xx`	服务端问题。

当部分饰品可解析而其他无法解析时，请求仍返回 200，包含已解析的饰品以及 errors[] 数组。变体请求使用 unsupported_variant。

响应#

json

{
  "response_time": "2026-06-14T12:00:00Z",
  "currency": "USD",
  "start": "2025-01-01T00:00:00Z",
  "end": "2025-02-01T00:00:00Z",
  "interval": "1d",
  "items": {
    "AK-47 | Redline (Field-Tested)": {
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "count": 1,
      "data": [
        {
          "bucket": "2025-01-01T00:00:00Z",
          "price": 39.12,
          "volume": 54
        }
      ]
    }
  }
}

返回 ArchiveSteamResponse 对象。完整结构见对象。