POST /v1/market/buff/history

本页内容

访问
支持的间隔
请求
参数
响应字段
错误
响应

返回 BUFF 浮动与渐变区间的 OHLC 历史。数据自 2026 年 5 月 19 日起。

来自 GET /v1/market/buff/latest 的每个区间都拥有独立的时间序列，包括 Doppler 阶段与 Case Hardened 分层的逐变体区间。OHLC 同时计算 ask、avg_ask 与 bid；ask_volume 与 bid_volume 为最后观测值。由于此端点的数据同样体现在 v1/market/buff/latest 中，价格每 10 分钟更新一次。每次请求最多 100 个饰品。

访问#

需要 Scale 或 Enterprise API 密钥。

支持的间隔#

间隔	最大范围
`30m`	90 天
`1h`	365 天
`1d`	不限

bucket 为 UTC 对齐的间隔边界。open_time 与 close_time 是每个区间内首次与最后一次观测的时间戳。

请求#

POSTapi.cs2.sh/v1/market/buff/history

curl -X POST https://api.cs2.sh/v1/market/buff/history \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Accept-Encoding: gzip" --compressed \
  -H "Content-Type: application/json" \
  -d '{
  "items": [
    "★ Bayonet | Fade (Factory New)",
    "AK-47 | Case Hardened (Field-Tested)"
  ],
  "start": "2026-05-12",
  "end": "2026-05-19",
  "interval": "1h"
}'

参数#

字段	类型	必需	描述
`items`	`string[]`	是	`market_hash_name` 值列表（最多 100 个）
`start`	`string`	是	开始日期/时间（YYYY-MM-DD 或 RFC3339）
`end`	`string`	否	结束日期/时间（YYYY-MM-DD 或 RFC3339）。默认现在。
`interval`	`string`	否	默认：`30m`。允许：`30m`、`1h`、`1d`。

响应字段#

每件饰品在 buckets[] 中包含其区间；每个条目携带区间标识（bucket_id、bucket_type、float/fade，与 GET /v1/market/buff/latest 一致）以及一个 OHLC 数据点的 data[] 数组。每个数据点携带 ask、avg_ask 和 bid 的 OHLC、最后观测的 ask_volume/bid_volume，以及真实观测窗口（open_time/close_time）。

返回的区间上都存在 bucket_id、bucket_type 和 data。
float 出现在 float 和 float_fade 区间上。
fade 出现在 fade 和 float_fade 区间上。
历史数据点上都存在 bucket、updated_at、collected_at、open_time 和 close_time。完整结构：BUFFMarketFloatHistoryItem、BUFFMarketFloatHistoryBucket、BUFFMarketFloatHistoryPoint。

错误#

状态	触发条件
`400 validation_error`	请求体或查询参数未通过校验（例如 JSON 格式错误、缺少 `items`/`start`、超过 100 个饰品，或 `interval` 或日期区间无效）。
`401` / `403`	缺少密钥、密钥无效或套餐无权访问。
`429`	触发限流。
`5xx`	服务端问题。

当部分饰品可解析而其他无法解析时，请求仍返回 200，包含已解析的饰品以及一个 errors[] 数组––每个条目都是 ItemError，其 code 为 unknown_item、invalid_format 或 not_in_cache。

响应#

json

{
  "response_time": "2026-05-19T18:42:11.014Z",
  "currency": "USD",
  "start": "2026-05-12T00:00:00Z",
  "end": "2026-05-19T00:00:00Z",
  "interval": "1h",
  "items": {
    "★ Bayonet | Fade (Factory New)": {
      "market_hash_name": "★ Bayonet | Fade (Factory New)",
      "buckets": [
        {
          "bucket_id": "fade:99:100",
          "bucket_type": "fade",
          "fade": {
            "min": 99,
            "max": 100
          },
          "data": [
            {
              "bucket": "2026-05-19T18:00:00Z",
              "updated_at": "2026-05-19T18:36:34Z",
              "collected_at": "2026-05-19T18:40:53.334Z",
              "open_ask": 472.06,
              "high_ask": 484.41,
              "low_ask": 471.32,
              "close_ask": 477.65,
              "open_avg_ask": 528.72,
              "high_avg_ask": 533.04,
              "low_avg_ask": 525.18,
              "close_avg_ask": 531.09,
              "open_bid": 369.85,
              "high_bid": 377.94,
              "low_bid": 369.85,
              "close_bid": 377.94,
              "ask_volume": 27,
              "bid_volume": 7,
              "open_time": "2026-05-19T18:01:12Z",
              "close_time": "2026-05-19T18:56:18Z"
            }
          ]
        }
      ]
    }
  }
}

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