游戏:CS2 与 Rust
核心读取接口(价格、挂单、价格历史、NBBO、挂单深度、饰品搜索、流动性、饰品 schema、市场健康状态)提供按游戏区分的 /v2 版本,同时覆盖 CS2 与 Rust。DTO、认证与配额完全相同,只多一个必填的 game 参数。
所有 /v1 路由都对应 CS2,行为与各接口页面的说明完全一致。下表中的路由另有同时服务两款游戏的 /v2 版本:响应结构相同,Authorization 请求头相同,套餐功能与配额也相同。唯一的契约变化是一个必填查询参数:game=cs2 或 game=rust(其他任何值返回 400)。所有现有套餐均包含 Rust 访问权限,没有单独的 Rust 附加项;CS2 与 Rust 调用从账号下所有密钥共享的同一份每分钟与每月配额中扣减。
按游戏区分的路由
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,即盘口中可实际成交的一侧。
错误与可用性
game 值无效,或输入无效(见上文的搜索、页码与市场限制)。第一次 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 接口完全相同。