价格历史
饰品按时间分桶的历史价格序列（avg/median/min/max 及最优买卖价，单位美分）。可用 from/to（ISO）、listingType（SELL_OFFER | BUY_ORDER | SALE_HISTORY）与 salesWindow 过滤。粒度默认根据时间范围自动选择，也可用 interval 指定（会对齐到已存储的 10m / 1h / 1d 汇总，实际宽度见响应中的 effectiveInterval）。需要按市场拆分的序列请见按市场的历史。
返回从旧到新的时间分桶序列。每个分桶汇总该窗口内观察到的价格（avg / median / min / max），以及当时的最优求购价、最优在售价与价差——正是画价格图所需的结构。
listingType 决定你画的是什么：SELL_OFFER（在售价，默认）、BUY_ORDER（求购价）或 SALE_HISTORY（已完成交易，配合 salesWindow 使用）。分桶粒度默认由 from/to 范围自动选择，也可用 interval 指定。数据来自已存储的 10 分钟、1 小时与 1 天汇总，所请求的粒度会对齐到最接近的一档（MINUTE_5 与 MINUTE_15 对齐到 10m，HOUR_1 与 HOUR_6 对齐到 1h，DAY_1 对齐到 1d）；响应中的 effectiveInterval 会告诉你实际宽度。
volume 在 listingType=SALE_HISTORY 时是该分桶的滚动成交笔数（完成交易的数量，不是成交额），在 SELL_OFFER / BUY_ORDER 下为 null。totalQuantity 在 BUY_ORDER 分桶上携带求购数量。请把 null 理解为"此处不适用"，而不是零。
按游戏区分的版本：GET /v2/pricing/:marketHashName/history 通过必填参数 game=cs2|rust 同时服务两款游戏。对挂单稀少的 Rust 饰品，请优先使用 bestAskCents / bestBidCents，而非各市场等权计算的 medianPrice，见游戏：CS2 与 Rust。
参数
SELL_OFFER | BUY_ORDER | SALE_HISTORY。默认：SELL_OFFER。24h | 7d | 30d | 90d。仅当 listingType=SALE_HISTORY 时有效。MINUTE_5 | MINUTE_15 | HOUR_1 | HOUR_6 | DAY_1。会覆盖由 from/to 推导的粒度，并对齐到最接近的已存储汇总（MINUTE_5/MINUTE_15 → 10m，HOUR_1/HOUR_6 → 1h，DAY_1 → 1d）；响应中的 effectiveInterval 报告实际宽度。未知值返回 400。响应字段
SELL_OFFER | BUY_ORDER | SALE_HISTORY。10m | 1h | 1d。可能与请求的 interval 不同，后者会对齐到这些已存储的汇总粒度。嵌套与共享结构链接到 API 对象 参考页。
错误
interval / listingType，或日期范围无效。Authorization 头、认证方案不支持，或密钥未知、未激活、已过期、已吊销。使用此端点的指南（英文）
export SKINPRICER_API_KEY="sp_live_•••"
curl -G "https://pricing.skinpricer.com/v1/pricing/AK-47%20%7C%20Redline%20(Field-Tested)/history" \
--data-urlencode "interval=HOUR_1" \
-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 series = await client.history.get("AK-47 | Redline (Field-Tested)", { interval: "HOUR_1" });
console.log(series.history.length, "buckets");import os
import requests
res = requests.get(
"https://pricing.skinpricer.com/v1/pricing/AK-47%20%7C%20Redline%20(Field-Tested)/history",
params={"interval": "HOUR_1"},
headers={"Authorization": f"ApiKey {os.environ['SKINPRICER_API_KEY']}"},
timeout=10,
)
res.raise_for_status()
print(res.json()){
"canonicalItemId": "cmlofca920lka01yozajhixt3",
"name": "Glock-18 | Water Elemental (Factory New)",
"listingType": "SELL_OFFER",
"salesWindow": null,
"effectiveInterval": "1d",
"history": [
{
"timestamp": "2026-05-25T00:00:00.000Z",
"avgPrice": 4923,
"medianPrice": 4222,
"minPrice": 3522,
"maxPrice": 8805,
"listingCount": 1442,
"totalQuantity": null,
"volume": null,
"bestBidCents": null,
"bestAskCents": 3522,
"spreadBps": null
}
]
}