Skip to main content
GET/v1/attribute-prices/latestDEVELOPER+

属性分桶价格

受支持市场(buff163、steamcommunity、marketcsgo、csfloat、dmarket)上按属性分桶的价格。每个分桶是一个磨损/渐变/图案/模板/变体区间,带各自的在售价、求购价与挂单数,以及稳定的 bucketId。各市场分桶宽度不同,见分桶构建方式。可按 marketHashNamecanonicalItemId 限定范围,两者都省略则返回分页的全量快照。默认只含磨损分桶(其余用 attributes=float,fade,tag 开启);用 limit + cursor 分页。时间序列见属性价格历史;仅 buff163 见 buff163 分桶。价格为整数美分。

按*属性*而非按挂单分桶的价格。每个 bucket 是一个区间(磨损区间如 0 到 0.01、渐变百分比、图案/模板、或多普勒相位等变体),带各自的 askCents / bidCents 与挂单数。稳定的 bucketId 让你可以长期追踪同一区间。

覆盖按市场划分(当前为 buff163steamcommunitymarketcsgocsfloatdmarket);dimensions 对象写明每个分桶的精确边界。各市场分桶宽度不同:Buff 用自己的非等宽原生区间,其余市场用等宽 0.01 分桶——所以请基于 dimensions.float.min / max 归一化,不要依赖标签。完整方案见属性与磨损分桶的构建方式

响应默认只含磨损分桶。加上 attributes=float,fade,tag 才会返回渐变与图案/变体(tag)分桶,否则它们会被静默省略。用 limit(1 到 1000,默认 500)+ 不透明 cursor 分页,读 nextCursor 继续。历史数据见 /v1/attribute-prices/history

Parameters

marketHashNamestringoptional
查询参数。用于限定分桶的精确 market_hash_name。可选。与 canonicalItemId 同时省略则返回分页的全量快照(不会 400)。
canonicalItemIdstringoptional
查询参数。用于限定分桶的规范饰品 id。可选。与 marketHashName 同时省略则返回分页的全量快照(不会 400)。
attributesstringoptional
查询参数。要包含的属性维度 CSV:float | fade | tag。默认仅 float,渐变与图案/变体(tag)分桶需显式请求,例如 attributes=float,fade,tag
limitintegeroptional
查询参数。返回分桶的最大数量,1 到 1000。默认 500。用 cursor / nextCursor 分页。
cursorstringoptional
查询参数。来自上一响应 nextCursor 的不透明分页游标。
marketsstringoptional
查询参数。用于限定响应的市场 id CSV;不受支持的市场会在 sourceGaps 中报告。

Response fields

AttributePricesResponse受支持市场上的按属性分桶价格。
bucketSchemaVersioninteger
分桶结构的 schema 版本。
marketsstring[]
本响应覆盖的市场。
currencystring
恒为 USD
asOfstring (date-time)
快照时间。
每个 饰品 × 市场 一条。
nextCursorstringnullable
下一页的不透明游标(作为 cursor 传回);最后一页为 null。
sourceGapsstring[]
请求了但本响应无覆盖的市场。

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

Response 200

{
  "bucketSchemaVersion": 1,
  "markets": ["buff163", "steamcommunity", "marketcsgo", "csfloat", "dmarket"],
  "currency": "USD",
  "asOf": "2026-06-23T09:18:45.864Z",
  "items": [
    {
      "canonicalItemId": "cmlofa7dh08ww01yo9lrpej3e",
      "marketHashName": "★ Karambit | Doppler (Factory New) - Phase 2",
      "market": "buff163",
      "buckets": [
        {
          "bucketId": "buff163:cmlofa7dh08ww01yo9lrpej3e:tag:446954:float:0-0.01",
          "bucketKey": "tag:446954:float:0-0.01",
          "bucketType": "attribute",
          "attributeType": "tag",
          "attributeTypes": ["tag", "float"],
          "dimensions": {
            "variant": "Phase2",
            "float": { "min": 0, "max": 0.01, "minInclusive": true, "maxInclusive": false },
            "fade": null,
            "pattern": null,
            "paintSeed": null
          },
          "sourceItemId": "44102",
          "sourceBucketId": "buff163:44102:tag446954:f0-0.01",
          "askCents": 197795,
          "avgAskCents": 201340,
          "medianAskCents": 199500,
          "bidCents": 179787,
          "askListingCount": 82,
          "bidOrderCount": null,
          "sourceUpdatedAt": "2026-06-23T09:10:00.000Z",
          "collectedAt": "2026-06-23T09:11:35.446Z"
        },
        {
          "bucketId": "buff163:cmlofa7dh08ww01yo9lrpej3e:tag:446954:float:0.01-0.02",
          "bucketKey": "tag:446954:float:0.01-0.02",
          "bucketType": "attribute",
          "attributeType": "tag",
          "attributeTypes": ["tag", "float"],
          "dimensions": {
            "variant": "Phase2",
            "float": { "min": 0.01, "max": 0.02, "minInclusive": true, "maxInclusive": false },
            "fade": null,
            "pattern": null,
            "paintSeed": null
          },
          "sourceItemId": "44102",
          "sourceBucketId": "buff163:44102:tag446954:f0.01-0.02",
          "askCents": 189676,
          "avgAskCents": 191220,
          "medianAskCents": 190100,
          "bidCents": 179344,
          "askListingCount": 66,
          "bidOrderCount": null,
          "sourceUpdatedAt": "2026-06-23T09:10:00.000Z",
          "collectedAt": "2026-06-23T09:11:35.446Z"
        }
      ]
    }
  ],
  "nextCursor": null,
  "sourceGaps": []
}

Errors

400attributeslimitcursor 的值无效。(范围参数是可选的:同时省略 marketHashNamecanonicalItemId 会返回分页的全量快照,而不是 400。)
401缺少 Authorization 头、认证方案不支持,或密钥未知、未激活、已过期、已吊销。
403密钥有效,但订阅未激活/已过期,或套餐不含此接口。
429超出速率限制;见 Retry-After 与 X-RateLimit-* 响应头。配额按账号合并计算,所有密钥共享。
curl "https://pricing.skinpricer.com/v1/attribute-prices/latest" \
  -H "Authorization: ApiKey sk_live_•••••••••••"

Authenticated endpoint — call it with your API key from your own client (see the code sample).

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

使用与许可

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