GET/v1/markets/buff163/historyPRO+

buff163 价格历史

仅 buff163 的属性价格历史：与 /v1/attribute-prices/history 相同的 points[] 时间序列，但限定为单一市场。响应封装携带单个 market: "buff163" 而非 markets[] 数组。可按 marketHashName、canonicalItemId，或仅凭 bucketId / bucketIds 限定。用 from / to 设定窗口（默认最近 7 天），用 granularity 固定间隔。价格为整数美分。

属性价格历史的 buff163 专属版本：同样的 points[] OHLC 式序列，限定为单一市场，因此响应封装携带单个 market 而非 markets[] 数组。

用 bucketId / bucketIds 收窄范围；points[] 从旧到新。要最新的 buff163 分桶（不含历史），用 buff163 分桶；要所有市场的历史，见属性价格历史。

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 个分桶。

limitintegeroptional

Query. Max history points across all buckets, 1 to 10000. Default 5000.

Response fields

BuffHistoryResponse仅 buff163 的饰品属性价格历史。

bucketSchemaVersioninteger

分桶结构的 schema 版本。

marketstring

恒为 buff163。

currencystring

恒为 USD。

granularitystring

点间隔，例如 10m。

itemsAttributeHistoryItem[]

每个饰品一条；分桶沿用 AttributeHistoryBucket / AttributeHistoryPoint 结构。

sourceGapsstring[]

请求了但无覆盖的市场。

Response 200

{
  "bucketSchemaVersion": 1,
  "market": "buff163",
  "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 一个都没提供。granularity / limit 无效或窗口超过 10,000 分桶上限时同样返回。

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

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

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

See also最新 buff163 分桶全市场历史

curl "https://pricing.skinpricer.com/v1/markets/buff163/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