Volume 24h—Positions ouvertes—Liquidations 24h$1.36BLong/Short 24h—Dominance BTC—Dominance ETH—
App
Langue ▾
€ EUR ▾
/api/indicators/halving
GETPartiel

Compte à rebours et historique du halving Bitcoin

Compte à rebours et historique du halving Bitcoin

GET/api/indicators/halving
Couverture partielle. La hauteur de bloc est en direct. `current_difficulty` porte la difficulté du réseau avec son horodatage et sa source ; `difficulty` (progression vers le prochain ajustement) vaut `null` tant que sa source est indisponible.

Requête

Cet endpoint n'accepte aucun paramètre.

Exemple de requête

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

Champs de la réponse

Le tableau des champs est généré à partir de réponses réelles : il liste donc exactement ce que renvoie l'endpoint. Les chemins utilisent a[] pour les éléments d'un tableau et {*} pour les objets indexés par un nom dynamique, comme une crypto ou une plateforme.

ChampTypeUnitéDescription
successboolean—true lorsque la requête a abouti. En cas d'échec, le corps est `{ success: false, code, error, request_id }`.
fetched_atnumbermsMoment où CoinBoss a récupéré les données auprès de la source.
heightnumber—Hauteur de bloc.
halvingobject—Compte à rebours du halving de Bitcoin, calculé à partir de la hauteur de bloc actuelle.
halving.epochnumbercountNombre de halvings déjà survenus : floor(hauteur ÷ 210 000).
halving.last_halving_heightnumberblocksHauteur de bloc du halving le plus récent.
halving.next_halving_heightnumberblocksHauteur de bloc à laquelle aura lieu le prochain halving.
halving.remaining_blocksnumberblocksBlocs restants avant le prochain halving.
halving.progress_pctnumber%Progression dans l'époque en cours de 210 000 blocs : (hauteur − `last_halving_height`) ÷ 210 000 × 100.
halving.avg_block_msnumbermsIntervalle moyen récent entre les blocs, issu d'une source publique de données blockchain ; 600000 est utilisé lorsqu'elle est indisponible.
halving.eta_msnumbermsHeure estimée du prochain halving : maintenant + `remaining_blocks` × `avg_block_ms`. Estimation qui évolue avec l'intervalle entre les blocs.
halving.current_rewardnumberBTCSubvention de bloc actuelle : 50 ÷ 2^`epoch`.
halving.next_rewardnumberBTCSubvention de bloc après le prochain halving : la moitié de `current_reward`.
halving.historyarray—Points historiques, du plus ancien au plus récent sauf mention contraire.
halving.history[]object—Points historiques, du plus ancien au plus récent sauf mention contraire.
halving.history[].heightnumber—Hauteur de bloc.
halving.history[].datestring—Date calendaire (UTC).
halving.history[].rewardnumberBTCSubvention de bloc en vigueur à partir de ce halving.
difficultynull—Toujours null : aucune estimation du prochain ajustement de difficulté n'est fournie.
current_difficultyobject—Difficulté de minage actuelle de Bitcoin avec son heure de lecture.
current_difficulty.valuenumber—Valeur.
current_difficulty.as_ofnumbermsHeure à laquelle la difficulté a été lue.
current_difficulty.sourcestring—Provenance de la valeur.
sourcesobject—Sources de données.
sources.heightstring—Hauteur de bloc.
sources.block_intervalstring—Nom de la source de `avg_block_ms` ; null lorsque la valeur par défaut de 10 minutes a été utilisée.
sources.current_difficultystring—Origine de la valeur de difficulté.

Généré à partir de 1 réponses réelles (2026-11-11 23:01 UTC).

Exemple de réponse

/api/indicators/halving · Réponse réelle (capture : 2026-11-13 03:59:14 UTC). Les tableaux et dictionnaires longs sont abrégés pour l'affichage : halving.history comptait 4 éléments.

  • {
    • "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"
      }
    }

Détails

Authentification
Aucune. Endpoint public.
Limite de requêtes
1200 requêtes par minute et par IP
Cache serveur
2m
Micro-cache en périphérie
10s
Fréquence de mise à jour
à la demande, mis en cache 2 minutes
Fenêtre
dernier instantané
Sources de données
Compte à rebours du halving de Bitcoin, calculé en interne à partir de la hauteur de bloc actuelle communiquée par des API blockchain publiques.
Couverture des plateformes
Bitcoin uniquement ; `difficulty` vaut toujours null.
Unités
blocks; milliseconds (avg_block_ms, eta_ms); BTC (block reward); percent (progress)
Méthode
Next halving height = (epoch + 1) x 210000; ETA = now + remaining blocks x average block interval (600 s fallback); reward = 50 / 2^epoch.
Horodatages
Millisecondes depuis l'epoch Unix (UTC), sauf indication contraire dans la description du champ
Format de réponse
json
Stabilité
Stable

Statut en direct

PartielVérifié : 2026-11-13 03:59:14 UTCHTTP 2001066 msSchéma conforme

La hauteur de bloc est en direct. `current_difficulty` porte la difficulté du réseau avec son horodatage et sa source ; `difficulty` (progression vers le prochain ajustement) vaut `null` tant que sa source est indisponible.

Disponibilité, 30 derniers jours

100 % des 408 contrôles réussis

Erreurs

Les appels en échec ont la même structure sur tous les endpoints. La liste complète figure sur la page des erreurs. Erreurs et limites de requêtes →

CodeHTTPSignificationQue faire
INVALID_PARAM400Un paramètre requis est manquant ou une valeur n'est pas acceptée. `param` indique le nom du paramètre lorsqu'il est connu.Ne réessayez pas à l'identique ; corrigez la requête.
UNAUTHORIZED401L'en-tête `CB-API-KEY` a été envoyé, mais la clé est inconnue ou révoquée. Les données publiques ne nécessitent aucune clé — supprimez l'en-tête ou utilisez une clé valide.Ne réessayez pas à l'identique.
FORBIDDEN403La route ne fait pas partie de l'API publique (interne ou réservée aux comptes).Ne réessayez pas.
NOT_FOUND404Route inconnue, ou la crypto / la plateforme / le fonds demandé n'existe pas.Ne réessayez pas ; vérifiez le chemin et les identifiants dans le catalogue.
RATE_LIMITED429Plus de requêtes que la limite par minute. `Retry-After` indique le nombre de secondes à attendre.Attendez la durée indiquée par `Retry-After`, puis réessayez avec backoff.
INTERNAL500Erreur serveur inattendue. Le message est volontairement générique ; citez `request_id` lorsque vous la signalez.Réessayez une fois après quelques secondes ; si l'erreur persiste, signalez-la avec l'ID de requête.
UPSTREAM_FAILED503La source de données derrière cet endpoint n'a pas répondu à temps. Aucun chiffre périmé ni de substitution n'est renvoyé à sa place.Réessayez avec backoff ; consultez la page de statut.
UNAVAILABLE501 / 503Le jeu de données n'est temporairement pas prêt (préchauffage du cache) ou l'endpoint n'a pas encore de source publique licite.Réessayez plus tard ; le catalogue signale les endpoints indisponibles par conception.
REQUEST_FAILED200Certains endpoints plus anciens répondent HTTP 200 avec `success: false`. Vérifiez toujours `success`, et pas seulement le statut HTTP.Dépend du message ; à traiter comme une requête en échec.

Essayer

GET/api/indicators/halvingPartiel
Paramètres

Aucun paramètre.

URL de la requêtehttps://www.coinboss.com/api/indicators/halving
Choisissez un endpoint et cliquez sur « Envoyer la requête ». La réponse, les en-têtes et le temps de réponse s'afficheront ici.