GET/v1/status/freshnessDEVELOPER+

各市场数据新鲜度

各市场数据新鲜度及整体状态汇总。响应为 snake_case。

这是运维视角而非定价视角的读取：每个市场自最后一次摄取事件以来的 delay_seconds，加上 overall_status 总览。用它判断当下是否该采信某个市场的数字。响应为 snake_case。

参数

无查询参数。

响应字段

FreshnessResponse各市场摄取新鲜度 + 整体汇总。snake_case。

marketsMarketFreshness[]

每个已摄取市场一行。

overall_statusstring

汇总：healthy | degraded | stale。

checked_atstring (date-time)

新鲜度采样时间。

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

错误

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

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

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

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

另见市场健康状态（公开）新鲜度模型

配套接口

GET/v1/status/market-latency

各市场的数据摄取延迟与可靠性：每个市场的 avg_latency_ms、p95_latency_ms、p99_latency_ms、fetch_count、error_rate 与 slo_breach_rate，外加 window_hours 与 measured_at。与 status 其余接口一样为 snake_case。

完整参考 →

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

export SKINPRICER_API_KEY="sp_live_•••"

curl "https://pricing.skinpricer.com/v1/status/freshness" \
  -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 health = await client.status.freshness();
console.log(health.overall_status, "·", health.markets.length, "markets");

import os
import requests

res = requests.get(
    "https://pricing.skinpricer.com/v1/status/freshness",
    headers={"Authorization": f"ApiKey {os.environ['SKINPRICER_API_KEY']}"},
    timeout=10,
)
res.raise_for_status()
print(res.json())

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

响应 200

{
  "markets": [
    {
      "market": "dmarket",
      "delay_seconds": 0,
      "last_update": "2026-06-23T22:00:00.000Z",
      "status": "healthy"
    },
    {
      "market": "steamcommunity",
      "delay_seconds": 0,
      "last_update": "2026-06-23T22:00:00.000Z",
      "status": "healthy"
    }
  ],
  "overall_status": "healthy",
  "checked_at": "2026-06-23T22:04:00.118Z"
}

响应头

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

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

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

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

X-Request-ID: req_xxxxxxxxxxxxxxxx