比特幣情報 API 狀態
本頁即時檢查主要輸入的可用性、資料年齡與樣本數：目前 BTC 價格、歷史資料、週期分數與冪律模型。呼叫 API 或引用資料前先看一下；頁面不會暴露任何內部憑證。
這個研究實驗室的互動介面目前以簡體中文提供；下方說明涵蓋所有輸入、方法與限制。
輸入項目
- 不需輸入；可按「Check again」重新檢查
- 資料來自 /api/bitcoin-intelligence-status
輸出結果
- 整體狀態：operational、degraded 或 unavailable，並顯示檢查時間、回應時間（ms）與資料版本
- 4 個元件卡片：ticker、weekly-history、cycle-score、power-law-model
- 每張卡片顯示狀態、說明，以及資料年齡與門檻（小時），或「No timestamp」
- 狀態 JSON 與 API 文件連結
使用步驟
- 開啟頁面，先看最上方的整體狀態。
- 逐一檢視元件，找出過舊或無法使用的項目。
- 比對各元件的資料年齡與門檻。
- 若為 degraded，幾分鐘後按「Check again」再檢查。
- 引用數據時記下資料版本。
計算公式
新鮮度門檻：ticker 1 小時、歷史 240 小時、週期分數 72 小時、冪律模型 240 小時。元件檢查失敗即為 unavailable（歷史需至少 60 筆有效月度觀測；模型需至少 100 個週樣本），年齡 > 門檻為 stale，其餘為 operational。整體狀態：≥ 2 個元件 unavailable 為 unavailable（HTTP 503）；1 個 unavailable 或任一 stale 為 degraded；其餘為 operational。
計算範例
ticker 0.4 h / 1 h、歷史 100 h / 240 h、冪律模型 100 h / 240 h 都正常，但週期分數年齡 80 h、門檻 72 h。因為 80 > 72，cycle-score 為 stale，整體狀態是 degraded，而不是 unavailable。
如何解讀
- operational 表示所有元件都可用，且都在新鮮度門檻內。
- degraded 多半是某個來源延遲；資料仍可使用，但最好註明時間。
- unavailable（HTTP 503）表示至少 2 個元件無法使用，大量呼叫 API 前應先等待。
注意事項
- 這是請求當下的即時檢查，不是 SLA。
- 回應有快取（邊緣最多 5 分鐘），狀態可能略晚於實際情況。
- 上游短暫延遲或網路錯誤可能讓狀態暫時顯示 degraded。
常見問題
頁面會暴露金鑰或內部位址嗎？
不會。回應只包含狀態、資料年齡與樣本數，沒有任何機密、內部位址、訂閱者資料或供應商憑證。
「No timestamp」是什麼意思？
該元件沒有可計算年齡的來源時間戳記；只要可用性檢查通過，仍算 operational。
可以用 API 查詢狀態嗎？
可以。GET /api/bitcoin-intelligence-status 回傳 JSON；operational 或 degraded 時為 HTTP 200，unavailable 時為 HTTP 503。