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）。