Como acompanhar preços de criptomoedas no Google Sheets

1. Defina o objetivo do acompanhamento de preços antes de criar a planilha

Comece com uma especificação simples, não com uma fórmula. Liste as criptomoedas, as moedas de cotação, a frequência de atualização e se precisa dos preços atuais, de registros históricos ou de ambos. Uma planilha para acompanhar BTC e ETH em USD tem um objetivo diferente de outra que registra uma carteira diversificada em EUR e GBP. Definir esses critérios ajuda a criar uma planilha para monitorar preços de criptomoedas que realmente atenda às suas necessidades.

Mantenha a primeira versão enxuta. Por exemplo, acompanhe três criptomoedas em uma moeda e atualize os dados uma vez por hora. Só adicione mais linhas ou moedas depois de confirmar que os resultados correspondem aos dados exibidos pela CoinGecko. O volume de solicitações necessário e as opções de atualização disponíveis dependem do método de acesso escolhido e das condições da sua conta. Por isso, confira os limites atuais antes de definir um cronograma.

Defina o que significa “preço” na sua planilha. Uma cotação atual é um valor referente a um determinado momento, não um preço de execução garantido. Se pretende compará-la com uma operação, registre o horário da cotação e não trate um resultado atrasado ou armazenado em cache como se estivesse em tempo real.

2. Escolha um método de acesso à API adequado à sua configuração

Há três formas comuns de conectar os dados da CoinGecko ao Google Sheets: um complemento do Sheets, um pequeno script do Apps Script ou um conector de terceiros. Para quem não tem conhecimentos técnicos, um complemento costuma ser a opção mais rápida. Um script oferece mais controle sobre o formato das solicitações e o armazenamento dos dados. Um conector pode dispensar a programação, mas acrescenta outro serviço a verificar se as atualizações pararem de funcionar.

Antes de escolher, compare os métodos de autenticação, os limites de solicitações e os requisitos de manutenção. Confirme se o método exige uma chave de API, onde ela será armazenada, qual frequência de atualização permite e se os limites atendem à quantidade planejada de criptomoedas e moedas. As opções de acesso à API e os termos da CoinGecko podem mudar; consulte a documentação para verificar os requisitos atuais.

Se usar o Apps Script, abra o editor de scripts da planilha e crie uma função que solicite dados à CoinGecko, interprete a resposta e grave os campos escolhidos em uma aba. É mais fácil solucionar problemas em um script simples quando ele tem uma única função e apresenta mensagens de erro claras. Não coloque uma chave de API privada em uma célula compartilhada com todas as pessoas que podem ver a planilha.

Se ainda estiver comparando ferramentas, o guia sobre o que caracteriza a melhor corretora de criptomoedas aborda outra decisão: escolher uma plataforma de negociação, e não uma fonte de dados. Manter essas decisões separadas ajuda a evitar que um feed de API seja confundido com uma conta em uma corretora.

3. Crie uma tabela de consulta de criptomoedas e moedas

Nas solicitações, use os IDs das criptomoedas da CoinGecko, não apenas os símbolos. Projetos diferentes podem usar o mesmo símbolo, enquanto um ID permite que a API identifique um ativo específico. Crie uma aba chamada “Consulta” com colunas para o nome de exibição, o ID da CoinGecko, o símbolo e a moeda de destino.

As duas primeiras linhas mostram o tipo de identificador a registrar. Confira todos os IDs na CoinGecko antes de usá-los. O símbolo é útil para identificar os ativos na planilha, mas não deve substituir o ID na solicitação. Isso é especialmente importante quando a carteira inclui um token pequeno cujo símbolo se parece com o de outro projeto.

Use um formato consistente para os códigos de moeda, como `usd` ou `eur` em letras minúsculas, se esse for o formato esperado pelo endpoint escolhido. Uma regra de validação no Google Sheets pode limitar a coluna de moedas às opções compatíveis com sua configuração. Essa verificação simples evita que um erro de digitação, como `usdd`, seja enviado à API.

4. Importe os preços atuais para uma tabela de dados organizada

Mantenha os dados brutos da API separados da aba usada para consultar os preços. Uma aba “Brutos” pode conter a resposta ou os últimos valores importados; uma aba “Preços” pode exibir o nome da criptomoeda, o símbolo, a moeda, o preço e o horário. Essa separação facilita alterar a formatação sem quebrar a lógica das solicitações.

Uma solicitação típica de preços atuais envia os IDs selecionados e a moeda de cotação ao endpoint de preços da CoinGecko. O URL, os parâmetros, o método de autenticação e os campos da resposta variam de acordo com o produto de API e o método de acesso. Consulte a documentação da CoinGecko para ver os detalhes do endpoint. Na tabela resultante, associe cada valor ao ID correspondente, em vez de presumir que a ordem da resposta sempre será igual à das linhas inseridas.

Por exemplo, sua tabela pode exibir “Bitcoin | BTC | USD | preço | atualizado em”. Formate a coluna de preços como número, com uma quantidade adequada de casas decimais, mas mantenha precisão suficiente para os ativos acompanhados. Arredondar o valor exibido é uma escolha de apresentação; arredondar o valor armazenado pode distorcer cálculos posteriores.

Para aprender como conectar a API da CoinGecko ao Google Sheets, comece com uma criptomoeda e uma moeda, e depois confirme que o ID, a moeda e a cotação correspondem aos dados da fonte. Quando isso estiver funcionando, amplie a tabela de consulta e teste cada nova linha. Pode ser menos empolgante do que criar um painel completo, mas ajuda a identificar IDs incompatíveis desde o início.

Use fórmulas para fazer cálculos, não para ocultar dados ausentes. Se uma solicitação falhar, exiba um aviso claro, como “Erro na solicitação”, ou deixe o erro visível, em vez de mostrar zero como se o ativo tivesse perdido todo o valor. Um zero pode afetar os totais da carteira e levar a decisões sem relação com o mercado.

5. Programe as atualizações e gerencie os limites de solicitações

Uma atualização automática só é útil se ocorrer em um intervalo permitido pelo seu acesso à API. Os controles de atualização dos complementos, os acionadores do Apps Script e os cronogramas dos conectores funcionam de formas diferentes. Confira os limites de solicitações e as regras de atualização atuais do método escolhido antes de definir um intervalo; esses limites podem variar conforme o plano e mudar com o tempo.

Comece com um cronograma conservador e poucas solicitações. Se acompanhar cinco ativos, evite enviar uma solicitação separada para cada célula quando uma única solicitação puder retornar todos os valores necessários. Reduzir o número de chamadas pode facilitar a manutenção da planilha, mas confirme se o endpoint aceita os IDs e as moedas enviados em conjunto.

Prepare-se para falhas. A API pode retornar um erro, um serviço pode ficar indisponível ou um limite de solicitações pode ser atingido. Mantenha visível o horário da última atualização bem-sucedida e não substitua dados válidos por uma resposta vazia, a menos que queira apagá-los. Uma cotação desatualizada continua desatualizada; identifique-a como tal em vez de apresentá-la como atual.

Os acionadores do Apps Script podem executar tarefas em horários programados, mas estão sujeitos aos limites de execução e aos requisitos de autorização do Google. Depois da configuração, verifique o estado do acionador e consulte o registro de execução se as atualizações pararem. Os limites do Google e da CoinGecko são independentes: respeitar os limites de um serviço não garante que o outro aceite todas as solicitações.

6. Adicione horários e guarde registros históricos de preços

Uma tabela que substitui o preço de ontem pelo de hoje não permite ver o que mudou. Adicione uma aba “Histórico” para armazenar uma linha por criptomoeda e atualização, com colunas para horário, ID da criptomoeda, moeda e preço. Grave cada resposta bem-sucedida em uma nova linha, sem substituir o registro anterior.

Por exemplo, uma linha de registro pode ser “2026-11-12 10:00 | bitcoin | usd | [valor retornado]”. Use o horário real informado pela conexão ou pelo script e indique se ele está em UTC ou no horário local. O preço exibido deve corresponder ao horário da mesma atualização, não à última vez que alguém abriu a planilha.

Defina como manter os dados antes que a aba de histórico cresça demais. Dependendo do objetivo e do limite de solicitações, você pode guardar um registro diário para um acompanhamento pessoal de longo prazo ou registros mais frequentes para monitorar o curto prazo. Não presuma que uma resposta da API forneça dados históricos só porque sua planilha acumulou registros: são fontes de dados diferentes.

Com linhas datadas, você pode calcular a variação entre duas observações registradas, desde que o ID da criptomoeda e a moeda de cotação sejam os mesmos. Comparar uma linha de BTC/USD com outra de BTC/EUR também reflete o efeito cambial, além da variação de preço. Por isso, identifique claramente as séries antes de criar gráficos.

7. Valide os resultados e mantenha a conexão

Faça algumas verificações antes de confiar no painel. Confirme que o ID da criptomoeda está correto, que a moeda indicada corresponde à solicitação, que o preço retornado é numérico e que o horário se refere àquela atualização. Em seguida, compare um resultado com o site da CoinGecko, levando em conta que as duas fontes podem ser atualizadas em momentos diferentes.

Durante os testes, mantenha as respostas de erro visíveis. Uma solicitação malsucedida pode indicar uma chave inválida, um parâmetro malformado, um problema com o limite de solicitações ou uma indisponibilidade temporária do serviço. Registre a mensagem e o horário em que ocorreu; alterar várias configurações ao mesmo tempo dificulta identificar a causa. Se o mesmo erro se repetir, consulte a documentação do endpoint e o seu plano de acesso.

Documente quem é responsável pelo script ou conector, onde as credenciais são armazenadas e quais abas podem ser editadas sem riscos. Se alguém renomear uma coluna esperada pelo script, a conexão pode deixar de funcionar mesmo sem qualquer mudança na CoinGecko. Proteger as abas de consulta e de dados brutos contra edições acidentais ajuda a evitar esse tipo de falha.

Revise a configuração quando a CoinGecko alterar os termos da API, os métodos de autenticação, os endpoints disponíveis ou os limites. Antes de modificar uma planilha em produção, confira os detalhes atuais. Depois de cada mudança, testar com uma única criptomoeda costuma ser suficiente para identificar um parâmetro incorreto antes que ele afete todas as linhas. Mantenha esse teste na pasta de trabalho para que outra pessoa possa repeti-lo.