Dados B3 › Planilha

Planilha Dados B3: fundamentos no Google Planilhas com uma fórmula

Uma planilha do Google com a função =DADOSB3(). Você escreve o código da ação, do FII ou do ETF e o nome do campo. A célula traz o número da nossa base: ROE, P/L, dividend yield, próximo provento e mais de 30 campos.

O preço não vem da Dados B3: no modelo, ele vem do próprio Google, pela função =GOOGLEFINANCE. Nada aqui é recomendação de investimento.

Comece em 3 passos

Abra o modelo da planilha e clique em Fazer uma cópia. A cópia é sua, na sua conta do Google. Se aparecer a barra amarela "algumas fórmulas estão tentando enviar e receber dados de terceiros", clique em Permitir acesso: é o que deixa a planilha mostrar a logo de cada ativo.
No menu Dados B3 › Minha chave, cole a sua chave. A chave grátis sai em um minuto, sem cartão: pegar chave grátis. A chave fica guardada no script da planilha, nunca numa célula.
Use. Escreva =DADOSB3("PETR4"; "roe") numa célula, ou aponte uma coluna inteira de códigos.

Abrir o modelo

Exemplos

Fórmula	O que devolve
`=DADOSB3("PETR4"; "roe")`	o ROE do último balanço anual
`=DADOSB3(A2:A31; "dy_12m")`	a coluna inteira de uma vez (um pedido só)
`=DADOSB3(A2:A31; B1:H1)`	a tabela inteira: códigos nas linhas, campos no cabeçalho
`=DADOSB3("WEGE3"; "pl"; "2019-06-30")`	o P/L como era conhecido em 30/06/2019
`=DADOSB3("SELIC")`	a meta Selic de hoje (também IPCA, DOLAR, EURO...)
`=GOOGLEFINANCE("BVMF:PETR4")`	o preço, do Google

Em planilha em inglês o separador é a vírgula (,).

Por que é diferente

Uma coluna, um pedido. A função manda a coluna inteira de uma vez. Carteira com 300 ativos não trava.
A chave não fica à vista. Ela mora no script, não numa célula que alguém copia.
O número que falta diz por quê. Em vez de célula vazia: "FII não tem P/L", "balanço ainda não saiu", "código não encontrado".
Data no passado. Com a data, vem o balanço que já estava na CVM naquele dia.
O código do jeito que você escreve. petr4, PETR4.SA, BVMF:PETR4, PETR4F e códigos antigos são entendidos.

O que vem pronto no modelo

Capa: valor da carteira, variação no mês, dividendos em 12 meses, carteira por setor e os proventos dos próximos 30 dias.
Carteira: quantidade, preço do Google, peso e os fundamentos de cada ativo.
Dividendos: o que a sua carteira recebe neste mês, com a data de pagamento.
Comparador: vários ativos lado a lado, nos mesmos campos.
Histórico 10 anos: os números de um ativo em cada ano, com a data de cada balanço.
Filtro de ações: uma lista de ações filtrada pelos critérios que você escolhe. É um exemplo de filtro, não uma recomendação.

Os campos

Porcentagem vem como fração (0,25 = 25%): formate a coluna como %. Valores em R$ são brutos, antes de IR.

Cadastro

Campo	O que é	Vale para	Aceita data
`nome`	Nome. Nome da companhia ou do fundo.	Ação, FII, ETF	não
`tipo`	Tipo. Ação, FII ou ETF.	Ação, FII, ETF	não
`setor`	Setor. Setor da ação; segmento do FII.	Ação, FII	não
`cnpj`	CNPJ. CNPJ da companhia ou do fundo.	Ação, FII, ETF	não
`pagina`	Página. Endereço da página do ativo no dadosb3.com.	Ação, FII, ETF	não
`logo`	Logo. Endereço do logotipo (PNG 64×64) no dadosb3.com: o da companhia, do site que ela declara à CVM; no FII e no ETF, o da gestora, do site que ela declara à CVM. Use com =IMAGE().	Ação, FII, ETF	não
`link_cvm`	Link CVM. Link do último balanço anual (DFP) no site da CVM.	Ação	sim
`indice`	Índice. Índice que o ETF segue.	ETF	não
`gestor`	Gestor. Gestor do ETF.	ETF	não

Balanço (último ano)

Campo	O que é	Vale para	Aceita data
`ano_balanco`	Ano do balanço. Exercício do balanço anual usado nos campos abaixo.	Ação	sim
`roe`	ROE. Lucro dos controladores ÷ patrimônio.	Ação	sim
`roic`	ROIC. Retorno sobre o capital investido.	Ação	sim
`roa`	ROA. Lucro ÷ ativo total.	Ação	sim
`margem_bruta`	Margem bruta. Resultado bruto ÷ receita.	Ação	sim
`margem_ebit`	Margem EBIT. Resultado operacional ÷ receita.	Ação	sim
`margem_liquida`	Margem líquida. Lucro líquido total ÷ receita.	Ação	sim
`divida_liquida_ebitda`	Dívida líquida/EBITDA. Dívida líquida ÷ EBITDA.	Ação	sim
`liquidez_corrente`	Liquidez corrente. Ativo circulante ÷ passivo circulante.	Ação	sim
`crescimento_receita`	Crescimento da receita (1 ano). Receita do ano ÷ receita do ano anterior − 1.	Ação	sim
`cagr_receita_5a`	Crescimento da receita (5 anos, ao ano). Crescimento médio anual da receita em 5 anos.	Ação	sim
`piotroski`	Piotroski. Nota de 0 a 9 dos nove critérios de Piotroski.	Ação	sim
`ebitda`	EBITDA. EBITDA do exercício, em R$.	Ação	sim
`divida_liquida`	Dívida líquida. Dívida bruta − caixa, em R$.	Ação	sim

Múltiplos

Campo	O que é	Vale para	Aceita data
`pl`	P/L. Valor de mercado ÷ lucro dos últimos 12 meses (o cartão P/L 12 m da página).	Ação	sim
`pvp`	P/VP. Ação: valor de mercado ÷ patrimônio do último trimestre. FII: preço ÷ valor patrimonial da cota.	Ação, FII	sim
`ev_ebitda`	EV/EBITDA. EV ÷ EBITDA, com o preço do 1º pregão depois da entrega do balanço anual.	Ação	sim
`fcf_yield`	FCF yield. Caixa livre ÷ valor de mercado, na mesma data do EV/EBITDA.	Ação	sim
`lpa`	LPA. Lucro por ação do último exercício.	Ação	não
`vpa`	VPA. Valor patrimonial por ação do último exercício.	Ação	não
`vp_cota`	VP da cota. Valor patrimonial da cota no último informe.	FII	não

Proventos

Campo	O que é	Vale para	Aceita data
`dy_12m`	Dividend yield 12 meses. Proventos dos últimos 12 meses ÷ preço.	Ação, FII	não
`proventos_12m`	Proventos 12 meses (R$). Soma por ação (ou cota) dos últimos 12 meses, bruto.	Ação, FII	não
`ultimo_provento`	Último provento (R$). R$ por ação (ou cota) da data-com mais recente, bruto.	Ação, FII, ETF	sim
`ultima_data_com`	Última data-com. A data-com do último provento.	Ação, FII, ETF	sim
`proximo_provento`	Próximo provento (R$). R$ por ação (ou cota) do próximo pagamento já anunciado, bruto.	Ação, FII, ETF	sim
`proximo_pagamento`	Próximo pagamento. A data do próximo pagamento já anunciado.	Ação, FII, ETF	sim
`proxima_data_com`	Data-com do próximo pagamento. A data-com do próximo pagamento já anunciado.	Ação, FII, ETF	sim

Indicadores da economia

Escreva o código no lugar da ação. O campo é valor (o padrão) ou data (a data do valor). Fonte: Banco Central e IBGE.

Código	O que é
`SELIC`	Meta Selic (Copom), ao ano
`SELIC_EFETIVA`	Selic efetiva, ao ano
`IPCA`	IPCA acumulado em 12 meses
`IPCA_MES`	IPCA do mês
`DOLAR`	Dólar PTAX de fechamento, venda
`DOLAR_COMPRA`	Dólar PTAX de fechamento, compra
`EURO`	Euro PTAX de fechamento, venda
`PIB`	PIB acumulado em 4 trimestres
`DESEMPREGO`	Taxa de desocupação (PNAD)

Limites

A planilha usa a cota da sua chave. Grátis: 200 consultas por dia, sem cartão. Pro (R$ 49,90/mês): 10.000 consultas por dia.

Cada pedido gasta 1 consulta a cada 100 células (código × campo), no mínimo 1. Uma carteira de 30 ativos com 10 campos gasta 3. A planilha guarda cada número por até 6 horas e não pede de novo nesse tempo. Até 300 códigos e 20 campos por pedido; intervalos maiores são divididos sozinhos.

Data no passado

Com a data (AAAA-MM-DD), o balanço é o último que a CVM já tinha recebido naquele dia, e o P/L e o P/VP usam o preço do 1º pregão depois da entrega. O número é o da versão publicada hoje: se a empresa republicou o balanço depois, vale o republicado. Dividend yield, LPA e VPA só existem com o valor de hoje.

Para quem programa

A função chama esta rota da API, com a sua chave:

curl -H "X-API-Key: SUA_CHAVE" "https://dadosb3.com/planilha/dados?codigos=PETR4,ITUB4,HGLG11&campo=roe,dy_12m"

Os números desta página são ao vivo. Versão do dado 2026-11-03-delistadas-proventos-cvm · página gerada em 2026-11-03 23:11 UTC. Se isto não bater com o /saude, você está lendo uma cópia em cache.

Fontes: CVM (dados abertos, ODbL) e B3 (COTAHIST). Não afiliado à B3 nem à CVM. Não é recomendação de investimento.