# How to Get BUFF Gamma Doppler Prices

> `GET /v1/market/buff/latest` returns separate current BUFF markets for Gamma
> Doppler Phase 1 through Phase 4 and Emerald. Each variant has phase-wide and
> float-range buckets with prices and active market counts.

Gamma Doppler variants should be addressed by their stable `version`: `p1`,
`p2`, `p3`, `p4`, and `emerald`. Emerald remains its own market instead of
being averaged into the four ordinary phases.

## Current BUFF Gamma Doppler fields

The dedicated BUFF response nests each variant under the base item's
`variants` object. Every variant carries `display_name`, the full variant
`name`, its stable `version`, and a `buckets` array.

Use the `base` bucket to read the whole phase:

- `ask` is the lowest active listing in USD.
- `avg_ask` is the average active listing ask.
- `bid` is the highest buy order.
- `ask_volume` counts active listings in the phase bucket.
- `bid_volume` counts active buy orders against the phase bucket.

Use a `float` bucket when the exact wear value belongs to a narrower BUFF
market. The range includes `float.min` and excludes `float.max`. A bucket such
as `variant:emerald|float:0.00:0.01` therefore means both Emerald and that
specific float range.

## Read phase-wide or float-specific prices

Fetch the complete BUFF range snapshot, select the base Gamma Doppler
`market_hash_name`, and locate the variant by `version`. Choose its `base`
bucket for a phase comparison. Match an exact float to a returned `float`
bucket for a float-aware valuation.

The endpoint refreshes every 10 minutes. `updated_at` records BUFF's source
update and `collected_at` records when cs2.sh fetched the bucket.

`GET /v1/prices/latest` also returns current per-source Gamma Doppler variants
for cross-marketplace comparisons. It does not expose BUFF's range buckets or
`avg_ask`; use the [dedicated BUFF endpoint](/docs/api-reference/market-buff-latest)
when those fields are required.

## Applicable endpoints

| Endpoint | Returns | Plans |
| --- | --- | --- |
| `GET /v1/market/buff/latest` | BUFF phase-wide and float-range Gamma Doppler books | All plans |
| `GET /v1/prices/latest` | Current variants across all supported sources | All plans |

## Reading a thin Emerald market

- A low `ask_volume` makes the floor sensitive to one listing. Keep
  `avg_ask` and active counts beside the ask instead of treating the floor as a
  complete description of the book.
- `bid_volume` is the number of active buy orders for the bucket. It is not the
  quantity available at the single highest bid.
- A phase-wide bucket and a low-float bucket answer different questions.
  Mixing both in one phase table double-counts the variant and overstates its
  ordinary price.
- Use [BUFF Gamma Doppler history](/resources/how-to-get-buff-gamma-doppler-price-history)
  to determine whether a current phase or float premium persisted.
