GET /v1/market/buff/latest
Returns current BUFF prices for every item, split into float ranges, fade ranges, and combined float/fade ranges. Data updates every 10 minutes.
Use bucket_id to match the same range between this snapshot and BUFF range history.
Access
Available on all plans.
Range types
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 Using the API. Each variant has its own ranges in buckets[].
Range boundaries
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. Fade ranges use fade percentage, not float. Always use the float and fade values returned on the bucket instead of assuming fixed 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. |
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" --compressedResponse
{
"response_time": "2026-07-26T18:54:14.833093145Z",
"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-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 213.23,
"avg_ask": 216.98,
"bid": 203.78,
"ask_volume": 982,
"bid_volume": 31
},
{
"bucket_id": "float:0.15:0.18",
"bucket_type": "float",
"float": {
"min": 0.15,
"max": 0.18
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 218.55,
"avg_ask": 231.47,
"bid": 203.78,
"ask_volume": 219,
"bid_volume": 10
}
],
"variants": {
"Tier 1": {
"market_hash_name": "AK-47 | Case Hardened (Field-Tested)",
"name": "AK-47 | Case Hardened (Field-Tested) | Tier 1",
"display_name": "Tier 1",
"version": "t1",
"buckets": [
{
"bucket_id": "variant:t1",
"bucket_type": "base",
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 1328.96,
"avg_ask": 2218.76,
"bid": 1077.98,
"ask_volume": 78,
"bid_volume": 13
},
{
"bucket_id": "variant:t1|float:0.15:0.18",
"bucket_type": "float",
"float": {
"min": 0.15,
"max": 0.18
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 2584.21,
"avg_ask": 12532.95,
"bid": 1077.98,
"ask_volume": 12,
"bid_volume": 15
},
{
"bucket_id": "variant:t1|float:0.18:0.21",
"bucket_type": "float",
"float": {
"min": 0.18,
"max": 0.21
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 1609.44,
"avg_ask": 14470.85,
"bid": 1079.46,
"ask_volume": 11,
"bid_volume": 23
},
{
"bucket_id": "variant:t1|float:0.21:0.24",
"bucket_type": "float",
"float": {
"min": 0.21,
"max": 0.24
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 2215.04,
"avg_ask": 33480.73,
"bid": 1079.46,
"ask_volume": 9,
"bid_volume": 23
},
{
"bucket_id": "variant:t1|float:0.24:0.27",
"bucket_type": "float",
"float": {
"min": 0.24,
"max": 0.27
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 2953.23,
"avg_ask": 19841.46,
"bid": 1079.46,
"ask_volume": 7,
"bid_volume": 23
},
{
"bucket_id": "variant:t1|float:0.27:0.38",
"bucket_type": "float",
"float": {
"min": 0.27,
"max": 0.38
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 1328.96,
"avg_ask": 3056.22,
"bid": 1079.46,
"ask_volume": 39,
"bid_volume": 16
}
]
},
"Tier 2": {
"market_hash_name": "AK-47 | Case Hardened (Field-Tested)",
"name": "AK-47 | Case Hardened (Field-Tested) | Tier 2",
"display_name": "Tier 2",
"version": "t2",
"buckets": [
{
"bucket_id": "variant:t2",
"bucket_type": "base",
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 389.77,
"avg_ask": 398.86,
"bid": 366.22,
"ask_volume": 235,
"bid_volume": 14
},
{
"bucket_id": "variant:t2|float:0.15:0.18",
"bucket_type": "float",
"float": {
"min": 0.15,
"max": 0.18
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 443.01,
"avg_ask": 521.14,
"bid": 366.22,
"ask_volume": 49,
"bid_volume": 16
},
{
"bucket_id": "variant:t2|float:0.18:0.21",
"bucket_type": "float",
"float": {
"min": 0.18,
"max": 0.21
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 407.57,
"avg_ask": 515.91,
"bid": 366.22,
"ask_volume": 38,
"bid_volume": 17
},
{
"bucket_id": "variant:t2|float:0.21:0.24",
"bucket_type": "float",
"float": {
"min": 0.21,
"max": 0.24
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 394.28,
"avg_ask": 672.67,
"bid": 366.22,
"ask_volume": 18,
"bid_volume": 16
},
{
"bucket_id": "variant:t2|float:0.24:0.27",
"bucket_type": "float",
"float": {
"min": 0.24,
"max": 0.27
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 389.77,
"avg_ask": 449.59,
"bid": 366.22,
"ask_volume": 32,
"bid_volume": 15
},
{
"bucket_id": "variant:t2|float:0.27:0.38",
"bucket_type": "float",
"float": {
"min": 0.27,
"max": 0.38
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 389.85,
"avg_ask": 408.05,
"bid": 366.22,
"ask_volume": 98,
"bid_volume": 15
}
]
},
"Tier 3": {
"market_hash_name": "AK-47 | Case Hardened (Field-Tested)",
"name": "AK-47 | Case Hardened (Field-Tested) | Tier 3",
"display_name": "Tier 3",
"version": "t3",
"buckets": [
{
"bucket_id": "variant:t3",
"bucket_type": "base",
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 216.26,
"avg_ask": 235.87,
"bid": 203.78,
"ask_volume": 295,
"bid_volume": 10
},
{
"bucket_id": "variant:t3|float:0.15:0.18",
"bucket_type": "float",
"float": {
"min": 0.15,
"max": 0.18
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 221.36,
"avg_ask": 252.9,
"bid": 203.78,
"ask_volume": 65,
"bid_volume": 10
},
{
"bucket_id": "variant:t3|float:0.18:0.21",
"bucket_type": "float",
"float": {
"min": 0.18,
"max": 0.21
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 236.12,
"avg_ask": 300.55,
"bid": 203.78,
"ask_volume": 41,
"bid_volume": 10
},
{
"bucket_id": "variant:t3|float:0.21:0.24",
"bucket_type": "float",
"float": {
"min": 0.21,
"max": 0.24
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 233.02,
"avg_ask": 276.7,
"bid": 203.78,
"ask_volume": 41,
"bid_volume": 10
},
{
"bucket_id": "variant:t3|float:0.24:0.27",
"bucket_type": "float",
"float": {
"min": 0.24,
"max": 0.27
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 248.08,
"avg_ask": 288.19,
"bid": 203.78,
"ask_volume": 38,
"bid_volume": 10
},
{
"bucket_id": "variant:t3|float:0.27:0.38",
"bucket_type": "float",
"float": {
"min": 0.27,
"max": 0.38
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 216.26,
"avg_ask": 246.05,
"bid": 203.78,
"ask_volume": 110,
"bid_volume": 10
}
]
},
"Tier 4": {
"market_hash_name": "AK-47 | Case Hardened (Field-Tested)",
"name": "AK-47 | Case Hardened (Field-Tested) | Tier 4",
"display_name": "Tier 4",
"version": "t4",
"buckets": [
{
"bucket_id": "variant:t4",
"bucket_type": "base",
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 213.23,
"avg_ask": 217.52,
"bid": 203.78,
"ask_volume": 362,
"bid_volume": 10
},
{
"bucket_id": "variant:t4|float:0.15:0.18",
"bucket_type": "float",
"float": {
"min": 0.15,
"max": 0.18
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 218.55,
"avg_ask": 233.7,
"bid": 203.78,
"ask_volume": 91,
"bid_volume": 10
},
{
"bucket_id": "variant:t4|float:0.18:0.21",
"bucket_type": "float",
"float": {
"min": 0.18,
"max": 0.21
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 221.5,
"avg_ask": 234.11,
"bid": 203.78,
"ask_volume": 59,
"bid_volume": 10
},
{
"bucket_id": "variant:t4|float:0.21:0.24",
"bucket_type": "float",
"float": {
"min": 0.21,
"max": 0.24
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 213.23,
"avg_ask": 240.46,
"bid": 203.78,
"ask_volume": 41,
"bid_volume": 10
},
{
"bucket_id": "variant:t4|float:0.24:0.27",
"bucket_type": "float",
"float": {
"min": 0.24,
"max": 0.27
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 216.52,
"avg_ask": 267.28,
"bid": 203.78,
"ask_volume": 33,
"bid_volume": 10
},
{
"bucket_id": "variant:t4|float:0.27:0.38",
"bucket_type": "float",
"float": {
"min": 0.27,
"max": 0.38
},
"updated_at": "2026-07-26T18:46:12Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 213.38,
"avg_ask": 220.17,
"bid": 203.78,
"ask_volume": 138,
"bid_volume": 10
}
]
}
}
},
"★ 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-07-26T18:46:27Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 1321.49,
"avg_ask": 1327.42,
"bid": 1281.77,
"ask_volume": 261,
"bid_volume": 22
},
{
"bucket_id": "variant:p2|float:0.00:0.01",
"bucket_type": "float",
"float": {
"min": 0,
"max": 0.01
},
"updated_at": "2026-07-26T18:46:27Z",
"collected_at": "2026-07-26T18:50:54.164Z",
"ask": 1336.26,
"avg_ask": 1365.19,
"bid": 1284.72,
"ask_volume": 60,
"bid_volume": 25
}
]
}
}
}
}
}Response fields
BUFFMarketFloatLatestResponse fields:
| Field | Type | Required | Description |
|---|---|---|---|
response_time | string (date-time) | Yes | When the response was generated. |
currency | string | Yes | Currency code (always USD). |
items | Record<string, BUFFMarketFloatItem> | Yes | Map of market_hash_name to per-item BUFF data. |
Range data
| Field | Description |
|---|---|
items.<name>.buckets[] | The item's price ranges: base, float, fade, and float_fade buckets. |
buckets[].bucket_id, bucket_type | Range identity, stable across latest and history. |
buckets[].float | Float range bounds. Present on float and float_fade ranges. |
buckets[].fade | Fade range bounds. Present on fade and float_fade ranges. |
buckets[].ask, avg_ask, bid, ask_volume, bid_volume | Prices and volumes in the range, with updated_at and collected_at. |
items.<name>.variants | Per-variant ranges in the same shape. |
Full schemas: BUFFMarketFloatItem, BUFFMarketFloatLatestBucket, BUFFMarketFloatRange, BUFFMarketFloatVariant.
Errors
503 service_unavailable means the BUFF range snapshot is not ready. See Request errors for shared errors.