---
title: "Get Buff163 float-ranged prices (Pro)"
method: GET
path: "/v1/prices/buff163/float-ranged"
tags: ["Float Ranged"]
---

# Get Buff163 float-ranged prices (Pro)

`GET /v1/prices/buff163/float-ranged`

## Request

- Base URL: `https://api.cspriceapi.com`
- URL: `https://api.cspriceapi.com/v1/prices/buff163/float-ranged`
- Auth: API key in header `x-api-key`

Buff163 listing prices per float range, Fade % range, Doppler phase and
pattern tier: lowest listing (`price_rmb`), average of the 10 cheapest
listings and the real listing count in that range.

Ranges are Buff's fixed buckets (e.g. `0.15-0.18`, the same buckets as
`/v2/prices/float-ranged`). Fade skins come as a matrix of float and
Fade ranges; `null` marks the axis that is not limited. `price_rmb` is
`null` when nothing is listed in that range right now.

`phase` holds Doppler / Gamma Doppler phases, `tier` pattern tiers
(`T1`–`T4` Case Hardened / Heat Treated, `T1`–`T10` Marble Fade,
`T1`–`T6` Crimson Kimono). Without `market_hash_name` the response
covers ~77,000 ranges for ~15,700 skins (use `Accept-Encoding: gzip`).
Data refreshes about every 10 minutes.

## Query parameters

- `market_hash_name` string

## Response `200`

Successful response with Buff163 float-ranged listing prices.

- BuffFloatRangedResponse: Envelope fields returned by every `GET /v1/prices/*` response.
  - `source` 'Buff163', required: Human-readable marketplace identifier.
  - `requestor` string, email: Email address associated with the API key making the call.
  - `plan` string: Plan of the API key (e.g. `free`, `pro`, `enterprise`).
  - `timestamp` string, date-time, required: ISO-8601 UTC timestamp (millisecond precision).
  - `data` BuffFloatRangedItem[], required
    - `market_hash_name` string
    - `goods_id` integer: Buff goods_id.
    - `float_range` string, nullable: Float bucket, e.g. "0.15-0.18"; null = all floats.
    - `fade_range` string, nullable: Fade % bucket, e.g. "97-99"; null = all fades.
    - `phase` string, nullable: Doppler / Gamma Doppler phase.
    - `tier` string, nullable: Pattern tier ("T1"–"T10").
    - `count` integer: Listings in this range.
    - `price_rmb` string: Fixed-point decimal value serialized as a string (preserves precision across languages). Parse with an arbitrary-precision decimal library; do **not** parse as a native float.
    - `avg_top10_price_rmb` string: Fixed-point decimal value serialized as a string (preserves precision across languages). Parse with an arbitrary-precision decimal library; do **not** parse as a native float.
    - `updated_at` string, date-time: ISO-8601 UTC timestamp (millisecond precision).

## Other responses

- `400`: Too many market_hash_name values.
- `401`: Missing, invalid, disabled or expired API key.
- `403`: The API key is valid but is not allowed to call this endpoint (endpoint ACL).
- `429`: Rate limit exceeded (10 requests per second per key). Retry after 1 second.
- `500`: Internal server error – temporary upstream failure, etc.

---

[API](https://skmtc.dev/cspriceapi/apis/cs-price-api.md) · [All operations](https://skmtc.dev/cspriceapi/apis/cs-price-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cspriceapi/apis/cs-price-api/revisions/4a18a7641dad?raw)