GET /v1/listings — 浏览实时的 CS2 市场挂单
获取实时可购买的 CS2 饰品挂单,包含磨损、印花种子、贴纸以及美元报价。可按磨损、类别、稀有度、磨损范围等过滤。
Authorization: Bearer csb_pub_... 发送。
查询参数
market_hash_name 进行模糊匹配 —— 将查询拆分为多个词,并对每个词进行子串匹配,非常适合探索。注意:如果某个名称是更长商品名称的词子集(例如 Spectrum Case 与 Spectrum 2 Case),则无法通过此方式单独筛选。要查询单个特定商品,请使用 name。market_hash_name(不区分大小写)。获取某个特定商品列表的精确方式 —— name=Spectrum Case 仅返回 Spectrum Case,绝不会返回 Spectrum 2 Case。当同时提供时,优先于 search。Rifle、Knife、Gloves、Pistol。Factory New、Minimal Wear、Field-Tested、Well-Worn、Battle-Scarred 之一。Classified、Covert、Extraordinary。0.0 到 1.0 之间的值。0.0 到 1.0 之间的值。only 仅返回 StatTrak™ 商品;exclude 将其从结果中移除。only 仅返回纪念品商品;exclude 将其从结果中移除。sort=newest 搭配使用时,通常的响应是一个空页面,这正是让频繁轮询变得廉价、而不是每次都全量重扫的原因。请将水位线回退约 60 秒,并按 id 去重。 请发送 max(listed_at) - 60s,而不是那个裸的最大值。时间戳取自发布该挂单的数据库事务的开始时刻,因此一个大批次可能提交出时间戳更早的行,而一个更小、更晚的批次却已经提交完毕;把水位线精确推进到最大值,会永久跳过这些挂单。id(稳定的默认值)、newest、price_asc、price_desc 之一。newest 按 listed_at 排序,因此重新上架的商品会与真正的新库存一起浮现。next_cursor 值以获取下一页。1,最大 200。响应字段
cursor 查询参数传入以获取下一页。最后一页为 null。分页
此端点使用键集分页。要遍历所有页面:- 发起初始请求(不带
cursor)。 - 如果
next_cursor非空,则携带cursor=<next_cursor>重复请求。 - 当
next_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.
Minimum float value.
Maximum float value.
Delivery bucket, the same three the site's grid shows. instant = bot fulfilment (seconds to minutes); up_to_12h = a human seller on the source market must send the trade; hold = inside a Steam trade lock until the item's tradable_at. Any other value is a 400.
instant, up_to_12h, hold Only listings whose refund_percent is at least this (0-100). Listings with no published figure are EXCLUDED, not assumed. Combine with delivery=instant for a pool that ships now and is fully refundable on a Steam reversal.
0 <= x <= 100Filter StatTrak™ items.
only, exclude Filter Souvenir items.
only, exclude ISO-8601 timestamp. Returns only listings that entered the catalogue after it — the delta-poll parameter. Pair with sort=newest; the usual response is an empty page, which is what makes frequent polling cheap instead of a full rescan every tick.
Overlap your watermark by ~60 seconds and dedupe by id. Send max(listed_at) - 60s, never the bare maximum. Timestamps come from the start of the database transaction that published the listing, so a large batch can commit rows stamped earlier than rows a smaller, later batch already committed; a watermark advanced to the exact maximum steps over those listings permanently.
Sort order. Default id. newest orders by listed_at (when the item entered the catalogue), so re-listings surface too.
id, newest, price_asc, price_desc Keyset cursor from next_cursor.
1–200. Default 50.
1 <= x <= 200