Referência da API da Blave

Dados de cripto e do mercado de Taiwan via REST. 89 endpoints, um par de chaves.

Última atualização 2026-10
Criar chave de API Ver planos de API
Cripto39
Geral · Ferramenta · Alpha · Dados brutos
Ações TW31
Dados de mercado · Fundamentos · Fluxo institucional · Outros
Mercado de Taiwan5
OHLC diário do TAIEX · Volume negociado do mercado · Compra/venda líquida institucional do mercado
Futuros e opções de Taiwan12
OHLCV · Símbolos com dados por minuto · Exportação anual de 1m
Commodities e macro2
Commodities · Macro

Autenticação

https://api.blave.org — todos os caminhos abaixo são relativos a ela.

api-key + secret-key em toda requisição (crie uma chave em a página de chaves de 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"

Acesso e planos

O que a conta da chave precisa ter, por endpoint (linha «Acesso» da página, Access no original):

ValorSignificado
API plan or Blave Agent planChave válida, e o plano da conta cobre essa chave — veja as regras de chaves abaixo. Sem cobertura → 403 ERR007
Any valid keyApenas chave válida — sem verificação de plano

Regras de chaves:

  • Uma chave que você mesmo criou (página de API acima — a que seus próprios scripts e agentes externos usam fora do Blave Agent) precisa de um plano API, mesmo que a conta também tenha um plano ou um teste do Blave Agent.
  • As chaves emitidas pelo Blave Agent (a chave do próprio servidor na nuvem, a chave de login do app de desktop) são cobertas pelo teste com cartão, por um plano ativo do Blave Agent (todos os níveis incluem dados) ou por um plano API.
  • Sem cobertura → 403 ERR007; os campos message e next_steps indicam a saída — siga-os, não tente adivinhar um preço.

Limites de requisições

Salvo indicação em contrário no bloco: 500 requisições / 5 min por chave de API e 500 requisições / 5 min por IP. A janela é reiniciada após 5 minutos.

Erros

(os erros específicos de cada endpoint estão listados em cada bloco):

StatusCorpoQuando
403{"error_code": "ERR005", "message": "API key and Secret key are required."}Cabeçalho ausente (endpoints API plan or Blave Agent plan)
422{"error_code": "ERR001", "message": "Token is invalid or expired."}Cabeçalho ausente (endpoints Any valid key)
403{"error_code": "ERR005", "message": "Invalid API key."} / "Invalid Secret key."Par de chaves incorreto
403{"error_code": "ERR007", "message": "…", "next_steps": {…}}A conta da chave não tem cobertura (regras de chaves acima): uma chave criada por você sem um plano API, ou uma chave do Blave Agent sem plano nem teste — message diz qual é o caso
429{"error_code": "ERR429", "message": "Rate limit exceeded."}Limite de requisições atingido
500{"error": "Internal error"} ou uma página de erro em HTMLErro inesperado do servidor

Marcas de tempo

São em UTC, salvo indicação em contrário no bloco. Os campos date do mercado de Taiwan são dias de negociação de Taipei (YYYY-MM-DD).