NBBO:全市场最优买卖价
单件 CS2 饰品在所有已接入市场上的 NBBO(全市场最优买卖价),附新鲜度元数据、基点价差与置信度评分。可按 id(规范 id)或 market_hash_name 查询,可选用 markets CSV 收窄范围。价格为整数美分。
NBBO 回答一个问题:同时看*所有*市场,现在买入的最优价是多少、卖出的最优价是多少?bestAsk 是全场最低在售价(并标明来源市场);bestBid 是全场最高求购价;两者之间的差就是 spreadBps,以基点计。
并非每件饰品都有双边市场。当没有任何市场存在求购单时,bestBid 与 spreadBps 返回 null——这是正常情况,不是错误(见 null 与部分数据)。confidence(0 到 1)综合了参与市场数量、数据新鲜度与跨市场一致性,可用来对单薄或过期的读数做降权。
locked(求购价 == 在售价)与 crossed(求购价 > 在售价)标记跨市场报价倒挂的罕见时刻,通常是一边的报价先于另一边刷新而过期。若你的策略依赖价差,请据此过滤。
默认情况下 bestBid 只统计可现金变现的市场(Steam 钱包余额与以物易物额度类平台被排除),因此默认的跨市场求购价是真正能变现的价格。传入 markets CSV 则改为逐字采信每个被请求平台的求购价。这也是 /v1/pricing 的 bestBid(统计所有平台)可能与本接口不同的原因,不要假设两者相等。
spreadBps 超过 10000 基点(±100%)时会被置为 null 以剔除垃圾求购价;交叉(负)价差会保留。若要的是可实际执行的价差而非标价价差,请读取可为 null 的 executionAdjusted 块:它在扣除手续费并按可执行性折价后对双边重新定价,并带有自己的 spreadBps 与 executableConfidence。
想要完整的按市场拆解而不只是最优两边?用 /v1/pricing/:marketHashName。想看盘口之下的挂单深度?用 /v1/nbbo/depth。
Parameters
id 二选一(都缺失返回 400)。market_hash_name 二选一(都缺失返回 400)。csfloat,buff163。传入后还会覆盖默认的"仅现金变现市场"的 bestBid 过滤规则:所有被请求平台的求购价将被逐字采信。Response fields
嵌套与共享结构链接到 API Objects 参考页(英文)。
Response 200
{
"marketHashName": "Glock-18 | Water Elemental (Factory New)",
"canonicalItemId": "cmlofca920lka01yozajhixt3",
"bestAsk": {
"market": "csfloat",
"price": 6500,
"updatedAt": "2026-06-23T21:52:27.427Z",
"isStale": false
},
"bestBid": {
"market": "buff163",
"price": 6440,
"updatedAt": "2026-06-23T21:59:48.717Z",
"isStale": false
},
"spreadBps": 93,
"marketCount": 10,
"freshMarketCount": 9,
"locked": false,
"crossed": false,
"confidence": 0.81,
"executionAdjusted": {
"bestAsk": {
"market": "csfloat",
"price": 6500,
"rawPrice": 6500,
"appliedFeeBps": 0,
"executability": 0.92,
"updatedAt": "2026-06-23T21:52:27.427Z",
"isStale": false,
"reasons": []
},
"bestBid": {
"market": "buff163",
"price": 6118,
"rawPrice": 6440,
"appliedFeeBps": 500,
"withdrawalFlatUsdCents": 0,
"executability": 0.74,
"updatedAt": "2026-06-23T21:59:48.717Z",
"isStale": false,
"reasons": ["assumed_fees"]
},
"spreadBps": 624,
"locked": false,
"crossed": false,
"executableConfidence": 0.7,
"reasons": ["assumed_fees"],
"feeModelVersion": "2026-06-01",
"calculatedAt": "2026-06-23T22:07:13.402Z"
},
"calculatedAt": "2026-06-23T22:07:13.395Z"
}Errors
market_hash_name 与 id 均未提供。Authorization 头、认证方案不支持,或密钥未知、未激活、已过期、已吊销。curl "https://pricing.skinpricer.com/v1/nbbo" \
-H "Authorization: ApiKey sk_live_•••••••••••"