Dados B3 › Guias › Planilha

Guia · Planilha

Preço de Graham numa planilha do Google, puxando LPA e VPA da CVM

A fórmula de Benjamin Graham para o "número de Graham" usa dois dados do balanço — o lucro por ação (LPA) e o valor patrimonial por ação (VPA). Este guia mostra como trazer os dois para o Google Planilhas direto da API, sem copiar número à mão, e o que a fórmula não diz.

A fórmula

Número de Graham = √(22,5 × LPA × VPA)

O 22,5 é o produto dos dois limites que Graham usava para ação "defensiva": P/L até 15 e P/VP até 1,5. A raiz devolve o preço em que os dois limites se encontram. É a régua de O Investidor Inteligente para empresa estável e lucrativa — não um preço-alvo.

Passo 1 — a função que busca os dados

No Google Planilhas, abra Extensões → Apps Script, apague o que houver e cole:

function DADOSB3(ticker) {
  var chave = PropertiesService.getScriptProperties().getProperty('DADOSB3_CHAVE');
  var opcoes = {muteHttpExceptions: true};
  if (chave) opcoes.headers = {'X-API-Key': chave};
  var r = UrlFetchApp.fetch('https://dadosb3.com/empresas/' + ticker + '/multiplos', opcoes);
  if (r.getResponseCode() !== 200) return 'erro ' + r.getResponseCode();
  var v = JSON.parse(r.getContentText()).valuation;
  return [[v.lpa, v.vpa, v.preco, v.data_preco, v.ano]];
}

A chave não vai dentro do código: em Configurações do projeto → Propriedades do script, crie a propriedade DADOSB3_CHAVE com a sua chave. Sem chave, só a WEGE3 responde (é a degustação aberta); a chave grátis libera 200 consultas por dia, sem cartão.

Passo 2 — a planilha

Na coluna A, os códigos (WEGE3, ITUB4…). Em B2, =DADOSB3(A2) — a função ocupa cinco colunas: LPA, VPA, preço, data do preço e exercício do balanço. Em G2, o número de Graham:

=SE(E(B2>0; C2>0); RAIZ(22,5*B2*C2); "não se aplica")

(Com a planilha em inglês: =IF(AND(B2>0,C2>0),SQRT(22.5*B2*C2),"n/a").)

Os três cuidados

• Prejuízo não entra. Com LPA negativo, a raiz não existe — e não é um erro da planilha: a fórmula não se aplica a quem não dá lucro. Por isso o SE acima.
• O LPA é do último balanço anual. A coluna "exercício" diz qual. Um ano com ganho não recorrente infla o LPA e o número de Graham junto; olhe a série na página da empresa antes de confiar num ano isolado.
• Cada chamada gasta uma consulta. O Google recalcula funções personalizadas quando a planilha abre. Com 50 códigos, uma abertura gasta 50 das 200 consultas diárias do plano grátis. Para uma lista grande, copie e cole como valores depois de atualizar.

Onde cada número nasce

LPA e VPA vêm do último balanço anual entregue à CVM; o preço é o fechamento do último pregão (arquivo diário da B3). A conta de cada um está aberta na metodologia. Se algum número parecer errado, a página da empresa mostra a conta CVM de origem — e erro apontado vira correção pública em /o-que-erramos.