比特幣情報 API 文件

更新日期：2026-10-07 · CryptoRebateHub Editorial Team

說明比特幣情報公開、唯讀、免 API 金鑰的各個端點：目前指標、無未來資料的月度歷史、異常、狀態、引用與研究快照。頁面列出參數、邊緣快取時間、合理使用限制、狀態碼與標示來源的要求。

這個研究實驗室的互動介面目前以簡體中文提供；下方說明涵蓋所有輸入、方法與限制。

開啟互動研究實驗室 →

輸入項目

/api/bitcoin-intelligence-history：years=1–20（預設 10）、limit=12–240（預設 180）
/api/bitcoin-intelligence-anomalies：lookback=12–60（預設 36）、limit=1–60（預設 24）
/api/bitcoin-research-snapshots：id=bir_…（必填）
目前指標、狀態、引用與 OpenAPI 端點不需參數

輸出結果

7 個端點卡片：路徑、回傳資料、參數、邊緣快取（15 分鐘、6 小時、5 分鐘、不可變或 24 小時）與驗證方式（無）
可一鍵複製的 cURL 範例
狀態碼：200 成功、429 超過合理使用限制、502/503 上游或歷史資料暫時無法使用
來源標示與版本規則（schemaVersion），以及位於 /api/bitcoin-intelligence-openapi 的 OpenAPI 3.1 機器可讀文件

使用步驟

選擇需要的端點：目前指標、月度歷史、異常、狀態或引用。
按「Open response」查看實際 JSON，或複製 cURL 指令。
大量使用時請自行快取回應，並遵守 429 與 Retry-After。
讀取回應中的 schemaVersion，以因應未來欄位變動。
轉載資料時標示 CryptoRebateHub，並連結到終端或方法頁。

計算範例

指令 curl -s "https://cryptorebatehub.com/api/bitcoin-intelligence-history?years=5&limit=60" 最多回傳 60 筆月度觀測。合理使用限制為每個 IP 每分鐘 120 次函式請求，平均 120 ÷ 60 = 每秒 2 次；命中邊緣快取的請求通常不計入額度。

如何解讀

快取時間代表資料最多可能多舊：狀態 5 分鐘、目前指標 15 分鐘、歷史、異常與引用 6 小時。
帶版本的回應包含 dataVersion 與 methodologyVersion，方便記錄你使用的確切資料。
新增欄位會保持向下相容；破壞性變更會提高 schemaVersion 並附上遷移說明。

注意事項

免費 API 沒有可用性 SLA；上游故障時可能回傳 502 或 503。
請勿把估算欄位描述成原始鏈上事實。
建立快照（POST）只接受瀏覽器同源請求；紀錄會永久公開，敏感欄位會被拒絕。

常見問題

需要註冊或 API 金鑰嗎？

不需要。所有讀取端點都是公開的，不需驗證。

請求頻率限制是多少？

每個 IP 每分鐘 120 次函式請求。超過時 API 回傳 429 並附 Retry-After；命中邊緣快取通常不計入。

有機器可讀的文件嗎？

有。GET /api/bitcoin-intelligence-openapi 會回傳 JSON 格式的 OpenAPI 3.1 文件。