cs2.sh

How to Export Multi-Year CS2 Price History

Updated

API reference: POST /v1/archive/history

POST /v1/archive/history provides multi-year CS2 price, active-order volume, sale volume, and total-supply history from 2023 in 1h or 1d buckets.

This archive is the long-term series for BUFF, Youpin, C5Game, and the aggregate market view. It has a different shape from the high-frequency OHLC endpoint and should retain that identity in an export.

Archive coverage and fields#

Source Returned fields
aggregate ask, bid, ask_volume, bid_volume, hourly_volume, total_supply, time, sample_count
buff Last-observed ask, bid, active-order volumes, time, and sample_count
youpin Last-observed ask, bid, active-order volumes, time, and sample_count
c5game Last-observed ask, bid, active-order volumes, time, and sample_count

The default source selection is aggregate. Data begins in 2023 and updates once or twice per day. Items with supported variants can include separate archive histories under variants.

Exporting the archive#

Request up to 100 exact market_hash_name values with an inclusive start, optional exclusive end, selected sources, and 1h or 1d interval. Store the response's effective start, end, and interval with the output.

For bounded exports, use adjacent UTC ranges and deduplicate by item, variant if present, source, and bucket. Within a bucket, retain time, which is the actual last observation and differs from the aligned boundary.

Keep item-level errors[] beside successful rows. A valid requested item with no archive data returns not_in_archive; that condition should remain a coverage result rather than an all-zero series.

Applicable endpoint#

Endpoint Returns Plans
POST /v1/archive/history Archive prices, order counts, supply, and sale volume from 2023 Scale, Enterprise

Export boundaries#

  • hourly_volume and total_supply populate only on aggregate. Marketplace rows do not carry those fields.
  • Archive rows are last-observed values, not OHLC candles. Do not label their price columns as opens, highs, lows, or closes.
  • hourly_volume is the archive's sale-volume metric; ask_volume and bid_volume are active order counts.
  • A daily export and hourly export have different aggregation. Keep the chosen interval in every dataset version.

Use backfilling OHLC without gaps when the goal is the separate high-frequency series from December 24, 2025.