跳转到主要内容
GET
/
prices
minAsk price list
curl --request GET \
  --url https://csboard.com/v1/prices \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "wear": "Field-Tested",
      "doppler_phase": null,
      "min_price_usd": 11.92,
      "qty": 73
    }
  ],
  "next_cursor": null
}
prices 端点返回 CSBoard 市场的分组价格快照。每一行代表 market_hash_name、wear 与 doppler_phase 的一个唯一组合，并附带当前最低报价以及挂单的数量。这使其非常适合用于构建比价表、告警管道或资产估值——您可以为成千上万的商品获取价格而无需拉取每条挂单。 需要身份验证。 请将密钥作为 Authorization: Bearer csb_pub_... 发送。

​
查询参数

​
search
string
对 market_hash_name 进行全文匹配，例如 AK-47 | Redline。
​
category
string
按商品类别过滤，例如 Rifle、Knife、Gloves。
​
wear
string
按磨损档位过滤。可选值：Factory New、Minimal Wear、Field-Tested、Well-Worn、Battle-Scarred 之一。
​
rarity
string
按稀有度档位过滤，例如 Classified、Covert。
​
min_price
number
最低 min_price_usd，单位美元（含）。
​
max_price
number
最高 min_price_usd，单位美元（含）。
​
cursor
string
键集分页游标。传入上一次响应中的 next_cursor 值。
​
limit
integer
默认值:"100"
每页行数。最小 1，最大 500。

​
响应字段

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

​
示例请求

curl "https://csboard.com/v1/prices?category=Rifle&wear=Field-Tested&limit=50" \
  -H "Authorization: Bearer csb_pub_..."

​
示例响应

{
  "items": [
    {
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "wear": "Field-Tested",
      "doppler_phase": null,
      "min_price_usd": 11.92,
      "qty": 73
    }
  ],
  "next_cursor": null
}

​
错误代码

HTTP 状态码代码含义
401unauthorizedAPI 密钥缺失或无效。
429rate_limit_exceeded超过 30 次/分钟。请在重试前等待 Retry-After 响应头中的秒数。
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.

查询参数

​
search
string

Full-text match on market hash name.

​
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
必填