GET/v1/pricing/:marketHashNameDEVELOPER+

跨市场价格快照

单件 CS2 饰品的完整跨市场价格快照：各市场报价、聚合值（min/max/avg/median/stdDev）、最优买卖价与 NBBO 价差。路径段为 URL 编码的 market_hash_name。所有价格均为整数美分。

这是单件饰品最全面的读取。markets[] 给出每个市场的代表性在售价，buyOrders[] 给出每个有效求购单，aggregate 是对在售价的聚合（min / max / avg / median / stdDev），再加上 bestAsk / bestBid / spreadBps 摘要。注意：这里的 bestBid 取自*所有*平台，而 /v1/nbbo 默认的 bestBid 仅限可现金变现的市场，因此两者可能不同。spreadBps 超过 10000 基点时被置为 null（交叉/负价差会保留）；要看扣费后的执行价格与 executionAdjusted 块，请用 /v1/nbbo。

每个 MarketQuote 同时携带 fetchedAt（市场报告报价的时间）与 ingestedAt（我们采集到的时间）以及 isStale。请据此对旧报价做折价，而不是直接丢弃。quoteSize 是该报价背后的挂单数量。

求购单是稀疏的：只有部分市场有求购侧，因此即使 markets[] 很长，buyOrders[] 也可能很短甚至为空。用 markets CSV 可将响应收窄到特定平台。

Parameters

marketHashNamestringrequired

路径段。URL 编码的 market_hash_name，例如 AK-47%20%7C%20Redline%20(Field-Tested)。

marketsstringoptional

查询参数。用于限定响应范围的市场 id CSV，例如 csfloat,buff163。

Response fields

PricingResponse完整跨市场快照：各市场报价 + 聚合值。

canonicalItemIdstring

SkinPricer 的规范饰品 id。

namestring

饰品的 market hash name。

aggregateAggregatenullable

所有参与市场的汇总统计。当饰品没有任何有价市场时（例如饰品搜索的部分行）可为 null/缺席。

marketsMarketQuote[]

每个有实时在售价的市场一条。

buyOrdersBuyOrder[]

各市场的有效求购单。

bestAskQuotenullable

跨市场最优在售价。

bestBidQuotenullable

跨*所有*平台的最优求购价（与 /v1/nbbo 不同——后者默认将 bestBid 限定为可现金变现的市场），因此可能与 NBBO 的 bestBid 不同。

spreadBpsintegernullable

最优在售价 − 最优求购价，以基点计。缺少任一边时为 null，超过 10000 基点时被置为 null；负（交叉）价差会保留。

marketCountinteger

提供报价的市场数。

freshMarketCountinteger

其中仍新鲜的市场数。

calculatedAtstring (date-time)

快照计算时间。

嵌套与共享结构链接到 API Objects 参考页（英文）。

Response 200

{
  "canonicalItemId": "cmlofca920lka01yozajhixt3",
  "name": "Glock-18 | Water Elemental (Factory New)",
  "aggregate": {
    "minPrice": 6500,
    "maxPrice": 8012,
    "avgPrice": 7102,
    "medianPrice": 7119,
    "stdDev": 439.12,
    "marketCount": 10,
    "freshMarketCount": 9,
    "listingCount": 710,
    "updatedAt": "2026-06-23T21:59:48.717Z"
  },
  "markets": [
    {
      "market": "csfloat",
      "price": 6500,
      "currency": "USD",
      "fetchedAt": "2026-06-23T21:52:27.427Z",
      "ingestedAt": "2026-06-23T21:55:56.923Z",
      "quoteSize": 132,
      "ingestLatencyMs": 209496,
      "isStale": false
    }
  ],
  "buyOrders": [
    {
      "market": "buff163",
      "price": 6440,
      "currency": "USD",
      "fetchedAt": "2026-06-23T21:59:48.717Z",
      "ingestedAt": "2026-06-23T21:59:48.000Z",
      "quoteSize": 47,
      "totalQuantity": 47,
      "ingestLatencyMs": 0,
      "isStale": false
    }
  ],
  "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,
  "calculatedAt": "2026-06-23T22:07:13.752Z"
}

Errors

404饰品不存在。

401缺少 Authorization 头、认证方案不支持，或密钥未知、未激活、已过期、已吊销。

403密钥有效，但订阅未激活/已过期，或套餐不含此接口。

429超出速率限制；见 Retry-After 与 X-RateLimit-* 响应头。配额按账号合并计算，所有密钥共享。

See also只要 NBBO 挂单深度数据新鲜度与时间戳

curl "https://pricing.skinpricer.com/v1/pricing/:marketHashName" \
  -H "Authorization: ApiKey sk_live_•••••••••••"

Response headers

X-RateLimit-Limit: <per-minute, set by your plan>

X-RateLimit-Remaining: <remaining this minute>

X-RateLimit-Reset: <seconds to reset>

X-Request-ID: req_xxxxxxxxxxxxxxxx