GET/v1/market-analytics/:marketHashNamePRO+

市场分析

饰品按市场的当前报价与滚动窗口汇总统计：当前在售价、求购价与价差，挂单与求购单数量，以及窗口期内在售 / 求购价格的均值、最小值与最大值。响应为 snake_case。价格为整数美分。

一次调用获取按市场的当前报价与滚动窗口统计：此刻的 current_ask / current_bid / spread_bps，以及最近 windowHours（默认 24，最多 168）内 sell_* 与 buy_* 的均值、最小值与最大值。所有价格字段（包括当前值与窗口值）都是整数美分（*_count / *_quantity 统计是普通计数）。响应为 snake_case。

每个统计字段都可以为 null，因此近期没有活动的市场会带着 null 返回，而不是被丢弃。用 markets 限定特定平台。

参数

marketHashNamestring必填

路径段。URL 编码的 market_hash_name。

marketsstring可选

查询参数。用于限定分析范围的市场 id CSV，例如 skinport,buff163。

windowHoursinteger可选

查询参数。滚动分析窗口（小时），1 到 168。默认 24。

响应字段

MarketAnalyticsResponse饰品按市场的当前与窗口期分析。snake_case。

canonical_item_idstring

规范饰品 id。

market_hash_namestring

Market hash name。

window_hoursinteger

分析窗口（小时）。

marketsMarketAnalyticsPoint[]

每个市场一行。

calculated_atstring (date-time)

分析的计算时间。

嵌套与共享结构链接到 API 对象参考页。

错误

404饰品不存在。

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

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

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

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

另见聚合价格历史流动性与售出时间

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

How to estimate what a CS2 skin is really worth

export SKINPRICER_API_KEY="sp_live_•••"

curl "https://pricing.skinpricer.com/v1/market-analytics/AK-47%20%7C%20Redline%20(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 a = await client.marketAnalytics.get("AK-47 | Redline (Field-Tested)");
console.log(a.markets.length, "markets over", a.window_hours, "hours");

import os
import requests

res = requests.get(
    "https://pricing.skinpricer.com/v1/market-analytics/AK-47%20%7C%20Redline%20(Field-Tested)",
    headers={"Authorization": f"ApiKey {os.environ['SKINPRICER_API_KEY']}"},
    timeout=10,
)
res.raise_for_status()
print(res.json())

需要认证的接口：请在你自己的客户端中携带 API 密钥调用（见代码示例）。

响应 200

{
  "canonical_item_id": "cmlofca920lka01yozajhixt3",
  "market_hash_name": "Glock-18 | Water Elemental (Factory New)",
  "window_hours": 24,
  "markets": [
    {
      "market": "avanmarket",
      "current_ask": null,
      "current_bid": null,
      "spread_bps": null,
      "ask_is_stale": null,
      "bid_is_stale": null,
      "current_listing_count": null,
      "current_buy_order_count": null,
      "current_bid_quantity": null,
      "sell_avg_price": 6704.25,
      "sell_min_price": 6404,
      "sell_max_price": 7166,
      "sell_avg_listing_count": 44.79,
      "buy_avg_price": null,
      "buy_max_price": null,
      "buy_avg_order_count": null,
      "buy_avg_total_quantity": null
    }
  ],
  "calculated_at": "2026-06-23T22:07:17.447Z"
}

响应头

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

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

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

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

X-Request-ID: req_xxxxxxxxxxxxxxxx