# POST /v1/market/steam/history

随时间变化的 Steam 全深度订单簿快照。

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

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

## 访问

需要 Scale 或 Enterprise API 密钥。

## 支持的间隔

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

## 请求

`POST https://api.cs2.sh/v1/market/steam/history`

**curl**

```bash
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"
}'
```

**Python**

```python
import requests

headers = {
    "Authorization": "Bearer <<YOUR_API_KEY>>",
    "Accept-Encoding": "gzip",
    "Content-Type": "application/json",
}

payload = {
    "items": ["USP-S | Printstream (Factory New)"],
    "start": "2026-07-20",
    "end": "2026-07-23",
    "interval": "1h",
}

response = requests.post(
    "https://api.cs2.sh/v1/market/steam/history",
    headers=headers,
    json=payload,
)

response.raise_for_status()
data = response.json()
```

**Node**

```javascript
const headers = {
  "Authorization": "Bearer <<YOUR_API_KEY>>",
  "Accept-Encoding": "gzip",
  "Content-Type": "application/json",
};

const response = await fetch("https://api.cs2.sh/v1/market/steam/history", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "items": [
      "USP-S | Printstream (Factory New)"
    ],
    "start": "2026-07-20",
    "end": "2026-07-23",
    "interval": "1h"
  }),
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
```

**Go**

```go
package main

import (
    "bytes"
    "compress/gzip"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    payload := map[string]any{
        "items": []any{
            "USP-S | Printstream (Factory New)",
        },
        "start": "2026-07-20",
        "end": "2026-07-23",
        "interval": "1h",
    }
    body, _ := json.Marshal(payload)
    req, _ := http.NewRequest("POST", "https://api.cs2.sh/v1/market/steam/history", bytes.NewReader(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer <<YOUR_API_KEY>>")
    req.Header.Set("Accept-Encoding", "gzip")

    resp, err := http.DefaultClient.Do(req)
    if err != nil { panic(err) }
    defer resp.Body.Close()

    if resp.StatusCode < 200 || resp.StatusCode >= 300 {
        body, _ := io.ReadAll(resp.Body)
        panic(fmt.Sprintf("HTTP %d: %s", resp.StatusCode, body))
    }

    var reader io.Reader = resp.Body
    if resp.Header.Get("Content-Encoding") == "gzip" {
        gz, err := gzip.NewReader(resp.Body)
        if err != nil { panic(err) }
        defer gz.Close()
        reader = gz
    }

    var data any
    if err := json.NewDecoder(reader).Decode(&data); err != nil { panic(err) }
    fmt.Printf("%#v\n", data)
}
```

**R**

```r
library(httr2)

payload <- list(
  items = list(
    "USP-S | Printstream (Factory New)"
  ),
  start = "2026-07-20",
  end = "2026-07-23",
  interval = "1h"
)

resp <- request("https://api.cs2.sh/v1/market/steam/history") |>
  req_headers(
    Authorization = "Bearer <<YOUR_API_KEY>>",
    `Accept-Encoding` = "gzip"
  ) |>
  req_body_json(payload) |>
  req_perform()

data <- resp_body_json(resp)
```

## 参数

| 字段 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `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` 不限。 |

## 响应

```json
{
  "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](/zh-cn/docs/objects#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>`](/zh-cn/docs/objects#steamorderbookhistoryitem) | 是 | `market_hash_name` 到返回订单簿历史的映射。 |
| `errors` | [ItemError[]](/zh-cn/docs/objects#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](/zh-cn/docs/objects#steamorderbookhistoryitem)、[SteamOrderbookHistoryPoint](/zh-cn/docs/objects#steamorderbookhistorypoint)、[SteamOrderbookTop](/zh-cn/docs/objects#steamorderbooktop)、[SteamOrderbookDepth](/zh-cn/docs/objects#steamorderbookdepth)、[SteamOrderbookDepthSide](/zh-cn/docs/objects#steamorderbookdepthside)。

### SteamOrderbookHistoryItem

单个常规饰品的 Steam 订单簿分桶快照。不返回变体。

| 字段 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `count` | `integer` | 是 | `data` 中的数据点数量。 |
| `data` | [SteamOrderbookHistoryPoint[]](/zh-cn/docs/objects#steamorderbookhistorypoint) | 是 | 按 `bucket` 升序排列的数据点。 |

### SteamOrderbookHistoryPoint

一个分桶内最新的全深度 Steam 订单簿快照。这不是 OHLC 数据。

| 字段 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `bucket` | `string (date-time)` | 是 | UTC 分桶开始时间。 |
| `updated_at` | `string (date-time)` | 是 | Steam 最后更新该分桶所代表订单簿的时间。 |
| `collected_at` | `string (date-time)` | 是 | cs2.sh 采集该分桶所代表订单簿的时间。 |
| `top` | [SteamOrderbookTop](/zh-cn/docs/objects#steamorderbooktop) | 是 | Steam 订单簿的最优卖单/买单（盘口顶部）。某一侧缺失时对应字段为 `null`。 |
| `depth` | [SteamOrderbookDepth](/zh-cn/docs/objects#steamorderbookdepth) | 是 | 列式表示的全深度 Steam 订单簿档位。 |

### SteamOrderbookTop

Steam 订单簿的最优卖单/买单（盘口顶部）。某一侧缺失时对应字段为 `null`。

| 字段 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `ask` | `number \| null` | 是 | 最优卖单 USD 价格；缺失时为 `null`。 |
| `ask_volume` | `integer \| null` | 是 | Steam 卖单总数量；缺失时为 `null`。 |
| `bid` | `number \| null` | 是 | 最优买单 USD 价格；缺失时为 `null`。 |
| `bid_volume` | `integer \| null` | 是 | Steam 买单总数量；缺失时为 `null`。 |

### SteamOrderbookDepth

列式表示的全深度 Steam 订单簿档位。

| 字段 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `ask_levels` | `integer` | 是 | `asks` 中的卖单档位数量。 |
| `bid_levels` | `integer` | 是 | `bids` 中的买单档位数量。 |
| `asks` | [SteamOrderbookDepthSide](/zh-cn/docs/objects#steamorderbookdepthside) | 是 | 订单簿某一侧的列式深度。`prices[i]` 与 `volumes[i]` 一一对应；每个 `volume` 是该价格上的数量，不是累计数量。 |
| `bids` | [SteamOrderbookDepthSide](/zh-cn/docs/objects#steamorderbookdepthside) | 是 | 订单簿某一侧的列式深度。`prices[i]` 与 `volumes[i]` 一一对应；每个 `volume` 是该价格上的数量，不是累计数量。 |

### SteamOrderbookDepthSide

订单簿某一侧的列式深度。`prices[i]` 与 `volumes[i]` 一一对应；每个 `volume` 是该价格上的数量，不是累计数量。

| 字段 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `prices` | `number[]` | 是 | USD 十进制价格。卖单升序，买单降序。 |
| `volumes` | `integer[]` | 是 | 每个对应价格上的数量。 |

## 错误

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