How to Get BUFF Float-Range Price History

Updated

API reference: POST /v1/market/buff/history · GET /v1/market/buff/latest

POST /v1/market/buff/history returns BUFF price history for specific float ranges from May 19, 2026. Each range has separate ask, average-ask, bid, listing-volume, and buy-order-volume data.

An exterior-wide floor can misprice an exact float. A low-float Factory New or low-end Field-Tested item may trade in a BUFF range whose ask is materially different from the base bucket for the same market_hash_name.

How the BUFF float bucket model works#

Every item is split into base, float, fade, and float_fade buckets when those range types apply:

  • The base bucket aggregates the whole item or variant.
  • A float bucket carries numeric float.min and float.max bounds.
  • A float_fade bucket requires both the float and Fade percentage to match.
  • Supported Doppler, Gamma Doppler, and Case Hardened variants have their own bucket lists under variants.

Bounds include min and exclude max. An exact float of 0.18 does not belong to float:0.15:0.18; it belongs to the range beginning at 0.18, if that range exists.

bucket_id is stable across current and historical responses. A variant identifier can combine both identities, such as variant:p2|float:0.00:0.01. This makes the market definition explicit: Phase 2 and the 0.00:0.01 float range must both match.

Query and compare float-range history#

Request the exact base market_hash_name. The response includes every range available for that item, so select by the stable bucket_id discovered through GET /v1/market/buff/latest.

Each historical point carries OHLC for ask, avg_ask, and bid. ask_volume and bid_volume are the last observed values in the interval. The endpoint supports 30m, 1h, and 1d, and the underlying BUFF range data refreshes every 10 minutes.

To calculate a float premium, compare the range's close_ask with the base bucket's close_ask at the same UTC bucket. For a variant float premium, compare against that variant's base bucket. Comparing with the parent item would mix the variant premium into the float premium.

Applicable endpoints#

Endpoint Returns Plans
POST /v1/market/buff/history Float and combined-range OHLC from May 19, 2026 Scale, Enterprise
GET /v1/market/buff/latest Current range catalog, prices, and stable bucket IDs All plans

Analysis boundaries#

  • BUFF ranges vary by item, exterior, float cap, and variant. Discover the returned catalog instead of deriving buckets from the wear label.
  • bucket marks the UTC interval boundary. open_time and close_time show the real observation window and should be retained when sparse coverage would affect the comparison.
  • The range ask is a listing floor rather than a completed-sale price. A persistent premium shows that the active market stayed higher; it does not prove buyers completed sales at that premium.
  • History before May 19, 2026 is unavailable for these BUFF range buckets. The broader BUFF163 archive guide covers base-market history from 2023, without float-range detail.