# How to Get BUFF Gamma Doppler Price History

> cs2.sh records BUFF Gamma Doppler history for Phase 1 through Phase 4 and
> Emerald separately. Dedicated BUFF history adds phase-specific float buckets
> and average-ask OHLC from May 19, 2026.

Emerald is a distinct variant, not a fifth ordinary phase. Its price and market
depth should remain separate from Phase 1 through Phase 4 throughout a history
analysis.

## Two BUFF Gamma Doppler history views

`POST /v1/prices/history` provides per-source variant OHLC for BUFF alongside
the other marketplaces. That series begins December 24, 2025 and supports
`5m`, `30m`, `1h`, and `1d` intervals. BUFF points include ask and bid OHLC,
last-observed `ask_volume` and `bid_volume`, `sample_count`, and the real
`open_time` and `close_time`.

`POST /v1/market/buff/history` provides the more detailed BUFF range model from
May 19, 2026:

- Every variant has a `base` bucket for its phase-wide market.
- Each phase can have narrower `float` buckets with independent prices.
- `ask`, `avg_ask`, and `bid` each receive OHLC fields.
- `ask_volume` and `bid_volume` are the last active counts in the interval.
- The dedicated data refreshes every 10 minutes and supports `30m`, `1h`, and
  `1d`.

Variant `version` codes are `p1`, `p2`, `p3`, `p4`, and `emerald`. These codes
are stable even if a display label changes.

## Choose the series that matches the question

Use general price history when you need comparable BUFF and cross-marketplace
phase-wide candles, especially before May 19, 2026. Request the base Gamma
Doppler `market_hash_name`, filter to source `buff`, and select the variant by
its `version`.

Use dedicated BUFF history when float-specific pricing or `avg_ask` changes the
answer. Discover the current bucket catalog with
[BUFF latest](/docs/api-reference/market-buff-latest), then match the stable
`bucket_id` in the history response. A phase-wide Emerald analysis uses its
`base` bucket; an Emerald low-float analysis uses the appropriate Emerald
`float` bucket.

## Applicable endpoints

| Endpoint | Returns | Plans |
| --- | --- | --- |
| `POST /v1/market/buff/history` | Phase and float-range BUFF OHLC since May 19, 2026 | Scale, Enterprise |
| `POST /v1/prices/history` | Per-source variant OHLC since December 24, 2025 | Scale, Enterprise |
| `GET /v1/market/buff/latest` | Current BUFF buckets and stable identifiers | All plans |

## Details that change the analysis

- `close_avg_ask` is the closing average active ask. It does not average
  completed sales, so it should be read with the listing floor and
  `ask_volume`.
- A missing Emerald bucket is missing coverage. Filling it with a parent item
  or Phase 1 through Phase 4 value would create data the marketplace did not
  report.
- Compare premiums at matching `bucket` timestamps. Using an Emerald close and
  a base close from different intervals mixes overall market movement into the
  variant premium.
- The dedicated BUFF history has no data before May 19, 2026. The general
  endpoint cannot supply earlier float-range or average-ask history.

For a marketplace comparison, use the
[Gamma Doppler history guide](/resources/how-to-get-gamma-doppler-price-history).