# How to Get BUFF Intraday Price History

> `POST /v1/prices/history` provides BUFF intraday price history as ask and bid
> OHLC candles at `5m`, `30m`, `1h`, or `1d`, with active listing and buy-order
> counts in each bucket.

Use this series when movement within a day matters. The long-term archive
provides older BUFF observations, while the continuously updated OHLC series
preserves opens, highs, lows, closes, and the real observation window.

## BUFF intraday fields and coverage

BUFF OHLC history begins December 24, 2025. Each per-source bucket contains:

- `open_ask`, `high_ask`, `low_ask`, and `close_ask`.
- Equivalent OHLC fields for `bid`.
- Last-observed `ask_volume` and `bid_volume`.
- `sample_count`, which counts underlying observations in the bucket.
- `open_time` and `close_time`, the first and last actual source observations.

The aligned `bucket` is the UTC interval start. It can differ from
`open_time`, especially when the first real observation arrived after the
boundary.

Interval limits are `5m` for up to 14 days, `30m` for up to 90 days, `1h` for
up to 365 days, and `1d` with no public maximum range.

## Query the BUFF source

Request up to 100 exact `market_hash_name` values and set `sources` to `buff`.
Choose the interval according to the required time resolution and date span.
The endpoint supports partial success, so resolved items remain in `items`
while invalid or unavailable names appear in `errors[]`.

Calculate a closing spread only when both `close_ask` and `close_bid` are
present, positive, and the bid does not exceed the ask. A crossed pair can
result from observations that should not be combined. Keep the BUFF source
timestamps with any spread series.

The [price-history reference](/docs/api-reference/prices-history) documents
the OHLC object. Use the
[BUFF163 archive guide](/resources/how-to-get-buff163-price-history) when the
analysis needs history from 2023 rather than intraday candles.

## Applicable endpoints

| Endpoint | Returns | Plans |
| --- | --- | --- |
| `POST /v1/prices/history` | BUFF OHLC since December 24, 2025 | Scale, Enterprise |
| `POST /v1/archive/history` | Last-observed BUFF price and volume from 2023 | Scale, Enterprise |

## Interpret the buckets correctly

- `ask_volume` and `bid_volume` are the last active counts observed in a
  candle. Their change is not completed-sale volume.
- A low `sample_count` or narrow `open_time` to `close_time` window means the
  bucket contains less observation coverage than its interval label implies.
- The OHLC series updates continuously, but marketplace refresh timing is
  source-dependent. Do not assume every `5m` bucket contains a new BUFF price.
- Price history requires Scale or Enterprise. Current prices are available on
  all plans, and a free 2-day developer key is available for evaluation.