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 分桶；要所有市场的历史，见属性价格历史。

参数

marketHashNamestring可选

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

canonicalItemIdstring可选

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

bucketIdstring可选

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

bucketIdsstring可选

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

attributesstring可选

查询参数。属性维度 CSV：float | fade | tag。按 bucketId / bucketIds 限定范围时默认三者全含，按饰品限定时默认仅 float；因此要获取某饰品的渐变与相位/变体历史，请传入 attributes=float,fade,tag（或 tag）。

fromstring可选

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

tostring可选

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

granularitystring可选

查询参数。点间隔：10m | 1h | 1d。默认由日期范围推导。上限 10,000 个分桶。

limitinteger可选

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

响应字段

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

bucketSchemaVersioninteger

分桶结构的 schema 版本。

marketstring

恒为 buff163。

currencystring

恒为 USD。

granularitystring

点间隔，例如 10m。

itemsAttributeHistoryItem[]

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

sourceGapsstring[]

请求了但无覆盖的市场。

错误

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

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

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

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

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

另见最新 buff163 分桶全市场历史

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

How to get BUFF163 prices, float buckets, and history in USD

export SKINPRICER_API_KEY="sp_live_•••"

curl -G "https://pricing.skinpricer.com/v1/markets/buff163/history" \
  --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, granularity } = await client.buff163.history({ marketHashName: "AK-47 | Redline (Field-Tested)" });
console.log(items.length, "bucket series at", granularity);

import os
import requests

res = requests.get(
    "https://pricing.skinpricer.com/v1/markets/buff163/history",
    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",
  "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": []
}

响应头

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

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

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

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

X-Request-ID: req_xxxxxxxxxxxxxxxx