Skip to main content
GET
minAsk price list
prices 端点返回 CSBoard 市场的分组价格快照。每一行代表 market_hash_nameweardoppler_phase 的一个唯一组合,并附带当前最低报价以及挂单的数量。这使其非常适合用于构建比价表、告警管道或资产估值——您可以为成千上万的商品获取价格而无需拉取每条挂单。 需要身份验证。 请将密钥作为 Authorization: Bearer csb_pub_... 发送。

查询参数

market_hash_name 进行模糊匹配 —— 将查询拆分为多个词,并对每个词进行子串匹配。如果某个名称是更长商品名称的词子集(例如 Spectrum CaseSpectrum 2 Case),则无法通过此方式单独筛选;要精确查询,请使用 name
string
精确的 market_hash_name(不区分大小写)—— 单个商品的精确查询方式。name=Spectrum Case 仅返回 Spectrum Case 组,绝不会返回 Spectrum 2 Case。优先于 search
string
按商品类别过滤,例如 RifleKnifeGloves
string
按磨损档位过滤。可选值:Factory NewMinimal WearField-TestedWell-WornBattle-Scarred 之一。
string
按稀有度档位过滤,例如 ClassifiedCovert
number
最低 min_price_usd,单位美元(含)。
number
最高 min_price_usd,单位美元(含)。
string
键集分页游标。传入上一次响应中的 next_cursor 值。
integer
默认值:"100"
每页行数。最小 1,最大 500

响应字段

PriceRow[]
必填
本页的价格行数组。
string | null
必填
下一页的键集游标。在下一次请求时作为 cursor 传入。最后一页为 null

示例请求

示例响应

错误代码

prices 端点返回的是指示性分组快照。该数据是周期性实体化的,可能滞后于实时市场。在下单前,请使用 GET /v1/listings 获取特定商品权威的实时报价。

授权

Authorization
string
header
必填

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.

查询参数

Full-text match on market hash name.

name
string

Exact market_hash_name (case-insensitive) — the precise single-item lookup. Unlike fuzzy search, it isolates one item even when its name is a word-subset of a longer one (e.g. Spectrum Case vs Spectrum 2 Case). Takes precedence over search.

category
string

e.g. Rifle, Knife, Gloves.

wear
enum<string>

Item wear bucket.

可用选项:
Factory New,
Minimal Wear,
Field-Tested,
Well-Worn,
Battle-Scarred
rarity
string

e.g. Classified, Covert.

min_price
number

Minimum price in USD.

max_price
number

Maximum price in USD.

cursor
string

Keyset cursor from next_cursor.

limit
integer
默认值:100

1–500. Default 100.

必填范围: 1 <= x <= 500

响应

A page of price rows.

items
object[]
必填
next_cursor
string | null
必填