---
title: "Get current Buff163 buy-order prices (Pro)"
method: GET
path: "/v1/prices/buff163/buyorder"
tags: ["Buyorder Prices"]
---

# Get current Buff163 buy-order prices (Pro)

`GET /v1/prices/buff163/buyorder`

## Request

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

Returns the highest Buff163 buy order and the number of buy orders for
every tracked skin, including Doppler / Gamma Doppler phases and pattern
tiers as separate rows (e.g. `… (Factory New) (Ruby)`,
`AK-47 | Case Hardened (Factory New) (T1)`).

`buyorder_price` is in CNY and `null` when the skin has no buy order.
For a phase or tier row it is the highest order that would buy that
variant, so general orders without a phase condition count too.
Buff reports this value per item; orders limited to a float range can
be higher and are listed per range in `/v1/prices/buff163/float-buyorder`.
`templateId` is the Buff `goods_id`, `typeId` the Buff tag id of the
phase/tier. Data refreshes about every 10 minutes.

## Response `200`

Successful response with current Buff163 buy orders.

- BuffBuyorderResponse: 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` BuffBuyorderItem[], required
    - `id` integer
    - `market_hash_name` string
    - `templateId` integer: Buff goods_id.
    - `buyorder_price` 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.
    - `phase` string, nullable: Doppler phase or pattern tier ("T1"…), null for plain skins.
    - `typeId` integer, nullable: Buff tag id of the phase/tier.
    - `updated_at` string, date-time: ISO-8601 UTC timestamp (millisecond precision).
    - `count` integer, nullable: Number of buy orders.

## Other responses

- `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)