Skip to main content
GET
minAsk price list
prices 端点返回 CSBoard 市场的分组价格快照。每一行代表 market_hash_name、wear 与 doppler_phase 的一个唯一组合,并附带当前最低报价以及挂单的数量。这使其非常适合用于构建比价表、告警管道或资产估值——您可以为成千上万的商品获取价格而无需拉取每条挂单。 需要身份验证。 请将密钥作为 Authorization: Bearer csb_pub_... 发送。
传入 appId=570 读取 Dota 2,传入 appId=252490 读取 Rust。对这些游戏,每行对应一个 market_hash_name,wear 和 doppler_phase 为 null。参见游戏。每个名称只需要一个价格?GET /v1/public/prices 无需密钥即可使用。

查询参数

integer
默认值:"730"
要读取的游戏:730 = CS2,570 = Dota 2,252490 = Rust。不传则为 CS2。您的密钥可用的游戏请参见 GET /v1/games。
对 market_hash_name 进行模糊匹配 —— 将查询拆分为多个词,并对每个词进行子串匹配。如果某个名称是更长商品名称的词子集(例如 Spectrum Case 与 Spectrum 2 Case),则无法通过此方式单独筛选;要精确查询,请使用 name。
string
精确的 market_hash_name(不区分大小写)—— 单个商品的精确查询方式。name=Spectrum Case 仅返回 Spectrum Case 组,绝不会返回 Spectrum 2 Case。优先于 search。
string
按商品类别过滤,例如 Rifle、Knife、Gloves。
string
按磨损档位过滤。可选值:Factory New、Minimal Wear、Field-Tested、Well-Worn、Battle-Scarred 之一。仅限 CS2——在其他 appId 下发送会返回 400 invalid_param。
string
按稀有度档位过滤,例如 Classified、Covert。
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.

查询参数

appId
enum<integer>
默认值:730

Steam appId of the game. 730 = CS2 (the default), 570 = Dota 2, 252490 = Rust. Omit it and the endpoint answers for CS2 exactly as before. An appId this key may not use answers 400 unsupported_game, whose supported_app_ids lists the ones it may — see GET /games.

可用选项:
730,
570,
252490

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. CS2 only — sent with another appId it answers 400 invalid_param.

可用选项:
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
必填