GET /v1/market/buff/latest

On this page

Access
What range types does BUFF expose?
How do float and fade ranges work?
Prices and volumes
Supported sources
Request
Response
Response fields
Errors

Returns current BUFF bid/ask prices for every item, split into float ranges, fade ranges, and variant ranges.

This endpoint's prices update every 10 minutes.

Access#

Available on all plans (Developer, Scale, Enterprise).

What range types does BUFF expose?#

Each item is split into base, float, fade, and float_fade buckets.

`bucket_type`	Meaning
`base`	Aggregated across the entire item or variant.
`float`	Float range. `float.min` and `float.max` describe the range.
`fade`	Fade percentage range. `fade.min` and `fade.max` describe the range.
`float_fade`	Combined float range and fade range.

Items with Doppler phases or Case Hardened tiers can include variants; see Response Format. Each variant has its own ranges in buckets[].

How do float and fade ranges work?#

Range boundaries are inclusive on min, exclusive on max. bucket_id is stable across latest and history.

Float ranges vary by item, exterior, and float cap.

You can find typical float range sets below:

Exterior	Common BUFF float ranges
Factory New	`0:0.01`, `0.01:0.02`, `0.02:0.03`, `0.03:0.04`, `0.04:0.07`
Minimal Wear	`0.07:0.08`, `0.08:0.09`, `0.09:0.10`, `0.10:0.11`, `0.11:0.15`
Field-Tested	`0.15:0.18`, `0.18:0.21`, `0.21:0.24`, `0.24:0.27`, `0.27:0.38`
Well-Worn	`0.38:0.39`, `0.39:0.40`, `0.40:0.41`, `0.41:0.42`, `0.42:0.45`
Battle-Scarred	Commonly `0.45:0.50`, `0.50:0.63`, `0.63:0.76`, `0.76:0.90`, `0.90:1`

Fade ranges use fade percentage, not float. Fade items may have fade ranges and combined float_fade ranges.

Prices and volumes#

Field	Meaning
`ask`	Lowest listing price in the range, USD.
`avg_ask`	Average listing price in the range, USD.
`bid`	Highest buy order in the range, USD.
`ask_volume`	Listings currently in the range.
`bid_volume`	Active buy orders for the range.

Supported sources#

Source	Fields
`buff`	`ask`, `avg_ask`, `bid`, `ask_volume`, `bid_volume`

Request#

GETapi.cs2.sh/v1/market/buff/latest

curl https://api.cs2.sh/v1/market/buff/latest \
  -H "Authorization: Bearer <<YOUR_API_KEY>>" \
  -H "Accept-Encoding: gzip" --compressed

Response#

json

{
  "response_time": "2026-05-19T18:40:53.334Z",
  "currency": "USD",
  "items": {
    "AK-47 | Case Hardened (Field-Tested)": {
      "market_hash_name": "AK-47 | Case Hardened (Field-Tested)",
      "buckets": [
        {
          "bucket_id": "base",
          "bucket_type": "base",
          "updated_at": "2026-05-19T18:36:34Z",
          "collected_at": "2026-05-19T18:40:53.334Z",
          "ask": 205.2,
          "avg_ask": 209.69,
          "bid": 197.06,
          "ask_volume": 1033,
          "bid_volume": 22
        },
        {
          "bucket_id": "float:0.15:0.18",
          "bucket_type": "float",
          "float": {
            "min": 0.15,
            "max": 0.18
          },
          "updated_at": "2026-05-19T18:36:34Z",
          "collected_at": "2026-05-19T18:40:53.334Z",
          "ask": 220.44,
          "avg_ask": 229.78,
          "bid": 197.06,
          "ask_volume": 231,
          "bid_volume": 9
        }
      ]
    },
    "★ M9 Bayonet | Doppler (Factory New)": {
      "market_hash_name": "★ M9 Bayonet | Doppler (Factory New)",
      "variants": {
        "Phase 2": {
          "market_hash_name": "★ M9 Bayonet | Doppler (Factory New)",
          "name": "★ M9 Bayonet | Doppler (Factory New) | Phase 2",
          "display_name": "Phase 2",
          "version": "p2",
          "buckets": [
            {
              "bucket_id": "variant:p2",
              "bucket_type": "base",
              "updated_at": "2026-05-19T18:36:34Z",
              "collected_at": "2026-05-19T18:40:53.334Z",
              "ask": 1286.62,
              "avg_ask": 1313.06,
              "bid": 1239.71,
              "ask_volume": 296,
              "bid_volume": 23
            },
            {
              "bucket_id": "variant:p2|float:0.00:0.01",
              "bucket_type": "float",
              "float": {
                "min": 0,
                "max": 0.01
              },
              "updated_at": "2026-05-19T18:36:34Z",
              "collected_at": "2026-05-19T18:40:53.334Z",
              "ask": 1352.94,
              "avg_ask": 1402.72,
              "bid": 1239.71,
              "ask_volume": 68,
              "bid_volume": 27
            }
          ]
        }
      }
    }
  }
}

Returns a BUFFMarketFloatLatestResponse object. See Objects for the full shape.

Response fields#

Each item holds ranges in buckets[]; variants nest under variants. Each entry carries range identity (bucket_id, bucket_type, float/fade), price and volume fields, and updated_at/collected_at.

Field	Appears on
`bucket_id`, `bucket_type`, `updated_at`, `collected_at`	All returned ranges
`float`	`float` and `float_fade` ranges
`fade`	`fade` and `float_fade` ranges

Full schemas: BUFFMarketFloatItem, BUFFMarketFloatLatestBucket, BUFFMarketFloatRange, BUFFMarketFloatVariant.

Errors#

This endpoint returns the full snapshot.

Status	When
`401` / `403`	Missing key, invalid key, or plan access.
`429`	Rate-limited.
`503` / `5xx`	Snapshot unavailable or server-side issue.