POST /v1/archive/csfloat

本页内容

POST /v1/archive/csfloat
访问
请求
参数
响应
响应字段
每日数据
错误

返回 CSFloat 的每日平均成交价格和成交量。数据始于 2022 年，每天约更新 1-2 次。

每次请求最多 100 个饰品。

访问#

需要 Scale 或 Enterprise API 密钥。

请求#

POSTapi.cs2.sh/v1/archive/csfloat

curl -X POST https://api.cs2.sh/v1/archive/csfloat \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Accept-Encoding: gzip" --compressed \
  -H "Content-Type: application/json" \
  -d '{
  "items": [
    "USP-S | Printstream (Factory New)"
  ],
  "start": "2024-01-01",
  "end": "2026-08-23",
  "currency": "USD"
}'

参数#

字段	类型	必需	描述
`items`	`string[]`	是	`market_hash_name` 值列表（最多 100 个）。
`start`	`string`	否	开始日期/时间（YYYY-MM-DD 或 RFC3339），包含。默认 2020-01-01。
`end`	`string`	否	结束日期/时间（YYYY-MM-DD 或 RFC3339），不含。默认现在。
`currency`	`string`	否	默认值: `USD`. 允许值: `AUD`, `CAD`, `CHF`, `CNY`, `EUR`, `GBP`, `JPY`, `NZD`, `SGD`, `USD`. 响应中所有价格使用的货币。

响应#

{
  "response_time": "2026-08-23T22:00:08.282900466Z",
  "currency": "USD",
  "start": "2026-05-25T00:00:00Z",
  "end": "2026-08-22T00:00:00Z",
  "items": {
    "USP-S | Printstream (Factory New)": {
      "market_hash_name": "USP-S | Printstream (Factory New)",
      "count": 89,
      "data": [
        {
          "date": "2026-05-25",
          "price": 132.03,
          "volume": 12
        },
        {
          "date": "2026-05-26",
          "price": 119.67,
          "volume": 10
        }
      ]
    }
  }
}

响应字段#

ArchiveCSFloatResponse 字段:

字段	类型	必需	描述
`response_time`	`string (date-time)`	是	响应生成时间。
`currency`	`string`	是	响应中所有价格的货币代码：即请求的 `currency`，默认为 `USD`。
`start`	`string (date-time)`	是	查询区间的有效起点，向下对齐到日边界。包含。
`end`	`string (date-time)`	是	查询区间的有效终点，向上对齐到日边界。不含。
`items`	`Record<string, ArchiveCSFloatItem>`	是	`market_hash_name` 到 CSFloat 成交时间序列的映射。
`errors`	ItemError[]	否	与成功结果一起返回的逐饰品失败（部分成功）。

每日数据#

字段	描述
`items.<name>.count`	每日聚合的数量。
`items.<name>.data[]`	每日聚合。
`data[].date`	日期，`YYYY-MM-DD`，UTC。
`data[].price`	当天所有成交价的算术平均值，美元。
`data[].volume`	当天的成交数量。
`items.<name>.variants`	每个变体的相同结构。

返回的每日聚合上都存在 date、price 和 volume。如果该日期有成交量但没有可用价格，price 可以是 null。
当该变体存在 CSFloat 归档数据时，变体出现在 variants 下。
没有 CSFloat 归档数据的有效请求饰品返回 not_in_archive。

完整结构：ArchiveCSFloatItem、ArchiveCSFloatBucket。

错误#

404 not_found 表示请求中的有效饰品均没有 CSFloat 归档数据。部分结果返回 200 和 errors[]；饰品错误代码包括 unknown_item、invalid_format 和 not_in_archive。见部分成功和请求错误。