Contagem regressiva e histórico do halving do Bitcoin
Contagem regressiva e histórico do halving do Bitcoin
/api/indicators/halvingRequisição
Este endpoint não recebe parâmetros.
Exemplo de requisição
curl -s "https://www.coinboss.com/api/indicators/halving"Campos da resposta
A tabela de campos é gerada a partir de respostas reais, portanto lista exatamente o que o endpoint retorna. Os caminhos usam a[] para itens de array e {*} para objetos indexados por um nome dinâmico, como uma moeda ou uma corretora.
| Campo | Tipo | Unidade | Descrição |
|---|---|---|---|
| success | boolean | — | true quando a requisição foi bem-sucedida. Em caso de falha, o corpo é `{ success: false, code, error, request_id }`. |
| fetched_at | number | ms | Quando a CoinBoss obteve os dados da fonte. |
| height | number | — | Altura do bloco. |
| halving | object | — | Contagem regressiva para o halving do Bitcoin, calculada a partir da altura de bloco atual. |
| halving.epoch | number | count | Número de halvings que já ocorreram: floor(altura ÷ 210,000). |
| halving.last_halving_height | number | blocks | Altura de bloco do halving mais recente. |
| halving.next_halving_height | number | blocks | Altura de bloco em que ocorre o próximo halving. |
| halving.remaining_blocks | number | blocks | Blocos restantes até o próximo halving. |
| halving.progress_pct | number | % | Progresso na época atual de 210,000 blocos: (altura − `last_halving_height`) ÷ 210,000 × 100. |
| halving.avg_block_ms | number | ms | Intervalo médio recente entre blocos, de uma fonte pública de dados de blockchain; usa-se 600000 quando ele está indisponível. |
| halving.eta_ms | number | ms | Horário estimado do próximo halving: agora + `remaining_blocks` × `avg_block_ms`. Uma estimativa que varia com o intervalo entre blocos. |
| halving.current_reward | number | BTC | Subsídio de bloco atual: 50 ÷ 2^`epoch`. |
| halving.next_reward | number | BTC | Subsídio de bloco após o próximo halving: metade de `current_reward`. |
| halving.history | array | — | Pontos históricos, do mais antigo para o mais recente, salvo indicação em contrário. |
| halving.history[] | object | — | Pontos históricos, do mais antigo para o mais recente, salvo indicação em contrário. |
| halving.history[].height | number | — | Altura do bloco. |
| halving.history[].date | string | — | Data do calendário (UTC). |
| halving.history[].reward | number | BTC | Subsídio de bloco que passou a valer a partir desse halving. |
| difficulty | null | — | Sempre null: não é fornecida uma estimativa do próximo ajuste de dificuldade. |
| current_difficulty | object | — | Dificuldade de mineração atual do Bitcoin com o horário da leitura. |
| current_difficulty.value | number | — | Valor. |
| current_difficulty.as_of | number | ms | Horário em que a dificuldade foi lida. |
| current_difficulty.source | string | — | De onde vem o valor. |
| sources | object | — | Fontes de dados. |
| sources.height | string | — | Altura do bloco. |
| sources.block_interval | string | — | Nome da fonte de `avg_block_ms`; null quando foi usado o padrão de 10 minutos. |
| sources.current_difficulty | string | — | Origem do valor da dificuldade. |
Gerada 2026-11-11 23:01 UTC a partir de 1 respostas reais.
Exemplo de resposta
/api/indicators/halving · Resposta real capturada 2026-11-13 03:18:34 UTC. Arrays e mapas longos são encurtados para exibição: halving.history tinha 4 itens.
- "success"true
- "fetched_at"1794539916200
- "height"975627
- "halving"
- "epoch"4
- "last_halving_height"840000
- "next_halving_height"1050000
- "remaining_blocks"74373
- "progress_pct"64.58
- "avg_block_ms"793495
- "eta_ms"1853554519835
- "current_reward"3.125
- "next_reward"1.5625
- "history"
- "difficulty"null
- "current_difficulty"
- "value"148364561003867
- "as_of"1794539916200
- "source""blockchain.info"
- "sources"
- "height""blockchain.info"
- "block_interval""blockchain.info"
- "current_difficulty""blockchain.info"
Detalhes
- Autenticação
- Nenhuma. Endpoint público.
- Limite de requisições
- 1200 requisições por minuto por IP
- Cache do servidor
- 2m
- Microcache de borda
- 10s
- Frequência de atualização
- sob demanda, em cache por 2 minutos
- Janela
- snapshot mais recente
- Fontes de dados
- Contagem regressiva para o halving do Bitcoin, calculada internamente a partir da altura atual do bloco reportada por APIs públicas de blockchain.
- Cobertura de corretoras
- Somente Bitcoin; `difficulty` é sempre 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.
- Timestamps
- Milissegundos da época Unix (UTC), salvo se a descrição do campo indicar o contrário
- Formato da resposta
- json
- Estabilidade
- Estável
Status ao vivo
A altura do bloco é ao vivo. `current_difficulty` traz a dificuldade da rede com seu timestamp e sua fonte; `difficulty` (progresso do reajuste) é `null` enquanto a sua fonte está indisponível.
Disponibilidade, últimos 30 dias
100% de 400 verificações aprovadas
Erros
As chamadas com falha têm o mesmo formato em todos os endpoints. A lista completa está na página de erros. Erros e limites de requisições →
| Código | HTTP | Significado | O que fazer |
|---|---|---|---|
| INVALID_PARAM | 400 | Falta um parâmetro obrigatório ou um valor não é aceito. `param` indica o nome do parâmetro quando ele é conhecido. | Não repita a requisição sem alterações; corrija-a. |
| UNAUTHORIZED | 401 | O cabeçalho `CB-API-KEY` foi enviado, mas a chave é desconhecida ou foi revogada. Dados públicos não exigem chave — remova o cabeçalho ou use uma chave válida. | Não repita a requisição sem alterações. |
| FORBIDDEN | 403 | A rota não faz parte da API pública (é interna ou exclusiva de conta). | Não tente novamente. |
| NOT_FOUND | 404 | Rota desconhecida, ou a moeda / corretora / fundo solicitado não existe. | Não tente novamente; confira o caminho e os identificadores no catálogo. |
| RATE_LIMITED | 429 | Mais requisições do que o limite por minuto. `Retry-After` informa os segundos a aguardar. | Aguarde `Retry-After` e então tente novamente com backoff. |
| INTERNAL | 500 | Erro inesperado do servidor. A mensagem é genérica de propósito; cite `request_id` ao reportá-lo. | Tente novamente uma vez após alguns segundos; se persistir, reporte-o com o ID da requisição. |
| UPSTREAM_FAILED | 503 | A fonte de dados por trás deste endpoint não respondeu a tempo. Nenhum número desatualizado ou substituto é retornado em seu lugar. | Tente novamente com backoff; consulte a página de status. |
| UNAVAILABLE | 501 / 503 | O conjunto de dados ainda não está pronto temporariamente (aquecimento do cache) ou o endpoint ainda não tem uma fonte pública lícita. | Tente novamente mais tarde; o catálogo marca os endpoints que são indisponíveis por design. |
| REQUEST_FAILED | 200 | Alguns endpoints mais antigos respondem HTTP 200 com `success: false`. Verifique sempre `success`, não apenas o status HTTP. | Depende da mensagem; trate como uma requisição com falha. |
Experimente
/api/indicators/halvingParcialSem parâmetros.
https://www.coinboss.com/api/indicators/halvingMais nesta categoria
- Consulta de endereço multichain /api/browser/:chain/address/:addr
- Consulta de bloco multichain /api/browser/:chain/block/:hashOrHeight
- Consulta de transação multichain /api/browser/:chain/tx/:txid
- Detecta em quais redes EVM um endereço está ativo /api/browser/detect
- Variações de saldo entre os endereços da lista de maiores detentores de BTC /api/btc/rich-flow
- Lista de maiores detentores de BTC /api/btc/rich-list
- Estatísticas da lista de maiores detentores de BTC /api/btc/rich-stat
- Tendência dos saldos da lista de maiores detentores de BTC /api/btc/rich-trend
- Resumo de um endereço Bitcoin /api/explorer/address/:addr
- Transações de um endereço Bitcoin /api/explorer/address/:addr/txs
- Detalhe de um bloco Bitcoin /api/explorer/block/:hashOrHeight
- Topo da cadeia do Bitcoin /api/explorer/tip
- Detalhe de uma transação Bitcoin /api/explorer/tx/:txid
- Número de endereços de BTC com saldo acima de um limiar /api/indicators/addr-above/:tier
- Série de indicadores de valuation on-chain do BTC /api/indicators/bdc/:name
- Número e distribuição dos nós alcançáveis do Bitcoin /api/indicators/bitnodes
- Série comparativa de detentores de BTC /api/indicators/btccmp/:pair
- Séries de gráficos on-chain do BTC /api/indicators/chain
- Histórico de entradas / saídas de BTC nas corretoras /api/indicators/cm/exchange-flows
- Oferta de BTC mantida em corretoras /api/indicators/cm/exchange-supply
- Histórico do número de endereços de BTC com saldo diferente de zero /api/indicators/cm/nonzero-addresses
- Participações em BTC de governos /api/indicators/gov-treasuries
- Contagem regressiva e histórico do halving do Bitcoin /api/indicators/halving
- Parcela da oferta de BTC inativa há mais de N anos /api/indicators/hodl-wave-above/:years
- Participação dos pools de mineração nos blocos do Bitcoin /api/indicators/mempool/pools
- Histórico do custo médio e das participações em BTC da Strategy /api/indicators/mstr-cost
- Parcela da oferta de BTC em lucro /api/indicators/supply-profit-pct
- Histórico do saldo de reservas do WBTC /api/indicators/wbtc-balance
- Lista de maiores detentores multichain /api/rich-list/:chain
- Variações de saldo da lista de maiores detentores multichain /api/rich-list/:chain/flow
- Estatísticas da lista de maiores detentores multichain /api/rich-list/:chain/stat
- Tendência dos saldos da lista de maiores detentores multichain /api/rich-list/:chain/trend
- Tesourarias em cripto de empresas de capital aberto / instituições /api/treasuries/:coin