GET/v1/pricing/:marketHashName/history/marketsPRO+

按市场价格历史

饰品的按市场历史价格序列：与 /v1/pricing/:marketHashName/history 相同的时间分桶，但按市场拆分为每个市场一条 series，而非单一跨市场聚合。用 markets 过滤特定平台。价格为整数美分。

这是价格历史的按市场版本：不再是一条混合序列，而是 series[] 中每个市场一条，各自携带自己的 history[] 分桶（avgPrice、bestBidCents / bestAskCents、spreadBps 等）。用它对比同一件饰品在不同平台的交易情况。

传入 markets CSV（例如 buff163,csfloat）限定返回的平台；省略则返回所有有覆盖的市场。from / to / interval / listingType / salesWindow 的行为与聚合历史接口完全一致。

Parameters

marketHashNamestringrequired

路径段。URL 编码的 market_hash_name。

marketsstringoptional

查询参数。要返回的市场 id CSV，例如 buff163,csfloat。省略则返回所有有覆盖的市场。

fromstringoptional

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

tostringoptional

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

listingTypestringoptional

查询参数。SELL_OFFER | BUY_ORDER | SALE_HISTORY。默认：SELL_OFFER。

salesWindowstringoptional

查询参数。24h | 7d | 30d | 90d。仅当 listingType=SALE_HISTORY 时有效。

intervalstringoptional

查询参数。固定分桶粒度：MINUTE_5 | MINUTE_15 | HOUR_1 | HOUR_6 | DAY_1。会覆盖由 from/to 推导的粒度。未知值返回 400。

Response fields

PriceHistoryByMarketResponse饰品的按市场时间分桶价格序列。

canonicalItemIdstring

规范饰品 id。

namestring

Market hash name。

listingTypestring

SELL_OFFER | BUY_ORDER | SALE_HISTORY。

salesWindowstringnullable

仅当 listingType=SALE_HISTORY 时设置。

seriesMarketSeries[]

每个市场一条。

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

Response 200

{
  "canonicalItemId": "cmlofczf90qj401vsd80dskd1",
  "name": "AK-47 | Redline (Field-Tested)",
  "listingType": "SELL_OFFER",
  "salesWindow": null,
  "series": [
    {
      "market": "buff163",
      "history": [
        {
          "timestamp": "2026-06-22T00:00:00.000Z",
          "avgPrice": 3820,
          "medianPrice": 3531,
          "minPrice": 3028,
          "maxPrice": 6185,
          "listingCount": 9374,
          "totalQuantity": null,
          "volume": null,
          "bestBidCents": 5978,
          "bestAskCents": 3028,
          "spreadBps": -6551
        },
        {
          "timestamp": "2026-06-23T00:00:00.000Z",
          "avgPrice": 3884,
          "medianPrice": 3542,
          "minPrice": 3063,
          "maxPrice": 6249,
          "listingCount": 9138,
          "totalQuantity": null,
          "volume": null,
          "bestBidCents": 6022,
          "bestAskCents": 3063,
          "spreadBps": -6514
        }
      ]
    },
    {
      "market": "csfloat",
      "history": [
        {
          "timestamp": "2026-06-22T00:00:00.000Z",
          "avgPrice": 2973,
          "medianPrice": 2972,
          "minPrice": 2906,
          "maxPrice": 3000,
          "listingCount": 3425,
          "totalQuantity": null,
          "volume": null,
          "bestBidCents": 2940,
          "bestAskCents": 2906,
          "spreadBps": -116
        },
        {
          "timestamp": "2026-06-23T00:00:00.000Z",
          "avgPrice": 2976,
          "medianPrice": 2964,
          "minPrice": 2964,
          "maxPrice": 3000,
          "listingCount": 3421,
          "totalQuantity": null,
          "volume": null,
          "bestBidCents": null,
          "bestAskCents": 2964,
          "spreadBps": null
        }
      ]
    }
  ]
}

Errors

400未知的 interval / listingType，或日期范围无效。

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

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

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

See also聚合价格历史市场健康状态

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