/api/indicators/halving
GETParcial

Cuenta atrás e historial del halving de Bitcoin

Cuenta atrás e historial del halving de Bitcoin

GET/api/indicators/halving
Cobertura parcial. La altura de bloque se sirve en vivo. `current_difficulty` contiene la dificultad de la red con su marca de tiempo y su fuente; `difficulty` (progreso del reajuste) es `null` mientras su fuente no está disponible.

Solicitud

Este endpoint no admite parámetros.

Solicitud de ejemplo

curl -s "https://www.coinboss.com/api/indicators/halving"

Campos de la respuesta

La tabla de campos se genera a partir de respuestas reales, por lo que recoge exactamente lo que devuelve el endpoint. Las rutas usan a[] para los elementos de un array y {*} para los objetos cuya clave es un nombre dinámico, como una moneda o un exchange.

CampoTipoUnidadDescripción
successboolean—true cuando la solicitud se completó correctamente. En caso de fallo, el cuerpo es `{ success: false, code, error, request_id }`.
fetched_atnumbermsCuándo obtuvo CoinBoss los datos de la fuente.
heightnumber—Altura de bloque.
halvingobject—Cuenta atrás del halving de Bitcoin calculada a partir de la altura de bloque actual.
halving.epochnumbercountNúmero de halvings que ya se han producido: floor(altura ÷ 210,000).
halving.last_halving_heightnumberblocksAltura de bloque del halving más reciente.
halving.next_halving_heightnumberblocksAltura de bloque en la que se produce el próximo halving.
halving.remaining_blocksnumberblocksBloques que faltan hasta el próximo halving.
halving.progress_pctnumber%Progreso dentro de la época actual de 210,000 bloques: (altura − `last_halving_height`) ÷ 210,000 × 100.
halving.avg_block_msnumbermsIntervalo medio reciente entre bloques procedente de una fuente pública de datos de blockchain; se usa 600000 cuando no está disponible.
halving.eta_msnumbermsHora estimada del próximo halving: ahora + `remaining_blocks` × `avg_block_ms`. Es una estimación que varía con el intervalo entre bloques.
halving.current_rewardnumberBTCSubsidio de bloque actual: 50 ÷ 2^`epoch`.
halving.next_rewardnumberBTCSubsidio de bloque tras el próximo halving: la mitad de `current_reward`.
halving.historyarray—Puntos históricos, del más antiguo al más reciente salvo que se indique otra cosa.
halving.history[]object—Puntos históricos, del más antiguo al más reciente salvo que se indique otra cosa.
halving.history[].heightnumber—Altura de bloque.
halving.history[].datestring—Fecha de calendario (UTC).
halving.history[].rewardnumberBTCSubsidio de bloque vigente a partir de ese halving.
difficultynull—Siempre null: no se proporciona una estimación del próximo ajuste de dificultad.
current_difficultyobject—Dificultad actual de minado de Bitcoin con su hora de lectura.
current_difficulty.valuenumber—Valor.
current_difficulty.as_ofnumbermsHora en que se leyó la dificultad.
current_difficulty.sourcestring—De dónde procede el valor.
sourcesobject—Fuentes de datos.
sources.heightstring—Altura de bloque.
sources.block_intervalstring—Nombre de la fuente de `avg_block_ms`; null cuando se usó el valor predeterminado de 10 minutos.
sources.current_difficultystring—Origen del valor de dificultad.

Generada 2026-11-11 23:01 UTC a partir de 1 respuestas reales.

Respuesta de ejemplo

/api/indicators/halving · Respuesta real capturada 2026-11-13 03:59:14 UTC. Los arrays y mapas largos se abrevian para su visualización: halving.history tenía 4 elementos.

  • {
    • "success": true,
    • "fetched_at": 1794542355398,
    • "height": 975627,
    • "halving": {
      • "epoch": 4,
      • "last_halving_height": 840000,
      • "next_halving_height": 1050000,
      • "remaining_blocks": 74373,
      • "progress_pct": 64.58,
      • "avg_block_ms": 776283,
      • "eta_ms": 1852276850957,
      • "current_reward": 3.125,
      • "next_reward": 1.5625,
      • "history": [ … 2 ]
      },
    • "difficulty": null,
    • "current_difficulty": {
      • "value": 148364561003867,
      • "as_of": 1794542355398,
      • "source": "blockchain.info"
      },
    • "sources": {
      • "height": "blockchain.info",
      • "block_interval": "blockchain.info",
      • "current_difficulty": "blockchain.info"
      }
    }

Detalles

Autenticación
Ninguna. Endpoint público.
Límite de solicitudes
1200 solicitudes por minuto por IP
Caché del servidor
2m
Microcaché de borde
10s
Frecuencia de actualización
bajo demanda, en caché 2 minutos
Ventana
última instantánea
Fuentes de datos
Cuenta atrás del halving de Bitcoin calculada internamente a partir de la altura de bloque actual que informan API públicas de blockchain.
Cobertura de exchanges
Solo Bitcoin; `difficulty` es siempre null.
Unidades
blocks; milliseconds (avg_block_ms, eta_ms); BTC (block reward); percent (progress)
Método
Next halving height = (epoch + 1) x 210000; ETA = now + remaining blocks x average block interval (600 s fallback); reward = 50 / 2^epoch.
Marcas de tiempo
Milisegundos de época Unix (UTC), salvo que la descripción del campo indique otra cosa
Formato de respuesta
json
Estabilidad
Estable

Estado en vivo

ParcialComprobado 2026-11-13 03:59:14 UTCHTTP 2001066 msEl esquema coincide

La altura de bloque se sirve en vivo. `current_difficulty` contiene la dificultad de la red con su marca de tiempo y su fuente; `difficulty` (progreso del reajuste) es `null` mientras su fuente no está disponible.

Disponibilidad, últimos 30 días

100% de 408 comprobaciones superadas

Errores

Las llamadas fallidas tienen la misma estructura en todos los endpoints. La lista completa está en la página de errores. Errores y límites de solicitudes →

CódigoHTTPSignificadoQué hacer
INVALID_PARAM400Falta un parámetro obligatorio o un valor no se acepta. `param` indica el nombre del parámetro cuando se conoce.No reintente sin cambios; corrija la solicitud.
UNAUTHORIZED401Se envió la cabecera `CB-API-KEY`, pero la clave es desconocida o está revocada. Los datos públicos no necesitan clave: elimine la cabecera o use una clave válida.No reintente sin cambios.
FORBIDDEN403La ruta no forma parte de la API pública (interna o solo para cuentas).No reintente.
NOT_FOUND404Ruta desconocida, o la moneda / el exchange / el fondo solicitado no existe.No reintente; compruebe la ruta y los identificadores en el catálogo.
RATE_LIMITED429Más solicitudes que el límite por minuto. `Retry-After` indica los segundos de espera.Espere el tiempo de `Retry-After` y después reintente con espera progresiva.
INTERNAL500Error inesperado del servidor. El mensaje es genérico por diseño; cite `request_id` al informar del error.Reintente una vez tras unos segundos; si persiste, infórmelo con el ID de solicitud.
UPSTREAM_FAILED503La fuente de datos de este endpoint no respondió a tiempo. No se devuelven cifras desactualizadas ni sustitutas en su lugar.Reintente con espera progresiva; consulte la página de estado.
UNAVAILABLE501 / 503El conjunto de datos no está listo temporalmente (calentamiento de la caché) o el endpoint aún no tiene una fuente pública lícita.Reintente más tarde; el catálogo marca los endpoints que no están disponibles por diseño.
REQUEST_FAILED200Algunos endpoints antiguos responden HTTP 200 con `success: false`. Compruebe siempre `success`, no solo el estado HTTP.Depende del mensaje; trátelo como una solicitud fallida.

Pruébelo

GET/api/indicators/halvingParcial
Parámetros

Sin parámetros.

URL de la solicitudhttps://www.coinboss.com/api/indicators/halving
Elija un endpoint y pulse «Enviar solicitud». Aquí aparecerán la respuesta, las cabeceras y los tiempos.