ROE (Retorno sobre o Patrimônio Líquido): Como Calcular e Acessar via API da B3
O ROE é um dos indicadores mais citados na análise fundamentalista brasileira e também um dos mais mal interpretados. Este guia detalha a fórmula, a metodologia CVM usada pela bolsai, o acesso via api roe em Python, armadilhas ligadas à alavancagem e a comparação natural com o ROIC.
O que é o ROE e como interpretar
O ROE (Return on Equity, ou retorno sobre o patrimônio líquido) mede quanto de lucro a empresa gera para cada real de capital próprio. É calculado como o lucro líquido dos últimos doze meses dividido pelo patrimônio líquido médio do mesmo período e expresso em percentual. Funciona como um termômetro de rentabilidade do acionista: quanto maior, mais eficiente está sendo o capital dos sócios na geração de resultado.
A leitura isolada, porém, engana com frequência. Setores intensivos em capital de terceiros, como bancos e utilities, carregam ROE naturalmente alto sem que isso reflita qualidade operacional superior. Empresas em crise, com patrimônio negativo, distorcem completamente a métrica. Por isso o ROE precisa ser lido em conjunto com ROIC, margem líquida e estrutura de capital.
Fórmula do ROE: lucro TTM sobre patrimônio médio
A forma canônica da fórmula é direta:
ROE = (Lucro Líquido 12m / Patrimônio Líquido médio) × 100
Três detalhes fazem diferença no número final. Primeiro, o numerador precisa ser TTM (trailing twelve months), combinando o ITR mais recente com as DFPs anteriores. Usar apenas o lucro anual de DFP atrasa a leitura em até nove meses em relação ao mercado. Segundo, o denominador ideal é a média do patrimônio entre o início e o fim do período, não o patrimônio final. Terceiro, o lucro considerado deve ser o atribuível aos acionistas da controladora, descontando participação de não controladores.
O endpoint de fundamentos aplica essas três convenções de forma automática para as 350+ ações listadas na B3.
Faixas típicas no mercado brasileiro
Embora varie por setor, as faixas abaixo são úteis como referência geral para empresas brasileiras:
- Abaixo de 10% — retorno fraco, geralmente abaixo da taxa livre de risco
- 10% a 15% — razoável, típico de empresas maduras
- 15% a 25% — bom, sinaliza vantagem competitiva ou setor favorável
- Acima de 25% — excepcional, merece escrutínio sobre alavancagem e efeitos não recorrentes
Metodologia da bolsai
O cálculo do ROE na bolsai segue a estrutura da CVM e se apoia em contas específicas do plano de contas padrão.
- Lucro líquido (numerador): conta
3.11da DRE consolidada — resultado atribuível aos sócios da controladora, consistente com a metodologia do Fundamentus. - Patrimônio líquido (denominador), caso geral: conta
2.03do balanço patrimonial consolidado. - Patrimônio líquido para bancos: contas
2.07ou2.08, que correspondem ao patrimônio no plano COSIF, já que bancos publicam o balanço em estrutura diferente das empresas não financeiras. - TTM do lucro: soma dos quatro trimestres mais recentes a partir do último ITR ou DFP disponível.
- Patrimônio médio: média entre o patrimônio do trimestre inicial do período TTM e o do trimestre final.
Essa combinação garante cobertura correta para bancos (BBAS3, ITUB4, BBDC4, SANB11) sem quebrar o cálculo para industriais, varejistas ou utilities. A acurácia medida contra o Fundamentus fica em 96% nas DFPs recentes.
A documentação completa do endpoint de fundamentos lista todos os 27 indicadores calculados, incluindo o ROE, com exemplos de resposta e parâmetros aceitos.
Como acessar o ROE via API em Python
O caminho mais direto para calcular roe python é delegar o cálculo à API e consumir o valor já normalizado. O exemplo abaixo busca o ROE, o lucro líquido 12m e o patrimônio líquido da WEGE3, referência de qualidade industrial no IBOV.
import httpx
API_KEY = "sua_chave_aqui"
BASE = "https://api.usebolsai.com/api/v1"
# ROE e insumos da WEGE3 (referência de qualidade industrial)
r = httpx.get(
f"{BASE}/fundamentals/WEGE3",
headers={"X-API-Key": API_KEY},
timeout=10,
)
d = r.json()
print(f"Ticker: {d['ticker']}")
print(f"ROE (TTM): {d['roe']}%")
print(f"Lucro líquido 12m (R$): {d['lucro_liquido_12m']:,.0f}")
print(f"Patrimônio líquido (R$): {d['patrimonio_liquido']:,.0f}")
print(f"P/L: {d['pl']}")
print(f"P/VP: {d['pvp']}")
# Ticker: WEGE3
# ROE (TTM): 30.1%
# Lucro líquido 12m (R$): 8,412,000,000
# Patrimônio líquido (R$): 27,946,000,000
# P/L: 28.46
# P/VP: 10.39
Para acompanhar o ROE trimestre a trimestre, o endpoint /fundamentals/{ticker}/history retorna cada ponto já com TTM recalculado. Útil para distinguir melhora consistente de um trimestre pontual inflado.
Screening por ROE: encontrando empresas de qualidade
Comprar empresas com ROE alto sem olhar valuation costuma resultar em carteiras caras. A regra mais usada combina qualidade (ROE mínimo) com preço razoável (P/L máximo). O endpoint /screener aceita os dois filtros em uma única requisição.
import httpx
API_KEY = "sua_chave_aqui"
BASE = "https://api.usebolsai.com/api/v1"
# Qualidade + valuation: ROE >= 15% e P/L <= 20
r = httpx.get(
f"{BASE}/screener",
params={
"roe_min": 15,
"pl_max": 20,
"sort": "roe",
"order": "desc",
"limit": 10,
},
headers={"X-API-Key": API_KEY},
)
for row in r.json()["results"]:
print(f"{row['ticker']:6} ROE={row['roe']:>5}% P/L={row['pl']:>6} P/VP={row['pvp']:>5}")
# ITUB4 ROE= 20.1% P/L= 9.99 P/VP= 2.13
# BBAS3 ROE= 17.2% P/L= 4.87 P/VP= 0.89
# VIVT3 ROE= 16.4% P/L= 13.70 P/VP= 1.82
# CMIG4 ROE= 15.8% P/L= 5.12 P/VP= 0.77
# ...
A lógica do filtro é clara: ROE acima de 15% sinaliza eficiência acima da média, e P/L abaixo de 20 garante que o mercado não esteja pagando um prêmio irreal pelo retorno. Variações úteis incluem adicionar divida_liquida_ebitda_max para filtrar alavancagem excessiva e pvp_max para priorizar desconto contra patrimônio.
A mecânica do P/L usado em conjunto aqui é detalhada no post de P/L via API em Python. A contrapartida patrimonial, o P/VP, recebe tratamento próprio em P/VP via API.
Quando o ROE engana
Confiar cegamente no indicador roe leva a decisões ruins. Quatro armadilhas aparecem com frequência em ações da B3.
Alavancagem alta infla o ROE
Substituir equity por dívida é a forma mais antiga de aumentar o ROE sem melhorar nada no negócio. Se a empresa recompra ações financiando-se com debêntures, o patrimônio cai, o lucro líquido praticamente não se mexe e o ROE salta. É por isso que bancos e utilities exibem ROE tão alto: operam com múltiplos de alavancagem que em outros setores seriam inviáveis. O ROE alto em ITUB4 e BBAS3 não é em si um problema, mas não deve ser comparado linearmente com o de uma empresa de software de capital leve.
Ganhos não recorrentes
Venda de subsidiária, reversão de provisão tributária, ganho de variação cambial pontual — qualquer um desses itens joga o lucro líquido para cima em um trimestre e infla o ROE TTM pelos quatro trimestres seguintes. O histórico trimestral do endpoint de fundamentos permite identificar esse ruído rapidamente: se o ROE saltou de 12% para 28% em um único trimestre e voltou depois, o gatilho muito provavelmente foi uma linha extraordinária.
Recompras agressivas de ações
Programas de recompra reduzem o patrimônio líquido diretamente. Quando conduzidos de forma agressiva, fazem o ROE subir sem que o lucro operacional tenha melhorado. A leitura fica mais limpa ao cruzar o ROE com a evolução do número de ações em circulação e com a geração de caixa operacional.
Patrimônio líquido negativo
Empresas em crise profunda podem operar com patrimônio negativo, caso de MGLU3 em determinados períodos recentes em função de prejuízos acumulados. Nessa situação, o ROE perde significado matemático: um lucro positivo dividido por patrimônio negativo resulta em ROE negativo que não reflete performance, e um prejuízo dividido por patrimônio negativo resulta em ROE positivo enganoso. A API retorna null nesses casos em vez de um número inútil.
ROE por setor: ordem de grandeza esperada
A referência setorial ajuda a enquadrar o número. A tabela abaixo sintetiza faixas observadas em ações brasileiras em janeiro e fevereiro de 2026.
| Setor | ROE típico | Observações |
|---|---|---|
| Bancos | 12% – 20% | Alavancagem estrutural; ITUB4, BBAS3 e BBDC4 nessa faixa |
| Industriais | 10% – 25% | Casos de qualidade extrema chegam a 30% (WEGE3) |
| Utilities | 8% – 15% | Lucro regulado, alavancagem elevada |
| Tecnologia / crescimento | 15% – 40% | Capital leve, volatilidade de margem |
| Commodities | 5% – 20% | Varia com ciclo de preço (VALE3, PETR4, SUZB3) |
| Consumo | 10% – 20% | Sensível a taxa de juros e confiança do consumidor |
ROE vs ROIC: quando cada um importa mais
O ROIC (Return on Invested Capital) responde à mesma pergunta, mas considerando todo o capital investido no negócio — equity somado à dívida onerosa. Ignora o efeito da estrutura de capital e mede pura eficiência operacional. Em ações pouco alavancadas, ROE e ROIC costumam ser próximos. Em ações muito alavancadas, a diferença entre os dois é o sinal mais claro de quanto do retorno vem do negócio e quanto vem da escolha de financiamento.
Um ROE de 25% com ROIC de 10% conta uma história diferente de um ROE de 25% com ROIC de 22%. No primeiro caso, a alavancagem está fazendo o trabalho pesado; no segundo, o negócio em si é excepcional. O aprofundamento na métrica e no cálculo está no guia dedicado de ROIC via API em Python.
Integração com outros indicadores
A análise fica mais robusta quando o ROE é lido junto de três dados:
- Dívida líquida / EBITDA: acima de 3 é sinal amarelo; ROE alto com esse múltiplo alto exige cuidado redobrado.
- Margem líquida: ROE puxado por margem operacional sustentável é diferente de ROE puxado por ganho pontual.
- Crescimento histórico de receita e lucro: CAGR 5 anos disponível no mesmo payload do endpoint de fundamentos.
A comparação entre provedores e a escolha de API para esse tipo de fluxo é discutida em bolsai vs brapi. Quem procura um substituto programático direto para o Fundamentus via API encontra cobertura específica em post próprio.
Perguntas frequentes
Qual ROE é considerado bom no Brasil?
ROE abaixo de 10% costuma ser classificado como fraco, entre 10% e 15% razoável, entre 15% e 25% bom e acima de 25% excepcional. Referências atuais na B3 incluem WEGE3 com ROE próximo de 30% (abril de 2026), ITUB4 em torno de 20% e BBAS3 em torno de 17%. A comparação sempre deve respeitar o setor: bancos e utilities operam em faixas distintas de industriais e empresas de tecnologia.
Qual a diferença entre ROE e ROIC?
O ROE mede retorno sobre o patrimônio líquido, que é o capital dos acionistas. O ROIC mede retorno sobre o capital total investido, incluindo a dívida onerosa. O ROIC remove o efeito da estrutura de capital e reflete melhor a qualidade operacional do negócio. Em empresas muito alavancadas, o gap entre ROE e ROIC é a medida direta de quanto a dívida está inflando a métrica de rentabilidade.
Alavancagem aumenta o ROE?
Sim, e esse é um dos aspectos mais importantes a compreender. Trocar equity por dívida reduz o denominador do ROE enquanto o lucro líquido cai pouco (ou até sobe, quando a dívida custa menos que o retorno operacional). O resultado líquido é um ROE maior sem melhoria no desempenho operacional. Bancos, seguradoras e utilities trabalham com alavancagem estrutural e por isso exibem ROE elevado de forma crônica.
Como a bolsai calcula o ROE de bancos?
Para bancos, o patrimônio líquido vem das contas CVM 2.07 ou 2.08 do plano COSIF, em vez da 2.03 usada para empresas não financeiras. O lucro líquido continua sendo extraído da conta 3.11 consolidada. O denominador é a média entre o patrimônio do início e o do fim do período TTM, o que evita distorções causadas por aportes, dividendos extraordinários ou recompras dentro do período.
Leia também
- ROIC via API em Python — retorno sobre capital investido, metodologia e comparação com ROE
- P/L via API em Python — cálculo do preço sobre lucro, TTM e armadilhas
- Alternativa ao Fundamentus via API oficial — acesso programático aos dados que antes só existiam em telas
Disclaimer
O conteúdo deste artigo tem caráter informativo e educacional. Não constitui recomendação de compra ou venda de ativos financeiros. Indicadores como ROE são insumos para análise e não substituem due diligence, leitura de relatórios oficiais nem avaliação de risco compatível com o perfil do investidor. Dados e valores citados refletem a base pública disponível na data de publicação.
por bolsai • 18 de abril de 2026 • 8 min de leitura
Comece agora
O plano gratuito libera 200 requisições por dia, suficiente para testar o endpoint de fundamentos, rodar screeners básicos de ROE e validar a integração antes de escalar. Planos pagos estão descritos em usebolsai.com.