Documentación de la API de Bitcoin Intelligence
Documentación de los endpoints públicos, de solo lectura y sin clave de API de Bitcoin Intelligence: métricas actuales, historial mensual sin datos del futuro, anomalías, estado, citas e instantáneas de investigación. Detalla parámetros, caché en el edge, límite de uso justo, códigos de estado y requisitos de atribución.
La interfaz interactiva de este laboratorio está en inglés; la guía de abajo describe todas las entradas, el método y los límites.
Datos de entrada
- /api/bitcoin-intelligence-history: years=1–20 (por defecto 10), limit=12–240 (por defecto 180)
- /api/bitcoin-intelligence-anomalies: lookback=12–60 (por defecto 36), limit=1–60 (por defecto 24)
- /api/bitcoin-research-snapshots: id=bir_… (obligatorio)
- Los endpoints de métricas actuales, estado, cita y OpenAPI no llevan parámetros
Qué muestra
- Tarjetas de 7 endpoints: ruta, datos devueltos, parámetros, caché en el edge (15 min, 6 h, 5 min, inmutable o 24 h) y autenticación (ninguna)
- Ejemplo de cURL con botón de copiar
- Códigos de estado: 200 éxito, 429 límite de uso superado, 502/503 fuente o historial no disponible temporalmente
- Reglas de atribución y de versionado (schemaVersion), y documento OpenAPI 3.1 legible por máquina en /api/bitcoin-intelligence-openapi
Cómo usarla
- Elige el endpoint: métricas actuales, historial mensual, anomalías, estado o cita.
- Pulsa «Open response» para ver un JSON real o copia el comando cURL.
- En uso masivo, guarda en caché las respuestas y respeta el 429 y la cabecera Retry-After.
- Lee schemaVersion en la respuesta para gestionar cambios futuros de campos.
- Al republicar datos, cita a CryptoRebateHub y enlaza al terminal o a la página de metodología.
Ejemplo
El comando curl -s "https://cryptorebatehub.com/api/bitcoin-intelligence-history?years=5&limit=60" devuelve hasta 60 observaciones mensuales. El límite de uso justo es de 120 solicitudes de función por IP y minuto, es decir, una media de 120 ÷ 60 = 2 por segundo; los aciertos de caché en el edge normalmente no consumen esa cuota.
Cómo interpretarlo
- La caché indica cuánto pueden tener de antigüedad los datos: estado 5 min, métricas actuales 15 min, historial, anomalías y cita 6 h.
- Las respuestas versionadas incluyen dataVersion y methodologyVersion para registrar exactamente qué datos usaste.
- Los campos nuevos se añaden de forma compatible; los cambios incompatibles suben schemaVersion e incluyen notas de migración.
Limitaciones y avisos
- La API gratuita no tiene SLA de disponibilidad; si falla la fuente puede devolver 502 o 503.
- No presentes los campos estimados como hechos on-chain en bruto.
- Crear instantáneas (POST) solo acepta peticiones del mismo origen desde el navegador; los registros son públicos para siempre y se rechazan los campos sensibles.
Preguntas frecuentes
¿Necesito registrarme o una clave de API?
No. Todos los endpoints de lectura son públicos y no requieren autenticación.
¿Cuál es el límite de peticiones?
120 solicitudes de función por IP y minuto. Si lo superas, la API responde 429 con Retry-After; los aciertos de caché en el edge normalmente no cuentan.
¿Hay documentación legible por máquina?
Sí. GET /api/bitcoin-intelligence-openapi devuelve el documento OpenAPI 3.1 en JSON.