cs2.sh

How to Get BUFF163 Price History with an API

Updated

API reference: POST /v1/archive/history · POST /v1/prices/history · POST /v1/market/buff/history

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 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.