POST /v1/market/steam/history

本页内容

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

返回随时间变化的 Steam 全深度订单簿快照，结构与 GET /v1/market/steam/latest 相同。数据始于 2026 年 6 月 9 日，每次请求最多 100 个饰品。

每个分桶包含该间隔内采集的最后一份完整订单簿。这是采样历史，不是 OHLC。

访问#

需要 Scale 或 Enterprise API 密钥。

支持的间隔#

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

请求#

POSTapi.cs2.sh/v1/market/steam/history

curl -X POST https://api.cs2.sh/v1/market/steam/history \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Accept-Encoding: gzip" --compressed \
  -H "Content-Type: application/json" \
  -d '{
  "items": [
    "USP-S | Printstream (Factory New)"
  ],
  "start": "2026-07-20",
  "end": "2026-07-23",
  "interval": "1h"
}'

参数#

字段	类型	必需	描述
`items`	`string[]`	是	常规 `market_hash_name` 值列表（最多 100 个）。不支持变体。
`start`	`string`	是	开始日期/时间（YYYY-MM-DD 或 RFC3339），包含。
`end`	`string`	否	结束日期/时间（YYYY-MM-DD 或 RFC3339），不含。默认现在。
`interval`	`string`	是	允许值: `1h`, `1d`. 分桶间隔。`1h` 最多 90 天；`1d` 不限。

响应#

{
  "response_time": "2026-07-26T18:54:23.061441059Z",
  "currency": "USD",
  "start": "2026-07-20T00:00:00Z",
  "end": "2026-07-23T00:00:00Z",
  "interval": "1h",
  "items": {
    "USP-S | Printstream (Factory New)": {
      "count": 72,
      "data": [
        {
          "bucket": "2026-07-20T00:00:00Z",
          "updated_at": "2026-07-20T00:54:22.006Z",
          "collected_at": "2026-07-20T00:55:13.298Z",
          "top": {
            "ask": 161.62,
            "ask_volume": 69,
            "bid": 155.43,
            "bid_volume": 2940
          },
          "depth": {
            "ask_levels": 1,
            "bid_levels": 1,
            "asks": {
              "prices": [
                161.62
              ],
              "volumes": [
                1
              ]
            },
            "bids": {
              "prices": [
                155.43
              ],
              "volumes": [
                1
              ]
            }
          }
        }
      ]
    }
  }
}

响应字段#

SteamOrderbookHistoryResponse 字段:

字段	类型	必需	描述
`response_time`	`string (date-time)`	是	响应生成时间。
`currency`	`string`	是	货币代码（始终为 `USD`）。
`start`	`string (date-time)`	是	规范化 UTC 起点，包含。
`end`	`string (date-time)`	是	规范化 UTC 终点，不含。
`interval`	`string`	是	允许值: `1h`, `1d`. 请求的分桶间隔。
`items`	`Record<string, SteamOrderbookHistoryItem>`	是	`market_hash_name` 到返回订单簿历史的映射。
`errors`	ItemError[]	否	部分成功响应中按饰品的错误列表。

采样分桶#

字段	描述
`items.<name>.count`	有数据的分桶数。
`items.<name>.data[]`	订单簿快照：每个 `bucket` 内最新的全深度观测。
`data[].bucket`	UTC 间隔边界。
`data[].top`	最优买/卖价以及 Steam 卖/买挂单总数。
`data[].depth`	完整的列式买卖档位，结构与 `GET /v1/market/steam/latest` 相同。
`data[].updated_at`、`collected_at`	Steam 的更新时间与 cs2.sh 的抓取时间。

不包含变体饰品。
在该区间内无分桶的有效请求饰品会从 items 中省略。

完整结构：SteamOrderbookHistoryItem、SteamOrderbookHistoryPoint、SteamOrderbookTop、SteamOrderbookDepth、SteamOrderbookDepthSide。

错误#

如果只有部分饰品名称失败，端点仍返回 200，其中包含成功的序列和 errors[]。变体请求使用 unsupported_variant；请求范围内没有分桶的有效常规饰品会从 items 中省略。见部分成功和请求错误。