数据覆盖范围
本页介绍 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 更新更频繁。
归档数据的含义并不总是与快照数据相同。取决于端点，它可能代表挂单价格、成交价格、成交量、饰品供应量，或市场提供的样本。