# 数据覆盖范围

高频 CS2 价格历史、变体饰品、总供应量、成交量、来源字段、新鲜度和历史覆盖范围。

本页介绍 cs2.sh API 端点提供的所有数据、刷新频率和历史覆盖范围。

## 市场与数据

cs2.sh 支持来自 BUFF、Youpin、CSFloat、Skinport、Steam 和 C5Game 的价格。

`ask` 是当前最低的出售挂单价。`bid` 是当前最高的普通求购价。
`ask_volume` 和 `bid_volume` 是活跃挂单或求购订单的数量。

| 市场 | 当前数据 | 历史数据 | 附加数据 |
| --- | --- | --- | --- |
| BUFF | `ask`、`bid`、`ask_volume`、`bid_volume` | 通过 `prices/history` 提供 OHLC；自 2023 年起的归档买/卖价 | 通过 `market/buff/latest` 和 `market/buff/history` 提供磨损区间 |
| Youpin | `ask`、`bid`、`ask_volume`、`bid_volume` | 通过 `prices/history` 提供 OHLC；自 2023 年起的归档买/卖价 | 通过 `archive/youpin` 提供成交价历史 |
| CSFloat | `ask`、`bid`、`ask_volume` | 通过 `prices/history` 提供 OHLC；自 2022 年起的成交价与成交量历史 | 通过 `archive/csfloat` 提供成交价与成交量 |
| Skinport | `ask`、`ask_volume` | 通过 `prices/history` 提供 OHLC | `max_ask`、`mean_ask`、`median_ask`，以及滚动 24h/7d/30d/90d 成交统计 |
| Steam | `ask`、`bid`、`ask_volume`、`bid_volume` | 通过 `prices/history` 提供 OHLC；自 2013 年起的中位成交价与成交量历史 | 通过 `market/steam/latest` 和 `market/steam/history` 提供完整买/卖订单簿 |
| C5Game | `ask`、`bid`、`ask_volume` | 通过 `prices/history` 提供 OHLC；自 2023 年起的归档买/卖价 | - |
| 汇总 | `hourly_volume`、`total_supply` | 自 2023 年起来自 `archive/history` 的归档数据 | `archive/history` 提供历史近似成交量和饰品供应量 |

BUFF、Youpin、CSFloat、Skinport 和 C5Game 支持当前 Doppler 与 Gamma Doppler 价格。当前 Case Hardened 价格在 BUFF、Skinport 和 C5Game 上受支持。Youpin 归档还可以返回已映射的 Case Hardened 变体。

Steam 不支持*任何*变体，因为 Steam 社区市场不区分单独的相位与其基础饰品。

### 归档数据

cs2.sh 的归档端点提供几种不同类型的历史数据：

- `archive/history`：小时级和日级的买/卖价、`ask_volume`、`bid_volume`、近似成交量和饰品供应量。
- `archive/csfloat`：CSFloat 每日平均成交价和成交量。
- `archive/steam`：Steam 社区市场中位成交价和成交量。
- `archive/youpin`：Youpin 成交价。

## 刷新频率

| 端点 | 刷新频率 |
| --- | --- |
| `GET /v1/prices/latest` | 大多数价格约每 5 分钟更新一次，具体取决于市场 |
| `POST /v1/prices/latest` | 与 `GET /v1/prices/latest` 相同的数据 |
| `POST /v1/prices/history` | 使用与 `prices/latest` 相同的数据持续更新 |
| `GET /v1/liquidity/items` | 每日 |
| `GET /v1/market/buff/latest` | 每 10 分钟 |
| `POST /v1/market/buff/history` | 每 10 分钟 |
| `GET /v1/market/steam/latest` | 约每 3-10 分钟，具体取决于饰品流动性 |
| `POST /v1/market/steam/history` | 与 `GET /v1/market/steam/latest` 相同的数据 |
| `GET /v1/schema` | 在 Counter-Strike 2 游戏文件更新时自动更新 |

刷新频率是近似值，因此当市场有新数据/没有数据时，或取决于饰品流动性，个别饰品的更新频率可能更低或更高。

### 归档刷新频率

| 端点 | 刷新频率 |
| --- | --- |
| `POST /v1/archive/history` | 每天约 1-2 次 |
| `POST /v1/archive/csfloat` | 每天约 1-2 次 |
| `POST /v1/archive/steam` | 每天约 1-4 次 |
| `POST /v1/archive/youpin` | 每天约 1-2 次 |

### 变体刷新频率

变体价格的刷新频率通常与常规饰品价格略有不同。

| 市场 | 变体刷新频率 |
| --- | --- |
| BUFF | 约每 3-5 分钟 |
| Youpin | 约每 5-15 分钟 |
| CSFloat 卖价 | 约每 10-15 分钟 |
| CSFloat 买价 | 约每 10-15 分钟 |
| Skinport | 约每 5 分钟 |
| Steam | 不适用（不支持） |
| C5Game | 约每 5 分钟 |

BUFF 磨损与渐变区间（包括变体的区间）每 10 分钟更新一次。

## 历史覆盖范围

| 端点 | 历史覆盖范围 | 间隔 |
| --- | --- | --- |
| `POST /v1/prices/history` | 自 2025 年 12 月 24 日起 | `5m`、`30m`、`1h`、`1d` |
| `POST /v1/market/buff/history` | 自 2026 年 5 月 19 日起 | `30m`、`1h`、`1d` |
| `POST /v1/market/steam/history` | 自 2026 年 6 月 9 日起 | `1h`、`1d` |
| `POST /v1/archive/history` | 自 2023 年起 | `1h`、`1d` |
| `POST /v1/archive/csfloat` | 自 2022 年起 | `1d` |
| `POST /v1/archive/steam` | 日级自 2013 年 4 月 26 日起；小时级自 2026 年 5 月 9 日起 | `1h`、`1d` |
| `POST /v1/archive/youpin` | 12h 自 2025 年 11 月 12 日起；4h 自 2026 年 6 月 27 日起；1h 自 2026 年 7 月 20 日起 | `1h`、`4h`、`12h` |

连续历史端点有按间隔划分的请求限制。这决定了单次请求可查询的最大请求范围，不过你仍然可以组合多次请求。例如，如果你想获取 180 天的 30m `prices/history` 数据，由于最大请求范围是 90 天，你需要组合 2 次请求。

| 端点 | 间隔 | 最大请求范围 |
| --- | --- | --- |
| `prices/history` | `5m` | 14 天 |
| `prices/history` | `30m` | 90 天 |
| `prices/history` | `1h` | 365 天 |
| `prices/history` | `1d` | 不限 |
| `market/buff/history` | `30m` | 90 天 |
| `market/buff/history` | `1h` | 365 天 |
| `market/buff/history` | `1d` | 不限 |
| `market/steam/history` | `1h` | 90 天 |
| `market/steam/history` | `1d` | 不限 |

## 端点类型

cs2.sh 提供三种不同类型的价格数据端点：

- 快照
- 历史时间序列
- 归档

快照端点提供请求时刻可用的当前最新价格。每个市场价格对象都有独立的 `updated_at` 和 `collected_at`，方便你检查数据新鲜度。

`updated_at` 是市场最后一次更新价格的时间。`collected_at` 是 cs2.sh 采集它的时间。

历史时间序列端点通过*聚合*快照数据来构建价格历史。例如，`prices/history` 端点使用与 `prices/latest` 相同的数据，但按设定的间隔收集 OHLC（给定时间段内的开盘价、最高价、最低价和收盘价）。如果你请求 `prices/history` 的 1h 间隔，每个独立的分桶将包含该小时数据的 OHLC。这使 `prices/history` 能以 5m/30m/1h/1d 间隔提供持续增长的时间序列。

- `prices/history` 和 `market/buff/history` 是 OHLC 聚合。
- `market/steam/history` 是采样历史。每个分桶包含该间隔内采集到的最新一份完整 Steam 订单簿快照。如果你查询 1h 间隔，每个分桶将包含该小时内采集的最后一份订单簿。

归档端点专用于更长期的历史数据，最长可达 13 年。这些端点通常每天更新约 1-2 次，其中 `archive/steam` 更新更频繁。

归档数据的含义并不总是与快照数据相同。取决于端点，它可能代表挂单价格、成交价格、成交量、饰品供应量，或市场提供的样本。