市场数据
GET /v1/prices — 按商品组的 CS2 minAsk 价格列表
按市场哈希名称、磨损以及多普勒相位分组,分页获取 minAsk 价格快照,每行包含最低报价和挂单数量。
GET
minAsk price list
prices 端点返回 CSBoard 市场的分组价格快照。每一行代表
market_hash_name、wear 与 doppler_phase 的一个唯一组合,并附带当前最低报价以及挂单的数量。这使其非常适合用于构建比价表、告警管道或资产估值——您可以为成千上万的商品获取价格而无需拉取每条挂单。
需要身份验证。 请将密钥作为 Authorization: Bearer csb_pub_... 发送。
查询参数
string
对
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 之一。string
按稀有度档位过滤,例如
Classified、Covert。number
最低
min_price_usd,单位美元(含)。number
最高
min_price_usd,单位美元(含)。string
键集分页游标。传入上一次响应中的
next_cursor 值。integer
默认值:"100"
每页行数。最小
1,最大 500。响应字段
PriceRow[]
必填
本页的价格行数组。
string | null
必填
下一页的键集游标。在下一次请求时作为
cursor 传入。最后一页为 null。示例请求
示例响应
错误代码
授权
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.
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.
e.g. Rifle, Knife, Gloves.
Item wear bucket.
可用选项:
Factory New, Minimal Wear, Field-Tested, Well-Worn, Battle-Scarred e.g. Classified, Covert.
Minimum price in USD.
Maximum price in USD.
Keyset cursor from next_cursor.
1–500. Default 100.
必填范围:
1 <= x <= 500