# How to Export Multi-Year CS2 Price 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](/resources/how-to-backfill-cs2-price-data-without-gaps) when the goal is the separate high-frequency series from December 24, 2025.