24h成交量—未平倉—24h爆倉$1.36B24h多空比—BTC市佔—ETH市佔—
App
語言 ▾
NT$ TWD ▾
/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 epoch 毫秒（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
選擇一個端點並按下「送出請求」。回應內容、標頭與耗時會顯示在這裡。