cs2.sh

GET /v1/market/buff/latest

本页内容

返回所有饰品的当前 BUFF 买价/卖价，划分为浮动区间、渐变区间和变体区间。

此端点的价格每 10 分钟更新一次。

访问#

适用于所有套餐（Developer、Scale、Enterprise）。

BUFF 暴露哪些区间类型？#

每件饰品被划分为 base、float、fade 和 float_fade 分桶。

bucket_type含义
base对整件饰品或变体的聚合。
float浮动区间。float.min 与 float.max 描述该区间。
fade渐变百分比区间。fade.min 与 fade.max 描述该区间。
float_fade浮动区间与渐变区间的组合。

具备 Doppler 阶段或 Case Hardened 分层的饰品可包含 variants，详见响应格式。每个变体在 buckets[] 中拥有自己的区间。

浮动和渐变区间如何运作？#

边界 min 为闭区间，max 为开区间。bucket_id 在 latest 与 history 之间保持稳定。

浮动区间会随饰品、外观和浮动上限而变化。

下面是常见的浮动区间组合：

外观常见的 BUFF 浮动区间
Factory New0:0.01、0.01:0.02、0.02:0.03、0.03:0.04、0.04:0.07
Minimal Wear0.07:0.08、0.08:0.09、0.09:0.10、0.10:0.11、0.11:0.15
Field-Tested0.15:0.18、0.18:0.21、0.21:0.24、0.24:0.27、0.27:0.38
Well-Worn0.38:0.39、0.39:0.40、0.40:0.41、0.41:0.42、0.42:0.45
Battle-Scarred通常为 0.45:0.50、0.50:0.63、0.63:0.76、0.76:0.90、0.90:1

渐变区间使用渐变百分比，而非浮动值。渐变饰品可能有 fade 区间和组合的 float_fade 区间。

价格与成交量#

字段含义
ask区间内的最低挂单价，美元。
avg_ask区间内的平均挂单价，美元。
bid区间内的最高求购订单，美元。
ask_volume当前处于该区间的挂单数。
bid_volume该区间的活跃求购订单数。

请求#

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

响应字段#

每件饰品在 buckets[] 中包含其区间；变体嵌套在 variants 下。每个条目携带区间标识（bucket_id、bucket_type、float/fade）、价格和成交量字段，以及 updated_at/collected_at。

错误#

此端点返回完整快照。

状态触发条件
401 / 403缺少密钥、密钥无效或套餐无权访问。
429触发限流。
503 / 5xx快照不可用或服务端问题。

响应#

json
{
  "response_time": "2026-05-19T18:40:53.334Z",
  "currency": "USD",
  "items": {
    "AK-47 | Case Hardened (Field-Tested)": {
      "market_hash_name": "AK-47 | Case Hardened (Field-Tested)",
      "buckets": [
        {
          "bucket_id": "base",
          "bucket_type": "base",
          "updated_at": "2026-05-19T18:36:34Z",
          "collected_at": "2026-05-19T18:40:53.334Z",
          "ask": 205.2,
          "avg_ask": 209.69,
          "bid": 197.06,
          "ask_volume": 1033,
          "bid_volume": 22
        },
        {
          "bucket_id": "float:0.15:0.18",
          "bucket_type": "float",
          "float": {
            "min": 0.15,
            "max": 0.18
          },
          "updated_at": "2026-05-19T18:36:34Z",
          "collected_at": "2026-05-19T18:40:53.334Z",
          "ask": 220.44,
          "avg_ask": 229.78,
          "bid": 197.06,
          "ask_volume": 231,
          "bid_volume": 9
        }
      ]
    },
    "★ M9 Bayonet | Doppler (Factory New)": {
      "market_hash_name": "★ M9 Bayonet | Doppler (Factory New)",
      "variants": {
        "Phase 2": {
          "market_hash_name": "★ M9 Bayonet | Doppler (Factory New)",
          "name": "★ M9 Bayonet | Doppler (Factory New) | Phase 2",
          "display_name": "Phase 2",
          "version": "p2",
          "buckets": [
            {
              "bucket_id": "variant:p2",
              "bucket_type": "base",
              "updated_at": "2026-05-19T18:36:34Z",
              "collected_at": "2026-05-19T18:40:53.334Z",
              "ask": 1286.62,
              "avg_ask": 1313.06,
              "bid": 1239.71,
              "ask_volume": 296,
              "bid_volume": 23
            },
            {
              "bucket_id": "variant:p2|float:0.00:0.01",
              "bucket_type": "float",
              "float": {
                "min": 0,
                "max": 0.01
              },
              "updated_at": "2026-05-19T18:36:34Z",
              "collected_at": "2026-05-19T18:40:53.334Z",
              "ask": 1352.94,
              "avg_ask": 1402.72,
              "bid": 1239.71,
              "ask_volume": 68,
              "bid_volume": 27
            }
          ]
        }
      }
    }
  }
}

返回 BUFFMarketFloatLatestResponse 对象。完整结构见对象。