24h成交量—未平仓—24h爆仓$1.36B24h多空比—BTC市占—ETH市占—
App
语言 ▾
¥ CNY ▾
/api/meta/status
GET可用FRESH

服务状态

总体状态、API 实例与存储、故障端点、延迟分位数、30 天可用性、各数据族的采集器健康状况以及未解决的事件。

GET/api/meta/status

请求

该端点不接受任何参数。

请求示例

curl -s "https://www.coinboss.com/api/meta/status"

响应字段

字段表根据真实响应生成，因此所列内容与端点实际返回的完全一致。路径中 a[] 表示数组元素，{*} 表示以动态名称（如币种或交易所）为键的对象。

字段类型单位说明
successboolean—请求成功时为 true。失败时响应体为 `{ success: false, code, error, request_id }`。
schemastring—本响应的结构 ID（`coinboss.meta.status/1`）。
nownumberms响应生成时的服务器时间。
overallstring—整体服务状态：`operational`、`degraded`、`partial_outage`、`major_outage` 或 `unknown`；见 `legend`。
api_versionstring—公开 API 的版本（`v1`）。
catalog_versionstring—端点目录的版本，为发布日期，例如 `2026.11.11`。
componentsarray—各服务组件及其状态：REST API、WebSocket 数据流、数据库、缓存、时序存储、端点探针和数据采集。
components[]object—一个组件：`id`、`title`、`status` 以及一个 `detail` 对象，其字段取决于具体组件。
components[].idstring—标识符。
components[].titlestring—组件的显示名称。
components[].statusstring—状态。
components[].detailobject—详情。
components[].detail.instances_healthynumbercount刚才对健康检查作出应答的 API 服务器实例数。 可能缺失
components[].detail.instances_totalnumbercount被检查的 API 服务器实例数。 可能缺失
components[].detail.health_latency_msnumberms各 API 实例中最慢的健康检查响应时间。 可能缺失
components[].detail.last_check_atnumberms时间戳。 可能缺失
components[].detail.first_frame_msnumberms最近一次探测中，从连接 WebSocket 数据流到第一帧到达所用的时间；未探测时为 null。 可能缺失
components[].detail.ping_msnumberms对该组件（数据库、缓存或时序存储）执行一次简单查询的往返时间，在 API 主机上测量。 可能缺失
components[].detail.notenull—备注。 可能缺失
components[].detail.last_run_atnumberms时间戳。 可能缺失
components[].detail.age_snumbers该行距上次更新的秒数。 可能缺失
components[].detail.interval_snumbers两次探针运行之间的计划间隔（300）。 可能缺失
components[].detail.took_msnumberms最近一轮完整探测的耗时；未记录时为 null。 可能缺失
components[].detail.families_totalnumbercount数据采集所评定的数据族数量。 可能缺失
components[].detail.families_degradednumbercount采集状态为 `degraded` 或 `outage` 的数据族数量。 可能缺失
components[].detail.judged_bystring—状态是依据哪个时间戳判定的。 可能缺失
endpointsobject—处于每种实时状态的已收录端点数量，以及失败端点的列表。
endpoints.totalnumber—总数。
endpoints.availablenumber—数据是否可用。
endpoints.partialnumber—仅有部分预期数据时为 true。
endpoints.degradednumbercount实时状态为 `degraded` 的端点数量。
endpoints.downnumbercount实时状态为 `down` 的端点数量。
endpoints.unavailablenumber—没有可用数据的条目，附原因。绝不会上报为 0。
endpoints.unknownnumbercount实时状态为 `unknown`（没有近期探测结果）的端点数量。
endpoints.failingarray—当前处于 `down` 或 `degraded` 的端点，每个附带 `id`、`path`、`status`、`reason`、最近一次 HTTP 状态码、上次成功时间和连续失败次数。
endpoints.failing[]object—一个当前不可用或已降级的端点。
endpoints.failing[].idstring—标识符。
endpoints.failing[].pathstring—端点路径。
endpoints.failing[].statusstring—状态。
endpoints.failing[].reasonstring—原因代码。
endpoints.failing[].httpnumber—最近一次探测的 HTTP 状态码；从未探测时为 `null`。
endpoints.failing[].last_ok_atnumberms时间戳。
endpoints.failing[].fail_streaknumbercount连续失败的探测次数。
latency_msobject—各端点最近一次成功探测请求的响应时间分布，在 API 主机上测量。
latency_ms.p50numberms各端点响应时间的中位数；没有新鲜样本时为 null。
latency_ms.p95numberms各端点响应时间的第 95 百分位数；没有新鲜样本时为 null。
latency_ms.maxnumber—最大值。
latency_ms.samplenumbercount计入延迟数据的端点数量。
latency_ms.measuredstring—关于延迟测量位置的纯文本说明：在服务端测量，不含网络传输时间。
uptimeobject—时间窗口内所有端点合计的探针检查情况：总数、成功百分比和按日拆分。
uptime.window_daysnumberdays可用率时间窗口的长度（30）。
uptime.checksnumbercount时间窗口内的探针检查次数，所有端点合计。
uptime.oknumbercount其中成功的检查次数。
uptime.pctnumber%百分比。
uptime.tracking_sincestring—时间窗口内有探针数据的第一天，格式为 `YYYY-MM-DD`；尚无数据时为 null。
uptime.daysarray—日度数值或天数。
uptime.days[]object—日度数值或天数。
uptime.days[].daystring—日历日（UTC）。
uptime.days[].checksnumbercount当日的探测请求次数。
uptime.days[].oknumbercount当日成功的探测请求次数。
uptime.days[].pctnumber%百分比。
uptime.days[].schema_pctnumber%当日被探测的响应中与文档记载的字段表一致的占比。
uptime.days[].avg_msnumberms当日的平均响应时间。
collectorsobject—交易所数据采集的状态，根据存储中的数据时间戳判定：各数据族计数、数据集检查和巡检健康状况；无法评定时为 null。
collectors.familiesarray—各数据族的采集状态。
collectors.families[]object—一个数据族：`family`、`title`、处于每种状态的交易所数量以及由此得出的 `status`。
collectors.families[].familystring—数据族 ID，例如 `ticker`、`oi`、`funding`、`liquidation`、`options`。
collectors.families[].titlestring—数据族的显示标题。
collectors.families[].exchanges_collectednumbercount采集该数据族的交易所数量：fresh + partial + stale + broken。
collectors.families[].freshnumbercount该数据族最新数据处于新鲜窗口内的交易所数量。
collectors.families[].partialnumber—仅有部分预期数据时为 true。
collectors.families[].stalenumber—超出新鲜窗口的数据行或其标志。
collectors.families[].brokennumbercount该数据族的上游持续失败、或大部分数据行未通过合理性检查的交易所数量。
collectors.families[].unavailablenumber—没有可用数据的条目，附原因。绝不会上报为 0。
collectors.families[].statusstring—状态。
collectors.datasetsarray—不按交易所划分的数据集（例如现货 ETF 和 CME 日度数据）的质量检查，每项附带状态、滞后、覆盖范围和原因。
collectors.datasets[]object—一个不与单一交易所绑定的全市场数据集（期权、现货 ETF、CME、订单簿、基差）。
collectors.datasets[].familystring—数据集 ID，例如 `etf` 或 `cme`。
collectors.datasets[].idstring—标识符。
collectors.datasets[].titlestring—数据集的显示名称。
collectors.datasets[].sourcestring—数值的来源。
collectors.datasets[].endpointstring—提供该数据集的公开端点。
collectors.datasets[].statusstring—状态。
collectors.datasets[].lag_snumbers响应生成时最新数据点的时效。
collectors.datasets[].source_atnumberms时间戳。
collectors.datasets[].fetched_atnumbermsCoinBoss 从数据源获取该数据的时间。
collectors.datasets[].fresh_within_snumbers新鲜窗口：比该时长更新的数据视为新鲜。
collectors.datasets[].coverageobject—包含了什么、缺少了什么。
collectors.datasets[].coverage.funds_totalnumbercount受跟踪的基金数量。 可能缺失
collectors.datasets[].coverage.funds_coverednumbercount有可用披露数据的基金数量。 可能缺失
collectors.datasets[].coverage.funds_unavailablenumbercount发行商未发布机器可读披露数据的基金数量。 可能缺失
collectors.datasets[].coverage.funds_failingnumbercount最近一轮采集中披露数据无法读取的基金数量。 可能缺失
collectors.datasets[].coverage.as_ofstring—已覆盖基金中最新的披露日期（YYYY-MM-DD）。 可能缺失
collectors.datasets[].coverage.as_of_minstring—已覆盖基金中最早的披露日期（YYYY-MM-DD）。 可能缺失
collectors.datasets[].reasonstring|null—原因代码。
collectors.datasets[].coverage.contractsnumber—各合约的数据行。 可能缺失
collectors.datasets[].coverage.report_datestring—最新一期 CFTC 交易者持仓报告（Commitments of Traders）的日期（YYYY-MM-DD）。 可能缺失
collectors.datasets[].coverage.productsnumbercount已覆盖的 CME 产品数量。 可能缺失
collectors.datasets[].coverage.trade_datestring—最新一份 CME 日度报告的交易日期（YYYY-MM-DD）。 可能缺失
collectors.patrol_okboolean—数据质量巡检在最近 15 分钟内运行过时为 true。
collectors.patrol_age_snumbers距该事件的秒数。
collectors.evaluated_atnumberms时间戳。
incidentsobject—未解决或在最近 7 天内已解决的数据质量告警：`open` 数量和 `items`（最多 100 条）。
incidents.opennumber—周期开盘价。
incidents.itemsarray—结果条目。
incidents.items[]object—结果条目。
incidents.items[].levelstring—等级。
incidents.items[].exchangestring—交易所 ID，小写（例如 `binance`）。
incidents.items[].familystring—该告警所涉及的数据族。
incidents.items[].codestring—代码。
incidents.items[].detailstring—详情。
incidents.items[].opened_atnumberms时间戳。
incidents.items[].last_seen_atnumberms时间戳。
incidents.items[].resolved_atnumber|nullms时间戳。
incidents.items[].hitsnumbercount自告警触发以来观察到该状况的巡检次数（每 5 分钟巡检一次）。
incidents.items[].openboolean—周期开盘价。
probeobject—实时状态背后的端点探针的状态：上次运行时间、距今时长、运行间隔以及是否新鲜。
probe.last_run_atnumberms时间戳。
probe.age_snumbers该行距上次更新的秒数。
probe.interval_snumbers两次探针运行之间的计划间隔（300）。
probe.freshboolean—最近一次探针运行距今不足 20 分钟时为 true；为 false 时端点状态一律报告为 `unknown`。
probe.errornull—错误信息（仅在失败时出现）。
probe.endpoints_checkednumbercount最近一轮探测中检查的端点数量。
probe.oknumbercount最近一轮探测中正确应答的端点数量。
probe.failednumbercount最近一轮探测中失败的端点数量。
probe.schema_mismatchnumbercount响应与文档记载的字段表不一致的端点数量。
probe.alt_samples_failednullcount失败的额外样本请求数量；最近一轮未运行这些请求时为 `null`。
legendobject—`overall` 每个取值的纯文本定义。
legend.operationalstring—`operational` 的定义。
legend.degradedstring—`degraded` 的定义。
legend.partial_outagestring—`partial_outage` 的定义。
legend.major_outagestring—`major_outage` 的定义。
legend.unknownstring—`unknown` 的定义。
metaobject—本响应的封装：结构 ID、数据生成系统、时间戳、缓存有效期和新鲜度。
meta.schemastring—本响应的结构 ID；与顶层 `schema` 的值相同。
meta.sourcearray—数值的来源。
meta.source[]object—数值的来源。
meta.source[].systemstring—生成该数据的系统；开发者中心端点始终为 `coinboss`。
meta.source[].componentstring—数据背后的组件：端点探针和数据质量巡检。
meta.observed_atnull—时间戳。
meta.received_atnumberms时间戳。
meta.fetched_atnumbermsCoinBoss 从数据源获取该数据的时间。
meta.windowstring—时间窗口。
meta.cache_ttl_snumbers本响应的服务端缓存有效期。
meta.qualitystring—端点探针在最近 20 分钟内上报过时为 `FRESH`，否则为 `STALE`。
meta.is_staleboolean—该行超出新鲜窗口时为 true；过期的行不计入合计。
meta.fallbackstring—纯文本说明：该端点的输入数据过期或缺失时会返回什么。

生成于 2026-11-11 23:01 UTC，基于 1 个真实响应。

响应示例

/api/meta/status · 真实响应，采集于 2026-11-13 03:53:47 UTC。 为便于展示，较长的数组和映射已被截短：components 原有 7 项; uptime.days 原有 3 项; incidents.items 原有 11 项; endpoints.failing 原有 25 项; collectors.datasets 原有 12 项; collectors.families 原有 12 项。

  • {
    • "success": true,
    • "schema": "coinboss.meta.status/1",
    • "now": 1794542027137,
    • "overall": "partial_outage",
    • "api_version": "v1",
    • "catalog_version": "2026.11.12",
    • "components": [
      • { … 4 },
      • { … 4 }
      ],
    • "endpoints": {
      • "total": 299,
      • "available": 256,
      • "partial": 17,
      • "degraded": 17,
      • "down": 8,
      • "unavailable": 1,
      • "unknown": 0,
      • "failing": [ … 2 ]
      },
    • "latency_ms": {
      • "p50": 7,
      • "p95": 839,
      • "max": 10047,
      • "sample": 289,
      • "measured": "server-side, from the probe on the API host (excludes network transit)"
      },
    • "uptime": {
      • "window_days": 30,
      • "checks": 119504,
      • "ok": 118277,
      • "pct": 98.97,
      • "tracking_since": "2026-11-11",
      • "days": [ … 2 ]
      },
    • "collectors": {
      • "families": [ … 2 ],
      • "datasets": [ … 2 ],
      • "patrol_ok": true,
      • "patrol_age_s": 282,
      • "evaluated_at": 1794542027976
      },
    • "incidents": {
      • "open": 2,
      • "items": [ … 2 ]
      },
    • "probe": {
      • "last_run_at": 1794541726312,
      • "age_s": 301,
      • "interval_s": 300,
      • "fresh": true,
      • "error": null,
      • "endpoints_checked": 290,
      • "ok": 289,
      • "failed": 1,
      • "schema_mismatch": 0,
      • "alt_samples_failed": null
      },
    • "legend": {
      • "operational": "all checks pass",
      • "degraded": "serving, with stale data, schema drift or reduced redundancy",
      • "partial_outage": "at least one endpoint or API instance is failing",
      • "major_outage": "database down, no API instance healthy, or 20%+ of endpoints failing",
      • "unknown": "the probe has not reported within 20 minutes — status cannot be asserted"
      },
    • "meta": {
      • "schema": "coinboss.meta.status/1",
      • "source": [ … 1 ],
      • "observed_at": null,
      • "received_at": 1794541726312,
      • "fetched_at": 1794542027137,
      • "window": "latest",
      • "cache_ttl_s": 15,
      • "quality": "FRESH",
      • "is_stale": false,
      • "fallback": "status is \"unknown\" whenever the probe is stale; process liveness is never used as evidence"
      }
    }

详细信息

身份验证
无。公开端点。
速率限制
每个 IP 每分钟 1200 次请求
服务端缓存
15s
边缘微缓存
10s
更新频率
请求时评估；端点结果来自每 5 分钟一次的 API 探测，采集器健康状况来自数据时间戳。
数据来源
API 探测结果、各实例健康检查、数据质量矩阵、告警日志。
时间戳
除非字段说明另有注明，均为 Unix 纪元毫秒（UTC）
响应格式
json
稳定性
稳定
上线时间
2026-11-11

实时状态

可用检查于 2026-11-13 03:53:47 UTCHTTP 200872 ms结构一致最新数据点距今 5m

近 30 天可用性

407 次检查中 99.75% 通过

错误

所有端点的失败响应格式一致。完整列表见错误页面。 错误与速率限制 →

错误码HTTP含义处理方式
INVALID_PARAM400缺少必填参数，或某个取值不被接受。已知是哪个参数时，`param` 会给出其名称。请勿原样重试；请修正请求。
UNAUTHORIZED401已发送 `CB-API-KEY` 请求头，但该密钥未知或已被吊销。公开数据无需密钥，请去掉该请求头或使用有效密钥。请勿原样重试。
FORBIDDEN403该路由不属于公开 API（内部或仅限账户使用）。请勿重试。
NOT_FOUND404未知路由，或所请求的币种 / 交易所 / 基金不存在。请勿重试；请对照目录检查路径和标识符。
RATE_LIMITED429请求数超过每分钟限额。`Retry-After` 给出需要等待的秒数。等待 `Retry-After` 指定的时间后，再以退避方式重试。
INTERNAL500意外的服务器错误。错误信息有意保持通用；报告问题时请附上 `request_id`。几秒后重试一次；若问题持续，请附上请求 ID 报告。
UPSTREAM_FAILED503该端点背后的数据源未及时响应。不会返回过期数据或替代数值来顶替。以退避方式重试；并查看状态页。
UNAVAILABLE501 / 503数据集暂时未就绪（缓存预热中），或该端点尚无合法的公开数据源。请稍后重试；目录会标出因设计原因而不可用的端点。
REQUEST_FAILED200部分较旧的端点会以 HTTP 200 返回 `success: false`。请务必检查 `success`，而不只是 HTTP 状态码。取决于具体信息；按请求失败处理。

试一试

GET/api/meta/status可用
参数

无参数。

请求 URLhttps://www.coinboss.com/api/meta/status
选择一个端点，然后点击“发送请求”。响应、响应头和耗时将显示在这里。