cs2.sh

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-07-26"
}'

参数#

字段类型必需描述
itemsstring[]是market_hash_name 值列表（最多 100 个）
startstring否开始日期（YYYY-MM-DD 或 RFC3339）。默认 2020-01-01。
endstring否结束日期（YYYY-MM-DD 或 RFC3339）。默认现在。

响应#

{
  "response_time": "2026-07-26T18:54:19.632716841Z",
  "currency": "USD",
  "start": "2026-04-27T00:00:00Z",
  "end": "2026-07-25T00:00:00Z",
  "items": {
    "USP-S | Printstream (Factory New)": {
      "market_hash_name": "USP-S | Printstream (Factory New)",
      "count": 89,
      "data": [
        {
          "date": "2026-04-27",
          "price": 149.76,
          "volume": 8
        },
        {
          "date": "2026-04-28",
          "price": 189.81,
          "volume": 10
        }
      ]
    }
  }
}

响应字段#

ArchiveCSFloatResponse 字段:

字段类型必需描述
response_timestring (date-time)是响应生成时间。
currencystring是货币代码（始终为 USD）。
startstring (date-time)是查询范围的有效开始时间，向下取整到日边界。
endstring (date-time)是查询范围的有效结束时间，向上取整到日边界。不包含该时间。
itemsRecord<string, ArchiveCSFloatItem>是market_hash_name 到 CSFloat 成交时间序列的映射。
errorsItemError[]否与成功结果一起返回的逐饰品失败（部分成功）。

每日数据#

字段描述
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。见部分成功和请求错误。