Resolva o problema de acompanhar ETFs brasileiros como WRLD11, IMAB11, IB5M11 e IRFM11 que não estão no Google Finance. Veja um passo a passo para obter cotações automáticas de ETFs para sua planilha e facilitar a gestão da sua carteira.
Quem já acompanhou o blog em algum momento sabe que eu tenho me direcionado mais aos ETFs e fundos de índice nos últimos anos. É uma estratégia simples, eficiente e que, a longo prazo, tende a potencializar a construção de um patrimônio sólido. Por isso, há tantos posts por aqui sobre ETFs, mas faltava um que resolve um problema muito comum entre as pessoas que usam planilhas para acompanhar seus investimentos: obter confiáveis cotações automáticas de ETFs.
Afinal, não adianta só comprar os ativos e esquecê-los. O acompanhamento periódico de seus investimentos é fundamental, e manter uma planilha organizada para monitorar o desempenho, calcular o preço médio e, o mais importante, ter os dados em mãos para a declaração de imposto de renda. Clique aqui para assinar as atualizações do blog e receber o acesso a algumas dessas planilhas.
No meu caso, uma das ferramentas que mais uso para essa tarefa é o Google Sheets. Ele é gratuito, flexível e, graças a fórmulas como a GOOGLEFINANCE, permite que a gente puxe cotações de diversos ativos de forma automática. Pelo menos na teoria.
A prática, no entanto, é bem diferente quando se trata de alguns ETFs específicos negociados na B3, a nossa bolsa de valores.
ETFs que Se Escondem do Google Finance
Se você também é adepto das planilhas, já deve ter se deparado com o mesmo problema que eu: certos ETFs brasileiros simplesmente não aparecem na função GOOGLEFINANCE, como o WRLD11, o IMAB11, o IB5M11 e o IRFM11.
Ao tentar usar a fórmula tradicional, o resultado é um erro ou, pior, um dado impreciso que pode levar a cálculos errados. Essa inconsistência me incomodava profundamente. A gente gasta tempo montando a planilha, organizando as fórmulas, e de repente, a principal fonte de dados nos deixa na mão.
Tentei de tudo, como importar cotações automáticas de ETFs de outros sites como o Investing.com e o Status Invest com a função IMPORTHTML ou IMPORTXML. O resultado era sempre o mesmo: a fórmula, que funcionava por um tempo, acabava quebrando ou retornava valores incorretos. A necessidade de atualizar manualmente a planilha era frustrante e a automação, que deveria ser nossa aliada, se tornava um obstáculo.
Afinal, se a ideia é facilitar a vida, por que a solução para um problema simples se tornou tão complexa? Essa busca me fez perceber que muitos investidores enfrentavam o mesmo dilema silencioso e queriam cotações automáticas de ETFs que funcionassem de verdade. Eles buscavam ter o controle total de suas finanças, mas a falta de dados confiáveis e automatizados em uma planilha era uma barreira real.
A Solução: a API da Brapi
A minha jornada por uma solução me levou a um caminho que eu não esperava: a utilização de uma API (Application Programming Interface). Para simplificar, uma API é um conjunto de regras que permite que dois programas (neste caso, o Google Sheets e uma base de dados de cotações) se comuniquem e troquem informações.
A chave para o sucesso foi a Brapi, uma API especializada em dados da B3. E, com uma pequena grande ajuda da Perplexity, através do Google Scripts foi possível criar uma função personalizada que busca os dados de forma direta e precisa. Essa solução não apenas resolveu o problema de conseguir cotações automáticas de ETFs que não aparecem no Google Finance, como também se mostrou mais robusta e confiável do que as tentativas anteriores com as funções de importação de sites.
Passo a Passo: A Sua Planilha de Acompanhamento no Piloto Automático
Para começar, vamos precisar de uma conta na Brapi. É rápido e gratuito. Claro que, para uso profissional, há de se pagar para ter os dados, mas a conta gratuita tem uma disponibilização de uso bem alta. Para uma ideia, veja a quantidade de requisições que usei em dez dias: 140 de 15.000 possíveis mensais. Ou seja, a não ser que sua demanda seja muito alta, o plano gratuito resolverá todos os seus problemas.
Passos para obter as cotações automáticas de ETFs
1. Obtenha sua chave API na Brapi
- Acesse o site brapi.dev.
- Crie uma conta gratuita.
- No seu painel de usuário, copie o seu token API. Ele é um código único que autoriza o acesso aos dados.
2. Adicione a função personalizada no Google Sheets
- Abra sua planilha no Google Sheets.
- No menu superior, clique em Extensões > Apps Script.
- Uma nova janela, o editor de projetos, será aberta. Apague o código que estiver lá e cole o código abaixo.
JavaScript
/**
* Retorna o preço atual de 1 ticker da B3 via BRAPI
* Uso: =BRAPI_PRICE("IMAB11"; $A$1)
*/
function BRAPI_PRICE(ticker, token) {
if (!ticker) return "Erro: informe ticker";
if (token && typeof token === 'object' && token.length) token = token[0][0];
if (!token) {
var sh = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
token = sh.getRange('A1').getDisplayValue();
}
if (!token) return "Erro: token BRAPI ausente";
ticker = String(ticker).toUpperCase().trim();
if (ticker.indexOf('.') === -1) ticker = ticker + '.SA';
var url = 'https://brapi.dev/api/quote/' + encodeURIComponent(ticker) + '?token=' + encodeURIComponent(token);
var res = UrlFetchApp.fetch(url, {muteHttpExceptions:true, headers:{'User-Agent':'Mozilla/5.0'}});
if (res.getResponseCode() !== 200) return "HTTP " + res.getResponseCode() + ": " + res.getContentText().substring(0,200);
var json = JSON.parse(res.getContentText());
var row = (json && json.results && json.results[0]) || (json && json.data && json.data[0]) || null;
if (!row) return "Sem dados retornados";
return row.regularMarketPrice || row.lastPrice || row.close || "Preço não encontrado";
}
- Salve o projeto. Pressione
Ctrl + Sou clique no ícone de disquete. - Feche a janela do editor de projetos.
3. Use a nova fórmula na sua planilha
- Na sua planilha, escolha uma célula (por exemplo, a célula A1) e cole o seu token API que você copiou da Brapi.
- Agora, em qualquer outra célula, você pode usar a nova fórmula personalizada.
Para o IMAB11, por exemplo, a fórmula será:
=BRAPI_PRICE("IMAB11"; $A$1)
Para os outros ETFs, basta trocar o ticker:
=BRAPI_PRICE("IB5M11"; $A$1)
=BRAPI_PRICE("IRFM11"; $A$1)
=BRAPI_PRICE("WRLD11"; $A$1)
A referência $A$1 no final da fórmula é o endereço da célula onde está o seu token. O cifrão garante que a referência não mude caso você arraste a fórmula para outras células.
E pronto! Agora sua planilha está conectada à Brapi e irá puxar a cotação atual desses ETFs de forma automática e precisa, embora, como o Google Finance e outros sites, não é em tempo real no plano gratuito. Se a cotação em tempo real for necessária para você, é necessária a assinatura do plano pago.
As cotações automáticas de ETFs proporcionam mais tempo para você
Pode parecer um detalhe, mas resolver o problema de cotações truncadas, erros de comunicação, etc, que ocorriam antes, ajuda a economizar tempo na nossa gestão dos investimentos, uma vez que esse acompanhamento ainda é necessário para, principalmente:
- Avaliar o desempenho da sua carteira: comparar a performance desses ETFs com outros ativos e com índices de referência, como o Ibovespa, IMAB e CDI.
- Cálculo de impostos: muitos investidores usam planilhas para calcular o Imposto de Renda sobre a venda de ativos com lucro e, para isso, você precisa manter correto seu preço médio de compra dos ativos.
Essa pequena solução técnica nos lembra de um ponto importante da nossa jornada como investidores: a necessidade de ter autonomia e ferramentas confiáveis. Em um mundo onde as informações sobre investimentos são abundantes, o nosso maior ativo é a capacidade de filtrar, organizar e transformar esses dados em conhecimento prático. Sim, e eu ainda prefiro as planilhas aliadas ao Microsoft Money. Mais do que quaisquer apps moderninhos que ainda surgem por aí.
Essa solução me salvou de muitas dores de cabeça e tornou o meu acompanhamento de carteira muito mais eficiente. E você, como tem esses ETFs? Usa planilhas? Como tem feito para acompanhar suas cotações? Deixe sua experiência nos comentários!
Explore mais o blog pelo menu no topo superior! E para me conhecer mais, você ainda pode…
… assistir uma entrevista de vídeo no YouTube
… ler sobre um resumo de minha história
… ouvir uma entrevista de podcast no YouTube
… participar de um papo de boteco
… curtir uma live descontraída no Instagram
… ou adquirir um livro que reúne tudo que aprendi em mais de 20 anos da jornada à independência financeira.
E, se gostou do texto e do blog, por que não ajudar a divulgá-lo em suas redes sociais através dos botões de compartilhamento?
Artigos mais recentes:
- Como puxar 4 cotações automáticas de ETFs brasileiros que não aparecem no Google Finance
- Rentabilidades de todas as carteiras (ago/25)
- Carteiras ativa e passiva: atualizações de agosto/25
- Atualização da rentabilidade das carteiras de ETFs (ago/25)