Blave API Reference

Crypto and Taiwan market data over REST. 89 endpoints, one key pair.

Last updated 2026-10
Create API Key See API plans
Crypto39
General · Tool · Alpha · Raw data
Taiwan Stock31
Market Data · Fundamentals · Institutional Flow · Other
Taiwan Market5
TAIEX Daily OHLC · Market Turnover · Market Institutional Net Buy/Sell
Taiwan Futures & Options12
OHLCV · Minute-Line Symbols · 1m Yearly Export
Commodities & Macro2
Commodities · Macro

Authentication

https://api.blave.org — every path below is relative to it.

api-key + secret-key on every request (create a key at the API key page).

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 & Plans

What the key's account needs, per endpoint (Access row in each block):

ValueMeaning
API plan or Blave Agent planValid key, and the account's plan covers that key — see the key rules below. Not covered → 403 ERR007
Any valid keyValid key only — no plan check

Key rules:

  • A key you created yourself (API page above — what your own scripts and external agents use outside Blave Agent) needs an API plan, even if the account also has a Blave Agent plan or trial.
  • Keys Blave Agent issues (the cloud machine's own key, the desktop app's sign-in key) are covered by the card trial, an active Blave Agent plan (every tier includes data) or an API plan.
  • Not covered → 403 ERR007; its message and next_steps name the way out — follow them, do not guess a price.

Rate Limits

Unless a block says otherwise: 500 requests / 5 min per API key, and 500 requests / 5 min per IP. The window resets after 5 minutes. A few endpoints that compute each response on request carry an extra, lower limit in their block (on top of the shared one); when that one is hit the 429 message names it and the response carries Retry-After (seconds until that key's window on that endpoint resets).

Errors

(endpoint-specific errors are listed in each block):

StatusBodyWhen
403{"error_code": "ERR005", "message": "API key and Secret key are required."}Header missing (API plan or Blave Agent plan endpoints)
422{"error_code": "ERR001", "message": "Token is invalid or expired."}Header missing (Any valid key endpoints)
403{"error_code": "ERR005", "message": "Invalid API key."} / "Invalid Secret key."Wrong key pair
403{"error_code": "ERR007", "message": "…", "next_steps": {…}}The key's account is not covered (key rules above): a self-created key without an API plan, or a Blave Agent key without a plan or trial — message says which
429{"error_code": "ERR429", "message": "Rate limit exceeded."}Shared rate limit hit
429{"error_code": "ERR429", "message": "Rate limit exceeded: this endpoint allows 200 requests per hour per API key."} + Retry-After headerPer-endpoint limit hit (only endpoints whose block lists one)
500{"error": "Internal error"} or an HTML error pageUnexpected server error

Timestamps

Are UTC unless a block says otherwise. Taiwan market date fields are Taipei trading days (YYYY-MM-DD).