Blave API リファレンス

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

最終更新 2026-10

認証

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 分後にリセットされます。

エラー

(エンドポイント固有のエラーは各エンドポイントに記載しています):

ステータスレスポンスボディ条件
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)です。