# CSFloat Counter-Strike 2 价格 API

CSFloat CS2 价格 API：实时挂单、高频刷新的求购价、Doppler 变体，以及自 2022 年起的每日实际成交价格与成交量。

cs2.sh 的 CSFloat API 返回的数据比 CSFloat 自己的 API 更多：在 `/v1/prices/latest` 上提供每件 CS2 饰品的最低挂单价与最高求购价（`ask`、`bid`、`ask_volume`），挂单每隔几分钟采集一次。CSFloat 官方 API 仅提供挂单，没有任何成交记录。

Doppler、Gamma Doppler 与 Case Hardened 单独定价，约每 10-15 分钟刷新一次。求购价覆盖大多数饰品（包括 Doppler 变体），约每 10-30 分钟更新一次，具体取决于饰品的流动性；高流动性饰品刷新更频繁。cs2.sh 是唯一对 CSFloat 求购价和变体保持高刷新率的 API。

`/v1/prices/history` 为每件 CSFloat 饰品返回持续更新的 ask 与 bid OHLC K 线，粒度为 `5m`/`30m`/`1h`/`1d`。`/v1/archive/csfloat` 额外提供可回溯至 2022 年的每日成交价与成交量：真实成交数据，是饰品实际成交的价格，而非挂单价。

所有响应均为以规范 `market_hash_name` 为键的 JSON，每个价格都带有 `updated_at` 与 `collected_at` 时间戳。GET 一次返回整个市场，POST 返回指定饰品。同一个 API 密钥与同一套 schema 覆盖 BUFF、Youpin、Steam、Skinport 与 C5Game。

关于 CSFloat：csfloat.com 是最大的西方 CS2 交易平台，采用 C2C 模式，位于美国，以 USD 计价。其免费官方 API 仅提供挂单数据，没有成交记录。

更新于 2026-08-21

## 字段

|  |  |
| --- | --- |
| `ask` | 最低在售价格（USD） |
| `bid` | 最高求购单价格（USD） |
| `ask_volume` | 在售饰品数量 |

## 端点

|  |  |
| --- | --- |
| [`/v1/prices/latest`](https://cs2.sh/docs/prices-latest) | 实时 CSFloat 挂单与高频刷新的求购价，包括 Doppler 变体 |
| [`/v1/prices/history`](https://cs2.sh/docs/prices-history) | 持续更新的 ask/bid 5m/30m/1h/1d OHLC K 线，自 2025 年 12 月 24 日起 |
| [`/v1/archive/csfloat`](https://cs2.sh/docs/archive-csfloat) | 可回溯至 2022 年的每日 CSFloat 成交价与成交量，真实成交数据而非挂单 |

## 常见问题

### cs2.sh 多久更新一次 CSFloat 价格？

cs2.sh 每隔几分钟采集一次所有饰品的 CSFloat 在售价格与数量；Doppler 变体价格约每 10-15 分钟刷新一次。求购价通常约每 10-30 分钟更新一次，具体取决于饰品的流动性，高流动性饰品刷新更频繁。

### CSFloat 成交历史能回溯多久？

cs2.sh 的 CSFloat 归档提供可回溯至 2022 年（3 年以上）的每日成交价与成交量：真实成交数据，是饰品实际成交的价格，而非挂单价。CSFloat 自己的 API 完全没有成交记录。

### CSFloat API 是否包含求购订单？

是。cs2.sh 通过 `bid` 返回 CSFloat 的最高求购价。求购价覆盖大多数饰品，包括 Doppler 变体，通常约每 10-30 分钟更新一次，具体取决于饰品的流动性；高流动性饰品刷新更频繁。它不返回 CSFloat `bid_volume` 或完整求购订单簿。
