Colocar a cotação do Bitcoin em tempo real no seu site leva menos de um minuto: você copia um trecho de código e cola no HTML da página. O widget mostra Bitcoin e Ethereum em real, com a variação do dia, e se atualiza sozinho o tempo todo, inclusive de madrugada e no fim de semana. É gratuito, não pede cadastro e não tem limite de visualizações. Teste abaixo e pegue o código.
Bitcoin e Ethereum hoje
Pré-visualização
Código para incorporar
Resposta rápida
- Preço em real, não em dólar.
- Atualiza 24 horas por dia, todos os dias.
- Grátis, sem conta e sem chave de API.
- Funciona em WordPress, Wix, Blogger e site feito à mão.
Por que um widget de cripto não é igual a um de dólar
Parece a mesma coisa: um número que vem de fora e aparece na sua página. Na prática, cripto tem uma característica que muda tudo. O câmbio tradicional fecha. O dólar comercial tem horário de divulgação e fica parado à noite, no fim de semana e no feriado, então um widget de moeda pode buscar o valor em janelas mais espaçadas sem prejuízo nenhum para quem lê.
Bitcoin não faz isso. Ele se move às três da manhã de domingo, e é comum a variação mais forte da semana acontecer justamente fora do horário comercial. Um widget de cripto que herda a janela de atualização do câmbio mostra preço velho exatamente quando o mercado está andando, e o leitor que confere em outro lugar percebe. Esse é o defeito mais comum em widget de cripto brasileiro, e ele é invisível durante o dia útil.
O erro que faz um widget mentir sem parecer quebrado
Vale conhecer esse caso antes de instalar qualquer widget de cotação, seu ou de terceiro, porque ele é sutil. Quando a fonte do preço não responde, um widget mal construído preenche o campo de variação com zero. O visitante vê 0,00% e entende que o mercado está parado. Só que o mercado não está parado: o widget é que não conseguiu o dado.
A diferença entre "não variou" e "não sei" é enorme para quem confia no número. Um widget honesto avisa que a informação não está disponível, em vez de exibir um número que parece verdade. Vale checar isso no widget que você usa: se ele nunca mostra falha, provavelmente ele está inventando o valor quando falha.
Outro ponto na mesma linha é a origem do preço. Preço de cripto varia entre corretoras, e widget que cota só em dólar e converte por uma taxa qualquer pode exibir um valor que não bate com nenhuma corretora brasileira. Preferir fonte que já cota em real evita esse descolamento.
De onde vem o preço deste widget, exatamente
Se você mantém um portal financeiro ou um site de cripto, dizer "vem de uma API confiável" não basta. Segue o caminho completo do número que aparece no card acima, para você conferir se ele atende o seu padrão antes de publicar.
| Item | Como funciona |
|---|---|
| Fonte principal | CoinGecko, consultado pelo nosso servidor de índices, já cotando o par contra o real. |
| Se ela falhar | Mercado Bitcoin e, em seguida, Coinbase. As três cotam o par direto em real, então o valor nunca é um preço em dólar convertido por uma taxa nossa. |
| Moeda | Real. Não há opção de exibir em dólar. |
| Frequência | A cotação de cripto é renovada a cada 60 segundos, o dia inteiro, todos os dias. Ela não segue o horário do câmbio tradicional. O widget na sua página rebusca a cada 45 segundos enquanto a aba está visível, e também no instante em que o leitor volta para a aba. |
| Última atualização | Aparece no rodapé do widget, com dia, mês e hora no fuso de Brasília, independente do fuso do servidor onde o seu site roda. |
| Variação | É a variação do período informada pela fonte. Quando a fonte que respondeu só entrega o preço à vista, a linha de variação simplesmente não aparece. O widget nunca escreve 0,00% no lugar de um dado que não tem. |
| Se tudo falhar | Fica o último valor bom conhecido, e o horário no rodapé denuncia que ele parou. Sem nenhum valor guardado, o widget mostra o estado de carregamento em vez de um número inventado. |
Vale um aviso honesto sobre o que isso não é. O número é referência de mercado, não a última negociação de uma corretora específica, e num pico de volatilidade a diferença entre corretoras aparece. Para conteúdo editorial e para dar contexto ao leitor, serve bem. Para exibir preço de execução de ordem ou alimentar qualquer decisão automatizada, não serve, e não é para isso que ele existe.
O que dá para configurar
Estas são todas as opções que o widget realmente aceita. Cada uma delas está no painel acima, e o que você escolher já sai no código copiado.
- Tema claro ou escuro, para o widget não brigar com o fundo do seu site.
- Cor de destaque, entre sete cores prontas ou um valor hexadecimal seu, aplicada na barra do topo e no link do rodapé.
- Título visível ou oculto, útil quando o seu próprio bloco já tem um cabeçalho.
- Largura, de compacta para barra lateral até ocupar a coluna inteira. A altura vem sugerida no código e se ajusta sozinha se você colar o script que acompanha.
- Idioma, português ou inglês, aplicado aos rótulos e ao formato dos números.
O que não existe, e é bom saber antes de planejar a página: não dá para escolher a corretora de origem, não há gráfico histórico dentro do widget, não há alerta de preço e não dá para trocar a moeda de referência. Para Bitcoin com gráfico, o lugar é a página de cotação do Bitcoin hoje.
Para que tipo de site esse widget serve
- Portal de tecnologia e blog de cripto, onde o preço é o assunto e o leitor volta para conferir.
- Site de investimento, ao lado de conteúdo sobre renda variável e diversificação.
- Portal de notícias, na lateral da editoria de economia, junto com dólar e Selic.
- Canal e newsletter com página própria, para dar um motivo de retorno entre uma publicação e outra.
- Site de contabilidade que atende cliente com cripto, onde o número serve de apoio à conversa sobre declaração.
Como instalar
- Ajuste tema, cor e largura no painel acima, ou abra a página de widgets gratuitos e vá ao bloco de criptomoedas.
- Clique em copiar código.
- Cole no HTML da sua página, no ponto onde o widget deve aparecer. Em editor visual, procure o bloco de HTML ou de incorporar código.
- Publique.
O código traz o iframe, um parágrafo de atribuição e um script curto que ajusta a altura sozinho. Cole os três juntos.
No WordPress
Adicione o bloco HTML personalizado e cole o código. Para a barra lateral, use um widget do tipo HTML. Quem não quer lidar com código pode instalar o plugin de widgets para WordPress do ValorFinal, que traz as ferramentas por bloco e por shortcode.
Mostrando outras criptomoedas
O widget principal traz Bitcoin e Ethereum juntas, que é o que a maior parte dos sites quer. Se o seu público acompanha outra moeda, o widget de cotação avulsa permite escolher uma só e exibir num bloco compacto. O catálogo cobre onze criptomoedas, além de 41 moedas tradicionais e dos metais preciosos. A ferramenta completa, com conversão, é o câmbio, e o preço detalhado do Bitcoin fica em cotação do Bitcoin hoje.
Cuidados ao publicar preço de cripto
Preço de ativo volátil na sua página é conteúdo sensível, e vale tratar com o mesmo cuidado de uma informação financeira qualquer. Três recomendações práticas.
- Deixe claro que é informativo. Preço exibido não é oferta nem recomendação de compra.
- Não prometa precisão de corretora. O valor é referência de mercado e pode diferir do que uma exchange específica está praticando naquele instante.
- Evite associar o widget a promessa de retorno. Além de ser problema editorial, é problema com as políticas de anúncio da maior parte das redes.
Como o ValorFinal apura e confere os dados que publica está descrito em como validamos os cálculos.
Limitações
A cotação exibida é referência de mercado agregada e pode divergir do preço praticado por uma corretora específica, principalmente em momento de volatilidade forte. Criptomoeda não tem garantia do Fundo Garantidor de Créditos e o valor investido pode ser perdido. O widget é informativo e educacional, e não constitui recomendação de investimento.
Outros widgets que combinam com este
Quem instala o de cripto costuma querer também a cotação de moedas e os indicadores do Banco Central na mesma página. A lista completa comentada, com demonstração de cada um, está no guia dos 25 melhores widgets grátis para site, e todos os códigos ficam na página de widgets gratuitos.