跳转到主要内容
GET
/
listings
Live buyable listings
curl --request GET \
  --url https://csboard.com/v1/listings \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "itm_8841201",
      "market_hash_name": "AK-47 | Redline (Minimal Wear)",
      "wear": "Minimal Wear",
      "doppler_phase": null,
      "float_value": 0.0912,
      "paint_seed": 412,
      "stickers": [
        {
          "name": "Crown (Foil)",
          "image": "https://cdn.csboard.com/stickers/crown_foil.png",
          "slot": 0,
          "wear": 0
        }
      ],
      "price_usd": 14.37,
      "category": "Rifle",
      "rarity": "Classified",
      "image": "https://cdn.csboard.com/items/ak47_redline_mw.png",
      "inspect_link": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20...",
      "tradable": false,
      "tradable_at": "2026-07-06T12:00:00Z",
      "delivery": "hold"
    }
  ],
  "next_cursor": "eyJpZCI6Iml0bV84ODQxMjAxIn0="
}
listings 端点公开了 CSBoard 市场上当前所有可购买的商品。每条记录都包含您进行评估所需的完整检视数据——磨损值、印花种子、已贴贴纸及其磨损——以及美元的权威报价。结果通过键集游标分页，即便不断有新挂单出现，您也能可靠地遍历整个目录。 需要身份验证。 请将密钥作为 Authorization: Bearer csb_pub_... 发送。

​
查询参数

​
search
string
对商品的 market_hash_name 进行全文匹配，例如 AK-47 | Redline。
​
category
string
按商品类别过滤，例如 Rifle、Knife、Gloves、Pistol。
​
wear
string
按磨损档位过滤。可选值：Factory New、Minimal Wear、Field-Tested、Well-Worn、Battle-Scarred 之一。
​
rarity
string
按稀有度档位过滤，例如 Classified、Covert、Extraordinary。
​
min_price
number
最低报价，单位美元（含）。
​
max_price
number
最高报价，单位美元（含）。
​
min_float
number
最小磨损值（含）。接受 0.0 到 1.0 之间的值。
​
max_float
number
最大磨损值（含）。接受 0.0 到 1.0 之间的值。
​
stat_trak
string
StatTrak™ 过滤。only 仅返回 StatTrak™ 商品；exclude 将其从结果中移除。
​
souvenir
string
纪念品过滤。only 仅返回纪念品商品；exclude 将其从结果中移除。
​
sort
string
默认值:"id"
排序方式。可选值：id（稳定的默认值）、newest、price_asc、price_desc 之一。
​
cursor
string
键集分页游标。传入上一次响应中的 next_cursor 值以获取下一页。
​
limit
integer
默认值:"50"
每页结果数。最小 1，最大 200。

​
响应字段

​
items
Listing[]
必填
本页的挂单对象数组。
​
next_cursor
string | null
必填
不透明的键集游标。将其作为 cursor 查询参数传入以获取下一页。最后一页为 null。

​
分页

此端点使用键集分页。要遍历所有页面：
  1. 发起初始请求（不带 cursor）。
  2. 如果 next_cursor 非空，则携带 cursor=<next_cursor> 重复请求。
  3. 当 next_cursor 为 null 时停止——您已到达最后一页。
键集分页是稳定的：在遍历期间新出现的挂单不会导致重复或跳行。

​
示例请求

curl "https://csboard.com/v1/listings?category=Rifle&wear=Minimal+Wear&min_float=0.07&max_float=0.12&sort=price_asc&limit=20" \
  -H "Authorization: Bearer csb_pub_..."

​
示例响应

{
  "items": [
    {
      "id": "itm_8841201",
      "market_hash_name": "AK-47 | Redline (Minimal Wear)",
      "wear": "Minimal Wear",
      "doppler_phase": null,
      "float_value": 0.0912,
      "paint_seed": 412,
      "stickers": [
        {
          "name": "Crown (Foil)",
          "image": "https://cdn.csboard.com/stickers/crown_foil.png",
          "slot": 0,
          "wear": 0.0
        }
      ],
      "price_usd": 14.37,
      "category": "Rifle",
      "rarity": "Classified",
      "image": "https://cdn.csboard.com/items/ak47_redline_mw.png",
      "inspect_link": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20...",
      "tradable": false,
      "tradable_at": "2026-07-06T12:00:00Z",
      "delivery": "hold"
    }
  ],
  "next_cursor": "eyJpZCI6Iml0bV84ODQxMjAxIn0="
}

​
错误代码

HTTP 状态码代码含义
401unauthorizedAPI 密钥缺失或无效。
429rate_limit_exceeded超过 30 次/分钟。请按照 Retry-After 响应头中的秒数退避。
每条挂单上的 price_usd 是权威购买价格——它反映了查询时刻的实时报价，也正是您将被扣除的金额。请不要将 /prices 端点中的 min_price_usd 用作购买价格估算；该值可能滞后。

授权

​
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.

​
min_float
number

Minimum float value.

​
max_float
number

Maximum float value.

​
stat_trak
enum<string>

Filter StatTrak™ items.

可用选项:
only,
exclude
​
souvenir
enum<string>

Filter Souvenir items.

可用选项:
only,
exclude
​
sort
enum<string>
默认值:id

Sort order. Default id.

可用选项:
id,
newest,
price_asc,
price_desc
​
cursor
string

Keyset cursor from next_cursor.

​
limit
integer
默认值:50

1–200. Default 50.

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

响应

A page of listings.

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

Pass back as cursor to fetch the next page. Null on the last page.