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 https://blave.org/landing/en/api?tab=blave).

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 data feeValid key, and the account's billing covers data — see Which key, which plan below. Not covered → 403 ERR007
Any valid keyValid key only — no plan check, no data fee

Blave Agent is moving from hourly billing to plan billing; each account switches on a date the platform emails that user.

  • A key you created yourself (API page above — what scripts, external agents and this skill use outside Blave Agent): on plan billing it needs an API plan, even if the account also has a Blave Agent plan or trial. Before the account switches, it also works when the account owns a Blave Agent machine, or with the hourly data fee charged from credit.
  • Keys Blave Agent issues (the cloud machine's own key, the desktop app's sign-in key): 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.

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 data fee 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 (see Which key, which plan): a self-created key without an API plan, no Blave Agent plan, or the hourly data fee could not be charged — message says which
429{"error_code": "ERR429", "message": "Rate limit exceeded."}Rate limit hit
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).