GET /v1/listings — 浏览实时的 CS2 市场挂单
获取实时可购买的 CS2 饰品挂单，包含磨损、印花种子、贴纸以及美元报价。可按磨损、类别、稀有度、磨损范围等过滤。
curl --request GET \
--url https://csboard.com/v1/listings \
--header 'Authorization: Bearer <token>'import requests
url = "https://csboard.com/v1/listings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://csboard.com/v1/listings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://csboard.com/v1/listings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://csboard.com/v1/listings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://csboard.com/v1/listings")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://csboard.com/v1/listings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_bodyAuthorization: Bearer csb_pub_... 发送。
appId=570 读取 Dota 2，传入 appId=252490 读取 Rust。这些行的键名相同；仅 CS2 才有的字段（wear、doppler_phase、float_value、paint_seed、inspect_link、tradable_at、listed_at）为 null，stickers 为 []。参见游戏。查询参数
730 = CS2，570 = Dota 2，252490 = Rust。不传则为 CS2。您的密钥可用的游戏请参见 GET /v1/games。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 之一。仅限 CS2——在其他 appId 下发送会返回 400 invalid_param。Classified、Covert、Extraordinary。0.0 到 1.0 之间的值。仅限 CS2——在其他 appId 下发送会返回 400 invalid_param。0.0 到 1.0 之间的值。仅限 CS2——在其他 appId 下发送会返回 400 invalid_param。instant— 机器人交付。几秒到几分钟。up_to_12h— 需要来源市场上的真人卖家发起交易。网站上显示为 ≤12 小时。hold— 处于 Steam 交易锁定期，直到物品的tradable_at。
delivery=instant——提现、机器人派发、正在屏幕前等待的用户。其他任何值都会返回 400，因此拼写错误会直接报错，而不会悄悄扩大结果范围。refund_percent 不低于该值（0–100）的挂单。没有公布数值的挂单会被排除，而不会被默认视为符合条件。?delivery=instant&min_refund_percent=100 正是提现流程需要的商品池：立即发货，且 Steam 交易回滚不会让任何人蒙受损失。only 仅返回 StatTrak™ 商品；exclude 将其从结果中移除。仅限 CS2——在其他 appId 下发送会返回 400 invalid_param。only 仅返回纪念品商品；exclude 将其从结果中移除。仅限 CS2——在其他 appId 下发送会返回 400 invalid_param。sort=newest 搭配使用时，通常的响应是一个空页面，这正是让频繁轮询变得廉价、而不是每次都全量重扫的原因。请将水位线回退约 60 秒，并按 id 去重。 请发送 max(listed_at) - 60s，而不是那个裸的最大值。时间戳取自发布该挂单的数据库事务的开始时刻，因此一个大批次可能提交出时间戳更早的行，而一个更小、更晚的批次却已经提交完毕；把水位线精确推进到最大值，会永久跳过这些挂单。仅限 CS2——在其他 appId 下发送会返回 400 invalid_param。id（稳定的默认值）、newest、price_asc、price_desc 之一。newest 按 listed_at 排序，因此重新上架的商品会与真正的新库存一起浮现。newest 仅限 CS2——在其他 appId 下使用会返回 400 invalid_param。next_cursor 值以获取下一页。1，最大 200。响应字段
显示 Listing object
显示 Listing object
POST /v1/orders 以购买该商品。AK-47 | Redline (Minimal Wear)。Factory New、Minimal Wear、Field-Tested、Well-Worn 或 Battle-Scarred。对于不带磨损的商品（如部分匕首或手套）为 null。"Phase 2"、"Ruby"、"Emerald"。非多普勒商品为 null。0.0 和 1.0 之间。不适用时为 null。null。POST /v1/orders 购买该挂单，扣除的金额就是这个数值。Rifle、Knife、Gloves。Classified、Covert。steam://rungame/...）。false 表示处于交易冻结期。null。instant（机器人，几秒到几分钟）、up_to_12h（需要来源市场上的真人卖家发起交易）或 hold（处于 Steam 交易锁定期，直到 tradable_at）。null 表示该挂单没有公布的数值——请视为未知，切勿当作 100。使用 min_refund_percent 过滤，可构建一个每件物品都能得到全额补偿的商品池。available_after 的值。cursor 查询参数传入以获取下一页。最后一页为 null。分页
此端点使用键集分页。要遍历所有页面：- 发起初始请求（不带
cursor）。 - 如果
next_cursor非空，则携带cursor=<next_cursor>重复请求。 - 当
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",
"refund_percent": 100,
"listed_at": "2026-06-29T08:41:17.000Z"
}
],
"next_cursor": "eyJpZCI6Iml0bV84ODQxMjAxIn0="
}
错误代码
| HTTP 状态码 | 代码 | 含义 |
|---|---|---|
| 400 | invalid_param | 参数格式错误，或在其他 appId 下发送了仅限 CS2 的过滤参数。 |
| 400 | unsupported_game | 您的密钥无法使用该 appId。supported_app_ids 列出了可用的值。 |
| 401 | missing_api_key, invalid_api_key | API 密钥缺失或无效。 |
| 429 | rate_limit_exceeded | 超过该密钥的每分钟限额（默认 100 次/分钟）。请按照 Retry-After 响应头中的秒数退避。 |
price_usd 是权威购买价格——它反映了查询时刻的实时报价，也正是您将被扣除的金额。请不要将 /prices 端点中的 min_price_usd 用作购买价格估算；该值可能滞后。授权
Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.
查询参数
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.
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. CS2 only — sent with another appId it answers 400 invalid_param.
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. CS2 only — sent with another appId it answers 400 invalid_param.
Maximum float value. CS2 only — sent with another appId it answers 400 invalid_param.
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. CS2 only — sent with another appId it answers 400 invalid_param.
only, exclude Filter Souvenir items. CS2 only — sent with another appId it answers 400 invalid_param.
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. CS2 only — sent with another appId it answers 400 invalid_param.
Sort order. Default id. newest orders by listed_at (when the item entered the catalogue), so re-listings surface too. newest is CS2 only — with another appId it answers 400 invalid_param.
id, newest, price_asc, price_desc Keyset cursor from next_cursor.
1–200. Default 50.
1 <= x <= 200curl --request GET \
--url https://csboard.com/v1/listings \
--header 'Authorization: Bearer <token>'import requests
url = "https://csboard.com/v1/listings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://csboard.com/v1/listings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://csboard.com/v1/listings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://csboard.com/v1/listings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://csboard.com/v1/listings")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://csboard.com/v1/listings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body