Skip to main content
GET/v1/status/market-latencyDEVELOPER+

市场延迟

各市场的数据摄取延迟与可靠性:每个市场在滚动 window_hours 内的平均、p95 与 p99 抓取延迟、抓取次数、错误率与 SLO 超标率。是数据新鲜度的同类接口;响应为 snake_case。

数据新鲜度的运维类同类接口:每个市场在滚动 window_hours 内的 avg_latency_ms、p95_latency_ms、p99_latency_ms,以及 fetch_count、error_rate 与 slo_breach_rate。在采信某个市场的报价之前,可以用它发现摄取滞后的市场。响应为 snake_case。

参数

无查询参数。

响应字段

MarketLatencyResponse各市场的摄取延迟与可靠性。snake_case。
每个市场一行。
window_hoursinteger
统计所覆盖的滚动窗口。
measured_atstring (date-time)
统计的测量时间。

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

错误

401缺少 Authorization 头、认证方案不支持,或密钥未知、未激活、已过期、已吊销。
403密钥有效,但订阅未激活/已过期,或套餐不含此接口。
429超出速率限制;见 Retry-After 与 X-RateLimit-* 响应头。配额按账号合并计算,所有密钥共享。
5xx上游快照不可用或服务端问题。请退避后重试。

使用此端点的指南(英文)

export SKINPRICER_API_KEY="sp_live_•••"

curl "https://pricing.skinpricer.com/v1/status/market-latency" \
  -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 latency = await client.status.marketLatency();
for (const m of latency.markets) console.log(m.market, m.avg_latency_ms, "ms avg");
import os
import requests

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

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

响应 200
{
  "markets": [
    {
      "market": "buff163",
      "avg_latency_ms": 51439,
      "p95_latency_ms": 69525,
      "p99_latency_ms": 75350,
      "fetch_count": 30003561,
      "error_rate": 0,
      "slo_breach_rate": 0.28
    },
    {
      "market": "dmarket",
      "avg_latency_ms": 839,
      "p95_latency_ms": 1021,
      "p99_latency_ms": 16686,
      "fetch_count": 3078604,
      "error_rate": 0,
      "slo_breach_rate": 0
    }
  ],
  "window_hours": 24,
  "measured_at": "2026-06-23T09:08:55.013Z"
}
响应头
X-RateLimit-Limit: <每分钟配额,由套餐决定>
X-RateLimit-Remaining: <本分钟剩余次数>
X-RateLimit-Reset: <距重置的秒数>
X-RateLimit-Remaining-Month: <本月剩余次数,仅限有月度上限的套餐>
X-Request-ID: req_xxxxxxxxxxxxxxxx

使用与许可

API 及其数据的使用受我们的服务条款(英文)约束:不得转售或再分发数据,不得用于构建竞争性服务, 不得超出套餐的速率限制;在条款允许展示数据的场景下须注明数据来源为 SkinPricer。滥用行为可能被限流或封禁。