Tutorial 18 abr 2026 8 min de leitura

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:

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.

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.

SetorROE típicoObservações
Bancos12% – 20%Alavancagem estrutural; ITUB4, BBAS3 e BBDC4 nessa faixa
Industriais10% – 25%Casos de qualidade extrema chegam a 30% (WEGE3)
Utilities8% – 15%Lucro regulado, alavancagem elevada
Tecnologia / crescimento15% – 40%Capital leve, volatilidade de margem
Commodities5% – 20%Varia com ciclo de preço (VALE3, PETR4, SUZB3)
Consumo10% – 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:

  1. Dívida líquida / EBITDA: acima de 3 é sinal amarelo; ROE alto com esse múltiplo alto exige cuidado redobrado.
  2. Margem líquida: ROE puxado por margem operacional sustentável é diferente de ROE puxado por ganho pontual.
  3. 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

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.