GET/v1/pricing/:marketHashName/listingsDEVELOPER+

实时挂单与磨损数据

饰品的逐件实时挂单（价格、磨损值、模板、印花、StatTrak™），附磨损覆盖率元数据。limit 最多 2000 条，可用 market 过滤特定市场。磨损-价格散点图的数据来源。

其他接口做的是聚合，本接口返回*逐件*挂单：每件带 price、floatValue（磨损值）、paintSeed（模板）、stickers（印花）与 StatTrak 标志。它是磨损-价格分析与按成色定价的数据来源。

磨损数据并非全市场可用。只有公开逐件磨损的市场才有 floatValue / paintSeed；其余返回 null。floatCoverage 明确告诉你哪些市场有、哪些没有（marketsWithFloat / marketsWithoutFloat），floatSummary 则把观察到的磨损值放在该饰品可能的磨损区间中对照。

用 limit（1 到 2000，默认 500）控制样本量，用 market CSV 限定平台。

Parameters

marketHashNamestringrequired

路径段。URL 编码的 market_hash_name。

limitintegeroptional

查询参数。最大样本数，1 到 2000。默认：500。

marketstringoptional

查询参数。市场过滤 CSV（markets 为其别名）。

Response fields

ListingsResponse逐件实时挂单，附磨损覆盖率元数据。

marketHashNamestring

Market hash name。

canonicalItemIdstring

规范饰品 id。

totalListingsinteger

全市场可用挂单总数。

sampledListingsinteger

本次返回的挂单数（≤ limit）。

floatCoverageFloatCoverage

哪些市场对该饰品公开磨损值。

floatSummaryFloatSummarynullable

观察到的磨损值摘要；未观察到磨损时为 null。

listingsListing[]

抽样的挂单。

calculatedAtstring (date-time)

抽样时间。

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

Response 200

{
  "marketHashName": "Glock-18 | Water Elemental (Factory New)",
  "canonicalItemId": "cmlofca920lka01yozajhixt3",
  "totalListings": 831,
  "sampledListings": 440,
  "floatCoverage": {
    "coverage": "partial",
    "sampledListings": 440,
    "listingsWithFloat": 436,
    "marketsWithFloat": [
      "avanmarket",
      "marketcsgo",
      "steamcommunity",
      "whitemarket"
    ],
    "marketsWithoutFloat": [
      "buff163",
      "csfloat",
      "cstrade",
      "dmarket",
      "lis-skins",
      "lootfarm",
      "skindeck",
      "skinport",
      "swapgg",
      "tradeit-store",
      "tradeit-trade",
      "waxpeer"
    ]
  },
  "floatSummary": {
    "observed": 0.04849119,
    "itemMin": 0,
    "itemMax": 0.07,
    "observedSource": {
      "market": "avanmarket"
    }
  },
  "listings": [
    {
      "listingId": "listing:3:2026012196248216436490249",
      "market": "avanmarket",
      "price": 7242,
      "currency": "USD",
      "floatValue": 0.0096316,
      "paintSeed": null,
      "paintIndex": null,
      "inspectLink": null,
      "stickers": [],
      "isStatTrak": false,
      "fetchedAt": "2026-06-23T10:09:37.606Z"
    }
  ],
  "calculatedAt": "2026-06-23T22:07:14.417Z"
}

Errors

404饰品不存在。

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

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

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