Você
Software e solução de problemas

Primeiros passos com a API do pool

Última atualização: 5 de novembro de 2026

Leia as estatísticas ao vivo do pool e de cada minerador na API JSON pública: os dois endpoints, como consultar seu endereço e com que frequência.

O que posso fazer com a API do pool?

O pool tem uma API JSON pública, só de leitura, que fornece tudo o que o painel mostra. Ela não precisa de chave nem de conta.

Você pode usá-la para montar o seu próprio monitoramento, um painel em casa, um bot ou uma planilha que acompanha a sua mineração. Ela dá dois tipos de dados:

  • Estatísticas do pool inteiro: hashrate, dificuldade da rede, blocos e pagamentos.
  • Estatísticas por minerador para qualquer endereço.
Uma requisição curl ao endereço de estatísticas do pool, com o host do pool e o endpoint marcados em cor. Abaixo dela está a resposta JSON. A seção do pool tem hashrate, mineradores e workers, e a seção da rede tem dificuldade e altura.
O endereço indica o pool e os números que você quer. A resposta é um JSON simples, dividido entre o pool e a rede.

Como pego as estatísticas do pool inteiro?

O endpoint de estatísticas do pool retorna os mesmos números que você vê no cabeçalho e no painel:

  • Hashrate do pool e da rede.
  • Mineradores conectados.
  • Dificuldade.
  • Os últimos blocos.
  • Os pagamentos recentes.

Busque-o como qualquer URL JSON:

Estatísticas do pool 
curl https://qubitcoin.herominers.com/api/stats

Como pego as estatísticas do meu próprio endereço?

Para ler um endereço, passe-o ao endpoint de estatísticas do minerador. Troque YOUR_QTC_ADDRESS pelo endereço da sua carteira.

A resposta traz o hashrate, os workers, os saldos e os pagamentos recentes desse endereço. São os dados brutos por trás da página do seu painel:

Estatísticas do minerador 
curl https://qubitcoin.herominers.com/api/stats_address?address=YOUR_QTC_ADDRESS

Com que frequência devo consultar a API?

Uma vez a cada um ou dois minutos é mais que suficiente. A API existe para ser usada, mas consulte-a com educação.

Um cartão de resposta da API atualizado por um relógio. Em cima, uma rajada densa de requisições está riscada em vermelho, porque toda resposta é a mesma. Embaixo, uma requisição a cada tique do relógio, bem espaçadas, recebe um visto verde.
Os números são atualizados de tempos em tempos, então uma requisição a cada um ou dois minutos basta.

Os números por trás dela só são atualizados de tempos em tempos. Consultar muito mais vezes gasta banda dos dois lados e não traz dados mais novos.

Guarde em cache o que você busca. Siga o mesmo ritmo de atualização que o painel usa.

Pronto para colocar isso em prática?
O guia Como minerar escolhe o servidor mais próximo de você e monta o comando exato do seu programa de mineração.
Começar a minerar Qubitcoin