# BUFF163 Counter-Strike 2 价格 API

BUFF163 CS2 价格 API：实时买卖价与求购订单（美元计价）、磨损与渐变区间、Doppler 变体，以及 3 年以上的 BUFF 价格历史。

cs2.sh 的 BUFF163 API 返回每件 CS2 饰品的实时 BUFF 价格：在 `/v1/prices/latest` 上提供 `ask`、`ask_volume`、`bid` 与 `bid_volume`，每隔几分钟采集一次，并从 CNY 标准化为 USD。不需要中国账号、BUFF 会话、代理或汇率换算。

Doppler、Gamma Doppler 与 Case Hardened 变体单独定价，带有各自的买卖价，约每 3-5 分钟刷新一次。BUFF 是唯一提供磨损区间与渐变区间的交易平台；cs2.sh 在 `/v1/market/buff/latest` 上按饰品并按变体返回这些数据，每 10 分钟更新一次。

`/v1/prices/history` 为每件 BUFF 饰品返回持续更新的 OHLC K 线，粒度为 `5m`/`30m`/`1h`/`1d`。`/v1/archive/history` 涵盖可回溯至 2023 年的每日与每小时 BUFF 价格、存世量与成交量，是市面上最深的 BUFF 价格历史之一；`/v1/market/buff/history` 则自 2026 年 5 月 19 日起记录磨损区间与渐变区间随时间的变化。

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

关于 BUFF163：buff.163.com 是由网易在中国运营的 C2C CS2 交易平台，按成交量计排名第二，也是市场上大多数饰品定价所参照的基准。它同时是最难采集的来源：会话会被作废，IP 会被封禁，且唯一的官方 API 每月收费 $150，仅向中国账号开放。

更新于 2026-08-21

## 字段

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

## 端点

|  |  |
| --- | --- |
| [`/v1/prices/latest`](https://cs2.sh/docs/prices-latest) | 实时 BUFF 买卖价、求购订单与数量（USD），约每 5 分钟刷新 |
| [`/v1/prices/history`](https://cs2.sh/docs/prices-history) | 持续更新的 5m/30m/1h/1d OHLC K 线，自 2025 年 12 月 24 日起 |
| [`/v1/market/buff/latest`](https://cs2.sh/docs/market-buff-latest) | BUFF 磨损区间与渐变区间，按饰品并按变体 |
| [`/v1/market/buff/history`](https://cs2.sh/docs/market-buff-history) | BUFF 磨损与渐变区间的时间序列（30m/1h/1d），自 2026 年 5 月 19 日起 |
| [`/v1/archive/history`](https://cs2.sh/docs/archive-history) | 可回溯至 2023 年的每日/每小时 BUFF 价格、存世量与成交量 |

## 常见问题

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

cs2.sh 每隔几分钟采集一次每件饰品的 BUFF 在售价格、求购订单与数量，并从 CNY 标准化为 USD。Doppler、Gamma Doppler 与 Case Hardened 变体约每 3-5 分钟刷新一次，BUFF 磨损区间与渐变区间每 10 分钟更新一次。

### BUFF 价格历史能回溯多久？

cs2.sh 保有三类 BUFF 历史：自 2025 年 12 月 24 日起的 5m/30m/1h/1d OHLC K 线，可回溯至 2023 年的每日与每小时归档价格、存世量与成交量，以及自 2026 年 5 月 19 日起的磨损与渐变区间历史。合在一起是市面上最深的 BUFF 价格历史之一。

### BUFF API 是否覆盖 Doppler 与 Case Hardened 变体？

是。Doppler 相位、Gamma Doppler 与 Case Hardened 分层均单独定价，带有各自的买卖价，而不是压缩成一个数字。BUFF 也是唯一提供磨损区间与渐变区间的交易平台，cs2.sh 按饰品并按变体全部提供。
