Blave API 參考文件

用 REST 取得加密貨幣與台灣市場資料。89 個端點，一組金鑰。

最後更新 2026-10
建立 API 金鑰 查看 API 方案
加密39
通用 · 工具 · Alpha · 原始資料
台股31
行情 · 基本面 · 籌碼面 · 其他
台股大盤5
加權指數日K · 全市場成交量值 · 全市場三大法人買賣超
台灣期貨與選擇權12
台灣期貨分線 · 期貨分線覆蓋清單 · 期貨分線年檔下載
商品期貨與總經2
商品 · 總體經濟

認證

https://api.blave.org：以下所有路徑都相對於它。

每個請求都要帶 api-key 與 secret-key（在 API 金鑰頁 建立金鑰）。

Python
import requests, osfrom dotenv import load_dotenvload_dotenv()headers = {    "api-key": os.getenv("blave_api_key"),    "secret-key": os.getenv("blave_secret_key"),}BASE_URL = "https://api.blave.org"

存取權限與方案

各端點對金鑰所屬帳號的要求（頁面上的「權限」列，原文 Access）：

值意義
API plan or Blave Agent plan金鑰有效，且帳號的方案涵蓋這把金鑰，見下方的金鑰規則。未涵蓋 → 403 ERR007
Any valid key只要金鑰有效，不檢查方案

金鑰規則：

  • 你自己建立的金鑰（上面的 API 頁；你自己的腳本與外部 agent 在 Blave Agent 之外用的那種）需要 API 方案，即使帳號另有 Blave Agent 方案或試用也一樣。
  • Blave Agent 發的金鑰（雲端機器自己的金鑰、電腦版的登入金鑰）由綁卡試用、有效的 Blave Agent 方案（每個方案都含資料）或 API 方案涵蓋。
  • 未涵蓋 → 403 ERR007；它的 message 與 next_steps 會指出解法，照著做，不要猜價格。

頻率限制

除非區塊另有說明：每組 API 金鑰每 5 分鐘 500 次請求，每個 IP 每 5 分鐘 500 次請求。視窗在 5 分鐘後重設。

錯誤

（各端點專屬的錯誤列在各區塊裡）：

狀態碼回應內容情況
403{"error_code": "ERR005", "message": "API key and Secret key are required."}缺少標頭（API plan or Blave Agent plan 端點）
422{"error_code": "ERR001", "message": "Token is invalid or expired."}缺少標頭（Any valid key 端點）
403{"error_code": "ERR005", "message": "Invalid API key."} / "Invalid Secret key."金鑰組合錯誤
403{"error_code": "ERR007", "message": "…", "next_steps": {…}}金鑰所屬帳號未涵蓋（見上方的金鑰規則）：自己建立的金鑰沒有 API 方案，或 Blave Agent 的金鑰沒有方案也沒有試用，message 會說明是哪一種
429{"error_code": "ERR429", "message": "Rate limit exceeded."}觸發頻率限制
500{"error": "Internal error"} 或 HTML 錯誤頁非預期的伺服器錯誤

時間戳

除非區塊另有說明，一律是 UTC。台灣市場的 date 欄位是台北的交易日（YYYY-MM-DD）。