# How to Get BUFF163 Price History with an API

> cs2.sh provides three BUFF163 history datasets: archive observations from
> 2023, continuously updated OHLC from December 24, 2025, and float or Fade
> range OHLC from May 19, 2026.

The correct endpoint depends on the date range and market definition. BUFF
base-item history, intraday OHLC, and exact float-range history have different
fields and start dates.

## BUFF history coverage by endpoint

| Dataset | Coverage | Fields |
| --- | --- | --- |
| Long-term archive | From 2023 at `1h` or `1d` | Last-observed ask, bid, `ask_volume`, `bid_volume`, `time`, `sample_count` |
| Continuous price history | From December 24, 2025 at `5m`, `30m`, `1h`, or `1d` | Ask and bid OHLC, last-observed volumes, `sample_count`, `open_time`, `close_time` |
| Dedicated BUFF ranges | From May 19, 2026 at `30m`, `1h`, or `1d` | Ask, `avg_ask`, and bid OHLC for base, float, fade, and combined buckets |

Archive history updates once or twice per day. The continuous series updates
with current price collection, and dedicated BUFF range prices refresh every
10 minutes.

The archive can include supported variant series, but it does not reconstruct
the dedicated float or Fade buckets before their May 19, 2026 launch.

## Request the dataset you need

For long horizons, request up to 100 exact `market_hash_name` values on
`POST /v1/archive/history`, set source to `buff`, and choose `1h` or `1d`.
Read `bucket` as the UTC boundary and the BUFF object's `time` as the actual
last observation inside it.

For intraday movement, use `POST /v1/prices/history`, filter to `buff`, and read
separate ask and bid OHLC. The interval maximum ranges are 14 days for `5m`,
90 days for `30m`, 365 days for `1h`, and unlimited for `1d`.

For exact float or Fade pricing, use `POST /v1/market/buff/history` and select
the required stable `bucket_id`. The
[BUFF float-range history guide](/resources/how-to-get-buff-float-range-price-history)
explains how exact floats map to lower-inclusive, upper-exclusive ranges.

## Applicable endpoints

| Endpoint | Returns | Plans |
| --- | --- | --- |
| `POST /v1/archive/history` | Long-term BUFF observations from 2023 | Scale, Enterprise |
| `POST /v1/prices/history` | Continuous BUFF OHLC from December 24, 2025 | Scale, Enterprise |
| `POST /v1/market/buff/history` | BUFF float and Fade range OHLC from May 19, 2026 | Scale, Enterprise |

## Avoid mixing the three models

- Archive `ask` and `bid` are last-observed values, not daily OHLC or
  completed-sale prices.
- Continuous `bucket` values are aligned interval boundaries.
  `open_time` and `close_time` identify the observations that formed each
  source candle.
- Dedicated BUFF `avg_ask` is an average of active listing asks. It is not a
  completed-sale average.
- Requests before an endpoint's start date cannot supply the missing history
  from another BUFF endpoint. Keep each boundary explicit in charts and
  backtests.