Este guia explica o que cada número desta plataforma significa, como eles se combinam numa decisão e onde estão as armadilhas. É material de estudo pessoal, não recomendação de investimento.
Não é "essa ação vai subir amanhã?". É:
Esta empresa vai me pagar bem ao longo de anos, e o preço de hoje é razoável para isso?
Isso separa duas coisas que iniciantes costumam misturar:
| Pergunta | O que responde | Nota do painel |
|---|---|---|
| A empresa é boa? | Qualidade do negócio ao longo de ~10 anos | nota_qualidade |
| Ela me paga renda? | Dividendo atual e sustentável | nota_dividendos |
| O preço está bom? | Desconto e catalisadores | nota_valorizacao + preço teto |
Uma empresa excelente a um preço péssimo é um investimento ruim. Uma empresa medíocre barata pode ser um investimento bom — ou uma armadilha de valor. As três notas existem para você não confundir uma coisa com a outra.
| Indicador | O que é | Como ler |
|---|---|---|
| P/L | Preço ÷ Lucro por ação | Quantos anos de lucro atual você paga. Baixo = barato ou o mercado espera o lucro cair |
| P/VP | Preço ÷ Valor patrimonial por ação | Abaixo de 1 = paga menos que o patrimônio contábil. Comum em bancos; raro em empresas de marca |
| ROE | Lucro ÷ Patrimônio líquido | A rentabilidade do negócio. O indicador mais importante. Compare sempre com a Selic |
| DY | Dividendo 12M ÷ Preço | Renda anual em %. Sempre confira se o número é bruto e se veio de provento extraordinário |
| Payout | Dividendo ÷ Lucro | Acima de 100% a empresa distribui mais do que ganha — insustentável ou devolução de capital |
| Margem líquida | Lucro ÷ Receita | Quanto sobra de cada real vendido |
| Indicador | O que é | Como ler |
|---|---|---|
| P/VP | Cota ÷ Valor patrimonial | Abaixo de 1 = comprando o patrimônio com desconto |
| DY 12M | Rendimento 12M ÷ Cota | FII distribui ~95% do lucro semestral por lei — o yield é mais previsível |
| Vacância | % do imóvel vazio (tijolo) | Vacância subindo antecipa queda de rendimento |
| Liquidez diária | R$ negociados por dia | Abaixo de ~R$ 500 mil/dia você pode ficar preso na hora de vender |
No Brasil a renda fixa é o custo de oportunidade de tudo. Com a Selic em 14,25% e o CDI em 14,78%, um ativo que rende 8% ao ano precisa de uma boa justificativa — normalmente crescimento ou isenção fiscal.
Atenção à tributação, que muda a comparação:
Por isso o painel mostra o DY bruto e o guia insiste na conta líquida.
Todo ativo tem um preço acima do qual o investimento deixa de fazer sentido, por melhor que a empresa seja. É isso que a seção Preço teto calcula.
Nenhum método sozinho é confiável, então calculamos vários e tiramos a mediana (que ignora o método extremo, ao contrário da média):
| Método | Fórmula | O que ele enxerga |
|---|---|---|
| Bazin | DPA ÷ DY alvo | "Que preço faz esse dividendo render o que eu exijo?" |
| Gordon | DPA × (1+g) ÷ (k − g) | Valor presente de todos os dividendos futuros |
| Graham | √(22,5 × LPA × VPA) | Lucro e patrimônio juntos |
| Múltiplo P/L | P/L mediano histórico × LPA | "Quanto o mercado costuma pagar por essa ação" |
| Múltiplo P/VP | P/VP mediano histórico × VPA | Idem, sobre o patrimônio |
Depois — e aqui está a parte que erramos na primeira versão — o consenso é tirado por família, não por método solto:
| Família | Métodos | Mede |
|---|---|---|
| renda | Bazin, Gordon | o fluxo de dividendo |
| lucro | Graham, múltiplo P/L | a capacidade de gerar lucro |
| patrimônio | múltiplo P/VP, valor patrimonial | o valor dos ativos |
valor da família = média dos métodos daquela família
preço justo = MEDIANA entre as famílias
PREÇO TETO = preço justo × (1 − margem de segurança)
Por que agrupar. Vários "métodos" medem a mesma coisa por caminhos diferentes.
Num FII, valor_patrimonial (VPA) e multiplo_pvp (P/VP mediano × VPA) são ambos
valor patrimonial — se votarem separado, afogam o Bazin 2 a 1, e num FII de papel o
fluxo de juros é o ativo. Foi exatamente esse erro que fazia o BTCI11 aparecer como
caro quando rendia 12,8% isento.
A margem de segurança não é sobre o risco do ativo — é sobre o risco de você estar errado. Por isso ela é diferente por tipo:
A margem de segurança (15% por padrão) não é sobre o risco da empresa — é sobre o risco de você estar errado. Benjamin Graham a chamava de a única proteção contra o próprio otimismo. Suba para 25% se estiver inseguro.
Preço teto não é preço-alvo. Não é para onde a ação vai; é o máximo que você aceita pagar. São coisas diferentes.
Commodity quebra o método. PETR4 pagou R$ 0,00 por ação em 2020 e R$ 16,78 em 2022, com LPA indo de R$ 0,55 a R$ 14,61. Nenhum modelo baseado em histórico acerta isso. O painel marca esses ativos como cíclicos e rebaixa a confiança — para eles, use múltiplos de ciclo e preço da commodity, não o preço teto.
Um preço teto que nunca é atingido não te protege — só te paralisa. Rode:
bash
python scripts/backtest_targets.py
Ele reconstrói, para cada ano do histórico, qual teria sido o teto usando apenas dados disponíveis até aquele ano, e compara com o preço real. A leitura:
| Taxa de disparo | Diagnóstico |
|---|---|
| 0% | modelo quebrado ou impossível de satisfazer — recalibrar |
| 10% a 40% | disciplina útil: comprar é exceção, como deve ser |
| acima de 60% | frouxo demais, aprova quase tudo |
Calibração atual: 24% no geral, com os ativos entre 20% e 40% — e os disparos caem em 2021, 2022 e 2024, que foram de fato os fundos de banco e de FII no período. O PETR4 dá 0%, e isso é esperado pelo motivo do item 5, não um defeito escondido.
Tudo é calibrável em config/valuation.json — mude e rode
python scripts/price_targets.py --all para ver o efeito, depois
python scripts/backtest_targets.py para ver se a mudança melhorou ou piorou.
O objetivo: em qualquer mês do ano, cair dinheiro na conta. A seção Calendário de proventos resolve isso.
FII resolve o calendário sozinho. Fundos imobiliários distribuem mensalmente — um único FII já cobre os 12 meses. Se o objetivo fosse só "receber todo mês", a resposta seria trivial.
Alguns bancos também pagam todo mês. Itaú (ITUB4) e Bradesco (BBDC3/BBDC4) declaram JCP mensal — o próprio fato relevante do Bradesco de 23/06/2026 fala em "18,3 vezes o valor dos juros mensalmente pagos". Itaúsa, apesar de ser a holding do Itaú, não repassa mensalmente: paga em jan, mar, abr, jul, ago, out e dez.
A maioria das ações paga trimestral ou semestralmente, cada uma no seu calendário. Exemplos reais da watchlist:
| Ativo | Meses em que pagou (últimos 3 anos) |
|---|---|
| RBRY11, BTCI11 (FIIs) | todos os 12 |
| ITUB4, BBDC3 | todos os 12 (JCP mensal) |
| PETR4 | jan, fev, mar, mai, jun, ago, set, nov, dez |
| BBAS3 | fev, mar, jun, ago, set, nov, dez |
| ITSA4 | jan, mar, abr, jul, ago, out, dez |
A watchlist atual já cobre 12/12 meses. Mas a distribuição é torta: dezembro recebe ~R$ 1.394 e julho ~R$ 336 (por R$ 10 mil investidos em cada ativo). A métrica regularidade mede isso: 100% seria receber o mesmo valor todo mês; a carteira atual está em ~51%.
Por isso o script marca três coisas diferentes:
E o --sugerir busca ativos que pagam exatamente nos meses fracos:
bash
python scripts/dividend_calendar.py --sugerir
Se quiser o calendário em reais da sua carteira real, crie
config/portfolio.json:
json
{"posicoes": [{"ticker": "RBRY11", "quantidade": 50},
{"ticker": "ITSA4", "quantidade": 1000}]}
e rode python scripts/dividend_calendar.py --carteira.
``` 1. DESCOBRIR python scripts/discover.py dividendos --top 15 → varre ~2.300 ativos da B3, devolve shortlist (é funil)
ANALISAR /analyze TICKER → fundamentos + notícias + debate touro/urso + risco + 3 notas
PRECIFICAR python scripts/price_targets.py TICKER → preço justo, preço teto, e onde os métodos discordam
ENCAIXAR python scripts/dividend_calendar.py --sugerir → o ativo reforça um mês fraco ou piora a concentração?
DECIDIR qualidade alta + preço abaixo do teto + encaixa no calendário ```
Qualidade antes de preço, e preço antes de calendário. Inverter essa ordem é como escolher casa pelo CEP antes de olhar se o telhado cai.
Se você não souber responder a primeira pergunta, nenhuma das outras importa.
| Erro comum | Como o painel protege |
|---|---|
| Comprar pelo DY alto | Marca dividendo_anormal e usa o menor DPA entre 12M e média de 5 anos |
| Achar que P/VP < 1 é sempre barato | Mostra ROE e histórico de 10 anos junto — banco ruim é barato por um motivo |
| Confundir lucro contábil com recorrente | As análises reconciliam os dois explicitamente |
| Confiar em número de site | validate_data.py cruza Investidor10 contra B3 e CVM; badge no card |
| Ancorar na primeira opinião | O debate usa dois subagentes independentes, cegos um ao outro |
| Extrapolar um trimestre bom | A nota_qualidade olha ~10 anos e não muda com o humor do trimestre |
| Ignorar o custo de oportunidade | O DY alvo do preço teto acompanha a Selic |
data/reports/) — press releases, demonstrações,
fatos relevantes, via arquivos IPE da CVM. Fonte primária.Regra de ouro do projeto: nunca inventar número. Todo valor citado existe em
data/ ou tem link de origem. Quando o dado não existe, o relatório diz que não
existe em vez de preencher com suposição.
```bash
python scripts/add_ticker.py TICKER # adiciona qualquer ativo da B3 /analyze TICKER # análise completa (Claude Code) /refresh # atualiza tudo e re-analisa o desatualizado
python scripts/fetch_dividends.py --all # histórico de proventos com datas python scripts/price_targets.py --all # preço justo e preço teto python scripts/dividend_calendar.py --sugerir
python scripts/discover.py dividendos --top 15 python scripts/discover.py valorizacao --type stock
python scripts/build_dashboard.py ```
Este material é gerado por IA para estudo pessoal e não constitui recomendação de investimento.