idomanteu/cs2-historical-item-prices-hourly-march-april-2026

# CS2 Historical Item Price Dataset - Hourly Data from BUFF, CSFloat, Youpin (March-April 2026) > **Published by [cs2.sh](https://cs2.sh)** - the pricing API for the Counter-Strike 2 skin market. Released free under CC BY 4.0. Hourly price history for **Counter-Strike 2 (CS2)** items across three marketplaces - **BUFF (buff163)**, **CSFloat**, and **Youpin (youpin898)** - plus a cross-marketplace aggregate with trading volume and total supply. - **Window:** 2026-03-22 → 2026-04-15 (25 days, 600 hourly buckets) - **Items:** 33,063 base items + 971 variants (Doppler phases, Case Hardened tiers) - **Formats:** Parquet (zstd-compressed) and gzipped CSV - **License:** CC BY 4.0 For full access, use the **[cs2.sh](https://cs2.sh) API** directly. API access to live prices, high-frequency historical data, and years of archive data. --- ## Files | File | Contents | Endpoint | |------|----------|----------| | `cs2_listing_prices_hourly.*` | Per-marketplace OHLC ask and bid prices | [`/v1/prices/history`](https://cs2.sh/docs) | | `cs2_market_aggregate_hourly.*` | Cross-marketplace aggregate with `hourly_volume` and `total_supply` | [`/v1/archive/history`](https://cs2.sh/docs) | All timestamps are UTC. Monetary values are in USD. --- ## Schema ### `cs2_listing_prices_hourly.*` One row per **(item × variant × source × hour)**. Per-marketplace hourly OHLC listing prices. | Column | Type | Nullable | Description | |--------|------|----------|-------------| | `market_hash_name` | string | no | Steam market hash name. | | `variant_version` | string | yes | Variant code (`p1`-`p4`, `ruby`, `sapphire`, `blackpearl`, `emerald`, `t1`-`t4`, `singleblue`); null for base items. | | `variant_display_name` | string | yes | Human-readable variant name; null for base items. | | `source` | string | no | `buff`, `youpin`, or `csfloat`. | | `bucket` | timestamp | no | Start of the 1-hour bucket (UTC). | | `open_ask`, `high_ask`, `low_ask`, `close_ask` | float | yes | OHLC ask prices (USD). | | `ask_volume` | integer | yes | Listings at end of hour. | | `open_bid`, `high_bid`, `low_bid`, `close_bid` | float | yes | OHLC bid prices (USD). Null for CSFloat. | | `bid_volume` | integer | yes | Buy orders at end of hour. Null for CSFloat. | | `sample_count` | integer | yes | Underlying 5-minute observations aggregated. | | `open_time`, `close_time` | timestamp | yes | First/last observation timestamps in the bucket. | ### `cs2_market_aggregate_hourly.*` One row per **(item × variant × hour)**. Cross-marketplace aggregate. Shares `market_hash_name`, `variant_version`, `variant_display_name`, and `bucket` with the listing file. | Column | Type | Nullable | Description | |--------|------|----------|-------------| | `time` | timestamp | yes | Last observation timestamp. | | `ask`, `bid` | float | yes | Aggregate ask/bid prices (USD). | | `ask_volume`, `bid_volume` | integer | yes | Aggregate listing/order counts. | | `hourly_volume` | float | yes | Completed sales in the hour (unique to this file). | | `total_supply` | float | yes | Total known items in existence at end of hour (unique to this file). | | `sample_count` | integer | yes | Underlying observations aggregated. | ### Variants Variants appear as rows with the same `market_hash_name` as their base item but with `variant_version` and `variant_display_name` populated. | Family | Values | |--------|--------| | Doppler phases | `p1`, `p2`, `p3`, `p4` | | Doppler finishes | `ruby`, `sapphire`, `blackpearl`, `emerald` | | Case Hardened tiers | `t1`, `t2`, `t3`, `t4` | | Case Hardened special | `singleblue` (Blue Gem) | ### Null semantics - **Missing rows:** a row is not emitted if a source had no data for that item at that hour. For cross-marketplace comparisons, use an explicit join rather than assuming aligned rows. - **Null columns:** CSFloat has no bid data, so `open_bid`, `close_bid`, `bid_volume` etc. are always null when `source = 'csfloat'`. --- ## Quick start ```python import pandas as pd import duckdb prices = pd.read_parquet("cs2_listing_prices_hourly.parquet") aggregate = pd.read_parquet("cs2_market_aggregate_hourly.parquet") # DuckDB runs directly on the files duckdb.sql("SELECT * FROM 'cs2_listing_prices_hourly.parquet' LIMIT 10") ``` --- ## Attribution > CS2 Historical Item Price Dataset - Hourly Data from BUFF, CSFloat, Youpin (March-April 2026). cs2.sh. https://cs2.sh# CS2历史物品价格数据集：来自BUFF、CSFloat、Youpin的小时级数据（2026年3-4月） > **由[cs2.sh](https://cs2.sh)发布**——该平台为Counter-Strike 2饰品市场提供定价API。本数据集以CC BY 4.0协议免费开放。 本数据集收录了Counter-Strike 2（以下简称CS2）物品在三大交易平台——BUFF（buff163）、CSFloat以及Youpin（youpin898）的小时级价格历史数据，同时包含跨平台聚合数据，附带交易量与总库存信息。 - **数据时间窗口**：2026年3月22日 → 2026年4月15日（共计25天，包含600个小时级数据块） - **覆盖物品**：33063件基础物品 + 971个变体（多普勒皮肤阶段、淬火渐变层级） - **数据格式**：采用zstd压缩的Parquet格式与gzip压缩的CSV格式 - **授权协议**：CC BY 4.0 如需完整获取数据，可直接使用cs2.sh的应用程序编程接口（API）。该API可获取实时价格、高频历史数据以及多年存档数据。 --- ## 文件 | 文件名 | 数据内容 | 接口端点 | |------|----------|----------| | `cs2_listing_prices_hourly.*` | 各平台的开盘-最高-最低-收盘（OHLC）挂单买卖价格 | [`/v1/prices/history`](https://cs2.sh/docs) | | `cs2_market_aggregate_hourly.*` | 跨平台聚合数据，包含`hourly_volume`（小时交易量）与`total_supply`（总库存） | [`/v1/archive/history`](https://cs2.sh/docs) | 所有时间戳均采用UTC时区，货币单位为美元（USD）。 --- ## 数据结构 ### `cs2_listing_prices_hourly.*` 每行对应**（物品 × 变体 × 交易平台 × 小时块）**，存储各平台的小时级OHLC挂单价格数据。 | 列名 | 数据类型 | 是否允许为空 | 说明 | |--------|------|----------|-------------| | `market_hash_name` | 字符串 | 否 | Steam市场物品哈希名称。 | | `variant_version` | 字符串 | 是 | 变体代码（`p1`-`p4`、`ruby`、`sapphire`、`blackpearl`、`emerald`、`t1`-`t4`、`singleblue`）；基础物品此字段为空。 | | `variant_display_name` | 字符串 | 是 | 人类可读的变体名称；基础物品此字段为空。 | | `source` | 字符串 | 否 | 取值为`buff`、`youpin`或`csfloat`。 | | `bucket` | 时间戳 | 否 | 1小时数据块的起始时间（UTC时区）。 | | `open_ask`, `high_ask`, `low_ask`, `close_ask` | 浮点数 | 是 | OHLC挂单卖价（单位：美元）。 | | `ask_volume` | 整数 | 是 | 时段结束时的挂单数量。 | | `open_bid`, `high_bid`, `low_bid`, `close_bid` | 浮点数 | 是 | OHLC挂单买价（单位：美元）。CSFloat平台此字段为空。 | | `bid_volume` | 整数 | 是 | 时段结束时的买单数量。CSFloat平台此字段为空。 | | `sample_count` | 整数 | 是 | 聚合的底层5分钟观测样本数。 | | `open_time`, `close_time` | 时间戳 | 是 | 数据块内的首个/末次观测时间戳。 | ### `cs2_market_aggregate_hourly.*` 每行对应**（物品 × 变体 × 小时块）**，存储跨平台聚合数据。与挂单数据文件共享`market_hash_name`、`variant_version`、`variant_display_name`和`bucket`字段。 | 列名 | 数据类型 | 是否允许为空 | 说明 | |--------|------|----------|-------------| | `time` | 时间戳 | 是 | 末次观测时间戳。 | | `ask`, `bid` | 浮点数 | 是 | 聚合后的卖/买价格（单位：美元）。 | | `ask_volume`, `bid_volume` | 整数 | 是 | 聚合后的挂单/买单总数。 | | `hourly_volume` | 浮点数 | 是 | 时段内完成的交易总量（为本文件独有字段）。 | | `total_supply` | 浮点数 | 是 | 时段结束时的已知物品总库存（为本文件独有字段）。 | | `sample_count` | 整数 | 是 | 聚合的底层观测样本数。 | ### 变体说明 变体与基础物品拥有相同的`market_hash_name`，但填充了`variant_version`和`variant_display_name`字段。 | 变体家族 | 取值 | |--------|--------| | 多普勒皮肤阶段 | `p1`, `p2`, `p3`, `p4` | | 多普勒皮肤特殊涂装 | `ruby`, `sapphire`, `blackpearl`, `emerald` | | 淬火皮肤渐变层级 | `t1`, `t2`, `t3`, `t4` | | 淬火皮肤特殊款 | `singleblue`（蓝宝石蓝宝石） | ### 空值语义 - **缺失行**：若某交易平台在对应时段无对应物品的数据，则不会生成该行。如需进行跨平台对比，请使用显式连接而非假设行对齐。 - **空列**：CSFloat平台无买单数据，因此当`source = 'csfloat'`时，`open_bid`, `close_bid`, `bid_volume`等字段均为空。 --- ## 快速入门 python import pandas as pd import duckdb # 读取各平台挂单价格数据 prices = pd.read_parquet("cs2_listing_prices_hourly.parquet") # 读取跨平台聚合数据 aggregate = pd.read_parquet("cs2_market_aggregate_hourly.parquet") # DuckDB可直接对Parquet文件执行SQL查询 duckdb.sql("SELECT * FROM 'cs2_listing_prices_hourly.parquet' LIMIT 10") --- ## 署名要求 > CS2历史物品价格数据集：来自BUFF、CSFloat、Youpin的小时级数据（2026年3-4月）。cs2.sh。https://cs2.sh