属性分桶价格
受支持市场(buff163、steamcommunity、marketcsgo、csfloat、dmarket)上按属性分桶的价格。每个分桶是一个磨损/渐变/图案/模板/变体区间,带各自的在售价、求购价与挂单数,以及稳定的 bucketId。各市场分桶宽度不同,见分桶构建方式。可按 marketHashName 或 canonicalItemId 限定范围,两者都省略则返回分页的全量快照。默认只含磨损分桶(其余用 attributes=float,fade,tag 开启);用 limit + cursor 分页。时间序列见属性价格历史;仅 buff163 见 buff163 分桶。价格为整数美分。
按*属性*而非按挂单分桶的价格。每个 bucket 是一个区间(磨损区间如 0 到 0.01、渐变百分比、图案/模板、或多普勒相位等变体),带各自的 askCents / bidCents 与挂单数。稳定的 bucketId 让你可以长期追踪同一区间。
覆盖按市场划分(当前为 buff163、steamcommunity、marketcsgo、csfloat、dmarket);dimensions 对象写明每个分桶的精确边界。各市场分桶宽度不同:Buff 用自己的非等宽原生区间,其余市场用等宽 0.01 分桶——所以请基于 dimensions.float.min / max 归一化,不要依赖标签。完整方案见属性与磨损分桶的构建方式。
响应默认只含磨损分桶。加上 attributes=float,fade,tag 才会返回渐变与图案/变体(tag)分桶,否则它们会被静默省略。用 limit(1 到 1000,默认 500)+ 不透明 cursor 分页,读 nextCursor 继续。历史数据见 /v1/attribute-prices/history。
Parameters
canonicalItemId 同时省略则返回分页的全量快照(不会 400)。marketHashName 同时省略则返回分页的全量快照(不会 400)。float | fade | tag。默认仅 float,渐变与图案/变体(tag)分桶需显式请求,例如 attributes=float,fade,tag。cursor / nextCursor 分页。nextCursor 的不透明分页游标。sourceGaps 中报告。Response fields
USD。cursor 传回);最后一页为 null。嵌套与共享结构链接到 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
attributes、limit 或 cursor 的值无效。(范围参数是可选的:同时省略 marketHashName 与 canonicalItemId 会返回分页的全量快照,而不是 400。)Authorization 头、认证方案不支持,或密钥未知、未激活、已过期、已吊销。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).