Skip to main content

游戏:CS2 与 Rust

核心读取接口(价格、挂单、价格历史、NBBO、挂单深度、饰品搜索、流动性、饰品 schema、市场健康状态)提供按游戏区分的 /v2 版本,同时覆盖 CS2 与 Rust。DTO、认证与配额完全相同,只多一个必填的 game 参数。

所有 /v1 路由都对应 CS2,行为与各接口页面的说明完全一致。下表中的路由另有同时服务两款游戏的 /v2 版本:响应结构相同,Authorization 请求头相同,套餐功能与配额也相同。唯一的契约变化是一个必填查询参数:game=cs2 或 game=rust(其他任何值返回 400)。所有现有套餐均包含 Rust 访问权限,没有单独的 Rust 附加项;CS2 与 Rust 调用从账号下所有密钥共享的同一份每分钟与每月配额中扣减。

按游戏区分的路由

GET /v2/pricing/:marketHashNamebasic_pricing
GET /v2/pricing/:marketHashName/listingsbasic_pricing
GET /v2/pricing/:marketHashName/historyhistorical_data
GET /v2/pricing/:marketHashName/history/marketshistorical_data
GET /v2/nbbobasic_pricing
GET /v2/nbbo/depthbasic_pricing
GET /v2/itemsbasic_pricing
GET /v2/liquidity/:marketHashNameliquidity_metrics
GET /v2/liquidity/summary/:marketHashNameliquidity_metrics
POST /v2/liquidity/batchliquidity_metrics
GET /v2/schemabasic_pricing
GET /v2/schema/items/:idOrNamebasic_pricing
GET /v2/schema/changesbasic_pricing
GET /v2/markets/health无:无需密钥,位于 https://api.skinpricer.com

/v2/items 支持 search、markets、page 与 perPage,页码范围 1 到 10,000,每页最多 100 件饰品。搜索文本最长 512 个字符(拒绝控制字符与双向文本控制字符);市场过滤最多 32 个名称,每个最长 64 个字符。没有 /v2/items/all 路由:请分页遍历 /v2/items;Enterprise 套餐也可以通过 /v2/prices/latest 一次获取全部饰品。/v2/schema/changes 的游标与签发时所属的游戏绑定,不能跨游戏复用。Rust 流动性依据同时公开 Rust 挂单簿与成交记录的市场估算。/v2/markets/health?game=rust 是按游戏区分的市场健康状态读取,与 v1 路由一样无需密钥。未列在此处的接口(套利、定价建议、属性价格、buff163 分桶、市场分析、批量流动性快照)尚无游戏版本,仍通过 /v1 仅提供 CS2 数据。

Rust 注意事项

Rust 饰品没有 CS2 的磨损语义:没有外观等级、磨损值、模板、StatTrak 或纪念品版本。属性/磨损类接口仅支持 CS2;Rust 挂单上的逐件磨损字段(floatValue、paintSeed、paintIndex、印花)始终为 null 或空,见 null 与部分数据。Rust 饰品以其原始 market hash name(即饰品的显示名称)标识,例如 market_hash_name=Big Grin。

对挂单稀少的 Rust 饰品,各市场等权计算的 medianPrice 可能与任何可成交价格相去甚远(参与市场少,在售价分散大)。用于展示与告警时,请优先使用价格历史分桶中的 bestAskCents / bestBidCents 以及 NBBO 的 bestAsk / bestBid,即盘口中可实际成交的一侧。

错误与可用性

400game 值无效,或输入无效(见上文的搜索、页码与市场限制)。
404未知饰品,或在路由需要价格数据时没有可用价格。
409饰品选择器有歧义,请把名称写得更精确。
503Rust 读取已被关闭(灰度发布开关)。认证与功能校验先于此执行,因此 503 表示你的密钥与套餐均正常,请稍后重试。
401 / 403 / 429与所有需要密钥的路由相同的认证、功能与配额语义,见错误与状态码。

第一次 Rust 调用

携带常规的 Authorization: ApiKey <key> 请求头调用 GET /v2/nbbo?game=rust&market_hash_name=Big%20Grin,返回与 /v1/nbbo 相同的 NBBO 结构。换成 game=cs2,同一路由即可服务你现有的 CS2 调用:一次集成,两款游戏。

TypeScript SDK 目前封装的是 v1(CS2)路由;按游戏区分的 SDK 方法将在后续 SDK 版本中提供。在此之前,请如上所示直接通过 HTTP 调用 /v2 版本,其响应类型与对应的 v1 接口完全相同。

使用此端点的指南(英文)

使用与许可

API 及其数据的使用受我们的服务条款(英文)约束:不得转售或再分发数据,不得用于构建竞争性服务, 不得超出套餐的速率限制;在条款允许展示数据的场景下须注明数据来源为 SkinPricer。滥用行为可能被限流或封禁。