Estado de la API de Bitcoin Intelligence
La página comprueba en el momento la disponibilidad, la antigüedad de los datos y el número de muestras de las entradas principales: precio actual de BTC, historial, puntuación del ciclo y modelo de ley de potencia. Consúltala antes de llamar a la API o de citar datos; no expone ninguna credencial interna.
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
- No requiere datos; botón «Check again» para volver a comprobar
- Datos de /api/bitcoin-intelligence-status
Qué muestra
- Estado general: operational, degraded o unavailable, con hora de comprobación, tiempo de respuesta (ms) y versión de datos
- Tarjetas de 4 componentes: ticker, weekly-history, cycle-score y power-law-model
- Cada tarjeta muestra estado, descripción y antigüedad frente al umbral (horas), o «No timestamp»
- Enlaces al JSON de estado y a la documentación de la API
Cómo usarla
- Abre la página y lee el estado general en la parte superior.
- Revisa cada componente para ver cuál está desactualizado o no disponible.
- Compara la antigüedad de cada componente con su umbral.
- Pulsa «Check again» pasados unos minutos si el estado es degraded.
- Anota la versión de datos cuando cites cifras.
Fórmula
Umbrales de frescura: ticker 1 h, historial 240 h, puntuación del ciclo 72 h, modelo de ley de potencia 240 h. Componente = unavailable si falla su comprobación (el historial necesita al menos 60 observaciones mensuales válidas; el modelo, al menos 100 muestras semanales), stale si antigüedad > umbral y operational en otro caso. Estado general = unavailable si hay ≥ 2 componentes unavailable (HTTP 503); degraded si hay 1 unavailable o alguno stale; operational en el resto.
Ejemplo
El ticker está en 0,4 h / 1 h, el historial en 100 h / 240 h y el modelo de ley de potencia en 100 h / 240 h, pero la puntuación del ciclo tiene 80 h con un umbral de 72 h. Como 80 > 72, cycle-score queda stale y el estado general es degraded, no unavailable.
Cómo interpretarlo
- operational significa que todos los componentes están disponibles y dentro de su umbral de frescura.
- degraded suele deberse a una fuente retrasada; los datos siguen siendo utilizables, pero conviene anotar la fecha.
- unavailable (HTTP 503) indica al menos 2 componentes caídos; espera antes de hacer llamadas masivas.
Limitaciones y avisos
- Es una comprobación puntual en el momento de la petición, no un SLA.
- La respuesta se guarda en caché (hasta 5 minutos en el edge), así que el estado puede ir algo por detrás.
- Retrasos breves de la fuente o errores de red pueden mostrar degraded de forma temporal.
Preguntas frecuentes
¿La página expone claves o direcciones internas?
No. La respuesta solo contiene estados, antigüedades y recuentos de muestras; no incluye secretos, direcciones internas, datos de suscriptores ni credenciales de proveedores.
¿Qué significa «No timestamp»?
Que el componente no tiene marca de tiempo de origen para calcular su antigüedad; si su comprobación de disponibilidad pasa, cuenta como operational.
¿Puedo consultar el estado por API?
Sí. GET /api/bitcoin-intelligence-status devuelve JSON con HTTP 200 si está operational o degraded y HTTP 503 si está unavailable.