GET /v1/market/buff/latest

本页内容

GET /v1/market/buff/latest
访问
区间类型
区间边界
价格与成交量
请求
响应
响应字段
区间数据
错误

返回每件饰品当前的 BUFF 价格，并按磨损区间、渐变区间以及两者组合的区间拆分。数据每 10 分钟更新一次。

使用 bucket_id 在此快照和 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，详见使用 API。每个变体在 buckets[] 中拥有自己的区间。

区间边界#

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

磨损区间会随饰品、外观和磨损上限而变化。渐变区间使用渐变百分比，而不是磨损值。请始终使用响应中返回的 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

响应#

{
  "response_time": "2026-08-23T22:00:06.665088573Z",
  "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-08-23T21:46:14Z",
          "collected_at": "2026-08-23T21:50:54.847Z",
          "ask": 216.49,
          "avg_ask": 217.84,
          "bid": 202.35,
          "ask_volume": 985,
          "bid_volume": 22
        },
        {
          "bucket_id": "float:0.15:0.18",
          "bucket_type": "float",
          "float": {
            "min": 0.15,
            "max": 0.18
          },
          "updated_at": "2026-08-23T21:46:14Z",
          "collected_at": "2026-08-23T21:50:54.847Z",
          "ask": 216.93,
          "avg_ask": 225.31,
          "bid": 202.35,
          "ask_volume": 219,
          "bid_volume": 7
        }
      ]
    },
    "★ 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-08-23T21:46:30Z",
              "collected_at": "2026-08-23T21:50:54.847Z",
              "ask": 1217.82,
              "avg_ask": 1249.35,
              "bid": 1167.98,
              "ask_volume": 280,
              "bid_volume": 15
            },
            {
              "bucket_id": "variant:p2|float:0.00:0.01",
              "bucket_type": "float",
              "float": {
                "min": 0,
                "max": 0.01
              },
              "updated_at": "2026-08-23T21:46:30Z",
              "collected_at": "2026-08-23T21:50:54.847Z",
              "ask": 1294.3,
              "avg_ask": 1334.61,
              "bid": 1178.4,
              "ask_volume": 61,
              "bid_volume": 19
            }
          ]
        }
      }
    }
  }
}

响应字段#

BUFFMarketFloatLatestResponse 字段:

字段	类型	必需	描述
`response_time`	`string (date-time)`	是	响应生成时间。
`currency`	`string`	是	货币代码（始终为 `USD`）。
`items`	`Record<string, BUFFMarketFloatItem>`	是	`market_hash_name` 到逐饰品 BUFF 数据的映射。

区间数据#

字段	描述
`items.<name>.buckets[]`	该饰品的价格区间：`base`、`float`、`fade` 和 `float_fade` 分桶。
`buckets[].bucket_id`、`bucket_type`	区间标识，在 latest 与 history 之间保持稳定。
`buckets[].float`	磨损区间边界。出现在 `float` 和 `float_fade` 区间上。
`buckets[].fade`	渐变区间边界。出现在 `fade` 和 `float_fade` 区间上。
`buckets[].ask`、`avg_ask`、`bid`、`ask_volume`、`bid_volume`	该区间内的价格和成交量，附带 `updated_at` 和 `collected_at`。
`items.<name>.variants`	逐变体的相同结构区间。

完整结构：BUFFMarketFloatItem、BUFFMarketFloatLatestBucket、BUFFMarketFloatRange、BUFFMarketFloatVariant。

错误#

503 service_unavailable 表示 BUFF 区间快照尚未就绪。共有错误见请求错误。