Blave API リファレンス

暗号資産と台湾市場のデータを REST で取得。89 個のエンドポイントを、ひと組のキーで。

最終更新 2026-10
API キーを作成 API プランを見る
暗号資産39
一般 · ツール · Alpha · 生データ
台湾株31
マーケットデータ · ファンダメンタルズ · 機関投資家の売買動向 · その他
台湾市場全体5
TAIEX 日足 OHLC · 市場全体の売買高 · 市場全体の三大機関投資家の売買差額
台湾先物・オプション12
OHLCV · 分足の対応シンボル · 1m 年次エクスポート
商品先物・マクロ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 ページで作成。自分のスクリプトや外部エージェントが Blave Agent の外で使うもの）には、アカウントに Blave Agent のプランやトライアルがあっても API プランが必要です。
  • Blave Agent が発行するキー（クラウドマシン自身のキー、デスクトップアプリのサインインキー）は、カード登録のトライアル、有効な Blave Agent のプラン（どのプランにもデータが含まれます）、または API プランでカバーされます。
  • カバーされていない場合 → 403 ERR007。その message と next_steps に対処方法が示されます。それに従い、価格を推測しないでください。

レート制限

各エンドポイントに別記がない限り：API キーごとに 500 リクエスト／5 分、かつ IP ごとに 500 リクエスト／5 分。期間は 5 分後にリセットされます。リクエストごとにレスポンスを計算する一部のエンドポイントは、そのブロックに別の低い上限を記載しています（共通の上限に加えて適用）。その上限に達すると 429 のメッセージがそれを明示し、レスポンスに Retry-After（そのキーのそのエンドポイントでの期間がリセットされるまでの秒数）が付きます。

エラー

（エンドポイント固有のエラーは各エンドポイントに記載しています）：

ステータスレスポンスボディ条件
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."}共通のレート制限に到達
429{"error_code": "ERR429", "message": "Rate limit exceeded: this endpoint allows 200 requests per hour per API key."} ＋ Retry-After ヘッダーエンドポイント個別の上限に到達（ブロックに上限が記載されたエンドポイントのみ）
500{"error": "Internal error"} または HTML のエラーページ予期しないサーバーエラー

タイムスタンプ

各エンドポイントに別記がない限り UTC です。台湾市場の date フィールドは台北の取引日（YYYY-MM-DD）です。