cs2.sh

How to Get BUFF Intraday Price History

Updated

API reference: POST /v1/prices/history · POST /v1/archive/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 documents the OHLC object. Use the BUFF163 archive guide 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.