Referencia de la API de Blave

Datos de cripto y del mercado de Taiwán por REST. 89 endpoints, un par de claves.

Última actualización 2026-10

Autenticación

https://api.blave.org — todas las rutas siguientes son relativas a ella.

api-key + secret-key en cada solicitud (cree una clave en la página de claves 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"

Acceso y planes

Qué necesita la cuenta de la clave, según el endpoint (fila «Acceso» de la página, Access en el original):

ValorSignificado
API plan or Blave Agent planClave válida y el plan de la cuenta cubre esa clave — véanse las reglas de claves más abajo. Sin cobertura → 403 ERR007
Any valid keySolo clave válida — sin comprobación de plan

Reglas de claves:

  • Una clave creada por usted (página de API de arriba — la que usan sus propios scripts y los agentes externos fuera de Blave Agent) necesita un plan API, aunque la cuenta tenga además un plan o una prueba de Blave Agent.
  • Las claves que emite Blave Agent (la clave propia de la máquina en la nube, la clave de inicio de sesión de la app de escritorio) están cubiertas por la prueba con tarjeta, por un plan de Blave Agent activo (todos los niveles incluyen datos) o por un plan API.
  • Sin cobertura → 403 ERR007; su message y su next_steps indican cómo resolverlo — sígalos, no suponga un precio.

Límites de uso

Salvo que un bloque indique lo contrario: 500 solicitudes / 5 min por clave API y 500 solicitudes / 5 min por IP. La ventana se reinicia a los 5 minutos.

Errores

(los errores específicos de cada endpoint se indican en su bloque):

EstadoCuerpoCuándo
403{"error_code": "ERR005", "message": "API key and Secret key are required."}Falta el encabezado (endpoints API plan or Blave Agent plan)
422{"error_code": "ERR001", "message": "Token is invalid or expired."}Falta el encabezado (endpoints Any valid key)
403{"error_code": "ERR005", "message": "Invalid API key."} / "Invalid Secret key."Par de claves incorrecto
403{"error_code": "ERR007", "message": "…", "next_steps": {…}}La cuenta de la clave no tiene cobertura (reglas de claves de arriba): una clave creada por el usuario sin plan API, o una clave de Blave Agent sin plan ni prueba — message indica cuál
429{"error_code": "ERR429", "message": "Rate limit exceeded."}Límite de uso alcanzado
500{"error": "Internal error"} o una página de error HTMLError inesperado del servidor

Marcas de tiempo

Están en UTC salvo que un bloque indique lo contrario. Los campos date del mercado de Taiwán son días de negociación de Taipéi (YYYY-MM-DD).