API 对象
本页内容
- API 对象
- 对象分组
- 响应封装
- LatestPricesGetResponse
- LatestPricesPostResponse
- HistoryResponse
- ItemLiquidityGetResponse
- BUFFMarketFloatLatestResponse
- BUFFMarketFloatHistoryResponse
- ArchiveBuffResponse
- ArchiveCSFloatResponse
- ArchiveHistoryResponse
- ArchiveSteamResponse
- ArchiveYoupinResponse
- CSFloatBuyOrdersLatestResponse
- CSFloatBuyOrdersHistoryResponse
- SteamOrderbookLatestResponse
- SteamOrderbookHistoryResponse
- SchemaResponse
- FXResponse
- 饰品对象
- Item
- Variant
- HistoryItem
- HistoryVariant
- ItemLiquidityItem
- ItemLiquidityVariant
- BUFFMarketFloatItem
- BUFFMarketFloatHistoryItem
- BUFFMarketFloatVariant
- BUFFMarketFloatHistoryVariant
- ArchiveBuffItem
- ArchiveBuffVariant
- ArchiveCSFloatItem
- ArchiveCSFloatVariant
- ArchiveHistoryItem
- ArchiveHistoryVariant
- ArchiveSteamItem
- ArchiveYoupinItem
- ArchiveYoupinVariant
- CSFloatBuyOrdersItem
- CSFloatBuyOrdersVariant
- CSFloatBuyOrdersHistoryItem
- CSFloatBuyOrdersHistoryVariant
- SteamOrderbookItem
- SteamOrderbookHistoryItem
- 历史分桶
- HistoryBucket
- BUFFMarketFloatLatestBucket
- BUFFMarketFloatHistoryBucket
- BUFFMarketFloatHistoryPoint
- BUFFMarketFloatRange
- ArchiveBuffPoint
- ArchiveCSFloatBucket
- ArchiveHistoryBucket
- ArchiveHistoryPlatformData
- ArchiveSteamBucket
- ArchiveYoupinSeries
- ArchiveYoupinPoint
- CSFloatBuyOrder
- CSFloatBuyOrderConditions
- CSFloatStickerCondition
- CSFloatKeychainCondition
- CSFloatBuyOrdersHistoryPoint
- SteamOrderbookTop
- SteamOrderbookDepth
- SteamOrderbookDepthSide
- SteamOrderbookHistoryPoint
- 最新价格来源数据
- BUFFSourceData
- YoupinSourceData
- CsfloatSourceData
- SkinportSourceData
- SteamSourceData
- C5GameSourceData
- SkinportPriceWindow
- OHLC 来源数据
- BUFFOHLCSourceData
- YoupinOHLCSourceData
- CsfloatOHLCSourceData
- SkinportOHLCSourceData
- SteamOHLCSourceData
- C5GameOHLCSourceData
- 饰品 Schema
- SchemaItem
- SchemaItemVariant
- SchemaCollection
- SchemaRarity
- 健康状态
- HealthResponse
- HealthEntry
- HealthStats
- 错误
- ItemError
- ErrorResponse
cs2.sh API 的响应对象字段参考。
对象分组
响应封装
LatestPricesGetResponse
全量饰品快照。由 GET /v1/prices/latest 返回，带有共享响应元数据。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
response_time | string (date-time) | 是 | 响应生成时间。 |
currency | string | 是 | 响应中所有价格的货币代码：即请求的 currency，默认为 USD。 |
items | Record<string, Item> | 是 | market_hash_name 到饰品价格数据的映射。 |
LatestPricesPostResponse
按饰品过滤的快照。由 POST /v1/prices/latest 返回，包含逐饰品 errors。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
response_time | string (date-time) | 是 | 响应生成时间。 |
currency | string | 是 | 响应中所有价格的货币代码：即请求的 currency，默认为 USD。 |
items | Record<string, Item> | 是 | market_hash_name 到饰品价格数据的映射，过滤到请求的饰品。 |
errors | ItemError[] | 否 | 与成功结果一起返回的逐饰品失败（部分成功）。 |
HistoryResponse
POST /v1/prices/history 的响应结构。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
response_time | string (date-time) | 是 | 响应生成时间。 |
currency | string | 是 | 响应中所有价格的货币代码：即请求的 currency，默认为 USD。 |
start | string (date-time) | 是 | 查询区间的有效起点，向下对齐到间隔边界。包含。 |
end | string (date-time) | 是 | 查询区间的有效终点，向上对齐到间隔边界。不含。 |
interval | string | 是 | 允许值: 5m, 30m, 1h, 1d. 请求的分桶间隔。 |
items | Record<string, HistoryItem> | 是 | market_hash_name 到 OHLC 时间序列的映射。 |
errors | ItemError[] | 否 | 与成功结果一起返回的逐饰品失败（部分成功）。 |
ItemLiquidityGetResponse
全量饰品流动性快照。由 GET /v1/liquidity/items 返回。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
response_time | string (date-time) | 是 | 快照计算时间。 |
run_date | string (date) | 是 | 每日计算对应的 UTC 日期。 |
items | Record<string, ItemLiquidityItem> | 是 | market_hash_name 到饰品流动性数据的映射。 |
BUFFMarketFloatLatestResponse
所有饰品的 BUFF 磨损与渐变范围快照。由 GET /v1/market/buff/latest 返回；所有价格均为 USD。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
response_time | string (date-time) | 是 | 响应生成时间。 |
currency | string | 是 | 响应中所有价格的货币代码：即请求的 currency，默认为 USD。 |
items | Record<string, BUFFMarketFloatItem> | 是 | market_hash_name 到逐饰品 BUFF 数据的映射。 |
BUFFMarketFloatHistoryResponse
由 POST /v1/market/buff/history 返回的响应。每个请求的 BUFF 市场磨损/渐变区间都会带有 OHLC 历史。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
response_time | string (date-time) | 是 | 响应生成时间。 |
currency | string | 是 | 响应中所有价格的货币代码：即请求的 currency，默认为 USD。 |
start | string (date-time) | 是 | 查询区间的有效起点，向下对齐到间隔边界。包含。 |
end | string (date-time) | 是 | 查询区间的有效终点，向上对齐到间隔边界。不含。 |
interval | string | 是 | 允许值: 30m, 1h, 1d. 请求的分桶间隔。 |
items | Record<string, BUFFMarketFloatHistoryItem> | 是 | market_hash_name 到逐饰品 BUFF 历史的映射。 |
errors | ItemError[] | 否 | 部分成功响应中按饰品的错误列表。 |
ArchiveBuffResponse
POST /v1/archive/buff 的响应结构。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
response_time | string (date-time) | 是 | 响应生成时间。 |
currency | string | 是 | sale_price 的货币单位：即请求的 currency，默认为 USD。 |
start | string (date-time) | 是 | 查询区间的有效起点，与请求或默认值完全一致。包含。 |
end | string (date-time) | 是 | 查询区间的有效终点，与请求或默认值完全一致。不含。 |
items | Record<string, ArchiveBuffItem> | 是 | market_hash_name 到 BUFF 成交序列的映射。 |
errors | ItemError[] | 否 | 与成功结果并存的按饰品失败（部分成功）。 |
ArchiveCSFloatResponse
POST /v1/archive/csfloat 的响应结构。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
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[] | 否 | 与成功结果一起返回的逐饰品失败（部分成功）。 |
ArchiveHistoryResponse
POST /v1/archive/history 的响应结构。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
response_time | string (date-time) | 是 | 响应生成时间。 |
currency | string | 是 | 响应中所有价格的货币代码：即请求的 currency，默认为 USD。 |
start | string (date-time) | 是 | 查询区间的有效起点，向下对齐到间隔边界。包含。 |
end | string (date-time) | 是 | 查询区间的有效终点，向上对齐到间隔边界。不含。 |
interval | string | 是 | 允许值: 1h, 1d. 请求的分桶间隔。 |
items | Record<string, ArchiveHistoryItem> | 是 | market_hash_name 到归档时间序列的映射。 |
errors | ItemError[] | 否 | 与成功结果一起返回的逐饰品失败（部分成功）。 |
ArchiveSteamResponse
POST /v1/archive/steam 的响应结构。合法常规饰品无数据时返回饰品级 not_in_archive；如果每个合法常规饰品均无数据，端点返回 404 not_found。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
response_time | string (date-time) | 是 | 响应生成时间。 |
currency | string | 是 | 响应中所有价格的货币代码：即请求的 currency，默认为 USD。 |
start | string (date-time) | 是 | 查询区间的有效起点，向下对齐到间隔边界。包含。 |
end | string (date-time) | 是 | 查询区间的有效终点，向上对齐到间隔边界。不含。 |
interval | string | 是 | 允许值: 1h, 1d. 请求的分桶间隔。 |
items | Record<string, ArchiveSteamItem> | 是 | market_hash_name 到原生 Steam 成交历史分桶的映射。 |
errors | ItemError[] | 否 | 部分成功响应中按饰品的错误列表。 |
ArchiveYoupinResponse
POST /v1/archive/youpin 的响应结构。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
response_time | string (date-time) | 是 | 响应生成时间。 |
currency | string | 是 | 响应中所有价格的货币代码：即请求的 currency，默认为 USD。 |
start | string (date-time) | 是 | 查询区间的有效起点，向下对齐到 1h 边界。包含。 |
end | string (date-time) | 是 | 查询区间的有效终点，向上对齐到 1h 边界。不含。 |
items | Record<string, ArchiveYoupinItem> | 是 | market_hash_name 到 Youpin 成交序列的映射。 |
errors | ItemError[] | 否 | 与成功结果并存的按饰品失败（部分成功）。 |
CSFloatBuyOrdersLatestResponse
所有有挂起求购订单的饰品当前的 CSFloat 求购订单簿。由 GET /v1/market/csfloat/latest 返回。订单簿在观测时间后 12 小时过期，与 /v1/prices/latest 上的 bid 使用相同窗口。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
response_time | string (date-time) | 是 | 生成此快照响应的时间。 |
currency | string | 是 | 响应中所有价格的货币代码：即请求的 currency，默认为 USD。 |
items | Record<string, CSFloatBuyOrdersItem> | 是 | 具有当前求购订单簿的饰品，以 market_hash_name 为键。 |
CSFloatBuyOrdersHistoryResponse
POST /v1/market/csfloat/history 的响应结构。没有数据行的有效请求饰品会在 errors 中报告。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
response_time | string (date-time) | 是 | 生成响应的时间。 |
currency | string | 是 | 响应中所有价格的货币代码：即请求的 currency，默认为 USD。 |
start | string (date-time) | 是 | 查询区间的有效起点，向下对齐到间隔边界。包含。 |
end | string (date-time) | 是 | 查询区间的有效终点，向上对齐到间隔边界。不含。 |
interval | string | 是 | 允许值: 1h, 1d. 请求的分桶间隔。 |
items | Record<string, CSFloatBuyOrdersHistoryItem> | 是 | market_hash_name 到所返回求购订单簿历史的映射。 |
errors | ItemError[] | 否 | 与成功结果一并返回的逐饰品错误（部分成功）。 |
SteamOrderbookLatestResponse
所有被追踪常规饰品的最新 Steam 订单簿快照。由 GET /v1/market/steam/latest 返回；不支持变体。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
response_time | string (date-time) | 是 | 此快照响应的生成时间。 |
currency | string | 是 | 响应中所有价格的货币代码：即请求的 currency，默认为 USD。 |
items | Record<string, SteamOrderbookItem> | 是 | 具有当前订单簿数据的常规饰品，按 market_hash_name 键控。 |
SteamOrderbookHistoryResponse
POST /v1/market/steam/history 的响应结构。有合法常规饰品但无数据时会从 items 中省略；如果所有合法常规饰品均无数据，则 items 为空。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
response_time | string (date-time) | 是 | 响应生成时间。 |
currency | string | 是 | 响应中所有价格的货币代码：即请求的 currency，默认为 USD。 |
start | string (date-time) | 是 | 查询区间的有效起点，向下对齐到间隔边界。包含。 |
end | string (date-time) | 是 | 查询区间的有效终点，向上对齐到间隔边界。不含。 |
interval | string | 是 | 允许值: 1h, 1d. 请求的分桶间隔。 |
items | Record<string, SteamOrderbookHistoryItem> | 是 | market_hash_name 到返回订单簿历史的映射。 |
errors | ItemError[] | 否 | 部分成功响应中按饰品的错误列表。 |
SchemaResponse
GET /v1/schema 的响应结构：按 market_hash_name 键控的完整饰品目录及其元数据。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
schema_version | string | 是 | 目录 schema 版本。变化时客户端应重新同步。 |
generation_id | string | 是 | 此 schema 代次的稳定标识符。 |
generated_at | string (date-time) | 是 | 此 schema 代次的构建时间。 |
counts | object | 是 | 目录实体计数。 |
rarities | SchemaRarity[] | 是 | 稀有度分层。 |
collections | Record<string, SchemaCollection> | 是 | 按收藏品名称键控的收藏品元数据。 |
items | Record<string, SchemaItem> | 是 | 按 market_hash_name 键控的饰品记录。 |
FXResponse
当前汇率。由 GET /v1/fx 返回。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
base | string | 是 | 基准货币（始终为 USD）。 |
updated_at | string (date-time) | 是 | 汇率提供方发布这些汇率的时间。 |
collected_at | string (date-time) | 是 | cs2.sh 采集这些汇率的时间。 |
fresh | boolean | 是 | 汇率超过 2 小时时为 false。最新价格换算在最长 24 小时内仍会继续使用这些汇率。 |
rates | Record<string, number> | 是 | 每 1 USD 可兑换的各货币数量，以货币代码为键。 |
饰品对象
Item
一个饰品在所有来源上的价格数据。除非 sources 将响应限制为所请求的来源，否则所有来源都会出现。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 规范化的 Steam market_hash_name。 |
buff | BUFFSourceData | 否 | 来自 BUFF 的价格数据。 |
youpin | YoupinSourceData | 否 | 来自 Youpin 的价格数据。 |
csfloat | CsfloatSourceData | 否 | 来自 CSFloat 的当前挂单与求购单价格。 |
skinport | SkinportSourceData | 否 | 来自 Skinport 的价格数据，包括 Skinport 提供的滚动历史窗口。 |
c5game | C5GameSourceData | 否 | 来自 C5Game 的价格数据。Ask 和 bid 来自独立采集流程，因此同一饰品的时间戳可能不同。 |
steam | SteamSourceData | 否 | 来自 Steam 社区市场的价格数据。 |
variants | Record<string, Variant> | 否 | 带有 Doppler 与 Gamma Doppler 相位或 Case Hardened 分层的饰品的逐变体价格数据。按显示名称作为键。 |
Variant
饰品的一个变体（Doppler 或 Gamma Doppler 相位或 Case Hardened 分层）。youpin 在每个 Doppler 与 Gamma Doppler 相位上提供 ask、bid 与 bid_volume，大多数饰品还提供 ask_volume。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 基础饰品的 market_hash_name。完整变体名称见 name。 |
name | string | 是 | 变体的完整 market_hash_name，例如 ★ Karambit | Doppler (Factory New) | Phase 1。 |
display_name | string | 是 | 人类可读的变体标签（例如 Phase 1、Ruby、Tier 1、Blue Gem）。 |
version | string | 是 | 允许值: p1, p2, p3, p4, ruby, sapphire, blackpearl, emerald, t1, t2, t3, t4, singleblue. 稳定变体代码。客户端代码应基于此切换。 |
buff | BUFFSourceData | 否 | 来自 BUFF 的价格数据。 |
youpin | YoupinSourceData | 否 | 来自 Youpin 的价格数据。 |
csfloat | CsfloatSourceData | 否 | 来自 CSFloat 的当前挂单与求购单价格。 |
skinport | SkinportSourceData | 否 | 来自 Skinport 的价格数据，包括 Skinport 提供的滚动历史窗口。 |
c5game | C5GameSourceData | 否 | 来自 C5Game 的价格数据。Ask 和 bid 来自独立采集流程，因此同一饰品的时间戳可能不同。 |
steam | SteamSourceData | 否 | 来自 Steam 社区市场的价格数据。 |
HistoryItem
单个饰品的 OHLC 时间序列。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 规范化的 Steam market_hash_name。 |
count | integer | 是 | data 中的分桶数量。 |
data | HistoryBucket[] | 是 | 按时间顺序排列的 OHLC 分桶。 |
variants | Record<string, HistoryVariant> | 否 | 带有 Doppler 与 Gamma Doppler 相位或 Case Hardened 分层的饰品的逐变体 OHLC 时间序列。按显示名称作为键。 |
HistoryVariant
一个 Doppler 或 Gamma Doppler 相位或 Case Hardened 分层的 OHLC 时间序列。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 基础饰品的 market_hash_name。完整变体名称见 name。 |
name | string | 是 | 变体的完整 market_hash_name，例如 ★ Karambit | Doppler (Factory New) | Phase 1。 |
display_name | string | 是 | 人类可读的变体标签（例如 Phase 1、Ruby、Tier 1、Blue Gem）。 |
version | string | 是 | 稳定变体代码。客户端代码应基于此切换。 |
count | integer | 是 | data 中的分桶数量。 |
data | HistoryBucket[] | 是 | 按时间顺序排列的 OHLC 分桶。 |
ItemLiquidityItem
单个饰品的流动性分档和预计售出时间。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 规范化的 Steam market_hash_name。 |
liquidity | string | 否 | 允许值: unknown, extremely_illiquid, very_illiquid, illiquid, moderate, liquid, very_liquid, extremely_liquid. 饰品流动性分档，每日重新计算。 |
estimated_sale_time | string | 否 | 允许值: under 1 hour, 1 - 2 hours, 2 - 6 hours, 6 - 12 hours, 12 - 24 hours, 1 - 2 days, 2 - 3 days, 3 - 4 days, 4 - 5 days, 5 - 7 days, 7 - 10 days, 10 - 14 days, 2 - 3 weeks, 3 - 4 weeks, 1 - 1.5 months, 1.5 - 2 months, 2+ months, unknown. 竞争性定价挂单售出的第 80 百分位预计等待时间。 |
variants | Record<string, ItemLiquidityVariant> | 否 | 按显示名称作为键的逐变体饰品流动性。 |
ItemLiquidityVariant
一个 Doppler 或 Gamma Doppler 相位或 Case Hardened 分层的流动性分档和预计售出时间。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 基础饰品的 market_hash_name。完整变体名称见 name。 |
name | string | 是 | 变体的完整 market_hash_name，例如 ★ Karambit | Doppler (Factory New) | Phase 1。 |
display_name | string | 是 | 人类可读的变体标签（例如 Phase 1、Ruby、Tier 1、Blue Gem）。 |
version | string | 是 | 稳定变体代码。客户端代码应基于此切换。 |
liquidity | string | 是 | 允许值: unknown, extremely_illiquid, very_illiquid, illiquid, moderate, liquid, very_liquid, extremely_liquid. 饰品流动性分档，每日重新计算。 |
estimated_sale_time | string | 是 | 允许值: under 1 hour, 1 - 2 hours, 2 - 6 hours, 6 - 12 hours, 12 - 24 hours, 1 - 2 days, 2 - 3 days, 3 - 4 days, 4 - 5 days, 5 - 7 days, 7 - 10 days, 10 - 14 days, 2 - 3 weeks, 3 - 4 weeks, 1 - 1.5 months, 1.5 - 2 months, 2+ months, unknown. 竞争性定价挂单售出的第 80 百分位预计等待时间。 |
BUFFMarketFloatItem
单件饰品的 BUFF 市场磨损/渐变数据。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 规范化的 Steam market_hash_name。 |
buckets | BUFFMarketFloatLatestBucket[] | 否 | 基础饰品挂单的最新 BUFF 区间。 |
variants | Record<string, BUFFMarketFloatVariant> | 否 | 带有 Doppler 与 Gamma Doppler 相位或 Case Hardened 分层的饰品的逐变体 BUFF 数据。按显示名称作为键（例如 Phase 1、Ruby、Tier 1）。 |
BUFFMarketFloatHistoryItem
单件饰品的 BUFF 市场磨损/渐变 OHLC 历史。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 规范化的 Steam market_hash_name。 |
buckets | BUFFMarketFloatHistoryBucket[] | 否 | 基础饰品挂单各区间的 OHLC 历史。 |
variants | Record<string, BUFFMarketFloatHistoryVariant> | 否 | 带有 Doppler 与 Gamma Doppler 相位或 Case Hardened 分层的饰品的逐变体 OHLC 历史。按显示名称作为键。 |
BUFFMarketFloatVariant
单个饰品变体（Doppler 或 Gamma Doppler 相位或 Case Hardened 分层）的 BUFF 最新数据。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 基础饰品的 market_hash_name。完整变体名称见 name。 |
name | string | 是 | 变体的完整 market_hash_name，例如 ★ Karambit | Doppler (Factory New) | Phase 1。 |
display_name | string | 是 | 人类可读的变体标签（例如 Phase 1、Ruby、Tier 1、Blue Gem）。 |
version | string | 是 | 稳定变体代码。客户端代码应基于此切换。 |
buckets | BUFFMarketFloatLatestBucket[] | 是 | 该变体的最新 BUFF 区间。 |
BUFFMarketFloatHistoryVariant
单个饰品变体的 BUFF OHLC 历史。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 基础饰品的 market_hash_name。完整变体名称见 name。 |
name | string | 是 | 变体的完整 market_hash_name，例如 ★ Karambit | Doppler (Factory New) | Phase 1。 |
display_name | string | 是 | 人类可读的变体标签（例如 Phase 1、Ruby、Tier 1、Blue Gem）。 |
version | string | 是 | 稳定变体代码。客户端代码应基于此切换。 |
buckets | BUFFMarketFloatHistoryBucket[] | 是 | 该变体每个区间的 OHLC 历史。 |
ArchiveBuffItem
单件饰品的 BUFF 成交与每日供应量，作为一条按时间顺序排列的序列。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 基础饰品的 market_hash_name。 |
count | integer | 是 | data 中的数据点数量。 |
data | ArchiveBuffPoint[] | 是 | 按时间顺序排列的成交和仅供应量数据点，每个时间戳一个点。 |
variants | Record<string, ArchiveBuffVariant> | 否 | 具有 Doppler、Gamma Doppler 相位或 Case Hardened 分层的饰品的逐变体 BUFF 序列。以显示名称为键，为空时省略。变体序列绝不会回退到基础饰品历史。 |
ArchiveBuffVariant
一个 Doppler 或 Gamma Doppler 相位或 Case Hardened 分层的 BUFF 成交与每日供应量。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 基础饰品的 market_hash_name。完整变体名称见 name。 |
count | integer | 是 | data 中的数据点数量。 |
data | ArchiveBuffPoint[] | 是 | 按时间顺序排列的成交和仅供应量数据点，每个时间戳一个点。 |
name | string | 是 | 变体的完整 market_hash_name，例如 ★ Karambit | Doppler (Factory New) | Phase 2。 |
display_name | string | 是 | 人类可读的变体标签（例如 Phase 1、Ruby、Tier 1、Blue Gem）。 |
version | string | 是 | 稳定变体代码。客户端代码应基于此切换。 |
ArchiveCSFloatItem
单个饰品的 CSFloat 成交时间序列。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 规范化的 Steam market_hash_name。 |
count | integer | 是 | data 中的天数。 |
data | ArchiveCSFloatBucket[] | 是 | 按时间顺序排列的每日成交聚合。 |
variants | Record<string, ArchiveCSFloatVariant> | 否 | 带有 Doppler 与 Gamma Doppler 相位或 Case Hardened 分层的饰品的逐变体 CSFloat 成交时间序列。按显示名称作为键。 |
ArchiveCSFloatVariant
一个 Doppler 或 Gamma Doppler 相位或 Case Hardened 分层的 CSFloat 成交时间序列。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 基础饰品的 market_hash_name。完整变体名称见 name。 |
name | string | 是 | 变体的完整 market_hash_name，例如 ★ Karambit | Doppler (Factory New) | Phase 1。 |
display_name | string | 是 | 人类可读的变体标签（例如 Phase 1、Ruby、Tier 1、Blue Gem）。 |
version | string | 是 | 稳定变体代码。客户端代码应基于此切换。 |
count | integer | 是 | data 中的天数。 |
data | ArchiveCSFloatBucket[] | 是 | 按时间顺序排列的每日成交聚合。 |
ArchiveHistoryItem
单个饰品的长期归档时间序列。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 规范化的 Steam market_hash_name。 |
count | integer | 是 | data 中的分桶数量。 |
data | ArchiveHistoryBucket[] | 是 | 按时间顺序排列的归档分桶。 |
variants | Record<string, ArchiveHistoryVariant> | 否 | 带有 Doppler 与 Gamma Doppler 相位或 Case Hardened 分层的饰品的逐变体归档时间序列。按显示名称作为键。 |
ArchiveHistoryVariant
一个 Doppler 或 Gamma Doppler 相位或 Case Hardened 分层的长期归档时间序列。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 基础饰品的 market_hash_name。完整变体名称见 name。 |
name | string | 是 | 变体的完整 market_hash_name，例如 ★ Karambit | Doppler (Factory New) | Phase 1。 |
display_name | string | 是 | 人类可读的变体标签（例如 Phase 1、Ruby、Tier 1、Blue Gem）。 |
version | string | 是 | 稳定变体代码。客户端代码应基于此切换。 |
count | integer | 是 | data 中的分桶数量。 |
data | ArchiveHistoryBucket[] | 是 | 按时间顺序排列的归档分桶。 |
ArchiveSteamItem
单个常规饰品的原生 Steam 成交历史分桶。不返回变体。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 规范化的 Steam market_hash_name。 |
count | integer | 是 | data 中的分桶数量。 |
data | ArchiveSteamBucket[] | 是 | 按时间顺序排列的分桶。 |
ArchiveYoupinItem
单个饰品的 Youpin 成交历史，每个抽样间隔一条序列。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 规范化的 Steam market_hash_name。 |
intervals | object | 是 | 按抽样间隔（1h、4h、12h）键控的序列。只有该间隔在请求窗口内被观测过时键才存在。 |
variants | Record<string, ArchiveYoupinVariant> | 否 | 具备 Doppler 与 Gamma Doppler 相位或 Case Hardened 分层的饰品的逐变体 Youpin 成交历史。以显示名称为键，为空时省略。变体序列绝不会回退到基础历史。 |
ArchiveYoupinVariant
一个 Doppler 或 Gamma Doppler 相位或 Case Hardened 分层的 Youpin 成交历史，按抽样间隔各一条独立序列。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 基础饰品的 market_hash_name。完整变体名称见 name。 |
name | string | 是 | 变体的完整 market_hash_name，例如 ★ Karambit | Doppler (Factory New) | Phase 1。 |
display_name | string | 是 | 人类可读的变体标签（例如 Phase 1、Ruby、Tier 1、Blue Gem）。 |
version | string | 是 | 稳定变体代码。客户端代码应基于此切换。 |
intervals | object | 是 | 该变体的序列，与饰品的 intervals 一样按抽样间隔键控。 |
CSFloatBuyOrdersItem
一个基础饰品的求购订单簿。当条目仅用于承载 variants 下的相位订单簿时，订单簿字段不出现。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 规范化的 Steam market_hash_name。 |
updated_at | string (date-time) | 否 | 此订单簿的最后更新时间。 |
collected_at | string (date-time) | 否 | cs2.sh 采集此订单簿的时间。 |
top_generic_bid | number | null | 否 | 无条件订单中的最高价格（USD）。没有无条件订单时为 null。 |
orders | CSFloatBuyOrder[] | 否 | 按价格降序的订单阶梯。 |
variants | Record<string, CSFloatBuyOrdersVariant> | 否 | 以显示名称为键的 Doppler 和 Gamma Doppler 相位订单簿。 |
CSFloatBuyOrdersVariant
一个 Doppler 或 Gamma Doppler 相位的求购订单簿。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 基础饰品的 market_hash_name。完整变体名称见 name。 |
name | string | 是 | 变体的完整 market_hash_name，例如 ★ Karambit | Doppler (Factory New) | Phase 1。 |
display_name | string | 是 | 人类可读的变体标签（例如 Phase 2、Ruby）。 |
version | string | 是 | 稳定变体代码。客户端代码应基于此切换。 |
updated_at | string (date-time) | 是 | 此订单簿的最后更新时间。 |
collected_at | string (date-time) | 是 | cs2.sh 采集此订单簿的时间。 |
top_generic_bid | number | null | 是 | 无条件订单中的最高价格（USD）。没有无条件订单时为 null。 |
orders | CSFloatBuyOrder[] | 是 | 按价格降序的订单阶梯。 |
CSFloatBuyOrdersHistoryItem
一个基础饰品的 CSFloat 求购订单簿历史。相位序列嵌套在 variants 下。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 规范化的 Steam market_hash_name。 |
count | integer | 是 | data 中的数据点数量。 |
data | CSFloatBuyOrdersHistoryPoint[] | 是 | 按时间顺序排列的数据点。 |
variants | Record<string, CSFloatBuyOrdersHistoryVariant> | 否 | 以显示名称为键的 Doppler 和 Gamma Doppler 相位序列。 |
CSFloatBuyOrdersHistoryVariant
一个 Doppler 或 Gamma Doppler 相位的 CSFloat 求购订单簿历史。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 基础饰品的 market_hash_name。完整变体名称见 name。 |
name | string | 是 | 变体的完整 market_hash_name，例如 ★ Karambit | Doppler (Factory New) | Phase 1。 |
display_name | string | 是 | 人类可读的变体标签（例如 Phase 2、Ruby）。 |
version | string | 是 | 稳定变体代码。客户端代码应基于此切换。 |
count | integer | 是 | data 中的数据点数量。 |
data | CSFloatBuyOrdersHistoryPoint[] | 是 | 按时间顺序排列的数据点。 |
SteamOrderbookItem
单个常规饰品的最新全深度 Steam 订单簿。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
updated_at | string (date-time) | 是 | Steam 最后更新该订单簿的时间。 |
collected_at | string (date-time) | 是 | cs2.sh 采集该订单簿的时间。 |
top | SteamOrderbookTop | 是 | Steam 订单簿的盘口顶部：最低卖单与最高买单。某一侧缺失时对应字段为 null。 |
depth | SteamOrderbookDepth | 是 | 列式表示的全深度 Steam 订单簿档位。 |
SteamOrderbookHistoryItem
单个常规饰品的 Steam 订单簿分桶快照。不返回变体。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
count | integer | 是 | data 中的数据点数量。 |
data | SteamOrderbookHistoryPoint[] | 是 | 按时间顺序排列的数据点。 |
历史分桶
HistoryBucket
单个 OHLC 时间分桶。bucket 是间隔边界（UTC 对齐、确定性）；每个按来源对象上的 open_time/close_time 是其中实际第一次/最后一次观测时间戳。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
bucket | string (date-time) | 是 | 时间分桶的开始时间。UTC 对齐到间隔边界（例如 1h 分桶的 2026-01-08T19:00:00Z）。确定性。 |
buff | BUFFOHLCSourceData | 否 | BUFF 价格的 OHLC 分桶。 |
youpin | YoupinOHLCSourceData | 否 | Youpin 价格的 OHLC 分桶。 |
csfloat | CsfloatOHLCSourceData | 否 | CSFloat ask 与 bid 价格的 OHLC 分桶。 |
skinport | SkinportOHLCSourceData | 否 | Skinport ask 价格的 OHLC 分桶。 |
c5game | C5GameOHLCSourceData | 否 | C5Game ask 和 bid 价格的 OHLC 分桶。 |
steam | SteamOHLCSourceData | 否 | Steam Community Market ask 和 bid 价格的 OHLC 分桶。 |
BUFFMarketFloatLatestBucket
一个由 bucket_type 标识的最新 BUFF 磨损或渐变范围区间。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
bucket_id | string | 是 | 稳定的区间标识（例如 base、float:0.15:0.18、variant:p2|float:0.00:0.01）。 |
bucket_type | string | 是 | 允许值: base, float, fade, float_fade. 区间分层。 - base：对整件饰品或变体的聚合。 - float：按磨损区间切分（见 float）。 - fade：按渐变百分比切分（见 fade）。 - float_fade：磨损与渐变组合切分。 |
float | BUFFMarketFloatRange | 否 | float 或 fade 区间的数值范围。min 含，max 不含。 |
fade | BUFFMarketFloatRange | 否 | float 或 fade 区间的数值范围。min 含，max 不含。 |
updated_at | string (date-time) | 否 | BUFF 上次刷新该区间的时间。 |
collected_at | string (date-time) | 否 | cs2.sh 采集此区间的时间。 |
ask | number | 否 | 该区间内最低挂单价（USD）。 |
avg_ask | number | 否 | 该区间内平均挂单价（USD）。 |
bid | number | 否 | BUFF 上的最高求购单价格（USD）。 |
ask_volume | integer | 否 | 该区间内在售饰品数量。 |
bid_volume | integer | 否 | 针对该区间的活跃求购单数量。 |
BUFFMarketFloatHistoryBucket
单个 BUFF 市场区间的 OHLC 历史。data 按时间顺序排列，每项对应一个间隔。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
bucket_id | string | 是 | 稳定的区间标识（例如 fade:99:100、variant:p2|float:0.00:0.01）。 |
bucket_type | string | 是 | 允许值: base, float, fade, float_fade. 区间分层，参见 BUFFMarketFloatLatestBucket.bucket_type。 |
float | BUFFMarketFloatRange | 否 | float 或 fade 区间的数值范围。min 含，max 不含。 |
fade | BUFFMarketFloatRange | 否 | float 或 fade 区间的数值范围。min 含，max 不含。 |
data | BUFFMarketFloatHistoryPoint[] | 是 | 该区间的 OHLC 观测，按时间顺序排列。 |
BUFFMarketFloatHistoryPoint
BUFF 市场磨损/渐变区间历史中的单个 OHLC 观测点。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
bucket | string (date-time) | 是 | OHLC 间隔的开始时间（UTC 对齐到间隔边界）。 |
updated_at | string (date-time) | 否 | BUFF 在此间隔内最后一次刷新该区间的时间。 |
collected_at | string (date-time) | 否 | cs2.sh 在此间隔内采集源数据行的时间。 |
open_ask | number | 否 | 间隔内首次观测的挂单价（USD）。 |
high_ask | number | 否 | 间隔内最高挂单价（USD）。 |
low_ask | number | 否 | 间隔内最低挂单价（USD）。 |
close_ask | number | 否 | 间隔内最后一次挂单价（USD）。 |
open_avg_ask | number | 否 | 间隔内首次观测的 avg_ask 值。 |
high_avg_ask | number | 否 | 间隔内最高 avg_ask 值。 |
low_avg_ask | number | 否 | 间隔内最低 avg_ask 值。 |
close_avg_ask | number | 否 | 间隔内最后一次 avg_ask 值。 |
open_bid | number | 否 | 间隔内首次观测的求购价（USD）。 |
high_bid | number | 否 | 间隔内最高求购价（USD）。 |
low_bid | number | 否 | 间隔内最低求购价（USD）。 |
close_bid | number | 否 | 间隔内最后一次求购价（USD）。 |
ask_volume | integer | 否 | 间隔内最后一次观测的挂单数量。 |
bid_volume | integer | 否 | 间隔内最后一次观测的求购单数量。 |
open_time | string (date-time) | 是 | 间隔内首次观测的时间戳。与 bucket（间隔边界）不同。 |
close_time | string (date-time) | 是 | 间隔内最后一次观测的时间戳。与 bucket（间隔边界）不同。 |
BUFFMarketFloatRange
float 或 fade 区间的数值范围。min 含，max 不含。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
min | number | 否 | 下界（含）。 |
max | number | 否 | 上界（不含）。 |
ArchiveBuffPoint
一笔 BUFF 成交，或当天没有成交时的仅供应量数据点。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
time | string (date-time) | 是 | 成交时间，UTC。仅供应量数据点使用中国时区零点（UTC 16:00）的时间戳。 |
sale_price | number | null | 是 | 成交价（USD），按成交日期的历史汇率由 CNY 换算。仅供应量数据点，以及成交日期尚未存储汇率的成交，为 null。 |
total_supply | integer | null | 是 | BUFF 在该成交所属中国自然日（UTC+8）报告的总供应量。当天没有报告供应量时为 null。 |
ArchiveCSFloatBucket
CSFloat 上一天的成交数据。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
date | string | 是 | YYYY-MM-DD 格式的日期（UTC）。 |
price | number | null | 是 | 当天所有成交价格的算术平均值（USD）。 |
volume | integer | 是 | 当天成交次数。 |
ArchiveHistoryBucket
单个归档时间分桶。只有当该来源在此分桶中存在数据时，对应来源键才会出现。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
bucket | string (date-time) | 是 | 时间分桶的开始时间（UTC 对齐到间隔边界）。 |
aggregate | ArchiveHistoryPlatformData | 否 | 归档分桶内的逐来源价格数据。aggregate 的价格由 BUFF 和 Youpin 派生；hourly_volume 和 total_supply 仅在 aggregate 来源上填充。 |
buff | ArchiveHistoryPlatformData | 否 | 归档分桶内的逐来源价格数据。aggregate 的价格由 BUFF 和 Youpin 派生；hourly_volume 和 total_supply 仅在 aggregate 来源上填充。 |
youpin | ArchiveHistoryPlatformData | 否 | 归档分桶内的逐来源价格数据。aggregate 的价格由 BUFF 和 Youpin 派生；hourly_volume 和 total_supply 仅在 aggregate 来源上填充。 |
c5game | ArchiveHistoryPlatformData | 否 | 归档分桶内的逐来源价格数据。aggregate 的价格由 BUFF 和 Youpin 派生；hourly_volume 和 total_supply 仅在 aggregate 来源上填充。 |
ArchiveHistoryPlatformData
归档分桶内的逐来源价格数据。aggregate 的价格由 BUFF 和 Youpin 派生；hourly_volume 和 total_supply 仅在 aggregate 来源上填充。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
time | string (date-time) | 是 | 分桶内最后一次观测的实际时间戳。不同于分桶边界。 |
ask | number | null | 是 | 分桶内最后观测到的 ask 价格（USD）。 |
ask_volume | integer | null | 是 | 最后观测到的在售饰品数量。 |
bid | number | null | 是 | 分桶内最后观测到的 bid 价格（USD）。高于该来源 ask 时为 null。 |
bid_volume | integer | null | 是 | 最后观测到的求购单数量。 |
hourly_volume | number | null | 否 | 聚合交易量指标（仅 aggregate 来源）。 |
total_supply | number | null | 否 | 总市场供应量指标（仅 aggregate 来源）。 |
sample_count | integer | 是 | 聚合到此分桶的观测数量。 |
ArchiveSteamBucket
一个原生 Steam 成交历史分桶。price 是 Steam 成交中位价，volume 是 Steam 报告的购买次数。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
bucket | string (date-time) | 是 | 原生 Steam 分桶开始时间。 |
price | number | null | 是 | Steam USD 成交中位价。 |
volume | integer | null | 是 | Steam 报告的购买次数。 |
ArchiveYoupinSeries
单一抽样间隔下的 Youpin 成交。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
count | integer | 是 | 该条序列中的点数量（即 data 的长度），不是成交量。0 加空 data 表示该间隔被观测过且无成交。 |
data | ArchiveYoupinPoint[] | 是 | 该间隔的成交，按时间顺序排列。 |
ArchiveYoupinPoint
Youpin 上的一笔成交。Youpin 对每个抽样分桶只保留一笔成交，因此点是一笔真实成交，不是聚合值。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
bucket | string (date-time) | 是 | 抽样分桶的起点。 |
time | string (date-time) | 是 | 分桶内的实际成交时间。 |
price | number | null | 是 | 成交价（USD），按成交日期各自的历史汇率由 CNY 换算；当该日期的汇率无法解析时为 null。 |
CSFloatBuyOrder
一条挂起的 CSFloat 求购订单。其条件位于 conditions 中。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
price | number | 是 | 订单价格（USD）。 |
quantity | integer | 否 | 该价格下求购的饰品数量。 |
kind | string | 是 | 允许值: generic, paint_index, float, sticker, keychain_pattern, paint_seeds, keychain, mixed. conditions 中匹配规则的摘要。generic 没有规则；mixed 包含多类规则或 cs2.sh 无法识别的规则。 |
conditions | CSFloatBuyOrderConditions | 是 | 挂单必须满足这些规则，此求购订单才会买入。存在多条规则时必须全部满足。generic 订单为空。mixed 订单还可能原样携带 API 无法识别的 CSFloat 规则键。 |
CSFloatBuyOrderConditions
挂单必须满足这些规则，此求购订单才会买入。存在多条规则时必须全部满足。generic 订单为空。mixed 订单还可能原样携带 API 无法识别的 CSFloat 规则键。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
paint_index | integer | 否 | 挂单的 paint index 必须等于此值。 |
min_float | number | 否 | 挂单的磨损值必须大于或等于此值。 |
max_float | number | 否 | 挂单的磨损值必须小于或等于此值。 |
stickers | CSFloatStickerCondition[] | 否 | 挂单必须满足此数组中的每项印花要求。同一印花 ID 重复出现表示要求多枚该印花。 |
min_keychain_pattern | integer | 否 | 已挂挂件的图案值必须大于或等于此值。 |
max_keychain_pattern | integer | 否 | 已挂挂件的图案值必须小于或等于此值。 |
paint_seeds | integer[] | 否 | 挂单的 paint seed 必须等于其中一个值。 |
keychains | CSFloatKeychainCondition[] | 否 | 挂单必须具有此数组中标识的每个挂件。 |
CSFloatStickerCondition
挂单必须具有的一枚印花。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
sId | integer | 是 | 挂单必须具有的印花的 CSFloat 数字 ID。 |
s | integer | 否 | 必须贴有此印花的槽位，从零开始。省略时，该印花可位于任意槽位。 |
CSFloatKeychainCondition
挂单必须具有的一个挂件。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
sId | integer | 是 | 挂单必须具有的挂件的 CSFloat 数字 ID。 |
CSFloatBuyOrdersHistoryPoint
一个 UTC 分桶内观测到的最新求购订单簿。这是某一时刻的订单簿状态，而非 OHLC 数据。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
bucket | string (date-time) | 是 | UTC 分桶起点。 |
updated_at | string (date-time) | 是 | 此分桶中订单簿的最后更新时间。 |
collected_at | string (date-time) | 是 | cs2.sh 采集此分桶所代表订单簿的时间。 |
top_generic_bid | number | null | 是 | 无条件订单中的最高价格（USD）。没有无条件订单时为 null。 |
orders | CSFloatBuyOrder[] | 是 | 按价格降序的订单阶梯。 |
SteamOrderbookTop
Steam 订单簿的盘口顶部：最低卖单与最高买单。某一侧缺失时对应字段为 null。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
ask | number | null | 是 | 最低卖单 USD 价格；缺失时为 null。 |
ask_volume | integer | null | 是 | Steam 卖单总数量；缺失时为 null。 |
bid | number | null | 是 | 最高求购单 USD 价格；缺失时为 null。 |
bid_volume | integer | null | 是 | Steam 买单总数量；缺失时为 null。 |
SteamOrderbookDepth
列式表示的全深度 Steam 订单簿档位。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
ask_levels | integer | 是 | asks 中的卖单档位数量。 |
bid_levels | integer | 是 | bids 中的买单档位数量。 |
asks | SteamOrderbookDepthSide | 是 | 订单簿某一侧的列式深度。prices[i] 与 volumes[i] 一一对应；每个 volume 是该价格上的数量，不是累计数量。 |
bids | SteamOrderbookDepthSide | 是 | 订单簿某一侧的列式深度。prices[i] 与 volumes[i] 一一对应；每个 volume 是该价格上的数量，不是累计数量。 |
SteamOrderbookDepthSide
订单簿某一侧的列式深度。prices[i] 与 volumes[i] 一一对应；每个 volume 是该价格上的数量，不是累计数量。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
prices | number[] | 是 | USD 十进制价格。卖单升序，买单降序。 |
volumes | integer[] | 是 | 每个对应价格上的数量。 |
SteamOrderbookHistoryPoint
一个分桶内最新的全深度 Steam 订单簿快照。这不是 OHLC 数据。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
bucket | string (date-time) | 是 | UTC 分桶开始时间。 |
updated_at | string (date-time) | 是 | Steam 最后更新该分桶所代表订单簿的时间。 |
collected_at | string (date-time) | 是 | cs2.sh 采集该分桶所代表订单簿的时间。 |
top | SteamOrderbookTop | 是 | Steam 订单簿的盘口顶部：最低卖单与最高买单。某一侧缺失时对应字段为 null。 |
depth | SteamOrderbookDepth | 是 | 列式表示的全深度 Steam 订单簿档位。 |
最新价格来源数据
BUFFSourceData
来自 BUFF 的价格数据。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
updated_at | string (date-time) | null | 是 | BUFF 上次更新此价格的时间。 |
collected_at | string (date-time) | null | 是 | cs2.sh 采集此价格的时间。 |
ask | number | null | 是 | 最低 ask 价格（USD）。 |
ask_volume | integer | null | 是 | 在售饰品数量。 |
bid | number | null | 是 | 最高求购单价格（USD）。 |
bid_volume | integer | null | 是 | 活跃求购单数量。 |
YoupinSourceData
来自 Youpin 的价格数据。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
updated_at | string (date-time) | null | 是 | Youpin 上次更新此价格的时间。 |
collected_at | string (date-time) | null | 是 | cs2.sh 采集此价格的时间。 |
ask | number | null | 是 | 最低 ask 价格（USD）。 |
ask_volume | integer | null | 是 | 在售饰品数量。 |
bid | number | null | 是 | 最高求购单价格（USD）。 |
bid_volume | integer | null | 是 | 活跃求购单数量。 |
CsfloatSourceData
来自 CSFloat 的当前挂单与求购单价格。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
updated_at | string (date-time) | null | 是 | CSFloat 上次更新此价格的时间。 |
collected_at | string (date-time) | null | 是 | cs2.sh 采集此价格的时间。 |
ask | number | null | 是 | 最低 ask 价格（USD）。 |
ask_volume | integer | null | 是 | 在售饰品数量。 |
bid | number | null | 是 | 最高求购单价格（USD）。 |
SkinportSourceData
来自 Skinport 的价格数据，包括 Skinport 提供的滚动历史窗口。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
updated_at | string (date-time) | null | 是 | Skinport 上次更新此价格的时间。 |
collected_at | string (date-time) | null | 是 | cs2.sh 采集此价格的时间。 |
ask | number | null | 是 | 最低 ask 价格（USD）。 |
ask_volume | integer | null | 是 | 在售饰品数量。 |
max_ask | number | null | 是 | 最高挂单价（USD）。 |
mean_ask | number | null | 是 | 平均挂单价（USD）。 |
median_ask | number | null | 是 | 挂单价中位数（USD）。 |
24h_history | SkinportPriceWindow | null | 是 | - |
7d_history | SkinportPriceWindow | null | 是 | - |
30d_history | SkinportPriceWindow | null | 是 | - |
90d_history | SkinportPriceWindow | null | 是 | - |
SteamSourceData
来自 Steam 社区市场的价格数据。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
updated_at | string (date-time) | null | 是 | Steam 上次更新此价格的时间。 |
collected_at | string (date-time) | null | 是 | cs2.sh 采集此价格的时间。 |
ask | number | null | 是 | 最低 ask 价格（USD）。 |
ask_volume | integer | null | 是 | 在售饰品数量。 |
bid | number | null | 是 | 最高求购单价格（USD）。 |
bid_volume | integer | null | 是 | 活跃求购单数量。 |
C5GameSourceData
来自 C5Game 的价格数据。Ask 和 bid 来自独立采集流程，因此同一饰品的时间戳可能不同。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
updated_at | string (date-time) | null | 是 | C5Game 上次更新此价格的时间。 |
collected_at | string (date-time) | null | 是 | cs2.sh 采集此价格的时间。 |
ask | number | null | 是 | 最低 ask 价格（USD）。 |
ask_volume | integer | null | 是 | 在售饰品数量。 |
bid | number | null | 是 | 最高求购单价格（USD）。 |
SkinportPriceWindow
Skinport 提供的滚动价格窗口。当 Skinport 最近没有该饰品成交时，对象为 null。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
price | number | 是 | 窗口内最近成交价（USD）。 |
max_price | number | 是 | 窗口内最高成交价（USD）。 |
mean_price | number | 是 | 窗口内平均成交价（USD）。 |
median_price | number | 是 | 窗口内成交价中位数（USD）。 |
volume | integer | 是 | 窗口内成交次数。 |
OHLC 来源数据
BUFFOHLCSourceData
BUFF 价格的 OHLC 分桶。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
open_ask | number | null | 是 | 分桶内第一个 ask 价格。 |
high_ask | number | null | 是 | 分桶内最高 ask 价格。 |
low_ask | number | null | 是 | 分桶内最低 ask 价格。 |
close_ask | number | null | 是 | 分桶内最后一个 ask 价格。 |
ask_volume | integer | null | 是 | 分桶内最后观测到的 ask 成交量。 |
open_bid | number | null | 是 | 分桶内第一个 bid 价格。 |
high_bid | number | null | 是 | 分桶内最高 bid 价格。 |
low_bid | number | null | 是 | 分桶内最低 bid 价格。 |
close_bid | number | null | 是 | 分桶内最后一个 bid 价格。 |
bid_volume | integer | null | 是 | 分桶内最后观测到的 bid 成交量。 |
sample_count | integer | 是 | 聚合到此分桶的底层 5 分钟观测数量。 |
open_time | string (date-time) | null | 是 | 此分桶内第一次观测的时间戳。不同于 bucket（间隔边界）。 |
close_time | string (date-time) | null | 是 | 此分桶内最后一次观测的时间戳。不同于 bucket（间隔边界）。 |
YoupinOHLCSourceData
Youpin 价格的 OHLC 分桶。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
open_ask | number | null | 是 | 分桶内第一个 ask 价格。 |
high_ask | number | null | 是 | 分桶内最高 ask 价格。 |
low_ask | number | null | 是 | 分桶内最低 ask 价格。 |
close_ask | number | null | 是 | 分桶内最后一个 ask 价格。 |
ask_volume | integer | null | 是 | 分桶内最后观测到的 ask 成交量。 |
open_bid | number | null | 是 | 分桶内第一个 bid 价格。 |
high_bid | number | null | 是 | 分桶内最高 bid 价格。 |
low_bid | number | null | 是 | 分桶内最低 bid 价格。 |
close_bid | number | null | 是 | 分桶内最后一个 bid 价格。 |
bid_volume | integer | null | 是 | 分桶内最后观测到的 bid 成交量。 |
sample_count | integer | 是 | 聚合到此分桶的底层 5 分钟观测数量。 |
open_time | string (date-time) | null | 是 | 此分桶内第一次观测的时间戳。不同于 bucket（间隔边界）。 |
close_time | string (date-time) | null | 是 | 此分桶内最后一次观测的时间戳。不同于 bucket（间隔边界）。 |
CsfloatOHLCSourceData
CSFloat ask 与 bid 价格的 OHLC 分桶。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
open_ask | number | null | 是 | 分桶内第一个 ask 价格。 |
high_ask | number | null | 是 | 分桶内最高 ask 价格。 |
low_ask | number | null | 是 | 分桶内最低 ask 价格。 |
close_ask | number | null | 是 | 分桶内最后一个 ask 价格。 |
ask_volume | integer | null | 是 | 分桶内最后观测到的 ask 成交量。 |
open_bid | number | null | 是 | 分桶内第一个 bid 价格。 |
high_bid | number | null | 是 | 分桶内最高 bid 价格。 |
low_bid | number | null | 是 | 分桶内最低 bid 价格。 |
close_bid | number | null | 是 | 分桶内最后一个 bid 价格。 |
sample_count | integer | 是 | 聚合到此分桶的底层 5 分钟观测数量。 |
open_time | string (date-time) | null | 是 | 此分桶内第一次观测的时间戳。不同于 bucket（间隔边界）。 |
close_time | string (date-time) | null | 是 | 此分桶内最后一次观测的时间戳。不同于 bucket（间隔边界）。 |
SkinportOHLCSourceData
Skinport ask 价格的 OHLC 分桶。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
open_ask | number | null | 是 | 分桶内第一个 ask 价格。 |
high_ask | number | null | 是 | 分桶内最高 ask 价格。 |
low_ask | number | null | 是 | 分桶内最低 ask 价格。 |
close_ask | number | null | 是 | 分桶内最后一个 ask 价格。 |
ask_volume | integer | null | 是 | 分桶内最后观测到的 ask 成交量。 |
sample_count | integer | 是 | 聚合到此分桶的底层 5 分钟观测数量。 |
open_time | string (date-time) | null | 是 | 此分桶内第一次观测的时间戳。不同于 bucket（间隔边界）。 |
close_time | string (date-time) | null | 是 | 此分桶内最后一次观测的时间戳。不同于 bucket（间隔边界）。 |
SteamOHLCSourceData
Steam Community Market ask 和 bid 价格的 OHLC 分桶。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
open_ask | number | null | 是 | 分桶内第一个 ask 价格。 |
high_ask | number | null | 是 | 分桶内最高 ask 价格。 |
low_ask | number | null | 是 | 分桶内最低 ask 价格。 |
close_ask | number | null | 是 | 分桶内最后一个 ask 价格。 |
ask_volume | integer | null | 是 | 分桶内最后观测到的 ask 成交量。 |
open_bid | number | null | 是 | 分桶内第一个 bid 价格。 |
high_bid | number | null | 是 | 分桶内最高 bid 价格。 |
low_bid | number | null | 是 | 分桶内最低 bid 价格。 |
close_bid | number | null | 是 | 分桶内最后一个 bid 价格。 |
bid_volume | integer | null | 是 | 分桶内最后观测到的 bid 成交量。 |
sample_count | integer | 是 | 聚合到此分桶的底层 5 分钟观测数量。 |
open_time | string (date-time) | null | 是 | 此分桶内第一次观测的时间戳。不同于 bucket（间隔边界）。 |
close_time | string (date-time) | null | 是 | 此分桶内最后一次观测的时间戳。不同于 bucket（间隔边界）。 |
C5GameOHLCSourceData
C5Game ask 和 bid 价格的 OHLC 分桶。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
open_ask | number | null | 是 | 分桶内第一个 ask 价格。 |
high_ask | number | null | 是 | 分桶内最高 ask 价格。 |
low_ask | number | null | 是 | 分桶内最低 ask 价格。 |
close_ask | number | null | 是 | 分桶内最后一个 ask 价格。 |
ask_volume | integer | null | 是 | 分桶内最后观测到的 ask 成交量。 |
open_bid | number | null | 是 | 分桶内第一个 bid 价格。 |
high_bid | number | null | 是 | 分桶内最高 bid 价格。 |
low_bid | number | null | 是 | 分桶内最低 bid 价格。 |
close_bid | number | null | 是 | 分桶内最后一个 bid 价格。 |
sample_count | integer | 是 | 聚合到此分桶的底层 5 分钟观测数量。 |
open_time | string (date-time) | null | 是 | 此分桶内第一次观测的时间戳。不同于 bucket（间隔边界）。 |
close_time | string (date-time) | null | 是 | 此分桶内最后一次观测的时间戳。不同于 bucket（间隔边界）。 |
饰品 Schema
SchemaItem
一条目录记录，在顶层 items 映射中按 market_hash_name 键控。不适用于该饰品的字段会被省略。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 规范化的 Steam market_hash_name，与价格端点一致。 |
category | string | 是 | 饰品类别（例如 skin、sticker、container、agent）。 |
image | string | 是 | cs2.sh 提供的图片 URL。 |
steam_image | string | 否 | 官方 Steam 图片 URL，可用时提供。 |
is_tradable | boolean | 是 | 该饰品是否可交易。 |
rarity | object | 否 | 饰品稀有度：name、tier 和 color。 |
collections | string[] | 否 | 饰品所属的收藏品。没有时省略。 |
containers | string[] | 否 | 掉落该饰品的容器。没有时省略。 |
ids | object | 否 | 已知的市场目录 id。 |
def_index | integer | 否 | 饰品定义索引。 |
base_name | string | 否 | 不含外观后缀的基础饰品名称。仅限皮肤。 |
weapon | string | 否 | 武器名称。仅限皮肤。 |
finish | string | 否 | 涂装名称。仅限皮肤。 |
paint_index | integer | 否 | 涂装索引。仅限皮肤；Doppler 和 Gamma Doppler 基础饰品会省略。 |
wears | string[] | 否 | 该饰品存在的外观。仅限有外观分级的饰品。 |
has_stattrak | boolean | 否 | 是否存在 StatTrak 版本。仅限有外观分级的饰品。 |
has_souvenir | boolean | 否 | 是否存在 Souvenir 版本。仅限有外观分级的饰品。 |
float_range | object | 否 | 该饰品的磨损上下界。仅限有外观分级的饰品。 |
wear | string | 否 | 该饰品的外观（例如 Field-Tested）。仅限有外观分级的饰品。 |
wear_float_range | object | 否 | 该外观行自身的磨损上下界，即 float_range 截取到该外观区间后的范围。仅限有外观分级的饰品。 |
stattrak | boolean | 否 | 该行是否为 StatTrak 版本。 |
souvenir | boolean | 否 | 该行是否为 Souvenir 版本。 |
variants | SchemaItemVariant[] | 否 | 该基础饰品的 Doppler 与 Gamma Doppler 相位或 Case Hardened 分层。 |
variant | object | 否 | 变体行回链到其基础饰品。 |
phase | string | 否 | 相位或宝石名称。仅限 Doppler 和 Gamma Doppler 变体行。 |
color | string | 否 | 十六进制强调色。仅限 Doppler 和 Gamma Doppler 变体行。 |
SchemaItemVariant
列在基础饰品 variants 下的一个 Doppler 或 Gamma Doppler 相位或 Case Hardened 分层。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
market_hash_name | string | 是 | 完整的变体 market_hash_name。 |
family | string | 是 | 允许值: doppler, gamma_doppler, case_hardened. 变体家族。 |
name | string | 是 | 变体名称（例如 Phase 2、Ruby、Tier 1）。 |
phase | string | 否 | 相位或宝石名称。Case Hardened 会省略。 |
color | string | 否 | 十六进制强调色。Case Hardened 会省略。 |
paint_index | integer | 否 | 该变体的涂装索引。 |
image | string | 是 | cs2.sh 提供的图片 URL。 |
steam_image | string | 否 | 官方 Steam 图片 URL，可用时提供。 |
SchemaCollection
收藏品元数据。在顶层 collections 映射中按收藏品名称键控。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
name | string | 是 | 收藏品名称。 |
kind | string | 是 | 收藏品类型（例如 weapon、sticker）。 |
release_date | string | 否 | 发布日期（YYYY-MM-DD），已知时提供。饰品的发布日期即其收藏品的发布日期。 |
released_at | string | 否 | Valve 公布该收藏品的时间（RFC 3339 UTC），已知时提供。 |
update_name | string | 否 | Valve 对该次更新的自有名称，例如 Season 5, Armory, and More。 |
announcement_url | string | 否 | 该次更新的规范 Steam 公告地址。 |
image | string | 否 | 由 cs2.sh 提供的图片 URL，可用时提供。 |
steam_image | string | 否 | 官方 Steam 图片 URL，可用时提供。 |
SchemaRarity
一个稀有度分层。列在顶层 rarities 数组中，并由饰品层的 rarity 引用。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
key | string | 是 | 稳定的稀有度键（例如 ancient、legendary）。 |
name | string | 是 | 显示名称（例如 Covert、Classified）。 |
tier | integer | 是 | 数值稀有度分层，随稀有度递增。 |
color | string | 是 | 该稀有度的十六进制颜色。 |
健康状态
HealthResponse
cs2.sh 数据来源和公共数据集的当前健康状态。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
status | string | 是 | 允许值: up, degraded, down. API 数据的整体健康状态。 |
last_refreshed_at | string (date-time) | 是 | 此健康快照的生成时间。 |
schema_ready | boolean | 是 | 饰品 schema 是否可用。 |
sources | Record<string, HealthEntry> | 是 | 按来源键控的市场健康状态。 |
variants | Record<string, HealthEntry> | 是 | 按来源采集器键控的变体价格健康状态。 |
endpoints | Record<string, HealthEntry> | 是 | 按端点名称键控的数据集健康状态。fx 报告货币换算所用汇率的状态。 |
stats | HealthStats | 是 | 上次健康状态刷新时的数据库汇总计数。 |
HealthEntry
单个来源、变体采集器或端点数据集的新鲜度和状态。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
updated_at | string (date-time) | 是 | 此条目所代表数据的最新来源时间。 |
collected_at | string (date-time) | 是 | cs2.sh 最近采集或生成此数据集的时间。 |
status | string | 是 | 允许值: up, degraded, down. 根据数据集预期刷新频率计算的健康状态。 |
HealthStats
上次健康状态刷新时的数据库汇总计数。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
total_events | integer | 是 | 已存储的市场数据事件总数。 |
market_hash_names | integer | 是 | 当前市场数据中唯一饰品名称的数量。 |
variant_items | integer | 是 | 当前市场数据中唯一变体饰品名称的数量。 |
错误
ItemError
部分成功响应中单个饰品的错误。
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
item | string | 是 | 失败的请求饰品名称。 |
code | string | 是 | 允许值: unknown_item, not_in_cache, invalid_format, not_in_archive, unsupported_variant, unsupported_source. 错误代码。 |
message | string | 是 | 人类可读错误消息。 |
ErrorResponse
| 字段 | 类型 | 必需 | 描述 |
|---|---|---|---|
error | string | 是 | 错误代码，例如 validation_error、unauthorized、rate_limited。 |
message | string | 是 | 人类可读错误消息。 |
request_id | string (uuid) | 否 | 用于支持的唯一请求标识符。 |
details | object | 否 | 额外错误详情；结构因错误类型而异。 |