快速开始

发起你的第一批 cs2.sh API 请求。本指南会获取饰品 schema、下载完整的最新价格快照，并介绍 BUFF 和 Steam 的专属快照。

获取 API 密钥#

所有 /v1 端点都需要 API 密钥。

订阅套餐后，你可以在仪表盘中查看你的密钥。如果想先试用 API，请注册并在我们的 Discord 服务器开一个工单，获取免费的 2 天 Developer 密钥。

公开 API 基础 URL 为：

https://api.cs2.sh

每个 /v1 请求都需要以下请求头：

请把 API 密钥保存在你的后端。不要在浏览器或客户端代码中暴露它。

获取饰品 schema#

GET /v1/schema 返回完整的 Counter-Strike 2 饰品 schema。

curl https://api.cs2.sh/v1/schema \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Accept-Encoding: gzip" --compressed

该 schema 包含约 47,500 件以 market_hash_name 为键的饰品，其中包括：

• 饰品类别和图片
• 稀有度和收藏品
• 外观和磨损区间
• 市场 id
• Doppler 变体

schema 与最新价格快照使用相同的键：

schema.items["USP-S | Printstream (Factory New)"]
prices.items["USP-S | Printstream (Factory New)"]

这样你就可以用 schema 获取饰品元数据，用 /v1/prices/latest 获取当前市场价格，而无需维护自己的饰品名称映射。

schema 会在 Counter-Strike 2 游戏文件更新时自动更新。

关于所有可用的饰品元数据，见 GET /v1/schema。

获取全部最新价格#

GET /v1/prices/latest 返回每一件已收录饰品在每个受支持市场上的当前价格。

curl https://api.cs2.sh/v1/prices/latest \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Accept-Encoding: gzip" --compressed

响应包含一个以 market_hash_name 为键的 items 对象。每件饰品对每个有可用数据的市场包含一个对象。

截断后的响应如下所示：

{
  "response_time": "2026-08-23T21:59:56.831728619Z",
  "currency": "USD",
  "items": {
    "USP-S | Printstream (Factory New)": {
      "market_hash_name": "USP-S | Printstream (Factory New)",
      "buff": {
        "updated_at": "2026-08-23T21:56:49Z",
        "collected_at": "2026-08-23T21:59:10.862Z",
        "ask": 101.95,
        "ask_volume": 491,
        "bid": 97.46,
        "bid_volume": 50
      },
      "csfloat": {
        "updated_at": "2026-08-23T21:59:27.65Z",
        "collected_at": "2026-08-23T21:59:27.697Z",
        "ask": 95,
        "ask_volume": 241,
        "bid": 92.6
      }
    }
  }
}

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

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

所有价格默认以 USD 返回；其他货币见货币。

此端点返回每一件已收录的饰品，因此响应可能很大。当你需要反复查询价格时，请从后端下载并缓存它。

关于每个市场的字段和完整的响应 schema，见 GET /v1/prices/latest。

市场专属快照#

通用的最新价格快照包含各市场当前的最优价格和数量。专属端点提供额外的市场特定数据。

BUFF 磨损与渐变区间#

GET /v1/market/buff/latest 返回按磨损区间拆分的 BUFF 价格。

curl https://api.cs2.sh/v1/market/buff/latest \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Accept-Encoding: gzip" --compressed

每个区间都有自己的 ask、bid、挂单数量和求购订单数量。Doppler 和 Case Hardened 变体可以拥有自己的区间。

关于可用的区间类型和响应字段，见 GET /v1/market/buff/latest。

Steam 订单簿#

GET /v1/market/steam/latest 返回每一件已收录常规饰品的最新完整 Steam 买/卖订单簿。

curl https://api.cs2.sh/v1/market/steam/latest \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Accept-Encoding: gzip" --compressed

响应包含最优买价和卖价，以及完整的订单簿深度。卖价按从低到高排序，买价按从高到低排序。

该快照约 100 MB。请从后端下载并缓存它，而不是为单个饰品查询而请求它。

Steam 不区分单独的 Doppler 或 Case Hardened 变体，因此不包含变体。

关于完整的订单簿格式，见 GET /v1/market/steam/latest。

获取指定饰品#

如果你只需要一组已知饰品的当前价格，请改用 POST /v1/prices/latest。它接受最多 100 个 market_hash_name 值，并为这些饰品返回相同的市场价格对象。

下一步#

• 阅读数据覆盖范围，了解支持的市场、可用字段、刷新频率、变体和历史覆盖范围。
• 阅读使用 API，了解共享的请求约定、时间戳、缺失数据、部分成功、错误和限制。
• 使用交互式 API 演示，无需编写代码即可查看响应。