GET/v1/attribute-prices/historyPRO+

属性价格历史

按属性分桶的价格时间序列：与 /v1/attribute-prices/latest 相同的磨损/渐变/图案/模板/变体区间，但每个分桶携带 points[] 序列而非单一买卖价。可按 marketHashName、canonicalItemId，或仅凭 bucketId / bucketIds 限定范围（任一均可）。用 from / to 设定窗口（默认最近 7 天），用 granularity 固定间隔。价格为整数美分。

属性价格的历史版本：同样的磨损/渐变/图案/模板/变体区间，但每个 bucket 携带 points[] 序列而非单一买卖价。每个点是一个 granularity 窗口的 OHLC 式汇总（openAskCents、highAskCents、lowAskCents、closeAskCents，外加 avgAskCents 与 closeBidCents）。

范围尽量收窄：传 bucketId（或 bucketIds CSV）只拉取你追踪的区间，而不是该饰品的全部区间。points[] 从旧到新；在没有求购侧的市场上，求购价与 bidOrderCount 为 null。

Parameters

marketHashNamestringoptional

查询参数。用于限定分桶的精确 market_hash_name。marketHashName / canonicalItemId / bucketId / bucketIds 至少需要其一。

canonicalItemIdstringoptional

查询参数。用于限定分桶的规范饰品 id。marketHashName / canonicalItemId / bucketId / bucketIds 至少需要其一。

bucketIdstringoptional

查询参数。按稳定 bucketId 限定到单个分桶。可作为独立范围使用（无需饰品 id）。

bucketIdsstringoptional

查询参数。bucketId 的 CSV。可作为独立范围使用（无需饰品 id）。

fromstringoptional

查询参数。ISO 8601 起始时间。默认：now − 7d。

tostringoptional

查询参数。ISO 8601 结束时间。默认：now。

granularitystringoptional

查询参数。点间隔：10m | 1h | 1d。默认由日期范围推导。窗口上限为 10,000 个分桶（超出返回 400）。

limitintegeroptional

查询参数。所有分桶合计返回的最大历史点数，1 到 10000。默认 5000。

marketsstringoptional

查询参数。用于限定响应的市场 id CSV；不受支持的市场会在 sourceGaps 中报告。

Response fields

AttributeHistoryResponse按属性分桶价格的时间序列。

bucketSchemaVersioninteger

分桶结构的 schema 版本。

marketsstring[]

本响应覆盖的市场。

currencystring

恒为 USD。

granularitystring

点间隔，例如 10m。

itemsAttributeHistoryItem[]

每个饰品 × 市场一条。

sourceGapsstring[]

请求了但无覆盖的市场。

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

Response 200

{
  "bucketSchemaVersion": 1,
  "markets": ["buff163", "steamcommunity", "marketcsgo", "csfloat", "dmarket"],
  "currency": "USD",
  "granularity": "10m",
  "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
          },
          "points": [
            {
              "bucketStart": "2026-06-16T14:40:00.000Z",
              "openAskCents": 192390,
              "highAskCents": 192390,
              "lowAskCents": 192390,
              "closeAskCents": 192390,
              "avgAskCents": 192390,
              "closeBidCents": 179367,
              "askListingCount": 87,
              "bidOrderCount": null,
              "firstObservedAt": "2026-06-16T14:41:02.190Z",
              "lastObservedAt": "2026-06-16T14:41:04.342Z"
            },
            {
              "bucketStart": "2026-06-16T14:50:00.000Z",
              "openAskCents": 192390,
              "highAskCents": 192390,
              "lowAskCents": 192390,
              "closeAskCents": 192390,
              "avgAskCents": 192390,
              "closeBidCents": 179367,
              "askListingCount": 87,
              "bidOrderCount": null,
              "firstObservedAt": "2026-06-16T14:51:03.475Z",
              "lastObservedAt": "2026-06-16T14:51:12.491Z"
            },
            {
              "bucketStart": "2026-06-16T15:00:00.000Z",
              "openAskCents": 192410,
              "highAskCents": 192410,
              "lowAskCents": 192410,
              "closeAskCents": 192410,
              "avgAskCents": 192410,
              "closeBidCents": 179385,
              "askListingCount": 87,
              "bidOrderCount": null,
              "firstObservedAt": "2026-06-16T15:00:49.830Z",
              "lastObservedAt": "2026-06-16T15:00:49.830Z"
            }
          ]
        }
      ]
    }
  ],
  "sourceGaps": []
}

Errors

400完全没有范围参数：marketHashName、canonicalItemId、bucketId、bucketIds 一个都没提供（任一即可，仅传 bucketId / bucketIds 也是有效范围）。granularity / limit 无效或窗口超过 10,000 分桶上限时同样返回。

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

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

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

See also最新属性价格饰品价格历史 buff163 历史

curl "https://pricing.skinpricer.com/v1/attribute-prices/history" \
  -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