GET/v1/markets/buff163/latestDEVELOPER+

buff163 属性价格

仅 buff163 的饰品属性分桶价格：与 /v1/attribute-prices/latest 相同的磨损/渐变/图案/模板/变体区间，但限定为单一市场。响应封装携带单个 market: "buff163" 而非 markets[] 数组。Buff 的磨损区间是其自身的非等宽原生区间（见分桶构建方式）。可按 marketHashName 或 canonicalItemId 限定，两者都省略则返回分页的全量快照。默认只含磨损分桶。时间序列见 buff163 历史。价格为整数美分。

属性价格的单市场切片：只含 buff163 的分桶，因此响应封装携带单个 market 字段而非 markets[] 数组。items[] 内部是同样的 AttributeItem / AttributeBucket 结构，每个分桶带 askCents / bidCents 与挂单数。

Buff 的磨损分桶是其自身的非等宽原生区间（不像 Steam / marketcsgo / csfloat / dmarket 是固定 0.01 宽度），所以请读每个分桶的 dimensions 获取精确边界，不要假设宽度。见属性与磨损分桶的构建方式。与跨市场接口一样，响应默认只含磨损分桶；传 attributes=float,fade,tag 获取渐变与图案/变体分桶，用 limit + cursor / nextCursor 分页。

当你只关心 buff163 时用它（它是磨损分桶最深的数据源）。要同样的分桶但覆盖所有市场，用 /v1/attribute-prices/latest；要 buff163 的时间序列，见 buff163 历史。

参数

marketHashNamestring可选

查询参数。用于限定分桶的精确 market_hash_name。可选。与 canonicalItemId 同时省略则返回分页的全量快照（不会 400）。

canonicalItemIdstring可选

查询参数。用于限定分桶的规范饰品 id。可选。与 marketHashName 同时省略则返回分页的全量快照（不会 400）。

attributesstring可选

查询参数。要包含的属性维度 CSV：float | fade | tag。默认仅 float；渐变 / tag 需显式开启，例如 attributes=float,fade,tag。

limitinteger可选

查询参数。返回分桶的最大数量，1 到 1000。默认 500。用 cursor / nextCursor 分页。

cursorstring可选

查询参数。来自上一响应 nextCursor 的不透明分页游标。

响应字段

BuffLatestResponse仅 buff163 的饰品属性分桶价格。

bucketSchemaVersioninteger

分桶结构的 schema 版本。

marketstring

恒为 buff163。

currencystring

恒为 USD。

asOfstring (date-time)

快照时间。

itemsAttributeItem[]

每个饰品一条；分桶沿用 AttributeItem / AttributeBucket 结构。

nextCursorstringnullable

下一页的不透明游标；最后一页为 null。

sourceGapsstring[]

请求了但无覆盖的市场（buff163 单市场切片下为空）。

错误

400attributes、limit 或 cursor 的值无效。（范围参数是可选的：同时省略 marketHashName 与 canonicalItemId 会返回分页的全量快照，而不是 400。）

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

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

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

5xx上游快照不可用或服务端问题。请退避后重试。

另见全市场属性价格 buff163 历史

使用此端点的指南（英文）

export SKINPRICER_API_KEY="sp_live_•••"

curl -G "https://pricing.skinpricer.com/v1/markets/buff163/latest" \
  --data-urlencode "marketHashName=AK-47 | Redline (Field-Tested)" \
  -H "Authorization: ApiKey $SKINPRICER_API_KEY"

// npm i @skinpricer/sdk
import { SkinpricerClient } from "@skinpricer/sdk";

const client = new SkinpricerClient({
  apiKey: process.env.SKINPRICER_API_KEY!,
  authScheme: "ApiKey",
});

const { items } = await client.buff163.latest({ marketHashName: "AK-47 | Redline (Field-Tested)" });
console.log(items[0]?.buckets.length ?? 0, "buff163 buckets");

import os
import requests

res = requests.get(
    "https://pricing.skinpricer.com/v1/markets/buff163/latest",
    params={"marketHashName": "AK-47 | Redline (Field-Tested)"},
    headers={"Authorization": f"ApiKey {os.environ['SKINPRICER_API_KEY']}"},
    timeout=10,
)
res.raise_for_status()
print(res.json())

需要认证的接口：请在你自己的客户端中携带 API 密钥调用（见代码示例）。

响应 200

{
  "bucketSchemaVersion": 1,
  "market": "buff163",
  "currency": "USD",
  "asOf": "2026-06-23T09:19:23.280Z",
  "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
          },
          "askCents": 197795,
          "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
          },
          "askCents": 189676,
          "bidCents": 179344,
          "askListingCount": 66,
          "bidOrderCount": null,
          "sourceUpdatedAt": "2026-06-23T09:10:00.000Z",
          "collectedAt": "2026-06-23T09:11:35.446Z"
        }
      ]
    }
  ],
  "nextCursor": null,
  "sourceGaps": []
}

响应头

X-RateLimit-Limit: <每分钟配额，由套餐决定>

X-RateLimit-Remaining: <本分钟剩余次数>

X-RateLimit-Reset: <距重置的秒数>

X-RateLimit-Remaining-Month: <本月剩余次数，仅限有月度上限的套餐>

X-Request-ID: req_xxxxxxxxxxxxxxxx