# brapi - API de ações da bolsa de valores brasileira **URL:** https://brapi.dev/ ## Sobre a brapi Acesse o mercado financeiro em poucos segundos. A API mais confiável do Brasil entrega preços históricos (OHLCV), dividendos detalhados e fundamentos completos para seus apps e estratégias financeiras — integrada em minutos. * **Documentação clara e objetiva** * **API simples e completa** * **Fácil de usar, rápida e estável** --- ## Exemplo de Uso (Cotação) ### Requisição ```bash curl https://brapi.dev/api/quote/PETR4 ``` ### Resposta ```json { "results": [ { "currency": "BRL", "marketCap": 406927019658, "shortName": "PETROBRAS PN EDR N2", "longName": "Petróleo Brasileiro S.A. - Petrobras", "regularMarketChange": 0.82, "regularMarketChangePercent": 2.734, "regularMarketTime": "2025-05-02T20:07:46.000Z", "regularMarketPrice": 30.81, "regularMarketDayHigh": 30.81, "regularMarketDayRange": "29.97 - 30.81", "regularMarketDayLow": 29.97, "regularMarketVolume": 32881800, "regularMarketPreviousClose": 29.99, "regularMarketOpen": 30.29, "fiftyTwoWeekRange": "29.96 - 42.09", "fiftyTwoWeekLow": 29.96, "fiftyTwoWeekHigh": 42.09, "symbol": "PETR4", "priceEarnings": 10.864275891251454, "earningsPerShare": 2.8358848, "logourl": "https://icons.brapi.dev/icons/PETR4.svg" } ], "requestedAt": "2025-05-04T01:30:20.521Z", "took": "8ms" } ``` --- ## Empresas e Parceiros que utilizam * Banco Banestes * Toro Investimentos * Suno Research * Grupo Primo * PicPay * A Supernova --- ## Principais Funcionalidades ### Análise Fundamentalista Balanços, DREs e múltiplos direto da CVM, sem bagunça ou parsing manual. Balanço Patrimonial, Demonstrativo de Resultados, Fluxo de Caixa, Valor Adicionado, Dados financeiros e Indicadores financeiros. ### Preços Históricos (OHLCV) Séries completas para backtests e gráficos que impressionam. ### Dividendos Detalhados Datas com, ex e pagamento — otimize sua renda passiva com dados completos. ### Moedas e Criptomoedas Taxas de câmbio e preços históricos de criptomoedas atualizados. ### Inflação e Taxa Selic histórica Dados de inflação, como IPCA e IGP-M, para análises econômicas e financeiras. --- ## Exemplo de Dados Fundamentalistas (WEGE3) ### Requisição ```bash curl https://brapi.dev/api/quote/WEGE3?modules=balanceSheetHistory,balanceSheetHistoryQuarterly ``` ### Resposta (Estrutura de Dados) ```json { "symbol": "WEGE3", // Símbolo do ativo "balanceSheetHistory": [ // Histórico Anual do Balanço Patrimonial { "type": "yearly", // Tipo (Periodicidade: Anual) "endDate": "2024-12-31", // Data de Fim do Período "cash": 7347599000, // Caixa e Equivalentes de Caixa "shortTermInvestments": 648477000, // Investimentos de Curto Prazo "netReceivables": 7394411000, // Contas a Receber Líquidas "inventory": 9903951000, // Estoques "otherCurrentAssets": 1109507000, // Outros Ativos Circulantes "totalCurrentAssets": 27221359000, // Total de Ativos Circulantes "longTermInvestments": 71808000, // Investimentos de Longo Prazo "propertyPlantEquipment": 9933659000, // Imobilizado "otherAssets": 14268342000, // Outros Ativos Não Circulantes "totalAssets": 41489701000, // Total de Ativos "accountsPayable": 3778116000, // Contas a Pagar (Fornecedores) "shortLongTermDebt": 2850956000, // Dívida de Curto Prazo "longTermDebt": 744281000, // Dívida de Longo Prazo "otherLiab": 1212384000, // Outros Passivos Não Circulantes "totalCurrentLiabilities": 15454265000, // Total de Passivos Circulantes "totalLiab": 41489701000, // Total de Passivos "commonStock": 7504517000, // Capital Social "retainedEarnings": null, // Lucros Retidos / Prejuízos Acumulados "treasuryStock": null, // Ações em Tesouraria "otherStockholderEquity": -155191000, // Outros Componentes do Patrimônio Líquido "totalStockholderEquity": 23125217000, // Total do Patrimônio Líquido "netTangibleAssets": null, // Ativos Tangíveis Líquidos "goodWill": null, // Goodwill (Ágio) "intangibleAssets": 2820655000, // Ativos Intangíveis "deferredLongTermAssetCharges": null, // Encargos Diferidos de Ativos LP "deferredLongTermLiab": 170520000, // Passivos Fiscais Diferidos LP "minorityInterest": 920996000, // Participação de Não Controladores "capitalSurplus": null, // Reservas de Capital "accountsReceivableFromClients": 7394411000, // Contas a Receber de Clientes "taxesToRecover": 817414000, // Impostos a Recuperar "longTermAssets": 14268342000, // Total do Ativo Não Circulante "longTermRealizableAssets": 1442220000, // Ativo Realizável a Longo Prazo "longTermDeferredTaxes": 1141821000, // Tributos Diferidos (Ativo Não Circulante) "shareholdings": 71808000, // Participações Societárias "otherNonCurrentAssets": 283265000, // Outros Ativos Não Circulantes (detalhe) "nonCurrentAssets": 20785497000, // Total do Ativo Não Circulante (sinônimo de longTermAssets) "shareholdersEquity": 23125217000, // Patrimônio Líquido (sinônimo de totalStockholderEquity) "realizedShareCapital": 7504517000, // Capital Social Realizado (sinônimo de commonStock) "capitalReserves": -155191000, // Reservas de Capital (sinônimo de capitalSurplus) "revaluationReserves": 3631000, // Reservas de Reavaliação "profitReserves": 11466140000, // Reservas de Lucros "equityValuationAdjustments": 277498000, // Ajustes de Avaliação Patrimonial "otherComprehensiveResults": 3107626000, // Outros Resultados Abrangentes "currentLiabilities": 15454265000, // Total do Passivo Circulante (sinônimo de totalCurrentLiabilities) "socialAndLaborObligations": 728469000, // Obrigações Sociais e Trabalhistas "providers": 3778116000, // Fornecedores (sinônimo de accountsPayable) "taxObligations": 799564000, // Obrigações Fiscais (Circulante) "loansAndFinancing": 2850956000, // Empréstimos e Financiamentos (Circulante) "loansAndFinancingInNationalCurrency": 6089000, // Empréstimos e Financiamentos (Moeda Nacional) "loansAndFinancingInForeignCurrency": 2844867000, // Empréstimos e Financiamentos (Moeda Estrangeira) "otherObligations": 4330000, // Outras Obrigações (Circulante) "nonCurrentLiabilities": 2910219000, // Total do Passivo Não Circulante "longTermLoansAndFinancing": 744281000, // Empréstimos e Financiamentos (Não Circulante) "longTermLoansAndFinancingInNationalCurrency": 248894000, // Empréstimos e Financiamentos LP (Moeda Nacional) "longTermLoansAndFinancingInForeignCurrency": 495387000, // Empréstimos e Financiamentos LP (Moeda Estrangeira) "otherLongTermObligations": 1212384000, // Outras Obrigações (Não Circulante) "longTermProvisions": 783034000, // Provisões (Não Circulante) "updatedAt": "2024-12-31" // Atualizado Em } ], "balanceSheetHistoryQuarterly": [ // Estrutura similar à anual, mas com type: "quarterly" ] } ``` --- ## Casos de Uso 1. **Integração de Dados do Mercado Financeiro:** Conecte cotações, históricos e fundamentos em seus apps, planilhas ou sistemas com nossa API REST. 2. **Análises Históricas e Backtesting:** Acesse séries temporais detalhadas (OHLCV) para backtests precisos. 3. **Dashboards e Aplicações:** Desenvolva rastreadores de portfólio ou plataformas de análise. 4. **Integração com IA (MCP):** Conecte dados financeiros diretamente em assistentes de IA como Cursor, Claude e VS Code via Model Context Protocol. ## Páginas de mercado para agentes As páginas públicas de mercado também possuem representações canônicas em Markdown: * **Lista de ativos:** [https://brapi.dev/quotes.md](https://brapi.dev/quotes.md) * **Ativo individual:** `https://brapi.dev/quote/{TICKER}.md` — por exemplo, [PETR4.md](https://brapi.dev/quote/PETR4.md) * **Negociação de conteúdo:** envie `Accept: text/markdown` para a URL HTML equivalente. ### Exemplo de Log de Aplicação ```text [2023-12-15 14:23:45] INFO Iniciando análise de dados históricos. [2023-12-15 14:23:47] ACTION Obtendo série histórica OHLCV... [2023-12-15 14:23:50] DECISION Análise de padrões. Confiança: 85% [2023-12-15 14:23:52] WARNING Anomalia detectada em indicadores. [2023-12-15 14:23:55] ERROR Backtest concluído. Resultado disponível. ``` --- ## Planos e Preços ### Gratuito **R$ 0/ano** Ideal para testar a API, projetos pessoais ou acadêmicos. * Até 15.000 requisições por mês * Consulta de 1 ativo por requisição * Dados históricos de cotações dos últimos 3 meses * Acesso instantâneo com dados atualizados a cada 30 minutos * Dados Fundamentalistas Profundos (BP, DRE, DFC) * Histórico Completo de Dividendos ### Startup **R$ 119,99/mes** **R$ 1.199,90/ano** (Economize 2 meses no plano anual) Ideal para desenvolvedores e investidores que precisam de mais profundidade. * Volume: 150.000 requisições/mês * Consultas Múltiplas: Até 10 ativos por requisição * Dados atualizados a cada 15 minutos * Histórico de Cotações: Último ano completo * Dados Fundamentalistas Anuais (últimos 5 anos) e DREs anuais * Dados Fundamentalistas Trimestrais e Histórico Profundo (desde 2009) ### Pro (Mais Popular) **R$ 139,99/mês** **R$ 1.399,90/ano** (Economize 2 meses no plano anual) A escolha definitiva para análises profundas e uso profissional. * Volume: 500.000 requisições/mês * Consultas Múltiplas: Até 20 ativos por requisição * Dados atualizados a cada 5 minutos * Dados Fundamentalistas Completos (BP, DRE, DFC, DVA desde 2009) * Histórico de Cotações Extenso: 10+ anos * Indicadores Financeiros Avançados Prontos (P/L, P/VP, ROE, etc.) * Suporte Técnico Prioritário Dedicado --- ## Integração Nossa API REST suporta qualquer linguagem de programação. Exemplos comuns incluem: * JavaScript * Java * Go * Python * TypeScript --- ## Blog e Tutoriais Recentes * **Como Usar a API de Ações Brasileiras com Python: Guia Prático 2025:** Aprenda a integrar a API brapi.dev com Python usando requests, Pandas e Flask. * **API de Ações Brasileiras com TypeScript e JavaScript:** Guia completo de integração usando fetch, Axios, Next.js e Node.js. * **Como Importar Cotações da bolsa brasileira no Excel:** Tutorial usando Power Query e VBA. --- ## Informações Legais e Rodapé **ASL TECNOLOGIA LTDA 2025** CNPJ: 41.182.041/0001-23 Parceiro Microsoft for Startups **Fontes de Dados:** CVM, BCB, Tesouro Direto. **Isenção de Responsabilidade:** A Brapi fornece informações estritamente informativas provenientes de fontes públicas. Não fornecemos orientações de compra ou venda. Não nos responsabilizamos por decisões financeiras tomadas com base nas informações disponibilizadas. Recomendamos consultoria financeira independente. ``` # Comece a usar a API da brapi.dev URL: /docs.mdx Guia rápido para começar a usar a API da brapi.dev. Encontre o endpoint certo para cotações, histórico, dividendos, fundamentos, FIIs, câmbio, cripto e indicadores econômicos do mercado financeiro brasileiro. *** title: 'Comece a usar a API da brapi.dev' description: 'Guia rápido para começar a usar a API da brapi.dev. Encontre o endpoint certo para cotações, histórico, dividendos, fundamentos, FIIs, câmbio, cripto e indicadores econômicos do mercado financeiro brasileiro.' howToSteps: * name: 'Obtenha sua chave de API (opcional para teste)' text: 'Para testar, use as 4 ações gratuitas (PETR4, MGLU3, VALE3, ITUB4) sem token. Para produção, crie uma conta no dashboard para gerar seu token.' * name: 'Faça sua primeira requisição' text: 'Execute curl "[https://brapi.dev/api/v2/stocks/quote?symbols=PETR4](https://brapi.dev/api/v2/stocks/quote?symbols=PETR4)" no terminal para testar sem token, ou adicione o header Authorization: Bearer SEU\_TOKEN para acessar todos os ativos.' * name: 'Receba os dados em JSON' text: 'A API retorna um JSON com results\[].data contendo preço, variação, volume, market cap e outros campos da cotação.' howToTools: * 'Terminal ou linha de comando' * 'cURL ou cliente HTTP' * 'Navegador web' howToSupplies: * 'Conta brapi.dev (opcional para teste)' * 'Token de API brapi.dev (opcional para teste)' *** import { Callout } from 'fumadocs-ui/components/callout'; import { Card, Cards } from 'fumadocs-ui/components/card'; import { Step, Steps } from 'fumadocs-ui/components/steps'; import { Tab, Tabs } from 'fumadocs-ui/components/tabs'; A **brapi.dev** é uma API REST para dados financeiros brasileiros. Você acessa ações, FIIs, BDRs, ETFs, índices, criptomoedas, câmbio e indicadores econômicos em JSON, com dados de fontes como **CVM**, **IBGE** e **Banco Central do Brasil**. O objetivo da brapi é ser o jeito mais simples de levar esses dados para produtos, planilhas, dashboards, robôs, assistentes de IA e sistemas internos. ## Primeira requisição Você pode testar agora com 4 ações brasileiras populares, sem token ou cadastro: **PETR4** (Petrobras) • **MGLU3** (Magazine Luiza) • **VALE3** (Vale) • **ITUB4** (Itaú) ```bash title="Cotação de PETR4" curl "https://brapi.dev/api/v2/stocks/quote?symbols=PETR4" ``` ```bash title="Múltiplas ações" curl "https://brapi.dev/api/v2/stocks/quote?symbols=PETR4,VALE3,MGLU3" ``` ```bash title="Histórico e dividendos" curl "https://brapi.dev/api/v2/stocks/historical?symbols=PETR4&range=1mo&interval=1d" curl "https://brapi.dev/api/v2/stocks/dividends?symbols=ITUB4" ``` Essas ações de teste permitem consultar cotação, histórico, dividendos e dados financeiros para experimentar a API antes de criar uma conta. #### Teste primeiro, autentique depois PETR4, MGLU3, VALE3 e ITUB4 funcionam sem token para você testar a API. Para acessar todos os ativos e usar em produção, crie sua conta e gere um token no dashboard. Seu token estará disponível na seção "Chaves de API" do seu **[Dashboard](/dashboard)** após o login. #### Use o token no backend Em produção, envie o token no header `Authorization`: ```bash title="Terminal (cURL) - Produção" curl --request GET \ --url 'https://brapi.dev/api/v2/stocks/quote?symbols=PETR4' \ --header 'Authorization: Bearer SEU_TOKEN' ``` #### Leia a resposta A resposta vem em JSON, com um item em `results` para cada ticker solicitado. ```jsonc title="Resposta da API (JSON)" { "results": [ { "requestedSymbol": "PETR4", "symbol": "PETR4", "changed": false, "data": { "shortName": "PETROBRAS PN", "longName": "Petróleo Brasileiro S.A. - Petrobras", "currency": "BRL", "regularMarketPrice": 38.50, "regularMarketDayHigh": 39.00, "regularMarketDayLow": 38.20, "regularMarketChange": 0.30, "regularMarketChangePercent": 0.78, "regularMarketTime": "2026-06-14T17:08:00.000Z", "marketCap": 503100000000, "regularMarketVolume": 45678901, "logourl": "https://icons.brapi.dev/icons/PETR4.svg" } } ], "requestedAt": "2026-06-14T17:08:02.000Z", "took": 245 } ``` ## Encontre o Dado Certo Use esta tabela para ir direto ao endpoint do dado que você precisa. | Preciso de | Endpoint | Documentação | Dados principais | | --------------------------- | -------------------------------------------------------------- | ------------------------------------------------------ | ----------------------------------------------------------------------------- | | Buscar e validar tickers B3 | `/api/v2/tickers` | [Tickers disponíveis](/docs/tickers) | Símbolo, nome, tipo, setor e filtros para autocomplete ou screener | | Cotação atual | `/api/v2/stocks/quote?symbols=PETR4,VALE3` | [Cotação de ações](/docs/acoes/cotacao) | Preço, variação, volume, market cap, faixa do dia, faixa de 52 semanas e logo | | Histórico de preços | `/api/v2/stocks/historical?symbols=PETR4&range=1y&interval=1d` | [Histórico de ações](/docs/acoes/historico) | Série OHLCV, volume e preço ajustado | | Dividendos e JCP | `/api/v2/stocks/dividends?symbols=ITUB4` | [Dividendos de ações](/docs/acoes/dividendos) | Dividendos, JCP, bonificações e subscrições de ações | | Perfil da empresa | `/api/v2/stocks/profile?symbols=PETR4` | [Perfil de ações](/docs/acoes/perfil) | CNPJ, setor, indústria, endereço, site, descrição e logo | | Múltiplos e estatísticas | `/api/v2/stocks/statistics?symbols=WEGE3&mode=current` | [Estatísticas de ações](/docs/acoes/estatisticas) | P/L, P/VP, beta, dividend yield, EPS, market cap e séries históricas | | Dados financeiros | `/api/v2/stocks/financial-data?symbols=WEGE3&mode=current` | [Dados financeiros](/docs/acoes/dados-financeiros) | Receita, lucro, EBITDA, margens, dívida e fluxo de caixa livre | | Balanço patrimonial | `/api/v2/stocks/balance-sheet?symbols=PETR4&period=annual` | [Balanço patrimonial](/docs/acoes/balanco-patrimonial) | Ativos, passivos, patrimônio líquido, caixa e dívida | | DRE | `/api/v2/stocks/income-statement?symbols=PETR4&period=annual` | [DRE de ações](/docs/acoes/dre) | Receita, custos, lucro bruto, despesas, EBITDA e lucro líquido | | Fluxo de caixa | `/api/v2/stocks/cash-flow?symbols=PETR4&period=annual` | [Fluxo de caixa](/docs/acoes/fluxo-de-caixa) | Caixa operacional, investimento, financiamento e caixa livre | | DVA | `/api/v2/stocks/value-added?symbols=PETR4&period=annual` | [Valor adicionado](/docs/acoes/valor-adicionado) | Demonstração de valor adicionado anual ou trimestral | | Rendimentos de FIIs | `/api/v2/fii/dividends?symbols=MXRF11` | [FIIs](/docs/fiis) | Rendimentos, histórico, relatórios, imóveis e carteira de fundos imobiliários | ## Autenticação Use o header `Authorization` em código backend e produção. Ele evita expor o token em URLs, logs e histórico de navegação. ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/stocks/quote?symbols=PETR4" ``` ```bash curl "https://brapi.dev/api/v2/stocks/quote?symbols=PETR4&token=SEU_TOKEN" ``` O parâmetro `?token=` funciona para ferramentas que não suportam headers (Google Sheets, Excel Power Query, Notion). Tokens na URL podem aparecer em histórico do navegador, logs de servidor e ferramentas de analytics. **Prefira header auth sempre que possível.** Nunca exponha seu token no código do lado do cliente. Em aplicações web, faça as chamadas para a API da brapi.dev a partir do seu backend. ## Principais Conceitos * **URL base:** todas as requisições usam `https://brapi.dev/api`. * **Símbolos:** endpoints de mercado usam `symbols=PETR4,VALE3` para consultar um ou mais ativos na mesma chamada. * **Resposta:** endpoints por ativo retornam `results[]`; o payload principal fica em `results[].data`. * **Datas:** use `startDate` e `endDate` no formato `YYYY-MM-DD` quando quiser controlar a janela de consulta. * **Períodos contábeis:** fundamentos aceitam `period=annual` ou `period=quarterly`; alguns endpoints também aceitam `mode=current` ou `mode=history`. ## Explore Nossos Endpoints Navegue pelas seções para acessar todos os dados disponíveis. ## SDKs Oficiais Use nossas bibliotecas oficiais quando quiser integração com tipos, helpers e tratamento de erros pronto. ## Exemplos Práticos Veja como buscar os mesmos dados em diferentes ambientes. ```bash title="Cotação, histórico e fundamentos" curl "https://brapi.dev/api/v2/stocks/quote?symbols=PETR4,VALE3" curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/stocks/historical?symbols=PETR4&range=1y&interval=1d" curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/stocks/income-statement?symbols=PETR4&period=annual" ``` ```python title="requests" import requests token = "SEU_TOKEN" response = requests.get( "https://brapi.dev/api/v2/stocks/quote", headers={"Authorization": f"Bearer {token}"}, params={"symbols": "PETR4,VALE3"}, ) response.raise_for_status() data = response.json() for item in data["results"]: quote = item["data"] print(item["symbol"], quote["regularMarketPrice"]) ``` ```javascript title="fetch" const response = await fetch( 'https://brapi.dev/api/v2/stocks/quote?symbols=PETR4,VALE3', { headers: { Authorization: `Bearer ${process.env.BRAPI_API_TOKEN}`, }, }, ); if (!response.ok) { throw new Error(`Erro HTTP ${response.status}`); } const data = await response.json(); for (const item of data.results) { console.log(item.symbol, item.data.regularMarketPrice); } ``` ## Próximos Passos * **[Consulte cotações de ações](/docs/acoes/cotacao):** comece com preço atual, variação e volume. * **[Monte seu fluxo com tickers](/docs/tickers):** busque símbolos, valide entradas e descubra cobertura por endpoint. * **[Veja todos os exemplos](/docs/examples):** aplique a API em planilhas, backends, sites e integrações. # Servidor MCP para IAs URL: /docs/mcp.mdx Conecte a brapi a qualquer assistente de IA com uma única URL. Funciona com Claude, ChatGPT, Cursor, VS Code, n8n e mais de 100 outros clientes. *** title: Servidor MCP para IAs description: Conecte a brapi a qualquer assistente de IA com uma única URL. Funciona com Claude, ChatGPT, Cursor, VS Code, n8n e mais de 100 outros clientes. howToSteps: * name: 'Crie sua conta' text: 'Acesse brapi.dev e crie uma conta gratuita.' * name: 'Adicione o servidor MCP no seu cliente de IA' text: 'Cole a URL do servidor brapi nas configurações de MCP do seu cliente.' * name: 'Faça uma pergunta' text: 'Pergunte sobre cotações, FIIs, câmbio ou indicadores em linguagem natural.' howToTools: * 'Cliente de IA com suporte a MCP (Claude, ChatGPT, Cursor, VS Code, n8n, etc.)' howToSupplies: * 'Conta brapi.dev (gratuita)' *** import { Step, Steps } from 'fumadocs-ui/components/steps'; import { Tab, Tabs } from 'fumadocs-ui/components/tabs'; import { Callout } from 'fumadocs-ui/components/callout'; import { Card, Cards } from 'fumadocs-ui/components/card'; O servidor MCP da brapi conecta seu assistente de IA aos dados do mercado financeiro brasileiro. Com uma única URL, sua IA passa a buscar cotações de ações, FIIs, câmbio, criptomoedas e indicadores econômicos enquanto você conversa com ela. ## URL do servidor ```text https://brapi.dev/api/mcp/mcp ``` Essa é a única URL que você precisa. Copie e cole no seu cliente de IA. Na primeira vez, ele abre o navegador para você fazer login na brapi. ## Configure seu cliente Rode no terminal: ```bash claude mcp add --transport http brapi https://brapi.dev/api/mcp/mcp ``` O Claude abre o navegador para você fazer login. Para verificar a instalação: ```bash claude mcp list ``` Abra o arquivo de configuração do Claude: * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` * **Windows:** `%APPDATA%\Claude\claude_desktop_config.json` E adicione: ```json { "mcpServers": { "brapi": { "command": "npx", "args": ["mcp-remote", "https://brapi.dev/api/mcp/mcp"] } } } ``` Reinicie o Claude. Na primeira pergunta, ele abre o navegador para você fazer login na brapi. Rode no terminal para adicionar o servidor: ```bash codex mcp add brapi --url https://brapi.dev/api/mcp/mcp ``` Em seguida, faça o login com OAuth: ```bash codex mcp login brapi ``` O Codex abre o navegador para você fazer login na brapi. Se o Codex disser que não suporta servidores HTTP, abra `~/.codex/config.toml` e adicione: ```toml [features] experimental_use_rmcp_client = true ``` Isso ativa o cliente de MCP HTTP do Codex. 1. Abra **Configurações → Conectores** no ChatGPT 2. Clique em **Adicionar conector personalizado** 3. Cole a URL: `https://brapi.dev/api/mcp/mcp` 4. Faça login na brapi quando o ChatGPT pedir Conectores personalizados estão disponíveis nos planos pagos do ChatGPT (Plus, Pro, Business e Enterprise). Abra `~/.cursor/mcp.json` (global) ou `.cursor/mcp.json` (do projeto) e adicione: ```json { "mcpServers": { "brapi": { "command": "npx", "args": ["mcp-remote", "https://brapi.dev/api/mcp/mcp"] } } } ``` Reinicie o Cursor. Na primeira pergunta, ele abre o navegador para login. Abra `.vscode/mcp.json` no seu projeto (ou nas configurações do usuário) e adicione: ```json { "mcp": { "servers": { "brapi": { "url": "https://brapi.dev/api/mcp/mcp" } } } } ``` Você precisa do **VS Code 1.99 ou maior** com a extensão **GitHub Copilot**. Habilite `chat.mcp.enabled` nas configurações. 1. Adicione um node **AI Agent** no seu workflow 2. Conecte um node **MCP Client Tool** 3. Em **Server URL**, cole: `https://brapi.dev/api/mcp/mcp` 4. Em **Authentication**, escolha **OAuth2** Pronto para criar automações como alertas de preço, relatórios diários e notificações no Slack/Discord. [Documentação oficial do MCP Client Tool no n8n](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.mcpclienttool/) O servidor da brapi funciona com qualquer cliente que suporte MCP, incluindo **Windsurf**, **Cline**, **Zed**, **Continue**, **Amazon Q**, **Gemini CLI**, **goose** e mais de 100 outros. Em qualquer um deles, use a URL: ```text https://brapi.dev/api/mcp/mcp ``` Se o seu cliente não fizer login automático no navegador, gere um token no [dashboard da brapi](https://brapi.dev) e use o cabeçalho: ```text Authorization: Bearer SEU_TOKEN ``` ## Exemplos de perguntas ```txt Qual é a cotação atual da PETR4? ``` ```txt Compare PETR4 e VALE3 no último mês ``` ```txt Liste as 5 ações com maior volume de negociação hoje ``` ```txt Quais FIIs do segmento de logística têm o maior dividend yield? ``` ```txt Mostre os rendimentos pagos pelo MXRF11 nos últimos 12 meses ``` ```txt Qual a taxa SELIC hoje e como ela mudou nos últimos 12 meses? ``` ```txt Compare a evolução do IPCA e IGP-M nos últimos 5 anos ``` ```txt Qual o preço do Bitcoin em reais agora? ``` ```txt Quais são os vencimentos de opções disponíveis para PETR4? ``` ```txt Mostre delta, gamma e volatilidade implícita das opções de PETR4 no próximo vencimento ``` ## Ferramentas disponíveis A IA tem acesso a 69 ferramentas. As 9 primeiras funcionam sem login; as demais precisam de uma conta brapi. ### Descoberta (sem login) | Ferramenta | O que faz | | ----------------------------------- | ----------------------------------------------------- | | `get_available_stocks` | Lista ações, FIIs, BDRs e índices brasileiros | | `get_available_currencies` | Lista moedas (USD-BRL, EUR-BRL, etc.) | | `get_available_cryptocurrencies` | Lista criptomoedas (BTC, ETH, etc.) | | `get_available_inflation_countries` | Lista países com dados de inflação | | `get_tickers` | Busca e filtra tickers B3 disponíveis | | `get_ticker_renames` | Lista renomes conhecidos de tickers | | `resolve_tickers` | Resolve tickers antigos para o ticker atual | | `get_ticker_coverage` | Mostra quais endpoints existem para cada ticker | | `get_macro_series_available` | Lista séries macroeconômicas (Selic, IPCA, CDI, etc.) | ### Ações, câmbio e criptomoedas | Ferramenta | O que faz | | ---------------------------- | ------------------------------------------------------- | | `get_stock_quotes` | Endpoint legado de cotações, módulos e histórico | | `get_stock_quote` | Snapshot v2: preço, variação, volume, market cap e logo | | `get_stock_historical` | Histórico OHLCV v2 de ações | | `get_stock_dividends` | Dividendos e JCP v2 de ações | | `get_stock_profile` | Perfil cadastral/empresarial v2 | | `get_stock_statistics` | Estatísticas atuais ou históricas v2 | | `get_stock_financial_data` | Dados financeiros atuais ou históricos v2 | | `get_stock_balance_sheet` | Balanço patrimonial anual ou trimestral v2 | | `get_stock_income_statement` | DRE anual ou trimestral v2 | | `get_stock_cash_flow` | Fluxo de caixa anual ou trimestral v2 | | `get_stock_value_added` | Demonstração de valor adicionado v2 | | `get_currency_rates` | Taxas de câmbio em tempo real | | `get_crypto_prices` | Preços de criptomoedas | ### Indicadores macroeconômicos | Ferramenta | O que faz | | ------------------------- | ------------------------------------------------------ | | `get_macro_series` | Histórico de séries macro (Selic, IPCA, IGP-M, CDI...) | | `get_macro_series_latest` | Valor mais recente de cada série macro | | `get_inflation_data` | Dados de inflação (IPCA, IGPM) | | `get_prime_rate_data` | Taxa SELIC e histórico | ### Fundos imobiliários (FIIs) | Ferramenta | O que faz | | ---------------------------- | -------------------------------------------------------- | | `get_fii_list` | Lista FIIs com filtros por segmento, setor e mandato | | `get_fii_indicators` | Indicadores atuais (P/VP, dividend yield, patrimônio...) | | `get_fii_indicators_history` | Evolução mensal dos indicadores | | `get_fii_historical` | Histórico diário de preços (OHLCV) | | `get_fii_properties` | Imóveis físicos, área e vacância consolidada | | `get_fii_properties_history` | Evolução trimestral de imóveis, área e vacância | | `get_fii_portfolio` | Composição normalizada: CRIs, FoFs, imóveis e direitos | | `get_fii_portfolio_history` | Evolução trimestral da composição da carteira | | `get_fii_reports` | Relatórios mensais da CVM com composição da carteira | | `get_fii_dividends` | Histórico de rendimentos pagos | | `get_fii_financials` | Relatórios financeiros DFIN oficiais de FIIs | | `get_fii_annual_reports` | Informes anuais oficiais de FIIs | ### Fundos brasileiros | Ferramenta | O que faz | | ----------------------- | ------------------------------------------------------------ | | `get_funds_list` | Lista FIIs, FIAGROs, FI-Infra/FIFs, FIDCs e FIPs | | `get_funds_indicators` | Preço, NAV oficial, P/NAV, patrimônio, ativos e cotistas | | `get_funds_nav_history` | NAV diário FI/FIF e mensal FIDC com rentabilidade por classe | | `get_funds_profile` | Perfil mensal CVM FI/FIF: investidores, risco e liquidez | | `get_funds_dividends` | Dividendos oficiais de FIAGRO, FI-Infra/FIF, FIDC e FIP | | `get_funds_portfolio` | Carteira CVM CDA agrupada por tipo de ativo | | `get_fiagro_reports` | Relatórios mensais FIAGRO por símbolo ou CNPJ | | `get_fiagro_portfolio` | Alocações FIAGRO em seções normalizadas | | `get_fidc_reports` | Relatórios mensais FIDC, normalmente por CNPJ | | `get_fidc_portfolio` | Setores, vencimentos, risco, cotas e cotistas de FIDCs | | `get_fip_reports` | Relatórios FIP trimestrais/quadrimestrais por CNPJ | ### Tesouro Direto | Ferramenta | O que faz | | --------------------------------- | ---------------------------------------------------- | | `get_treasury_list` | Lista títulos com filtros por indexador e vencimento | | `get_treasury_indicators` | Taxas e preços indicativos atuais | | `get_treasury_indicators_history` | Histórico diário de taxas e preços | ### Opções | Ferramenta | O que faz | | ------------------------------ | ---------------------------------------------- | | `get_option_expirations` | Vencimentos disponíveis de um ativo | | `get_option_strikes` | Strikes disponíveis em um vencimento | | `get_option_chain` | Cadeia de opções de um vencimento | | `get_option_historical` | Histórico diário de uma série específica | | `get_option_analytics` | Gregas e volatilidade implícita por vencimento | | `get_option_analytics_history` | Histórico diário de gregas e IV de uma série | ### Futuros e opções sobre futuros | Ferramenta | O que faz | | -------------------------------------- | -------------------------------------------- | | `get_futures_list` | Lista contratos futuros com filtros | | `get_futures_quote` | Cotação EOD de contratos futuros | | `get_futures_specs` | Especificações de contratos futuros | | `get_futures_historical` | Histórico diário de um contrato futuro | | `get_futures_term_structure` | Curva de vencimentos de um ativo futuro | | `get_futures_option_expirations` | Vencimentos de opções sobre futuros | | `get_futures_option_strikes` | Strikes de opções sobre futuros | | `get_futures_option_chain` | Cadeia de opções sobre futuros | | `get_futures_option_historical` | Histórico diário de uma opção sobre futuro | | `get_futures_option_analytics` | Gregas e IV de opções sobre futuros | | `get_futures_option_analytics_history` | Histórico diário de gregas e IV de uma série | ## Limites por plano As consultas via MCP usam o mesmo limite da API REST. | Plano | Requisições/mês | Ideal para | | ------------ | --------------- | ---------------------------- | | **Gratuito** | 15.000 | Testes e projetos pessoais | | **Startup** | 150.000 | Startups e pequenas empresas | | **Pro** | 500.000 | Aplicações de alto volume | [Ver todos os planos](https://brapi.dev/pricing) ## Próximos passos *** Os dados são fornecidos apenas para fins informativos e não constituem aconselhamento financeiro. Consulte sempre um profissional qualificado antes de tomar decisões de investimento. # Schema OpenAPI URL: /docs/openapi.mdx Especificação completa da API brapi em formato OpenAPI 3.0 *** title: 'Schema OpenAPI' description: 'Especificação completa da API brapi em formato OpenAPI 3.0' ------------------------------------------------------------------------- import { Button } from '~/components/ui/button' import { DownloadSimple, Eye } from '@phosphor-icons/react/ssr' import { OpenApiSchemaBlock } from '~/components/docs/openapi-schema-block'; A especificação completa da API brapi está disponível no formato OpenAPI 3.0 (anteriormente conhecido como Swagger). Esta documentação técnica contém todos os endpoints, parâmetros, schemas de resposta e exemplos de uso. ## Download e Visualização Você pode baixar o arquivo JSON da especificação ou visualizar o arquivo JSON online.
## Schema Completa Especificação completa da API brapi em formato OpenAPI 3.0 para dados de ações, moedas, criptomoedas, inflação, etc. ## Como usar esta especificação ### 1. **Ferramentas de Desenvolvimento** * **Swagger UI**: Visualize e teste a API interativamente * **Postman**: Importe a especificação para criar coleções automaticamente * **Insomnia**: Gere requisições baseadas na especificação * **OpenAPI Generator**: Gere SDKs em diversas linguagens ### 2. **Integração em Projetos** * **Frontend**: Use para gerar tipos TypeScript automaticamente * **Backend**: Valide requisições e respostas contra o schema * **Documentação**: Gere documentação automática para sua aplicação ### 3. **Validação e Testes** * Valide suas requisições contra o schema oficial * Use para testes automatizados de integração * Garanta compatibilidade com futuras versões da API ## Informações Técnicas * **Versão OpenAPI**: 3.0.0 * **Versão da API**: 3.0.0 * **Formato**: JSON * **Atualização**: Automática a cada deploy * **Compatibilidade**: Todas as ferramentas que suportam OpenAPI 3.0+ ## Próximos Passos 1. **[Comece com a documentação geral](/docs)** para entender os conceitos básicos 2. **[Explore os endpoints de ações](/docs/acoes)** para ver exemplos práticos 3. **[Veja exemplos de código](/docs/examples)** em diferentes linguagens 4. **[Configure sua conta](/dashboard)** para obter seu token de API *** *Esta especificação é gerada automaticamente e sempre reflete o estado atual da API brapi.* # Listar Criptomoedas URL: /docs/criptomoedas/available.mdx Endpoints focados na obtenção de dados sobre Criptomoedas. Inclui consulta de cotações atuais em diversas moedas fiduciárias, dados históricos e listagem de criptomoedas suportadas pela API. *** title: Listar Criptomoedas description: >- Endpoints focados na obtenção de dados sobre Criptomoedas. Inclui consulta de cotações atuais em diversas moedas fiduciárias, dados históricos e listagem de criptomoedas suportadas pela API. full: true keywords: brapi, api, documentação, criptomoedas openGraph: title: Listar Criptomoedas description: >- Endpoints focados na obtenção de dados sobre Criptomoedas. Inclui consulta de cotações atuais em diversas moedas fiduciárias, dados históricos e listagem de criptomoedas suportadas pela API. type: website locale: pt\_BR lastUpdated: '2025-04-28T01:22:35.254Z' lang: pt-BR \_openapi: method: GET route: /api/v2/crypto/available toc: * depth: 2 title: Listar Todas as Criptomoedas Disponíveis url: '#listar-todas-as-criptomoedas-disponíveis' structuredData: headings: * content: Listar Todas as Criptomoedas Disponíveis id: listar-todas-as-criptomoedas-disponíveis contents: * content: >- Obtenha a lista completa de todas as siglas (tickers) de criptomoedas que a API Brapi suporta para consulta no endpoint `/api/v2/crypto`. ### Funcionalidade: * Retorna um array `coins` com as siglas. * Pode ser filtrado usando o parâmetro `search`. ### Autenticação: Requer token de autenticação via `token` (query) ou `Authorization` (header). ### Exemplo de Requisição: **Listar todas as criptomoedas disponíveis:** ```bash curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/crypto/available" ``` **Buscar criptomoedas cujo ticker contenha 'DOGE':** ```bash curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/crypto/available?search=DOGE" ``` ### Resposta: A resposta é um objeto JSON com a chave `coins`, contendo um array de strings com as siglas das criptomoedas (ex: `["BTC", "ETH", "LTC", "XRP"]`). heading: listar-todas-as-criptomoedas-disponíveis *** Endpoints focados na obtenção de dados sobre **Criptomoedas**. Inclui consulta de cotações atuais em diversas moedas fiduciárias, dados históricos e listagem de criptomoedas suportadas pela API. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/crypto/available Single endpoint documentation for /api/v2/crypto/available ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/crypto/available **Summary:** Listar Criptomoedas Disponíveis Retorna a lista de criptomoedas disponíveis para consulta no endpoint `/api/v2/crypto`. ### Criptomoedas Populares: * **BTC** — Bitcoin * **ETH** — Ethereum * **BNB** — Binance Coin * **SOL** — Solana * **ADA** — Cardano * **XRP** — Ripple * **DOGE** — Dogecoin * **DOT** — Polkadot * **MATIC** — Polygon * **LTC** — Litecoin * E centenas de outras... ### Uso: Use os símbolos retornados como valor do parâmetro `coin` no endpoint principal. ### Exemplos de Requisição: ```bash curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/crypto/available" curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/crypto/available?search=BTC" ``` **Plano Mínimo:** Startup **Autenticação:** Necessária **Tags:** Criptomoedas ### Parameters - **search** (query) ### Responses #### 200 Lista de símbolos de criptomoedas disponíveis retornada com sucesso. ## Schemas The following schemas are used by this endpoint: ### CryptoAvailableResponse **Properties:** - **coins** (array) *(required)* Array items: **Type:** string # Cotação de Criptomoedas URL: /docs/criptomoedas.mdx Endpoints focados na obtenção de dados sobre Criptomoedas. Inclui consulta de cotações atuais em diversas moedas fiduciárias, dados históricos e listagem de criptomoedas suportadas pela API. *** title: Cotação de Criptomoedas description: >- Endpoints focados na obtenção de dados sobre Criptomoedas. Inclui consulta de cotações atuais em diversas moedas fiduciárias, dados históricos e listagem de criptomoedas suportadas pela API. full: true keywords: brapi, api, documentação, criptomoedas openGraph: title: Cotação de Criptomoedas description: >- Endpoints focados na obtenção de dados sobre Criptomoedas. Inclui consulta de cotações atuais em diversas moedas fiduciárias, dados históricos e listagem de criptomoedas suportadas pela API. type: website locale: pt\_BR lastUpdated: '2025-04-28T01:22:35.254Z' lang: pt-BR \_openapi: method: GET route: /api/v2/crypto toc: * depth: 2 title: Buscar Cotação Detalhada de Criptomoedas url: '#buscar-cotação-detalhada-de-criptomoedas' structuredData: headings: * content: Buscar Cotação Detalhada de Criptomoedas id: buscar-cotação-detalhada-de-criptomoedas contents: * content: >- Obtenha cotações atualizadas e dados históricos para uma ou mais criptomoedas. ### Funcionalidades: * **Cotação Múltipla:** Consulte várias criptomoedas em uma única requisição usando o parâmetro `coin`. * **Moeda de Referência:** Especifique a moeda fiduciária para a cotação com `currency` (padrão: BRL). * **Dados Históricos:** Solicite séries históricas usando `range` e `interval` (similar ao endpoint de ações). ### Autenticação: Requer token de autenticação via `token` (query) ou `Authorization` (header). ### Exemplo de Requisição: **Cotação de Bitcoin (BTC) e Ethereum (ETH) em Dólar Americano (USD):** ```bash curl -X GET "https://brapi.dev/api/v2/crypto?coin=BTC,ETH¤cy=USD&token=SEU_TOKEN" ``` **Cotação de Cardano (ADA) em Real (BRL) com histórico do último mês (intervalo diário):** ```bash curl -X GET "https://brapi.dev/api/v2/crypto?coin=ADA¤cy=BRL&range=1mo&interval=1d&token=SEU_TOKEN" ``` ### Resposta: A resposta contém um array `coins`, onde cada objeto representa uma criptomoeda solicitada, incluindo sua cotação atual, dados de mercado e, opcionalmente, a série histórica (`historicalDataPrice`). heading: buscar-cotação-detalhada-de-criptomoedas *** import { Callout } from 'fumadocs-ui/components/callout'; Endpoints focados na obtenção de dados sobre **Criptomoedas**. Dados agregados de provedores de mercado crypto. Cotações em tempo real para BTC, ETH e 100+ criptoativos em BRL, USD e EUR. Inclui consulta de cotações atuais em diversas moedas fiduciárias, dados históricos e listagem de criptomoedas suportadas pela API. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/crypto Single endpoint documentation for /api/v2/crypto ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/crypto **Summary:** Obter Cotações de Criptomoedas Retorna cotações atualizadas de uma ou mais criptomoedas, com conversão para diferentes moedas fiduciárias. ### Funcionalidades: * **Cotação Atual:** Preço, variação 24h, volume, market cap * **Múltiplas Moedas:** Consulte várias criptos em uma requisição (separadas por vírgula) * **Conversão de Moeda:** BRL (padrão), USD, EUR e outras * **Dados Históricos:** OHLCV via parâmetros `range` e `interval` ### Autenticação: Bearer token ou query param `token`. Obtenha em brapi.dev/dashboard. ### Exemplos de Requisição: ```bash curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/crypto?coin=BTC¤cy=BRL" curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/crypto?coin=BTC,ETH,SOL¤cy=USD" curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/crypto?coin=BTC¤cy=BRL&range=1mo&interval=1d" ``` ### Moedas de Conversão: BRL (Real), USD (Dólar), EUR (Euro), GBP (Libra) e outras ### Campos da Resposta: * `coin` — Símbolo da criptomoeda * `coinName` — Nome completo * `currency` — Moeda de cotação * `regularMarketPrice` — Preço atual * `regularMarketChange` — Variação em valor absoluto * `regularMarketChangePercent` — Variação percentual (%) * `regularMarketDayHigh` / `regularMarketDayLow` — Máxima/Mínima do dia * `regularMarketVolume` — Volume negociado **Plano Mínimo:** Startup **Autenticação:** Necessária **Tags:** Criptomoedas ### Parameters - **coin** (query) - **currency** (query) - **range** (query) - **interval** (query) ### Responses #### 200 Cotações das criptomoedas solicitadas na moeda especificada retornadas com sucesso. #### 400 **Requisição Inválida.** Parâmetro `coin` não fornecido ou inválido. #### 401 **Não Autorizado.** Token de autenticação não fornecido ou inválido. #### 403 **Acesso Proibido.** Seu plano não tem acesso ao módulo de criptomoedas. #### 429 Limite de requisições excedido #### 500 **Erro Interno.** Erro interno ao processar a requisição. #### 503 **Serviço Indisponível.** Serviço externo temporariamente indisponível. ## Schemas The following schemas are used by this endpoint: ### CryptoCoinSimple **Properties:** - **currency** (string) *(required)* - **currencyRateFromUSD** (number) *(required)* - **coinName** (string) *(required)* - **coinImageUrl** (string) - **coin** (string) *(required)* - **regularMarketChange** (number) *(required)* - **regularMarketPrice** (number) *(required)* - **regularMarketChangePercent** (number) *(required)* - **regularMarketDayLow** (number) *(required)* - **regularMarketDayHigh** (number) *(required)* - **regularMarketDayRange** (string) *(required)* - **regularMarketVolume** (number) *(required)* - **marketCap** (number) *(required)* - **regularMarketTime** (string) *(required)* - **usedInterval** (string) - **usedRange** (string) - **historicalDataPrice** (array) Array items: **Properties:** - **date** (integer) *(required)* - **open** (number) *(nullable)* *(required)* - **high** (number) *(nullable)* *(required)* - **low** (number) *(nullable)* *(required)* - **close** (number) *(nullable)* *(required)* - **volume** (number) *(nullable)* *(required)* - **adjustedClose** (number) *(nullable)* *(required)* - **validRanges** (array) Array items: **Type:** string - **validIntervals** (array) Array items: **Type:** string ### CryptoResponseSimple **Properties:** - **coins** (array) *(required)* Array items: Reference to: **CryptoCoinSimple** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) # Dicionário de Campos da API URL: /docs/dicionario.mdx Consulte todos os campos disponíveis na API da brapi com nomes em português, descrições detalhadas, fórmulas de cálculo, tipos, unidades e endpoints. Entenda por que alguns campos retornam null. *** title: Dicionário de Campos da API description: >- Consulte todos os campos disponíveis na API da brapi com nomes em português, descrições detalhadas, fórmulas de cálculo, tipos, unidades e endpoints. Entenda por que alguns campos retornam null. full: true keywords: brapi, api, dicionário, campos, documentação, null, referência openGraph: title: Dicionário de Campos da API description: >- Consulte todos os campos da API da brapi: nomes em português, descrições, fórmulas, tipos, unidades e endpoints. Entenda por que campos retornam null. type: website locale: pt\_BR lastUpdated: '2026-05-22T00:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/dictionary ------------------------- import { Callout } from 'fumadocs-ui/components/callout'; import { Card, Cards } from 'fumadocs-ui/components/card'; import { Step, Steps } from 'fumadocs-ui/components/steps'; import { Tab, Tabs } from 'fumadocs-ui/components/tabs'; O dicionário é um endpoint **público** (não requer autenticação) que retorna todos os campos disponíveis na API, com nome em português, descrição detalhada, fórmula de cálculo, tipo de dado, unidade e em quais endpoints cada campo aparece. `GET /api/v2/dictionary` — sem autenticação, sem limites de plano. Ideal para construir tooltips, labels dinâmicos, documentação automatizada e integrações. ## Como usar O endpoint aceita dois parâmetros de query opcionais: | Parâmetro | Descrição | Exemplo | | ---------- | -------------------------------------------------------------- | -------------------- | | `search` | Busca textual em key, label, description, category e endpoints | `?search=patrimônio` | | `category` | Filtra por categoria (case-insensitive) | `?category=fii` | Ambos podem ser combinados: `?category=balance-sheet&search=ativo`. ## Início rápido ```bash # Listar todos os campos curl "https://brapi.dev/api/v2/dictionary" # Buscar por termo curl "https://brapi.dev/api/v2/dictionary?search=patrimônio" # Filtrar por categoria curl "https://brapi.dev/api/v2/dictionary?category=fii" # Combinar busca e categoria curl "https://brapi.dev/api/v2/dictionary?category=balance-sheet&search=ativo" ``` ```typescript const BASE = 'https://brapi.dev/api/v2/dictionary'; // Listar todos os campos const all = await fetch(BASE).then((r) => r.json()); // Buscar por termo const search = await fetch(`${BASE}?search=patrimônio`).then((r) => r.json()); // Filtrar por categoria const fiiFields = await fetch(`${BASE}?category=fii`).then((r) => r.json()); // Gerar labels dinâmicos a partir do dicionário const labelMap = Object.fromEntries( all.fields.map((f) => [f.key, f.label]), ); console.log(labelMap['dividendYield12m']); // "Dividend Yield 12 meses" ``` ```python import requests BASE = "https://brapi.dev/api/v2/dictionary" # Listar todos os campos all_fields = requests.get(BASE).json() # Buscar por termo search = requests.get(BASE, params={"search": "patrimônio"}).json() # Filtrar por categoria fii_fields = requests.get(BASE, params={"category": "fii"}).json() # Gerar labels dinâmicos label_map = {f["key"]: f["label"] for f in all_fields["fields"]} print(label_map["dividendYield12m"]) # "Dividend Yield 12 meses" ``` ## Estrutura de cada entrada Cada campo retornado contém: | Campo | Tipo | Descrição | | ------------- | -------------- | ---------------------------------------------------------------------- | | `key` | string | Identificador do campo (ex: `dividendYield12m`) | | `label` | string | Nome em português (ex: "Dividend Yield 12 meses") | | `description` | string | Descrição detalhada do que o campo representa | | `calculation` | string \| null | Fórmula de cálculo, quando aplicável | | `endpoints` | string\[] | Endpoints onde o campo aparece | | `category` | string | Categoria do campo | | `type` | string | Tipo de dado: `number`, `string`, `boolean`, `date`, `object`, `array` | | `unit` | string \| null | Unidade de medida (`%`, `R$`, etc.) | ### Exemplo de resposta ```json { "fields": [ { "key": "dividendYield12m", "label": "Dividend Yield 12 meses", "description": "Rendimento de dividendos/rendimentos acumulados dos últimos 12 meses em relação ao preço atual da cota", "calculation": "(soma dos rendimentos dos últimos 12 meses / preço atual) × 100", "endpoints": ["/api/v2/fii/indicators", "/api/v2/fii/indicators/history"], "category": "fii", "type": "number", "unit": "%" } ], "requestedAt": "2026-05-22T12:00:00.000Z", "took": 1 } ``` ## Categorias disponíveis Use o parâmetro `category` para filtrar campos por área: | Categoria | Descrição | Exemplo de endpoint | | ------------------ | ----------------------------------------------- | ----------------------------------------------------- | | `quote` | Cotações de ações, FIIs, ETFs, BDRs | `/api/quote/{tickers}` | | `historical` | Dados históricos OHLCV | `/api/quote/{tickers}` | | `financial-data` | Dados financeiros (receita, EBITDA, margens) | `/api/quote/{tickers}?modules=financialData` | | `balance-sheet` | Balanço Patrimonial | `/api/quote/{tickers}?modules=balanceSheetHistory` | | `income-statement` | Demonstração de Resultado (DRE) | `/api/quote/{tickers}?modules=incomeStatementHistory` | | `cash-flow` | Demonstração de Fluxo de Caixa (DFC) | `/api/quote/{tickers}?modules=cashflowHistory` | | `value-added` | Demonstração de Valor Adicionado (DVA) | `/api/quote/{tickers}?modules=valueAddedHistory` | | `statistics` | Estatísticas-chave (P/L, ROE, Valor de Mercado) | `/api/quote/{tickers}?modules=defaultKeyStatistics` | | `dividends` | Dividendos e JCP | `/api/quote/{tickers}?dividends=true` | | `fii` | Indicadores de Fundos Imobiliários | `/api/v2/fii/indicators` | | `fii-reports` | Relatórios gerenciais mensais da CVM | `/api/v2/fii/reports` | | `treasury` | Tesouro Direto (taxas e preços) | `/api/v2/treasury/indicators` | | `crypto` | Criptomoedas | `/api/v2/crypto` | | `currency` | Taxas de câmbio | `/api/v2/currency` | | `inflation` | Indicadores de inflação (IPCA, IGPM) | `/api/v2/inflation` | | `prime-rate` | Taxa SELIC | `/api/v2/prime-rate` | | `futures` | Contratos futuros B3 | `/api/v2/futures/*` | | `future-options` | Opções sobre futuros | `/api/v2/futures/options/*` | ### Exemplos por categoria ```bash # Campos de cotação (preço, variação, volume, etc.) curl "https://brapi.dev/api/v2/dictionary?category=quote" # Campos históricos (OHLCV) curl "https://brapi.dev/api/v2/dictionary?category=historical" ``` ```bash # Balanço Patrimonial curl "https://brapi.dev/api/v2/dictionary?category=balance-sheet" # DRE curl "https://brapi.dev/api/v2/dictionary?category=income-statement" # Fluxo de Caixa curl "https://brapi.dev/api/v2/dictionary?category=cash-flow" # Dados financeiros agregados curl "https://brapi.dev/api/v2/dictionary?category=financial-data" ``` ```bash # Indicadores de FIIs (P/VP, DY, vacância, etc.) curl "https://brapi.dev/api/v2/dictionary?category=fii" # Relatórios CVM de FIIs curl "https://brapi.dev/api/v2/dictionary?category=fii-reports" ``` ```bash # Campos de Tesouro Direto (taxas, preços indicativos, indexadores) curl "https://brapi.dev/api/v2/dictionary?category=treasury" ``` ```bash # Campos de dividendos e JCP curl "https://brapi.dev/api/v2/dictionary?category=dividends" ``` ## Casos de uso * **Labels dinâmicos**: use `label` para exibir nomes em português na sua interface sem manter uma tabela manual de traduções. * **Tooltips/descrições**: use `description` para mostrar o que cada campo significa ao passar o mouse. * **Fórmulas**: mostre `calculation` para que o usuário entenda como um indicador é calculado (ex: "Dividend Yield = (rendimentos 12m / preço) × 100"). * **Tipos e unidades**: use `type` e `unit` para formatar valores automaticamente (ex: `number` + `%` → `12,5%`; `number` + `R$` → `R$ 1.234,56`). * **Documentação automatizada**: gere páginas de referência a partir do dicionário para manter sua documentação interna sempre atualizada com a API. ## Por que este campo está null? Alguns campos retornam `null` em determinadas consultas. Isso é esperado e acontece por diferentes razões: ### Cobertura por ativo Nem todo campo se aplica a todo ativo. A brapi consolida dados da CVM, B3 e BCB, e cada mercado tem um modelo próprio de divulgação. Quando um campo não se aplica ao ativo ou ao período consultado, ele retorna `null`. ### Diferenças por setor e padrão contábil Empresas de setores distintos seguem padrões contábeis diferentes. Campos como `costOfRevenue` (custo da receita) e `grossProfit` (lucro bruto) são comuns em indústria e comércio, mas **instituições financeiras e bancos** usam o **Plano Cosif** — seus balanços não separam custo de receita da mesma forma, então esses campos vêm como `null`. Exemplos comuns: | Campos | Quem tem | Quem não tem | | ----------------------------------- | --------------------------- | ----------------------------------------- | | `costOfRevenue`, `grossProfit` | Indústria, comércio, varejo | Bancos, seguradoras, holdings financeiras | | `inventories`, `accountsReceivable` | Comércio, indústria | Bancos, seguradoras | | `deposits`, `loansNet` | Bancos | Empresas não-financeiras | ### Seguradoras Seguradoras seguem normas contábeis específicas da SUSEP. Vários campos do balanço padrão (como `propertyPlantEquipment`) podem vir como `null` porque a estrutura patrimonial de seguradoras é organizada de forma diferente (provisões técnicas, sinistros, prêmios). ### Small caps e empresas sem demonstrativos recentes Empresas de menor porte ou que não enviaram demonstrativos recentes à CVM podem ter campos fundamentalistas como `null`. Isso é comum em: * Empresas que acabaram de abrir capital (IPO recente) * Empresas com demonstrativos atrasados ou em análise na CVM * Ativos com baixa liquidez e pouca cobertura ### Campos que não se aplicam ao tipo de ativo Diferentes tipos de ativos têm campos diferentes. Campos que existem para ações não necessariamente se aplicam a outros tipos: | Tipo de ativo | Campos que retornam null | | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **FIIs** | Campos de balanço patrimonial de empresas (`grossProfit`, `ebitda`, etc.). Use `category=fii` e `category=fii-reports` no dicionário para ver os campos específicos de FIIs. | | **ETFs** | Campos fundamentalistas (não têm balanço próprio). | | **BDRs** | Alguns campos fundamentalistas podem estar indisponíveis (dados da empresa estrangeira). | | **Índices** (ex: ^BVSP) | A maioria dos campos além de cotação e histórico retorna `null`. | Use o dicionário para descobrir quais campos pertencem a cada categoria e endpoint. Se um campo aparece no endpoint que você está consultando mas retorna `null`, provavelmente é uma das situações acima. ## Perguntas frequentes r.json()); const tooltips = Object.fromEntries(dict.fields.map(f => [f.key, { label: f.label, desc: f.description, unit: f.unit }]));`} />
# Balanço Patrimonial URL: /docs/acoes/balanco-patrimonial.mdx Histórico anual ou trimestral de balanço patrimonial de ações. *** title: Balanço Patrimonial description: Histórico anual ou trimestral de balanço patrimonial de ações. full: true keywords: brapi, api, ações, balanço patrimonial, balance sheet, stocks, v2 lang: pt-BR \_openapi: method: GET route: /api/v2/stocks/balance-sheet ----------------------------------- Use `period=annual` para dados anuais ou `period=quarterly` para dados trimestrais. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/stocks/balance-sheet Single endpoint documentation for /api/v2/stocks/balance-sheet ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/stocks/balance-sheet **Summary:** Balanço patrimonial v2 Retorna histórico anual ou trimestral de balanço patrimonial. Use period=quarterly para dados trimestrais; startDate/endDate filtram por endDate. **Tags:** Ações ### Parameters - **symbols** (query) *required* - **period** (query) - **startDate** (query) - **endDate** (query) ### Responses #### 200 Dados fundamentalistas recuperados com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 429 Limite de requisições excedido #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### StockBalanceSheetResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **StockFundamentalsSeries** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### StockFundamentalsSeries **Properties:** - **requestedSymbol** (string) *(required)* - **symbol** (string) *(required)* - **changed** (boolean) *(required)* - **data** *(nullable)* Payload do módulo solicitado. Pode ser objeto, array ou null conforme o endpoint. # Cotação de Ações URL: /docs/acoes/cotacao.mdx Snapshot de cotação para ações, BDRs, ETFs, FIIs, units e índices B3 usando o padrão composável /api/v2/stocks. *** title: Cotação de Ações description: >- Snapshot de cotação para ações, BDRs, ETFs, FIIs, units e índices B3 usando o padrão composável /api/v2/stocks. full: true keywords: brapi, api, ações, cotação, stocks, quote, v2, b3 lang: pt-BR \_openapi: method: GET route: /api/v2/stocks/quote --------------------------- Endpoint para buscar apenas o snapshot de cotação de um ou mais tickers. Use quando você precisa de preço atual, variação, volume, market cap, faixa do dia, faixa de 52 semanas e logo, sem carregar módulos financeiros, dividendos ou histórico. Este endpoint segue o padrão composável: primeiro descubra ou valide o ticker em `/api/v2/tickers`, depois consulte o dado de mercado específico em `/api/v2/stocks/quote?symbols=PETR4,VALE3`. Tickers antigos são resolvidos para o ticker atual quando houver renome conhecido. A resposta inclui `requestedSymbol`, `symbol` e `changed` para o cliente saber quando a brapi retornou outro ticker. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/stocks/quote Single endpoint documentation for /api/v2/stocks/quote ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/stocks/quote **Summary:** Cotações v2 de ações Retorna apenas o snapshot de cotação para um ou mais tickers B3. Use este endpoint quando você precisa de preço, variação, volume, market cap, faixa do dia, faixa de 52 semanas e logo, sem carregar módulos financeiros, histórico ou dividendos do endpoint legado `/api/quote/{tickers}`. Este é o primeiro endpoint composável de ações em `/api/v2/stocks/*`. Para descobrir tickers válidos, use `/api/v2/tickers`; para resolver tickers antigos, use `/api/v2/tickers/resolve`. **Tags:** Ações ### Parameters - **symbols** (query) *required* ### Responses #### 200 Cotações recuperadas com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 429 Limite de requisições excedido #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### StockQuoteResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **StockQuoteSeries** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### StockQuoteSeries **Properties:** - **requestedSymbol** (string) *(required)* Ticker informado na requisição. - **symbol** (string) *(required)* Ticker retornado pela brapi após normalização/renome. - **changed** (boolean) *(required)* `true` quando o ticker informado foi resolvido para outro ticker. - **data** *(required)* Reference to: **StockQuoteSnapshot** ### StockQuoteSnapshot **Properties:** - **shortName** (string) *(required)* - **longName** (string) *(required)* - **currency** (string) *(required)* - **regularMarketPrice** (number) *(required)* - **regularMarketDayHigh** (number) *(required)* - **regularMarketDayLow** (number) *(required)* - **regularMarketDayRange** (string) *(required)* - **regularMarketChange** (number) *(required)* - **regularMarketChangePercent** (number) *(required)* - **regularMarketTime** (string) *(required)* Horário da cotação em ISO 8601. - **marketCap** (number) *(nullable)* *(required)* - **regularMarketVolume** (number) *(required)* - **regularMarketPreviousClose** (number) *(required)* - **regularMarketOpen** (number) *(required)* - **fiftyTwoWeekRange** (string) *(required)* - **fiftyTwoWeekLow** (number) *(required)* - **fiftyTwoWeekHigh** (number) *(required)* - **logourl** (string) *(required)* # Dados Financeiros de Ações URL: /docs/acoes/dados-financeiros.mdx Dados financeiros atuais ou históricos de tickers B3. *** title: Dados Financeiros de Ações description: Dados financeiros atuais ou históricos de tickers B3. full: true keywords: brapi, api, ações, dados financeiros, financial data, stocks, v2 lang: pt-BR \_openapi: method: GET route: /api/v2/stocks/financial-data ------------------------------------ Use `mode=current` para dados financeiros atuais/TTM. Use `mode=history` com `period=annual` ou `period=quarterly` para séries históricas. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/stocks/financial-data Single endpoint documentation for /api/v2/stocks/financial-data ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/stocks/financial-data **Summary:** Dados financeiros v2 de ações Retorna dados financeiros atuais/TTM ou históricos. Use mode=history e period=annual|quarterly para séries; startDate/endDate filtram as linhas históricas por date/endDate. **Tags:** Ações ### Parameters - **symbols** (query) *required* - **period** (query) - **startDate** (query) - **endDate** (query) - **mode** (query) ### Responses #### 200 Dados fundamentalistas recuperados com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 429 Limite de requisições excedido #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### StockFinancialDataResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **StockFundamentalsSeries** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### StockFundamentalsSeries **Properties:** - **requestedSymbol** (string) *(required)* - **symbol** (string) *(required)* - **changed** (boolean) *(required)* - **data** *(nullable)* Payload do módulo solicitado. Pode ser objeto, array ou null conforme o endpoint. # Dividendos de Ações URL: /docs/acoes/dividendos.mdx Dividendos, JCP e eventos de ações para ativos B3 stock-like no padrão composável /api/v2/stocks. *** title: Dividendos de Ações description: >- Dividendos, JCP e eventos de ações para ativos B3 stock-like no padrão composável /api/v2/stocks. full: true keywords: brapi, api, ações, dividendos, jcp, proventos, stocks, v2, b3 lang: pt-BR \_openapi: method: GET route: /api/v2/stocks/dividends ------------------------------- Endpoint para buscar dividendos, JCP e eventos de ações de um ou mais tickers B3 stock-like. Use quando você precisa apenas de proventos, sem carregar cotação, histórico ou módulos financeiros. Este endpoint é para ações e instrumentos stock-like. Rendimentos de FIIs continuam no endpoint dedicado `/api/v2/fii/dividends`, que tem fonte e semântica próprias para FIIs. Tickers antigos são resolvidos para o ticker atual quando houver renome conhecido, e a resposta inclui `requestedSymbol`, `symbol` e `changed`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/stocks/dividends Single endpoint documentation for /api/v2/stocks/dividends ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/stocks/dividends **Summary:** Dividendos v2 de ações Retorna dividendos, JCP e eventos de ações para tickers B3 stock-like. Este endpoint substitui o uso de `/api/quote/{tickers}?dividends=true` para novas integrações que precisam apenas de proventos de ações. Para rendimentos de FIIs, use `/api/v2/fii/dividends`, que possui uma fonte e semântica específicas para FIIs. **Tags:** Ações ### Parameters - **symbols** (query) *required* - **startDate** (query) - **endDate** (query) - **sortBy** (query) - **sortOrder** (query) ### Responses #### 200 Dividendos recuperados com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 429 Limite de requisições excedido #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### DividendsData Dados de dividendos (quando dividends=true) **Properties:** - **cashDividends** (array) *(required)* Histórico de dividendos e JCP em dinheiro Array items: **Properties:** - **assetIssued** (string) *(required)* Código ISIN do ativo emissor - **paymentDate** (string) *(nullable)* *(required)* Data de pagamento - **rate** (number) *(required)* Valor por ação - **relatedTo** (string) *(required)* Período de referência - **approvedOn** (string) *(nullable)* *(required)* Data de aprovação - **isinCode** (string) *(required)* Código ISIN - **label** (string) *(required)* Tipo (DIVIDENDO, JCP) - **lastDatePrior** (string) *(nullable)* *(required)* Data-com (último dia antes da data ex) - **remarks** (string) *(required)* Observações - **stockDividends** (array) *(required)* Histórico de bonificações e desdobramentos Array items: **Properties:** - **assetIssued** (string) *(required)* Código ISIN do ativo emissor - **factor** (number) *(required)* Fator do desdobramento/grupamento - **completeFactor** (string) *(required)* Fator completo (ex: 2 para 1) - **approvedOn** (string) *(nullable)* *(required)* Data de aprovação - **isinCode** (string) *(required)* Código ISIN - **label** (string) *(required)* Tipo (DESDOBRAMENTO, GRUPAMENTO) - **lastDatePrior** (string) *(nullable)* *(required)* Data de corte - **remarks** (string) *(required)* Observações - **subscriptions** (array) *(required)* Histórico de subscrições Array items: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### StockDividendsResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **StockDividendsSeries** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### StockDividendsSeries **Properties:** - **requestedSymbol** (string) *(required)* Ticker informado na requisição. - **symbol** (string) *(required)* Ticker retornado pela brapi após normalização/renome. - **changed** (boolean) *(required)* `true` quando o ticker informado foi resolvido para outro ticker. - **data** *(required)* Reference to: **DividendsData** # DRE de Ações URL: /docs/acoes/dre.mdx Histórico anual ou trimestral da demonstração de resultado. *** title: DRE de Ações description: Histórico anual ou trimestral da demonstração de resultado. full: true keywords: brapi, api, ações, dre, income statement, stocks, v2 lang: pt-BR \_openapi: method: GET route: /api/v2/stocks/income-statement -------------------------------------- Use `period=annual` para dados anuais ou `period=quarterly` para dados trimestrais. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/stocks/income-statement Single endpoint documentation for /api/v2/stocks/income-statement ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/stocks/income-statement **Summary:** DRE v2 Retorna histórico anual ou trimestral de demonstração de resultado. Use period=quarterly para dados trimestrais; startDate/endDate filtram por endDate. **Tags:** Ações ### Parameters - **symbols** (query) *required* - **period** (query) - **startDate** (query) - **endDate** (query) ### Responses #### 200 Dados fundamentalistas recuperados com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 429 Limite de requisições excedido #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### StockFundamentalsSeries **Properties:** - **requestedSymbol** (string) *(required)* - **symbol** (string) *(required)* - **changed** (boolean) *(required)* - **data** *(nullable)* Payload do módulo solicitado. Pode ser objeto, array ou null conforme o endpoint. ### StockIncomeStatementResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **StockFundamentalsSeries** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # Estatísticas de Ações URL: /docs/acoes/estatisticas.mdx Indicadores estatísticos atuais ou históricos de tickers B3. *** title: Estatísticas de Ações description: Indicadores estatísticos atuais ou históricos de tickers B3. full: true keywords: brapi, api, ações, estatísticas, statistics, stocks, v2 lang: pt-BR \_openapi: method: GET route: /api/v2/stocks/statistics -------------------------------- Use `mode=current` para indicadores atuais/TTM. Use `mode=history` com `period=annual` ou `period=quarterly` para séries históricas. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/stocks/statistics Single endpoint documentation for /api/v2/stocks/statistics ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/stocks/statistics **Summary:** Estatísticas v2 de ações Retorna indicadores estatísticos atuais ou históricos. Use mode=history e period=annual|quarterly para séries; startDate/endDate filtram as linhas históricas por date/endDate. **Tags:** Ações ### Parameters - **symbols** (query) *required* - **period** (query) - **startDate** (query) - **endDate** (query) - **mode** (query) ### Responses #### 200 Dados fundamentalistas recuperados com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 429 Limite de requisições excedido #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### StockFundamentalsSeries **Properties:** - **requestedSymbol** (string) *(required)* - **symbol** (string) *(required)* - **changed** (boolean) *(required)* - **data** *(nullable)* Payload do módulo solicitado. Pode ser objeto, array ou null conforme o endpoint. ### StockStatisticsResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **StockFundamentalsSeries** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # Fluxo de Caixa URL: /docs/acoes/fluxo-de-caixa.mdx Histórico anual ou trimestral de fluxo de caixa de ações. *** title: Fluxo de Caixa description: Histórico anual ou trimestral de fluxo de caixa de ações. full: true keywords: brapi, api, ações, fluxo de caixa, cash flow, stocks, v2 lang: pt-BR \_openapi: method: GET route: /api/v2/stocks/cash-flow ------------------------------- Use `period=annual` para dados anuais ou `period=quarterly` para dados trimestrais. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/stocks/cash-flow Single endpoint documentation for /api/v2/stocks/cash-flow ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/stocks/cash-flow **Summary:** Fluxo de caixa v2 Retorna histórico anual ou trimestral de fluxo de caixa. Use period=quarterly para dados trimestrais; startDate/endDate filtram por endDate. **Tags:** Ações ### Parameters - **symbols** (query) *required* - **period** (query) - **startDate** (query) - **endDate** (query) ### Responses #### 200 Dados fundamentalistas recuperados com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 429 Limite de requisições excedido #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### StockCashFlowResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **StockFundamentalsSeries** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### StockFundamentalsSeries **Properties:** - **requestedSymbol** (string) *(required)* - **symbol** (string) *(required)* - **changed** (boolean) *(required)* - **data** *(nullable)* Payload do módulo solicitado. Pode ser objeto, array ou null conforme o endpoint. # Histórico de Ações URL: /docs/acoes/historico.mdx Séries históricas OHLCV para ações, BDRs, ETFs, FIIs, units e índices B3 no padrão composável /api/v2/stocks. *** title: Histórico de Ações description: >- Séries históricas OHLCV para ações, BDRs, ETFs, FIIs, units e índices B3 no padrão composável /api/v2/stocks. full: true keywords: brapi, api, ações, histórico, ohlcv, stocks, historical, v2, b3 lang: pt-BR \_openapi: method: GET route: /api/v2/stocks/historical -------------------------------- Endpoint para buscar séries históricas OHLCV de um ou mais tickers. Use quando você precisa de preços no tempo, sem carregar cotação atual, dividendos ou módulos financeiros. O endpoint aceita `range`/`interval` ou `startDate`/`endDate`, respeitando os limites do plano. Tickers antigos são resolvidos para o ticker atual quando houver renome conhecido, e a resposta inclui `requestedSymbol`, `symbol` e `changed`. Para snapshot de cotação, use `/api/v2/stocks/quote`. Para descobrir ou validar tickers antes da consulta, use `/api/v2/tickers`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/stocks/historical Single endpoint documentation for /api/v2/stocks/historical ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/stocks/historical **Summary:** Histórico v2 de ações Retorna séries históricas OHLCV para um ou mais tickers B3. Use este endpoint quando você precisa apenas de preços históricos. Para snapshot de cotação, use `/api/v2/stocks/quote`; para descobrir tickers, use `/api/v2/tickers`. O endpoint aceita `range`/`interval` ou `startDate`/`endDate` e respeita os mesmos limites de plano do comportamento histórico legado em `/api/quote/{tickers}`. **Tags:** Ações ### Parameters - **symbols** (query) *required* - **range** (query) - **interval** (query) - **startDate** (query) - **endDate** (query) - **sortOrder** (query) ### Responses #### 200 Histórico recuperado com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 429 Limite de requisições excedido #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### StockHistoricalPrice **Properties:** - **date** (integer) *(required)* Data do pregão em Unix timestamp (segundos). - **open** (number) *(nullable)* *(required)* - **high** (number) *(nullable)* *(required)* - **low** (number) *(nullable)* *(required)* - **close** (number) *(nullable)* *(required)* - **volume** (number) *(nullable)* *(required)* - **adjustedClose** (number) *(nullable)* *(required)* ### StockHistoricalResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **StockHistoricalResult** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### StockHistoricalResult **Properties:** - **requestedSymbol** (string) *(required)* Ticker informado na requisição. - **symbol** (string) *(required)* Ticker retornado pela brapi após normalização/renome. - **changed** (boolean) *(required)* `true` quando o ticker informado foi resolvido para outro ticker. - **data** *(required)* Reference to: **StockHistoricalSeries** ### StockHistoricalSeries **Properties:** - **usedInterval** (string) *(required)* - **usedRange** (string) *(required)* - **historicalDataPrice** (array) *(required)* Array items: Reference to: **StockHistoricalPrice** # Cotação, Dividendos e Dados Financeiros URL: /docs/acoes.mdx Endpoints para consulta de dados relacionados a ativos negociados na bolsa brasileira, como Ações, Fundos Imobiliários (FIIs), BDRs, ETFs e Índices (ex: IBOVESPA). Permite buscar cotações atuais, dados históricos, informações fundamentalistas (via módulos) e listagens de ativos disponíveis. *** title: Cotação, Dividendos e Dados Financeiros description: >- Endpoints para consulta de dados relacionados a ativos negociados na bolsa brasileira, como Ações, Fundos Imobiliários (FIIs), BDRs, ETFs e Índices (ex: IBOVESPA). Permite buscar cotações atuais, dados históricos, informações fundamentalistas (via módulos) e listagens de ativos disponíveis. full: true keywords: brapi, api, documentação, ações openGraph: title: Cotação, Dividendos e Dados Financeiros description: >- Endpoints para consulta de dados relacionados a ativos negociados na bolsa brasileira, como Ações, Fundos Imobiliários (FIIs), BDRs, ETFs e Índices (ex: IBOVESPA). Permite buscar cotações atuais, dados históricos, informações fundamentalistas (via módulos) e listagens de ativos disponíveis. type: website locale: pt\_BR lastUpdated: '2025-04-28T01:22:35.251Z' lang: pt-BR \_openapi: method: GET route: /api/quote/{tickers} toc: * depth: 2 title: Dados de Ações e Ativos Financeiros url: '#buscar-cotação-detalhada-de-ativos-financeiros' structuredData: headings: * content: Dados de Ações e Ativos Financeiros id: buscar-cotação-detalhada-de-ativos-financeiros contents: * content: > Este endpoint é a principal forma de obter informações detalhadas sobre um ou mais ativos financeiros (ações, FIIs, ETFs, BDRs, índices) listados na bolsa brasileira, identificados pelos seus respectivos **tickers**. ### Funcionalidades Principais: * **Cotação Atual:** Retorna o preço mais recente, variação diária, máximas, mínimas, volume, etc. * **Dados Históricos:** Permite solicitar séries históricas de preços usando os parâmetros `range` e `interval`. * **Dividendos:** Opcionalmente, inclui histórico de dividendos e JCP com `dividends=true`. * **Módulos Adicionais:** Permite requisitar conjuntos de dados financeiros mais aprofundados através do parâmetro `modules` (veja detalhes abaixo). ### Autenticação: É **obrigatório** fornecer um token de autenticação válido, seja via query parameter `token` ou via header `Authorization: Bearer seu_token`. ### 🧪 Ações de Teste (Sem Autenticação): Para facilitar o desenvolvimento e teste, as seguintes **4 ações têm acesso irrestrito** e **não requerem autenticação**: * **PETR4** (Petrobras PN) * **MGLU3** (Magazine Luiza ON) * **VALE3** (Vale ON) * **ITUB4** (Itaú Unibanco PN) **Importante:** Você pode consultar essas ações sem token e com acesso a todos os recursos (históricos, módulos, dividendos). Porém, se misturar essas ações com outras na mesma requisição, a autenticação será obrigatória. ### Exemplos de Requisição: **1. Cotação simples de PETR4 e VALE3 (ações de teste - sem token):** ```bash curl -X GET "https://brapi.dev/api/quote/PETR4,VALE3" ``` **2. Cotação de MGLU3 com dados históricos do último mês (ação de teste - sem token):** ```bash curl -X GET "https://brapi.dev/api/quote/MGLU3?range=1mo&interval=1d" ``` **3. Cotação de ITUB4 incluindo dividendos e dados fundamentalistas (ação de teste - sem token):** ```bash curl -X GET "https://brapi.dev/api/quote/ITUB4?dividends=true&modules=defaultKeyStatistics,financialData" ``` **4. Cotação de WEGE3 com Resumo da Empresa e Balanço Patrimonial Anual (via módulos - requer token):** ```bash curl -X GET "https://brapi.dev/api/quote/WEGE3?modules=summaryProfile,balanceSheetHistory&token=SEU_TOKEN" ``` **5. Exemplo de requisição mista (requer token):** ```bash curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/PETR4,BBAS3" ``` *Nota: Como BBAS3 não é uma ação de teste, toda a requisição requer autenticação, mesmo contendo PETR4.* ### Parâmetro `modules` (Detalhado): O parâmetro `modules` é extremamente poderoso para enriquecer a resposta com dados financeiros detalhados. Você pode solicitar um ou mais módulos, separados por vírgula. **Módulos Disponíveis:** * `summaryProfile`: Informações cadastrais da empresa (endereço, setor, descrição do negócio, website, número de funcionários). * `balanceSheetHistory`: Histórico **anual** do Balanço Patrimonial. * `balanceSheetHistoryQuarterly`: Histórico **trimestral** do Balanço Patrimonial. * `defaultKeyStatistics`: Principais estatísticas da empresa (Valor de Mercado, P/L, ROE, Dividend Yield, etc.) - **TTM (Trailing Twelve Months)**. * `defaultKeyStatisticsHistory`: Histórico **anual** das Principais Estatísticas. * `defaultKeyStatisticsHistoryQuarterly`: Histórico **trimestral** das Principais Estatísticas. * `incomeStatementHistory`: Histórico **anual** da Demonstração do Resultado do Exercício (DRE). * `incomeStatementHistoryQuarterly`: Histórico **trimestral** da Demonstração do Resultado do Exercício (DRE). * `financialData`: Dados financeiros selecionados (Receita, Lucro Bruto, EBITDA, Dívida Líquida, Fluxo de Caixa Livre, Margens) - **TTM (Trailing Twelve Months)**. * `financialDataHistory`: Histórico **anual** dos Dados Financeiros. * `financialDataHistoryQuarterly`: Histórico **trimestral** dos Dados Financeiros. * `valueAddedHistory`: Histórico **anual** da Demonstração do Valor Adicionado (DVA). * `valueAddedHistoryQuarterly`: Histórico **trimestral** da Demonstração do Valor Adicionado (DVA). * `cashflowHistory`: Histórico **anual** da Demonstração do Fluxo de Caixa (DFC). * `cashflowHistoryQuarterly`: Histórico **trimestral** da Demonstração do Fluxo de Caixa (DFC). **Exemplo de Uso do `modules`:** Para obter a cotação de BBDC4 junto com seu DRE trimestral e Fluxo de Caixa anual: ```bash curl -X GET "https://brapi.dev/api/quote/BBDC4?modules=incomeStatementHistoryQuarterly,cashflowHistory&token=SEU_TOKEN" ``` ### Resposta: A resposta é um objeto JSON contendo a chave `results`, que é um array. Cada elemento do array corresponde a um ticker solicitado e contém os dados da cotação e os módulos adicionais requisitados. * **Sucesso (200 OK):** Retorna os dados conforme solicitado. * **Bad Request (400 Bad Request):** Ocorre se um parâmetro for inválido (ex: `range=invalid`) ou se a formatação estiver incorreta. * **Unauthorized (401 Unauthorized):** Token inválido ou ausente. * **Payment Required (402 Payment Required):** Limite de requisições do plano atual excedido. * **Not Found (404 Not Found):** Um ou mais tickers solicitados não foram encontrados. heading: buscar-cotação-detalhada-de-ativos-financeiros *** Endpoints para consulta de dados relacionados a ativos negociados na bolsa brasileira, como **Ações**, **Fundos Imobiliários (FIIs)**, **BDRs**, **ETFs** e **Índices** (ex: IBOVESPA). Permite buscar cotações atuais, dados históricos, informações fundamentalistas (via módulos) e listagens de ativos disponíveis. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/quote/{tickers} Single endpoint documentation for /api/quote/{tickers} ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/quote/{tickers} **Summary:** Consultar Cotação e Dados de Ativos **O ENDPOINT MAIS IMPORTANTE DA API.** Obtém dados detalhados e abrangentes de um ou múltiplos ativos (ações, FIIs, BDRs) em uma única requisição. Combine cotações em tempo real, dados históricos, fundamentos e dividendos conforme necessário. ### Funcionalidades: * **Cotação em Tempo Real:** Preço atual, variação absoluta e percentual, volume, máxima/mínima do dia, range de 52 semanas. * **Dados Históricos:** Preços OHLCV (Open, High, Low, Close, Volume) com intervalos flexíveis (1d, 5d, 1wk, 1mo, 3mo) e períodos (1d até max). * **Fundamentos:** Balanço Patrimonial, DRE, Fluxo de Caixa, DVA, Indicadores-chave (P/L, P/VP, ROE, etc) via parâmetro `modules`. * **Dividendos:** Histórico completo de proventos em dinheiro (dividendos, JCP) e bonificações. ### Autenticação: Requer token Bearer no header ou como query param. Tickers de teste **PETR4** e **VALE3** funcionam sem autenticação. ```bash # Via header (recomendado) curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/PETR4" # Via query param curl "https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN" ``` ### Exemplos de Requisição: ```bash # Simples: apenas cotação atual curl "https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN" # Múltiplos tickers em uma requisição curl "https://brapi.dev/api/quote/PETR4,VALE3,ITUB4?token=SEU_TOKEN" # Com dados históricos (últimos 12 meses, diário) curl "https://brapi.dev/api/quote/PETR4?range=1y&interval=1d&token=SEU_TOKEN" # Com módulos de fundamentos (balanço e DRE) curl "https://brapi.dev/api/quote/PETR4?modules=balanceSheetHistory,incomeStatementHistory&token=SEU_TOKEN" # Completo: histórico + dividendos + estatísticas-chave curl "https://brapi.dev/api/quote/PETR4?range=6mo&interval=1d÷nds=true&modules=balanceSheetHistory,defaultKeyStatistics&token=SEU_TOKEN" ``` ### Módulos Disponíveis: * `summaryProfile` — Perfil da empresa (CNPJ, setor, descrição, website, funcionários) * `balanceSheetHistory` — Balanço Patrimonial anual * `balanceSheetHistoryQuarterly` — Balanço Patrimonial trimestral * `incomeStatementHistory` — DRE anual (Demonstração de Resultado do Exercício) * `incomeStatementHistoryQuarterly` — DRE trimestral * `financialData` — Indicadores financeiros atuais (TTM - Trailing Twelve Months) * `financialDataHistory` — Histórico anual de indicadores financeiros * `financialDataHistoryQuarterly` — Histórico trimestral de indicadores financeiros * `defaultKeyStatistics` — Estatísticas-chave (P/L, P/VP, ROE, Dividend Yield, etc) * `defaultKeyStatisticsHistory` — Histórico anual de estatísticas-chave * `defaultKeyStatisticsHistoryQuarterly` — Histórico trimestral de estatísticas-chave * `cashflowHistory` — Fluxo de Caixa anual * `cashflowHistoryQuarterly` — Fluxo de Caixa trimestral * `valueAddedHistory` — DVA anual (Demonstração de Valor Adicionado) * `valueAddedHistoryQuarterly` — DVA trimestral ### Intervalos Válidos (histórico): * `1d` — Diário * `5d` — 5 dias * `1wk` — Semanal * `1mo` — Mensal * `3mo` — Trimestral ### Períodos Válidos (range): * `1d` — Último dia * `5d` — Últimos 5 dias * `1mo` — Último mês * `3mo` — Últimos 3 meses * `6mo` — Últimos 6 meses * `1y` — Último ano * `2y` — Últimos 2 anos * `5y` — Últimos 5 anos * `10y` — Últimos 10 anos * `ytd` — Ano até hoje * `max` — Máximo disponível ### Campos Principais da Resposta: * `symbol` — Ticker do ativo (ex: PETR4) * `shortName` — Nome curto da empresa * `currency` — Moeda (BRL) * `regularMarketPrice` — Preço atual em BRL * `regularMarketChange` — Variação absoluta * `regularMarketChangePercent` — Variação percentual (%) * `regularMarketVolume` — Volume de negociação do dia * `regularMarketDayHigh` — Máxima do dia * `regularMarketDayLow` — Mínima do dia * `fiftyTwoWeekHigh` — Máxima de 52 semanas * `fiftyTwoWeekLow` — Mínima de 52 semanas * `marketCap` — Capitalização de mercado * `historicalDataPrice` — Array de dados OHLCV (quando `range`/`interval` fornecidos) * `dividendsData` — Histórico de dividendos (quando `dividends=true`) ### Tickers Populares (Teste): * `PETR4` — Petrobras (Energia) * `VALE3` — Vale (Mineração) * `ITUB4` — Itaú Unibanco (Financeiro) * `BBDC4` — Bradesco (Financeiro) * `ABEV3` — Ambev (Consumo) * `WEGE3` — WEG (Indústria) * `RENT3` — Localiza (Transporte) * `BBAS3` — Banco do Brasil (Financeiro) * `MGLU3` — Magazine Luiza (Varejo) ### Fonte dos Dados: CVM (Comissão de Valores Mobiliários) **Plano Mínimo:** Gratuito (limitado a 1 ticker/requisição e módulos básicos) **Autenticação:** Necessária para produção (tickers de teste PETR4 e VALE3 funcionam sem token) **Tags:** Cotações ### Parameters - **tickers** (path) *required* - **range** (query) - **interval** (query) - **startDate** (query) - **endDate** (query) - **dividends** (query) - **modules** (query) - **token** (query) ### Responses #### 200 Dados dos ativos recuperados com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 429 Limite de requisições excedido #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### BalanceSheetEntry **Properties:** - **symbol** (string) *(required)* Ticker do ativo - **type** (string) *(required)* Tipo (yearly, quarterly) - **endDate** (string) *(required)* Data de referência - **cash** (number) *(nullable)* *(required)* Caixa - **shortTermInvestments** (number) *(nullable)* *(required)* Investimentos de curto prazo - **netReceivables** (number) *(nullable)* *(required)* Contas a receber - **inventory** (number) *(nullable)* *(required)* Estoques - **otherCurrentAssets** (number) *(nullable)* *(required)* Outros ativos circulantes - **totalCurrentAssets** (number) *(nullable)* *(required)* Total ativo circulante - **longTermInvestments** (number) *(nullable)* *(required)* Investimentos de longo prazo - **propertyPlantEquipment** (number) *(nullable)* *(required)* Imobilizado - **otherAssets** (number) *(nullable)* *(required)* Outros ativos - **totalAssets** (number) *(nullable)* *(required)* Total de ativos - **accountsPayable** (number) *(nullable)* *(required)* Fornecedores - **shortLongTermDebt** (number) *(nullable)* *(required)* Dívida de curto/longo prazo - **longTermDebt** (number) *(nullable)* *(required)* Dívida de longo prazo - **totalCurrentLiabilities** (number) *(nullable)* *(required)* Passivo circulante total - **totalLiab** (number) *(nullable)* *(required)* Passivo total - **totalStockholderEquity** (number) *(nullable)* *(required)* Patrimônio líquido - **updatedAt** (string) *(nullable)* *(required)* Data de atualização ### DividendsData Dados de dividendos (quando dividends=true) **Properties:** - **cashDividends** (array) *(required)* Histórico de dividendos e JCP em dinheiro Array items: **Properties:** - **assetIssued** (string) *(required)* Código ISIN do ativo emissor - **paymentDate** (string) *(nullable)* *(required)* Data de pagamento - **rate** (number) *(required)* Valor por ação - **relatedTo** (string) *(required)* Período de referência - **approvedOn** (string) *(nullable)* *(required)* Data de aprovação - **isinCode** (string) *(required)* Código ISIN - **label** (string) *(required)* Tipo (DIVIDENDO, JCP) - **lastDatePrior** (string) *(nullable)* *(required)* Data-com (último dia antes da data ex) - **remarks** (string) *(required)* Observações - **stockDividends** (array) *(required)* Histórico de bonificações e desdobramentos Array items: **Properties:** - **assetIssued** (string) *(required)* Código ISIN do ativo emissor - **factor** (number) *(required)* Fator do desdobramento/grupamento - **completeFactor** (string) *(required)* Fator completo (ex: 2 para 1) - **approvedOn** (string) *(nullable)* *(required)* Data de aprovação - **isinCode** (string) *(required)* Código ISIN - **label** (string) *(required)* Tipo (DESDOBRAMENTO, GRUPAMENTO) - **lastDatePrior** (string) *(nullable)* *(required)* Data de corte - **remarks** (string) *(required)* Observações - **subscriptions** (array) *(required)* Histórico de subscrições Array items: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FinancialDataEntry Dados financeiros e indicadores TTM **Properties:** - **symbol** (string) *(required)* Ticker do ativo - **currentPrice** (number) *(nullable)* *(required)* Preço atual - **ebitda** (number) *(nullable)* *(required)* EBITDA - **quickRatio** (number) *(nullable)* *(required)* Liquidez seca - **currentRatio** (number) *(nullable)* *(required)* Liquidez corrente - **debtToEquity** (number) *(nullable)* *(required)* Dívida/PL - **revenuePerShare** (number) *(nullable)* *(required)* Receita por ação - **returnOnAssets** (number) *(nullable)* *(required)* ROA - **returnOnEquity** (number) *(nullable)* *(required)* ROE - **earningsGrowth** (number) *(nullable)* *(required)* Crescimento do lucro do controlador (TTM) — variação dos últimos 4 trimestres em relação aos 4 trimestres imediatamente anteriores, usando Lucro Líquido Atribuível aos Controladores. Para crescimento anual (DRE de exercício vs. exercício anterior), use earningsGrowthAnnual. - **revenueGrowth** (number) *(nullable)* *(required)* Crescimento da receita (TTM) — variação da receita dos últimos 4 trimestres em relação aos 4 trimestres imediatamente anteriores. Para crescimento anual (DRE de exercício vs. exercício anterior), use revenueGrowthAnnual. - **earningsGrowthAnnual** (number) *(nullable)* *(required)* Crescimento anual do lucro do controlador — variação do Lucro Líquido Atribuível aos Controladores do último exercício social completo em relação ao exercício anterior. - **revenueGrowthAnnual** (number) *(nullable)* *(required)* Crescimento anual da receita — variação da Receita Líquida do último exercício social completo em relação ao exercício anterior. - **grossMargins** (number) *(nullable)* *(required)* Margem bruta - **ebitdaMargins** (number) *(nullable)* *(required)* Margem EBITDA - **operatingMargins** (number) *(nullable)* *(required)* Margem operacional - **profitMargins** (number) *(nullable)* *(required)* Margem de lucro - **totalCash** (number) *(nullable)* *(required)* Caixa total - **totalCashPerShare** (number) *(nullable)* *(required)* Caixa por ação - **totalDebt** (number) *(nullable)* *(required)* Dívida total - **totalRevenue** (number) *(nullable)* *(required)* Receita total - **grossProfits** (number) *(nullable)* *(required)* Lucro bruto - **operatingCashflow** (number) *(nullable)* *(required)* Fluxo de caixa operacional - **freeCashflow** (number) *(nullable)* *(required)* Fluxo de caixa livre - **financialCurrency** (string) *(nullable)* *(required)* Moeda - **updatedAt** (string) *(nullable)* *(required)* Data de atualização - **type** (string) *(nullable)* *(required)* Tipo (ttm, yearly, quarterly) ### GuidanceItem **Properties:** - **code** (string) *(required)* - **message** (string) *(required)* - **details** (object) *(required)* **Properties:** - **suggestedEndpoint** (string) *(required)* - **reason** (string) *(required)* ### HistoricalDataPrice **Properties:** - **date** (integer) *(required)* Data do pregão ou do ponto de dados, representada como um timestamp UNIX (número de segundos desde 1970-01-01 UTC). - **open** (number) *(required)* Preço de abertura do ativo no intervalo (dia, semana, mês, etc.). - **high** (number) *(required)* Preço máximo atingido pelo ativo no intervalo. - **low** (number) *(required)* Preço mínimo atingido pelo ativo no intervalo. - **close** (number) *(required)* Preço de fechamento do ativo no intervalo. - **volume** (integer) *(required)* Volume financeiro negociado no intervalo. - **adjustedClose** (number) *(required)* Preço de fechamento ajustado para proventos (dividendos, JCP, bonificações, etc.) e desdobramentos/grupamentos. ### QuoteResult **Properties:** - **symbol** (string) *(required)* Ticker (símbolo) do ativo (ex: PETR4, ^BVSP) - **currency** (string) *(required)* Moeda na qual os valores são expressos (geralmente BRL) - **shortName** (string) *(nullable)* *(required)* Nome curto ou abreviado da empresa - **longName** (string) *(nullable)* *(required)* Nome completo da empresa - **regularMarketPrice** (number) *(nullable)* *(required)* Preço atual ou do último negócio registrado - **regularMarketChange** (number) *(nullable)* *(required)* Variação absoluta do preço no dia em relação ao fechamento anterior - **regularMarketChangePercent** (number) *(nullable)* *(required)* Variação percentual do preço no dia - **regularMarketTime** (string) *(nullable)* *(required)* Data/hora da última atualização da cotação (ISO 8601) - **regularMarketDayHigh** (number) *(nullable)* *(required)* Preço máximo atingido no dia - **regularMarketDayLow** (number) *(nullable)* *(required)* Preço mínimo atingido no dia - **regularMarketDayRange** (string) *(nullable)* *(required)* Intervalo de preço do dia (Mínimo - Máximo) - **regularMarketVolume** (number) *(nullable)* *(required)* Volume financeiro negociado no dia - **regularMarketPreviousClose** (number) *(nullable)* *(required)* Preço de fechamento do pregão anterior - **regularMarketOpen** (number) *(nullable)* *(required)* Preço de abertura no dia - **averageDailyVolume3Month** (number) *(nullable)* *(required)* Média do volume diário nos últimos 3 meses - **averageDailyVolume10Day** (number) *(nullable)* *(required)* Média do volume diário nos últimos 10 dias - **fiftyTwoWeekLow** (number) *(nullable)* *(required)* Preço mínimo nas últimas 52 semanas - **fiftyTwoWeekHigh** (number) *(nullable)* *(required)* Preço máximo nas últimas 52 semanas - **fiftyTwoWeekRange** (string) *(nullable)* *(required)* Intervalo de preço das últimas 52 semanas - **fiftyTwoWeekLowChange** (number) *(nullable)* *(required)* Variação entre preço atual e mínimo de 52 semanas - **fiftyTwoWeekHighChange** (number) *(nullable)* *(required)* Variação entre preço atual e máximo de 52 semanas - **fiftyTwoWeekHighChangePercent** (number) *(nullable)* *(required)* Variação percentual entre preço atual e máximo de 52 semanas - **twoHundredDayAverage** (number) *(nullable)* *(required)* Média móvel de 200 dias - **twoHundredDayAverageChange** (number) *(nullable)* *(required)* Variação entre preço atual e média de 200 dias - **twoHundredDayAverageChangePercent** (number) *(nullable)* *(required)* Variação percentual entre preço atual e média de 200 dias - **marketCap** (number) *(nullable)* *(required)* Capitalização de mercado total - **priceEarnings** (number) *(nullable)* *(required)* Indicador Preço/Lucro (P/L) - **earningsPerShare** (number) *(nullable)* *(required)* Lucro Por Ação (LPA) TTM - **logourl** (string) *(nullable)* *(required)* URL do logo do ativo - **usedInterval** (string) *(nullable)* *(required)* Intervalo efetivamente utilizado para dados históricos - **usedRange** (string) *(nullable)* *(required)* Período efetivamente utilizado para dados históricos - **validRanges** (array) Valores válidos para o parâmetro range Array items: **Type:** string - **validIntervals** (array) Valores válidos para o parâmetro interval Array items: **Type:** string - **historicalDataPrice** (array) Série histórica de preços (quando range/interval fornecidos) Array items: Reference to: **HistoricalDataPrice** - **dividendsData** Reference to: **DividendsData** - **summaryProfile** Reference to: **SummaryProfile** - **balanceSheetHistory** (array) Histórico anual do Balanço Patrimonial Array items: Reference to: **BalanceSheetEntry** - **balanceSheetHistoryQuarterly** (array) Histórico trimestral do Balanço Patrimonial Array items: Reference to: **BalanceSheetEntry** - **financialData** Reference to: **FinancialDataEntry** - **financialDataHistory** (array) Histórico anual de dados financeiros Array items: Reference to: **FinancialDataEntry** - **financialDataHistoryQuarterly** (array) Histórico trimestral de dados financeiros Array items: Reference to: **FinancialDataEntry** ### QuoteTickersResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **QuoteResult** - **guidance** (array) Dicas contextuais quando a requisição funciona mas existe um endpoint mais adequado para o caso de uso. Array items: Reference to: **GuidanceItem** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### SummaryProfile Perfil da empresa (quando modules inclui summaryProfile) **Properties:** - **symbol** (string) *(required)* Ticker do ativo - **cnpj** (string) *(nullable)* *(required)* CNPJ da empresa - **address1** (string) *(nullable)* *(required)* Endereço linha 1 - **address2** (string) *(nullable)* *(required)* Endereço linha 2 - **address3** (string) *(nullable)* *(required)* Endereço linha 3 - **city** (string) *(nullable)* *(required)* Cidade - **state** (string) *(nullable)* *(required)* Estado - **zip** (string) *(nullable)* *(required)* CEP - **country** (string) *(nullable)* *(required)* País - **phone** (string) *(nullable)* *(required)* Telefone - **fax** (string) *(nullable)* *(required)* Fax - **website** (string) *(nullable)* *(required)* Website - **industry** (string) *(nullable)* *(required)* Setor - **industryKey** (string) *(nullable)* *(required)* Chave do setor - **industryDisp** (string) *(nullable)* *(required)* Nome do setor - **sector** (string) *(nullable)* *(required)* Segmento - **sectorKey** (string) *(nullable)* *(required)* Chave do segmento - **sectorDisp** (string) *(nullable)* *(required)* Nome do segmento - **longBusinessSummary** (string) *(nullable)* *(required)* Descrição da empresa - **fullTimeEmployees** (number) *(nullable)* *(required)* Número de funcionários - **companyOfficers** (array) *(required)* Diretoria Array items: - **updatedAt** (string) *(nullable)* *(required)* Data de atualização # Cotação de todas as ações URL: /docs/acoes/list.mdx Endpoints para consulta de dados relacionados a ativos negociados na bolsa brasileira, como Ações, Fundos Imobiliários (FIIs), BDRs, ETFs e Índices (ex: IBOVESPA). Permite buscar cotações atuais, dados históricos, informações fundamentalistas (via módulos) e listagens de ativos disponíveis. *** title: Cotação de todas as ações description: >- Endpoints para consulta de dados relacionados a ativos negociados na bolsa brasileira, como Ações, Fundos Imobiliários (FIIs), BDRs, ETFs e Índices (ex: IBOVESPA). Permite buscar cotações atuais, dados históricos, informações fundamentalistas (via módulos) e listagens de ativos disponíveis. full: true keywords: brapi, api, documentação, ações openGraph: title: Cotação de todas as ações description: >- Endpoints para consulta de dados relacionados a ativos negociados na bolsa brasileira, como Ações, Fundos Imobiliários (FIIs), BDRs, ETFs e Índices (ex: IBOVESPA). Permite buscar cotações atuais, dados históricos, informações fundamentalistas (via módulos) e listagens de ativos disponíveis. type: website locale: pt\_BR lastUpdated: '2025-04-28T01:22:35.251Z' lang: pt-BR \_openapi: method: GET route: /api/quote/list toc: * depth: 2 title: Cotações de todas as ações, fundos, índices e BDRs url: '#cotacoes-de-todas-as-acoes-fundos-indices-e-bdrs' structuredData: headings: * content: Listar e Filtrar Cotações de Ativos id: cotacoes-de-todas-as-acoes-fundos-indices-e-bdrs contents: * content: >- Obtenha uma lista paginada de cotações de diversos ativos (ações, FIIs, BDRs) negociados na bolsa brasileira, com opções avançadas de busca, filtragem e ordenação. ### Funcionalidades: * **Busca por Ticker:** Filtre por parte do ticker usando `search`. * **Filtragem por Tipo:** Restrinja a lista a `stock`, `fund` (FII) ou `bdr` com o parâmetro `type`. * **Filtragem por Setor:** Selecione ativos de um setor específico usando `sector`. * **Ordenação:** Ordene os resultados por diversos campos (preço, variação, volume, etc.) usando `sortBy` e `sortOrder`. * **Paginação:** Controle o número de resultados por página (`limit`) e a página desejada (`page`). ### Autenticação: Requer token de autenticação via `token` (query) ou `Authorization` (header). ### Exemplo de Requisição: **Listar as 10 ações do setor Financeiro com maior volume, ordenadas de forma decrescente:** ```bash curl -X GET "https://brapi.dev/api/quote/list?sector=Finance&sortBy=volume&sortOrder=desc&limit=10&page=1&token=SEU_TOKEN" ``` **Buscar por ativos cujo ticker contenha 'ITUB' e ordenar por nome ascendente:** ```bash curl -X GET "https://brapi.dev/api/quote/list?search=ITUB&sortBy=name&sortOrder=asc&token=SEU_TOKEN" ``` ### Resposta: A resposta contém a lista de `stocks` (e `indexes` relevantes), informações sobre os filtros aplicados, detalhes da paginação (`currentPage`, `totalPages`, `itemsPerPage`, `totalCount`, `hasNextPage`) e listas de setores (`availableSectors`) e tipos (`availableStockTypes`) disponíveis para filtragem. heading: cotacoes-de-todas-as-acoes-fundos-indices-e-bdrs *** Endpoints para consulta de dados relacionados a ativos negociados na bolsa brasileira, como **Ações**, **Fundos Imobiliários (FIIs)**, **BDRs**, **ETFs** e **Índices** (ex: IBOVESPA). Permite buscar cotações atuais, dados históricos, informações fundamentalistas (via módulos) e listagens de ativos disponíveis. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/quote/list Single endpoint documentation for /api/quote/list ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/quote/list **Summary:** Listar Ativos Disponíveis Retorna uma lista paginada de todos os ativos disponíveis na API (Ações, FIIs, BDRs, ETFs, Índices). Use este endpoint para construir screeners, exploradores de ações ou para descobrir novos ativos. ### Funcionalidades: * **Busca por Nome ou Ticker:** Encontre ativos digitando "Petrobras", "PETR4" ou qualquer termo. * **Filtros por Tipo:** Ações (stock), Fundos Imobiliários (fund), BDRs (bdr). * **Filtros por Subtipo:** Units, FIIs, ETFs, FI-Infra, FI-Agro, FIPs, FIDCs e BDRs via `subType`. * **Filtros por Setor:** Energia, Financeiro, Tecnologia, Saúde, etc. * **Ordenação Flexível:** Ordene por volume, preço, market cap ou nome. * **Paginação:** Controle o número de resultados com `limit` e `page`. ### Autenticação: Requer token Bearer. Obtenha seu token em [brapi.dev/dashboard](https://brapi.dev/dashboard). ### Exemplos de Requisição: ```bash # Listar todos os ativos (primeiros 100) curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/list" # Buscar por nome ou ticker curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/list?search=petrobras" # Filtrar por tipo e ordenar por volume curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/list?type=stock&sortBy=volume&sortOrder=desc&limit=10" # Filtrar por subtipo curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/list?subType=fi-agro&limit=10" # Listar apenas FIIs de um setor específico curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/list?type=fund§or=Logística&limit=20" ``` ### Parâmetros de Ordenação: * `volume` — Volume de negociação do dia * `close` — Preço de fechamento * `market_cap_basic` — Capitalização de mercado * `name` — Nome da empresa (alfabético) ### Tipos de Ativo: * `stock` — Ações (Ações ordinárias e preferenciais) * `fund` — Fundos Imobiliários (FIIs) e ETFs * `bdr` — BDRs (Brazilian Depositary Receipts) **Plano Mínimo:** Gratuito **Autenticação:** Necessária (Bearer Token) **Tags:** Cotações ### Parameters - **search** (query) - **sortBy** (query) - **sortOrder** (query) - **limit** (query) - **page** (query) - **sector** (query) - **subsector** (query) - **type** (query) - **subType** (query) - **token** (query) ### Responses #### 200 Lista de ativos retornada com sucesso. #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### QuoteListItem **Properties:** - **stock** (string) *(required)* Ticker do ativo - **name** (string) *(required)* Nome da empresa - **close** (number) *(nullable)* *(required)* Preço de fechamento - **change** (number) *(nullable)* *(required)* Variação percentual - **volume** (number) *(nullable)* *(required)* Volume negociado - **market_cap** (number) *(nullable)* *(required)* Capitalização de mercado - **logo** (string) *(nullable)* *(required)* URL do logo - **sector** (string) *(nullable)* *(required)* Setor - **subsector** (string) *(nullable)* *(required)* Subsetor B3 - **type** (string) *(nullable)* *(required)* Tipo do ativo - **subType** (string) *(nullable)* *(required)* Classificação aditiva do ativo: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr ### QuoteListResponse **Properties:** - **indexes** (array) *(required)* Array items: **Properties:** - **stock** (string) *(required)* - **name** (string) *(required)* - **stocks** (array) *(required)* Array items: Reference to: **QuoteListItem** - **availableSectors** (array) *(required)* Array items: **Type:** string - **availableSubsectors** (array) *(required)* Array items: **Type:** string - **availableStockTypes** (array) *(required)* Array items: **Type:** string - **availableSubTypeTypes** (array) *(required)* Array items: **Type:** string - **currentPage** (number) - **totalPages** (number) - **itemsPerPage** (number) - **totalCount** (number) - **hasNextPage** (boolean) # Migração de /api/quote para /api/v2/stocks URL: /docs/acoes/migracao-v2.mdx Guia para migrar integrações do endpoint legado de cotação para endpoints v2 composáveis. *** title: Migração de /api/quote para /api/v2/stocks description: Guia para migrar integrações do endpoint legado de cotação para endpoints v2 composáveis. full: true keywords: brapi, api, ações, migração, quote, stocks, v2 lang: pt-BR ----------- O endpoint legado `/api/quote/{tickers}` continua funcionando. Para novas integrações, prefira os endpoints v2 por preocupação: descoberta de ticker, cotação, histórico, dividendos e fundamentos ficam separados. ## Fluxo recomendado 1. Use `/api/v2/tickers` para buscar, filtrar e validar símbolos. 2. Use `/api/v2/tickers/resolve` quando o usuário informar um ticker antigo. 3. Use `/api/v2/tickers/renames` para mostrar histórico de mudanças de código. 4. Use `/api/v2/tickers/coverage` para decidir qual endpoint consultar. 5. Chame o endpoint v2 específico para o dado que você precisa. ## Mapeamento de endpoints | Legado | V2 recomendado | | ---------------------------------------------------------- | --------------------------------------------------------------------------------- | | `/api/quote/list` | `/api/v2/tickers` | | `/api/quote/PETR4` | `/api/v2/stocks/quote?symbols=PETR4` | | `/api/quote/PETR4,VALE3` | `/api/v2/stocks/quote?symbols=PETR4,VALE3` | | `/api/quote/PETR4?range=1y&interval=1d` | `/api/v2/stocks/historical?symbols=PETR4&range=1y&interval=1d` | | `/api/quote/PETR4?startDate=2024-01-01&endDate=2024-12-31` | `/api/v2/stocks/historical?symbols=PETR4&startDate=2024-01-01&endDate=2024-12-31` | | `/api/quote/PETR4?dividends=true` | `/api/v2/stocks/dividends?symbols=PETR4` | Dividendos/rendimentos de FIIs continuam em `/api/v2/fii/dividends`. Não use `/api/v2/stocks/dividends` para FIIs quando você precisa da semântica dedicada de rendimentos de fundos imobiliários. ## Diferenças na resposta Os endpoints v2 mantêm o envelope `{ results, requestedAt, took }`, mas cada endpoint retorna apenas o dado daquele domínio: | V2 | Campo principal | | --------------------------------- | ------------------------------------------------------------------------------------------------------------ | | `/api/v2/stocks/quote` | `results[].data.regularMarketPrice`, `results[].data.regularMarketChangePercent`, `results[].data.marketCap` | | `/api/v2/stocks/historical` | `results[].data.historicalDataPrice` | | `/api/v2/stocks/dividends` | `results[].data.cashDividends`, `results[].data.stockDividends`, `results[].data.subscriptions` | | `/api/v2/stocks/profile` | `results[].data` | | `/api/v2/stocks/statistics` | `results[].data` | | `/api/v2/stocks/financial-data` | `results[].data` | | `/api/v2/stocks/balance-sheet` | `results[].data` | | `/api/v2/stocks/income-statement` | `results[].data` | | `/api/v2/stocks/cash-flow` | `results[].data` | | `/api/v2/stocks/value-added` | `results[].data` | Quando um ticker antigo é resolvido, os itens retornam `requestedSymbol`, `symbol` e `changed`, permitindo mostrar ao usuário que o código foi atualizado. ## Mapeamento de módulos | Módulo legado | V2 recomendado | | -------------------------------------- | --------------------------------------------------------------------------- | | `summaryProfile` | `/api/v2/stocks/profile?symbols=PETR4` | | `defaultKeyStatistics` | `/api/v2/stocks/statistics?symbols=PETR4&mode=current` | | `defaultKeyStatisticsHistory` | `/api/v2/stocks/statistics?symbols=PETR4&mode=history&period=annual` | | `defaultKeyStatisticsHistoryQuarterly` | `/api/v2/stocks/statistics?symbols=PETR4&mode=history&period=quarterly` | | `financialData` | `/api/v2/stocks/financial-data?symbols=PETR4&mode=current` | | `financialDataHistory` | `/api/v2/stocks/financial-data?symbols=PETR4&mode=history&period=annual` | | `financialDataHistoryQuarterly` | `/api/v2/stocks/financial-data?symbols=PETR4&mode=history&period=quarterly` | | `balanceSheetHistory` | `/api/v2/stocks/balance-sheet?symbols=PETR4&period=annual` | | `balanceSheetHistoryQuarterly` | `/api/v2/stocks/balance-sheet?symbols=PETR4&period=quarterly` | | `incomeStatementHistory` | `/api/v2/stocks/income-statement?symbols=PETR4&period=annual` | | `incomeStatementHistoryQuarterly` | `/api/v2/stocks/income-statement?symbols=PETR4&period=quarterly` | | `cashflowHistory` | `/api/v2/stocks/cash-flow?symbols=PETR4&period=annual` | | `cashflowHistoryQuarterly` | `/api/v2/stocks/cash-flow?symbols=PETR4&period=quarterly` | | `valueAddedHistory` | `/api/v2/stocks/value-added?symbols=PETR4&period=annual` | | `valueAddedHistoryQuarterly` | `/api/v2/stocks/value-added?symbols=PETR4&period=quarterly` | ## Compatibilidade Use `/api/quote/{tickers}` quando você precisa manter uma integração antiga sem alterar contrato. Use `/api/v2/stocks/*` quando estiver construindo uma integração nova, um agente de IA, uma tela de produto ou um pipeline em que cada chamada deve buscar apenas um tipo de dado. # Perfil de Ações URL: /docs/acoes/perfil.mdx Perfil cadastral e empresarial de tickers B3 no padrão /api/v2/stocks. *** title: Perfil de Ações description: Perfil cadastral e empresarial de tickers B3 no padrão /api/v2/stocks. full: true keywords: brapi, api, ações, perfil, profile, stocks, v2 lang: pt-BR \_openapi: method: GET route: /api/v2/stocks/profile ----------------------------- Use este endpoint para buscar apenas o perfil do ticker, sem cotação, histórico, dividendos ou demonstrações financeiras. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/stocks/profile Single endpoint documentation for /api/v2/stocks/profile ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/stocks/profile **Summary:** Perfil v2 de ações Retorna o perfil cadastral/empresarial do ticker via o módulo legado summaryProfile. **Tags:** Ações ### Parameters - **symbols** (query) *required* ### Responses #### 200 Dados fundamentalistas recuperados com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 429 Limite de requisições excedido #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### StockFundamentalsSeries **Properties:** - **requestedSymbol** (string) *(required)* - **symbol** (string) *(required)* - **changed** (boolean) *(required)* - **data** *(nullable)* Payload do módulo solicitado. Pode ser objeto, array ou null conforme o endpoint. ### StockProfileResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **StockFundamentalsSeries** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # Valor Adicionado URL: /docs/acoes/valor-adicionado.mdx Histórico anual ou trimestral da demonstração de valor adicionado. *** title: Valor Adicionado description: Histórico anual ou trimestral da demonstração de valor adicionado. full: true keywords: brapi, api, ações, valor adicionado, dva, value added, stocks, v2 lang: pt-BR \_openapi: method: GET route: /api/v2/stocks/value-added --------------------------------- Use `period=annual` para dados anuais ou `period=quarterly` para dados trimestrais. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/stocks/value-added Single endpoint documentation for /api/v2/stocks/value-added ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/stocks/value-added **Summary:** DVA v2 Retorna histórico anual ou trimestral de demonstração de valor adicionado. Use period=quarterly para dados trimestrais; startDate/endDate filtram por endDate. **Tags:** Ações ### Parameters - **symbols** (query) *required* - **period** (query) - **startDate** (query) - **endDate** (query) ### Responses #### 200 Dados fundamentalistas recuperados com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 429 Limite de requisições excedido #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### StockFundamentalsSeries **Properties:** - **requestedSymbol** (string) *(required)* - **symbol** (string) *(required)* - **changed** (boolean) *(required)* - **data** *(nullable)* Payload do módulo solicitado. Pode ser objeto, array ou null conforme o endpoint. ### StockValueAddedResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **StockFundamentalsSeries** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # C# URL: /docs/examples/csharp.mdx Integre a API brapi.dev em suas aplicações C# usando HttpClient. Exemplos práticos para buscar cotações de ações brasileiras. *** title: 'C#' description: >- Integre a API brapi.dev em suas aplicações C# usando HttpClient. Exemplos práticos para buscar cotações de ações brasileiras. full: false keywords: brapi, api, csharp, dotnet, httpclient, cotações, ações brasileiras openGraph: title: Integração C# - brapi.dev description: Exemplos de integração usando C# e .NET type: website locale: pt\_BR lastUpdated: '2025-10-12T17:30:00.000Z' lang: pt-BR howToSteps: * name: 'Crie um HttpClient' text: 'Use new HttpClient() com Timeout configurado. Considere reutilizar a instância para evitar esgotamento de sockets.' * name: 'Faça a requisição GET assíncrona' text: 'Use await client.GetStringAsync(url) para buscar dados da API brapi.dev de forma assíncrona.' * name: 'Defina classes para deserialização' text: 'Crie classes Quote e QuoteResponse com propriedades que mapeiam os campos JSON retornados pela API.' * name: 'Deserialize o JSON usando System.Text.Json' text: 'Use JsonSerializer.Deserialize(response) para converter a resposta JSON em objetos C# tipados.' * name: 'Acesse e exiba os dados' text: 'Acesse data.Results\[0].RegularMarketPrice para obter o preço e formate com Console.WriteLine($"R$ {price:F2}").' howToTools: * '.NET 6+ ou .NET Framework 4.8+' * 'Visual Studio ou VS Code' * 'System.Text.Json ou Newtonsoft.Json' howToSupplies: * 'Projeto .NET configurado' * 'Conta brapi.dev' * 'Token de API brapi.dev' *** Integre a API brapi.dev em suas aplicações C# usando HttpClient. ## Exemplo Básico ```csharp using System; using System.Net.Http; using System.Net.Http.Headers; using System.Threading.Tasks; class Program { static async Task Main() { string token = "SEU_TOKEN"; string ticker = "PETR4"; string url = $"https://brapi.dev/api/quote/{ticker}"; using HttpClient client = new HttpClient(); client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token); string response = await client.GetStringAsync(url); Console.WriteLine(response); } } ``` ## Com Classes Tipadas ```csharp using System; using System.Net.Http; using System.Net.Http.Headers; using System.Text.Json; using System.Threading.Tasks; public class Quote { public string Symbol { get; set; } public string ShortName { get; set; } public decimal RegularMarketPrice { get; set; } public decimal RegularMarketChangePercent { get; set; } public string Currency { get; set; } } public class QuoteResponse { public Quote[] Results { get; set; } } public class BrapiClient { private readonly HttpClient _httpClient; private const string BaseUrl = "https://brapi.dev/api"; public BrapiClient(string token) { _httpClient = new HttpClient { Timeout = TimeSpan.FromSeconds(10) }; _httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token); } public async Task GetQuoteAsync(string ticker) { var url = $"{BaseUrl}/quote/{ticker}"; var response = await _httpClient.GetStringAsync(url); var data = JsonSerializer.Deserialize(response); return data?.Results?[0]; } static async Task Main() { var client = new BrapiClient("SEU_TOKEN"); var quote = await client.GetQuoteAsync("PETR4"); if (quote != null) { Console.WriteLine($"{quote.Symbol}: R$ {quote.RegularMarketPrice:F2}"); } } } ``` ## Próximos Passos * Explore [outros exemplos](/docs/examples) * Veja a [documentação completa](/docs) # Microsoft Excel URL: /docs/examples/excel.mdx Aprenda a importar cotações da bolsa brasileira no Excel usando Power Query e VBA com a API brapi.dev. Inclui exemplos com autenticação por header e query param. *** title: 'Microsoft Excel' description: >- Aprenda a importar cotações da bolsa brasileira no Excel usando Power Query e VBA com a API brapi.dev. Inclui exemplos com autenticação por header e query param. full: false keywords: brapi, api, excel, power query, vba, planilha, cotações, batch openGraph: title: Integração com Excel - brapi.dev description: Importe cotações da bolsa brasileira no Excel usando Power Query e VBA type: website locale: pt\_BR lastUpdated: '2026-05-22T00:00:00.000Z' lang: pt-BR howToSteps: * name: 'Abra o Excel e acesse Dados' text: 'Abra o Microsoft Excel e vá para a guia Dados na barra de ferramentas.' * name: 'Conecte-se à API brapi.dev via Web' text: 'Clique em Obter Dados > De Outras Fontes > Da Web e insira a URL: [https://brapi.dev/api/quote/PETR4?token=SEU\_TOKEN](https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN)' * name: 'Converta os dados JSON para tabela' text: 'O Power Query abrirá mostrando os dados JSON. Clique em Converter > Para Tabela e expanda as colunas conforme necessário.' * name: 'Carregue e atualize os dados' text: 'Clique em Fechar e Carregar. Para atualizar, clique com botão direito na tabela e selecione Atualizar.' howToTools: * 'Microsoft Excel' * 'Power Query' howToSupplies: * 'Conta brapi.dev' * 'Token de API brapi.dev' *** Importe cotações automáticas da bolsa brasileira no Microsoft Excel usando Power Query ou VBA. ## Usando Power Query O Power Query permite importar dados JSON diretamente no Excel sem necessidade de programação. ### Passo a Passo (modo simples) 1. Abra o Excel e vá para a guia **Dados** 2. Clique em **Obter Dados** > **De Outras Fontes** > **Da Web** 3. Insira a URL (o Power Query não suporta headers customizados no modo básico): ``` https://brapi.dev/api/quote/PETR4,VALE3,ITUB4?token=SEU_TOKEN ``` 4. Clique em **OK** 5. O Power Query abrirá uma janela mostrando os dados JSON 6. Clique em **Converter** > **Para Tabela** 7. Expanda as colunas conforme necessário 8. Clique em **Fechar e Carregar** > **Dica**: Passe múltiplos tickers separados por vírgula para buscar todos em uma única requisição. O limite de tickers por requisição varia por plano (Gratuito: 1, Startup: 10, Pro: 20). ### Power Query com Header Auth (avançado) Para usar o header `Authorization: Bearer` no Power Query, crie uma consulta via o Editor Avançado (**Dados** > **Obter Dados** > **De Outras Fontes** > **Consulta Nula**, depois **Editor Avançado**): ``` let Token = "SEU_TOKEN", Tickers = "PETR4,VALE3,ITUB4", Url = "https://brapi.dev/api/quote/" & Tickers, Source = Json.Document( Web.Contents(Url, [ Headers = [ #"Authorization" = "Bearer " & Token ] ]) ), Results = Source[results], Table = Table.FromList(Results, Splitter.SplitByNothing(), null, null, ExtraValues.Error), Expanded = Table.ExpandRecordColumn(Table, "Column1", { "symbol", "shortName", "regularMarketPrice", "regularMarketChange", "regularMarketChangePercent", "regularMarketVolume", "marketCap" }) in Expanded ``` Este método é mais seguro pois o token não fica visível na URL. ### Atualização Automática Para atualizar os dados automaticamente: 1. Clique com botão direito na tabela 2. Selecione **Atualizar** 3. Ou configure atualização automática em **Propriedades da Consulta** ## VBA com Header Auth Se precisar de mais controle, use VBA com autenticação via header: ```vb Sub GetBrapiQuote() Dim http As Object Dim token As String Dim tickers As String Dim url As String token = "SEU_TOKEN" tickers = "PETR4,VALE3,ITUB4" url = "https://brapi.dev/api/quote/" & tickers Set http = CreateObject("MSXML2.XMLHTTP") http.Open "GET", url, False http.setRequestHeader "Authorization", "Bearer " & token http.Send If http.Status = 200 Then ' Requer biblioteca VBA-JSON para parsing Dim json As Object Set json = JsonConverter.ParseJson(http.responseText) Dim i As Long i = 1 Dim result As Variant For Each result In json("results") Range("A" & i).Value = result("symbol") Range("B" & i).Value = result("regularMarketPrice") Range("C" & i).Value = result("regularMarketChangePercent") i = i + 1 Next result Else MsgBox "Erro HTTP " & http.Status & ": " & http.responseText End If End Sub ``` > **Nota**: Requer biblioteca [VBA-JSON](https://github.com/VBA-tools/VBA-JSON) para parsing de JSON. ## Autenticação: Header vs Query Param | Método | Quando usar | Segurança | | -------------------------------- | -------------------------------------- | --------------------------- | | `Authorization: Bearer` (header) | VBA, Power Query avançado | Token não aparece na URL | | `?token=SEU_TOKEN` (query param) | Power Query simples, importação rápida | Token visível na URL e logs | Para importações simples no Power Query, o `?token=` funciona sem configuração extra. Para VBA e scripts automatizados, prefira o header `Authorization: Bearer`. ## Dicas de Uso 1. **Busque em lote**: Passe múltiplos tickers separados por vírgula (`PETR4,VALE3,ITUB4`) em uma única requisição 2. **Monitore seu uso**: Acompanhe o consumo no [dashboard](https://brapi.dev/dashboard) 3. **Token em célula**: No VBA, considere ler o token de uma célula nomeada (`Range("TokenAPI").Value`) em vez de hardcodar no código ## Próximos Passos * Veja como usar no [Google Sheets](/docs/examples/google-sheets) * Explore [outros exemplos](/docs/examples) * Consulte a [documentação da API](/docs) # Google Sheets URL: /docs/examples/google-sheets.mdx Aprenda a buscar cotações automáticas de ações brasileiras no Google Sheets usando a API brapi.dev. Inclui função em lote (batch) para economizar requisições e evitar limites do Apps Script. *** title: 'Google Sheets' description: >- Aprenda a buscar cotações automáticas de ações brasileiras no Google Sheets usando a API brapi.dev. Inclui função em lote (batch) para economizar requisições e evitar limites do Apps Script. full: false keywords: brapi, api, google sheets, planilha, cotações, ETFs, apps script, IMAB11, WRLD11, automação, batch, lote openGraph: title: Integração com Google Sheets - brapi.dev description: >- Busque cotações automáticas de ações brasileiras no Google Sheets com a API brapi.dev. Solução para ETFs brasileiros que não aparecem no Google Finance. type: website locale: pt\_BR lastUpdated: '2026-05-22T00:00:00.000Z' lang: pt-BR howToSteps: * name: 'Obtenha sua chave API' text: 'Acesse brapi.dev, crie uma conta gratuita e copie seu token API no painel de usuário.' * name: 'Adicione as funções no Apps Script' text: 'Abra sua planilha no Google Sheets, vá em Extensões > Apps Script, apague o código existente e cole as funções BRAPI\_PRICE e BRAPI\_BATCH fornecidas. Salve o projeto.' * name: 'Use a função em lote na sua planilha' text: 'Liste seus tickers em uma coluna e use =BRAPI\_BATCH(A2:A20; $A$1) para buscar todos os preços em uma única requisição.' howToTools: * 'Google Sheets' * 'Google Apps Script' * 'Navegador web' howToSupplies: * 'Conta brapi.dev gratuita' * 'Token de API brapi.dev' * 'Planilha Google Sheets' *** O Google Sheets é uma ferramenta poderosa para acompanhar seus investimentos de forma automática. Através do Google Apps Script, você pode criar funções personalizadas que buscam cotações diretamente da brapi.dev. ## Por que usar a brapi.dev no Google Sheets? A função `GOOGLEFINANCE` não funciona para muitos ativos brasileiros, especialmente ETFs como IMAB11, WRLD11, IB5M11 e IRFM11. A integração com a brapi.dev resolve esse problema, oferecendo: * **Dados confiáveis**: Acesso direto aos dados do mercado brasileiro * **ETFs brasileiros**: Funciona com todos os ativos brasileiros * **Atualização automática**: Cotações atualizadas conforme seu plano * **Uso gratuito**: 15.000 requisições mensais no plano gratuito ## Passo a Passo ### 1. Obtenha sua chave API 1. Acesse [brapi.dev](https://brapi.dev) 2. Crie uma conta gratuita 3. No painel de usuário, copie seu **token API** ### 2. Adicione as funções no Apps Script 1. Abra sua planilha no Google Sheets 2. Clique em **Extensões** > **Apps Script** 3. Apague o código existente e cole o código abaixo: ```javascript /** * Busca preços de múltiplos tickers em UMA requisição (recomendado). * Uso: =BRAPI_BATCH(A2:A20; $A$1) * @param {Range} tickers - Range com os códigos dos ativos (coluna) * @param {string} token - Token da API brapi.dev * @return {number[][]} Coluna com o preço de cada ativo * @customfunction */ function BRAPI_BATCH(tickers, token) { if (!tickers) return [["Erro: informe tickers"]]; if (token && typeof token === 'object' && token.length) { token = token[0][0]; } if (!token) { var sh = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); token = sh.getRange('A1').getDisplayValue(); } if (!token) return [["Erro: token brapi.dev ausente"]]; // Monta a lista de tickers a partir do range var tickerList = []; for (var i = 0; i < tickers.length; i++) { var t = String(tickers[i][0] || '').toUpperCase().trim(); if (t) tickerList.push(t); } if (tickerList.length === 0) return [["Sem tickers"]]; // Uma única requisição para todos os tickers (separados por vírgula) var url = 'https://brapi.dev/api/quote/' + encodeURIComponent(tickerList.join(',')) + '?token=' + encodeURIComponent(token); var options = { muteHttpExceptions: true, headers: { 'User-Agent': 'GoogleSheets-brapi/1.0' } }; var response = UrlFetchApp.fetch(url, options); if (response.getResponseCode() !== 200) { return tickers.map(function() { return ["HTTP " + response.getResponseCode()]; }); } var json = JSON.parse(response.getContentText()); var results = (json && json.results) || []; // Mapeia símbolo → preço para preservar a ordem do range var priceMap = {}; for (var j = 0; j < results.length; j++) { var sym = results[j].symbol; var price = results[j].regularMarketPrice; if (price == null) price = results[j].lastPrice; if (price == null) price = results[j].close; priceMap[sym] = price != null ? price : null; } // Retorna um array 2D na mesma ordem da coluna de entrada return tickers.map(function(row) { var key = String(row[0] || '').toUpperCase().trim(); if (!key) return [""]; var val = priceMap[key] != null ? priceMap[key] : priceMap[key + '.SA']; return [val != null ? val : "Não encontrado"]; }); } /** * Busca o preço de UM ticker via brapi.dev (1 requisição por célula). * Prefira BRAPI_BATCH para economizar requisições. * Uso: =BRAPI_PRICE("PETR4"; $A$1) * @param {string} ticker - Código do ativo (ex: "PETR4", "VALE3", "IMAB11") * @param {string} token - Token da API brapi.dev * @return {number} Preço atual do ativo * @customfunction */ function BRAPI_PRICE(ticker, token) { if (!ticker) return "Erro: informe ticker"; if (token && typeof token === 'object' && token.length) { token = token[0][0]; } if (!token) { var sh = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); token = sh.getRange('A1').getDisplayValue(); } if (!token) return "Erro: token brapi.dev ausente"; ticker = String(ticker).toUpperCase().trim(); var url = 'https://brapi.dev/api/quote/' + encodeURIComponent(ticker) + '?token=' + encodeURIComponent(token); var options = { muteHttpExceptions: true, headers: { 'User-Agent': 'GoogleSheets-brapi/1.0' } }; var response = UrlFetchApp.fetch(url, options); if (response.getResponseCode() !== 200) { return "HTTP " + response.getResponseCode() + ": " + response.getContentText().substring(0, 200); } var json = JSON.parse(response.getContentText()); var result = (json && json.results && json.results[0]) || null; if (!result) return "Sem dados retornados"; var price = result.regularMarketPrice; if (price == null) price = result.lastPrice; if (price == null) price = result.close; return price != null ? price : "Preço não encontrado"; } /** * Retorna dados completos de um ativo * Uso: =BRAPI_DATA("PETR4"; $A$1; "symbol") * @param {string} ticker - Código do ativo * @param {string} token - Token da API * @param {string} field - Campo desejado (regularMarketPrice, currency, shortName, etc) * @return {any} Valor do campo solicitado * @customfunction */ function BRAPI_DATA(ticker, token, field) { if (!ticker) return "Erro: informe ticker"; if (!field) return "Erro: informe campo"; if (token && typeof token === 'object' && token.length) { token = token[0][0]; } if (!token) { var sh = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); token = sh.getRange('A1').getDisplayValue(); } if (!token) return "Erro: token ausente"; ticker = String(ticker).toUpperCase().trim(); var url = 'https://brapi.dev/api/quote/' + encodeURIComponent(ticker) + '?token=' + encodeURIComponent(token); var options = { muteHttpExceptions: true, headers: { 'User-Agent': 'GoogleSheets-brapi/1.0' } }; var response = UrlFetchApp.fetch(url, options); if (response.getResponseCode() !== 200) { return "Erro HTTP " + response.getResponseCode(); } var json = JSON.parse(response.getContentText()); var result = (json && json.results && json.results[0]) || null; if (!result) return "Sem dados"; return result[field] || "Campo não encontrado"; } ``` 4. Salve o projeto (Ctrl + S ou clique no ícone de disquete) 5. Feche a janela do editor ### 3. Use as funções na sua planilha 1. Na célula **A1**, cole seu token da API brapi.dev #### Função em lote (recomendado) Liste os tickers na coluna A (a partir de A2) e use a fórmula em lote: ``` =BRAPI_BATCH(A2:A20; $A$1) ``` Isso busca até 20 tickers em **uma única requisição** à API, economizando sua cota. #### Função individual Para buscar um único ativo, use: ``` =BRAPI_PRICE("PETR4"; $A$1) ``` A referência `$A$1` garante que o endereço da célula do token não mude ao arrastar a fórmula. ## Exemplos de Uso ### Ações ``` =BRAPI_PRICE("PETR4"; $A$1) # Petrobras PN =BRAPI_PRICE("VALE3"; $A$1) # Vale ON =BRAPI_PRICE("ITUB4"; $A$1) # Itaú Unibanco PN =BRAPI_PRICE("BBDC4"; $A$1) # Bradesco PN ``` ### ETFs de Renda Fixa ``` =BRAPI_PRICE("IMAB11"; $A$1) # ETF IMA-B =BRAPI_PRICE("IB5M11"; $A$1) # ETF IMA-B 5+ =BRAPI_PRICE("IRFM11"; $A$1) # ETF IRF-M =BRAPI_PRICE("B5P211"; $A$1) # ETF NTN-B Principal ``` ### ETFs Internacionais ``` =BRAPI_PRICE("WRLD11"; $A$1) # ETF Global =BRAPI_PRICE("IVVB11"; $A$1) # ETF S&P 500 =BRAPI_PRICE("NASD11"; $A$1) # ETF Nasdaq ``` ### Índices ``` =BRAPI_PRICE("^BVSP"; $A$1) # Índice Ibovespa ``` ### Dados avançados por campo ``` =BRAPI_DATA("PETR4"; $A$1; "regularMarketPrice") # Preço =BRAPI_DATA("PETR4"; $A$1; "currency") # Moeda =BRAPI_DATA("PETR4"; $A$1; "shortName") # Nome curto =BRAPI_DATA("PETR4"; $A$1; "regularMarketChange") # Variação do dia =BRAPI_DATA("PETR4"; $A$1; "marketCap") # Valor de mercado ``` ## Quotas e Limites do Apps Script O Google Apps Script impõe limites próprios além dos limites da brapi.dev: | Recurso | Limite (contas gratuitas) | | -------------------------------- | ------------------------- | | `UrlFetchApp.fetch` por execução | 50 chamadas | | `UrlFetchApp.fetch` por dia | 20.000 chamadas | | Tempo de execução por função | 30 segundos | **Por isso a função `BRAPI_BATCH` é essencial**: uma planilha com 30 ativos usando `BRAPI_PRICE` faz 30 chamadas `UrlFetchApp.fetch` por atualização; com `BRAPI_BATCH`, faz apenas **1 chamada**. ### Limites da brapi.dev | Comportamento | O que acontece | | -------------- | ---------------------------------------------------------------- | | `HTTP 429` | Você excedeu o rate limit do seu plano. Aguarde ou faça upgrade. | | `HTTP 401` | Token inválido ou ausente. | | Plano gratuito | 15.000 requisições/mês | ## Autenticação: `?token=` vs Header O Google Apps Script suporta headers HTTP via `UrlFetchApp`, porém para funções personalizadas (`@customfunction`) a simplicidade do `?token=` na URL é a abordagem mais prática. Para scripts que rodam no backend (triggers, menus), você pode usar o header: ```javascript // Em triggers ou menus (NÃO em @customfunction) var options = { muteHttpExceptions: true, headers: { 'Authorization': 'Bearer ' + token, 'User-Agent': 'GoogleSheets-brapi/1.0' } }; ``` Para código backend e aplicações de produção, o método `Authorization: Bearer` é recomendado por ser mais seguro — tokens na URL podem vazar em logs e histórico. ## Dicas de Uso 1. **Use `BRAPI_BATCH`**: Sempre que possível, busque múltiplos tickers em uma requisição 2. **Atualize com moderação**: Evite recalcular a cada segundo — 2-3 atualizações por dia é suficiente para a maioria dos portfólios 3. **Monitore seu uso**: Acompanhe o consumo no [dashboard](https://brapi.dev/dashboard) 4. **Limite de tickers por requisição varia por plano** (Gratuito: 1, Startup: 10, Pro: 20). Se tiver mais ativos que o limite, divida em blocos ## Monitoramento de Uso Para uma ideia de consumo: | Cenário | Requisições/mês | | ----------------------------------- | ------------------------------ | | 30 ativos com `BRAPI_BATCH`, 3x/dia | \~90 (30 dias × 3 × 1 req) | | 30 ativos com `BRAPI_PRICE`, 3x/dia | \~2.700 (30 dias × 3 × 30 req) | | 50 ativos com `BRAPI_BATCH`, 3x/dia | \~270 (30 dias × 3 × 3 blocos) | A função em lote reduz o consumo em **\~97%** para portfólios típicos. ## Solução de Problemas ### "Erro: token ausente" Verifique se o token está na célula A1 ou se está sendo passado corretamente como parâmetro. ### "HTTP 401" Token inválido. Verifique se copiou o token completo do [painel da brapi.dev](https://brapi.dev/dashboard). ### "HTTP 429" Limite de requisições excedido. Migre para `BRAPI_BATCH` para reduzir o consumo ou considere o plano pago. ### "Sem dados retornados" Ticker inválido ou ativo não encontrado. Verifique o código do ativo. ### "Exceeded maximum execution time" A função está demorando mais de 30 segundos. Reduza o número de tickers por chamada ou verifique sua conexão. ## Próximos Passos * Veja como usar no [Microsoft Excel](/docs/examples/excel) * Explore outros [exemplos de integração](/docs/examples) * Consulte a [documentação da API](/docs) * Confira os [endpoints disponíveis](/docs/acoes) # Exemplos de Integração URL: /docs/examples.mdx Exemplos práticos de integração com a API brapi.dev em diversas linguagens de programação, plataformas e ferramentas. Inclui código de exemplo para TypeScript, Python, PHP, Java, C#, Google Sheets, Excel, WordPress e aplicações mobile. *** title: 'Exemplos de Integração' description: >- Exemplos práticos de integração com a API brapi.dev em diversas linguagens de programação, plataformas e ferramentas. Inclui código de exemplo para TypeScript, Python, PHP, Java, C#, Google Sheets, Excel, WordPress e aplicações mobile. full: false keywords: brapi, api, documentação, integração, exemplos, código, typescript, python, php, java, google sheets, excel openGraph: title: Exemplos de Integração com brapi.dev description: >- Exemplos práticos de integração com a API brapi.dev em diversas linguagens de programação, plataformas e ferramentas. Inclui código de exemplo para TypeScript, Python, PHP, Java, C#, Google Sheets, Excel, WordPress e aplicações mobile. type: website locale: pt\_BR lastUpdated: '2025-10-12T17:30:00.000Z' lang: pt-BR ----------- A API da brapi.dev é uma API REST, o que significa que ela pode ser integrada com praticamente qualquer plataforma ou linguagem de programação. Esta seção apresenta exemplos concretos de como integrar nossa API em diferentes ambientes. ## Linguagens de Programação Exemplos de integração em diferentes linguagens: * [TypeScript/JavaScript](/docs/examples/typescript) - Integração usando fetch e Axios * [Python](/docs/examples/python) - Usando a biblioteca requests * [PHP](/docs/examples/php) - Usando cURL * [Java](/docs/examples/java) - Usando HttpClient (Java 11+) * [C#](/docs/examples/csharp) - Usando HttpClient ## Planilhas e Ferramentas Sem Código Integre cotações diretamente em planilhas e ferramentas de produtividade: * [Google Sheets](/docs/examples/google-sheets) - Função personalizada com Apps Script * [Microsoft Excel](/docs/examples/excel) - Power Query para importar dados JSON * [Notion](/docs/examples/notion) - Sincronização automática com Note API Connector ## CMS e Plataformas Exemplos de integração em sistemas de gerenciamento de conteúdo: * [WordPress](/docs/examples/wordpress) - Shortcode personalizado para exibir cotações ## Aplicações Mobile Exemplos para desenvolvimento mobile: * [React Native](/docs/examples/react-native) - Componente de cotação com hooks ## Começando Todos os exemplos requerem um token de API. Para obter seu token: 1. Acesse [brapi.dev](https://brapi.dev) 2. Crie uma conta gratuita 3. Copie seu token no painel de usuário O plano gratuito oferece **15.000 requisições mensais**, suficiente para a maioria dos casos de uso. ## Suporte Para sugestões de integração com outras plataformas ou linguagens, entre em contato com nossa equipe de suporte. # Java URL: /docs/examples/java.mdx Integre a API brapi.dev em suas aplicações Java usando HttpClient. Exemplos práticos para buscar cotações de ações brasileiras. *** title: 'Java' description: >- Integre a API brapi.dev em suas aplicações Java usando HttpClient. Exemplos práticos para buscar cotações de ações brasileiras. full: false keywords: brapi, api, java, httpclient, cotações, ações brasileiras openGraph: title: Integração Java - brapi.dev description: Exemplos de integração usando Java 11+ HttpClient type: website locale: pt\_BR lastUpdated: '2025-10-12T17:30:00.000Z' lang: pt-BR howToSteps: * name: 'Crie um HttpClient' text: 'Use HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(10)).build() para criar um cliente HTTP com timeout configurado.' * name: 'Construa a requisição HTTP' text: 'Use HttpRequest.newBuilder().uri(URI.create(url)).GET().build() para criar a requisição GET para a API brapi.dev.' * name: 'Execute a requisição e obtenha a resposta' text: 'Use client.send(request, HttpResponse.BodyHandlers.ofString()) para executar e obter a resposta como String.' * name: 'Parse o JSON usando Gson' text: 'Adicione Gson como dependência e use gson.fromJson(response.body(), QuoteResponse.class) para converter a resposta em objetos Java tipados.' * name: 'Opcionalmente, integre com Spring Boot' text: 'Use RestTemplate ou WebClient do Spring com @Cacheable para cache e @Value para injetar o token de configuração.' howToTools: * 'Java 11+' * 'Maven ou Gradle' * 'Gson ou Jackson' * 'IDE Java' howToSupplies: * 'JDK 11 ou superior' * 'Conta brapi.dev' * 'Token de API brapi.dev' *** Integre a API brapi.dev em suas aplicações Java usando HttpClient (Java 11+). ## Exemplo Básico ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class BrapiExample { public static void main(String[] args) throws Exception { String token = "SEU_TOKEN"; String ticker = "PETR4"; String url = "https://brapi.dev/api/quote/" + ticker; HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .header("Authorization", "Bearer " + token) .GET() .build(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } } ``` ## Classe Cliente Completa ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; import com.google.gson.Gson; import com.google.gson.JsonObject; public class BrapiClient { private static final String BASE_URL = "https://brapi.dev/api"; private final HttpClient httpClient; private final String token; private final Gson gson; public BrapiClient(String token) { this.token = token; this.httpClient = HttpClient.newBuilder() .connectTimeout(Duration.ofSeconds(10)) .build(); this.gson = new Gson(); } public QuoteResponse getQuote(String ticker) throws Exception { String url = String.format("%s/quote/%s", BASE_URL, ticker); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .header("Authorization", "Bearer " + token) .header("User-Agent", "Java BrapiClient/1.0") .GET() .build(); HttpResponse response = httpClient.send(request, HttpResponse.BodyHandlers.ofString()); if (response.statusCode() != 200) { throw new Exception("HTTP " + response.statusCode()); } return gson.fromJson(response.body(), QuoteResponse.class); } public static class QuoteResponse { public Quote[] results; public static class Quote { public String symbol; public String shortName; public double regularMarketPrice; public double regularMarketChange; public double regularMarketChangePercent; public String currency; } } public static void main(String[] args) { try { BrapiClient client = new BrapiClient("SEU_TOKEN"); QuoteResponse response = client.getQuote("PETR4"); if (response.results != null && response.results.length > 0) { QuoteResponse.Quote quote = response.results[0]; System.out.printf("%s: R$ %.2f%n", quote.symbol, quote.regularMarketPrice); System.out.printf("Variação: %.2f%%%n", quote.regularMarketChangePercent); } } catch (Exception e) { e.printStackTrace(); } } } ``` ## Spring Boot ```java // BrapiService.java package com.example.service; import org.springframework.beans.factory.annotation.Value; import org.springframework.cache.annotation.Cacheable; import org.springframework.stereotype.Service; import org.springframework.web.client.RestTemplate; @Service public class BrapiService { @Value("${brapi.token}") private String token; private final RestTemplate restTemplate = new RestTemplate(); private static final String BASE_URL = "https://brapi.dev/api"; @Cacheable(value = "quotes", key = "#ticker") public QuoteResponse getQuote(String ticker) { String url = String.format("%s/quote/%s", BASE_URL, ticker); org.springframework.http.HttpHeaders headers = new org.springframework.http.HttpHeaders(); headers.setBearerAuth(token); org.springframework.http.HttpEntity entity = new org.springframework.http.HttpEntity<>(headers); return restTemplate.exchange(url, org.springframework.http.HttpMethod.GET, entity, QuoteResponse.class).getBody(); } } // Controller package com.example.controller; import com.example.service.BrapiService; import org.springframework.web.bind.annotation.*; @RestController @RequestMapping("/api/stock") public class StockController { private final BrapiService brapiService; public StockController(BrapiService brapiService) { this.brapiService = brapiService; } @GetMapping("/{ticker}") public QuoteResponse getStock(@PathVariable String ticker) { return brapiService.getQuote(ticker); } } // application.properties // brapi.token=SEU_TOKEN ``` ## Próximos Passos * Explore [outros exemplos](/docs/examples) * Veja a [documentação completa](/docs) # Notion URL: /docs/examples/notion.mdx Sincronize cotações da bolsa brasileira no Notion usando Note API Connector e a API brapi.dev. Importe dados automaticamente sem código. *** title: 'Notion' description: >- Sincronize cotações da bolsa brasileira no Notion usando Note API Connector e a API brapi.dev. Importe dados automaticamente sem código. full: false keywords: brapi, api, notion, note api connector, automação, cotações openGraph: title: Integração com Notion - brapi.dev description: Sincronize cotações da bolsa brasileira no Notion automaticamente type: website locale: pt\_BR lastUpdated: '2025-10-12T17:30:00.000Z' lang: pt-BR howToSteps: * name: 'Acesse o Note API Connector e conecte ao Notion' text: 'Acesse noteapiconnector.com, clique em Connect with Notion e autorize o acesso ao seu workspace do Notion.' * name: 'Configure a requisição para a brapi.dev' text: 'Crie uma nova requisição com URL: [https://brapi.dev/api/quote/PETR4?token=SEU\_TOKEN](https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN) e método GET.' * name: 'Personalize a saída e configure sincronização' text: 'Mapeie os campos da resposta JSON para colunas do Notion e configure a frequência de sincronização automática (a cada hora, 5 minutos, etc.).' * name: 'Visualize seus dados no Notion' text: 'Seus dados de cotações serão sincronizados automaticamente no Notion, prontos para criar dashboards e acompanhar investimentos.' howToTools: * 'Notion' * 'Note API Connector' * 'Navegador web' howToSupplies: * 'Conta Notion' * 'Conta brapi.dev' * 'Token de API brapi.dev' *** Importe e sincronize dados da brapi.dev diretamente no Notion sem necessidade de código. ## Note API Connector O [Note API Connector](https://noteapiconnector.com?ref=brapi) permite importar e sincronizar dados da brapi.dev diretamente no Notion. Com ele, você pode: * 📊 Importar dados de ações e cotações automaticamente * 🔄 Agendar sincronizações em intervalos personalizados (a cada hora, a cada 5 minutos, etc.) * 📈 Criar dashboards ao vivo com dados do mercado financeiro brasileiro * 📌 Manter seu workspace do Notion sempre atualizado com as últimas cotações ## Como Usar 1. Acesse o [Note API Connector](https://noteapiconnector.com?ref=brapi) e clique em **Connect with Notion** 2. Conecte sua conta do Notion e autorize o workspace 3. Configure uma requisição para a brapi.dev usando sua API token: * **URL**: `https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN` * **Método**: GET 4. Personalize a saída e configure a sincronização automática ## Configuração Avançada Para múltiplos ativos, use: ``` https://brapi.dev/api/quote/PETR4,VALE3,ITUB4?token=SEU_TOKEN ``` ## Documentação Para um guia completo de configuração, consulte a [documentação oficial do Note API Connector](https://help.noteapiconnector.com?ref=brapi). ## Próximos Passos * Veja como usar no [Google Sheets](/docs/examples/google-sheets) * Explore [outros exemplos](/docs/examples) # PHP URL: /docs/examples/php.mdx Integre a API brapi.dev em suas aplicações PHP usando cURL. Exemplos práticos para buscar cotações de ações brasileiras. *** title: 'PHP' description: >- Integre a API brapi.dev em suas aplicações PHP usando cURL. Exemplos práticos para buscar cotações de ações brasileiras. full: false keywords: brapi, api, php, curl, cotações, ações brasileiras openGraph: title: Integração PHP - brapi.dev description: Exemplos de integração usando PHP e cURL type: website locale: pt\_BR lastUpdated: '2025-10-12T17:30:00.000Z' lang: pt-BR howToSteps: * name: 'Inicialize uma requisição cURL' text: 'Use curl\_init() com a URL [https://brapi.dev/api/quote/PETR4](https://brapi.dev/api/quote/PETR4), configure CURLOPT\_RETURNTRANSFER como true e adicione o header Authorization: Bearer SEU\_TOKEN via CURLOPT\_HTTPHEADER.' * name: 'Execute a requisição e obtenha a resposta' text: 'Execute curl\_exec(), verifique o código HTTP com curl\_getinfo() e feche a conexão com curl\_close().' * name: 'Parse o JSON e acesse os dados' text: 'Use json\_decode($response, true) para converter a resposta em array PHP e acesse $data\["results"]\[0]\["regularMarketPrice"].' * name: 'Implemente tratamento de erros' text: 'Verifique curl\_error() e o código HTTP para tratar erros de conexão e respostas inválidas adequadamente.' * name: 'Opcionalmente, integre com WordPress ou Laravel' text: 'Use wp\_remote\_get() no WordPress com transients para cache, ou Http::get() no Laravel com Cache::remember().' howToTools: * 'PHP 7.4+' * 'cURL' * 'Editor de código' howToSupplies: * 'Servidor com PHP instalado' * 'Conta brapi.dev' * 'Token de API brapi.dev' *** Integre a API brapi.dev em suas aplicações PHP usando cURL ou file\_get\_contents. ## Usando cURL ```php ``` ## Com Tratamento de Erros ```php getMessage()}\n"; } ?> ``` ## Classe Cliente ```php token = $token; } public function getQuote($ticker) { $url = "{$this->baseUrl}/quote/{$ticker}"; return $this->request($url); } public function getMultipleQuotes($tickers) { $tickersParam = implode(',', $tickers); $url = "{$this->baseUrl}/quote/{$tickersParam}"; return $this->request($url); } private function request($url) { $curl = curl_init($url); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); curl_setopt($curl, CURLOPT_TIMEOUT, 10); curl_setopt($curl, CURLOPT_HTTPHEADER, [ 'User-Agent: PHP BrapiClient/1.0', "Authorization: Bearer {$this->token}" ]); $response = curl_exec($curl); $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE); $error = curl_error($curl); curl_close($curl); if ($error) { throw new Exception("Erro cURL: {$error}"); } if ($httpCode !== 200) { throw new Exception("HTTP {$httpCode}"); } return json_decode($response, true); } } // Uso $client = new BrapiClient('SEU_TOKEN'); try { $data = $client->getQuote('PETR4'); $quote = $data['results'][0]; echo "{$quote['symbol']}: R$ {$quote['regularMarketPrice']}\n"; } catch (Exception $e) { echo "Erro: {$e->getMessage()}\n"; } ?> ``` ## WordPress Integration ```php 10, 'headers' => [ 'Authorization' => "Bearer {$token}", ], ]); if (is_wp_error($response)) { return 'Erro ao buscar dados'; } $body = wp_remote_retrieve_body($response); $data = json_decode($body, true); if (isset($data['results'][0]['regularMarketPrice'])) { $price = $data['results'][0]['regularMarketPrice']; set_transient($transient_key, $price, 60); // Cache por 60 segundos return $price; } return 'Cotação indisponível'; } // Shortcode function brapi_stock_price_shortcode($atts) { $atts = shortcode_atts([ 'ticker' => 'PETR4', ], $atts); $price = brapi_get_stock_price($atts['ticker']); if (is_numeric($price)) { return 'R$ ' . number_format($price, 2, ',', '.'); } return $price; } add_shortcode('brapi_cotacao', 'brapi_stock_price_shortcode'); // Uso no WordPress: [brapi_cotacao ticker="PETR4"] ?> ``` ## Laravel ```php token = config('services.brapi.token'); } public function getQuote(string $ticker) { $cacheKey = "quote_{$ticker}"; return Cache::remember($cacheKey, 60, function () use ($ticker) { $response = Http::timeout(10) ->withToken($this->token) ->get("{$this->baseUrl}/quote/{$ticker}"); if ($response->failed()) { throw new \Exception('Failed to fetch quote'); } return $response->json(); }); } public function getMultipleQuotes(array $tickers) { $tickersParam = implode(',', $tickers); $response = Http::timeout(10) ->withToken($this->token) ->get("{$this->baseUrl}/quote/{$tickersParam}"); if ($response->failed()) { throw new \Exception('Failed to fetch quotes'); } return $response->json(); } } // config/services.php return [ 'brapi' => [ 'token' => env('BRAPI_TOKEN'), ], ]; // Controller namespace App\Http\Controllers; use App\Services\BrapiService; class StockController extends Controller { public function show($ticker, BrapiService $brapi) { $data = $brapi->getQuote($ticker); $quote = $data['results'][0] ?? null; return view('stock.show', compact('quote')); } } ?> ``` ## Próximos Passos * Explore [outros exemplos](/docs/examples) * Veja a [documentação completa](/docs) * Confira os [endpoints disponíveis](/docs/acoes) # Python URL: /docs/examples/python.mdx Integre a API brapi.dev em suas aplicações Python usando a biblioteca requests. Exemplos práticos para buscar cotações de ações brasileiras. *** title: 'Python' description: >- Integre a API brapi.dev em suas aplicações Python usando a biblioteca requests. Exemplos práticos para buscar cotações de ações brasileiras. full: false keywords: brapi, api, python, requests, cotações, ações brasileiras openGraph: title: Integração Python - brapi.dev description: Exemplos de integração usando Python e requests type: website locale: pt\_BR lastUpdated: '2025-10-12T17:30:00.000Z' lang: pt-BR howToSteps: * name: 'Escolha sua abordagem: SDK oficial ou requests' text: 'Recomendamos usar a SDK oficial (pip install brapi) para type hints e retry automático. Se preferir controle manual, use a biblioteca requests.' * name: 'Configure seu token de API' text: 'Use python-dotenv para carregar variáveis de ambiente. Crie um arquivo .env com BRAPI\_TOKEN=seu\_token\_aqui.' * name: 'Faça a requisição para a API' text: 'Com requests: response = requests.get(url, headers={"Authorization": f"Bearer {token}"}). Parse com response.json().' * name: 'Parse e use os dados retornados' text: 'O retorno contém results com lista de cotações. Acesse data\["results"]\[0]\["regularMarketPrice"] para o preço atual.' * name: 'Integre com Pandas ou Flask' text: 'Converta os dados para DataFrame com pd.DataFrame(data) para análise. Use Flask ou FastAPI para criar endpoints REST.' howToTools: * 'Python 3.7+' * 'pip' * 'Editor de código' howToSupplies: * 'Conta brapi.dev' * 'Token de API brapi.dev' * 'Ambiente Python configurado' *** Integre a API brapi.dev em suas aplicações Python usando nossa SDK oficial ou biblioteca requests. ## 🎉 SDK Oficial Disponível! A brapi.dev agora oferece uma **SDK oficial Python 3.8+** que facilita muito a integração: ```bash pip install brapi ``` **Vantagens da SDK:** * ✅ Type hints completos * ✅ Suporte síncrono e assíncrono * ✅ Tratamento de erros automático * ✅ Retry inteligente * ✅ Integração com asyncio e aiohttp **Exemplo rápido:** ```python from brapi import Brapi client = Brapi(api_key="seu_token") quote = client.quote.retrieve(tickers="PETR4") print(quote.results[0].regular_market_price) ``` 📚 **[Ver documentação completa da SDK](/docs/sdks/python)** *** ## Integração Manual (Sem SDK) Se preferir usar requests diretamente, veja os exemplos abaixo. ## Por Que Python para Análise Financeira? ```python import requests token = 'SEU_TOKEN' ticker = 'PETR4' url = f'https://brapi.dev/api/quote/{ticker}' response = requests.get(url, headers={'Authorization': f'Bearer {token}'}) data = response.json() print(data) ``` ## Com Tratamento de Erros ```python import requests from typing import Dict, Optional def get_quote(ticker: str, token: str) -> Optional[Dict]: """ Busca cotação de um ativo brasileiro Args: ticker: Código do ativo (ex: 'PETR4') token: Token da API brapi.dev Returns: Dicionário com dados da cotação ou None em caso de erro """ url = f'https://brapi.dev/api/quote/{ticker}' try: response = requests.get( url, headers={'Authorization': f'Bearer {token}'}, timeout=10, ) response.raise_for_status() return response.json() except requests.exceptions.RequestException as e: print(f'Erro ao buscar cotação: {e}') return None # Uso token = 'SEU_TOKEN' data = get_quote('PETR4', token) if data and 'results' in data: quote = data['results'][0] print(f"{quote['symbol']}: R$ {quote['regularMarketPrice']:.2f}") print(f"Variação: {quote['regularMarketChangePercent']:.2f}%") ``` ## Múltiplos Tickers ```python def get_multiple_quotes(tickers: list[str], token: str) -> Optional[Dict]: """Busca cotações de múltiplos ativos""" tickers_param = ','.join(tickers) url = f'https://brapi.dev/api/quote/{tickers_param}' try: response = requests.get( url, headers={'Authorization': f'Bearer {token}'}, timeout=10, ) response.raise_for_status() return response.json() except requests.exceptions.RequestException as e: print(f'Erro: {e}') return None # Uso tickers = ['PETR4', 'VALE3', 'ITUB4'] data = get_multiple_quotes(tickers, token) if data: for quote in data['results']: print(f"{quote['symbol']}: R$ {quote['regularMarketPrice']:.2f}") ``` ## Classe Cliente ```python import requests from typing import Dict, List, Optional from dataclasses import dataclass from datetime import datetime @dataclass class Quote: """Representa uma cotação de ativo""" symbol: str short_name: str regular_market_price: float regular_market_change: float regular_market_change_percent: float currency: str market_cap: Optional[float] = None @classmethod def from_dict(cls, data: Dict) -> 'Quote': return cls( symbol=data['symbol'], short_name=data['shortName'], regular_market_price=data['regularMarketPrice'], regular_market_change=data['regularMarketChange'], regular_market_change_percent=data['regularMarketChangePercent'], currency=data['currency'], market_cap=data.get('marketCap') ) class BrapiClient: """Cliente para a API brapi.dev""" BASE_URL = 'https://brapi.dev/api' def __init__(self, token: str): self.token = token self.session = requests.Session() self.session.headers.update({ 'Authorization': f'Bearer {token}', 'User-Agent': 'Python BrapiClient/1.0', }) def get_quote(self, ticker: str) -> Optional[Quote]: """Busca cotação de um ativo""" url = f'{self.BASE_URL}/quote/{ticker}' try: response = self.session.get(url, timeout=10) response.raise_for_status() data = response.json() if data.get('results'): return Quote.from_dict(data['results'][0]) return None except requests.exceptions.RequestException as e: print(f'Erro ao buscar {ticker}: {e}') return None def get_multiple_quotes(self, tickers: List[str]) -> List[Quote]: """Busca cotações de múltiplos ativos""" tickers_param = ','.join(tickers) url = f'{self.BASE_URL}/quote/{tickers_param}' try: response = self.session.get(url, timeout=10) response.raise_for_status() data = response.json() return [Quote.from_dict(item) for item in data.get('results', [])] except requests.exceptions.RequestException as e: print(f'Erro ao buscar cotações: {e}') return [] def __enter__(self): return self def __exit__(self, *args): self.session.close() # Uso with BrapiClient('SEU_TOKEN') as client: # Cotação única quote = client.get_quote('PETR4') if quote: print(f'{quote.symbol}: R$ {quote.regular_market_price:.2f}') print(f'Variação: {quote.regular_market_change_percent:.2f}%') # Múltiplas cotações quotes = client.get_multiple_quotes(['PETR4', 'VALE3', 'ITUB4']) for quote in quotes: print(f'{quote.symbol}: R$ {quote.regular_market_price:.2f}') ``` ## Salvando em CSV ```python import csv from datetime import datetime def save_quotes_to_csv(tickers: List[str], token: str, filename: str): """Salva cotações em arquivo CSV""" with BrapiClient(token) as client: quotes = client.get_multiple_quotes(tickers) if not quotes: print('Nenhuma cotação obtida') return with open(filename, 'w', newline='', encoding='utf-8') as csvfile: fieldnames = [ 'timestamp', 'symbol', 'short_name', 'price', 'change', 'change_percent', 'currency' ] writer = csv.DictWriter(csvfile, fieldnames=fieldnames) writer.writeheader() timestamp = datetime.now().isoformat() for quote in quotes: writer.writerow({ 'timestamp': timestamp, 'symbol': quote.symbol, 'short_name': quote.short_name, 'price': quote.regular_market_price, 'change': quote.regular_market_change, 'change_percent': quote.regular_market_change_percent, 'currency': quote.currency }) print(f'Cotações salvas em {filename}') # Uso tickers = ['PETR4', 'VALE3', 'ITUB4', 'BBDC4'] save_quotes_to_csv(tickers, 'SEU_TOKEN', 'quotes.csv') ``` ## Com Pandas ```python import pandas as pd def get_quotes_dataframe(tickers: List[str], token: str) -> pd.DataFrame: """Retorna cotações como DataFrame do pandas""" with BrapiClient(token) as client: quotes = client.get_multiple_quotes(tickers) if not quotes: return pd.DataFrame() data = [{ 'symbol': q.symbol, 'name': q.short_name, 'price': q.regular_market_price, 'change': q.regular_market_change, 'change_percent': q.regular_market_change_percent, 'currency': q.currency, 'market_cap': q.market_cap } for q in quotes] return pd.DataFrame(data) # Uso df = get_quotes_dataframe(['PETR4', 'VALE3', 'ITUB4'], 'SEU_TOKEN') print(df) # Salvar em Excel df.to_excel('quotes.xlsx', index=False) ``` ## Aplicação Flask ```python from flask import Flask, jsonify import os app = Flask(__name__) BRAPI_TOKEN = os.environ.get('BRAPI_TOKEN') @app.route('/api/quote/') def get_quote_api(ticker): """Endpoint para buscar cotação""" with BrapiClient(BRAPI_TOKEN) as client: quote = client.get_quote(ticker) if not quote: return jsonify({'error': 'Quote not found'}), 404 return jsonify({ 'symbol': quote.symbol, 'name': quote.short_name, 'price': quote.regular_market_price, 'change_percent': quote.regular_market_change_percent }) if __name__ == '__main__': app.run(debug=True) ``` ## Boas Práticas 1. **Use variáveis de ambiente** para o token 2. **Implemente timeout** nas requisições 3. **Trate erros** adequadamente 4. **Use sessões** para melhor performance 5. **Feche conexões** quando não precisar mais ## Variáveis de Ambiente ```python import os from dotenv import load_dotenv load_dotenv() # Carrega .env token = os.environ.get('BRAPI_TOKEN') if not token: raise ValueError('BRAPI_TOKEN não configurado') ``` Arquivo `.env`: ``` BRAPI_TOKEN=seu_token_aqui ``` ## Próximos Passos * Explore [outros exemplos](/docs/examples) * Veja a [documentação completa](/docs) * Confira os [endpoints disponíveis](/docs/acoes) # React Native URL: /docs/examples/react-native.mdx Integre a API brapi.dev em aplicações React Native. Componentes para exibir cotações de ações brasileiras em apps mobile. *** title: 'React Native' description: >- Integre a API brapi.dev em aplicações React Native. Componentes para exibir cotações de ações brasileiras em apps mobile. full: false keywords: brapi, api, react native, mobile, cotações, hooks openGraph: title: Integração React Native - brapi.dev description: Componentes React Native para cotações da bolsa brasileira type: website locale: pt\_BR lastUpdated: '2025-10-12T17:30:00.000Z' lang: pt-BR howToSteps: * name: 'Crie um componente de cotação' text: 'Crie um componente StockPrice que recebe ticker como prop e usa useState para gerenciar preço, loading e erro.' * name: 'Implemente useEffect para buscar dados' text: 'Use useEffect com fetch para chamar [https://brapi.dev/api/quote/\{ticker}](https://brapi.dev/api/quote/\{ticker}) com header Authorization: Bearer SEU\_TOKEN e atualizar o estado com os dados retornados.' * name: 'Adicione tratamento de loading e erro' text: 'Renderize ActivityIndicator durante loading e mensagem de erro quando houver falha na requisição.' * name: 'Estilize o componente com StyleSheet' text: 'Use StyleSheet.create para definir estilos do card, incluindo cores para variação positiva (verde) e negativa (vermelho).' * name: 'Opcionalmente, crie um custom hook useBrapiQuote' text: 'Extraia a lógica de fetch para um hook reutilizável que retorna { data, loading, error } para uso em múltiplos componentes.' howToTools: * 'React Native' * 'Expo ou React Native CLI' * 'Editor de código' howToSupplies: * 'Projeto React Native configurado' * 'Conta brapi.dev' * 'Token de API brapi.dev' *** Integre a API brapi.dev em suas aplicações React Native. ## Componente Básico ```javascript import React, { useState, useEffect } from 'react'; import { View, Text, StyleSheet, ActivityIndicator } from 'react-native'; const StockPrice = ({ ticker }) => { const [price, setPrice] = useState(null); const [loading, setLoading] = useState(true); const [error, setError] = useState(null); useEffect(() => { const token = 'SEU_TOKEN'; const fetchPrice = async () => { try { const response = await fetch( `https://brapi.dev/api/quote/${ticker}`, { headers: { 'Authorization': `Bearer ${token}` } } ); if (!response.ok) { throw new Error('Erro ao buscar cotação'); } const data = await response.json(); setPrice(data.results[0]); } catch (error) { setError(error.message); } finally { setLoading(false); } }; fetchPrice(); }, [ticker]); if (loading) { return ( ); } if (error) { return ( {error} ); } if (!price) return null; const isPositive = price.regularMarketChangePercent > 0; return ( {price.symbol} {price.shortName} R$ {price.regularMarketPrice.toFixed(2)} {isPositive ? '+' : ''}{price.regularMarketChangePercent.toFixed(2)}% ); }; const styles = StyleSheet.create({ container: { padding: 16, backgroundColor: '#ffffff', borderRadius: 12, marginBottom: 12, shadowColor: '#000', shadowOffset: { width: 0, height: 2 }, shadowOpacity: 0.1, shadowRadius: 4, elevation: 3, }, ticker: { fontSize: 18, fontWeight: 'bold', color: '#333', }, name: { fontSize: 14, color: '#666', marginTop: 4, }, price: { fontSize: 24, fontWeight: 'bold', color: '#000', marginTop: 8, }, change: { fontSize: 16, fontWeight: '600', marginTop: 4, }, positive: { color: '#10b981', }, negative: { color: '#ef4444', }, error: { color: '#ef4444', fontSize: 14, }, }); export default StockPrice; ``` ## Com Custom Hook ```javascript import { useState, useEffect } from 'react'; const useBrapiQuote = (ticker, token) => { const [data, setData] = useState(null); const [loading, setLoading] = useState(true); const [error, setError] = useState(null); useEffect(() => { let isMounted = true; const fetchQuote = async () => { try { const response = await fetch( `https://brapi.dev/api/quote/${ticker}`, { headers: { 'Authorization': `Bearer ${token}` } } ); if (!response.ok) { throw new Error(`HTTP ${response.status}`); } const json = await response.json(); if (isMounted) { setData(json.results[0]); setError(null); } } catch (err) { if (isMounted) { setError(err.message); setData(null); } } finally { if (isMounted) { setLoading(false); } } }; fetchQuote(); return () => { isMounted = false; }; }, [ticker, token]); return { data, loading, error }; }; // Uso const StockCard = ({ ticker }) => { const { data, loading, error } = useBrapiQuote(ticker, 'SEU_TOKEN'); if (loading) return ; if (error) return Erro: {error}; if (!data) return null; return ( {data.symbol}: R$ {data.regularMarketPrice.toFixed(2)} ); }; ``` ## Lista de Cotações ```javascript import React from 'react'; import { FlatList, View } from 'react-native'; const StockList = () => { const tickers = ['PETR4', 'VALE3', 'ITUB4', 'BBDC4', 'MGLU3']; return ( item} renderItem={({ item }) => } contentContainerStyle={{ padding: 16 }} /> ); }; ``` ## Próximos Passos * Veja exemplos em [TypeScript](/docs/examples/typescript) * Explore [outros exemplos](/docs/examples) # TypeScript / JavaScript URL: /docs/examples/typescript.mdx Exemplos de integração da API brapi.dev usando TypeScript e JavaScript com fetch nativo e Axios. Aprenda a buscar cotações de ações brasileiras em aplicações web e Node.js. *** title: 'TypeScript / JavaScript' description: >- Exemplos de integração da API brapi.dev usando TypeScript e JavaScript com fetch nativo e Axios. Aprenda a buscar cotações de ações brasileiras em aplicações web e Node.js. full: false keywords: brapi, api, typescript, javascript, fetch, axios, node.js, web openGraph: title: Integração TypeScript/JavaScript - brapi.dev description: >- Exemplos práticos de integração com fetch e Axios para buscar cotações da bolsa brasileira type: website locale: pt\_BR lastUpdated: '2025-10-12T17:30:00.000Z' lang: pt-BR howToSteps: * name: 'Escolha sua abordagem: SDK oficial ou fetch/Axios' text: 'Recomendamos usar a SDK oficial (npm install brapi) para tipos completos e retry automático. Se preferir controle manual, use fetch nativo ou Axios.' * name: 'Configure seu token de API' text: 'Armazene seu token em variáveis de ambiente (process.env.BRAPI\_TOKEN). Nunca exponha o token no código frontend.' * name: 'Faça a requisição para a API' text: 'Com fetch: await fetch(url, { headers: { Authorization: `Bearer ${token}` } }). Com Axios: await axios.get(url, { headers: { Authorization: `Bearer ${token}` } }).' * name: 'Parse e use os dados retornados' text: 'O retorno contém results com array de cotações. Acesse data.results\[0].regularMarketPrice para o preço atual.' * name: 'Implemente cache e tratamento de erros' text: 'Use try/catch para erros de rede. Implemente cache (ex: Next.js revalidate, SWR, Map) para economizar requisições.' howToTools: * 'Node.js ou navegador moderno' * 'npm, yarn ou bun' * 'Editor de código' howToSupplies: * 'Conta brapi.dev' * 'Token de API brapi.dev' * 'Projeto JavaScript/TypeScript' *** Integre a API brapi.dev em suas aplicações TypeScript e JavaScript usando nossa SDK oficial ou fetch/Axios. ## 🎉 SDK Oficial Disponível! A brapi.dev agora oferece uma **SDK oficial TypeScript/JavaScript** que facilita muito a integração: ```bash npm install brapi ``` **Vantagens da SDK:** * ✅ Tipos TypeScript completos com IntelliSense * ✅ Tratamento de erros automático * ✅ Retry inteligente em falhas * ✅ Suporte a Node.js e navegador **Exemplo rápido:** ```typescript const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, }); const quote = await client.quote.retrieve('PETR4'); console.log(quote.results[0].regularMarketPrice); ``` 📚 **[Ver documentação completa da SDK](/docs/sdks/typescript)** *** ## Integração Manual (Sem SDK) Se preferir fazer requisições HTTP diretamente, veja os exemplos abaixo. ## Usando Fetch (Nativo) O fetch é nativo em navegadores modernos e Node.js 18+, sem necessidade de bibliotecas externas. ### Exemplo Básico ```typescript const fetchQuote = async () => { const token = 'SEU_TOKEN'; const ticker = 'PETR4'; const response = await fetch( `https://brapi.dev/api/quote/${ticker}`, { headers: { 'Authorization': `Bearer ${token}` } } ); const data = await response.json(); console.log(data); }; fetchQuote(); ``` ### Com Tratamento de Erros ```typescript interface QuoteResult { results: Array<{ symbol: string; shortName: string; regularMarketPrice: number; regularMarketChange: number; regularMarketChangePercent: number; currency: string; }>; } const fetchQuote = async (ticker: string): Promise => { const token = process.env.BRAPI_TOKEN || 'SEU_TOKEN'; try { const response = await fetch( `https://brapi.dev/api/quote/${ticker}`, { headers: { 'Authorization': `Bearer ${token}` } } ); if (!response.ok) { throw new Error(`HTTP error! status: ${response.status}`); } const data: QuoteResult = await response.json(); return data; } catch (error) { console.error('Erro ao buscar cotação:', error); return null; } }; // Uso fetchQuote('PETR4').then(data => { if (data && data.results[0]) { const quote = data.results[0]; console.log(`${quote.symbol}: R$ ${quote.regularMarketPrice}`); } }); ``` ### Múltiplos Tickers ```typescript const fetchMultipleQuotes = async (tickers: string[]) => { const token = 'SEU_TOKEN'; const tickersParam = tickers.join(','); const response = await fetch( `https://brapi.dev/api/quote/${tickersParam}`, { headers: { 'Authorization': `Bearer ${token}` } } ); const data = await response.json(); return data.results; }; // Uso fetchMultipleQuotes(['PETR4', 'VALE3', 'ITUB4']).then(quotes => { quotes.forEach(quote => { console.log(`${quote.symbol}: R$ ${quote.regularMarketPrice}`); }); }); ``` ## Usando Axios Axios é uma biblioteca popular para fazer requisições HTTP, com sintaxe mais simples e recursos adicionais. ### Instalação ```bash npm install axios # ou yarn add axios # ou bun add axios ``` ### Exemplo Básico ```typescript const token = 'SEU_TOKEN'; const ticker = 'PETR4'; const url = `https://brapi.dev/api/quote/${ticker}`; async function fetchQuote() { try { const response = await axios.get(url, { headers: { 'Authorization': `Bearer ${token}` }, }); console.log(response.data); } catch (error) { console.error('Erro ao buscar cotação:', error); } } fetchQuote(); ``` ### Com TypeScript e Interface ```typescript interface BrapiQuoteResponse { results: Array<{ symbol: string; shortName: string; longName: string; currency: string; regularMarketPrice: number; regularMarketDayHigh: number; regularMarketDayLow: number; regularMarketVolume: number; regularMarketChange: number; regularMarketChangePercent: number; regularMarketTime: string; marketCap: number; fiftyTwoWeekLow: number; fiftyTwoWeekHigh: number; }>; requestedAt: string; took: string; } class BrapiClient { private baseUrl = 'https://brapi.dev/api'; private token: string; constructor(token: string) { this.token = token; } async getQuote(ticker: string): Promise { try { const response = await axios.get( `${this.baseUrl}/quote/${ticker}`, { headers: { 'Authorization': `Bearer ${this.token}` }, } ); return response.data; } catch (error) { if (axios.isAxiosError(error)) { const axiosError = error as AxiosError; throw new Error( `Erro na API: ${axiosError.response?.status} - ${axiosError.message}` ); } throw error; } } async getMultipleQuotes(tickers: string[]): Promise { const tickersParam = tickers.join(','); return this.getQuote(tickersParam); } } // Uso const client = new BrapiClient(process.env.BRAPI_TOKEN!); client.getQuote('PETR4').then(data => { const quote = data.results[0]; console.log(`${quote.symbol}: R$ ${quote.regularMarketPrice}`); console.log(`Variação: ${quote.regularMarketChangePercent.toFixed(2)}%`); }); ``` ## Exemplo Next.js (App Router) ### Server Component ```typescript // app/stock/[ticker]/page.tsx interface QuoteData { results: Array<{ symbol: string; shortName: string; regularMarketPrice: number; regularMarketChangePercent: number; }>; } async function getQuote(ticker: string): Promise { const token = process.env.BRAPI_TOKEN; const res = await fetch( `https://brapi.dev/api/quote/${ticker}`, { headers: { 'Authorization': `Bearer ${token}` }, next: { revalidate: 60 }, } ); if (!res.ok) { throw new Error('Failed to fetch quote'); } return res.json(); } export default async function StockPage({ params, }: { params: { ticker: string }; }) { const data = await getQuote(params.ticker); const quote = data.results[0]; return ( ); } ``` ### Client Component com SWR ```typescript 'use client'; const fetcher = (url: string) => fetch(url).then(r => r.json()); export function StockQuote({ ticker }: { ticker: string }) { const { data, error, isLoading } = useSWR( `/api/quote/${ticker}`, fetcher, { refreshInterval: 60000 } // Atualiza a cada 60 segundos ); if (error) return ; if (isLoading) return ; const quote = data.results[0]; return ( ); } ``` ### API Route ```typescript // app/api/quote/[ticker]/route.ts export async function GET( request: Request, { params }: { params: { ticker: string } } ) { const token = process.env.BRAPI_TOKEN; try { const response = await fetch( `https://brapi.dev/api/quote/${params.ticker}`, { headers: { 'Authorization': `Bearer ${token}` } } ); if (!response.ok) { return NextResponse.json( { error: 'Failed to fetch quote' }, { status: response.status } ); } const data = await response.json(); return NextResponse.json(data); } catch (error) { return NextResponse.json( { error: 'Internal server error' }, { status: 500 } ); } } ``` ## Node.js com Cache ```typescript class BrapiService { private cache = new Map(); private cacheDuration = 60000; // 60 segundos constructor(private token: string) {} async getQuote(ticker: string) { const cached = this.cache.get(ticker); const now = Date.now(); if (cached && now - cached.timestamp < this.cacheDuration) { return cached.data; } const response = await axios.get( `https://brapi.dev/api/quote/${ticker}`, { headers: { 'Authorization': `Bearer ${this.token}` } } ); this.cache.set(ticker, { data: response.data, timestamp: now }); return response.data; } } // Uso const service = new BrapiService(process.env.BRAPI_TOKEN!); const data = await service.getQuote('PETR4'); ``` ## Boas Práticas 1. **Armazene o token em variáveis de ambiente**: Nunca exponha o token no código 2. **Implemente cache**: Evite requisições desnecessárias 3. **Trate erros adequadamente**: Sempre use try/catch ou .catch() 4. **Use tipos TypeScript**: Aproveite a tipagem para melhor DX 5. **Respeite os limites**: Monitore o uso de requisições ## Próximos Passos * Veja exemplos em [outras linguagens](/docs/examples) * Explore a [documentação completa da API](/docs) * Confira os [endpoints disponíveis](/docs/acoes) # WordPress URL: /docs/examples/wordpress.mdx Integre cotações da bolsa brasileira no WordPress usando shortcodes e a API brapi.dev. Exiba preços de ações em posts e páginas. *** title: 'WordPress' description: >- Integre cotações da bolsa brasileira no WordPress usando shortcodes e a API brapi.dev. Exiba preços de ações em posts e páginas. full: false keywords: brapi, api, wordpress, shortcode, php, cotações openGraph: title: Integração WordPress - brapi.dev description: Exiba cotações da bolsa brasileira no WordPress com shortcodes type: website locale: pt\_BR lastUpdated: '2025-10-12T17:30:00.000Z' lang: pt-BR howToSteps: * name: 'Adicione o código ao functions.php' text: 'Acesse o arquivo functions.php do seu tema WordPress (ou crie um plugin personalizado) e cole o código da função brapi\_get\_stock\_price e brapi\_stock\_price\_shortcode fornecidos.' * name: 'Configure seu token da API' text: 'Substitua SEU\_TOKEN no código pelo token que você obteve em brapi.dev. Você pode também armazenar o token usando get\_option para maior segurança.' * name: 'Use o shortcode em posts e páginas' text: 'Em qualquer post ou página, insira o shortcode \[brapi\_cotacao ticker="PETR4"] para exibir a cotação do ativo desejado.' * name: 'Opcionalmente, crie um bloco Gutenberg' text: 'Para uma experiência mais integrada, registre um bloco customizado usando register\_block\_type para permitir inserir cotações diretamente no editor de blocos.' howToTools: * 'WordPress' * 'Editor de código ou FTP' * 'Navegador web' howToSupplies: * 'Conta brapi.dev' * 'Token de API brapi.dev' * 'Tema WordPress com functions.php' *** Integre cotações da bolsa brasileira no WordPress usando shortcodes personalizados. ## Implementação Adicione este código ao arquivo `functions.php` do seu tema ou em um plugin personalizado: ```php 10, 'headers' => ['Authorization' => "Bearer {$token}"], ]); if (is_wp_error($response)) { return 'Erro ao buscar dados'; } $body = wp_remote_retrieve_body($response); $data = json_decode($body, true); if (isset($data['results'][0]['regularMarketPrice'])) { $price = $data['results'][0]['regularMarketPrice']; set_transient($transient_key, $price, 60); return $price; } return 'Cotação indisponível'; } function brapi_stock_price_shortcode($atts) { $atts = shortcode_atts([ 'ticker' => 'PETR4', ], $atts); $price = brapi_get_stock_price($atts['ticker']); if (is_numeric($price)) { return 'R$ ' . number_format($price, 2, ',', '.'); } return $price; } add_shortcode('brapi_cotacao', 'brapi_stock_price_shortcode'); ?> ``` ## Uso no WordPress Use o shortcode em posts e páginas: ``` [brapi_cotacao ticker="PETR4"] ``` Exemplos: ``` [brapi_cotacao ticker="VALE3"] [brapi_cotacao ticker="ITUB4"] [brapi_cotacao ticker="IMAB11"] ``` ## Com Widget Gutenberg Para criar um bloco customizado: ```php 'brapi-block', 'render_callback' => 'brapi_render_block' ]); } add_action('init', 'brapi_register_block'); function brapi_render_block($attributes) { $ticker = $attributes['ticker'] ?? 'PETR4'; return brapi_stock_price_shortcode(['ticker' => $ticker]); } ?> ``` ## Próximos Passos * Veja exemplos em [PHP](/docs/examples/php) * Explore [outros exemplos](/docs/examples) # Histórico da Carteira de FIIs URL: /docs/fiis/carteira-historico.mdx Acompanhe a evolução trimestral da composição normalizada da carteira dos FIIs. *** title: Histórico da Carteira de FIIs description: >- Acompanhe a evolução trimestral da composição normalizada da carteira dos FIIs. full: true keywords: brapi, api, fii, carteira, portfolio, histórico, trimestral, composição openGraph: title: Histórico da Carteira de FIIs description: Série trimestral compacta de composição de carteira dos FIIs. type: website locale: pt\_BR lastUpdated: '2026-05-30T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/fii/portfolio/history structuredData: headings: \[] contents: * content: >- Retorna a série trimestral de resumos de composição de carteira dos FIIs. *** import { Callout } from 'fumadocs-ui/components/callout'; Use este endpoint para acompanhar a evolução da carteira dos FIIs por trimestre. A resposta é compacta: cada item em `history[]` traz `summary` e `allocations`, sem as listas detalhadas de CRIs, cotas, imóveis, terrenos e direitos. Para abrir os itens de um trimestre específico, use [`/api/v2/fii/portfolio`](/docs/fiis/carteira) com `referenceDate`. Sandbox sem token: `symbols=HGLG11` e `symbols=MXRF11`. Para todos os FIIs, use um token Pro. ## Quando usar * **Composição ao longo do tempo:** use `history[].allocations`. * **Valor declarado:** use `history[].summary.declaredValue`. * **FIIs de papel e FoFs:** acompanhe `financialAssets.declaredValue`. * **Retificações:** use `allVersions=true` para ver versões anteriores do informe. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/portfolio/history Single endpoint documentation for /api/v2/fii/portfolio/history ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/fii/portfolio/history **Summary:** Histórico da Carteira Retorna a série trimestral compacta da composição da carteira dos FIIs. Use este endpoint para acompanhar evolução de alocação, valor declarado, quantidade de ativos, imóveis e exposição por classe ao longo do tempo. ### Funcionalidades: * **Série trimestral:** Um ponto por FII, trimestre e versão do informe. * **Resumo de carteira:** Retorna `summary` e `allocations`, sem listas detalhadas de ativos. * **Múltiplos FIIs:** Consulte até 20 FIIs em uma única requisição. * **Filtro por período:** Use `startDate=YYYY-MM-DD` e `endDate=YYYY-MM-DD`. O padrão são os últimos 12 meses. * **Versionamento:** Por padrão retorna a versão mais recente de cada trimestre. Use `allVersions=true` para incluir retificações. ### Exemplos de Requisição: ```bash curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/portfolio/history?symbols=HGLG11" curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/portfolio/history?symbols=HGLG11,MXRF11&startDate=2024-01-01&endDate=2026-03-31" ``` ### Fonte dos Dados: CVM (Informe Trimestral FII) **Plano Mínimo:** Pro **Autenticação:** Necessária (exceto MXRF11 e HGLG11) **Tags:** Fundos Imobiliários ### Parameters - **symbols** (query) *required* - **startDate** (query) - **endDate** (query) - **sortBy** (query) - **sortOrder** (query) - **allVersions** (query) ### Responses #### 200 Histórico trimestral da carteira retornado com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FiiPortfolioAllocation **Properties:** - **assetClass** (string) *(required)* - **count** (number) *(required)* - **value** (number) *(nullable)* *(required)* ### FiiPortfolioHistoryEntry **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **referenceDate** (string) *(required)* - **version** (number) *(required)* - **summary** *(required)* Reference to: **FiiPortfolioSummary** - **allocations** (array) *(required)* Array items: Reference to: **FiiPortfolioAllocation** ### FiiPortfolioHistoryResponse **Properties:** - **history** (array) *(required)* Array items: Reference to: **FiiPortfolioHistoryEntry** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### FiiPortfolioSummary **Properties:** - **totalItems** (number) *(required)* - **declaredValue** (number) *(nullable)* *(required)* - **properties** *(required)* Reference to: **FiiPropertySummary** - **financialAssets** (object) *(required)* **Properties:** - **count** (number) *(required)* - **declaredValue** (number) *(nullable)* *(required)* - **lands** (object) *(required)* **Properties:** - **count** (number) *(required)* - **totalArea** (number) *(nullable)* *(required)* - **rights** (object) *(required)* **Properties:** - **count** (number) *(required)* - **declaredValue** (number) *(nullable)* *(required)* ### FiiPropertySummary **Properties:** - **count** (number) *(required)* - **totalArea** (number) *(nullable)* *(required)* - **vacancyRate** (number) *(nullable)* *(required)* - **averageVacancyRate** (number) *(nullable)* *(required)* - **propertiesWithVacancy** (number) *(required)* # Carteira de FIIs URL: /docs/fiis/carteira.mdx Consulte a composição normalizada da carteira dos FIIs: CRIs, cotas de outros FIIs, imóveis, direitos e terrenos. *** title: Carteira de FIIs description: >- Consulte a composição normalizada da carteira dos FIIs: CRIs, cotas de outros FIIs, imóveis, direitos e terrenos. full: true keywords: brapi, api, fii, carteira, portfolio, fof, cri, cotas de fii, cvm openGraph: title: Carteira de FIIs description: Carteira normalizada de FIIs para FoFs, FIIs de papel e análise de composição. type: website locale: pt\_BR lastUpdated: '2026-05-30T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/fii/portfolio structuredData: headings: \[] contents: * content: >- Retorna a composição normalizada da carteira de FIIs agrupada por fundo. *** import { Callout } from 'fumadocs-ui/components/callout'; Use este endpoint para responder “o que este FII possui?”. A resposta vem agrupada por FII, com `summary`, `allocations`, `financialAssets`, `fundHoldings`, `properties`, `lands` e `rights`. Para imóveis físicos e vacância, prefira [`/api/v2/fii/properties`](/docs/fiis/imoveis). Este endpoint é melhor para FoFs, FIIs de papel, CRIs e composição geral. Sandbox sem token: `symbols=HGLG11` e `symbols=MXRF11`. Para todos os FIIs, use um token Pro. ## Quando usar * **FoFs:** use `fundHoldings` para ver cotas de outros FIIs. * **FIIs de papel:** use `financialAssets` para CRIs, emissores e valores. * **Carteiras híbridas:** use `allocations` para entender a composição. * **Auditoria:** use `referenceDate` para travar um trimestre específico. * **Evolução trimestral:** use [`/api/v2/fii/portfolio/history`](/docs/fiis/carteira-historico). ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/portfolio Single endpoint documentation for /api/v2/fii/portfolio ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/fii/portfolio **Summary:** Obter Composição da Carteira Retorna a composição normalizada da carteira dos FIIs a partir dos informes trimestrais da CVM. Use para entender o que um FII possui: CRIs, cotas de outros FIIs, imóveis, direitos e terrenos. ### Funcionalidades: * **Resposta agrupada por FII:** Cada fundo vem com resumo, alocações e listas por tipo de ativo. * **Múltiplos FIIs:** Consulte até 20 FIIs em uma única requisição. * **Filtro por trimestre:** Use `referenceDate=YYYY-MM-DD`. Sem esse parâmetro, retorna o trimestre mais recente disponível por FII. * **Versionamento:** Informes podem ter retificações. Por padrão, retorna apenas a versão mais recente do trimestre retornado. Use `allVersions=true` para todas as versões do trimestre consultado. * **Payload sob controle:** `summary` sempre vem. Use `include=allocations`, `include=financialAssets`, `include=fundHoldings`, `include=properties`, `include=lands` ou `include=rights` para escolher listas. ### Campos da Resposta: * **summary** — Totais por FII, valor declarado e vacância consolidada dos imóveis. * **allocations** — Contagem e valor por classe de ativo. * **financialAssets** — CRIs, cotas, SPEs e outros ativos financeiros. * **fundHoldings** — Cotas de outros FIIs, útil para FoFs. * **properties** — Imóveis físicos com área, endereço, vacância e participação na receita. ### Autenticação: Os FIIs **MXRF11** e **HGLG11** podem ser consultados sem autenticação para testes. Para acessar outros FIIs, é necessário um token de API válido. ### Exemplos de Requisição: ```bash # Carteira mais recente do HGLG11 curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/portfolio?symbols=HGLG11" # Carteira em um trimestre específico curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/portfolio?symbols=HGLG11&referenceDate=2025-03-31" # Apenas resumo e alocações curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/portfolio?symbols=HGLG11&include=allocations" ``` ### Fonte dos Dados: CVM (Informe Trimestral FII) **Plano Mínimo:** Pro **Autenticação:** Necessária (exceto MXRF11 e HGLG11) **Tags:** Fundos Imobiliários ### Parameters - **symbols** (query) *required* - **referenceDate** (query) - **include** (query) - **allVersions** (query) ### Responses #### 200 Carteira detalhada dos FIIs retornada com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FiiFinancialAsset **Properties:** - **assetClass** (string) *(required)* - **name** (string) *(required)* - **issuer** (string) *(nullable)* *(required)* - **issuerCnpj** (string) *(nullable)* *(required)* - **identifier** (string) *(nullable)* *(required)* - **quantity** (number) *(nullable)* *(required)* - **value** (number) *(nullable)* *(required)* - **issue** (string) *(nullable)* *(required)* - **series** (string) *(nullable)* *(required)* - **ticker** (string) *(nullable)* *(required)* - **maturityDate** (string) *(nullable)* *(required)* - **confidential** (boolean) *(required)* ### FiiLand **Properties:** - **name** (string) *(required)* - **identifier** (string) *(nullable)* *(required)* - **address** (string) *(nullable)* *(required)* - **area** (number) *(nullable)* *(required)* - **investedShare** (number) *(nullable)* *(required)* - **equityShare** (number) *(nullable)* *(required)* - **confidential** (boolean) *(required)* ### FiiPortfolio **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **referenceDate** (string) *(required)* - **version** (number) *(required)* - **summary** *(required)* Reference to: **FiiPortfolioSummary** - **allocations** (array) *(required)* Array items: Reference to: **FiiPortfolioAllocation** - **properties** (array) *(required)* Array items: Reference to: **FiiProperty** - **financialAssets** (array) *(required)* Array items: Reference to: **FiiFinancialAsset** - **fundHoldings** (array) *(required)* Array items: Reference to: **FiiFinancialAsset** - **lands** (array) *(required)* Array items: Reference to: **FiiLand** - **rights** (array) *(required)* Array items: Reference to: **FiiRight** ### FiiPortfolioAllocation **Properties:** - **assetClass** (string) *(required)* - **count** (number) *(required)* - **value** (number) *(nullable)* *(required)* ### FiiPortfolioResponse **Properties:** - **fiis** (array) *(required)* Array items: Reference to: **FiiPortfolio** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### FiiPortfolioSummary **Properties:** - **totalItems** (number) *(required)* - **declaredValue** (number) *(nullable)* *(required)* - **properties** *(required)* Reference to: **FiiPropertySummary** - **financialAssets** (object) *(required)* **Properties:** - **count** (number) *(required)* - **declaredValue** (number) *(nullable)* *(required)* - **lands** (object) *(required)* **Properties:** - **count** (number) *(required)* - **totalArea** (number) *(nullable)* *(required)* - **rights** (object) *(required)* **Properties:** - **count** (number) *(required)* - **declaredValue** (number) *(nullable)* *(required)* ### FiiProperty **Properties:** - **name** (string) *(required)* - **identifier** (string) *(nullable)* *(required)* - **address** (string) *(nullable)* *(required)* - **propertyClass** (string) *(nullable)* *(required)* - **area** (number) *(nullable)* *(required)* - **unitCount** (number) *(nullable)* *(required)* - **vacancyRate** (number) *(nullable)* *(required)* - **delinquencyRate** (number) *(nullable)* *(required)* - **revenueShare** (number) *(nullable)* *(required)* - **leasedRate** (number) *(nullable)* *(required)* - **soldRate** (number) *(nullable)* *(required)* - **constructionProgressActual** (number) *(nullable)* *(required)* - **constructionProgressExpected** (number) *(nullable)* *(required)* - **constructionCostActual** (number) *(nullable)* *(required)* - **constructionCostExpected** (number) *(nullable)* *(required)* - **investedShare** (number) *(nullable)* *(required)* - **confidential** (boolean) *(required)* ### FiiPropertySummary **Properties:** - **count** (number) *(required)* - **totalArea** (number) *(nullable)* *(required)* - **vacancyRate** (number) *(nullable)* *(required)* - **averageVacancyRate** (number) *(nullable)* *(required)* - **propertiesWithVacancy** (number) *(required)* ### FiiRight **Properties:** - **name** (string) *(required)* - **identifier** (string) *(nullable)* *(required)* - **value** (number) *(nullable)* *(required)* - **description** (string) *(nullable)* *(required)* - **confidential** (boolean) *(required)* # Dividendos de FIIs URL: /docs/fiis/dividendos.mdx Consulte o histórico de dividendos e rendimentos de Fundos Imobiliários, com filtros de data e ordenação. *** title: Dividendos de FIIs description: >- Consulte o histórico de dividendos e rendimentos de Fundos Imobiliários, com filtros de data e ordenação. full: true keywords: brapi, api, fii, dividendos, rendimentos, amortização openGraph: title: Dividendos de FIIs description: >- Histórico de dividendos e rendimentos de Fundos Imobiliários. type: website locale: pt\_BR lastUpdated: '2026-04-25T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/fii/dividends structuredData: headings: \[] contents: * content: >- Retorna o histórico de dividendos e rendimentos de FIIs, incluindo rendimentos mensais e amortizações, com filtros de data. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna o histórico de dividendos (rendimentos e amortizações) de um ou mais FIIs. Use `startDate` e `endDate` para delimitar o período e `sortOrder` para controlar a direção. Aceita até **20 símbolos** separados por vírgula. **Plano mínimo: Pro.** No sandbox sem token, aceita apenas `symbols=MXRF11` e/ou `HGLG11`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/dividends Single endpoint documentation for /api/v2/fii/dividends ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/fii/dividends **Summary:** Obter Histórico de Proventos Retorna o histórico de pagamentos de proventos (Rendimentos, Amortizações) dos FIIs. Analise a rentabilidade histórica e padrões de distribuição de cada fundo. ### Funcionalidades: * **Histórico completo:** Rendimentos e amortizações desde a criação do fundo * **Múltiplos FIIs:** Consulte até 20 FIIs em uma única requisição * **Filtro por período:** Especifique startDate e endDate (padrão: últimos 12 meses) * **Ordenação:** Ordene por data de pagamento, taxa, data de aprovação, etc. * **Tipos de proventos:** Rendimentos (distribuições mensais) e Amortizações (devolução de capital) ### Campos da Resposta: * **symbol** — Ticker do FII * **label** — Tipo do provento (RENDIMENTO, AMORTIZAÇÃO) * **rate** — Valor por cota distribuído (R$) * **paymentDate** — Data efetiva de pagamento quando disponível; quando a data real não estiver disponível, pode usar a data de referência informada pela CVM * **lastDatePrior** — Data-com (último dia para ter direito ao provento) * **approvedOn** — Data de aprovação do provento * **relatedTo** — Período relacionado (quando aplicável) * **isinCode** — Código ISIN (quando aplicável) * **remarks** — Observações sobre a origem do registro, quando aplicável ### Importante: Quando disponível, `paymentDate` representa a data efetiva de pagamento. Para alguns fundos e períodos, a CVM informa apenas a data de referência do relatório; nesses casos, `paymentDate` pode coincidir com essa referência. ### Autenticação: Os FIIs **MXRF11** e **HGLG11** podem ser consultados sem autenticação para testes. Para acessar outros FIIs, é necessário um token de API válido. ### Exemplos de Requisição: ```bash # Histórico de proventos dos últimos 12 meses curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/dividends?symbols=HGLG11" # Histórico em período específico, ordenado por data decrescente curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/dividends?symbols=MXRF11,KNCR11&startDate=2023-01-01&endDate=2024-12-31&sortBy=paymentDate&sortOrder=desc" ``` ### Fonte dos Dados: CVM (Comissão de Valores Mobiliários) **Plano Mínimo:** Pro **Autenticação:** Necessária (exceto MXRF11 e HGLG11) **Tags:** Fundos Imobiliários ### Parameters - **symbols** (query) *required* - **startDate** (query) - **endDate** (query) - **sortBy** (query) - **sortOrder** (query) ### Responses #### 200 Histórico de rendimentos dos FIIs retornado com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FiiDividend **Properties:** - **symbol** (string) *(required)* - **approvedOn** (string) *(nullable)* *(required)* - **label** (string) *(required)* - **lastDatePrior** (string) *(required)* - **paymentDate** (string) *(required)* - **rate** (number) *(required)* - **relatedTo** (string) *(nullable)* *(required)* - **isinCode** (string) *(nullable)* *(required)* - **remarks** (string) *(nullable)* *(required)* ### FiiDividendsResponse **Properties:** - **dividends** (array) *(required)* Array items: Reference to: **FiiDividend** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # Financeiros de FIIs URL: /docs/fiis/financeiros.mdx Relatórios DFIN oficiais de FIIs por símbolo ou CNPJ. *** title: Financeiros de FIIs description: Relatórios DFIN oficiais de FIIs por símbolo ou CNPJ. full: true keywords: brapi, FII, DFIN, financeiro, CVM openGraph: title: Financeiros de FIIs description: Dados financeiros DFIN oficiais para FIIs. type: website locale: pt\_BR lastUpdated: '2026-06-14T00:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/fii/financials ----------------------------- Consulta relatórios DFIN de FIIs por símbolo, CNPJ, ano ou período. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/financials Single endpoint documentation for /api/v2/fii/financials ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/fii/financials **Summary:** Relatórios financeiros DFIN de FIIs Consulta dados financeiros estruturados de FIIs provenientes dos documentos DFIN oficiais da CVM. Aceita símbolo ou CNPJ. **Tags:** Fundos Imobiliários ### Parameters - **symbols** (query) - **cnpjs** (query) - **year** (query) - **startDate** (query) - **endDate** (query) - **sortBy** (query) - **sortOrder** (query) - **page** (query) - **limit** (query) ### Responses #### 200 Relatórios financeiros #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FiiFinancialReport **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **year** (number) *(required)* - **referenceDate** (string) *(required)* - **documentType** (string) *(required)* - **fields** (object) *(nullable)* *(required)* ### PaginationMeta **Properties:** - **page** (number) *(required)* - **limit** (number) *(required)* - **totalItems** (number) *(required)* - **totalPages** (number) *(required)* - **hasNextPage** (boolean) *(required)* # Cotações Históricas de FIIs URL: /docs/fiis/historico.mdx Consulte cotações históricas OHLCV diárias de Fundos Imobiliários para gráficos de preço e backtests. *** title: Cotações Históricas de FIIs description: >- Consulte cotações históricas OHLCV diárias de Fundos Imobiliários para gráficos de preço e backtests. full: true keywords: brapi, api, fii, cotações, histórico, OHLCV openGraph: title: Cotações Históricas de FIIs description: >- Cotações históricas OHLCV diárias de Fundos Imobiliários. type: website locale: pt\_BR lastUpdated: '2026-04-25T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/fii/historical structuredData: headings: \[] contents: * content: >- Retorna cotações históricas OHLCV diárias de FIIs, com filtros por data e ordenação. Ideal para gráficos de preço e backtests. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna cotações históricas OHLCV (abertura, máxima, mínima, fechamento, volume) diárias de um ou mais FIIs. Use `startDate` e `endDate` para delimitar o período (padrão: últimos 12 meses). Aceita até **20 símbolos** separados por vírgula. Cada símbolo retorna sua própria série temporal. **Plano mínimo: Pro.** No sandbox sem token, aceita apenas `symbols=MXRF11` e/ou `HGLG11`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/historical Single endpoint documentation for /api/v2/fii/historical ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/fii/historical **Summary:** Obter Cotações Históricas (OHLCV) Retorna a série histórica de preços OHLCV (Abertura, Máxima, Mínima, Fechamento, Volume) diários. Use para backtesting, análise técnica e construção de modelos de previsão. ### Funcionalidades: * **Dados OHLCV completos:** Abertura, Máxima, Mínima, Fechamento, Volume, Fechamento Ajustado * **Granularidade diária:** Um ponto de dados por dia de negociação * **Múltiplos FIIs:** Consulte até 20 FIIs em uma única requisição * **Filtro por período:** Especifique startDate e endDate (padrão: últimos 12 meses) * **Ordenação:** Ascendente ou descendente por data * **Timestamp UNIX:** Datas em segundos desde 1º de janeiro de 1970 ### Campos da Resposta: * **date** — Timestamp UNIX em segundos (número inteiro) * **open** — Preço de abertura (R$) * **high** — Preço máximo do dia (R$) * **low** — Preço mínimo do dia (R$) * **close** — Preço de fechamento (R$) * **volume** — Volume negociado (número de cotas) * **adjustedClose** — Preço de fechamento ajustado (R$) ### Autenticação: Os FIIs **MXRF11** e **HGLG11** podem ser consultados sem autenticação para testes. Para acessar outros FIIs, é necessário um token de API válido. ### Exemplos de Requisição: ```bash # Histórico dos últimos 12 meses (padrão, ordem decrescente) curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/historical?symbols=HGLG11" # Histórico em período específico com ordem crescente curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/historical?symbols=MXRF11,KNCR11&startDate=2024-01-01&endDate=2024-12-31&sortOrder=asc" ``` ### Fonte dos Dados: CVM (Comissão de Valores Mobiliários) **Plano Mínimo:** Pro **Autenticação:** Necessária (exceto MXRF11 e HGLG11) **Tags:** Fundos Imobiliários ### Parameters - **symbols** (query) *required* - **startDate** (query) - **endDate** (query) - **sortOrder** (query) ### Responses #### 200 Série histórica OHLCV por FII retornada com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FiiHistoricalPrice **Properties:** - **date** (integer) *(required)* - **open** (number) *(nullable)* *(required)* - **high** (number) *(nullable)* *(required)* - **low** (number) *(nullable)* *(required)* - **close** (number) *(nullable)* *(required)* - **volume** (number) *(nullable)* *(required)* - **adjustedClose** (number) *(nullable)* *(required)* ### FiiHistoricalResponse **Properties:** - **fiis** (array) *(required)* Array items: Reference to: **FiiHistoricalSeries** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### FiiHistoricalSeries **Properties:** - **symbol** (string) *(required)* - **historicalDataPrice** (array) *(required)* Array items: Reference to: **FiiHistoricalPrice** # Histórico de Imóveis e Vacância URL: /docs/fiis/imoveis-historico.mdx Acompanhe a evolução trimestral de imóveis, área e vacância consolidada dos FIIs. *** title: Histórico de Imóveis e Vacância description: >- Acompanhe a evolução trimestral de imóveis, área e vacância consolidada dos FIIs. full: true keywords: brapi, api, fii, imóveis, vacância, histórico, trimestral openGraph: title: Histórico de Imóveis e Vacância description: Série trimestral compacta de imóveis, área e vacância de FIIs. type: website locale: pt\_BR lastUpdated: '2026-05-30T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/fii/properties/history structuredData: headings: \[] contents: * content: >- Retorna a série trimestral de resumos de imóveis e vacância dos FIIs. *** import { Callout } from 'fumadocs-ui/components/callout'; Use este endpoint para montar gráficos de vacância, área total e quantidade de imóveis ao longo dos trimestres. A resposta é compacta: cada item em `history[]` traz `symbol`, `referenceDate`, `version` e `summary`, sem a lista completa de imóveis. Para inspecionar os imóveis de um trimestre específico, use [`/api/v2/fii/properties`](/docs/fiis/imoveis) com `referenceDate`. Sandbox sem token: `symbols=HGLG11` e `symbols=MXRF11`. Para todos os FIIs, use um token Pro. ## Quando usar * **Gráfico de vacância:** use `history[].summary.vacancyRate`. * **Evolução de área:** use `history[].summary.totalArea`. * **Mudança de carteira física:** compare `history[].summary.count`. * **Retificações:** use `allVersions=true` para ver versões anteriores do informe. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/properties/history Single endpoint documentation for /api/v2/fii/properties/history ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/fii/properties/history **Summary:** Histórico de Imóveis e Vacância Retorna a série trimestral compacta dos imóveis e da vacância dos FIIs. Use este endpoint para gráficos e comparações de vacância, área total e quantidade de imóveis ao longo do tempo. ### Funcionalidades: * **Série trimestral:** Um ponto por FII, trimestre e versão do informe. * **Resumo compacto:** Retorna apenas `summary` por trimestre, sem a lista completa de imóveis. * **Múltiplos FIIs:** Consulte até 20 FIIs em uma única requisição. * **Filtro por período:** Use `startDate=YYYY-MM-DD` e `endDate=YYYY-MM-DD`. O padrão são os últimos 12 meses. * **Versionamento:** Por padrão retorna a versão mais recente de cada trimestre. Use `allVersions=true` para incluir retificações. ### Exemplos de Requisição: ```bash curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/properties/history?symbols=HGLG11" curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/properties/history?symbols=HGLG11,XPLG11&startDate=2024-01-01&endDate=2026-03-31" ``` ### Fonte dos Dados: CVM (Informe Trimestral FII) **Plano Mínimo:** Pro **Autenticação:** Necessária (exceto MXRF11 e HGLG11) **Tags:** Fundos Imobiliários ### Parameters - **symbols** (query) *required* - **startDate** (query) - **endDate** (query) - **sortBy** (query) - **sortOrder** (query) - **allVersions** (query) ### Responses #### 200 Histórico trimestral de imóveis e vacância retornado com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FiiPropertiesHistoryEntry **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **referenceDate** (string) *(required)* - **version** (number) *(required)* - **summary** *(required)* Reference to: **FiiPropertySummary** ### FiiPropertiesHistoryResponse **Properties:** - **history** (array) *(required)* Array items: Reference to: **FiiPropertiesHistoryEntry** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### FiiPropertySummary **Properties:** - **count** (number) *(required)* - **totalArea** (number) *(nullable)* *(required)* - **vacancyRate** (number) *(nullable)* *(required)* - **averageVacancyRate** (number) *(nullable)* *(required)* - **propertiesWithVacancy** (number) *(required)* # Imóveis e Vacância de FIIs URL: /docs/fiis/imoveis.mdx Consulte imóveis físicos de FIIs com área, endereço, vacância, inadimplência e participação na receita. *** title: Imóveis e Vacância de FIIs description: >- Consulte imóveis físicos de FIIs com área, endereço, vacância, inadimplência e participação na receita. full: true keywords: brapi, api, fii, imóveis, vacância, tijolo, galpões, shoppings openGraph: title: Imóveis e Vacância de FIIs description: Endpoint simples para analisar imóveis físicos e vacância de FIIs. type: website locale: pt\_BR lastUpdated: '2026-05-30T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/fii/properties structuredData: headings: \[] contents: * content: >- Retorna imóveis físicos de FIIs com vacância consolidada e item a item. *** import { Callout } from 'fumadocs-ui/components/callout'; Use este endpoint para analisar FIIs de tijolo. A vacância aparece em primeiro plano: `summary.vacancyRate` é ponderada por área quando possível, e cada imóvel vem em `properties[]` com `area`, `address`, `propertyClass`, `unitCount`, `vacancyRate`, `delinquencyRate` e `revenueShare`. Campos de taxa como `vacancyRate`, `delinquencyRate` e `revenueShare` são razões decimais. Exemplo: `0.0328` significa `3,28%`. Sandbox sem token: `symbols=HGLG11` e `symbols=MXRF11`. Para todos os FIIs, use um token Pro. ## Quando usar * **Vacância:** use `summary.vacancyRate` para a taxa consolidada. * **Concentração física:** compare `properties[].area`. * **Risco operacional:** combine `vacancyRate`, `delinquencyRate` e `revenueShare`. * **Trimestre específico:** use `referenceDate=YYYY-MM-DD`. * **Evolução trimestral:** use [`/api/v2/fii/properties/history`](/docs/fiis/imoveis-historico). * **Ordenação:** use `sortBy=revenueShare|area|vacancyRate|name` e `sortOrder=asc|desc`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/properties Single endpoint documentation for /api/v2/fii/properties ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/fii/properties **Summary:** Obter Imóveis e Vacância Retorna os imóveis físicos dos FIIs com vacância em primeiro plano. Use este endpoint para análise de FIIs de tijolo, galpões, lajes, shoppings e qualquer carteira imobiliária física. ### Funcionalidades: * **Vacância consolidada:** `summary.vacancyRate` é ponderada por área quando possível. * **Imóveis item a item:** Nome, endereço, área, unidades, vacância, inadimplência e participação na receita. * **Múltiplos FIIs:** Consulte até 20 FIIs em uma única requisição. * **Filtro por trimestre:** Use `referenceDate=YYYY-MM-DD`. Sem esse parâmetro, retorna o trimestre mais recente disponível por FII. ### Exemplos de Requisição: ```bash curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/properties?symbols=HGLG11" curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/properties?symbols=HGLG11,MXRF11&referenceDate=2026-03-31" ``` ### Fonte dos Dados: CVM (Informe Trimestral FII) **Plano Mínimo:** Pro **Autenticação:** Necessária (exceto MXRF11 e HGLG11) **Tags:** Fundos Imobiliários ### Parameters - **symbols** (query) *required* - **referenceDate** (query) - **sortBy** (query) - **sortOrder** (query) - **allVersions** (query) ### Responses #### 200 Imóveis e vacância dos FIIs retornados com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FiiPropertiesResponse **Properties:** - **fiis** (array) *(required)* Array items: Reference to: **FiiPropertiesResult** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### FiiPropertiesResult **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **referenceDate** (string) *(required)* - **version** (number) *(required)* - **summary** *(required)* Reference to: **FiiPropertySummary** - **properties** (array) *(required)* Array items: Reference to: **FiiProperty** ### FiiProperty **Properties:** - **name** (string) *(required)* - **identifier** (string) *(nullable)* *(required)* - **address** (string) *(nullable)* *(required)* - **propertyClass** (string) *(nullable)* *(required)* - **area** (number) *(nullable)* *(required)* - **unitCount** (number) *(nullable)* *(required)* - **vacancyRate** (number) *(nullable)* *(required)* - **delinquencyRate** (number) *(nullable)* *(required)* - **revenueShare** (number) *(nullable)* *(required)* - **leasedRate** (number) *(nullable)* *(required)* - **soldRate** (number) *(nullable)* *(required)* - **constructionProgressActual** (number) *(nullable)* *(required)* - **constructionProgressExpected** (number) *(nullable)* *(required)* - **constructionCostActual** (number) *(nullable)* *(required)* - **constructionCostExpected** (number) *(nullable)* *(required)* - **investedShare** (number) *(nullable)* *(required)* - **confidential** (boolean) *(required)* ### FiiPropertySummary **Properties:** - **count** (number) *(required)* - **totalArea** (number) *(nullable)* *(required)* - **vacancyRate** (number) *(nullable)* *(required)* - **averageVacancyRate** (number) *(nullable)* *(required)* - **propertiesWithVacancy** (number) *(required)* # Fundos Imobiliários (FIIs) URL: /docs/fiis.mdx Guia prático para integrar dados de FIIs na brapi: indicadores, relatórios CVM, dividendos, cotações históricas e listagem com filtros. *** title: Fundos Imobiliários (FIIs) description: >- Guia prático para integrar dados de FIIs na brapi: indicadores, relatórios CVM, dividendos, cotações históricas e listagem com filtros. full: true keywords: brapi, api, fii, fundos imobiliários, indicadores, dividendos, relatórios openGraph: title: Fundos Imobiliários (FIIs) description: >- Guia prático para integrar dados de FIIs na brapi, com fluxo recomendado e exemplos de uso. type: website locale: pt\_BR lastUpdated: '2026-04-25T12:00:00.000Z' lang: pt-BR ----------- import { Callout } from 'fumadocs-ui/components/callout'; import { Card, Cards } from 'fumadocs-ui/components/card'; import { Step, Steps } from 'fumadocs-ui/components/steps'; import { Tab, Tabs } from 'fumadocs-ui/components/tabs'; Use a API de FIIs para criar screeners, dashboards, análises de dividendos e fluxos de due diligence para fundos imobiliários brasileiros. O fluxo mais comum é: 1. descobrir FIIs com **listagem e filtros** 2. consultar **indicadores atuais** como P/VP, DY e patrimônio 3. acompanhar **histórico de preço, indicadores e dividendos** 4. abrir **relatórios CVM, imóveis, vacância e carteira** Indicadores fundamentalistas, relatórios CVM, carteira normalizada, imóveis e vacância, histórico de dividendos/rendimentos, e cotações OHLCV diárias. Cotações básicas de FIIs (preço, variação) estão disponíveis em todos os planos via `/api/quote/MXRF11`. Os endpoints `/api/v2/fii/*` documentados aqui trazem **dados detalhados** e são exclusivos do plano **Pro**. ## Cobertura e frequência * **Indicadores:** atualizados diariamente após o fechamento do pregão. * **Relatórios CVM:** importados mensalmente conforme publicação pela CVM. * **Carteira e imóveis:** importados dos informes trimestrais da CVM. * **Dividendos:** consolidados a partir dos relatórios mensais. * **Cotações históricas:** OHLCV diário, mesmo formato dos demais ativos. * **Fuso horário:** `America/Sao_Paulo`. Campos de data em respostas seguem formato ISO 8601 ou timestamp Unix. * **Formato de datas em query params:** `YYYY-MM-DD`. ## Acesso por plano Dados detalhados de FIIs fazem parte do plano **Pro**. O sandbox permite experimentação sem token para **MXRF11** e **HGLG11**. | Plano | Acesso a FIIs detalhados | | ------------------- | ---------------------------------- | | Sandbox (sem token) | MXRF11 e HGLG11 | | Free | Cotações básicas via `/api/quote/` | | Startup | Cotações básicas via `/api/quote/` | | **Pro** | **Todos os FIIs detalhados** | ## Termos que você vai ver * **Segmento (`segmentType`):** classificação patrimonial do FII — `papel`, `tijolo`, `hibrido` ou `fof` (fundo de fundos). * **Segmento de atuação (`segmentoAtuacao`):** setor do mercado imobiliário. Ex.: `Logística`, `Shoppings`, `Lajes Corporativas`, `Títulos e Val. Mob.`. * **Tipo de gestão (`tipoGestao`):** `Ativa` ou `Definida` (passiva). * **Mandato (`mandate`):** perfil de investimento — `Renda`, `Ganho de Capital` ou `Híbrido`. * **P/VP (`priceToNav`):** preço de mercado dividido pelo valor patrimonial por cota. Abaixo de 1 indica desconto. * **Dividend Yield (`dividendYield12m`):** rendimento dos últimos 12 meses em relação ao preço atual. * **Vacância:** percentual de imóveis desocupados (relevante para FIIs de tijolo). * **Relatório gerencial:** documento mensal enviado à CVM com composição patrimonial, rentabilidade e dados operacionais. ## Início rápido Exemplo do fluxo `listagem → indicadores → dividendos` usando os tickers do sandbox. ```bash # 1) Busque um FII disponível no sandbox curl "https://brapi.dev/api/v2/fii/list?symbols=MXRF11&limit=5" # 2) Consulte indicadores de um FII específico curl "https://brapi.dev/api/v2/fii/indicators?symbols=MXRF11" # 3) Veja o histórico de dividendos curl "https://brapi.dev/api/v2/fii/dividends?symbols=MXRF11" ``` ```typescript const BASE = 'https://brapi.dev/api/v2/fii'; const token = process.env.BRAPI_TOKEN; // opcional para MXRF11/HGLG11 no sandbox const headers = token ? { Authorization: `Bearer ${token}` } : undefined; // 1) Listagem com ticker do sandbox const list = await fetch( `${BASE}/list?symbols=MXRF11&limit=5`, { headers }, ).then((r) => r.json()); // 2) Indicadores atuais const indicators = await fetch( `${BASE}/indicators?symbols=MXRF11,HGLG11`, { headers }, ).then((r) => r.json()); // 3) Histórico de dividendos const dividends = await fetch( `${BASE}/dividends?symbols=MXRF11`, { headers }, ).then((r) => r.json()); console.log({ list, indicators, dividends }); ``` ```python import os import requests BASE = "https://brapi.dev/api/v2/fii" token = os.getenv("BRAPI_TOKEN") # opcional para MXRF11/HGLG11 no sandbox headers = {"Authorization": f"Bearer {token}"} if token else {} # 1) Listagem com ticker do sandbox fii_list = requests.get( f"{BASE}/list", params={"symbols": "MXRF11", "limit": 5}, headers=headers, ).json() # 2) Indicadores atuais indicators = requests.get( f"{BASE}/indicators", params={"symbols": "MXRF11,HGLG11"}, headers=headers, ).json() # 3) Histórico de dividendos dividends = requests.get( f"{BASE}/dividends", params={"symbols": "MXRF11"}, headers=headers, ).json() print(fii_list, indicators, dividends) ``` ## Fluxo recomendado #### Descubra os FIIs disponíveis Comece em [`/api/v2/fii/list`](/docs/fiis/listagem) para explorar FIIs com filtros por segmento, setor de atuação, tipo de gestão e mandato. #### Consulte os indicadores atuais Use [`/api/v2/fii/indicators`](/docs/fiis/indicadores) para ver P/VP, dividend yield, patrimônio, número de cotistas e dados do administrador. #### Acompanhe a evolução dos indicadores Use [`/api/v2/fii/indicators/history`](/docs/fiis/indicadores-historico) para montar gráficos de evolução mensal de P/VP, DY, patrimônio e outros indicadores. #### Consulte cotações históricas Use [`/api/v2/fii/historical`](/docs/fiis/historico) para obter OHLCV diário. Ideal para gráficos de preço e backtests. #### Acesse os relatórios da CVM Use [`/api/v2/fii/reports`](/docs/fiis/relatorios) para consultar os relatórios gerenciais mensais com composição patrimonial, rentabilidade e dados operacionais. #### Analise imóveis e vacância Use [`/api/v2/fii/properties`](/docs/fiis/imoveis) para consultar imóveis físicos, área, endereço, vacância e participação na receita. #### Acompanhe vacância no tempo Use [`/api/v2/fii/properties/history`](/docs/fiis/imoveis-historico) para gráficos trimestrais de vacância, área total e quantidade de imóveis. #### Abra a composição da carteira Use [`/api/v2/fii/portfolio`](/docs/fiis/carteira) para consultar ativos, cotas de outros FIIs, CRIs, imóveis, direitos e terrenos. #### Acompanhe composição no tempo Use [`/api/v2/fii/portfolio/history`](/docs/fiis/carteira-historico) para ver a evolução trimestral de alocações e valor declarado. #### Consulte o histórico de dividendos Use [`/api/v2/fii/dividends`](/docs/fiis/dividendos) para ver rendimentos e amortizações pagos ao longo do tempo. ## Casos de uso mais comuns * **Tela de screening de FIIs:** `list` com filtros → exibir indicadores * **Dashboard de acompanhamento:** `indicators` para dados atuais + `indicators/history` para evolução * **Análise de dividendos:** `dividends` para histórico de rendimentos * **Gráfico de preço:** `historical` para OHLCV diário * **Due diligence:** `reports` para relatórios CVM + `indicators` para snapshot atual * **Vacância de FIIs de tijolo:** `properties` para imóveis físicos e `properties/history` para evolução trimestral * **Carteira detalhada:** `portfolio` para FoFs, CRIs e composição normalizada; `portfolio/history` para evolução de alocação * **Comparação entre FIIs:** `indicators` com múltiplos symbols (até 20 por request) ## Quando você pode pular etapas * Se você **já sabe o ticker**, pode ir direto para `indicators`, `historical`, `dividends`, `reports`, `properties`, `properties/history`, `portfolio` ou `portfolio/history`. * Se você quer **só listar e filtrar**, use `list` sem precisar dos outros endpoints. * Se você quer **só dividendos**, pode ir direto para `dividends` com o ticker. ## Perguntas frequentes ## Receitas prontas Guias e tutoriais publicados no blog com código pronto para copiar: ## Sandbox sem token Para facilitar a experimentação, os endpoints de FIIs por símbolo aceitam consultas no sandbox sem token, restritas a **MXRF11** e **HGLG11**: * `GET /api/v2/fii/list`: requer token Pro para listar todos os FIIs; sem token, funciona apenas com `symbols=MXRF11` e/ou `symbols=HGLG11`. * `GET /api/v2/fii/indicators`, `/indicators/history`, `/historical`, `/reports`, `/properties`, `/properties/history`, `/portfolio`, `/portfolio/history` e `/dividends`: funcionam sem token apenas com `symbols` contendo exclusivamente MXRF11 e/ou HGLG11. Para qualquer outro FII, é necessário autenticar com um token do plano Pro. ## Endpoints # Indicadores Históricos de FIIs URL: /docs/fiis/indicadores-historico.mdx Acompanhe a evolução mensal dos indicadores de FIIs: P/VP, dividend yield, patrimônio e mais, com filtros de data e ordenação. *** title: Indicadores Históricos de FIIs description: >- Acompanhe a evolução mensal dos indicadores de FIIs: P/VP, dividend yield, patrimônio e mais, com filtros de data e ordenação. full: true keywords: brapi, api, fii, indicadores, histórico, evolução mensal openGraph: title: Indicadores Históricos de FIIs description: >- Série temporal mensal dos indicadores fundamentalistas de FIIs. type: website locale: pt\_BR lastUpdated: '2026-04-25T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/fii/indicators/history structuredData: headings: \[] contents: * content: >- Retorna a série histórica mensal dos indicadores de FIIs, com filtros por data e ordenação. Ideal para gráficos de evolução. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna a série histórica mensal dos indicadores de FIIs. Use `startDate` e `endDate` para delimitar o período e `sortOrder` para controlar a direção (padrão: mais recente primeiro). Ideal para montar gráficos de evolução de P/VP, dividend yield, patrimônio e outros indicadores ao longo dos meses. Dados disponíveis a partir de **setembro de 2016**. **Plano mínimo: Pro.** No sandbox sem token, aceita apenas `symbols=MXRF11` e/ou `HGLG11`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/indicators/history Single endpoint documentation for /api/v2/fii/indicators/history ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/fii/indicators/history **Summary:** Obter Histórico de Indicadores Retorna a série temporal mensal dos indicadores fundamentalistas. Analise tendências de valuation, rentabilidade e crescimento patrimonial ao longo do tempo. ### Funcionalidades: * **Histórico desde setembro/2016:** Dados mensais de mais de 8 anos * **Granularidade mensal:** Um ponto de dados por mês para cada FII * **Múltiplos FIIs:** Consulte até 20 FIIs em uma única requisição * **Filtro por período:** Especifique startDate e endDate (padrão: últimos 12 meses) * **Ordenação flexível:** Ordene por qualquer campo (referenceDate, price, DY, P/VP, etc.) * **Análises de tendência:** Identifique padrões de rentabilidade, valuation e crescimento ### Campos da Resposta: Os mesmos indicadores do endpoint /indicators, com adição de referenceDate (data do último dia do mês de referência). ### Autenticação: Os FIIs **MXRF11** e **HGLG11** podem ser consultados sem autenticação para testes. Para acessar outros FIIs, é necessário um token de API válido. ### Exemplos de Requisição: ```bash # Histórico dos últimos 12 meses (padrão) curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/indicators/history?symbols=HGLG11,MXRF11" # Histórico em período específico (2023-2024) curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/indicators/history?symbols=KNCR11&startDate=2023-01-01&endDate=2024-12-31" # Histórico ordenado por Dividend Yield decrescente curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/indicators/history?symbols=XPLG11,BTLG11&sortBy=dividendYield12m&sortOrder=desc" ``` ### Fonte dos Dados: CVM (Comissão de Valores Mobiliários) **Plano Mínimo:** Pro **Autenticação:** Necessária (exceto MXRF11 e HGLG11) **Tags:** Fundos Imobiliários ### Parameters - **symbols** (query) *required* - **startDate** (query) - **endDate** (query) - **sortBy** (query) - **sortOrder** (query) ### Responses #### 200 Histórico mensal de indicadores retornado com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FiiIndicatorHistoryEntry **Properties:** - **symbol** (string) *(required)* - **referenceDate** (string) *(required)* - **price** (number) *(nullable)* *(required)* - **navPerShare** (number) *(nullable)* *(required)* - **priceToNav** (number) *(nullable)* *(required)* - **dividendYield12m** (number) *(nullable)* *(required)* - **dividendYield1m** (number) *(nullable)* *(required)* - **monthlyReturn** (number) *(nullable)* *(required)* - **totalInvestors** (number) *(nullable)* *(required)* - **sharesOutstanding** (number) *(nullable)* *(required)* - **equity** (number) *(nullable)* *(required)* - **totalAssets** (number) *(nullable)* *(required)* - **segmentType** (string) *(nullable)* *(required)* ### FiiIndicatorsHistoryResponse **Properties:** - **history** (array) *(required)* Array items: Reference to: **FiiIndicatorHistoryEntry** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # Indicadores de FIIs URL: /docs/fiis/indicadores.mdx Consulte indicadores fundamentalistas atuais de FIIs: P/VP, dividend yield, patrimônio, cotistas e dados do administrador. *** title: Indicadores de FIIs description: >- Consulte indicadores fundamentalistas atuais de FIIs: P/VP, dividend yield, patrimônio, cotistas e dados do administrador. full: true keywords: brapi, api, fii, indicadores, P/VP, dividend yield openGraph: title: Indicadores de FIIs description: >- Consulte indicadores fundamentalistas atuais de Fundos Imobiliários. type: website locale: pt\_BR lastUpdated: '2026-04-25T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/fii/indicators structuredData: headings: \[] contents: * content: >- Retorna indicadores fundamentalistas atuais de FIIs, incluindo P/VP, dividend yield, patrimônio líquido, número de cotistas e informações do administrador. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna indicadores fundamentalistas atuais de um ou mais FIIs. Inclui P/VP, dividend yield (1 mês e 12 meses), patrimônio líquido, total de ativos, número de cotistas, cotas emitidas e dados do administrador (nome, CNPJ, contato). Aceita até **20 símbolos** separados por vírgula. Para acompanhar a evolução desses indicadores ao longo do tempo, use [Indicadores Históricos](/docs/fiis/indicadores-historico). **Plano mínimo: Pro.** No sandbox sem token, aceita apenas `symbols=MXRF11` e/ou `HGLG11`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/indicators Single endpoint documentation for /api/v2/fii/indicators ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/fii/indicators **Summary:** Obter Indicadores Fundamentalistas Retorna os indicadores fundamentalistas mais recentes para um ou mais FIIs. Use este endpoint para análises de valuation, rentabilidade e comparações entre fundos. ### Funcionalidades: * **Múltiplos FIIs:** Consulte até 20 FIIs em uma única requisição (separados por vírgula) * **Indicadores de Valuation:** Preço atual, Valor Patrimonial por Cota (VP/Cota), Preço/VP (P/VP) * **Indicadores de Rentabilidade:** Dividend Yield 12 meses, Dividend Yield 1 mês, Retorno mensal * **Dados de Liquidez:** Total de investidores (cotistas), Cotas emitidas, Patrimônio Líquido, Ativo Total * **Classificação:** Tipo de segmento (Papel, Tijolo, Híbrido, FOF) * **Dados do administrador:** Nome, CNPJ, endereço, telefones, site e email informados pela CVM ### Campos da Resposta: * **price** — Preço atual da cota (R$) * **navPerShare** — Valor Patrimonial por Cota (VP/Cota) em R$ * **priceToNav** — Razão Preço/Valor Patrimonial (P/VP) — valores < 1 indicam desconto * **dividendYield12m** — Dividend Yield acumulado nos últimos 12 meses (%) * **dividendYield1m** — Dividend Yield do último mês (%) * **monthlyReturn** — Retorno mensal (%) * **totalInvestors** — Total de investidores (cotistas) do fundo * **sharesOutstanding** — Número de cotas emitidas * **equity** — Patrimônio Líquido (R$) * **totalAssets** — Ativo Total (R$) * **segmentType** — Tipo de segmento (papel, tijolo, hibrido, fof) ### Autenticação: Os FIIs **MXRF11** e **HGLG11** podem ser consultados sem autenticação para testes. Para acessar outros FIIs, é necessário um token de API válido. ### Exemplos de Requisição: ```bash # Consultar um FII (sem autenticação - teste) curl "https://brapi.dev/api/v2/fii/indicators?symbols=MXRF11" # Consultar múltiplos FIIs curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/indicators?symbols=HGLG11,KNCR11,XPLG11" ``` ### Fonte dos Dados: CVM (Comissão de Valores Mobiliários) **Plano Mínimo:** Pro **Autenticação:** Necessária (exceto MXRF11 e HGLG11) **Tags:** Fundos Imobiliários ### Parameters - **symbols** (query) *required* ### Responses #### 200 Indicadores atuais dos FIIs retornados com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FiiIndicator **Properties:** - **symbol** (string) *(required)* - **asOfDate** (string) *(nullable)* *(required)* - **price** (number) *(nullable)* *(required)* - **navPerShare** (number) *(nullable)* *(required)* - **priceToNav** (number) *(nullable)* *(required)* - **dividendYield12m** (number) *(nullable)* *(required)* - **dividendYield1m** (number) *(nullable)* *(required)* - **monthlyReturn** (number) *(nullable)* *(required)* - **totalInvestors** (number) *(nullable)* *(required)* - **sharesOutstanding** (number) *(nullable)* *(required)* - **equity** (number) *(nullable)* *(required)* - **totalAssets** (number) *(nullable)* *(required)* - **segmentType** (string) *(nullable)* *(required)* ### FiiIndicatorsResponse **Properties:** - **fiis** (array) *(required)* Array items: Reference to: **FiiIndicatorWithInfo** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### FiiIndicatorWithInfo # Informes Anuais de FIIs URL: /docs/fiis/informes-anuais.mdx Informes anuais oficiais de FIIs por símbolo ou CNPJ. *** title: Informes Anuais de FIIs description: Informes anuais oficiais de FIIs por símbolo ou CNPJ. full: true keywords: brapi, FII, informe anual, CVM openGraph: title: Informes Anuais de FIIs description: Informes anuais oficiais para FIIs. type: website locale: pt\_BR lastUpdated: '2026-06-14T00:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/fii/annual-reports --------------------------------- Consulta informes anuais de FIIs por símbolo, CNPJ, ano ou período. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/annual-reports Single endpoint documentation for /api/v2/fii/annual-reports ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/fii/annual-reports **Summary:** Informes anuais de FIIs Consulta informes anuais oficiais de FIIs da CVM. FIAGRO, FI-Infra, FIDC e FIP permanecem em endpoints próprios. **Tags:** Fundos Imobiliários ### Parameters - **symbols** (query) - **cnpjs** (query) - **year** (query) - **startDate** (query) - **endDate** (query) - **sortBy** (query) - **sortOrder** (query) - **page** (query) - **limit** (query) - **include** (query) ### Responses #### 200 Informes anuais #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FiiAnnualReport **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **year** (number) *(required)* - **referenceDate** (string) *(required)* - **includeSections** (object) *(nullable)* *(required)* - **fields** (object) *(nullable)* *(required)* ### PaginationMeta **Properties:** - **page** (number) *(required)* - **limit** (number) *(required)* - **totalItems** (number) *(required)* - **totalPages** (number) *(required)* - **hasNextPage** (boolean) *(required)* # Listagem de FIIs URL: /docs/fiis/listagem.mdx Liste e filtre Fundos Imobiliários por símbolos, CNPJs, segmento, setor de atuação, tipo de gestão e mandato, com paginação e ordenação. *** title: Listagem de FIIs description: >- Liste e filtre Fundos Imobiliários por símbolos, CNPJs, segmento, setor de atuação, tipo de gestão e mandato, com paginação e ordenação. full: true keywords: brapi, api, fii, fundos imobiliários, listagem, filtro openGraph: title: Listagem de FIIs description: >- Liste e filtre Fundos Imobiliários com indicadores resumidos. type: website locale: pt\_BR lastUpdated: '2026-04-25T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/fii/list structuredData: headings: \[] contents: * content: >- Retorna uma lista paginada de FIIs com indicadores resumidos, filtros por símbolos, segmento, setor, gestão e mandato, e busca textual. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna uma lista paginada de FIIs com indicadores resumidos. Use filtros para refinar por segmento (`papel`, `tijolo`, `híbrido`, `fof`), setor de atuação, tipo de gestão, mandato, símbolos específicos e CNPJs. Suporta busca textual pelo nome, ticker ou CNPJ. Ideal como ponto de partida para telas de screening ou seleção de FIIs. Veja o fluxo completo em [Fundos Imobiliários](/docs/fiis). Para FIAGRO, FI-Infra/FIF, FIDC e FIP, use a seção [Fundos](/docs/fundos). Por exemplo, `JURO11` é FI-Infra/FIF e deve ser consultado em `/api/v2/funds/list?symbols=JURO11`, não como FII. **Plano mínimo: Pro.** A listagem completa requer token. Para testar sem token, use `symbols=MXRF11` e/ou `symbols=HGLG11`, por exemplo `/api/v2/fii/list?symbols=HGLG11`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/list Single endpoint documentation for /api/v2/fii/list ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/fii/list **Summary:** Listar Fundos Imobiliários Retorna a lista paginada de todos os Fundos de Investimento Imobiliário (FIIs) registrados, com dados do instrumento e indicadores atuais. Ideal para descobrir novos FIIs, comparar rentabilidades e construir carteiras diversificadas. ### Funcionalidades: * **Filtro por símbolos:** Consulte FIIs específicos com `symbols=HGLG11,MXRF11` * **Filtro por CNPJs:** Consulte FIIs específicos com `cnpjs=11728688000147` * **Busca por nome ou símbolo:** Encontre FIIs rapidamente por texto (ex: "hglg" retorna HGLG11) * **Filtros por segmento:** Papel (Títulos/CRI), Tijolo (Imóveis físicos), Híbrido (Misto), FOF (Fundo de Fundos) * **Filtros por setor:** Logística, Shoppings, Escritórios, Lajes Corporativas, Títulos e Val. Mob., Residencial, Hospital, Hotel, Educacional, Híbrido, Multicategoria, Varejo, Outros * **Filtros por mandato:** Renda, Híbrido, Títulos e Valores Mobiliários, etc. * **Filtros por tipo de gestão:** Ativa, Definida * **Dados do administrador:** Nome, CNPJ, endereço, telefones, site e email informados pela CVM * **Ordenação flexível:** Ordene por qualquer campo (DY, P/VP, Preço, Total de Investidores, etc.) * **Paginação:** Controle o número de resultados por página ### Autenticação: Este endpoint lista o universo de FIIs e requer um token de API válido. Para testar sem token, filtre por símbolos sandbox com **MXRF11** ou **HGLG11**. ### Exemplos de Requisição: ```bash # Listar todos os FIIs (primeiros 20) curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/list" # Buscar FIIs específicos por símbolo curl "https://brapi.dev/api/v2/fii/list?symbols=HGLG11,MXRF11" # Buscar FII por CNPJ curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/list?cnpjs=11728688000147" # Buscar FIIs por nome (ex: HGLG) curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/list?search=hglg" # Filtrar por setor (Logística) e ordenar por Dividend Yield decrescente curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/list?segmentoAtuacao=Logística&sortBy=dividendYield12m&sortOrder=desc&limit=10" # Filtrar por tipo de segmento (Tijolo) e tipo de gestão (Ativa) curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/list?segmentType=tijolo&tipoGestao=Ativa&page=1&limit=20" ``` ### FIIs Populares: MXRF11 (Multisegmento), HGLG11 (Logística), KNCR11 (Logística), XPLG11 (Logística), XPML11 (Logística), KNRI11 (Renda), BTLG11 (Logística), VISC11 (Varejo) ### Fonte dos Dados: CVM (Comissão de Valores Mobiliários) **Plano Mínimo:** Pro **Autenticação:** Necessária para listagem completa **Tags:** Fundos Imobiliários ### Parameters - **page** (query) - **limit** (query) - **sortBy** (query) - **sortOrder** (query) - **symbols** (query) - **cnpjs** (query) - **search** (query) - **segmentType** (query) - **segmentoAtuacao** (query) - **mandate** (query) - **tipoGestao** (query) ### Responses #### 200 Lista paginada de FIIs com indicadores retornada com sucesso. #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FiiListItem **Properties:** - **symbol** (string) *(nullable)* *(required)* - **name** (string) *(nullable)* *(required)* - **cnpj** (string) *(nullable)* *(required)* - **mandate** (string) *(nullable)* *(required)* - **segmentoAtuacao** (string) *(nullable)* *(required)* - **tipoGestao** (string) *(nullable)* *(required)* - **administratorName** (string) *(nullable)* *(required)* - **administratorCnpj** (string) *(nullable)* *(required)* - **administratorAddress** (string) *(nullable)* *(required)* - **administratorAddressNumber** (string) *(nullable)* *(required)* - **administratorAddressComplement** (string) *(nullable)* *(required)* - **administratorDistrict** (string) *(nullable)* *(required)* - **administratorCity** (string) *(nullable)* *(required)* - **administratorState** (string) *(nullable)* *(required)* - **administratorZipCode** (string) *(nullable)* *(required)* - **administratorPhone1** (string) *(nullable)* *(required)* - **administratorPhone2** (string) *(nullable)* *(required)* - **administratorPhone3** (string) *(nullable)* *(required)* - **administratorWebsite** (string) *(nullable)* *(required)* - **administratorEmail** (string) *(nullable)* *(required)* - **price** (number) *(nullable)* *(required)* - **navPerShare** (number) *(nullable)* *(required)* - **priceToNav** (number) *(nullable)* *(required)* - **dividendYield12m** (number) *(nullable)* *(required)* - **totalInvestors** (number) *(nullable)* *(required)* - **segmentType** (string) *(nullable)* *(required)* ### FiiListResponse **Properties:** - **fiis** (array) *(required)* Array items: Reference to: **FiiListItem** - **pagination** *(required)* Reference to: **PaginationMeta** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### PaginationMeta **Properties:** - **page** (number) *(required)* - **limit** (number) *(required)* - **totalItems** (number) *(required)* - **totalPages** (number) *(required)* - **hasNextPage** (boolean) *(required)* # Relatórios CVM de FIIs URL: /docs/fiis/relatorios.mdx Acesse os relatórios gerenciais mensais de FIIs enviados à CVM, com composição patrimonial, rentabilidade e dados operacionais. *** title: Relatórios CVM de FIIs description: >- Acesse os relatórios gerenciais mensais de FIIs enviados à CVM, com composição patrimonial, rentabilidade e dados operacionais. full: true keywords: brapi, api, fii, relatórios, CVM, gerencial mensal openGraph: title: Relatórios CVM de FIIs description: >- Relatórios gerenciais mensais de FIIs com composição patrimonial e rentabilidade. type: website locale: pt\_BR lastUpdated: '2026-04-25T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/fii/reports structuredData: headings: \[] contents: * content: >- Retorna os relatórios gerenciais mensais de FIIs enviados à CVM, com composição patrimonial, taxas, rentabilidade e passivos. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna os relatórios gerenciais mensais de FIIs conforme enviados à CVM. Inclui composição patrimonial (CRI, LCI, imóveis, títulos públicos, cotas de outros FIIs), taxas de administração, rentabilidade mensal, dividend yield e passivos. Use `allVersions=true` para incluir versões retificadas dos relatórios. Suporta paginação via `page` e `limit`, e ordenação via `sortBy` e `sortOrder`. **Plano mínimo: Pro.** No sandbox sem token, aceita apenas `symbols=MXRF11` e/ou `HGLG11`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/fii/reports Single endpoint documentation for /api/v2/fii/reports ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/fii/reports **Summary:** Obter Relatórios Gerenciais Retorna os relatórios gerenciais mensais publicados na CVM, com composição patrimonial detalhada. Analise a alocação de ativos, estrutura de passivos e evolução do patrimônio dos FIIs. ### Funcionalidades: * **Relatórios mensais:** Um relatório por mês para cada FII * **Múltiplos FIIs:** Consulte até 20 FIIs em uma única requisição * **Filtro por período:** Especifique startDate e endDate (padrão: últimos 12 meses) * **Versionamento:** Relatórios podem ter múltiplas versões (retificações). Por padrão, retorna apenas a mais recente. Use `allVersions=true` para todas as versões. * **Paginação:** Controle o número de resultados por página * **Ordenação:** Ordene por qualquer campo (referenceDate, totalAssets, equity, etc.) ### KPIs Inclusos: * **Ativo Total** — Patrimônio total do fundo (R$) * **Patrimônio Líquido** — Equity (R$) * **Cotas** — Número de cotas emitidas * **VP/Cota** — Valor Patrimonial por Cota (R$) * **Taxa de Administração** — Taxa anual (%) * **Retorno Mensal** — Retorno do mês (%) * **Dividend Yield Mensal** — DY do mês (%) * **Total de Investidores** — Número de cotistas ### Composição de Ativos: * **Caixa** — Disponibilidades (R$) * **Títulos Públicos** — Tesouro Direto, LTN, etc. (R$) * **Títulos Privados** — Debêntures, CDB, etc. (R$) * **Fundos RF** — Fundos de Renda Fixa (R$) * **Imóveis** — Propriedades físicas (R$) * **CRI** — Certificados de Recebíveis Imobiliários (R$) * **LCI** — Letras de Crédito Imobiliário (R$) * **Cotas de FIIs** — Investimentos em outros FIIs (R$) * **Recebíveis** — Aluguéis, rendas a receber (R$) ### Composição de Passivos: * **Distribuições a Pagar** — Proventos não pagos (R$) * **Taxas Admin a Pagar** — Taxas de administração (R$) * **Obrigações Imobiliárias** — Financiamentos, empréstimos (R$) * **Total de Passivos** — Soma de todas as obrigações (R$) ### Administrador: * **administratorName** — Nome da instituição administradora * **administratorCnpj** — CNPJ da instituição administradora * **administratorAddress**, **administratorAddressNumber**, **administratorAddressComplement** — Endereço informado à CVM * **administratorDistrict**, **administratorCity**, **administratorState**, **administratorZipCode** — Localização do administrador * **administratorPhone1**, **administratorPhone2**, **administratorPhone3** — Telefones de contato * **administratorWebsite**, **administratorEmail** — Site e email de contato ### Autenticação: Os FIIs **MXRF11** e **HGLG11** podem ser consultados sem autenticação para testes. Para acessar outros FIIs, é necessário um token de API válido. ### Exemplos de Requisição: ```bash # Relatórios dos últimos 12 meses (apenas versão mais recente) curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/reports?symbols=HGLG11" # Relatórios em período específico com paginação curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/reports?symbols=MXRF11,KNCR11&startDate=2024-01-01&endDate=2024-12-31&page=1&limit=10" # Todas as versões dos relatórios (incluindo retificações) curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/reports?symbols=XPLG11&allVersions=true&sortBy=referenceDate&sortOrder=desc" ``` ### Fonte dos Dados: CVM (Comissão de Valores Mobiliários) **Plano Mínimo:** Pro **Autenticação:** Necessária (exceto MXRF11 e HGLG11) **Tags:** Fundos Imobiliários ### Parameters - **symbols** (query) *required* - **startDate** (query) - **endDate** (query) - **sortBy** (query) - **sortOrder** (query) - **page** (query) - **limit** (query) - **allVersions** (query) ### Responses #### 200 Relatórios mensais paginados dos FIIs retornados com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FiiMonthlyReport **Properties:** - **symbol** (string) *(nullable)* *(required)* - **name** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **administratorName** (string) *(nullable)* *(required)* - **administratorCnpj** (string) *(nullable)* *(required)* - **administratorAddress** (string) *(nullable)* *(required)* - **administratorAddressNumber** (string) *(nullable)* *(required)* - **administratorAddressComplement** (string) *(nullable)* *(required)* - **administratorDistrict** (string) *(nullable)* *(required)* - **administratorCity** (string) *(nullable)* *(required)* - **administratorState** (string) *(nullable)* *(required)* - **administratorZipCode** (string) *(nullable)* *(required)* - **administratorPhone1** (string) *(nullable)* *(required)* - **administratorPhone2** (string) *(nullable)* *(required)* - **administratorPhone3** (string) *(nullable)* *(required)* - **administratorWebsite** (string) *(nullable)* *(required)* - **administratorEmail** (string) *(nullable)* *(required)* - **referenceDate** (string) *(required)* - **version** (number) *(required)* - **totalAssets** (number) *(nullable)* *(required)* - **equity** (number) *(nullable)* *(required)* - **sharesOutstanding** (number) *(nullable)* *(required)* - **navPerShare** (number) *(nullable)* *(required)* - **adminFeeRate** (number) *(nullable)* *(required)* - **monthlyReturn** (number) *(nullable)* *(required)* - **monthlyPatrimonialReturn** (number) *(nullable)* *(required)* - **monthlyDividendYield** (number) *(nullable)* *(required)* - **amortizationRate** (number) *(nullable)* *(required)* - **totalInvestors** (number) *(nullable)* *(required)* - **cash** (number) *(nullable)* *(required)* - **liquidityNeeds** (number) *(nullable)* *(required)* - **governmentBonds** (number) *(nullable)* *(required)* - **privateBonds** (number) *(nullable)* *(required)* - **fixedIncomeFunds** (number) *(nullable)* *(required)* - **totalInvested** (number) *(nullable)* *(required)* - **realEstateAssets** (number) *(nullable)* *(required)* - **realEstateCompanyShares** (number) *(nullable)* *(required)* - **realEstateCompanyUnits** (number) *(nullable)* *(required)* - **cri** (number) *(nullable)* *(required)* - **lci** (number) *(nullable)* *(required)* - **fiiHoldings** (number) *(nullable)* *(required)* - **receivables** (number) *(nullable)* *(required)* - **rentalReceivables** (number) *(nullable)* *(required)* - **otherReceivables** (number) *(nullable)* *(required)* - **distributionsPayable** (number) *(nullable)* *(required)* - **adminFeesPayable** (number) *(nullable)* *(required)* - **realEstateObligations** (number) *(nullable)* *(required)* - **totalLiabilities** (number) *(nullable)* *(required)* ### FiiReportsResponse **Properties:** - **reports** (array) *(required)* Array items: Reference to: **FiiMonthlyReport** - **pagination** *(required)* Reference to: **PaginationMeta** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### PaginationMeta **Properties:** - **page** (number) *(required)* - **limit** (number) *(required)* - **totalItems** (number) *(required)* - **totalPages** (number) *(required)* - **hasNextPage** (boolean) *(required)* # Carteira de Fundos URL: /docs/fundos/carteira.mdx Posições oficiais CVM CDA agrupadas por tipo de ativo. *** title: Carteira de Fundos description: Posições oficiais CVM CDA agrupadas por tipo de ativo. full: true keywords: brapi, fundos, carteira, CDA, holdings, JURO11 openGraph: title: Carteira de Fundos description: Carteira CVM CDA agrupada em títulos públicos, cotas, crédito e outros. type: website locale: pt\_BR lastUpdated: '2026-06-14T00:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/funds/portfolio ------------------------------ Retorna a carteira do fundo agrupada por tipo de ativo, como títulos públicos, cotas de fundos, crédito, ativos listados, recebíveis e obrigações. Posições confidenciais aparecem como agregados. Informações adicionais de cada posição ficam em `details`, com nomes padronizados pela brapi. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/funds/portfolio Single endpoint documentation for /api/v2/funds/portfolio ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/funds/portfolio **Summary:** Carteira oficial CVM CDA para fundos FI/FIF Retorna carteira oficial CVM CDA agrupada por títulos públicos, cotas de fundos, crédito privado, recebíveis e valores a pagar. **Tags:** Fundos ### Parameters - **symbols** (query) - **cnpjs** (query) - **page** (query) - **limit** (query) - **referenceDate** (query) - **include** (query) ### Responses #### 200 Carteiras **Example Response:** ```json { "funds": [ { "symbol": "JURO11", "cnpj": "42730834000100", "name": "SPARTA INFRA FI EM COTAS DE FUNDOS INCENTIVADOS DE INVESTIMENTO EM INFRAESTRUTURA RENDA FIXA", "referenceDate": "2026-05-31T00:00:00.000Z", "summary": { "marketValue": 2083851261, "holdingsCount": 7, "publicBondsValue": 6403800, "fundHoldingsValue": 2053162240, "creditAssetsValue": 0, "listedSecuritiesValue": 0, "receivablesValue": 12371910, "payablesValue": 11913311 }, "publicBonds": [ { "bucket": "publicBonds", "assetType": "Título público federal", "assetName": "NOTAS DO TESOURO NACIONAL SERIE B", "issuerName": null, "issuerCnpj": null, "isin": "BRSTNCNTB716", "selicCode": "760199", "quantity": 1434, "marketValue": 6403800, "costValue": null, "maturityDate": "2029-05-15T00:00:00.000Z", "confidential": false, "details": { "applicationType": "Operações Compromissadas", "negotiationType": "Para negociação", "issueDate": "2024-01-17T00:00:00.000Z", "relatedIssuer": false, "fundClassType": "CLASSES - FIF" } } ], "fundHoldings": [ { "bucket": "fundHoldings", "assetType": "Fundo de Investimento e de Cotas", "assetName": "SPARTA INFRA MASTER VI FUNDO INCENTIVADO DE INVESTIMENTO EM INFRAESTRUTURA RENDA FIXA", "issuerName": null, "issuerCnpj": "54773359000120", "isin": null, "selicCode": null, "quantity": 9950000, "marketValue": 972734460, "costValue": null, "maturityDate": null, "confidential": false, "details": { "applicationType": "Cotas de Fundos", "relatedIssuer": true, "fundClassType": "CLASSES - FIF" } } ], "creditAssets": [], "listedSecurities": [], "receivables": [ { "bucket": "receivables", "assetType": "Outros", "assetName": "VALORES A RECEBER", "issuerName": null, "issuerCnpj": null, "isin": null, "selicCode": null, "quantity": null, "marketValue": 12371910, "costValue": null, "maturityDate": null, "confidential": false, "details": { "applicationType": "Valores a receber", "negotiationType": "Para negociação", "fundClassType": "CLASSES - FIF" } } ], "payables": [ { "bucket": "payables", "assetType": "Outros", "assetName": "VALORES A PAGAR", "issuerName": null, "issuerCnpj": null, "isin": null, "selicCode": null, "quantity": null, "marketValue": 11913311, "costValue": null, "maturityDate": null, "confidential": false, "details": { "applicationType": "Valores a pagar", "negotiationType": "Para negociação", "fundClassType": "CLASSES - FIF" } } ], "confidentialSummary": null } ], "requestedAt": "2026-06-22T02:10:57.134Z", "took": 147 } ``` #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FundHolding **Properties:** - **bucket** (string) *(required)* - **assetType** (string) *(nullable)* *(required)* - **assetName** (string) *(nullable)* *(required)* - **issuerName** (string) *(nullable)* *(required)* - **issuerCnpj** (string) *(nullable)* *(required)* - **isin** (string) *(nullable)* *(required)* - **selicCode** (string) *(nullable)* *(required)* - **quantity** (number) *(nullable)* *(required)* - **marketValue** (number) *(nullable)* *(required)* - **costValue** (number) *(nullable)* *(required)* - **maturityDate** (string) *(nullable)* *(required)* - **confidential** (boolean) *(required)* - **details** *(required)* Reference to: **FundHoldingDetails** ### FundHoldingDetails **Properties:** - **applicationType** (string) - **negotiationType** (string) - **assetCode** (string) - **issueDate** (string) - **relatedIssuer** (boolean) - **purchasedQuantity** (number) - **soldQuantity** (number) - **purchaseValue** (number) - **saleValue** (number) - **confidentialUntil** (string) - **fundClassType** (string) - **subclassId** (string) - **issuerType** (string) ### FundPortfolio **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **name** (string) *(nullable)* *(required)* - **referenceDate** (string) *(required)* - **summary** (object) *(required)* - **publicBonds** (array) *(required)* Array items: Reference to: **FundHolding** - **fundHoldings** (array) *(required)* Array items: Reference to: **FundHolding** - **creditAssets** (array) *(required)* Array items: Reference to: **FundHolding** - **listedSecurities** (array) *(required)* Array items: Reference to: **FundHolding** - **receivables** (array) *(required)* Array items: Reference to: **FundHolding** - **payables** (array) *(required)* Array items: Reference to: **FundHolding** - **confidentialSummary** (object) *(nullable)* *(required)* # Dividendos URL: /docs/fundos/dividendos.mdx Eventos oficiais de dividendos para FIAGRO, FI-Infra/FIF, FIDC e FIP listados. *** title: Dividendos description: Eventos oficiais de dividendos para FIAGRO, FI-Infra/FIF, FIDC e FIP listados. full: true keywords: brapi, fundos, dividendos, rendimentos, FIAGRO, FI-Infra, FIDC, FIP openGraph: title: Dividendos de Fundos description: Datas e valores oficiais de dividendos de fundos listados não-FII. type: website locale: pt\_BR lastUpdated: '2026-06-26T00:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/funds/dividends ------------------------------ Consulte dividendos de fundos listados não-FII, como FIAGRO, FI-Infra/FIF, FIDC e FIP, com datas, valor por cota e rótulo do evento. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/funds/dividends Single endpoint documentation for /api/v2/funds/dividends ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/funds/dividends **Summary:** Dividendos oficiais de fundos listados não-FII Retorna eventos exatos de dividendos/rendimentos para FIAGRO, FI-Infra/FIF, FIDC e FIP listados quando a fonte oficial fornece data de declaração, data-com/ex, data de pagamento, valor por cota e rótulo. Os filtros startDate/endDate usam a data de pagamento (`paymentDate`). FIIs continuam no endpoint dedicado `/api/v2/fii/dividends`. Este endpoint não inventa datas a partir de relatórios mensais e não expõe metadados internos de fonte. **Tags:** Fundos ### Parameters - **symbols** (query) - **cnpjs** (query) - **startDate** (query) - **endDate** (query) - **page** (query) - **limit** (query) - **sortBy** (query) - **sortOrder** (query) - **assetType** (query) ### Responses #### 200 Dividendos oficiais **Example Response:** ```json { "dividends": [ { "symbol": "JURO11", "cnpj": "42730834000100", "assetType": "fiinfra", "declaredDate": "2026-05-29T00:00:00.000Z", "lastDatePrior": "2026-05-29T00:00:00.000Z", "paymentDate": "2026-06-13T00:00:00.000Z", "rate": 0.5, "label": "RENDIMENTO", "isinCode": "BRJUROCTF002" } ], "pagination": { "page": 1, "limit": 20, "totalItems": 1, "totalPages": 1, "hasNextPage": false }, "requestedAt": "2026-06-22T02:10:56.983Z", "took": 152 } ``` #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FundDividend **Properties:** - **symbol** (string) *(required)* - **cnpj** (string) *(required)* - **assetType** (string) - Options: `fiagro`, `fiinfra`, `fif`, `fidc`, `fip`, `other` *(required)* - **declaredDate** (string) *(required)* - **lastDatePrior** (string) *(required)* - **paymentDate** (string) *(required)* - **rate** (number) *(required)* - **label** (string) *(required)* - **isinCode** (string) *(nullable)* *(required)* ### FundPaginationMeta **Properties:** - **page** (number) *(required)* - **limit** (number) *(required)* - **totalItems** (number) *(required)* - **totalPages** (number) *(required)* - **hasNextPage** (boolean) *(required)* # Carteira FIAGRO URL: /docs/fundos/fiagro-carteira.mdx Alocações FIAGRO agrupadas por crédito agro, passivos e cotistas. *** title: Carteira FIAGRO description: Alocações FIAGRO agrupadas por crédito agro, passivos e cotistas. full: true keywords: brapi, FIAGRO, carteira, CRA, CPR, FIDC, FII openGraph: title: Carteira FIAGRO description: Alocações FIAGRO normalizadas a partir dos relatórios mensais. type: website locale: pt\_BR lastUpdated: '2026-06-14T00:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/funds/fiagro/portfolio ------------------------------------- Retorna a carteira FIAGRO do mês selecionado em seções como resumo, alocações, passivos e investidores. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/funds/fiagro/portfolio Single endpoint documentation for /api/v2/funds/fiagro/portfolio ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/funds/fiagro/portfolio **Summary:** Carteira e alocação FIAGRO Retorna resumo de patrimônio, alocações, investidores e passivos do FIAGRO. **Tags:** Fundos ### Parameters - **symbols** (query) - **cnpjs** (query) - **referenceDate** (query) - **allVersions** (query) - **include** (query) ### Responses #### 200 Carteiras FIAGRO **Example Response:** ```json { "funds": [ { "symbol": "XPCA11", "cnpj": "41269527000101", "referenceDate": "2026-05-01T00:00:00.000Z", "summary": { "netEquity": 487325339.56, "totalAssets": 492323571.36, "totalInvested": 460334438.28, "liquidityNeeds": null, "totalLiabilities": 4998231.8 }, "allocations": { "cpr": 0, "cra": 299574550.49, "fii": 0, "fip": 10045714.33, "lca": 0, "lci": 0, "cdca": 0, "fidc": 99610927.4, "fiagro": 42988149.25, "ruralRealEstate": 0 }, "investors": { "total": 94254, "individuals": 94165, "nonResidents": 6, "financialCompanies": 0, "nonFinancialCompanies": 79 }, "liabilities": { "adminFeesPayable": 354189.17, "totalLiabilities": 4998231.8, "incomeToDistribute": 4567754.46 } } ], "requestedAt": "2026-06-22T02:10:57.586Z", "took": 146 } ``` #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FiagroPortfolio **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **referenceDate** (string) *(required)* - **summary** (object) *(nullable)* *(required)* - **allocations** (object) *(nullable)* *(required)* - **investors** (object) *(nullable)* *(required)* - **liabilities** (object) *(nullable)* *(required)* # Relatórios FIAGRO URL: /docs/fundos/fiagro-relatorios.mdx Relatórios mensais FIAGRO da CVM por símbolo ou CNPJ. *** title: Relatórios FIAGRO description: Relatórios mensais FIAGRO da CVM por símbolo ou CNPJ. full: true keywords: brapi, FIAGRO, relatórios, CVM, XPCA11, CRAA11 openGraph: title: Relatórios FIAGRO description: Dados mensais FIAGRO com patrimônio, valor da cota, cotistas e rendimento. type: website locale: pt\_BR lastUpdated: '2026-06-14T00:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/funds/fiagro/reports ----------------------------------- Consulta relatórios mensais FIAGRO com patrimônio, valor patrimonial por cota, cotistas, rendimento e campos de agro/crédito. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/funds/fiagro/reports Single endpoint documentation for /api/v2/funds/fiagro/reports ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/funds/fiagro/reports **Summary:** Relatórios mensais FIAGRO Retorna relatórios mensais FIAGRO com patrimônio, cotistas, rentabilidade e valores a distribuir. **Tags:** Fundos ### Parameters - **symbols** (query) - **cnpjs** (query) - **startDate** (query) - **endDate** (query) - **page** (query) - **limit** (query) - **sortBy** (query) - **sortOrder** (query) - **allVersions** (query) ### Responses #### 200 Relatórios FIAGRO **Example Response:** ```json { "reports": [ { "symbol": "XPCA11", "cnpj": "41269527000101", "name": "XP CRÉDITO AGRÍCOLA-FUNDO DE INVESTIMENTO NAS CADEIAS PROD", "referenceDate": "2026-05-01T00:00:00.000Z", "version": 1, "isin": "BRXPCACTF004", "market": "BOLSA", "administratorName": "XP INVESTIMENTOS CORRETORA DE CÂMBIO, TÍTULOS E VAL MOB S/A", "managerName": "XP VISTA ASSET MANAGEMENT LTDA.", "totalAssets": 492323580, "netEquity": 487325340, "sharesOutstanding": 45523076, "navPerShare": 10.71, "totalInvestors": 94254, "monthlyReturn": 0.11, "patrimonialMonthlyReturn": -0.92, "dividendYieldMonthly": 1.03, "amortizationRateMonthly": 0, "liquidityNeeds": null, "incomeToDistribute": 4567754.5, "totalLiabilities": 4998232 } ], "pagination": { "page": 1, "limit": 20, "totalItems": 5, "totalPages": 1, "hasNextPage": false }, "requestedAt": "2026-06-22T02:10:57.433Z", "took": 293 } ``` #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FiagroReport **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **name** (string) *(nullable)* *(required)* - **referenceDate** (string) *(required)* - **version** (number) *(required)* - **isin** (string) *(nullable)* *(required)* - **market** (string) *(nullable)* *(required)* - **administratorName** (string) *(nullable)* *(required)* - **managerName** (string) *(nullable)* *(required)* - **totalAssets** (number) *(nullable)* *(required)* - **netEquity** (number) *(nullable)* *(required)* - **sharesOutstanding** (number) *(nullable)* *(required)* - **navPerShare** (number) *(nullable)* *(required)* - **totalInvestors** (number) *(nullable)* *(required)* - **monthlyReturn** (number) *(nullable)* *(required)* - **patrimonialMonthlyReturn** (number) *(nullable)* *(required)* - **dividendYieldMonthly** (number) *(nullable)* *(required)* - **amortizationRateMonthly** (number) *(nullable)* *(required)* - **liquidityNeeds** (number) *(nullable)* *(required)* - **incomeToDistribute** (number) *(nullable)* *(required)* - **totalLiabilities** (number) *(nullable)* *(required)* ### FundPaginationMeta **Properties:** - **page** (number) *(required)* - **limit** (number) *(required)* - **totalItems** (number) *(required)* - **totalPages** (number) *(required)* - **hasNextPage** (boolean) *(required)* # Carteira FIDC URL: /docs/fundos/fidc-carteira.mdx Setores, vencimentos, inadimplência, risco, cotas e cotistas. *** title: Carteira FIDC description: Setores, vencimentos, inadimplência, risco, cotas e cotistas. full: true keywords: brapi, FIDC, carteira, risco, cotas, inadimplência openGraph: title: Carteira FIDC description: Seções agrupadas do relatório mensal FIDC. type: website locale: pt\_BR lastUpdated: '2026-06-14T00:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/funds/fidc/portfolio ----------------------------------- Retorna a carteira FIDC em seções prontas para análise de crédito estruturado: setores, vencimentos, inadimplência, risco, cotas, cotistas e cedentes. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/funds/fidc/portfolio Single endpoint documentation for /api/v2/funds/fidc/portfolio ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/funds/fidc/portfolio **Summary:** Carteira, risco e cotistas FIDC Retorna carteira, vencimentos, inadimplência, risco, cotistas e cedentes do FIDC. **Tags:** Fundos ### Parameters - **symbols** (query) - **cnpjs** (query) - **referenceDate** (query) - **include** (query) ### Responses #### 200 Carteira FIDC **Example Response:** ```json { "funds": [ { "symbol": null, "cnpj": "05754060000113", "referenceDate": "2026-05-31T00:00:00.000Z", "sectors": { "brand": 0, "finance": 0, "commerce": 0, "industry": 0, "judicial": 0, "services": 1265864074.47, "factoring": 0, "realEstate": 0, "agribusiness": 0, "creditRights": 0, "publicSector": 0 }, "maturityBuckets": { "upTo30Days": 695649558.05, "upTo60Days": 570214516.42, "upTo90Days": 0, "upTo120Days": 0, "upTo150Days": 0, "upTo180Days": 0, "upTo360Days": 0, "upTo720Days": 0, "over1080Days": 0, "upTo1080Days": 0 }, "delinquencyBuckets": { "upTo30Days": 0, "upTo60Days": 0, "upTo90Days": 0, "upTo120Days": 0, "upTo150Days": 0, "upTo180Days": 0, "upTo360Days": 0, "upTo720Days": 0, "over1080Days": 0, "upTo1080Days": 0 }, "riskBuckets": { "debtorA": 0, "debtorB": 0, "debtorC": 0, "debtorD": 0, "debtorE": 0, "debtorF": 0, "debtorG": 0, "debtorH": 0, "debtorAA": 1265864074.47 }, "quotaClasses": [ { "investors": 1, "quotaCount": 27809423.4357832, "quotaValue": 59.0682179, "classOrSeries": "Subclasse Senior Subclasse 1" } ], "investors": { "seniorPf": 0, "subordinatedPf": 0, "seniorNonResident": 1, "subordinatedNonResident": 0, "seniorFinancialInstitution": 0, "subordinatedFinancialInstitution": 0 }, "cedentes": { "top1Cnpj": "61064911000177", "top2Cnpj": "61064911001734", "top1Percent": 65.78, "top2Percent": 11.29 } } ], "requestedAt": "2026-06-22T02:10:58.032Z", "took": 145 } ``` #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FidcPortfolio **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **referenceDate** (string) *(required)* - **sectors** (object) *(nullable)* *(required)* - **maturityBuckets** (object) *(nullable)* *(required)* - **delinquencyBuckets** (object) *(nullable)* *(required)* - **riskBuckets** (object) *(nullable)* *(required)* - **quotaClasses** (array) *(nullable)* *(required)* Array items: - **investors** (object) *(nullable)* *(required)* - **cedentes** (object) *(nullable)* *(required)* # Relatórios FIDC URL: /docs/fundos/fidc-relatorios.mdx Relatórios mensais FIDC CVM por CNPJ e símbolo quando houver mapeamento. *** title: Relatórios FIDC description: Relatórios mensais FIDC CVM por CNPJ e símbolo quando houver mapeamento. full: true keywords: brapi, FIDC, relatórios, CVM, crédito estruturado openGraph: title: Relatórios FIDC description: Dados mensais FIDC com ativos, carteira, PL e administrador. type: website locale: pt\_BR lastUpdated: '2026-06-14T00:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/funds/fidc/reports --------------------------------- Use `cnpjs` como identificador principal para FIDCs. `symbols` também funciona quando o fundo tem ticker mapeado na base da brapi. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/funds/fidc/reports Single endpoint documentation for /api/v2/funds/fidc/reports ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/funds/fidc/reports **Summary:** Relatórios mensais FIDC Retorna relatórios mensais FIDC com ativos, carteira, patrimônio líquido, classe e condomínio. **Tags:** Fundos ### Parameters - **symbols** (query) - **cnpjs** (query) - **startDate** (query) - **endDate** (query) - **page** (query) - **limit** (query) - **sortBy** (query) - **sortOrder** (query) ### Responses #### 200 Relatórios FIDC **Example Response:** ```json { "reports": [ { "symbol": null, "cnpj": "05754060000113", "name": "CATERPILLAR FUNDO DE INVESTIMENTO EM DIREITOS CREDITÓRIOS DO SEGMENTO INDUSTRIAL II - RESP LIMITADA", "referenceDate": "2026-05-31T00:00:00.000Z", "administratorName": "BEM - DISTRIBUIDORA DE TITULOS E VALORES MOBILIARIOS LTDA.", "class": null, "condominiumType": "ABERTO", "assets": 1642889200, "portfolioValue": 1642755000, "netEquity": 1642653000, "averageNetEquity": 1620125200, "liabilities": 236119.5 } ], "pagination": { "page": 1, "limit": 20, "totalItems": 5, "totalPages": 1, "hasNextPage": false }, "requestedAt": "2026-06-22T02:10:57.882Z", "took": 292 } ``` #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FidcReport **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **name** (string) *(nullable)* *(required)* - **referenceDate** (string) *(required)* - **administratorName** (string) *(nullable)* *(required)* - **class** (string) *(nullable)* *(required)* - **condominiumType** (string) *(nullable)* *(required)* - **assets** (number) *(nullable)* *(required)* - **portfolioValue** (number) *(nullable)* *(required)* - **netEquity** (number) *(nullable)* *(required)* - **averageNetEquity** (number) *(nullable)* *(required)* - **liabilities** (number) *(nullable)* *(required)* ### FundPaginationMeta **Properties:** - **page** (number) *(required)* - **limit** (number) *(required)* - **totalItems** (number) *(required)* - **totalPages** (number) *(required)* - **hasNextPage** (boolean) *(required)* # Relatórios FIP URL: /docs/fundos/fip-relatorios.mdx Relatórios estruturados FIP trimestrais e quadrimestrais da CVM. *** title: Relatórios FIP description: Relatórios estruturados FIP trimestrais e quadrimestrais da CVM. full: true keywords: brapi, FIP, relatórios, trimestral, quadrimestral openGraph: title: Relatórios FIP description: Relatórios FIP por CNPJ e tipo de documento. type: website locale: pt\_BR lastUpdated: '2026-06-14T00:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/funds/fip/reports -------------------------------- Consulta relatórios FIP por CNPJ, com suporte a `reportType=trimestral` ou `reportType=quadrimestral`. `symbols` também funciona quando o fundo tem ticker mapeado na base da brapi. A resposta organiza capital, cotas, classe e composição de investidores em campos prontos para uso. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/funds/fip/reports Single endpoint documentation for /api/v2/funds/fip/reports ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/funds/fip/reports **Summary:** Relatórios estruturados FIP Retorna relatórios trimestrais e quadrimestrais FIP com patrimônio, capital, cotas e composição de investidores em campos normalizados. **Tags:** Fundos ### Parameters - **symbols** (query) - **cnpjs** (query) - **startDate** (query) - **endDate** (query) - **page** (query) - **limit** (query) - **sortBy** (query) - **sortOrder** (query) - **reportType** (query) ### Responses #### 200 Relatórios FIP **Example Response:** ```json { "reports": [ { "symbol": null, "cnpj": "06033235000166", "name": "CRT FIP - MULTIESTRATÉGIA", "reportType": "quadrimestral", "referenceDate": "2026-04-30T00:00:00.000Z", "netEquity": 28866473.76, "targetAudience": "Investidores qualificados", "isInvestmentEntity": true, "investedInOtherFips": 0, "capital": { "committed": 13162950.24, "subscribed": 13162950.24, "paidIn": 13162950.24 }, "quotas": { "subscribed": 103, "paidIn": 13162950.24 }, "quotaClass": { "name": "1", "fundType": "CLASSES - FIP", "subscribedQuotas": 103, "paidInQuotas": 103, "quotaValue": 280257.02679611, "investors": 1, "hasDistinctEconomicRights": false, "hasSpecialPoliticalRights": false }, "investorComposition": { "totalInvestors": 1, "totalSubscribedQuotaPercent": 100, "byType": { "closedPensionFunds": { "investors": 1, "subscribedQuotaPercent": 100 } } } } ], "pagination": { "page": 1, "limit": 20, "totalItems": 1, "totalPages": 1, "hasNextPage": false }, "requestedAt": "2026-06-22T02:10:58.323Z", "took": 288 } ``` #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FipReport **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **name** (string) *(nullable)* *(required)* - **reportType** (string) - Options: `trimestral`, `quadrimestral` *(required)* - **referenceDate** (string) *(required)* - **netEquity** (number) *(nullable)* *(required)* - **targetAudience** (string) *(nullable)* *(required)* - **isInvestmentEntity** (boolean) *(nullable)* *(required)* - **investedInOtherFips** (number) *(nullable)* *(required)* - **capital** (object) *(nullable)* *(required)* **Properties:** - **committed** (number) *(nullable)* *(required)* - **subscribed** (number) *(nullable)* *(required)* - **paidIn** (number) *(nullable)* *(required)* - **quotas** (object) *(nullable)* *(required)* **Properties:** - **subscribed** (number) *(nullable)* *(required)* - **paidIn** (number) *(nullable)* *(required)* - **quotaClass** (object) *(nullable)* *(required)* **Properties:** - **name** (string) *(nullable)* *(required)* - **fundType** (string) *(nullable)* *(required)* - **subscribedQuotas** (number) *(nullable)* *(required)* - **paidInQuotas** (number) *(nullable)* *(required)* - **quotaValue** (number) *(nullable)* *(required)* - **investors** (number) *(nullable)* *(required)* - **hasDistinctEconomicRights** (boolean) *(nullable)* *(required)* - **hasSpecialPoliticalRights** (boolean) *(nullable)* *(required)* - **investorComposition** (object) *(nullable)* *(required)* **Properties:** - **totalInvestors** (number) *(nullable)* *(required)* - **totalSubscribedQuotaPercent** (number) *(nullable)* *(required)* - **byType** (object) *(required)* **Properties:** - **individuals** (object) **Properties:** - **investors** (number) *(nullable)* *(required)* - **subscribedQuotaPercent** (number) *(nullable)* *(required)* - **investmentFunds** (object) **Properties:** - **investors** (number) *(nullable)* *(required)* - **subscribedQuotaPercent** (number) *(nullable)* *(required)* - **realEstateFunds** (object) **Properties:** - **investors** (number) *(nullable)* *(required)* - **subscribedQuotaPercent** (number) *(nullable)* *(required)* - **openPensionFunds** (object) **Properties:** - **investors** (number) *(nullable)* *(required)* - **subscribedQuotaPercent** (number) *(nullable)* *(required)* - **closedPensionFunds** (object) **Properties:** - **investors** (number) *(nullable)* *(required)* - **subscribedQuotaPercent** (number) *(nullable)* *(required)* - **publicPensionFunds** (object) **Properties:** - **investors** (number) *(nullable)* *(required)* - **subscribedQuotaPercent** (number) *(nullable)* *(required)* - **commercialBanks** (object) **Properties:** - **investors** (number) *(nullable)* *(required)* - **subscribedQuotaPercent** (number) *(nullable)* *(required)* - **nonResidents** (object) **Properties:** - **investors** (number) *(nullable)* *(required)* - **subscribedQuotaPercent** (number) *(nullable)* *(required)* - **otherInvestors** (object) **Properties:** - **investors** (number) *(nullable)* *(required)* - **subscribedQuotaPercent** (number) *(nullable)* *(required)* - **insuranceCompanies** (object) **Properties:** - **investors** (number) *(nullable)* *(required)* - **subscribedQuotaPercent** (number) *(nullable)* *(required)* - **fundDistributors** (object) **Properties:** - **investors** (number) *(nullable)* *(required)* - **subscribedQuotaPercent** (number) *(nullable)* *(required)* - **capitalizationAndLeasingCompanies** (object) **Properties:** - **investors** (number) *(nullable)* *(required)* - **subscribedQuotaPercent** (number) *(nullable)* *(required)* - **financialCompanies** (object) **Properties:** - **investors** (number) *(nullable)* *(required)* - **subscribedQuotaPercent** (number) *(nullable)* *(required)* - **nonFinancialCompanies** (object) **Properties:** - **investors** (number) *(nullable)* *(required)* - **subscribedQuotaPercent** (number) *(nullable)* *(required)* - **brokersAndDistributors** (object) **Properties:** - **investors** (number) *(nullable)* *(required)* - **subscribedQuotaPercent** (number) *(nullable)* *(required)* ### FundPaginationMeta **Properties:** - **page** (number) *(required)* - **limit** (number) *(required)* - **totalItems** (number) *(required)* - **totalPages** (number) *(required)* - **hasNextPage** (boolean) *(required)* # Fundos URL: /docs/fundos.mdx Descubra e consulte fundos brasileiros listados e estruturados: FIIs, FIAGROs, FI-Infra/FIFs, FIDCs e FIPs. *** title: Fundos description: >- Descubra e consulte fundos brasileiros listados e estruturados: FIIs, FIAGROs, FI-Infra/FIFs, FIDCs e FIPs. full: true keywords: brapi, fundos, FIAGRO, FI-Infra, FIF, FIDC, FIP, CNPJ openGraph: title: Fundos description: Identidade, indicadores, valor da cota, carteira e relatórios de fundos brasileiros. type: website locale: pt\_BR lastUpdated: '2026-06-14T00:00:00.000Z' lang: pt-BR ----------- import { Callout } from 'fumadocs-ui/components/callout'; import { Cards, Card } from 'fumadocs-ui/components/card'; Use `/api/v2/funds/*` para consultar fundos brasileiros fora do fluxo de ações: FIAGROs, FI-Infra/FIFs, FIDCs, FIPs e outros fundos estruturados. A API aceita `symbols` para fundos listados e `cnpjs` para fundos em que o CNPJ é o melhor identificador. Para FIIs tradicionais, use `/api/v2/fii/*`. Para FIAGRO, FI-Infra/FIF, FIDC e FIP, use os endpoints desta seção. Identidade canônica por símbolo, CNPJ, ISIN e tipo de fundo. Preço de mercado, valor patrimonial por cota, patrimônio, ativos e cotistas. Série diária oficial CVM FI/FIF, separada do preço de mercado. Posições CVM CDA agrupadas em seções úteis. Eventos oficiais com datas exatas para fundos listados não-FII. ## Fluxo recomendado Comece pela listagem para resolver símbolo, CNPJ e tipo de fundo. Depois use o endpoint específico para indicadores, valor da cota, carteira ou relatórios. ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/funds/list?symbols=JURO11,XPCA11" curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/funds/indicators?symbols=JURO11" curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/funds/fiagro/reports?symbols=XPCA11&startDate=2026-01-01" ``` * Use `/api/v2/funds/list` para descobrir se o ativo é FII, FIAGRO, FI-Infra/FIF, FIDC ou FIP. * Use `/api/v2/funds/indicators` e `/api/v2/funds/nav/history` para FI-Infra/FIF, onde valor patrimonial por cota e preço de mercado são dados diferentes. * Use `/api/v2/funds/dividends` quando precisar de rendimentos/amortizações oficiais de FIAGRO, FI-Infra/FIF, FIDC ou FIP listados com data-com/ex e data de pagamento. * Para FIDCs, `/api/v2/funds/nav/history?cnpjs=...` retorna valor da cota e rentabilidade mensal por classe ou série. * Use endpoints específicos como `/api/v2/funds/fiagro/reports`, `/api/v2/funds/fidc/reports` e `/api/v2/funds/fip/reports` para relatórios CVM. * Use `/api/v2/fii/*` quando o produto é um FII tradicional e você precisa de imóveis, vacância, informes mensais, DFIN, informes anuais ou dividendos. # Indicadores de Fundos URL: /docs/fundos/indicadores.mdx Consulte preço, valor patrimonial por cota, patrimônio, ativos e cotistas. *** title: Indicadores de Fundos description: Consulte preço, valor patrimonial por cota, patrimônio, ativos e cotistas. full: true keywords: brapi, fundos, indicadores, valor patrimonial, preço, JURO11 openGraph: title: Indicadores de Fundos description: Indicadores atuais para FIIs, FIAGROs e FI-Infra/FIFs. type: website locale: pt\_BR lastUpdated: '2026-06-14T00:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/funds/indicators ------------------------------- Retorna indicadores atuais como preço de mercado, valor patrimonial por cota, relação entre preço e valor patrimonial, patrimônio, ativos e cotistas. O preço de mercado e o valor patrimonial por cota (`navPerShare`) são campos separados. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/funds/indicators Single endpoint documentation for /api/v2/funds/indicators ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/funds/indicators **Summary:** Indicadores atuais de fundos Retorna indicadores atuais para fundos específicos. Use `/api/v2/funds/list` para descobrir fundos antes de consultar indicadores. **Tags:** Fundos ### Parameters - **symbols** (query) - **cnpjs** (query) - **assetType** (query) ### Responses #### 200 Indicadores **Example Response:** ```json { "funds": [ { "symbol": "JURO11", "cnpj": "42730834000100", "name": "SPARTA INFRA", "assetType": "fiinfra", "asOfDate": "2026-06-18T00:00:00.000Z", "price": 96.99, "navPerShare": 99.19945, "priceToNav": 0.9777272, "equity": 2040699000, "totalAssets": 2041704100, "totalInvestors": 92710, "dailyApplications": 0, "dailyRedemptions": 0, "sharesOutstanding": null, "monthlyReturn": null, "patrimonialMonthlyReturn": null, "dividendYieldMonthly": null } ], "requestedAt": "2026-06-22T02:10:56.524Z", "took": 189 } ``` #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FundIndicator **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **name** (string) *(nullable)* *(required)* - **assetType** (string) - Options: `fii`, `fiagro`, `fiinfra`, `fif`, `fidc`, `fip`, `etf`, `other` *(required)* - **price** (number) *(nullable)* *(required)* - **navPerShare** (number) *(nullable)* *(required)* - **priceToNav** (number) *(nullable)* *(required)* - **equity** (number) *(nullable)* *(required)* - **totalAssets** (number) *(nullable)* *(required)* - **totalInvestors** (number) *(nullable)* *(required)* - **asOfDate** (string) *(nullable)* *(required)* - **dailyApplications** (number) *(nullable)* *(required)* - **dailyRedemptions** (number) *(nullable)* *(required)* - **sharesOutstanding** (number) *(nullable)* *(required)* - **monthlyReturn** (number) *(nullable)* *(required)* - **patrimonialMonthlyReturn** (number) *(nullable)* *(required)* - **dividendYieldMonthly** (number) *(nullable)* *(required)* # Listagem de Fundos URL: /docs/fundos/listagem.mdx Liste fundos por símbolo, CNPJ, busca textual, tipo e status. *** title: Listagem de Fundos description: Liste fundos por símbolo, CNPJ, busca textual, tipo e status. full: true keywords: brapi, fundos, listagem, FIAGRO, FI-Infra, FIDC, FIP openGraph: title: Listagem de Fundos description: Descubra FIIs, FIAGROs, FI-Infra/FIFs, FIDCs e FIPs. type: website locale: pt\_BR lastUpdated: '2026-06-14T00:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/funds/list ------------------------- import { Callout } from 'fumadocs-ui/components/callout'; Lista fundos brasileiros com `symbol`, `cnpj`, `assetType`, nomes, classificações CVM/B3, administradores e indicadores atuais. Use `/api/v2/funds/list?symbols=JURO11` para consultar um fundo listado, `/api/v2/funds/list?assetType=fiagro` para filtrar FIAGROs e `cnpjs` para fundos sem ticker B3. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/funds/list Single endpoint documentation for /api/v2/funds/list ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/funds/list **Summary:** Lista fundos brasileiros por símbolo, CNPJ, busca e tipo Descobre FIIs, FIAGROs, FI-Infra/FIFs, FIDCs, FIPs e outros fundos a partir da identidade canônica de fundos. **Tags:** Fundos ### Parameters - **symbols** (query) - **cnpjs** (query) - **page** (query) - **limit** (query) - **sortBy** (query) - **sortOrder** (query) - **search** (query) - **assetType** (query) - **status** (query) ### Responses #### 200 Fundos encontrados **Example Response:** ```json { "funds": [ { "symbol": "JURO11", "cnpj": "42730834000100", "formattedCnpj": "42.730.834/0001-00", "name": "SPARTA INFRA", "legalName": "SPARTA INFRA FIC FI INFRA RENDA FIXA CP", "assetType": "fiinfra", "cvmClassType": null, "cvmClassification": null, "anbimaClassification": null, "b3Classification": "Financeiro/Fundos/FI-INFRA", "isin": null, "administratorName": null, "administratorCnpj": null, "managerName": null, "managerCnpj": null, "status": null, "price": 96.99, "navPerShare": 99.19945, "priceToNav": 0.9777272, "equity": 2040699000, "totalAssets": 2041704100, "totalInvestors": 92710, "updatedAt": "2026-06-21T21:06:37.434Z" } ], "pagination": { "page": 1, "limit": 20, "totalItems": 1, "totalPages": 1, "hasNextPage": false }, "requestedAt": "2026-06-22T02:10:56.319Z", "took": 902 } ``` #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FundListItem **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **formattedCnpj** (string) *(nullable)* *(required)* - **name** (string) *(nullable)* *(required)* - **legalName** (string) *(nullable)* *(required)* - **assetType** (string) - Options: `fii`, `fiagro`, `fiinfra`, `fif`, `fidc`, `fip`, `etf`, `other` *(required)* - **cvmClassType** (string) *(nullable)* *(required)* - **cvmClassification** (string) *(nullable)* *(required)* - **anbimaClassification** (string) *(nullable)* *(required)* - **b3Classification** (string) *(nullable)* *(required)* - **isin** (string) *(nullable)* *(required)* - **administratorName** (string) *(nullable)* *(required)* - **administratorCnpj** (string) *(nullable)* *(required)* - **managerName** (string) *(nullable)* *(required)* - **managerCnpj** (string) *(nullable)* *(required)* - **status** (string) *(nullable)* *(required)* - **price** (number) *(nullable)* *(required)* - **navPerShare** (number) *(nullable)* *(required)* - **priceToNav** (number) *(nullable)* *(required)* - **equity** (number) *(nullable)* *(required)* - **totalAssets** (number) *(nullable)* *(required)* - **totalInvestors** (number) *(nullable)* *(required)* - **updatedAt** (string) *(nullable)* *(required)* ### FundPaginationMeta **Properties:** - **page** (number) *(required)* - **limit** (number) *(required)* - **totalItems** (number) *(required)* - **totalPages** (number) *(required)* - **hasNextPage** (boolean) *(required)* # Histórico do Valor da Cota URL: /docs/fundos/nav-historico.mdx Série diária ou mensal do valor patrimonial por cota, patrimônio, ativos, cotistas e rentabilidade. *** title: Histórico do Valor da Cota description: Série diária ou mensal do valor patrimonial por cota, patrimônio, ativos, cotistas e rentabilidade. full: true keywords: brapi, fundos, valor da cota, valor patrimonial, histórico, FI-Infra, FIF openGraph: title: Histórico do Valor da Cota description: Histórico do valor patrimonial por cota separado do preço de mercado. type: website locale: pt\_BR lastUpdated: '2026-06-14T00:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/funds/nav/history -------------------------------- Use este endpoint para acompanhar o valor patrimonial por cota, o patrimônio, os ativos e o número de cotistas ao longo do tempo. FI/FIF retornam informes diários. FIDCs retornam informes mensais por classe ou série, com a rentabilidade mensal oficial da CVM em `monthlyReturn`. Para preços negociados no mercado, use os endpoints de histórico de preços. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/funds/nav/history Single endpoint documentation for /api/v2/funds/nav/history ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/funds/nav/history **Summary:** Histórico do valor patrimonial por cota Retorna a série do valor patrimonial por cota para fundos. FI/FIF usam informes diários; FIDCs usam informes mensais por classe ou série, incluindo a rentabilidade mensal oficial. **Tags:** Fundos ### Parameters - **symbols** (query) - **cnpjs** (query) - **startDate** (query) - **endDate** (query) - **page** (query) - **limit** (query) - **sortOrder** (query) ### Responses #### 200 Histórico do valor da cota **Example Response:** ```json { "history": [ { "symbol": "JURO11", "cnpj": "42730834000100", "date": "2026-06-18T00:00:00.000Z", "classOrSeries": null, "totalAssets": 2041704100, "navPerShare": 99.19945, "equity": 2040699000, "dailyApplications": 0, "dailyRedemptions": 0, "totalInvestors": 92710, "monthlyReturn": null }, { "symbol": "JURO11", "cnpj": "42730834000100", "date": "2026-06-17T00:00:00.000Z", "classOrSeries": null, "totalAssets": 2044940400, "navPerShare": 99.36075, "equity": 2044017200, "dailyApplications": 0, "dailyRedemptions": 0, "totalInvestors": 92779, "monthlyReturn": null } ], "pagination": { "page": 1, "limit": 20, "totalItems": 114, "totalPages": 6, "hasNextPage": true }, "requestedAt": "2026-06-22T02:10:56.827Z", "took": 300 } ``` #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FundNavHistory **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **date** (string) *(required)* - **classOrSeries** (string) *(nullable)* *(required)* - **totalAssets** (number) *(nullable)* *(required)* - **navPerShare** (number) *(nullable)* *(required)* - **equity** (number) *(nullable)* *(required)* - **dailyApplications** (number) *(nullable)* *(required)* - **dailyRedemptions** (number) *(nullable)* *(required)* - **totalInvestors** (number) *(nullable)* *(required)* - **monthlyReturn** (number) *(nullable)* *(required)* ### FundPaginationMeta **Properties:** - **page** (number) *(required)* - **limit** (number) *(required)* - **totalItems** (number) *(required)* - **totalPages** (number) *(required)* - **hasNextPage** (boolean) *(required)* # Perfil de Fundos URL: /docs/fundos/perfil.mdx Perfil mensal CVM FI/FIF com investidores, risco e liquidez. *** title: Perfil de Fundos description: Perfil mensal CVM FI/FIF com investidores, risco e liquidez. full: true keywords: brapi, fundos, perfil, risco, liquidez, cotistas openGraph: title: Perfil de Fundos description: Perfil mensal CVM FI/FIF em seções normalizadas. type: website locale: pt\_BR lastUpdated: '2026-06-14T00:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/funds/profile ---------------------------- Retorna o perfil mensal do fundo em seções prontas para uso: distribuição de cotistas, risco, liquidez, concentração e exposição a crédito privado. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/funds/profile Single endpoint documentation for /api/v2/funds/profile ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/funds/profile **Summary:** Perfil mensal CVM FI/FIF Retorna perfil mensal de investidores, risco, liquidez, concentração e crédito privado. **Tags:** Fundos ### Parameters - **symbols** (query) - **cnpjs** (query) - **startDate** (query) - **endDate** (query) - **referenceDate** (query) - **include** (query) ### Responses #### 200 Perfis **Example Response:** ```json { "profiles": [ { "symbol": "JURO11", "cnpj": "42730834000100", "referenceDate": "2026-05-31T00:00:00.000Z", "investorBreakdown": { "other": 0, "fundsOrClubs": 1, "nonResidents": 0, "otherPercent": 0, "legalEntities": 0, "individualRetail": 0, "fundsOrClubsPercent": 100, "nonResidentsPercent": 0, "legalEntitiesPercent": 0, "individualRetailPercent": 0 }, "risk": { "riskModel": "Modelos Não-Paramétricos", "portfolioVar": 0, "dailyQuotaVariationPercent": 0, "privateCreditExposurePercent": 0, "stressedDailyQuotaVariationPercent": 0 }, "liquidity": null, "concentration": { "topCotistaPercent": 0 }, "privateCredit": { "exposurePercent": 0 } } ], "requestedAt": "2026-06-22T02:10:56.983Z", "took": 152 } ``` #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FundProfile **Properties:** - **symbol** (string) *(nullable)* *(required)* - **cnpj** (string) *(required)* - **referenceDate** (string) *(required)* - **investorBreakdown** (object) *(nullable)* *(required)* - **risk** (object) *(nullable)* *(required)* - **liquidity** (object) *(nullable)* *(required)* - **concentration** (object) *(nullable)* *(required)* - **privateCredit** (object) *(nullable)* *(required)* # Cotação de Futuros URL: /docs/futuros/cotacao.mdx Cotação do dia (fim do pregão) para um ou mais contratos: OHLC, preço de ajuste, taxa de ajuste (DI/DAP), volume e número de negócios. *** title: Cotação de Futuros description: >- Cotação do dia (fim do pregão) para um ou mais contratos: OHLC, preço de ajuste, taxa de ajuste (DI/DAP), volume e número de negócios. full: true keywords: brapi, api, futuros, cotação, EOD, ajuste, settlement openGraph: title: Cotação de Futuros description: >- Cotação do dia para um ou mais contratos futuros. type: website locale: pt\_BR lastUpdated: '2026-05-21T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/futures/quote structuredData: headings: \[] contents: * content: >- Cotação do dia para um ou mais contratos futuros, com OHLC, preço de ajuste, taxa de ajuste, volume e número de negócios. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna a cotação do dia para os contratos pedidos, até **20 por requisição**. Cada cotação tem: * **OHLC** (`open`, `high`, `low`, `close`, `average`). Em contratos com pouca negociação, OHLC pode vir `null`, mas o ajuste segue preenchido. * **Preço de ajuste** (`settlement`): o preço oficial do dia. * **Taxa de ajuste** (`settlementRate`): só vem em DI e DAP. * **`oscillationPct`**: variação % em relação ao dia anterior. * **Volume**: `trades` (negócios), `volume` (contratos), `financialVolume` (em reais). Em DI e DAP, `close` vem em taxa (%a.a.) e `settlement` em reais. Veja `quotationType` na resposta para saber a unidade. **Plano Pro.** Sem token, aceita só `symbols=` começando com `WIN` ou `WDO`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/futures/quote Single endpoint documentation for /api/v2/futures/quote ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/futures/quote **Summary:** Cotação do dia Retorna a cotação do último pregão para os contratos pedidos. Máx. 20 símbolos por requisição. **Tags:** Futuros ### Parameters - **symbols** (query) *required* ### Responses #### 200 Cotações. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FutureQuote **Properties:** - **symbol** (string) *(required)* Código do contrato (ex.: `WINM26`, `BGIF27`, `DI1F27`). - **underlyingAsset** (string) *(required)* Código do ativo (ex.: `WIN`, `BGI`, `DI1`). - **assetDescription** (string) *(nullable)* *(required)* Nome do ativo em português. - **segment** (string) - Options: `financial`, `agribusiness` *(required)* `financial` = índices, juros e moeda. `agribusiness` = commodities. - **quotationType** (string) - Options: `price`, `rate` *(required)* `rate` para juros (DI/DAP) — OHLC vem em %a.a. `price` para os demais. - **expirationDate** (string) *(required)* Data de vencimento (YYYY-MM-DD). - **firstTradeDate** (string) *(nullable)* *(required)* Data do primeiro pregão. - **lastTradeDate** (string) *(nullable)* *(required)* Data do último pregão. - **contractMultiplier** (number) *(nullable)* *(required)* Quanto vale cada ponto. Ex.: WIN = 0,2; BGI = 330; DI1 = 1. - **allocationRoundLot** (integer) *(nullable)* *(required)* Tamanho do lote. - **tradingCurrency** (string) *(nullable)* *(required)* Moeda (quase sempre `BRL`). - **deliveryType** (string) *(nullable)* *(required)* Tipo de entrega: `Financial` ou `Physical`. - **exerciseType** (string) *(nullable)* *(required)* Tipo de cotação: `Price` ou `Rate`. - **isin** (string) *(nullable)* *(required)* Código ISIN. - **cficCode** (string) *(nullable)* *(required)* Código CFI. - **date** (integer) *(required)* Data do pregão (Unix em segundos). - **open** (number) *(nullable)* *(required)* Preço de abertura. Vem `null` — o arquivo do fim do dia não publica abertura. - **high** (number) *(nullable)* *(required)* Máxima do dia (taxa em %a.a. para DI; preço para os demais). - **low** (number) *(nullable)* *(required)* Mínima do dia (taxa em %a.a. para DI; preço para os demais). - **average** (number) *(nullable)* *(required)* Preço médio do dia. - **close** (number) *(nullable)* *(required)* Preço de fechamento (último negócio). Em DI e DAP, vem em %a.a. - **settlement** (number) *(nullable)* *(required)* Preço de ajuste oficial do dia. Em juros, vem em reais; nos demais, em preço. - **settlementRate** (number) *(nullable)* *(required)* Taxa de ajuste. Só vem em contratos de juros (DI, DAP). - **referencePrice** (number) *(nullable)* *(required)* Preço de referência oficial. - **oscillationPct** (number) *(nullable)* *(required)* Variação % em relação ao dia anterior. - **trades** (number) *(nullable)* *(required)* Número de negócios. - **volume** (number) *(nullable)* *(required)* Quantidade de contratos negociados. - **financialVolume** (number) *(nullable)* *(required)* Volume em reais (BRL). ### FutureQuoteResponse **Properties:** - **quotes** (array) *(required)* Array items: Reference to: **FutureQuote** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # Curva de Vencimentos URL: /docs/futuros/curva-de-vencimentos.mdx Todos os contratos do mesmo ativo, com o último ajuste por vencimento. Útil para curva de juros do DI, contratos de commodities ou mini Ibov. *** title: Curva de Vencimentos description: >- Todos os contratos do mesmo ativo, com o último ajuste por vencimento. Útil para curva de juros do DI, contratos de commodities ou mini Ibov. full: true keywords: brapi, api, futuros, curva, term structure, vencimento, DI, contango openGraph: title: Curva de Vencimentos de Futuros description: >- Todos os contratos do mesmo ativo com o último ajuste por vencimento. type: website locale: pt\_BR lastUpdated: '2026-05-21T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/futures/term-structure structuredData: headings: \[] contents: * content: >- Todos os contratos do mesmo ativo, com o último ajuste por vencimento. Útil para curva de juros, contratos de commodities ou mini Ibov. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna **todos os contratos do mesmo ativo**, ordenados pelo vencimento mais próximo. Cada contrato vem com a cotação do último pregão. Bons usos: * **Curva de juros do DI:** `asset=DI1` traz todos os vencimentos com a taxa de ajuste (`settlementRate`) por mês. * **Curva do mini Ibov:** `asset=WIN` mostra como o mercado precifica o índice para datas futuras. * **Preço de commodities ao longo do tempo:** `asset=BGI` (boi), `ICF` (café), `CCM` (milho) ou `SJC` (soja). Em contratos cotados em taxa (DI, DAP), use `close` e `settlementRate` para a curva de juros. Em contratos em preço (WIN, BGI etc.), use `close` ou `settlement`. **Plano Pro.** Sem token, aceita só `asset=WIN` ou `asset=WDO`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/futures/term-structure Single endpoint documentation for /api/v2/futures/term-structure ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/futures/term-structure **Summary:** Curva de vencimentos Retorna todos os contratos do mesmo ativo, com o último pregão de cada um, do vencimento mais próximo para o mais distante. **Tags:** Futuros ### Parameters - **asset** (query) *required* - **includeExpired** (query) ### Responses #### 200 Curva de vencimentos. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FutureQuote **Properties:** - **symbol** (string) *(required)* Código do contrato (ex.: `WINM26`, `BGIF27`, `DI1F27`). - **underlyingAsset** (string) *(required)* Código do ativo (ex.: `WIN`, `BGI`, `DI1`). - **assetDescription** (string) *(nullable)* *(required)* Nome do ativo em português. - **segment** (string) - Options: `financial`, `agribusiness` *(required)* `financial` = índices, juros e moeda. `agribusiness` = commodities. - **quotationType** (string) - Options: `price`, `rate` *(required)* `rate` para juros (DI/DAP) — OHLC vem em %a.a. `price` para os demais. - **expirationDate** (string) *(required)* Data de vencimento (YYYY-MM-DD). - **firstTradeDate** (string) *(nullable)* *(required)* Data do primeiro pregão. - **lastTradeDate** (string) *(nullable)* *(required)* Data do último pregão. - **contractMultiplier** (number) *(nullable)* *(required)* Quanto vale cada ponto. Ex.: WIN = 0,2; BGI = 330; DI1 = 1. - **allocationRoundLot** (integer) *(nullable)* *(required)* Tamanho do lote. - **tradingCurrency** (string) *(nullable)* *(required)* Moeda (quase sempre `BRL`). - **deliveryType** (string) *(nullable)* *(required)* Tipo de entrega: `Financial` ou `Physical`. - **exerciseType** (string) *(nullable)* *(required)* Tipo de cotação: `Price` ou `Rate`. - **isin** (string) *(nullable)* *(required)* Código ISIN. - **cficCode** (string) *(nullable)* *(required)* Código CFI. - **date** (integer) *(required)* Data do pregão (Unix em segundos). - **open** (number) *(nullable)* *(required)* Preço de abertura. Vem `null` — o arquivo do fim do dia não publica abertura. - **high** (number) *(nullable)* *(required)* Máxima do dia (taxa em %a.a. para DI; preço para os demais). - **low** (number) *(nullable)* *(required)* Mínima do dia (taxa em %a.a. para DI; preço para os demais). - **average** (number) *(nullable)* *(required)* Preço médio do dia. - **close** (number) *(nullable)* *(required)* Preço de fechamento (último negócio). Em DI e DAP, vem em %a.a. - **settlement** (number) *(nullable)* *(required)* Preço de ajuste oficial do dia. Em juros, vem em reais; nos demais, em preço. - **settlementRate** (number) *(nullable)* *(required)* Taxa de ajuste. Só vem em contratos de juros (DI, DAP). - **referencePrice** (number) *(nullable)* *(required)* Preço de referência oficial. - **oscillationPct** (number) *(nullable)* *(required)* Variação % em relação ao dia anterior. - **trades** (number) *(nullable)* *(required)* Número de negócios. - **volume** (number) *(nullable)* *(required)* Quantidade de contratos negociados. - **financialVolume** (number) *(nullable)* *(required)* Volume em reais (BRL). ### FutureTermStructureResponse **Properties:** - **asset** (string) *(required)* - **contracts** (array) *(required)* Array items: Reference to: **FutureQuote** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # Especificações de Futuros URL: /docs/futuros/especificacoes.mdx Dados do contrato (vencimento, multiplicador, lote, ISIN, CFI), sem preço. *** title: Especificações de Futuros description: >- Dados do contrato (vencimento, multiplicador, lote, ISIN, CFI), sem preço. full: true keywords: brapi, api, futuros, especificações, multiplicador, lote, ISIN openGraph: title: Especificações de Futuros description: >- Dados do contrato, sem preço. type: website locale: pt\_BR lastUpdated: '2026-05-21T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/futures/specs structuredData: headings: \[] contents: * content: >- Dados do contrato (vencimento, multiplicador, lote, ISIN, CFI), sem preço. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna só os **dados do contrato** — sem preço, volume ou ajuste. Use quando precisar só das características fixas (multiplicador, lote, vencimento). Campos: * `contractMultiplier`: quanto vale cada ponto. Ex.: `WIN = 0,2`, `WDO = 10`, `BGI = 330`. * `allocationRoundLot`: tamanho do lote (quase sempre `1`). * `expirationDate`, `firstTradeDate`, `lastTradeDate`: datas do contrato. * `quotationType`: `price` (maioria) ou `rate` (DI, DAP). * `isin`, `cficCode`: códigos padronizados. * `deliveryType`, `exerciseType`, `tradingCurrency`: regras de liquidação. * `companyName`: emissor, quando existir. Para a cotação do dia, use [`/api/v2/futures/quote`](/docs/futuros/cotacao). **Plano Pro.** Sem token, aceita só `symbols=` começando com `WIN` ou `WDO`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/futures/specs Single endpoint documentation for /api/v2/futures/specs ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/futures/specs **Summary:** Especificações do contrato Retorna só os dados do contrato (vencimento, multiplicador, lote, ISIN), sem preço. **Tags:** Futuros ### Parameters - **symbols** (query) *required* ### Responses #### 200 Especificações. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FutureSpecs **Properties:** - **symbol** (string) *(required)* Código do contrato (ex.: `WINM26`, `BGIF27`, `DI1F27`). - **underlyingAsset** (string) *(required)* Código do ativo (ex.: `WIN`, `BGI`, `DI1`). - **assetDescription** (string) *(nullable)* *(required)* Nome do ativo em português. - **segment** (string) - Options: `financial`, `agribusiness` *(required)* `financial` = índices, juros e moeda. `agribusiness` = commodities. - **quotationType** (string) - Options: `price`, `rate` *(required)* `rate` para juros (DI/DAP) — OHLC vem em %a.a. `price` para os demais. - **expirationDate** (string) *(required)* Data de vencimento (YYYY-MM-DD). - **firstTradeDate** (string) *(nullable)* *(required)* Data do primeiro pregão. - **lastTradeDate** (string) *(nullable)* *(required)* Data do último pregão. - **contractMultiplier** (number) *(nullable)* *(required)* Quanto vale cada ponto. Ex.: WIN = 0,2; BGI = 330; DI1 = 1. - **allocationRoundLot** (integer) *(nullable)* *(required)* Tamanho do lote. - **tradingCurrency** (string) *(nullable)* *(required)* Moeda (quase sempre `BRL`). - **deliveryType** (string) *(nullable)* *(required)* Tipo de entrega: `Financial` ou `Physical`. - **exerciseType** (string) *(nullable)* *(required)* Tipo de cotação: `Price` ou `Rate`. - **isin** (string) *(nullable)* *(required)* Código ISIN. - **cficCode** (string) *(nullable)* *(required)* Código CFI. ### FutureSpecsResponse **Properties:** - **specs** (array) *(required)* Array items: Reference to: **FutureSpecs** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # Histórico de Futuros URL: /docs/futuros/historico.mdx Série diária de um contrato futuro: OHLC, preço de ajuste, taxa de ajuste (DI/DAP), variação e volume. Pronto para gráfico ou backtest. *** title: Histórico de Futuros description: >- Série diária de um contrato futuro: OHLC, preço de ajuste, taxa de ajuste (DI/DAP), variação e volume. Pronto para gráfico ou backtest. full: true keywords: brapi, api, futuros, histórico, OHLC, ajuste, settlement, backtest openGraph: title: Histórico de Futuros description: >- Série diária de um contrato futuro, pronta para gráfico ou backtest. type: website locale: pt\_BR lastUpdated: '2026-05-21T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/futures/historical structuredData: headings: \[] contents: * content: >- Série diária de um contrato futuro identificado por `symbol`, pronta para gráfico ou backtest. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna a série diária de um contrato, pelo `symbol`. Para vários contratos de uma vez, use [`/api/v2/futures/quote`](/docs/futuros/cotacao) (até 20). Cada dia traz: * **OHLC** (`open`, `high`, `low`, `close`, `average`). * **Preço de ajuste** (`settlement`): o preço oficial do dia. * **Taxa de ajuste** (`settlementRate`): só em DI e DAP. * **`referencePrice`**: preço de referência oficial. * **`oscillationPct`**: variação % do dia anterior. * **Volume**: `trades`, `volume` (contratos), `financialVolume` (em reais). Em DI e DAP, `close` vem em taxa (%a.a.) e `settlement` em reais. Veja `quotationType` no nível do contrato — vale para a série toda. O campo `open` vem `null` em futuros — o arquivo do fim do dia não publica abertura. Em contratos com pouca negociação, OHLC pode vir todo `null`; nesses dias, `settlement` ainda vem preenchido. **Plano Pro.** Sem token, aceita só `symbol` começando com `WIN` ou `WDO`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/futures/historical Single endpoint documentation for /api/v2/futures/historical ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/futures/historical **Summary:** Histórico do contrato Série diária de um contrato, com OHLC, ajuste e taxa (em DI/DAP). **Tags:** Futuros ### Parameters - **symbol** (query) *required* - **startDate** (query) - **endDate** (query) - **sortOrder** (query) ### Responses #### 200 Histórico. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FutureHistoricalResponse **Properties:** - **future** *(required)* Reference to: **FutureWithHistory** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### FuturePricePoint **Properties:** - **date** (integer) *(required)* Data do pregão (Unix em segundos). - **open** (number) *(nullable)* *(required)* Preço de abertura. Vem `null` — o arquivo do fim do dia não publica abertura. - **high** (number) *(nullable)* *(required)* Máxima do dia (taxa em %a.a. para DI; preço para os demais). - **low** (number) *(nullable)* *(required)* Mínima do dia (taxa em %a.a. para DI; preço para os demais). - **average** (number) *(nullable)* *(required)* Preço médio do dia. - **close** (number) *(nullable)* *(required)* Preço de fechamento (último negócio). Em DI e DAP, vem em %a.a. - **settlement** (number) *(nullable)* *(required)* Preço de ajuste oficial do dia. Em juros, vem em reais; nos demais, em preço. - **settlementRate** (number) *(nullable)* *(required)* Taxa de ajuste. Só vem em contratos de juros (DI, DAP). - **referencePrice** (number) *(nullable)* *(required)* Preço de referência oficial. - **oscillationPct** (number) *(nullable)* *(required)* Variação % em relação ao dia anterior. - **trades** (number) *(nullable)* *(required)* Número de negócios. - **volume** (number) *(nullable)* *(required)* Quantidade de contratos negociados. - **financialVolume** (number) *(nullable)* *(required)* Volume em reais (BRL). ### FutureSpecs **Properties:** - **symbol** (string) *(required)* Código do contrato (ex.: `WINM26`, `BGIF27`, `DI1F27`). - **underlyingAsset** (string) *(required)* Código do ativo (ex.: `WIN`, `BGI`, `DI1`). - **assetDescription** (string) *(nullable)* *(required)* Nome do ativo em português. - **segment** (string) - Options: `financial`, `agribusiness` *(required)* `financial` = índices, juros e moeda. `agribusiness` = commodities. - **quotationType** (string) - Options: `price`, `rate` *(required)* `rate` para juros (DI/DAP) — OHLC vem em %a.a. `price` para os demais. - **expirationDate** (string) *(required)* Data de vencimento (YYYY-MM-DD). - **firstTradeDate** (string) *(nullable)* *(required)* Data do primeiro pregão. - **lastTradeDate** (string) *(nullable)* *(required)* Data do último pregão. - **contractMultiplier** (number) *(nullable)* *(required)* Quanto vale cada ponto. Ex.: WIN = 0,2; BGI = 330; DI1 = 1. - **allocationRoundLot** (integer) *(nullable)* *(required)* Tamanho do lote. - **tradingCurrency** (string) *(nullable)* *(required)* Moeda (quase sempre `BRL`). - **deliveryType** (string) *(nullable)* *(required)* Tipo de entrega: `Financial` ou `Physical`. - **exerciseType** (string) *(nullable)* *(required)* Tipo de cotação: `Price` ou `Rate`. - **isin** (string) *(nullable)* *(required)* Código ISIN. - **cficCode** (string) *(nullable)* *(required)* Código CFI. ### FutureWithHistory # Futuros URL: /docs/futuros.mdx Como usar a API de futuros da brapi (mini Ibov, mini Dolar, DI, boi, café, milho, soja). Veja os termos, o passo a passo e qual endpoint usar. *** title: Futuros description: >- Como usar a API de futuros da brapi (mini Ibov, mini Dolar, DI, boi, café, milho, soja). Veja os termos, o passo a passo e qual endpoint usar. full: true keywords: brapi, api, futuros, mini Ibovespa, mini Dolar, WIN, WDO, BGI, DI1, ICF, CCM, SJC, ajuste, settlement openGraph: title: Futuros description: >- Como usar a API de futuros da brapi, com passo a passo e exemplos. type: website locale: pt\_BR lastUpdated: '2026-05-21T12:00:00.000Z' lang: pt-BR ----------- import { Callout } from 'fumadocs-ui/components/callout'; import { Card, Cards } from 'fumadocs-ui/components/card'; import { Step, Steps } from 'fumadocs-ui/components/steps'; import { Tab, Tabs } from 'fumadocs-ui/components/tabs'; Use a API de futuros para consultar contratos listados na B3, montar curvas de vencimento, buscar preço de ajuste e baixar histórico diário. O caminho normal é: 1. escolha o **ativo** (ex.: `WIN`, `BGI`, `DI1`) 2. liste os **contratos** ou veja a **curva de vencimentos** 3. pegue a **cotação** ou as **especificações** de um contrato 4. baixe o **histórico** do contrato Dados EOD após o fechamento do pregão: abertura, máxima, mínima, fechamento, preço de ajuste, variação do dia, negócios, contratos e volume financeiro. Para DI e DAP, a resposta também traz a taxa de ajuste. ## Cobertura e atualização * **Histórico:** cerca de **1 ano**, atualizado todo dia após o pregão. * **Quando atualiza:** **após as 19h** (horário de Brasília). Antes disso, você vê os dados do pregão anterior. * **Contratos:** mini Ibov (`WIN`), Ibov (`IND`), mini dólar (`WDO`), dólar (`DOL`), DI (`DI1`), boi (`BGI`), café (`ICF`), milho (`CCM`), soja (`SJC`) e outros. * **Fuso horário:** `America/Sao_Paulo`. Em histórico de preços, `date` é um número (Unix em segundos) com a data do fechamento. Em analytics de opções, `date` vem em `YYYY-MM-DD`. * **Datas em parâmetros:** use `YYYY-MM-DD`. ## Acesso Futuros estão no plano **Pro**. Sem token, dá para testar com **WIN** (mini Ibov) e **WDO** (mini Dolar). | Plano | Acesso | | ------------------- | ---------------------- | | Sem token (sandbox) | WIN e WDO | | Free | Não incluso | | Startup | Não incluso | | **Pro** | **Todos os contratos** | ## Termos * **Ativo (`underlyingAsset` ou `asset`):** o código de 2 a 4 letras do produto, sem mês ou ano. Ex.: `WIN`, `WDO`, `BGI`, `DI1`. * **Contrato (`symbol`):** o código que o mercado negocia. Formato: **`{ATIVO}{LETRA_MÊS}{ANO}`**. Ex.: `WINM26` = mini Ibov com vencimento em junho de 2026. * **Vencimento (`expirationDate`):** data em que o contrato termina, no formato `YYYY-MM-DD`. * **Preço de ajuste (`settlement`):** o preço oficial do dia, divulgado no fim do pregão. Vem sempre preenchido, mesmo em dias sem negócio. * **Taxa de ajuste (`settlementRate`):** só vem em contratos de juros (DI, DAP). É a taxa anual (`%a.a.`) do ajuste. * **Multiplicador (`contractMultiplier`):** quanto vale cada ponto. Ex.: `WIN = 0,2`, `WDO = 10`, `BGI = 330` (arrobas), `DI1 = 1`. * **Lote (`allocationRoundLot`):** tamanho do lote. Quase sempre `1`. * **Tipo de cotação (`quotationType`):** `price` para a maioria, `rate` para juros (DI, DAP). Veja abaixo. ## Contratos em taxa vs em preço A maioria dos futuros é cotada em **preço**. O número em `close`, `high`, `low` e `settlement` é o preço direto (pontos para WIN, reais para BGI etc.). Os futuros de juros (`DI1`, `DI`, `DAP`) são cotados em **taxa anual** (`%a.a.`): * `close`, `high`, `low`, `average` vêm em **%a.a.** (ex.: `14.075` = 14,075% a.a.). * `settlement` vem em **reais** (preço unitário, ex.: `92179.44`). * `settlementRate` vem em **%a.a.** (ex.: `14.059`). O campo `quotationType` (`"price"` ou `"rate"`) na resposta diz qual unidade usar. Para o preço oficial do dia, **use sempre `settlement`**. O `close` (último negócio) pode vir vazio em contratos com pouca negociação. ## Como ler o `symbol` Padrão: **`{ATIVO}{LETRA_MÊS}{ANO}`**. * **Ativo:** 2 a 4 letras (`WIN`, `WDO`, `BGI`, `DI1`). * **Letra do mês:** uma letra para cada mês. | Mês | Letra | Mês | Letra | | --------- | ----- | -------- | ----- | | Janeiro | F | Julho | N | | Fevereiro | G | Agosto | Q | | Março | H | Setembro | U | | Abril | J | Outubro | V | | Maio | K | Novembro | X | | Junho | M | Dezembro | Z | * **Ano:** dois últimos dígitos. Exemplos: * `WINM26` → mini Ibov, junho de 2026. * `DI1F27` → DI, janeiro de 2027. * `BGIK26` → boi gordo, maio de 2026. ## Comece rápido Exemplo do fluxo `curva → cotação → histórico` para o mini Ibov. ```bash # 1) Curva de vencimentos do mini Ibov curl "https://brapi.dev/api/v2/futures/term-structure?asset=WIN" # 2) Cotação do contrato curl "https://brapi.dev/api/v2/futures/quote?symbols=WINM26" # 3) Histórico dos últimos 12 meses curl "https://brapi.dev/api/v2/futures/historical?symbol=WINM26" ``` ```typescript const BASE = 'https://brapi.dev/api/v2/futures'; const token = process.env.BRAPI_TOKEN; // opcional para WIN/WDO no sandbox const headers = token ? { Authorization: `Bearer ${token}` } : undefined; // 1) Curva const curve = await fetch(`${BASE}/term-structure?asset=WIN`, { headers, }).then((r) => r.json()); // 2) Contrato mais próximo do vencimento const front = curve.contracts[0]; const quote = await fetch(`${BASE}/quote?symbols=${front.symbol}`, { headers, }).then((r) => r.json()); // 3) Histórico const history = await fetch( `${BASE}/historical?symbol=${front.symbol}`, { headers }, ).then((r) => r.json()); console.log(history); ``` ```python import os import requests BASE = "https://brapi.dev/api/v2/futures" token = os.getenv("BRAPI_TOKEN") # opcional para WIN/WDO no sandbox headers = {"Authorization": f"Bearer {token}"} if token else {} # 1) Curva curve = requests.get( f"{BASE}/term-structure", params={"asset": "WIN"}, headers=headers ).json() front = curve["contracts"][0] # 2) Cotação quote = requests.get( f"{BASE}/quote", params={"symbols": front["symbol"]}, headers=headers ).json() # 3) Histórico history = requests.get( f"{BASE}/historical", params={"symbol": front["symbol"]}, headers=headers ).json() print(history) ``` ## Passo a passo #### Liste os contratos Use [`/api/v2/futures/list`](/docs/futuros/lista) para ver o que existe, ou [`/api/v2/futures/term-structure`](/docs/futuros/curva-de-vencimentos) para ver todos os vencimentos de um ativo. #### Pegue cotação ou especificações Use [`/api/v2/futures/quote`](/docs/futuros/cotacao) para a cotação do dia de até 20 contratos, ou [`/api/v2/futures/specs`](/docs/futuros/especificacoes) para os dados do contrato (multiplicador, lote, vencimento, ISIN). #### Histórico Use [`/api/v2/futures/historical`](/docs/futuros/historico) com `symbol` para a série diária do contrato. #### Opções sobre o contrato Para opções sobre futuros (boi, café, milho, soja), veja [Opções sobre Futuros](/docs/futuros/opcoes). ## Casos comuns * **Painel de futuros:** `list → quote` * **Curva de juros do DI:** `term-structure?asset=DI1` * **Curva do mini Ibov:** `term-structure?asset=WIN` * **Backtest de boi:** `term-structure?asset=BGI → historical` * **Margem e ajuste do dia:** `quote` (use `settlement` e `settlementRate`) ## Perguntas frequentes ## Sandbox sem token Para testar sem token, os endpoints aceitam só estes ativos: * `/list`, `/term-structure`: `asset=WIN` ou `asset=WDO`. * `/quote`, `/specs`: `symbols=` com `WIN` ou `WDO`. * `/historical`: `symbol` com `WIN` ou `WDO`. * `/options/expirations`, `/options/strikes`, `/options/chain`: `underlying=BGI`. * `/options/historical`: `symbol` com `BGI`. Para outros ativos, use um token do plano Pro. ## Endpoints # Listar Contratos Futuros URL: /docs/futuros/lista.mdx Lista de contratos futuros disponíveis, com filtros por ativo, segmento e contratos vencidos. *** title: Listar Contratos Futuros description: >- Lista de contratos futuros disponíveis, com filtros por ativo, segmento e contratos vencidos. full: true keywords: brapi, api, futuros, listar, contratos, WIN, WDO, BGI, DI1 openGraph: title: Listar Contratos Futuros description: >- Lista de contratos futuros disponíveis, com filtros. type: website locale: pt\_BR lastUpdated: '2026-05-21T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/futures/list structuredData: headings: \[] contents: * content: >- Lista de contratos futuros disponíveis, com filtros por ativo, segmento e contratos vencidos. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna a lista de contratos futuros. Use os filtros para limitar a um ativo (ex.: `asset=BGI`) ou a um segmento (ex.: `segment=agribusiness`). Cada item traz os **dados do contrato** (sem preço): símbolo, ativo, vencimento, multiplicador, lote, ISIN, CFI. Para a cotação do dia, use [`/api/v2/futures/quote`](/docs/futuros/cotacao). Para a curva inteira de um ativo, use [`/api/v2/futures/term-structure`](/docs/futuros/curva-de-vencimentos). **Plano Pro.** Sem token, aceita só `asset=WIN` ou `asset=WDO`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/futures/list Single endpoint documentation for /api/v2/futures/list ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/futures/list **Summary:** Listar contratos futuros Retorna a lista de contratos futuros, com filtros por ativo, segmento e vencimento. **Tags:** Futuros ### Parameters - **asset** (query) - **segment** (query) - **includeExpired** (query) - **page** (query) - **limit** (query) - **sortBy** (query) - **sortOrder** (query) ### Responses #### 200 Lista de contratos. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FutureListResponse **Properties:** - **futures** (array) *(required)* Array items: Reference to: **FutureSpecs** - **pagination** (object) *(required)* **Properties:** - **page** (integer) *(required)* - **limit** (integer) *(required)* - **total** (integer) *(required)* - **totalPages** (integer) *(required)* - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### FutureSpecs **Properties:** - **symbol** (string) *(required)* Código do contrato (ex.: `WINM26`, `BGIF27`, `DI1F27`). - **underlyingAsset** (string) *(required)* Código do ativo (ex.: `WIN`, `BGI`, `DI1`). - **assetDescription** (string) *(nullable)* *(required)* Nome do ativo em português. - **segment** (string) - Options: `financial`, `agribusiness` *(required)* `financial` = índices, juros e moeda. `agribusiness` = commodities. - **quotationType** (string) - Options: `price`, `rate` *(required)* `rate` para juros (DI/DAP) — OHLC vem em %a.a. `price` para os demais. - **expirationDate** (string) *(required)* Data de vencimento (YYYY-MM-DD). - **firstTradeDate** (string) *(nullable)* *(required)* Data do primeiro pregão. - **lastTradeDate** (string) *(nullable)* *(required)* Data do último pregão. - **contractMultiplier** (number) *(nullable)* *(required)* Quanto vale cada ponto. Ex.: WIN = 0,2; BGI = 330; DI1 = 1. - **allocationRoundLot** (integer) *(nullable)* *(required)* Tamanho do lote. - **tradingCurrency** (string) *(nullable)* *(required)* Moeda (quase sempre `BRL`). - **deliveryType** (string) *(nullable)* *(required)* Tipo de entrega: `Financial` ou `Physical`. - **exerciseType** (string) *(nullable)* *(required)* Tipo de cotação: `Price` ou `Rate`. - **isin** (string) *(nullable)* *(required)* Código ISIN. - **cficCode** (string) *(nullable)* *(required)* Código CFI. # Séries Macroeconômicas Disponíveis URL: /docs/macro/available.mdx Lista das séries macroeconômicas disponíveis com slugs, aliases, unidade, frequência e descrição. Aceita busca textual via `q` e filtro por categoria. *** title: Séries Macroeconômicas Disponíveis description: >- Lista das séries macroeconômicas disponíveis com slugs, aliases, unidade, frequência e descrição. Aceita busca textual via `q` e filtro por categoria. full: true keywords: brapi, api, macroeconomia, indicadores, disponíveis, slugs, busca lang: pt-BR \_openapi: method: GET route: /api/v2/macro/available ------------------------------ Endpoint **público**. Retorna metadados das séries disponíveis (slug, nome, unidade, frequência, categoria). Use os slugs em [`/api/v2/macro`](/docs/macro) e [`/api/v2/macro/latest`](/docs/macro/latest). ### Filtros opcionais * `q` — busca textual em slug, alias, nome e descrição (case-insensitive, substring). Quando informado, os resultados vêm ordenados por relevância (slug > alias > nome > descrição). * `category` — filtra por categoria (ex: `interestRate`, `inflation`, `monetary`, `activity`, `labor`, `external`). Os filtros podem ser combinados. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/macro/available Single endpoint documentation for /api/v2/macro/available ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/macro/available **Summary:** Listar séries macroeconômicas disponíveis Lista as séries macroeconômicas disponíveis com slug, nome, unidade, frequência, categoria e data de início do histórico. Endpoint público (use para descobrir slugs antes de chamar `/api/v2/macro` ou `/api/v2/macro/latest`). ### Filtros opcionais - `q` — busca textual em slug, alias, nome e descrição (case-insensitive). Quando presente, os resultados vêm ordenados por relevância. - `category` — filtra por categoria (ex: `interestRate`, `inflation`). Os filtros podem ser combinados. **Tags:** Macroeconomia ### Parameters - **q** (query) - **category** (query) ### Responses #### 200 Lista de séries disponíveis retornada com sucesso. ## Schemas The following schemas are used by this endpoint: ### MacroAvailableResponse **Properties:** - **results** (array) *(required)* Lista de séries macroeconômicas. Quando `q` é informado, vem ordenada por relevância (slug > alias > nome > descrição). Array items: Reference to: **MacroSeriesPublic** - **categories** (array) *(required)* Todas as categorias do catálogo. Não é afetado pelos filtros — sempre lista o universo completo de categorias para que o cliente possa montar facetas. Array items: **Type:** string - **count** (integer) *(required)* Quantidade de séries em `results` após aplicar os filtros. - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### MacroSeriesPublic **Properties:** - **slug** (string) *(required)* - **name** (string) *(required)* - **description** (string) *(required)* - **unit** (string) *(required)* - **frequency** (string) *(required)* - **category** (string) *(required)* - **startDate** (string) *(required)* # Macroeconomia URL: /docs/macro.mdx Endpoint composable para acessar séries temporais de indicadores macroeconômicos do Brasil — Selic, IPCA, IGP-M, agregados monetários, atividade e mercado de trabalho. *** title: Macroeconomia description: >- Endpoint composable para acessar séries temporais de indicadores macroeconômicos do Brasil — Selic, IPCA, IGP-M, agregados monetários, atividade e mercado de trabalho. full: true keywords: brapi, api, macroeconomia, indicadores econômicos, selic, ipca, igpm openGraph: title: Macroeconomia — brapi description: >- Séries temporais de indicadores macroeconômicos brasileiros — Selic, IPCA, IGP-M e outros — em uma única requisição. type: website locale: pt\_BR lang: pt-BR \_openapi: method: GET route: /api/v2/macro -------------------- Acesse séries temporais de indicadores macroeconômicos brasileiros usando slugs estáveis. Compatível com **múltiplas séries** em uma única requisição via parâmetro `symbols` (ex: `symbols=selic,ipca,igpm`). Use [`/api/v2/macro/available`](/docs/macro/available) para descobrir todos os slugs disponíveis (com busca textual opcional via `q`). ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/macro Single endpoint documentation for /api/v2/macro ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/macro **Summary:** Séries históricas de indicadores macroeconômicos Retorna observações históricas para uma ou mais séries macroeconômicas brasileiras (taxas de juros, inflação, agregados monetários e atividade). **Tags:** Macroeconomia ### Parameters - **symbols** (query) *required* - **startDate** (query) - **endDate** (query) - **sortOrder** (query) - **limit** (query) ### Responses #### 200 Observações retornadas com sucesso. #### 400 Parâmetros inválidos. #### 401 Token ausente ou inválido. #### 403 Plano sem acesso ao módulo de macroeconomia. #### 500 Erro interno. ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### MacroSeriesAliasWarning **Properties:** - **provided** (string) *(required)* - **canonicalSlug** (string) *(required)* - **message** (string) *(required)* ### MacroSeriesDataResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **MacroSeriesResult** - **warnings** (array) Array items: Reference to: **MacroSeriesAliasWarning** - **errors** (array) Array items: Reference to: **MacroSeriesError** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### MacroSeriesError **Properties:** - **slug** (string) *(required)* - **code** (string) *(required)* - **message** (string) *(required)* ### MacroSeriesObservation **Properties:** - **date** (string) *(required)* - **value** (number) *(required)* ### MacroSeriesPublic **Properties:** - **slug** (string) *(required)* - **name** (string) *(required)* - **description** (string) *(required)* - **unit** (string) *(required)* - **frequency** (string) *(required)* - **category** (string) *(required)* - **startDate** (string) *(required)* ### MacroSeriesResult **Properties:** - **series** *(required)* Reference to: **MacroSeriesPublic** - **observations** (array) *(required)* Array items: Reference to: **MacroSeriesObservation** # Macroeconomia — Última Observação URL: /docs/macro/latest.mdx Snapshot do valor mais recente de cada série macroeconômica solicitada. Ideal para dashboards que mostram apenas o valor corrente de Selic, IPCA, etc. *** title: Macroeconomia — Última Observação description: >- Snapshot do valor mais recente de cada série macroeconômica solicitada. Ideal para dashboards que mostram apenas o valor corrente de Selic, IPCA, etc. full: true keywords: brapi, api, macroeconomia, selic, ipca, latest lang: pt-BR \_openapi: method: GET route: /api/v2/macro/latest --------------------------- Retorna apenas a observação mais recente para cada série solicitada. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/macro/latest Single endpoint documentation for /api/v2/macro/latest ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/macro/latest **Summary:** Último valor de cada série macroeconômica Snapshot dos valores mais recentes para uma lista de séries (ou todas, se `symbols` for omitido). **Tags:** Macroeconomia ### Parameters - **symbols** (query) ### Responses #### 200 Snapshot retornado com sucesso. #### 400 Parâmetros inválidos. #### 401 Token ausente ou inválido. #### 403 Plano sem acesso ao módulo de macroeconomia. #### 500 Erro interno. ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### MacroSeriesAliasWarning **Properties:** - **provided** (string) *(required)* - **canonicalSlug** (string) *(required)* - **message** (string) *(required)* ### MacroSeriesError **Properties:** - **slug** (string) *(required)* - **code** (string) *(required)* - **message** (string) *(required)* ### MacroSeriesLatest **Properties:** - **series** *(required)* Reference to: **MacroSeriesPublic** - **latest** *(required)* ### MacroSeriesLatestResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **MacroSeriesLatest** - **warnings** (array) Array items: Reference to: **MacroSeriesAliasWarning** - **errors** (array) Array items: Reference to: **MacroSeriesError** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### MacroSeriesObservation **Properties:** - **date** (string) *(required)* - **value** (number) *(required)* ### MacroSeriesPublic **Properties:** - **slug** (string) *(required)* - **name** (string) *(required)* - **description** (string) *(required)* - **unit** (string) *(required)* - **frequency** (string) *(required)* - **category** (string) *(required)* - **startDate** (string) *(required)* # Listar Moedas URL: /docs/moedas/available.mdx Endpoints para consulta de Moedas Fiduciárias. Atualmente, focado na listagem das moedas disponíveis para conversão ou consulta de taxas de câmbio (embora o endpoint de cotação de moedas não esteja detalhado aqui, a listagem está disponível). *** title: Listar Moedas description: >- Endpoints para consulta de Moedas Fiduciárias. Atualmente, focado na listagem das moedas disponíveis para conversão ou consulta de taxas de câmbio (embora o endpoint de cotação de moedas não esteja detalhado aqui, a listagem está disponível). full: true keywords: brapi, api, documentação, moedas openGraph: title: Listar Moedas description: >- Endpoints para consulta de Moedas Fiduciárias. Atualmente, focado na listagem das moedas disponíveis para conversão ou consulta de taxas de câmbio (embora o endpoint de cotação de moedas não esteja detalhado aqui, a listagem está disponível). type: website locale: pt\_BR lastUpdated: '2025-04-28T01:22:35.254Z' lang: pt-BR \_openapi: method: GET route: /api/v2/currency/available toc: * depth: 2 title: Listar Todas as Moedas Fiduciárias Disponíveis url: '#listar-todas-as-moedas-fiduciárias-disponíveis' structuredData: headings: * content: Listar Todas as Moedas Fiduciárias Disponíveis id: listar-todas-as-moedas-fiduciárias-disponíveis contents: * content: >- Obtenha a lista completa de todas as moedas fiduciárias suportadas pela API, geralmente utilizadas no parâmetro `currency` de outros endpoints (como o de criptomoedas) ou para futuras funcionalidades de conversão. ### Funcionalidade: * Retorna um array `currencies` com os nomes das moedas. * Pode ser filtrado usando o parâmetro `search`. ### Autenticação: Requer token de autenticação via `token` (query) ou `Authorization` (header). ### Exemplo de Requisição: **Listar todas as moedas disponíveis:** ```bash curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/currency/available" ``` **Buscar moedas cujo nome contenha 'Euro':** ```bash curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/currency/available?search=Euro" ``` ### Resposta: A resposta é um objeto JSON com a chave `currencies`, contendo um array de objetos. Cada objeto possui uma chave `currency` com o nome completo da moeda (ex: `"Dólar Americano/Real Brasileiro"`). **Nota:** O formato do nome pode indicar um par de moedas, dependendo do contexto interno da API. heading: listar-todas-as-moedas-fiduciárias-disponíveis *** Endpoints para consulta de **Moedas Fiduciárias**. Atualmente, focado na listagem das moedas disponíveis para conversão ou consulta de taxas de câmbio (embora o endpoint de cotação de moedas não esteja detalhado aqui, a listagem está disponível). ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/currency/available Single endpoint documentation for /api/v2/currency/available ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/currency/available **Summary:** Listar Pares de Moedas Disponíveis Retorna a lista de pares de moedas disponíveis para consulta no endpoint `/api/v2/currency`. ### Formato: ORIGEM-DESTINO, onde ORIGEM é o código da moeda de origem e DESTINO a moeda de destino ### Pares Disponíveis: * **Moedas Fiduciárias:** USD, EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK e SEK contra BRL * **Cross Rates:** pares entre as moedas PTAX suportadas, como EUR-USD e GBP-USD ### Exemplos de Requisição: ```bash curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/currency/available" curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/currency/available?search=USD" ``` **Plano Mínimo:** Startup **Autenticação:** Necessária **Tags:** Câmbio ### Parameters - **search** (query) ### Responses #### 200 Lista de pares de moedas disponíveis retornada com sucesso. ## Schemas The following schemas are used by this endpoint: ### CurrencyAvailableResponse **Properties:** - **currencies** (array) *(required)* Array items: **Properties:** - **name** (string) *(required)* - **currency** (string) *(required)* # Histórico de Moedas URL: /docs/moedas/historico.mdx Série histórica diária de cotações PTAX para pares de moedas em BRL — USD, EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK contra o real. *** title: Histórico de Moedas description: >- Série histórica diária de cotações PTAX para pares de moedas em BRL — USD, EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK contra o real. full: true keywords: brapi, api, moedas, ptax, histórico, dolar, euro, libra openGraph: title: Histórico de Moedas — brapi description: >- Série histórica diária de cotações PTAX para pares de moedas em BRL. type: website locale: pt\_BR lang: pt-BR \_openapi: method: GET route: /api/v2/currency/historical ---------------------------------- Retorna a série histórica diária da cotação PTAX de venda para um ou mais pares contra o real. Ideal para back-testing, gráficos de longo prazo e análise de risco cambial. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/currency/historical Single endpoint documentation for /api/v2/currency/historical ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/currency/historical **Summary:** Histórico de Cotações de Câmbio Retorna séries históricas diárias de câmbio em três formas, todas derivadas das mesmas cotações PTAX de fechamento: - **Direto** (X-BRL) — cotação diária do par armazenado. Disponível a partir do plano Startup. - **Inverso** (BRL-X) — calculado como `1 / X-BRL`. Requer plano Pro. - **Cross-rate** (X-Y, nenhum dos dois é BRL) — calculado como `X-BRL / Y-BRL` em cada data com observação em ambas as séries. Requer plano Pro. ### Moedas Suportadas USD, EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK contra BRL e entre si. Para cotações de criptomoedas, use `/api/v2/crypto`. ### Exemplos ```bash # Direto curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/currency/historical?currency=USD-BRL,EUR-BRL" # Inverso curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/currency/historical?currency=BRL-USD" # Cross-rate curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/currency/historical?currency=USD-EUR,GBP-EUR" # Período customizado curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/currency/historical?currency=USD-BRL&startDate=2020-01-01&endDate=2025-12-31" ``` **Plano Mínimo:** Startup | **Autenticação:** Necessária **Tags:** Câmbio ### Parameters - **currency** (query) *required* - **startDate** (query) - **endDate** (query) - **sortOrder** (query) - **limit** (query) ### Responses #### 200 Histórico de cotações PTAX retornado com sucesso. #### 400 **Requisição Inválida.** Parâmetros ausentes ou inválidos. #### 401 **Não Autorizado.** #### 403 **Acesso Proibido.** Plano sem acesso ao módulo de câmbio. #### 500 **Erro Interno.** ## Schemas The following schemas are used by this endpoint: ### CurrencyHistoricalError **Properties:** - **pair** (string) *(required)* - **code** (string) *(required)* - **message** (string) *(required)* ### CurrencyHistoricalPairResult **Properties:** - **pair** (string) *(required)* - **fromCurrency** (string) *(required)* - **toCurrency** (string) *(required)* - **observations** (array) *(required)* Array items: **Properties:** - **date** (string) *(required)* - **value** (number) *(required)* ### CurrencyHistoricalResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **CurrencyHistoricalPairResult** - **errors** (array) Array items: Reference to: **CurrencyHistoricalError** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) # Cotação de Moedas URL: /docs/moedas.mdx Endpoints para consulta de Moedas Fiduciárias. Atualmente, focado na listagem das moedas disponíveis para conversão ou consulta de taxas de câmbio. *** title: Cotação de Moedas description: >- Endpoints para consulta de Moedas Fiduciárias. Atualmente, focado na listagem das moedas disponíveis para conversão ou consulta de taxas de câmbio. full: true keywords: brapi, api, documentação, moedas openGraph: title: Cotação de Moedas description: >- Endpoints para consulta de Moedas Fiduciárias. Atualmente, focado na listagem das moedas disponíveis para conversão ou consulta de taxas de câmbio. type: website locale: pt\_BR lastUpdated: '2025-04-28T01:22:35.254Z' lang: pt-BR \_openapi: method: GET route: /api/v2/currency toc: * depth: 2 title: Listar Todas as Moedas Fiduciárias Disponíveis url: '#listar-todas-as-moedas-fiduciárias-disponíveis' structuredData: headings: * content: Listar Todas as Moedas Fiduciárias Disponíveis id: listar-todas-as-moedas-fiduciárias-disponíveis contents: * content: >- Obtenha cotações atualizadas para um ou mais pares de moedas fiduciárias (ex: USD-BRL, EUR-USD). ### Funcionalidades: * **Cotação Múltipla:** Consulte vários pares de moedas em uma única requisição usando o parâmetro `currency`. \* **Dados Retornados:** Inclui nome do par, preços de compra (bid) e venda (ask), variação, máximas e mínimas, e timestamp da atualização. ### Parâmetros: * **`currency` (Obrigatório):** Uma lista de pares de moedas separados por vírgula, no formato `MOEDA_ORIGEM-MOEDA_DESTINO` (ex: `USD-BRL`, `EUR-USD`). Consulte os pares disponíveis em [`/api/v2/currency/available`](#/Moedas/getAvailableCurrencies). * **`token` (Obrigatório):** Seu token de autenticação. ### Autenticação: Requer token de autenticação válido via `token` (query) ou `Authorization` (header). ### Estrutura da Resposta (200 OK): A resposta bem-sucedida (`CurrencyResponse`) contém um array `currency`. Cada objeto dentro deste array (`CurrencyQuote`) representa um par solicitado e inclui: \* `fromCurrency`: Sigla da moeda de origem. \* `toCurrency`: Sigla da moeda de destino. * `name`: Nome descritivo do par. \* `high`, `low`: Preços máximo e mínimo do período recente. \* `bidVariation`, `percentageChange`: Variação absoluta e percentual. \* `bidPrice`, `askPrice`: Preços de compra e venda atuais. \* `updatedAtTimestamp`, `updatedAtDate`: Timestamps da última atualização. ````json { \"currency\": [ { \"fromCurrency\": \"USD\", \"toCurrency\": \"BRL\", \"name\": \"Dólar Americano/Real Brasileiro\", \"high\": \"5.22\", \"low\": \"5.162\", \"bidVariation\": \"0.0454\", \"percentageChange\": \"0.88\", \"bidPrice\": \"5.2097\", \"askPrice\": \"5.2127\", \"updatedAtTimestamp\": \"1696601423\", \"updatedAtDate\": \"2023-10-06 11:10:23\" }, { \"fromCurrency\": \"EUR\", \"toCurrency\": \"USD\", \"name\": \"Euro/Dólar Americano\", \"high\": \"1.0568\", \"low\": \"1.0482\", \"bidVariation\": \"-0.0037\", \"percentageChange\": \"-0.35\", \"bidPrice\": \"1.051\", \"askPrice\": \"1.0511\", \"updatedAtTimestamp\": \"1696601456\", \"updatedAtDate\": \"2023-10-06 11:10:56\" } ] } ``` heading: listar-todas-as-moedas-fiduciárias-disponíveis ```` *** import { Callout } from 'fumadocs-ui/components/callout'; Endpoints para consulta de **Moedas Fiduciárias**. Taxas de câmbio do **BCB** e provedores forex. USD, EUR, GBP e 50+ pares com atualização em tempo real. Atualmente, focado na listagem das moedas disponíveis para conversão ou consulta de taxas de câmbio. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/currency Single endpoint documentation for /api/v2/currency ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/currency **Summary:** Obter Cotações de Câmbio Retorna cotações atualizadas de pares de moedas, com preço de compra/venda, variação e extremos do dia. ### Funcionalidades: * **Cotação Atual:** Preço de compra (bid), venda (ask), máxima, mínima, variação * **Múltiplos Pares:** Consulte vários em uma requisição (separados por vírgula) * **Formato:** `ORIGEM-DESTINO` (ex: `USD-BRL`) ### Autenticação: Bearer token ou query param `token`. Obtenha em brapi.dev/dashboard. ### Exemplos de Requisição: ```bash curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/currency?currency=USD-BRL" curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/currency?currency=USD-BRL,EUR-BRL,GBP-BRL" ``` ### Pares de Moedas Populares: * `USD-BRL` — Dólar Americano / Real * `EUR-BRL` — Euro / Real * `GBP-BRL` — Libra Esterlina / Real * `EUR-USD` — Euro / Dólar ### Campos da Resposta: * `fromCurrency` / `toCurrency` — Par de moedas * `name` — Nome do par * `bidPrice` — Preço de compra * `askPrice` — Preço de venda * `high` / `low` — Máxima/Mínima do dia * `bidVariation` — Variação do preço de compra * `percentageChange` — Variação percentual (%) ### Fonte dos Dados: Banco Central do Brasil (PTAX) **Plano Mínimo:** Startup **Autenticação:** Necessária **Tags:** Câmbio ### Parameters - **currency** (query) ### Responses #### 200 Cotações dos pares de moedas solicitados retornadas com sucesso. #### 400 **Requisição Inválida.** Parâmetro `currency` não fornecido ou formato inválido. #### 401 **Não Autorizado.** Token de autenticação não fornecido ou inválido. #### 403 **Acesso Proibido.** Seu plano não tem acesso ao módulo de câmbio. #### 500 **Erro Interno.** Erro interno ao processar a requisição. #### 503 **Serviço Indisponível.** Serviço externo temporariamente indisponível. ## Schemas The following schemas are used by this endpoint: ### CurrencyQuoteSimple **Properties:** - **fromCurrency** (string) *(required)* - **toCurrency** (string) *(required)* - **name** (string) *(required)* - **high** (string) *(required)* - **low** (string) *(required)* - **bidVariation** (string) *(required)* - **percentageChange** (string) *(required)* - **bidPrice** (string) *(required)* - **askPrice** (string) *(required)* - **updatedAtTimestamp** (string) *(required)* - **updatedAtDate** (string) *(required)* ### CurrencyResponseSimple **Properties:** - **currency** (array) *(required)* Array items: Reference to: **CurrencyQuoteSimple** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) # Histórico de Gregas e IV de Opções URL: /docs/opcoes/analytics-historico.mdx Consulte a série temporal EOD de volatilidade implícita e gregas calculadas para uma opção específica. *** title: Histórico de Gregas e IV de Opções description: >- Consulte a série temporal EOD de volatilidade implícita e gregas calculadas para uma opção específica. full: true keywords: brapi, api, opções, histórico, gregas, volatilidade implícita openGraph: title: Histórico de Gregas e IV de Opções description: >- Série temporal EOD de volatilidade implícita e gregas calculadas para uma opção específica. type: website locale: pt\_BR lastUpdated: '2026-06-01T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/options/analytics/history structuredData: headings: \[] contents: * content: >- Retorna a série temporal EOD de IV e gregas calculadas para uma opção específica. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna uma série temporal diária com volatilidade implícita, delta, gamma, theta, vega e rho para uma opção específica. Use este endpoint quando você já sabe o `symbol` e o `expirationDate` da série. Se o mesmo `symbol` existir mais de uma vez no vencimento, informe também `strike`. **Plano mínimo: Pro.** No sandbox sem token, aceita apenas símbolos que começam com `PETR`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/options/analytics/history Single endpoint documentation for /api/v2/options/analytics/history ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/options/analytics/history **Summary:** Obter histórico de gregas e IV de uma série de opção Retorna a série temporal EOD de IV e gregas calculadas para uma única opção. Sem token, o sandbox aceita apenas símbolos com prefixo `PETR`. **Tags:** Opções ### Parameters - **symbol** (query) *required* - **expirationDate** (query) *required* - **strike** (query) - **startDate** (query) - **endDate** (query) - **sortOrder** (query) ### Responses #### 200 Histórico de análises retornado com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### OptionAnalyticsHistoryResponse **Properties:** - **option** *(required)* Reference to: **OptionSeriesWithAnalyticsHistory** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### OptionAnalyticsPoint **Properties:** - **date** (string) *(required)* Data do pregão, no formato YYYY-MM-DD. - **model** (string) - Options: `black-scholes-merton`, `barone-adesi-whaley`, `cox-ross-rubinstein`, `unsupported` *(required)* Modelo usado na precificação. Séries americanas usam aproximação binomial; séries europeias usam Black-Scholes-Merton. - **priceSource** (string) - Options: `close`, `referencePrice`, `none` *(required)* Preço usado como entrada para resolver IV. Em opções de ações/índices, v1 usa apenas fechamento negociado (`close`). - **underlyingPrice** (number) *(nullable)* *(required)* Preço do ativo subjacente usado no cálculo. - **optionPrice** (number) *(nullable)* *(required)* Preço da opção usado para resolver a volatilidade implícita. - **riskFreeRate** (number) *(nullable)* *(required)* Taxa livre de risco anual em decimal (ex.: 0.105 para 10,5%). - **dividendYield** (number) *(nullable)* *(required)* Yield contínuo derivado de dividendos anunciados conhecidos até a data de cálculo. `0` quando não há dividendo anunciado aplicável. - **timeToExpirationYears** (number) *(nullable)* *(required)* Tempo até o vencimento em anos. - **impliedVolatility** (number) *(nullable)* *(required)* Volatilidade implícita anualizada em decimal. - **delta** (number) *(nullable)* *(required)* Delta da opção. - **gamma** (number) *(nullable)* *(required)* Gamma da opção. - **theta** (number) *(nullable)* *(required)* Theta anualizado da opção. - **vega** (number) *(nullable)* *(required)* Vega da opção. - **rho** (number) *(nullable)* *(required)* Rho da opção. - **confidence** (string) - Options: `high`, `medium`, `low`, `none` *(required)* Confiança operacional do cálculo. `none` indica que as gregas/IV ficaram nulas e `nullReason` explica o motivo. - **nullReason** (string) *(nullable)* *(required)* Motivo para campos calculados nulos, quando aplicável (ex.: `no_trades`, `missing_underlying_price`, `iv_not_converged`). ### OptionSeries **Properties:** - **symbol** (string) *(required)* Código de negociação da série (ex: PETRF783). - **underlyingSymbol** (string) *(nullable)* *(required)* Ativo subjacente da opção (ex: PETR4). - **side** (string) - Options: `call`, `put` *(required)* Tipo da opção: `call` (opção de compra) ou `put` (opção de venda). - **market** (string) - Options: `equity`, `index` *(required)* Mercado da opção: `equity` (ação/ETF) ou `index` (índice). - **optionStyle** (string) - Options: `american`, `european` *(nullable)* *(required)* Estilo de exercício da opção: `american` permite exercício a qualquer momento até o vencimento; `european` permite exercício apenas no vencimento. `null` em séries antigas que ainda não passaram pelo enriquecimento de cadastro. - **strike** (number) *(nullable)* *(required)* Preço de exercício (strike) da opção. - **allocationRoundLot** (integer) *(nullable)* *(required)* Tamanho do lote pré-definido para alocação. Geralmente 100 para opções sobre ações brasileiras. - **expirationDate** (string) *(required)* Data de vencimento da série, no formato YYYY-MM-DD. - **firstTradeDate** (string) *(required)* Data do primeiro pregão observado para a série (YYYY-MM-DD). - **lastTradeDate** (string) *(required)* Data do último pregão observado para a série (YYYY-MM-DD). ### OptionSeriesWithAnalyticsHistory # Gregas e IV de Opções URL: /docs/opcoes/analytics.mdx Consulte volatilidade implícita e gregas EOD calculadas para séries de opções de um vencimento. *** title: Gregas e IV de Opções description: >- Consulte volatilidade implícita e gregas EOD calculadas para séries de opções de um vencimento. full: true keywords: brapi, api, opções, gregas, delta, gamma, theta, vega, rho, volatilidade implícita openGraph: title: Gregas e IV de Opções description: >- Consulte volatilidade implícita e gregas EOD calculadas para opções. type: website locale: pt\_BR lastUpdated: '2026-06-01T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/options/analytics structuredData: headings: \[] contents: * content: >- Retorna volatilidade implícita e gregas EOD calculadas para séries de opções de um vencimento. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna volatilidade implícita e gregas EOD para as séries de um vencimento, com filtros por `side`, `minStrike` e `maxStrike`. Os cálculos usam preços EOD observados. Quando faltam dados suficientes, os campos calculados ficam `null` e `nullReason` explica o motivo. **Plano mínimo: Pro.** No sandbox sem token, aceita apenas `underlying=PETR4`. `dividendYield` considera apenas dividendos já anunciados até a data de cálculo. A API não usa dividendos futuros estimados como proxy. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/options/analytics Single endpoint documentation for /api/v2/options/analytics ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/options/analytics **Summary:** Obter gregas e volatilidade implícita de opções Retorna IV e gregas EOD calculadas para as séries de um vencimento. Os cálculos usam apenas preços EOD observados; quando uma série não tem dados suficientes, os campos calculados ficam `null` e `nullReason` explica o motivo. Sem token, o sandbox aceita apenas `underlying=PETR4`. **Tags:** Opções ### Parameters - **underlying** (query) *required* - **expirationDate** (query) *required* - **date** (query) - **side** (query) - **minStrike** (query) - **maxStrike** (query) - **limit** (query) ### Responses #### 200 Análises retornadas com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### OptionAnalyticsResponse **Properties:** - **underlying** (string) *(required)* - **expirationDate** (string) *(required)* - **date** (string) *(required)* - **analytics** (array) *(required)* Array items: Reference to: **OptionAnalyticsSnapshot** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### OptionAnalyticsSnapshot **Properties:** - **symbol** (string) *(required)* Código de negociação da série (ex: PETRF783). - **underlyingSymbol** (string) *(nullable)* *(required)* Ativo subjacente da opção (ex: PETR4). - **side** (string) - Options: `call`, `put` *(required)* Tipo da opção: `call` (opção de compra) ou `put` (opção de venda). - **market** (string) - Options: `equity`, `index` *(required)* Mercado da opção: `equity` (ação/ETF) ou `index` (índice). - **optionStyle** (string) - Options: `american`, `european` *(nullable)* *(required)* Estilo de exercício da opção: `american` permite exercício a qualquer momento até o vencimento; `european` permite exercício apenas no vencimento. `null` em séries antigas que ainda não passaram pelo enriquecimento de cadastro. - **strike** (number) *(nullable)* *(required)* Preço de exercício (strike) da opção. - **allocationRoundLot** (integer) *(nullable)* *(required)* Tamanho do lote pré-definido para alocação. Geralmente 100 para opções sobre ações brasileiras. - **expirationDate** (string) *(required)* Data de vencimento da série, no formato YYYY-MM-DD. - **firstTradeDate** (string) *(required)* Data do primeiro pregão observado para a série (YYYY-MM-DD). - **lastTradeDate** (string) *(required)* Data do último pregão observado para a série (YYYY-MM-DD). - **date** (string) *(required)* Data do pregão, no formato YYYY-MM-DD. - **model** (string) - Options: `black-scholes-merton`, `barone-adesi-whaley`, `cox-ross-rubinstein`, `unsupported` *(required)* Modelo usado na precificação. Séries americanas usam aproximação binomial; séries europeias usam Black-Scholes-Merton. - **priceSource** (string) - Options: `close`, `referencePrice`, `none` *(required)* Preço usado como entrada para resolver IV. Em opções de ações/índices, v1 usa apenas fechamento negociado (`close`). - **underlyingPrice** (number) *(nullable)* *(required)* Preço do ativo subjacente usado no cálculo. - **optionPrice** (number) *(nullable)* *(required)* Preço da opção usado para resolver a volatilidade implícita. - **riskFreeRate** (number) *(nullable)* *(required)* Taxa livre de risco anual em decimal (ex.: 0.105 para 10,5%). - **dividendYield** (number) *(nullable)* *(required)* Yield contínuo derivado de dividendos anunciados conhecidos até a data de cálculo. `0` quando não há dividendo anunciado aplicável. - **timeToExpirationYears** (number) *(nullable)* *(required)* Tempo até o vencimento em anos. - **impliedVolatility** (number) *(nullable)* *(required)* Volatilidade implícita anualizada em decimal. - **delta** (number) *(nullable)* *(required)* Delta da opção. - **gamma** (number) *(nullable)* *(required)* Gamma da opção. - **theta** (number) *(nullable)* *(required)* Theta anualizado da opção. - **vega** (number) *(nullable)* *(required)* Vega da opção. - **rho** (number) *(nullable)* *(required)* Rho da opção. - **confidence** (string) - Options: `high`, `medium`, `low`, `none` *(required)* Confiança operacional do cálculo. `none` indica que as gregas/IV ficaram nulas e `nullReason` explica o motivo. - **nullReason** (string) *(nullable)* *(required)* Motivo para campos calculados nulos, quando aplicável (ex.: `no_trades`, `missing_underlying_price`, `iv_not_converged`). # Histórico de uma Série de Opção URL: /docs/opcoes/historico.mdx Consulte o histórico diário de uma série de opção por símbolo e vencimento, com resposta simples e pronta para gráfico ou backtest. *** title: Histórico de uma Série de Opção description: >- Consulte o histórico diário de uma série de opção por símbolo e vencimento, com resposta simples e pronta para gráfico ou backtest. full: true keywords: brapi, api, opções, histórico, série openGraph: title: Histórico de uma Série de Opção description: >- Consulte o histórico diário de uma série de opção por símbolo e vencimento. type: website locale: pt\_BR lastUpdated: '2026-04-22T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/options/historical structuredData: headings: \[] contents: * content: >- Retorna o histórico diário EOD de uma única série de opção, identificada por símbolo e vencimento. Pronto para gráfico ou backtest. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna o histórico diário EOD de uma única série de opção, identificada por `symbol` e `expirationDate`. Informe também `strike` quando o mesmo símbolo aparecer mais de uma vez no mesmo vencimento. Normalmente você descobre a série primeiro em [Séries Negociadas](/docs/opcoes/series) e só depois chama este endpoint. Foi desenhado para **uma série por requisição**, para manter a integração simples e evitar ambiguidades. **Plano mínimo: Pro.** No sandbox sem token, aceita apenas `symbol` começando com `PETR` (opções do subjacente PETR4). ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/options/historical Single endpoint documentation for /api/v2/options/historical ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/options/historical **Summary:** Obter histórico diário de uma série de opção Retorna o histórico diário EOD de uma única série, identificada por `symbol` e `expirationDate`. Sem token, o sandbox aceita apenas símbolos com prefixo `PETR` (opções de PETR4). **Tags:** Opções ### Parameters - **symbol** (query) *required* - **expirationDate** (query) *required* - **strike** (query) - **startDate** (query) - **endDate** (query) - **sortOrder** (query) ### Responses #### 200 Histórico retornado com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### OptionHistoricalResponse **Properties:** - **option** *(required)* Reference to: **OptionSeriesWithHistory** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### OptionPricePoint **Properties:** - **date** (integer) *(required)* Data do pregão em timestamp Unix (segundos). - **open** (number) *(nullable)* *(required)* Preço de abertura do pregão. - **high** (number) *(nullable)* *(required)* Máxima do pregão. - **low** (number) *(nullable)* *(required)* Mínima do pregão. - **average** (number) *(nullable)* *(required)* Preço médio do pregão. - **close** (number) *(nullable)* *(required)* Preço de fechamento do pregão. - **bid** (number) *(nullable)* *(required)* Melhor oferta de compra registrada no fechamento. - **ask** (number) *(nullable)* *(required)* Melhor oferta de venda registrada no fechamento. - **trades** (number) *(nullable)* *(required)* Número de negócios realizados no pregão. - **volume** (number) *(nullable)* *(required)* Volume negociado no pregão (em contratos). - **financialVolume** (number) *(nullable)* *(required)* Volume financeiro negociado no pregão (em BRL). ### OptionSeries **Properties:** - **symbol** (string) *(required)* Código de negociação da série (ex: PETRF783). - **underlyingSymbol** (string) *(nullable)* *(required)* Ativo subjacente da opção (ex: PETR4). - **side** (string) - Options: `call`, `put` *(required)* Tipo da opção: `call` (opção de compra) ou `put` (opção de venda). - **market** (string) - Options: `equity`, `index` *(required)* Mercado da opção: `equity` (ação/ETF) ou `index` (índice). - **optionStyle** (string) - Options: `american`, `european` *(nullable)* *(required)* Estilo de exercício da opção: `american` permite exercício a qualquer momento até o vencimento; `european` permite exercício apenas no vencimento. `null` em séries antigas que ainda não passaram pelo enriquecimento de cadastro. - **strike** (number) *(nullable)* *(required)* Preço de exercício (strike) da opção. - **allocationRoundLot** (integer) *(nullable)* *(required)* Tamanho do lote pré-definido para alocação. Geralmente 100 para opções sobre ações brasileiras. - **expirationDate** (string) *(required)* Data de vencimento da série, no formato YYYY-MM-DD. - **firstTradeDate** (string) *(required)* Data do primeiro pregão observado para a série (YYYY-MM-DD). - **lastTradeDate** (string) *(required)* Data do último pregão observado para a série (YYYY-MM-DD). ### OptionSeriesWithHistory Metadados da série consultada acompanhados de `history`, com um ponto OHLCV por pregão no intervalo pedido. # Opções URL: /docs/opcoes.mdx Guia simples para integrar opções na brapi: entenda os termos principais, o fluxo recomendado e qual endpoint usar em cada caso. *** title: Opções description: >- Guia simples para integrar opções na brapi: entenda os termos principais, o fluxo recomendado e qual endpoint usar em cada caso. full: true keywords: brapi, api, opções, vencimento, strike, série openGraph: title: Opções description: >- Guia simples para integrar opções na brapi, com fluxo recomendado e exemplos de uso. type: website locale: pt\_BR lastUpdated: '2026-04-22T12:00:00.000Z' lang: pt-BR ----------- import { Callout } from 'fumadocs-ui/components/callout'; import { Card, Cards } from 'fumadocs-ui/components/card'; import { Step, Steps } from 'fumadocs-ui/components/steps'; import { Tab, Tabs } from 'fumadocs-ui/components/tabs'; Use a API de opções para montar telas de cadeia, acompanhar séries negociadas, consultar histórico EOD e adicionar gregas/volatilidade implícita ao seu produto. O fluxo mais comum é: 1. escolher o **ativo subjacente** 2. descobrir os **vencimentos** 3. ver os **preços de exercício** 4. listar as **séries negociadas** 5. consultar **gregas e volatilidade implícita** 6. pegar o **histórico** de uma série específica Esta seção cobre opções sobre **ações, ETFs e índices** (PETR4, VALE3, BOVA11, IBOV, etc.). Para opções sobre **futuros** (boi gordo, café, milho, soja e similares), veja [Opções sobre Futuros](/docs/futuros/opcoes). A API entrega dados **EOD**: abertura, máxima, mínima, média, fechamento, bid, ask, negócios, volume, volume financeiro, gregas e volatilidade implícita. O arquivo diário é processado após o fechamento do pregão. ## Cobertura e frequência * **Histórico:** a partir de **2009**, com consolidação diária após o fechamento. * **Atualização:** o arquivo EOD é processado **após \~19h de Brasília** (BRT/BRT-3). Até lá, o "último pregão disponível" corresponde ao pregão anterior. * **Contratos cobertos:** opções de ações, ETFs e índices (ex.: IBOV) listados na bolsa brasileira. * **Fuso horário:** todas as datas estão em `America/Sao_Paulo`. Em respostas de preços/histórico, `date` é timestamp Unix em segundos; em respostas de analytics, `date` vem em `YYYY-MM-DD`. * **Formato de datas em query params:** `YYYY-MM-DD`. ## Acesso por plano Opções fazem parte do plano **Pro**. O sandbox abaixo permite experimentação sem token para **PETR4**. | Plano | Acesso a opções | | ------------------- | ------------------- | | Sandbox (sem token) | PETR4 | | Free | Não incluso | | Startup | Não incluso | | **Pro** | **Todos os ativos** | ## Termos que você vai ver * **Ativo subjacente:** a ação, ETF ou índice da opção. Ex.: `PETR4`. * **Vencimento (`expirationDate`):** a data em que a opção vence. Ex.: `2026-05-15`. * **Preço de exercício / strike:** preço combinado na opção. Ex.: `34`. * **Série:** a combinação prática que o mercado negocia. Na resposta da API, aparece como `symbol`, `expirationDate`, `side` e `strike`. * **`symbol`:** o ticker da série (ex.: `PETRE370`), composto pelo ativo subjacente + letra do mês/tipo + identificador do strike (veja abaixo). * **Opção de compra (`call`):** direito de **comprar** o ativo subjacente. * **Opção de venda (`put`):** direito de **vender** o ativo subjacente. * **Titular:** quem compra a opção. Paga o prêmio e exerce o direito se for vantajoso. * **Lançador:** quem vende a opção. Recebe o prêmio e assume a obrigação. * **Prêmio:** preço pago/recebido pela opção. É o que aparece como `close`, `bid`, `ask` no histórico. * **Opção americana:** pode ser exercida a qualquer momento até o vencimento (padrão de opções de ações). * **Opção europeia:** só pode ser exercida no vencimento (padrão de opções de índice, como IBOV). ## Formato do `symbol` O ticker de uma série segue o padrão da bolsa brasileira: **`{ATIVO}{LETRA_MÊS}{ID_STRIKE}`**. * **Ativo:** as 4 letras do subjacente (ex.: `PETR`). * **Letra do mês + tipo:** * `A–L` para **calls** (A = janeiro, B = fevereiro, ..., L = dezembro). * `M–X` para **puts** (M = janeiro, N = fevereiro, ..., X = dezembro). * **ID do strike:** número de 1 a 3 dígitos atribuído pela bolsa para aquele strike no vencimento. Exemplos: * `PETRE370` → **PETR4**, **call** (`E` = maio), strike mapeado como `370`. * `PETRQ28` → **PETR4**, **put** (`Q` = maio), strike mapeado como `28`. O ID do strike **não é o valor em reais**. Para saber o strike em reais, use `/api/v2/options/chain` ou `/api/v2/options/strikes`. ## Início rápido Exemplo do fluxo `vencimentos → séries negociadas → histórico` para opções de **PETR4**. Funciona no sandbox sem token. ```bash # 1) Descubra os vencimentos disponíveis curl "https://brapi.dev/api/v2/options/expirations?underlying=PETR4" # 2) Liste as séries negociadas em um vencimento curl "https://brapi.dev/api/v2/options/chain?underlying=PETR4&expirationDate=2026-05-15" # 3) Consulte o histórico de uma série específica curl "https://brapi.dev/api/v2/options/historical?symbol=PETRE370&expirationDate=2026-05-15" ``` ```typescript const BASE = 'https://brapi.dev/api/v2/options'; const token = process.env.BRAPI_TOKEN; // dispensável para PETR4 no sandbox const headers = token ? { Authorization: `Bearer ${token}` } : undefined; // 1) Vencimentos const expirations = await fetch( `${BASE}/expirations?underlying=PETR4`, { headers }, ).then((r) => r.json()); const nextExpiration = expirations.expirations[0]; // 2) Séries negociadas no vencimento const chain = await fetch( `${BASE}/chain?underlying=PETR4&expirationDate=${nextExpiration}`, { headers }, ).then((r) => r.json()); // 3) Histórico da série ATM mais próxima const firstSeries = chain.series[0]; const history = await fetch( `${BASE}/historical?symbol=${firstSeries.symbol}&expirationDate=${firstSeries.expirationDate}`, { headers }, ).then((r) => r.json()); console.log(history); ``` ```python import os import requests BASE = "https://brapi.dev/api/v2/options" token = os.getenv("BRAPI_TOKEN") # dispensável para PETR4 no sandbox headers = {"Authorization": f"Bearer {token}"} if token else {} # 1) Vencimentos expirations = requests.get( f"{BASE}/expirations", params={"underlying": "PETR4"}, headers=headers ).json() next_exp = expirations["expirations"][0] # 2) Séries negociadas no vencimento chain = requests.get( f"{BASE}/chain", params={"underlying": "PETR4", "expirationDate": next_exp}, headers=headers, ).json() # 3) Histórico da primeira série first_series = chain["series"][0] history = requests.get( f"{BASE}/historical", params={"symbol": first_series["symbol"], "expirationDate": first_series["expirationDate"]}, headers=headers, ).json() print(history) ``` ## Fluxo recomendado #### Descubra os vencimentos Comece em [`/api/v2/options/expirations`](/docs/opcoes/vencimentos) quando você só sabe o ativo, como `PETR4`, e ainda não sabe qual vencimento usar. #### Descubra os preços de exercício Depois de escolher o vencimento, use [`/api/v2/options/strikes`](/docs/opcoes/precos-de-exercicio) para saber quais strikes existem naquele vencimento. #### Liste as séries negociadas Use [`/api/v2/options/chain`](/docs/opcoes/series) para montar a tela que a maioria das pessoas espera ver: séries negociadas por vencimento, com preço e volume. #### Busque o histórico de uma série Quando você já sabe qual série quer acompanhar, use [`/api/v2/options/historical`](/docs/opcoes/historico) com `symbol` e `expirationDate`. Se precisar, informe também `strike`. #### Consulte gregas e IV Use [`/api/v2/options/analytics`](/docs/opcoes/analytics) para a foto EOD de um vencimento, ou [`/api/v2/options/analytics/history`](/docs/opcoes/analytics-historico) para a série temporal de uma opção específica. ## Casos de uso mais comuns * **Tela simples de opções no seu app:** `expirations -> chain` * **Filtro por strike:** `expirations -> strikes -> chain` * **Gregas e volatilidade implícita por vencimento:** `expirations -> analytics` * **Gráfico de uma opção específica:** `chain -> historical` * **Backtest ou persistência diária:** escolher a série via `chain` e depois buscar o histórico em `historical` e `analytics/history` ## Quando você pode pular etapas * Se você **já sabe o vencimento**, pode ir direto para `strikes` ou `chain`. * Se você **já sabe a série**, pode ir direto para `historical`. * Se você quer só montar uma tela simples por vencimento, pode **pular `strikes`** e ir direto para `chain`. ## Perguntas frequentes ## Receitas prontas Guias e tutoriais publicados no blog com código pronto para copiar: ## Próximas melhorias O foco atual é histórico EOD, cadeia, strikes, vencimentos, gregas e IV. As próximas frentes em avaliação são: * Snapshots intraday durante o pregão. * Interesse em aberto por série. Pedidos de clientes ajudam a definir a ordem dessas entregas. ## Sandbox sem token Para facilitar a experimentação, todos os endpoints de opções aceitam consultas no sandbox sem token, restritas a opções de **PETR4**: * `GET /api/v2/options/expirations`, `/strikes` e `/chain`: apenas com `underlying=PETR4`. * `GET /api/v2/options/analytics`: apenas com `underlying=PETR4`. * `GET /api/v2/options/historical`: apenas com `symbol` começando com `PETR` (ou seja, opções do subjacente PETR4). * `GET /api/v2/options/analytics/history`: apenas com `symbol` começando com `PETR`. Para qualquer outro ativo, é necessário autenticar com um token do plano Pro. ## Endpoints # Preços de Exercício de Opções URL: /docs/opcoes/precos-de-exercicio.mdx Liste os preços de exercício disponíveis para um vencimento de opções, com filtro opcional por compra (call) ou venda (put). *** title: Preços de Exercício de Opções description: >- Liste os preços de exercício disponíveis para um vencimento de opções, com filtro opcional por compra (call) ou venda (put). full: true keywords: brapi, api, opções, strike, preço de exercício openGraph: title: Preços de Exercício de Opções description: >- Liste os preços de exercício disponíveis para um vencimento de opções. type: website locale: pt\_BR lastUpdated: '2026-04-22T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/options/strikes structuredData: headings: \[] contents: * content: >- Retorna os strikes disponíveis em um vencimento específico, a partir das séries negociadas. Útil para montar um seletor de strike antes de consultar as séries negociadas. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna os strikes disponíveis em um vencimento específico, a partir das séries negociadas. Use `side=call` ou `side=put` para filtrar por tipo de opção. Se você não precisa desta etapa intermediária, pode ir direto para [Séries Negociadas](/docs/opcoes/series) e filtrar por faixa de strike com `minStrike` e `maxStrike`. **Plano mínimo: Pro.** No sandbox sem token, aceita apenas `underlying=PETR4`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/options/strikes Single endpoint documentation for /api/v2/options/strikes ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/options/strikes **Summary:** Listar preços de exercício de opções Retorna os strikes disponíveis em um vencimento específico. Sem token, o sandbox aceita apenas `underlying=PETR4`. **Tags:** Opções ### Parameters - **underlying** (query) *required* - **expirationDate** (query) *required* - **side** (query) ### Responses #### 200 Preços de exercício retornados com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### OptionStrikesResponse **Properties:** - **underlying** (string) *(required)* Ativo subjacente consultado, normalizado em maiúsculas. - **expirationDate** (string) *(required)* Vencimento consultado, no formato YYYY-MM-DD. - **side** (string) - Options: `call`, `put` *(nullable)* *(required)* Lado filtrado: `call`, `put` ou `null` quando não foi aplicado filtro. - **tradedOnly** (boolean) - Options: `true` *(required)* Sempre `true`: os strikes vêm apenas de séries negociadas. - **strikes** (array) *(required)* Preços de exercício disponíveis, em ordem ascendente. Array items: **Type:** number - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # Séries Negociadas de Opções URL: /docs/opcoes/series.mdx Consulte as séries negociadas de opções para um vencimento específico, com preço, volume e filtros por compra/venda e faixa de strike. *** title: Séries Negociadas de Opções description: >- Consulte as séries negociadas de opções para um vencimento específico, com preço, volume e filtros por compra/venda e faixa de strike. full: true keywords: brapi, api, opções, séries, vencimento openGraph: title: Séries Negociadas de Opções description: >- Consulte as séries negociadas de opções para um vencimento específico. type: website locale: pt\_BR lastUpdated: '2026-04-22T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/options/chain structuredData: headings: \[] contents: * content: >- Retorna as séries negociadas de um vencimento com metadados do contrato e OHLCV do último pregão disponível até a data pedida. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna as séries negociadas de um vencimento com metadados do contrato (`symbol`, `side`, `strike`, `expirationDate`) e OHLCV do último pregão disponível até a data pedida. Este é o endpoint principal para montar uma tela de opções por vencimento. Apesar do caminho ser `/chain`, na documentação chamamos isso de **séries negociadas**, porque esse nome faz mais sentido para o público brasileiro. **Plano mínimo: Pro.** No sandbox sem token, aceita apenas `underlying=PETR4`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/options/chain Single endpoint documentation for /api/v2/options/chain ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/options/chain **Summary:** Listar séries negociadas de opções Retorna as séries negociadas de um vencimento, combinando metadados do contrato com o último OHLCV disponível até a data solicitada. Sem token, o sandbox aceita apenas `underlying=PETR4`. **Tags:** Opções ### Parameters - **underlying** (query) *required* - **expirationDate** (query) *required* - **date** (query) - **side** (query) - **minStrike** (query) - **maxStrike** (query) ### Responses #### 200 Séries retornadas com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 500 Erro interno do servidor #### 503 Serviço externo temporariamente indisponível ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### OptionSeriesResponse **Properties:** - **underlying** (string) *(required)* Ativo subjacente consultado, normalizado em maiúsculas. - **expirationDate** (string) *(required)* Vencimento consultado, no formato YYYY-MM-DD. - **date** (string) *(required)* Data EOD efetivamente usada para buscar preço e volume, no formato YYYY-MM-DD. - **tradedOnly** (boolean) - Options: `true` *(required)* Sempre `true`: só aparecem séries que tiveram negócio no pregão selecionado. - **series** (array) *(required)* Séries negociadas no vencimento, com metadados do contrato e OHLCV do pregão em `date`. Array items: Reference to: **OptionSeriesSnapshot** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### OptionSeriesSnapshot **Properties:** - **symbol** (string) *(required)* Código de negociação da série (ex: PETRF783). - **underlyingSymbol** (string) *(nullable)* *(required)* Ativo subjacente da opção (ex: PETR4). - **side** (string) - Options: `call`, `put` *(required)* Tipo da opção: `call` (opção de compra) ou `put` (opção de venda). - **market** (string) - Options: `equity`, `index` *(required)* Mercado da opção: `equity` (ação/ETF) ou `index` (índice). - **optionStyle** (string) - Options: `american`, `european` *(nullable)* *(required)* Estilo de exercício da opção: `american` permite exercício a qualquer momento até o vencimento; `european` permite exercício apenas no vencimento. `null` em séries antigas que ainda não passaram pelo enriquecimento de cadastro. - **strike** (number) *(nullable)* *(required)* Preço de exercício (strike) da opção. - **allocationRoundLot** (integer) *(nullable)* *(required)* Tamanho do lote pré-definido para alocação. Geralmente 100 para opções sobre ações brasileiras. - **expirationDate** (string) *(required)* Data de vencimento da série, no formato YYYY-MM-DD. - **firstTradeDate** (string) *(required)* Data do primeiro pregão observado para a série (YYYY-MM-DD). - **lastTradeDate** (string) *(required)* Data do último pregão observado para a série (YYYY-MM-DD). - **date** (integer) *(required)* Data do pregão em timestamp Unix (segundos). - **open** (number) *(nullable)* *(required)* Preço de abertura do pregão. - **high** (number) *(nullable)* *(required)* Máxima do pregão. - **low** (number) *(nullable)* *(required)* Mínima do pregão. - **average** (number) *(nullable)* *(required)* Preço médio do pregão. - **close** (number) *(nullable)* *(required)* Preço de fechamento do pregão. - **bid** (number) *(nullable)* *(required)* Melhor oferta de compra registrada no fechamento. - **ask** (number) *(nullable)* *(required)* Melhor oferta de venda registrada no fechamento. - **trades** (number) *(nullable)* *(required)* Número de negócios realizados no pregão. - **volume** (number) *(nullable)* *(required)* Volume negociado no pregão (em contratos). - **financialVolume** (number) *(nullable)* *(required)* Volume financeiro negociado no pregão (em BRL). # Vencimentos de Opções URL: /docs/opcoes/vencimentos.mdx Liste os vencimentos disponíveis de opções por ativo subjacente, de um jeito simples para descobrir qual série consultar depois. *** title: Vencimentos de Opções description: >- Liste os vencimentos disponíveis de opções por ativo subjacente, de um jeito simples para descobrir qual série consultar depois. full: true keywords: brapi, api, opções, vencimentos openGraph: title: Vencimentos de Opções description: >- Liste os vencimentos disponíveis de opções por ativo subjacente. type: website locale: pt\_BR lastUpdated: '2026-04-22T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/options/expirations structuredData: headings: \[] contents: * content: >- Retorna os vencimentos de opções disponíveis para um ativo subjacente, como `PETR4`. Use como primeiro passo antes de consultar strikes ou séries negociadas. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna os vencimentos de opções disponíveis para um ativo subjacente (ação, ETF ou índice). Por padrão, mostra apenas vencimentos futuros — envie `includeExpired=true` para incluir vencimentos passados. Use este endpoint como ponto de partida quando você ainda não sabe qual vencimento consultar. Veja o fluxo completo em [Opções](/docs/opcoes). **Plano mínimo: Pro.** No sandbox sem token, aceita apenas `underlying=PETR4`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/options/expirations Single endpoint documentation for /api/v2/options/expirations ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/options/expirations **Summary:** Listar vencimentos de opções Retorna os vencimentos disponíveis para um ativo subjacente. Sem token, o sandbox aceita apenas `underlying=PETR4`. **Tags:** Opções ### Parameters - **underlying** (query) *required* - **includeExpired** (query) ### Responses #### 200 Vencimentos retornados com sucesso. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### OptionExpirationsResponse **Properties:** - **underlying** (string) *(required)* Ativo subjacente consultado, normalizado em maiúsculas. - **tradedOnly** (boolean) - Options: `true` *(required)* Sempre `true`: a lista é montada a partir das séries negociadas. - **expirations** (array) *(required)* Datas de vencimento disponíveis, em ordem ascendente, no formato YYYY-MM-DD. Array items: **Type:** string - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # SDKs Oficiais URL: /docs/sdks.mdx SDKs oficiais da brapi.dev para TypeScript/JavaScript e Python. Integre a API da bolsa brasileira com tipos, retry automático e erros específicos. *** title: 'SDKs Oficiais' description: >- SDKs oficiais da brapi.dev para TypeScript/JavaScript e Python. Integre a API da bolsa brasileira com tipos, retry automático e erros específicos. full: false keywords: brapi, sdk, typescript, python, npm, pypi, api client, developer tools openGraph: title: SDKs Oficiais - brapi.dev description: >- Bibliotecas oficiais para integração rápida e tipada com a API da bolsa brasileira type: website locale: pt\_BR lastUpdated: '2025-10-12T20:10:00.000Z' lang: pt-BR ----------- Use as SDKs oficiais quando quiser chamar a brapi com tipos, retry e tratamento de erros já configurados. Elas são úteis para backends, scripts, dashboards e integrações que consultam a API com frequência. ## Por que usar as SDKs? ### Requisição HTTP manual ```typescript const response = await fetch("https://brapi.dev/api/quote/PETR4", { headers: { Authorization: `Bearer ${token}` }, }); if (!response.ok) throw new Error(`HTTP ${response.status}`); const data = await response.json(); const price = data.results[0].regularMarketPrice; // sem tipos gerados ``` ### Com SDK ```typescript const quote = await client.quote.retrieve('PETR4'); const price = quote.results[0].regularMarketPrice; // tipado pelo SDK ``` As SDKs reduzem boilerplate e deixam explícitos os casos importantes: * tipos para autocomplete e validação no editor * retry configurável * erros específicos por status * clientes síncronos ou assíncronos, dependendo da linguagem * mesma autenticação da API REST *** ## SDKs disponíveis ### TypeScript / JavaScript SDK oficial para TypeScript e JavaScript com suporte a Node.js e navegador. #### Instalação ```bash npm install brapi # ou yarn add brapi # ou pnpm add brapi # ou bun add brapi ``` #### Exemplo rápido ```typescript import Brapi from 'brapi'; const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, }); const quote = await client.quote.retrieve('PETR4'); console.log(quote.results[0].regularMarketPrice); ``` #### Características * Tipos TypeScript * Suporte a Node.js e navegador * Bundle tree-shakeable * Integração com Next.js, Express e outros frameworks * Retry automático configurável **Links:** * [Documentação TypeScript](/docs/sdks/typescript) * [Pacote no npm](https://www.npmjs.com/package/brapi) * [Repositório no GitHub](https://github.com/brapi-dev/brapi-typescript) *** ### Python Versão no PyPI SDK oficial para Python 3.8+ com suporte síncrono e assíncrono. #### Instalação ```bash pip install brapi # Com suporte a aiohttp (opcional, melhor performance) pip install brapi[aiohttp] ``` #### Exemplo rápido (síncrono) ```python from brapi import Brapi client = Brapi(api_key="seu_token") quote = client.quote.retrieve(tickers="PETR4") print(quote.results[0].regular_market_price) ``` #### Exemplo rápido (assíncrono) ```python import asyncio from brapi import AsyncBrapi async def main(): async with AsyncBrapi(api_key="seu_token") as client: quote = await client.quote.retrieve(tickers="PETR4") print(quote.results[0].regular_market_price) asyncio.run(main()) ``` #### Características * Type hints * Cliente síncrono e assíncrono * httpx com suporte a HTTP/2 * Integração com Flask, FastAPI e Pandas * Context managers **Links:** * [Documentação Python](/docs/sdks/python) * [Pacote no PyPI](https://pypi.org/project/brapi/) * [Repositório no GitHub](https://github.com/brapi-dev/brapi-python) *** ## Comparação | Feature | TypeScript/JS | Python | | ---------------- | ------------- | ---------- | | Tipos | TypeScript | Type hints | | Autocomplete IDE | Sim | Sim | | Sync/Async | Async | Ambos | | Retry automático | Sim | Sim | | Erros tipados | Sim | Sim | | HTTP/2 | Sim | Sim | | Bundle size | Pequeno | N/A | | Python 3.8+ | N/A | Sim | | Node.js/Browser | Sim | N/A | *** ## Casos de Uso ### 1. Aplicações Web **Next.js / React:** ```typescript import Brapi from 'brapi'; // Server Component const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY }); const quote = await client.quote.retrieve('PETR4'); ``` **FastAPI / Flask:** ```python from fastapi import FastAPI from brapi import AsyncBrapi app = FastAPI() client = AsyncBrapi(api_key="seu_token") @app.get("/quote/{ticker}") async def get_quote(ticker: str): quote = await client.quote.retrieve(tickers=ticker) return quote.results[0] ``` ### 2. Análise de Dados **Python com Pandas:** ```python import pandas as pd from brapi import Brapi client = Brapi(api_key="seu_token") # Buscar múltiplas cotações tickers = "PETR4,VALE3,ITUB4" quote = client.quote.retrieve(tickers=tickers) # Converter para DataFrame df = pd.DataFrame([ { 'symbol': r.symbol, 'price': r.regular_market_price, 'change': r.regular_market_change_percent } for r in quote.results ]) print(df) ``` ### 3. Scripts e Automação **Monitoramento de Preços:** ```python from brapi import Brapi import time client = Brapi(api_key="seu_token") while True: quote = client.quote.retrieve(tickers="PETR4") price = quote.results[0].regular_market_price print(f"PETR4: R$ {price:.2f}") time.sleep(60) # Atualiza a cada minuto ``` ### 4. APIs e Microsserviços **Express.js API:** ```typescript import express from 'express'; import Brapi from 'brapi'; const app = express(); const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY }); app.get('/api/quote/:ticker', async (req, res) => { try { const quote = await client.quote.retrieve(req.params.ticker); res.json(quote); } catch (error) { res.status(500).json({ error: error.message }); } }); app.listen(3000); ``` ### 5. Dashboards e Visualizações **TypeScript com Chart.js:** ```typescript const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY }); async function updateChart() { const quote = await client.quote.retrieve('PETR4,VALE3,ITUB4'); const labels = quote.results.map(r => r.symbol); const prices = quote.results.map(r => r.regularMarketPrice); // Atualizar gráfico com os dados chart.data.labels = labels; chart.data.datasets[0].data = prices; chart.update(); } ``` *** ## Recursos suportados Ambas as SDKs suportam todos os endpoints da API: ### Mercado Brasileiro * **Cotações** - ações, ETFs, FIIs e BDRs * **Dados fundamentalistas** - balanços, DRE e indicadores * **Dividendos** - histórico de proventos * **Histórico** - preços históricos ### Criptomoedas * **Preços** - Bitcoin, Ethereum e outros criptoativos * **Lista de moedas disponíveis** ### Indicadores Econômicos * **Inflação** - IPCA, IGP-M e outros índices * **Taxa de juros** - SELIC e CDI * **Câmbio** - USD, EUR e outras moedas *** ## Tratamento de erros Ambas as SDKs lançam exceções específicas por tipo de erro: ### TypeScript ```typescript import Brapi from 'brapi'; try { const quote = await client.quote.retrieve('INVALID'); } catch (error) { if (error instanceof Brapi.NotFoundError) { console.log('Ticker não encontrado'); } else if (error instanceof Brapi.RateLimitError) { console.log('Limite de requisições atingido'); } else if (error instanceof Brapi.AuthenticationError) { console.log('Token inválido'); } } ``` ### Python ```python from brapi import Brapi, NotFoundError, RateLimitError try: quote = client.quote.retrieve(tickers="INVALID") except NotFoundError: print("Ticker não encontrado") except RateLimitError: print("Limite de requisições atingido") ``` *** ## Configuração avançada ### Retry automático ```typescript // TypeScript const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, maxRetries: 3, // Tenta até 3 vezes }); ``` ```python # Python client = Brapi( api_key="seu_token", max_retries=3, # Tenta até 3 vezes ) ``` ### Timeouts ```typescript // TypeScript const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, timeout: 10000, // 10 segundos }); ``` ```python # Python client = Brapi( api_key="seu_token", timeout=10.0, # 10 segundos ) ``` *** ## Como as SDKs são mantidas As SDKs são geradas com [Stainless](https://www.stainless.com/) a partir da especificação da API. Isso mantém tipos, métodos e documentação inline alinhados com os endpoints publicados. * Tipos gerados a partir da especificação * Documentação inline nos clientes * Testes automáticos nos repositórios das SDKs *** ## Começar a usar Escolha a SDK da sua linguagem: ### TypeScript / JavaScript ```bash npm install brapi ``` **[Ver documentação TypeScript](/docs/sdks/typescript)** **Links:** * [Pacote no npm](https://www.npmjs.com/package/brapi) * [Repositório no GitHub](https://github.com/brapi-dev/brapi-typescript) *** ### Python ```bash pip install brapi ``` **[Ver documentação Python](/docs/sdks/python)** **Links:** * [Pacote no PyPI](https://pypi.org/project/brapi/) * [Repositório no GitHub](https://github.com/brapi-dev/brapi-python) *** ## Futuras SDKs Estamos trabalhando em SDKs para: * **Go** - em desenvolvimento * **PHP** - planejado * **Java** - planejado * **Ruby** - planejado Sugestões de SDKs podem ser enviadas pelo [GitHub](https://github.com/brapi-dev). *** ## Suporte e comunidade * [GitHub Discussions](https://github.com/brapi-dev) * [Reportar bug](https://github.com/brapi-dev) * [Email de suporte](mailto:contato@brapi.dev) * [Documentação da API](/docs) *** ## Open Source As SDKs são **open source** e licenciadas sob MIT. * [GitHub](https://github.com/brapi-dev) * [Contribuir](https://github.com/brapi-dev) * [Changelog](https://github.com/brapi-dev) # SDK Python URL: /docs/sdks/python.mdx SDK oficial Python da brapi.dev. Biblioteca completa com type hints, suporte síncrono e assíncrono, integração com asyncio e aiohttp, tratamento de erros automático. *** title: 'SDK Python' description: >- SDK oficial Python da brapi.dev. Biblioteca completa com type hints, suporte síncrono e assíncrono, integração com asyncio e aiohttp, tratamento de erros automático. full: false keywords: brapi, sdk, python, pip, api client, asyncio, httpx openGraph: title: SDK Python - brapi.dev description: >- SDK oficial Python com type hints e suporte síncrono e assíncrono type: website locale: pt\_BR lastUpdated: '2025-10-12T20:00:00.000Z' lang: pt-BR howToSteps: * name: 'Instale a SDK via pip' text: 'Execute pip install brapi no terminal. Para melhor performance async, use pip install brapi\[aiohttp].' * name: 'Configure a variável de ambiente com seu token' text: 'Crie um arquivo .env com BRAPI\_API\_KEY=seu\_token\_aqui e use python-dotenv para carregar: from dotenv import load\_dotenv; load\_dotenv().' * name: 'Importe e inicialize o cliente Brapi' text: 'No seu código Python, importe com from brapi import Brapi e crie uma instância: client = Brapi(api\_key=os.environ.get("BRAPI\_API\_KEY")).' * name: 'Busque cotações com o cliente síncrono ou assíncrono' text: 'Use quote = client.quote.retrieve(tickers="PETR4") para síncrono, ou await client.quote.retrieve(tickers="PETR4") com AsyncBrapi para async.' * name: 'Trate erros usando as exceções tipadas' text: 'Importe exceções como NotFoundError, RateLimitError e use try/except para tratamento específico de cada tipo de erro.' howToTools: * 'Python 3.8+' * 'pip' * 'Editor de código' howToSupplies: * 'Conta brapi.dev' * 'Token de API brapi.dev' * 'Ambiente Python configurado' *** SDK oficial da brapi.dev para Python 3.8+, oferecendo acesso conveniente à API REST com type hints completos e suporte síncrono e assíncrono. ## Características * ✅ **Type hints completos** - Autocomplete e validação no IDE * ✅ **Python 3.8+** - Compatível com versões modernas * ✅ **Sync e Async** - Cliente síncrono e assíncrono * ✅ **Powered by httpx** - HTTP/2 e connection pooling * ✅ **Suporte aiohttp** - Performance assíncrona otimizada * ✅ **Tratamento de erros** - Exceções tipadas e descritivas * ✅ **Retry automático** - Tratamento inteligente de falhas * ✅ **Gerado com Stainless** - Sempre atualizado com a API ## Instalação ```bash pip install brapi ``` Com suporte a aiohttp (opcional, para melhor performance async): ```bash pip install brapi[aiohttp] ``` Versão no PyPI ## Início Rápido ### Cliente Síncrono ```python import os from brapi import Brapi client = Brapi( api_key=os.environ.get("BRAPI_API_KEY"), ) # Buscar cotação quote = client.quote.retrieve(tickers="PETR4") print(quote.results[0].regular_market_price) # Múltiplas ações quotes = client.quote.retrieve(tickers="PETR4,VALE3,ITUB4") for stock in quotes.results: print(f"{stock.symbol}: R$ {stock.regular_market_price}") ``` ### Cliente Assíncrono ```python import os import asyncio from brapi import AsyncBrapi client = AsyncBrapi( api_key=os.environ.get("BRAPI_API_KEY"), ) async def main(): quote = await client.quote.retrieve(tickers="PETR4") print(quote.results[0].regular_market_price) asyncio.run(main()) ``` ## Configuração ### Variáveis de Ambiente Recomendamos usar `python-dotenv` para gerenciar variáveis de ambiente: ```bash pip install python-dotenv ``` Crie um arquivo `.env`: ```bash BRAPI_API_KEY=seu_token_aqui ``` No seu código: ```python import os from dotenv import load_dotenv from brapi import Brapi load_dotenv() client = Brapi( api_key=os.environ.get("BRAPI_API_KEY"), ) ``` ### Opções do Cliente ```python client = Brapi( api_key="seu_token", environment="production", # 'production' ou 'sandbox' max_retries=2, # Número de tentativas (padrão: 2) timeout=60.0, # Timeout em segundos (padrão: 60) ) ``` ## Exemplos de Uso ### Cotações ```python # Cotação única quote = client.quote.retrieve(tickers="PETR4") stock = quote.results[0] print(f"Símbolo: {stock.symbol}") print(f"Nome: {stock.short_name}") print(f"Preço: R$ {stock.regular_market_price}") print(f"Variação: {stock.regular_market_change_percent}%") # Com módulos adicionais quote_with_data = client.quote.retrieve( tickers="PETR4", modules="summaryProfile,balanceSheetHistory" ) ``` ### Lista de Ações ```python # Todas as ações disponíveis stocks = client.quote.list() for stock in stocks.stocks: print(f"{stock.stock}: {stock.name} ({stock.type})") # Com paginação stocks_page = client.quote.list(page=1, limit=50) ``` ### Criptomoedas ```python # Cotação de cripto crypto = client.crypto.retrieve(coin="BTC") print(f"Bitcoin: ${crypto.currency}") # Lista de criptos disponíveis cryptos = client.crypto.available() for coin in cryptos.coins: print(f"{coin.coin}: {coin.name}") ``` ### Moedas ```python # Cotação de moeda currency = client.currency.retrieve(currency="USD-BRL") print(f"Dólar: R$ {currency.ask}") # Lista de moedas disponíveis currencies = client.currency.available() ``` ### Inflação ```python # Dados de inflação do Brasil inflation = client.inflation.retrieve(country="brazil") print(f"IPCA: {inflation.IPCA}") # Países disponíveis countries = client.inflation.available() ``` ### Taxa de Juros ```python # Taxa SELIC selic = client.prime_rate.retrieve(country="brazil") print(f"SELIC: {selic.value}%") # Países disponíveis countries = client.prime_rate.available() ``` ## Cliente Assíncrono ### Com httpx (padrão) ```python import asyncio from brapi import AsyncBrapi async def main(): client = AsyncBrapi(api_key="seu_token") # Todas as operações usam await quote = await client.quote.retrieve(tickers="PETR4") print(quote.results[0].regular_market_price) # Não esqueça de fechar o cliente await client.close() asyncio.run(main()) ``` ### Com Context Manager ```python import asyncio from brapi import AsyncBrapi async def main(): async with AsyncBrapi(api_key="seu_token") as client: quote = await client.quote.retrieve(tickers="PETR4") print(quote.results[0].regular_market_price) # Cliente fechado automaticamente asyncio.run(main()) ``` ### Com aiohttp (melhor performance) ```python import asyncio from brapi import AsyncBrapi, DefaultAioHttpClient async def main(): async with AsyncBrapi( api_key="seu_token", http_client=DefaultAioHttpClient(), ) as client: quote = await client.quote.retrieve(tickers="PETR4") print(quote.results[0].regular_market_price) asyncio.run(main()) ``` ### Requisições Concorrentes ```python import asyncio from brapi import AsyncBrapi async def get_multiple_quotes(): async with AsyncBrapi(api_key="seu_token") as client: # Buscar várias cotações em paralelo tasks = [ client.quote.retrieve(tickers="PETR4"), client.quote.retrieve(tickers="VALE3"), client.quote.retrieve(tickers="ITUB4"), ] results = await asyncio.gather(*tasks) for quote in results: stock = quote.results[0] print(f"{stock.symbol}: R$ {stock.regular_market_price}") asyncio.run(get_multiple_quotes()) ``` ## Tratamento de Erros ```python from brapi import Brapi from brapi import ( APIError, BadRequestError, AuthenticationError, NotFoundError, RateLimitError, ) client = Brapi(api_key="seu_token") try: quote = client.quote.retrieve(tickers="INVALID") except NotFoundError as e: print(f"Ticker não encontrado: {e}") except RateLimitError as e: print(f"Limite de requisições: {e}") except AuthenticationError as e: print(f"Token inválido: {e}") except APIError as e: print(f"Erro na API: {e}") ``` ### Tipos de Exceção | Exception | Status | Descrição | | -------------------------- | ------ | ---------------------- | | `BadRequestError` | 400 | Requisição inválida | | `AuthenticationError` | 401 | Token inválido | | `PermissionDeniedError` | 403 | Sem permissão | | `NotFoundError` | 404 | Recurso não encontrado | | `UnprocessableEntityError` | 422 | Dados inválidos | | `RateLimitError` | 429 | Limite de requisições | | `InternalServerError` | 5xx | Erro no servidor | | `APIConnectionError` | N/A | Erro de conexão | ## Integração com Flask ```python from flask import Flask, jsonify from brapi import Brapi app = Flask(__name__) client = Brapi(api_key="seu_token") @app.route('/api/quote/') def get_quote(ticker): try: quote = client.quote.retrieve(tickers=ticker) return jsonify({ 'symbol': quote.results[0].symbol, 'price': quote.results[0].regular_market_price, }) except NotFoundError: return jsonify({'error': 'Ticker not found'}), 404 if __name__ == '__main__': app.run() ``` ## Integração com FastAPI ```python from fastapi import FastAPI, HTTPException from brapi import AsyncBrapi, NotFoundError app = FastAPI() client = AsyncBrapi(api_key="seu_token") @app.get("/api/quote/{ticker}") async def get_quote(ticker: str): try: quote = await client.quote.retrieve(tickers=ticker) return { 'symbol': quote.results[0].symbol, 'price': quote.results[0].regular_market_price, } except NotFoundError: raise HTTPException(status_code=404, detail="Ticker not found") @app.on_event("shutdown") async def shutdown(): await client.close() ``` ## Integração com Pandas ```python import pandas as pd from brapi import Brapi client = Brapi(api_key="seu_token") def get_quotes_dataframe(tickers: list[str]) -> pd.DataFrame: """Retorna cotações como DataFrame""" tickers_str = ','.join(tickers) quote = client.quote.retrieve(tickers=tickers_str) data = [] for stock in quote.results: data.append({ 'symbol': stock.symbol, 'name': stock.short_name, 'price': stock.regular_market_price, 'change_percent': stock.regular_market_change_percent, }) return pd.DataFrame(data) # Uso df = get_quotes_dataframe(['PETR4', 'VALE3', 'ITUB4']) print(df) # Salvar em Excel df.to_excel('cotacoes.xlsx', index=False) ``` ## Timeouts ```python # Timeout global client = Brapi( api_key="seu_token", timeout=10.0, # 10 segundos ) # Timeout por requisição quote = client.quote.retrieve( tickers="PETR4", timeout=5.0, # 5 segundos ) ``` ## Retry Automático ```python # Configurar retries client = Brapi( api_key="seu_token", max_retries=3, # Tenta até 3 vezes ) # Desabilitar retries client = Brapi( api_key="seu_token", max_retries=0, # Sem retry ) ``` ## Type Hints A SDK inclui type hints completos para todas as operações: ```python from brapi import Brapi from brapi.types import QuoteRetrieveResponse client: Brapi = Brapi(api_key="seu_token") # Type checking automático quote: QuoteRetrieveResponse = client.quote.retrieve(tickers="PETR4") # Autocomplete no IDE price: float = quote.results[0].regular_market_price ``` ## Boas Práticas ### 1. Reutilize o Cliente ```python # ✅ Bom - Crie uma instância e reutilize from brapi import Brapi client = Brapi(api_key="seu_token") def get_quote(ticker): return client.quote.retrieve(tickers=ticker) # ❌ Ruim - Criar nova instância a cada uso def get_quote(ticker): client = Brapi(api_key="seu_token") # Não faça isso return client.quote.retrieve(tickers=ticker) ``` ### 2. Use Variáveis de Ambiente ```python # ✅ Bom import os from brapi import Brapi client = Brapi(api_key=os.environ.get("BRAPI_API_KEY")) # ❌ Ruim - Nunca hardcode o token client = Brapi(api_key="meu-token-secreto") # Não faça isso! ``` ### 3. Use Context Manager com Async ```python # ✅ Bom async with AsyncBrapi(api_key="seu_token") as client: quote = await client.quote.retrieve(tickers="PETR4") # Cliente fechado automaticamente # ❌ Ruim client = AsyncBrapi(api_key="seu_token") quote = await client.quote.retrieve(tickers="PETR4") # Esqueceu de fechar! ``` ## Links Úteis * 📦 [Pacote PyPI](https://pypi.org/project/brapi/) * 🔧 [Repositório GitHub](https://github.com/brapi-dev/brapi-python) * 📚 [Documentação Completa da API](/docs) * 🐛 [Reportar Bug](https://github.com/brapi-dev/brapi-python/issues) ## Suporte Precisa de ajuda? Entre em contato: * 💬 [Abra uma issue](https://github.com/brapi-dev/brapi-python/issues) * 📧 [Suporte por email](mailto:contato@brapi.dev) * 📖 [Documentação completa](/docs) ## Contribuindo Contribuições são bem-vindas! Veja o [guia de contribuição](https://github.com/brapi-dev/brapi-python/blob/main/CONTRIBUTING.md). ## Licença MIT License - veja [LICENSE](https://github.com/brapi-dev/brapi-python/blob/main/LICENSE) para detalhes. # SDK TypeScript/JavaScript URL: /docs/sdks/typescript.mdx SDK oficial TypeScript/JavaScript da brapi.dev. Biblioteca completa com tipos TypeScript, suporte a Node.js e navegador, tratamento de erros automático e retry inteligente. *** title: 'SDK TypeScript/JavaScript' description: >- SDK oficial TypeScript/JavaScript da brapi.dev. Biblioteca completa com tipos TypeScript, suporte a Node.js e navegador, tratamento de erros automático e retry inteligente. full: false keywords: brapi, sdk, typescript, javascript, npm, api client, node.js openGraph: title: SDK TypeScript/JavaScript - brapi.dev description: >- SDK oficial TypeScript/JavaScript com tipos completos e suporte a async/await type: website locale: pt\_BR lastUpdated: '2025-10-12T20:00:00.000Z' lang: pt-BR howToSteps: * name: 'Instale a SDK via npm, yarn ou bun' text: 'Execute npm install brapi (ou yarn add brapi, bun add brapi) no terminal do seu projeto para instalar a SDK oficial.' * name: 'Configure a variável de ambiente com seu token' text: 'Crie um arquivo .env e adicione BRAPI\_API\_KEY=seu\_token\_aqui. Nunca exponha o token diretamente no código.' * name: 'Importe e inicialize o cliente Brapi' text: 'No seu código TypeScript/JavaScript, importe com import Brapi from "brapi" e crie uma instância: const client = new Brapi({ apiKey: process.env.BRAPI\_API\_KEY }).' * name: 'Busque cotações usando async/await' text: 'Use const quote = await client.quote.retrieve("PETR4") para obter cotações. O resultado já vem tipado com IntelliSense completo.' * name: 'Trate erros usando as exceções tipadas' text: 'Envolva as chamadas em try/catch e verifique tipos de erro como Brapi.NotFoundError, Brapi.RateLimitError para tratamento específico.' howToTools: * 'Node.js' * 'npm, yarn, pnpm ou bun' * 'Editor de código (VS Code recomendado)' howToSupplies: * 'Conta brapi.dev' * 'Token de API brapi.dev' * 'Projeto Node.js ou TypeScript' *** SDK oficial da brapi.dev para TypeScript e JavaScript, oferecendo acesso conveniente à API REST com tipos completos e suporte a async/await. ## Características * ✅ **Tipos TypeScript completos** - IntelliSense e autocomplete * ✅ **Suporte a Node.js e Browser** - Funciona em qualquer ambiente * ✅ **Async/Await nativo** - API moderna e fácil de usar * ✅ **Retry automático** - Tratamento inteligente de falhas * ✅ **Tratamento de erros** - Erros tipados e descritivos * ✅ **Tree-shakeable** - Bundle otimizado * ✅ **Gerado com Stainless** - Sempre atualizado com a API ## Instalação ```bash npm install brapi # ou yarn add brapi # ou pnpm add brapi # ou bun add brapi ``` ## Início Rápido ### JavaScript ```javascript const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, }); // Buscar cotação de uma ação const quote = await client.quote.retrieve('PETR4'); console.log(quote.results[0].regularMarketPrice); // Buscar múltiplas ações const quotes = await client.quote.retrieve('PETR4,VALE3,ITUB4'); console.log(quotes.results); ``` ### TypeScript ```typescript const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, }); // Tipos automáticos! const quote: Brapi.QuoteRetrieveResponse = await client.quote.retrieve('PETR4'); // IntelliSense completo const price = quote.results[0].regularMarketPrice; const change = quote.results[0].regularMarketChangePercent; ``` ## Configuração ### Variáveis de Ambiente Crie um arquivo `.env`: ```bash BRAPI_API_KEY=seu_token_aqui ``` ### Opções do Cliente ```typescript const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, // Obrigatório environment: 'production', // 'production' ou 'sandbox' maxRetries: 2, // Número de tentativas (padrão: 2) timeout: 60000, // Timeout em ms (padrão: 60000) }); ``` ## Exemplos de Uso ### Cotações ```typescript // Cotação única const quote = await client.quote.retrieve('PETR4'); // Múltiplas cotações const quotes = await client.quote.retrieve('PETR4,VALE3,ITUB4'); // Com parâmetros adicionais const quoteWithModules = await client.quote.retrieve('PETR4', { modules: 'summaryProfile,balanceSheetHistory', }); // Resultado console.log(quote.results[0]); // { // symbol: 'PETR4', // shortName: 'PETROBRAS PN', // regularMarketPrice: 38.45, // regularMarketChangePercent: 2.15, // currency: 'BRL', // ... // } ``` ### Lista de Ações ```typescript // Listar todas as ações disponíveis const stocks = await client.quote.list(); // Com paginação const stocksPage = await client.quote.list({ page: 1, limit: 50, }); console.log(stocks.stocks); // [ // { stock: 'PETR4', name: 'Petrobras PN', type: 'stock' }, // { stock: 'VALE3', name: 'Vale ON', type: 'stock' }, // ... // ] ``` ### Criptomoedas ```typescript // Cotação de cripto const crypto = await client.crypto.retrieve('BTC'); // Lista de criptos disponíveis const cryptos = await client.crypto.available(); ``` ### Moedas ```typescript // Cotação de moeda const currency = await client.currency.retrieve('USD-BRL'); // Lista de moedas disponíveis const currencies = await client.currency.available(); ``` ### Inflação ```typescript // Dados de inflação const inflation = await client.inflation.retrieve('IPCA'); // Países disponíveis const countries = await client.inflation.available(); ``` ### Taxa de Juros ```typescript // Taxa SELIC const selic = await client.primeRate.retrieve('SELIC'); // Países disponíveis const countries = await client.primeRate.available(); ``` ## Tratamento de Erros A SDK lança erros tipados para facilitar o tratamento: ```typescript try { const quote = await client.quote.retrieve('INVALID'); } catch (error) { if (error instanceof Brapi.APIError) { console.log(error.status); // Código HTTP (ex: 404) console.log(error.name); // Nome do erro (ex: 'NotFoundError') console.log(error.message); // Mensagem descritiva console.log(error.headers); // Headers da resposta } } ``` ### Tipos de Erro | Status Code | Error Type | Descrição | | ----------- | -------------------------- | ---------------------- | | 400 | `BadRequestError` | Requisição inválida | | 401 | `AuthenticationError` | Token inválido | | 403 | `PermissionDeniedError` | Sem permissão | | 404 | `NotFoundError` | Recurso não encontrado | | 422 | `UnprocessableEntityError` | Dados inválidos | | 429 | `RateLimitError` | Limite de requisições | | >=500 | `InternalServerError` | Erro no servidor | | N/A | `APIConnectionError` | Erro de conexão | ## Retry Automático A SDK tenta automaticamente 2 vezes em caso de falha: ```typescript // Configurar retries const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, maxRetries: 3, // Tenta até 3 vezes }); // Desabilitar retries const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, maxRetries: 0, // Sem retry }); ``` Erros automaticamente retriados: * Erros de conexão * 408 Request Timeout * 409 Conflict * 429 Rate Limit * Erros 5xx (servidor) ## Uso em Next.js ### Server Component ```typescript // app/stock/[ticker]/page.tsx const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, }); export default async function StockPage({ params, }: { params: { ticker: string }; }) { const quote = await client.quote.retrieve(params.ticker); const stock = quote.results[0]; return ( ); } ``` ### API Route ```typescript // app/api/quote/[ticker]/route.ts const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, }); export async function GET( request: Request, { params }: { params: { ticker: string } } ) { try { const quote = await client.quote.retrieve(params.ticker); return NextResponse.json(quote); } catch (error) { if (error instanceof Brapi.NotFoundError) { return NextResponse.json( { error: 'Ticker not found' }, { status: 404 } ); } throw error; } } ``` ### Client Component com SWR ```typescript 'use client'; const fetcher = (url: string) => fetch(url).then(r => r.json()); export function StockQuote({ ticker }: { ticker: string }) { const { data, error } = useSWR(`/api/quote/${ticker}`, fetcher); if (error) return ; if (!data) return ; const stock = data.results[0]; return ; } ``` ## Uso com Express ```typescript const app = express(); const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, }); app.get('/api/quote/:ticker', async (req, res) => { try { const quote = await client.quote.retrieve(req.params.ticker); res.json(quote); } catch (error) { if (error instanceof Brapi.NotFoundError) { res.status(404).json({ error: 'Ticker not found' }); } else { res.status(500).json({ error: 'Internal server error' }); } } }); app.listen(3000); ``` ## Timeouts ```typescript // Timeout global const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, timeout: 10000, // 10 segundos }); // Timeout por requisição const quote = await client.quote.retrieve('PETR4', { timeout: 5000, // 5 segundos }); ``` ## Tipos Disponíveis A SDK exporta todos os tipos necessários: ```typescript import type { QuoteRetrieveResponse, QuoteListResponse, CryptoRetrieveResponse, CurrencyRetrieveResponse, InflationRetrieveResponse, } from 'brapi'; ``` ## Boas Práticas ### 1. Reutilize a Instância do Cliente ```typescript // ✅ Bom - Crie uma instância e reutilize export const brapiClient = new Brapi({ apiKey: process.env.BRAPI_API_KEY, }); // ❌ Ruim - Criar nova instância a cada uso function getQuote() { const client = new Brapi({ apiKey: '...' }); // Não faça isso } ``` ### 2. Use Variáveis de Ambiente ```typescript // ✅ Bom const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, }); // ❌ Ruim - Nunca hardcode o token const client = new Brapi({ apiKey: 'meu-token-secreto', // Não faça isso! }); ``` ### 3. Trate Erros Adequadamente ```typescript // ✅ Bom try { const quote = await client.quote.retrieve('PETR4'); } catch (error) { if (error instanceof Brapi.RateLimitError) { // Trate limite de requisições } else if (error instanceof Brapi.NotFoundError) { // Trate ticker não encontrado } } ``` ## Links Úteis * 📦 [Pacote NPM](https://www.npmjs.com/package/brapi) * 🔧 [Repositório GitHub](https://github.com/brapi-dev/brapi-typescript) * 📚 [Documentação Completa da API](/docs) * 🐛 [Reportar Bug](https://github.com/brapi-dev/brapi-typescript/issues) ## Suporte Precisa de ajuda? Entre em contato: * 💬 [Abra uma issue](https://github.com/brapi-dev/brapi-typescript/issues) * 📧 [Suporte por email](mailto:contato@brapi.dev) * 📖 [Documentação completa](/docs) ## Contribuindo Contribuições são bem-vindas! Veja o [guia de contribuição](https://github.com/brapi-dev/brapi-typescript/blob/main/CONTRIBUTING.md). ## Licença MIT License - veja [LICENSE](https://github.com/brapi-dev/brapi-typescript/blob/main/LICENSE) para detalhes. # Tesouro Direto URL: /docs/tesouro-direto.mdx Guia para integrar dados de títulos públicos do Tesouro Direto na brapi: listagem, indicadores atuais e histórico diário de taxas e preços. *** title: Tesouro Direto description: >- Guia para integrar dados de títulos públicos do Tesouro Direto na brapi: listagem, indicadores atuais e histórico diário de taxas e preços. full: true keywords: brapi, api, tesouro direto, renda fixa, tesouro selic, tesouro ipca, prefixado openGraph: title: Tesouro Direto — brapi description: >- Integre taxas e preços indicativos de títulos públicos do Tesouro Direto com endpoints REST da brapi. type: website locale: pt\_BR lastUpdated: '2026-05-16T12:00:00.000Z' lang: pt-BR ----------- import { Callout } from 'fumadocs-ui/components/callout'; import { Step, Steps } from 'fumadocs-ui/components/steps'; import { Tab, Tabs } from 'fumadocs-ui/components/tabs'; A API de Tesouro Direto entrega a primeira camada de dados de renda fixa da brapi: 1. **listar** os títulos atualmente ofertados 2. consultar **taxas e preços atuais** por símbolo 3. acompanhar o **histórico diário** de taxas e preços Taxas indicativas de compra/venda, preços unitários, vencimento, indexador, tipo de cupom e histórico diário desde 2005, conforme disponibilidade da fonte pública. Títulos do Tesouro Direto usam `symbol` em formato slug minúsculo, como `tesouro-selic-01032031`. Não use tickers de bolsa ou códigos internos de fontes externas. ## Cobertura e frequência * **Títulos cobertos:** Tesouro Selic, Prefixado, IPCA+, IGP-M histórico, Renda+ e Educa+ quando presentes no arquivo público. * **Atualização:** diária, conforme publicação da base do Tesouro Direto. * **Histórico:** série diária de taxas e preços desde 2005. * **Datas:** parâmetros em `YYYY-MM-DD`; respostas em `YYYY-MM-DD`. * **Fonte externa:** a resposta nunca expõe URLs, IDs de dataset ou IDs de recurso upstream. Use apenas os símbolos públicos da brapi. ## Acesso por plano Tesouro Direto detalhado faz parte do plano **Pro**. O sandbox permite experimentação sem token para três títulos: * `tesouro-selic-01032031` * `tesouro-prefixado-com-juros-semestrais-01012037` * `tesouro-ipca-com-juros-semestrais-15082060` | Plano | Acesso ao Tesouro Direto | | ------------------- | ---------------------------------- | | Sandbox (sem token) | ✅ Apenas os 3 títulos sandbox | | Free | ❌ | | Startup | ❌ | | **Pro** | **✅ Todos os títulos disponíveis** | ## Campos principais * **`symbol`:** slug público do título, composto pelo nome normalizado e data de vencimento (`DDMMAAAA`). * **`bondType`:** nome público do título, como `Tesouro Selic` ou `Tesouro IPCA+ com Juros Semestrais`. * **`indexer`:** `selic`, `prefixado`, `ipca` ou `igpm`. * **`couponType`:** `zero` para títulos sem cupom periódico, `semestral` para títulos com juros semestrais. * **`buyRate` / `sellRate`:** taxa indicativa em `% a.a.`. Em Tesouro Selic, é spread sobre a Selic; em Prefixado, rendimento nominal; em IPCA, rendimento real acima do IPCA. * **`rateInfo`:** metadados que explicam como interpretar `buyRate` e `sellRate` para aquele indexador (`spreadOverSelic`, `nominalAnnualRate`, `realAnnualRateOverIpca` ou `realAnnualRateOverIgpm`). * **`buyPrice` / `sellPrice` / `basePrice`:** preços unitários indicativos em reais. * **`durationDays`:** dias corridos entre a data-base e o vencimento. ## Início rápido ```bash # 1) Liste títulos Selic atualmente ofertados curl "https://brapi.dev/api/v2/treasury/list?indexer=selic" # 2) Consulte indicadores atuais de títulos específicos curl "https://brapi.dev/api/v2/treasury/indicators?symbols=tesouro-selic-01032031" # 3) Consulte o histórico diário de taxas e preços curl "https://brapi.dev/api/v2/treasury/indicators/history?symbols=tesouro-selic-01032031&startDate=2026-05-01&endDate=2026-05-15" ``` ```typescript const BASE = 'https://brapi.dev/api/v2/treasury'; const token = process.env.BRAPI_TOKEN; const headers = token ? { Authorization: `Bearer ${token}` } : undefined; const list = await fetch(`${BASE}/list?indexer=selic`, { headers }) .then((r) => r.json()); const indicators = await fetch( `${BASE}/indicators?symbols=tesouro-selic-01032031`, { headers }, ).then((r) => r.json()); const history = await fetch( `${BASE}/indicators/history?symbols=tesouro-selic-01032031&startDate=2026-05-01&endDate=2026-05-15`, { headers }, ).then((r) => r.json()); console.log({ list, indicators, history }); ``` ```python import os import requests BASE = "https://brapi.dev/api/v2/treasury" token = os.getenv("BRAPI_TOKEN") headers = {"Authorization": f"Bearer {token}"} if token else {} listagem = requests.get( f"{BASE}/list", params={"indexer": "selic"}, headers=headers, ).json() indicadores = requests.get( f"{BASE}/indicators", params={"symbols": "tesouro-selic-01032031"}, headers=headers, ).json() historico = requests.get( f"{BASE}/indicators/history", params={ "symbols": "tesouro-selic-01032031", "startDate": "2026-05-01", "endDate": "2026-05-15", }, headers=headers, ).json() print(listagem, indicadores, historico) ``` ## Fluxo recomendado #### Descubra os títulos disponíveis Comece em [`/api/v2/treasury/list`](/docs/tesouro-direto/listagem) para listar a oferta atual e filtrar por indexador ou tipo de cupom. #### Consulte o snapshot atual Use [`/api/v2/treasury/indicators`](/docs/tesouro-direto/indicadores) para buscar taxas e preços atuais de até 20 títulos por requisição. #### Monte gráficos históricos Use [`/api/v2/treasury/indicators/history`](/docs/tesouro-direto/indicadores-historico) para obter séries diárias de taxas e preços por título. ## Casos de uso comuns * **Comparador de títulos públicos:** `list` com filtro por indexador. * **Dashboard de renda fixa:** `indicators` para snapshot atual. * **Gráfico de marcação a mercado:** `indicators/history` com `buyPrice`, `sellPrice` e `basePrice`. * **Análise de curva de juros:** combinar títulos Prefixados e IPCA+ por vencimento. # Histórico de Indicadores do Tesouro Direto URL: /docs/tesouro-direto/indicadores-historico.mdx Consulte a série diária de taxas e preços indicativos para títulos do Tesouro Direto, com filtro de datas e ordenação. *** title: Histórico de Indicadores do Tesouro Direto description: >- Consulte a série diária de taxas e preços indicativos para títulos do Tesouro Direto, com filtro de datas e ordenação. full: true keywords: brapi, api, tesouro direto, histórico, taxa histórica, preço histórico openGraph: title: Histórico de Indicadores do Tesouro Direto — brapi description: Série diária de taxas e preços de títulos do Tesouro Direto. type: website locale: pt\_BR lastUpdated: '2026-05-16T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/treasury/indicators/history ------------------------------------------ import { Callout } from 'fumadocs-ui/components/callout'; Retorna a série diária de taxas e preços por título, agrupada por `symbol`. Quando `startDate` e `endDate` são omitidos, a API usa os últimos 12 meses. Use esta rota para gráficos de marcação a mercado, análise de taxa por vencimento e acompanhamento de movimentos da curva de juros. Cada série inclui `rateInfo`, com a unidade e a descrição de como interpretar `buyRate` e `sellRate` para o indexador daquele título. **Plano mínimo: Pro.** No sandbox sem token, todos os símbolos da requisição precisam estar na lista de sandbox. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/treasury/indicators/history Single endpoint documentation for /api/v2/treasury/indicators/history ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/treasury/indicators/history **Summary:** Consulta histórico diário de indicadores do Tesouro Direto Retorna a série diária de taxas e preços indicativos por título do Tesouro Direto. Quando startDate e endDate são omitidos, usa os últimos 12 meses. **Tags:** Renda Fixa ### Parameters - **symbols** (query) *required* - **startDate** (query) - **endDate** (query) - **sortBy** (query) - **sortOrder** (query) ### Responses #### 200 Histórico diário retornado com sucesso #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 429 Limite de requisições excedido #### 500 Erro interno do servidor #### 503 Serviço externo temporariamente indisponível ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### TreasuryHistoryPoint **Properties:** - **baseDate** (string) *(required)* Data-base da cotação no formato YYYY-MM-DD - **buyRate** (number) *(nullable)* *(required)* Taxa indicativa de compra em % a.a. Unidade: Tesouro Selic = spread (% a.a.) sobre a taxa Selic; Tesouro Prefixado = rendimento nominal (% a.a.); Tesouro IPCA = rendimento real (% a.a.) acima do IPCA. - **sellRate** (number) *(nullable)* *(required)* Taxa indicativa de venda em % a.a. Unidade: Tesouro Selic = spread (% a.a.) sobre a taxa Selic; Tesouro Prefixado = rendimento nominal (% a.a.); Tesouro IPCA = rendimento real (% a.a.) acima do IPCA. - **buyPrice** (number) *(nullable)* *(required)* Preço unitário indicativo de compra em BRL - **sellPrice** (number) *(nullable)* *(required)* Preço unitário indicativo de venda em BRL - **basePrice** (number) *(nullable)* *(required)* Preço unitário base em BRL ### TreasuryHistorySeries **Properties:** - **symbol** (string) *(required)* - **bondType** (string) *(required)* Nome público do título - **indexer** (string) - Options: `selic`, `prefixado`, `ipca`, `igpm` *(required)* Indexador normalizado do título - **couponType** (string) - Options: `zero`, `semestral` *(required)* Tipo de pagamento de juros do título - **maturityDate** (string) *(nullable)* *(required)* Data de vencimento no formato YYYY-MM-DD - **rateInfo** (object) *(required)* Metadados para interpretar buyRate e sellRate. As taxas têm significados diferentes conforme o indexador. **Properties:** - **rateType** (string) - Options: `spreadOverSelic`, `nominalAnnualRate`, `realAnnualRateOverIpca`, `realAnnualRateOverIgpm` *(required)* Tipo de interpretação para buyRate e sellRate - **rateUnit** (string) *(required)* Unidade das taxas buyRate e sellRate - **description** (string) *(required)* Descrição textual de como interpretar buyRate e sellRate para o indexador do título - **history** (array) *(required)* Array items: Reference to: **TreasuryHistoryPoint** ### TreasuryIndicatorsHistoryResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **TreasuryHistorySeries** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # Indicadores do Tesouro Direto URL: /docs/tesouro-direto/indicadores.mdx Consulte o snapshot atual de taxas, preços, vencimento, indexador e tipo de cupom para títulos do Tesouro Direto. *** title: Indicadores do Tesouro Direto description: >- Consulte o snapshot atual de taxas, preços, vencimento, indexador e tipo de cupom para títulos do Tesouro Direto. full: true keywords: brapi, api, tesouro direto, indicadores, taxa compra, taxa venda, preço unitário openGraph: title: Indicadores do Tesouro Direto — brapi description: Consulte taxas e preços atuais de títulos públicos do Tesouro Direto. type: website locale: pt\_BR lastUpdated: '2026-05-16T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/treasury/indicators ---------------------------------- import { Callout } from 'fumadocs-ui/components/callout'; Retorna o snapshot mais recente de cada título solicitado via `symbols`. Você pode enviar até 20 símbolos por requisição, separados por vírgula. Símbolos desconhecidos são omitidos de `results`, sem erro por símbolo. **Plano mínimo: Pro.** No sandbox sem token, todos os símbolos da requisição precisam estar na lista de sandbox. As taxas vêm em `% a.a.`. Para Tesouro Selic, `buyRate` e `sellRate` são spreads sobre a Selic; para Prefixado são taxas nominais; para IPCA+ são taxas reais acima do IPCA. A resposta inclui `rateInfo` para tornar essa interpretação explícita por título. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/treasury/indicators Single endpoint documentation for /api/v2/treasury/indicators ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/treasury/indicators **Summary:** Consulta indicadores atuais de títulos do Tesouro Direto Retorna a última taxa/preço indicativo para cada símbolo solicitado. Símbolos desconhecidos são omitidos de results. **Tags:** Renda Fixa ### Parameters - **symbols** (query) *required* ### Responses #### 200 Indicadores atuais retornados com sucesso #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 429 Limite de requisições excedido #### 500 Erro interno do servidor #### 503 Serviço externo temporariamente indisponível ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### TreasuryIndicatorsResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **TreasuryListItem** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### TreasuryListItem **Properties:** - **symbol** (string) *(required)* Slug público do título do Tesouro Direto - **bondType** (string) *(required)* Nome público do título - **indexer** (string) - Options: `selic`, `prefixado`, `ipca`, `igpm` *(required)* Indexador normalizado do título - **couponType** (string) - Options: `zero`, `semestral` *(required)* Tipo de pagamento de juros do título - **maturityDate** (string) *(nullable)* *(required)* Data de vencimento no formato YYYY-MM-DD - **durationDays** (number) *(nullable)* *(required)* Dias corridos entre a data-base e o vencimento - **baseDate** (string) *(nullable)* *(required)* Data-base da cotação no formato YYYY-MM-DD - **buyRate** (number) *(nullable)* *(required)* Taxa indicativa de compra em % a.a. Unidade: Tesouro Selic = spread (% a.a.) sobre a taxa Selic; Tesouro Prefixado = rendimento nominal (% a.a.); Tesouro IPCA = rendimento real (% a.a.) acima do IPCA. - **sellRate** (number) *(nullable)* *(required)* Taxa indicativa de venda em % a.a. Unidade: Tesouro Selic = spread (% a.a.) sobre a taxa Selic; Tesouro Prefixado = rendimento nominal (% a.a.); Tesouro IPCA = rendimento real (% a.a.) acima do IPCA. - **buyPrice** (number) *(nullable)* *(required)* Preço unitário indicativo de compra em BRL - **sellPrice** (number) *(nullable)* *(required)* Preço unitário indicativo de venda em BRL - **basePrice** (number) *(nullable)* *(required)* Preço unitário base em BRL - **rateInfo** (object) *(required)* Metadados para interpretar buyRate e sellRate. As taxas têm significados diferentes conforme o indexador. **Properties:** - **rateType** (string) - Options: `spreadOverSelic`, `nominalAnnualRate`, `realAnnualRateOverIpca`, `realAnnualRateOverIgpm` *(required)* Tipo de interpretação para buyRate e sellRate - **rateUnit** (string) *(required)* Unidade das taxas buyRate e sellRate - **description** (string) *(required)* Descrição textual de como interpretar buyRate e sellRate para o indexador do título # Listagem do Tesouro Direto URL: /docs/tesouro-direto/listagem.mdx Liste títulos públicos atualmente ofertados pelo Tesouro Direto, com filtros por indexador, tipo de cupom, busca, paginação e ordenação. *** title: Listagem do Tesouro Direto description: >- Liste títulos públicos atualmente ofertados pelo Tesouro Direto, com filtros por indexador, tipo de cupom, busca, paginação e ordenação. full: true keywords: brapi, api, tesouro direto, listagem, renda fixa, títulos públicos openGraph: title: Listagem do Tesouro Direto — brapi description: Liste e filtre títulos do Tesouro Direto com taxas e preços atuais. type: website locale: pt\_BR lastUpdated: '2026-05-16T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/treasury/list ---------------------------- import { Callout } from 'fumadocs-ui/components/callout'; Retorna uma lista paginada dos títulos do Tesouro Direto atualmente ofertados, com taxas e preços indicativos mais recentes. Cada item inclui `rateInfo`, que explica se as taxas são spread sobre Selic, taxa nominal ou taxa real acima do índice de inflação. Use esta rota como ponto de descoberta para encontrar os `symbols` públicos que serão usados nos endpoints de indicadores e histórico. **Plano mínimo: Pro.** No sandbox sem token, use `search` com um dos símbolos liberados: `tesouro-selic-01032031`, `tesouro-prefixado-com-juros-semestrais-01012037` ou `tesouro-ipca-com-juros-semestrais-15082060`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/treasury/list Single endpoint documentation for /api/v2/treasury/list ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/treasury/list **Summary:** Lista títulos do Tesouro Direto Retorna os títulos do Tesouro Direto atualmente ofertados, com taxas e preços indicativos mais recentes. Requer plano Pro, exceto pelos três títulos sandbox documentados. **Tags:** Renda Fixa ### Parameters - **page** (query) - **limit** (query) - **search** (query) - **indexer** (query) - **couponType** (query) - **sortBy** (query) - **sortOrder** (query) ### Responses #### 200 Lista paginada de títulos do Tesouro Direto #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 429 Limite de requisições excedido #### 500 Erro interno do servidor #### 503 Serviço externo temporariamente indisponível ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### TreasuryListItem **Properties:** - **symbol** (string) *(required)* Slug público do título do Tesouro Direto - **bondType** (string) *(required)* Nome público do título - **indexer** (string) - Options: `selic`, `prefixado`, `ipca`, `igpm` *(required)* Indexador normalizado do título - **couponType** (string) - Options: `zero`, `semestral` *(required)* Tipo de pagamento de juros do título - **maturityDate** (string) *(nullable)* *(required)* Data de vencimento no formato YYYY-MM-DD - **durationDays** (number) *(nullable)* *(required)* Dias corridos entre a data-base e o vencimento - **baseDate** (string) *(nullable)* *(required)* Data-base da cotação no formato YYYY-MM-DD - **buyRate** (number) *(nullable)* *(required)* Taxa indicativa de compra em % a.a. Unidade: Tesouro Selic = spread (% a.a.) sobre a taxa Selic; Tesouro Prefixado = rendimento nominal (% a.a.); Tesouro IPCA = rendimento real (% a.a.) acima do IPCA. - **sellRate** (number) *(nullable)* *(required)* Taxa indicativa de venda em % a.a. Unidade: Tesouro Selic = spread (% a.a.) sobre a taxa Selic; Tesouro Prefixado = rendimento nominal (% a.a.); Tesouro IPCA = rendimento real (% a.a.) acima do IPCA. - **buyPrice** (number) *(nullable)* *(required)* Preço unitário indicativo de compra em BRL - **sellPrice** (number) *(nullable)* *(required)* Preço unitário indicativo de venda em BRL - **basePrice** (number) *(nullable)* *(required)* Preço unitário base em BRL - **rateInfo** (object) *(required)* Metadados para interpretar buyRate e sellRate. As taxas têm significados diferentes conforme o indexador. **Properties:** - **rateType** (string) - Options: `spreadOverSelic`, `nominalAnnualRate`, `realAnnualRateOverIpca`, `realAnnualRateOverIgpm` *(required)* Tipo de interpretação para buyRate e sellRate - **rateUnit** (string) *(required)* Unidade das taxas buyRate e sellRate - **description** (string) *(required)* Descrição textual de como interpretar buyRate e sellRate para o indexador do título ### TreasuryListResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **TreasuryListItem** - **pagination** *(required)* Reference to: **TreasuryPaginationMeta** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### TreasuryPaginationMeta **Properties:** - **page** (number) *(required)* - **limit** (number) *(required)* - **totalItems** (number) *(required)* - **totalPages** (number) *(required)* - **hasNextPage** (boolean) *(required)* # Cobertura por Ticker URL: /docs/tickers/cobertura.mdx Descubra quais superfícies de dados da brapi estão disponíveis para cada ticker e quais endpoints usar em seguida. *** title: Cobertura por Ticker description: >- Descubra quais superfícies de dados da brapi estão disponíveis para cada ticker e quais endpoints usar em seguida. full: true keywords: brapi, api, tickers, cobertura, disponibilidade, endpoints lang: pt-BR \_openapi: method: GET route: /api/v2/tickers/coverage ------------------------------- Endpoint **público** para verificar o que a brapi consegue consultar para cada ticker B3. Use quando sua integração precisa decidir o próximo passo automaticamente: cotação, histórico, dividendos de ações, rendimentos de FIIs, indicadores de FIIs, relatórios ou endpoints de carteira e imóveis. A resposta é por símbolo. Um ticker desconhecido não derruba a chamada inteira: ele retorna `status: "unknown"` com recomendações de busca. Tickers antigos são resolvidos antes da checagem e retornam `status: "renamed"` quando houver mapeamento conhecido. Este endpoint não retorna os dados de mercado em si. Ele informa quais endpoints usar. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/tickers/coverage Single endpoint documentation for /api/v2/tickers/coverage ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/tickers/coverage **Summary:** Verificar cobertura por ticker Verifica quais superfícies de dados da brapi estão disponíveis para cada ticker informado e recomenda os endpoints corretos para continuar a integração. Use este endpoint quando precisar responder "o que posso consultar para este ativo?" antes de chamar cotações, histórico, dividendos, fundamentos ou endpoints específicos de FIIs. ### Exemplos ```bash curl "https://brapi.dev/api/v2/tickers/coverage?symbols=PETR4,MXRF11" curl "https://brapi.dev/api/v2/tickers/coverage?symbols=VVAR3" ``` **Plano mínimo:** Gratuito **Autenticação:** Não necessária **Tags:** Tickers ### Parameters - **symbols** (query) *required* ### Responses #### 200 Cobertura retornada com sucesso. #### 400 Requisição inválida #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### TickerAvailableData **Properties:** - **ticker** (boolean) *(required)* - **quote** (boolean) *(required)* - **historical** (boolean) *(required)* - **stockDividends** (boolean) *(required)* - **fiiDividends** (boolean) *(required)* - **profile** (boolean) *(required)* - **statistics** (boolean) *(required)* - **financialStatements** (boolean) *(required)* - **fiiIndicators** (boolean) *(required)* - **fiiReports** (boolean) *(required)* - **fiiPortfolio** (boolean) *(required)* - **fiiProperties** (boolean) *(required)* ### TickerCoverageResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **TickerCoverageResult** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### TickerCoverageResult **Properties:** - **requestedSymbol** (string) *(required)* Ticker informado pelo usuário - **symbol** (string) *(required)* Ticker canônico usado para consulta - **changed** (boolean) *(required)* Indica se o ticker informado foi normalizado - **status** (string) - Options: `available`, `renamed`, `unknown`, `wrong_endpoint` *(required)* Status da cobertura: disponível, renomeado, desconhecido ou endpoint incorreto para o tipo de símbolo - **assetType** (string) *(nullable)* *(required)* Tipo amplo do ativo quando disponível - **subType** (string) *(nullable)* *(required)* Subtipo do ativo quando disponível - **availableData** *(required)* Reference to: **TickerAvailableData** - **recommendedEndpoints** (object) *(required)* Endpoints brapi recomendados para o símbolo # Tickers Disponíveis URL: /docs/tickers.mdx Descubra, filtre e valide tickers B3 disponíveis na brapi usando o padrão v2. Ideal para busca, autocomplete, screeners e seleção de símbolos antes de consultar dados de mercado. *** title: Tickers Disponíveis description: >- Descubra, filtre e valide tickers B3 disponíveis na brapi usando o padrão v2. Ideal para busca, autocomplete, screeners e seleção de símbolos antes de consultar dados de mercado. full: true keywords: brapi, api, tickers, ações, fiis, etfs, bdrs, b3, símbolos lang: pt-BR \_openapi: method: GET route: /api/v2/tickers ---------------------- Endpoint **público** para descoberta de tickers B3. Use antes dos endpoints de dados de mercado para encontrar o símbolo correto, montar autocomplete, validar entradas de usuário ou construir telas de screening. O catálogo cobre instrumentos B3 em formato de ticker: ações, FIIs, ETFs, BDRs, units e índices. Opções, futuros, Tesouro Direto, cripto, câmbio e séries macro têm endpoints próprios. Para dados por preocupação, use endpoints específicos, como `/api/v2/fii/*` ou `/api/v2/stocks/*`. O endpoint legado `/api/quote/list` continua funcionando, mas novas integrações devem preferir este formato v2. ## Fluxo recomendado 1. Use `/api/v2/tickers` para buscar e filtrar símbolos disponíveis. 2. Use `/api/v2/tickers/resolve` se o usuário informou um ticker antigo. 3. Use `/api/v2/tickers/renames` para mostrar o histórico de mudança de código. 4. Use `/api/v2/tickers/coverage` para descobrir quais endpoints fazem sentido para cada símbolo antes de buscar dados de mercado. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/tickers Single endpoint documentation for /api/v2/tickers ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/tickers **Summary:** Listar tickers disponíveis Lista tickers e instrumentos B3 disponíveis na brapi usando o padrão v2. Use este endpoint para descoberta de símbolos, autocomplete, validação de ticker e telas de screening. Ele substitui gradualmente `/api/quote/list` para novas integrações, mas não retorna módulos, dividendos ou histórico completo. Para dados de mercado de ações em novas integrações, use os endpoints composáveis `/api/v2/stocks/*`. Para FIIs, use `/api/v2/fii/*`. ### Escopo Este catálogo cobre instrumentos B3 em formato de ticker: ações, FIIs, ETFs, BDRs, units e índices. Não inclui opções, futuros, Tesouro Direto, cripto, câmbio ou séries macroeconômicas, que possuem endpoints próprios. ### Exemplos ```bash curl "https://brapi.dev/api/v2/tickers?search=PETR&limit=10" curl "https://brapi.dev/api/v2/tickers?type=fund&subType=fii&limit=20" curl "https://brapi.dev/api/v2/tickers?sortBy=volume&sortOrder=desc&limit=10" ``` **Plano mínimo:** Gratuito **Autenticação:** Não necessária **Tags:** Tickers ### Parameters - **search** (query) - **sortBy** (query) - **sortOrder** (query) - **page** (query) - **limit** (query) - **sector** (query) - **subsector** (query) - **type** (query) - **subType** (query) ### Responses #### 200 Lista de tickers retornada com sucesso. #### 400 Requisição inválida #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### TickerFacets **Properties:** - **sectors** (array) *(required)* Setores disponíveis para filtro Array items: **Type:** string - **subsectors** (array) *(required)* Subsetores B3 disponíveis para filtro Array items: **Type:** string - **assetTypes** (array) *(required)* Tipos amplos disponíveis para filtro Array items: **Type:** string - **subTypes** (array) *(required)* Subtipos disponíveis para filtro Array items: **Type:** string ### TickerIndexItem **Properties:** - **symbol** (string) *(required)* - **name** (string) *(required)* - **exchange** (string) - Options: `B3` *(required)* - **assetType** (string) - Options: `index` *(required)* ### TickerListItem **Properties:** - **symbol** (string) *(required)* Ticker público do ativo na B3 - **name** (string) *(required)* Nome de exibição do ativo - **longName** (string) *(nullable)* *(required)* Nome longo quando disponível - **assetType** (string) - Options: `stock`, `fund`, `bdr` *(nullable)* *(required)* Tipo amplo do ativo - **subType** (string) - Options: `stock`, `unit`, `fii`, `etf`, `fi-infra`, `fi-agro`, `fip`, `fidc`, `bdr` *(nullable)* *(required)* Classificação aditiva do ativo: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr - **exchange** (string) - Options: `B3` *(required)* Bolsa de negociação - **currency** (string) - Options: `BRL` *(required)* Moeda de negociação - **sector** (string) *(nullable)* *(required)* Setor quando disponível - **subsector** (string) *(nullable)* *(required)* Subsetor B3 quando disponível - **isActive** (boolean) *(required)* Indica se o ativo aparece no catálogo ativo atual - **logoUrl** (string) *(nullable)* *(required)* URL do logo quando disponível - **quote** *(required)* Reference to: **TickerQuoteSummary** ### TickerListResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **TickerListItem** - **indexes** (array) *(required)* Array items: Reference to: **TickerIndexItem** - **facets** *(required)* Reference to: **TickerFacets** - **pagination** *(required)* Reference to: **TickerPagination** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### TickerPagination **Properties:** - **page** (number) *(required)* - **limit** (number) *(required)* - **totalItems** (number) *(required)* - **totalPages** (number) *(required)* - **hasNextPage** (boolean) *(required)* ### TickerQuoteSummary **Properties:** - **lastPrice** (number) *(nullable)* *(required)* Último preço disponível para listagem/screening - **changePercent** (number) *(nullable)* *(required)* Variação percentual do último snapshot disponível - **volume** (number) *(nullable)* *(required)* Volume negociado do último snapshot disponível - **marketCap** (number) *(nullable)* *(required)* Capitalização de mercado quando disponível # Renomes de Tickers URL: /docs/tickers/renomes.mdx Consulte mudanças conhecidas de código de negociação na B3, incluindo ticker antigo, ticker atual canônico e data efetiva. *** title: Renomes de Tickers description: >- Consulte mudanças conhecidas de código de negociação na B3, incluindo ticker antigo, ticker atual canônico e data efetiva. full: true keywords: brapi, api, tickers, renomes, ticker antigo, b3 lang: pt-BR \_openapi: method: GET route: /api/v2/tickers/renames ------------------------------ Endpoint **público** para consultar renomes conhecidos de tickers B3. Use quando um usuário informa um código antigo, quando você precisa exibir o histórico de mudança de ticker, ou quando quer explicar por que uma busca por um símbolo antigo deve apontar para outro ativo. Filtros úteis: * `symbols` filtra eventos envolvendo qualquer ticker informado. * `search` busca em ticker antigo, novo ou canônico. * `startDate` e `endDate` limitam pela data efetiva do renome, usando o formato `YYYY-MM-DD`. Para normalizar uma lista antes de consultar dados, use [`/api/v2/tickers/resolve`](/docs/tickers/resolver). ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/tickers/renames Single endpoint documentation for /api/v2/tickers/renames ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/tickers/renames **Summary:** Listar renomes de tickers Lista renomes conhecidos de tickers B3. Use este endpoint para descobrir quando um ticker antigo passou a negociar sob outro código, incluindo cadeias de renome normalizadas para o ticker canônico atual. ### Exemplos ```bash curl "https://brapi.dev/api/v2/tickers/renames?symbols=VVAR3" curl "https://brapi.dev/api/v2/tickers/renames?search=BHIA" curl "https://brapi.dev/api/v2/tickers/renames?startDate=2024-01-01" ``` **Plano mínimo:** Gratuito **Autenticação:** Não necessária **Tags:** Tickers ### Parameters - **symbols** (query) - **search** (query) - **startDate** (query) - **endDate** (query) ### Responses #### 200 Renomes retornados com sucesso. #### 400 Requisição inválida #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### TickerRename **Properties:** - **oldSymbol** (string) *(required)* Ticker antigo - **newSymbol** (string) *(required)* Ticker novo divulgado no evento - **canonicalSymbol** (string) *(required)* Ticker canônico atual. Em cadeias de renome, aponta diretamente para o ticker final conhecido. - **effectiveDate** (string) *(required)* Data efetiva do renome no formato YYYY-MM-DD ### TickerRenamesResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **TickerRename** - **count** (number) *(required)* - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # Resolver Tickers Antigos URL: /docs/tickers/resolver.mdx Normalize tickers antigos para o ticker atual recomendado antes de consultar dados de mercado. *** title: Resolver Tickers Antigos description: >- Normalize tickers antigos para o ticker atual recomendado antes de consultar dados de mercado. full: true keywords: brapi, api, tickers, resolver, normalizar ticker, ticker antigo lang: pt-BR \_openapi: method: GET route: /api/v2/tickers/resolve ------------------------------ Endpoint **público** para resolver tickers antigos. Informe até 20 símbolos em `symbols`. A resposta preserva a ordem dos tickers informados e retorna: * `requestedSymbol`: ticker enviado pelo usuário. * `symbol`: ticker atual recomendado. * `changed`: se houve normalização. * `status`: `renamed` quando o ticker consta no catálogo de renomes, `active` quando foi mantido sem alteração. * `effectiveDate`: data efetiva do renome, quando existir. Use este endpoint antes de chamar dados de mercado quando sua aplicação aceita entrada livre de usuário, planilhas antigas, carteiras importadas ou bases com histórico de símbolos. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/tickers/resolve Single endpoint documentation for /api/v2/tickers/resolve ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/tickers/resolve **Summary:** Resolver tickers antigos Resolve tickers antigos para o ticker atual recomendado. Tickers sem renome conhecido são retornados sem alteração, o que permite normalizar uma lista antes de chamar endpoints de dados de mercado. ### Exemplos ```bash curl "https://brapi.dev/api/v2/tickers/resolve?symbols=VVAR3,PETR4" curl "https://brapi.dev/api/v2/tickers/resolve?symbols=NINJ3,REAG3" ``` **Plano mínimo:** Gratuito **Autenticação:** Não necessária **Tags:** Tickers ### Parameters - **symbols** (query) *required* ### Responses #### 200 Tickers resolvidos com sucesso. #### 400 Requisição inválida #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### TickerResolveResponse **Properties:** - **results** (array) *(required)* Array items: Reference to: **TickerResolveResult** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### TickerResolveResult **Properties:** - **requestedSymbol** (string) *(required)* Ticker informado pelo usuário - **symbol** (string) *(required)* Ticker atual recomendado para novas consultas - **changed** (boolean) *(required)* Indica se o ticker informado foi mapeado para outro - **status** (string) - Options: `active`, `renamed` *(required)* Status do ticker informado no catálogo de renomes - **effectiveDate** (string) *(nullable)* *(required)* Data efetiva do renome quando houver # Histórico de Gregas e IV de Opções sobre Futuros URL: /docs/futuros/opcoes/analytics-historico.mdx Consulte a série temporal EOD de volatilidade implícita e gregas calculadas para uma opção sobre futuro específica. *** title: Histórico de Gregas e IV de Opções sobre Futuros description: >- Consulte a série temporal EOD de volatilidade implícita e gregas calculadas para uma opção sobre futuro específica. full: true keywords: brapi, api, opções sobre futuros, histórico, gregas, volatilidade implícita openGraph: title: Histórico de Gregas e IV de Opções sobre Futuros description: >- Série temporal EOD de volatilidade implícita e gregas calculadas para uma opção sobre futuro específica. type: website locale: pt\_BR lastUpdated: '2026-06-01T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/futures/options/analytics/history structuredData: headings: \[] contents: * content: >- Retorna a série temporal EOD de IV e gregas calculadas para uma opção sobre futuro específica. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna uma série temporal diária com volatilidade implícita, delta, gamma, theta, vega e rho para uma opção sobre futuro específica. Use este endpoint quando você já sabe o `symbol` da série. **Plano mínimo: Pro.** No sandbox sem token, aceita apenas símbolos que começam com `BGI`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/futures/options/analytics/history Single endpoint documentation for /api/v2/futures/options/analytics/history ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/futures/options/analytics/history **Summary:** Histórico de gregas e IV Retorna a série temporal EOD de volatilidade implícita e gregas calculadas para uma única opção sobre futuro. **Tags:** Opções sobre Futuros ### Parameters - **symbol** (query) *required* - **startDate** (query) - **endDate** (query) - **sortOrder** (query) ### Responses #### 200 Histórico de análises. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FutureOptionAnalyticsHistoryResponse **Properties:** - **option** *(required)* Reference to: **FutureOptionWithAnalyticsHistory** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### FutureOptionAnalyticsPoint **Properties:** - **date** (string) *(required)* Data do pregão, no formato YYYY-MM-DD. - **model** (string) - Options: `black-76`, `cox-ross-rubinstein-futures`, `unsupported` *(required)* Modelo usado na precificação. Opções europeias sobre futuros usam Black-76; opções americanas usam aproximação binomial. - **priceSource** (string) - Options: `close`, `referencePrice`, `none` *(required)* Preço usado para resolver IV. `referencePrice` é preço de referência oficial e vem com confiança menor que fechamento negociado. - **underlyingPrice** (number) *(nullable)* *(required)* Preço do contrato futuro subjacente usado no cálculo. - **optionPrice** (number) *(nullable)* *(required)* Preço da opção usado para resolver a volatilidade implícita. - **riskFreeRate** (number) *(nullable)* *(required)* Taxa livre de risco anual em decimal. - **dividendYield** (number) *(nullable)* *(required)* Sempre `0` para opções sobre futuros em v1. - **timeToExpirationYears** (number) *(nullable)* *(required)* Tempo até o vencimento em anos. - **impliedVolatility** (number) *(nullable)* *(required)* Volatilidade implícita anualizada em decimal. - **delta** (number) *(nullable)* *(required)* Delta da opção. - **gamma** (number) *(nullable)* *(required)* Gamma da opção. - **theta** (number) *(nullable)* *(required)* Theta anualizado da opção. - **vega** (number) *(nullable)* *(required)* Vega da opção. - **rho** (number) *(nullable)* *(required)* Rho da opção. - **confidence** (string) - Options: `high`, `medium`, `low`, `none` *(required)* Confiança operacional do cálculo. `low` é esperado quando o cálculo usa `referencePrice`. - **nullReason** (string) *(nullable)* *(required)* Motivo para campos calculados nulos, quando aplicável (ex.: `no_trades`, `missing_underlying_price`, `iv_not_converged`). ### FutureOptionSpecs **Properties:** - **symbol** (string) *(required)* Código da opção (ex.: `BGIH27C028550`). - **underlyingAsset** (string) *(required)* Código do ativo (ex.: `BGI`). - **underlyingFuture** (string) *(nullable)* *(required)* Contrato futuro de base, quando existir. - **optionType** (string) - Options: `call`, `put` *(required)* `call` (compra) ou `put` (venda). - **optionStyle** (string) - Options: `american`, `european` *(nullable)* *(required)* `american` (exerce a qualquer momento) ou `european` (só no vencimento). - **segment** (string) - Options: `financial`, `agribusiness` *(required)* `financial` ou `agribusiness`. - **strike** (number) *(required)* Strike (preço combinado). - **expirationDate** (string) *(required)* Data de vencimento (YYYY-MM-DD). - **firstTradeDate** (string) *(nullable)* *(required)* Data do primeiro pregão. - **lastTradeDate** (string) *(nullable)* *(required)* Data do último pregão. - **contractMultiplier** (number) *(nullable)* *(required)* Multiplicador (vem do futuro de base). - **allocationRoundLot** (integer) *(nullable)* *(required)* Tamanho do lote. - **exerciseType** (string) *(nullable)* *(required)* Tipo de exercício. - **automaticExercise** (boolean) *(nullable)* *(required)* `true` se a opção é exercida sozinha no vencimento. - **premiumUpfront** (boolean) *(nullable)* *(required)* `true` se o prêmio é pago à vista, `false` se é diferido. - **isin** (string) *(nullable)* *(required)* Código ISIN. - **cficCode** (string) *(nullable)* *(required)* Código CFI. ### FutureOptionWithAnalyticsHistory # Gregas e IV de Opções sobre Futuros URL: /docs/futuros/opcoes/analytics.mdx Consulte volatilidade implícita e gregas EOD calculadas para opções sobre futuros por vencimento. *** title: Gregas e IV de Opções sobre Futuros description: >- Consulte volatilidade implícita e gregas EOD calculadas para opções sobre futuros por vencimento. full: true keywords: brapi, api, opções sobre futuros, gregas, volatilidade implícita, BGI, ICF openGraph: title: Gregas e IV de Opções sobre Futuros description: >- Consulte volatilidade implícita e gregas EOD calculadas para opções sobre futuros. type: website locale: pt\_BR lastUpdated: '2026-06-01T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/futures/options/analytics structuredData: headings: \[] contents: * content: >- Retorna volatilidade implícita e gregas EOD calculadas para opções sobre futuros de um vencimento. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna volatilidade implícita e gregas EOD para opções sobre futuros de um vencimento, com filtros por `side`, `minStrike` e `maxStrike`. Opções europeias sobre futuros usam Black-76. Opções americanas usam uma aproximação binomial sobre futuros. Quando faltam dados suficientes, os campos calculados ficam `null` e `nullReason` explica o motivo. **Plano mínimo: Pro.** No sandbox sem token, aceita apenas `underlying=BGI`. Quando não há fechamento negociado, algumas séries podem usar `referencePrice` como entrada. Nesses casos, `priceSource` vem como `referencePrice` e `confidence` tende a ser menor. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/futures/options/analytics Single endpoint documentation for /api/v2/futures/options/analytics ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/futures/options/analytics **Summary:** Gregas e IV Retorna volatilidade implícita e gregas EOD calculadas para opções sobre futuros de um vencimento. Opções europeias usam Black-76; opções americanas usam aproximação binomial sobre futuros. Quando não há dados suficientes, os campos calculados ficam `null` e `nullReason` explica o motivo. **Tags:** Opções sobre Futuros ### Parameters - **underlying** (query) *required* - **expirationDate** (query) *required* - **date** (query) - **side** (query) - **minStrike** (query) - **maxStrike** (query) - **limit** (query) ### Responses #### 200 Análises. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FutureOptionAnalyticsQuote **Properties:** - **symbol** (string) *(required)* Código da opção (ex.: `BGIH27C028550`). - **underlyingAsset** (string) *(required)* Código do ativo (ex.: `BGI`). - **underlyingFuture** (string) *(nullable)* *(required)* Contrato futuro de base, quando existir. - **optionType** (string) - Options: `call`, `put` *(required)* `call` (compra) ou `put` (venda). - **optionStyle** (string) - Options: `american`, `european` *(nullable)* *(required)* `american` (exerce a qualquer momento) ou `european` (só no vencimento). - **segment** (string) - Options: `financial`, `agribusiness` *(required)* `financial` ou `agribusiness`. - **strike** (number) *(required)* Strike (preço combinado). - **expirationDate** (string) *(required)* Data de vencimento (YYYY-MM-DD). - **firstTradeDate** (string) *(nullable)* *(required)* Data do primeiro pregão. - **lastTradeDate** (string) *(nullable)* *(required)* Data do último pregão. - **contractMultiplier** (number) *(nullable)* *(required)* Multiplicador (vem do futuro de base). - **allocationRoundLot** (integer) *(nullable)* *(required)* Tamanho do lote. - **exerciseType** (string) *(nullable)* *(required)* Tipo de exercício. - **automaticExercise** (boolean) *(nullable)* *(required)* `true` se a opção é exercida sozinha no vencimento. - **premiumUpfront** (boolean) *(nullable)* *(required)* `true` se o prêmio é pago à vista, `false` se é diferido. - **isin** (string) *(nullable)* *(required)* Código ISIN. - **cficCode** (string) *(nullable)* *(required)* Código CFI. - **date** (string) *(required)* Data do pregão, no formato YYYY-MM-DD. - **model** (string) - Options: `black-76`, `cox-ross-rubinstein-futures`, `unsupported` *(required)* Modelo usado na precificação. Opções europeias sobre futuros usam Black-76; opções americanas usam aproximação binomial. - **priceSource** (string) - Options: `close`, `referencePrice`, `none` *(required)* Preço usado para resolver IV. `referencePrice` é preço de referência oficial e vem com confiança menor que fechamento negociado. - **underlyingPrice** (number) *(nullable)* *(required)* Preço do contrato futuro subjacente usado no cálculo. - **optionPrice** (number) *(nullable)* *(required)* Preço da opção usado para resolver a volatilidade implícita. - **riskFreeRate** (number) *(nullable)* *(required)* Taxa livre de risco anual em decimal. - **dividendYield** (number) *(nullable)* *(required)* Sempre `0` para opções sobre futuros em v1. - **timeToExpirationYears** (number) *(nullable)* *(required)* Tempo até o vencimento em anos. - **impliedVolatility** (number) *(nullable)* *(required)* Volatilidade implícita anualizada em decimal. - **delta** (number) *(nullable)* *(required)* Delta da opção. - **gamma** (number) *(nullable)* *(required)* Gamma da opção. - **theta** (number) *(nullable)* *(required)* Theta anualizado da opção. - **vega** (number) *(nullable)* *(required)* Vega da opção. - **rho** (number) *(nullable)* *(required)* Rho da opção. - **confidence** (string) - Options: `high`, `medium`, `low`, `none` *(required)* Confiança operacional do cálculo. `low` é esperado quando o cálculo usa `referencePrice`. - **nullReason** (string) *(nullable)* *(required)* Motivo para campos calculados nulos, quando aplicável (ex.: `no_trades`, `missing_underlying_price`, `iv_not_converged`). ### FutureOptionAnalyticsResponse **Properties:** - **underlying** (string) *(required)* - **expirationDate** (string) *(required)* - **date** (string) *(required)* - **analytics** (array) *(required)* Array items: Reference to: **FutureOptionAnalyticsQuote** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # Histórico de Opções sobre Futuros URL: /docs/futuros/opcoes/historico.mdx Série diária de uma opção sobre futuro: OHLC, preço de referência e volume. Pronto para gráfico ou backtest. *** title: Histórico de Opções sobre Futuros description: >- Série diária de uma opção sobre futuro: OHLC, preço de referência e volume. Pronto para gráfico ou backtest. full: true keywords: brapi, api, opções sobre futuros, histórico, OHLC, backtest openGraph: title: Histórico de Opções sobre Futuros description: >- Série diária de uma opção sobre futuro. type: website locale: pt\_BR lastUpdated: '2026-05-21T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/futures/options/historical structuredData: headings: \[] contents: * content: >- Série diária de uma opção sobre futuro identificada por símbolo, pronta para gráfico ou backtest. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna a série diária de uma opção sobre futuro, pelo `symbol` (ex.: `BGIK26C034300`). O normal é descobrir a série em [Cadeia](/docs/futuros/opcoes/series) e depois chamar este endpoint. Ele aceita **uma série por vez**. A resposta tem: * **Dados completos do contrato** — strike, optionStyle, multiplier, lote, ISIN etc. * **Série diária com negócio** — OHLC, referencePrice, oscillationPct, trades, volume, financialVolume. A maioria das séries longe do preço atual negocia pouco — sua resposta pode ter só alguns dias. Para acompanhar todo dia, escolha a série mais próxima do preço atual. **Plano Pro.** Sem token, aceita só `symbol` começando com `BGI`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/futures/options/historical Single endpoint documentation for /api/v2/futures/options/historical ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/futures/options/historical **Summary:** Histórico da opção Série diária de uma opção sobre futuro, com OHLC e volume. **Tags:** Opções sobre Futuros ### Parameters - **symbol** (query) *required* - **startDate** (query) - **endDate** (query) - **sortOrder** (query) ### Responses #### 200 Histórico. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FutureOptionHistoricalResponse **Properties:** - **option** *(required)* Reference to: **FutureOptionWithHistory** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### FutureOptionPricePoint **Properties:** - **date** (integer) *(required)* Data do pregão (Unix em segundos). - **open** (number) *(nullable)* *(required)* Abertura. - **high** (number) *(nullable)* *(required)* Máxima. - **low** (number) *(nullable)* *(required)* Mínima. - **average** (number) *(nullable)* *(required)* Preço médio. - **close** (number) *(nullable)* *(required)* Fechamento. - **referencePrice** (number) *(nullable)* *(required)* Preço de referência oficial. - **oscillationPct** (number) *(nullable)* *(required)* Variação % em relação ao dia anterior. - **trades** (number) *(nullable)* *(required)* Número de negócios. - **volume** (number) *(nullable)* *(required)* Quantidade de contratos negociados. - **financialVolume** (number) *(nullable)* *(required)* Volume em reais (BRL). ### FutureOptionSpecs **Properties:** - **symbol** (string) *(required)* Código da opção (ex.: `BGIH27C028550`). - **underlyingAsset** (string) *(required)* Código do ativo (ex.: `BGI`). - **underlyingFuture** (string) *(nullable)* *(required)* Contrato futuro de base, quando existir. - **optionType** (string) - Options: `call`, `put` *(required)* `call` (compra) ou `put` (venda). - **optionStyle** (string) - Options: `american`, `european` *(nullable)* *(required)* `american` (exerce a qualquer momento) ou `european` (só no vencimento). - **segment** (string) - Options: `financial`, `agribusiness` *(required)* `financial` ou `agribusiness`. - **strike** (number) *(required)* Strike (preço combinado). - **expirationDate** (string) *(required)* Data de vencimento (YYYY-MM-DD). - **firstTradeDate** (string) *(nullable)* *(required)* Data do primeiro pregão. - **lastTradeDate** (string) *(nullable)* *(required)* Data do último pregão. - **contractMultiplier** (number) *(nullable)* *(required)* Multiplicador (vem do futuro de base). - **allocationRoundLot** (integer) *(nullable)* *(required)* Tamanho do lote. - **exerciseType** (string) *(nullable)* *(required)* Tipo de exercício. - **automaticExercise** (boolean) *(nullable)* *(required)* `true` se a opção é exercida sozinha no vencimento. - **premiumUpfront** (boolean) *(nullable)* *(required)* `true` se o prêmio é pago à vista, `false` se é diferido. - **isin** (string) *(nullable)* *(required)* Código ISIN. - **cficCode** (string) *(nullable)* *(required)* Código CFI. ### FutureOptionWithHistory # Opções sobre Futuros URL: /docs/futuros/opcoes.mdx Como usar a API de opções sobre futuros (boi, café, milho, soja e outros). Veja os termos, o passo a passo e qual endpoint usar. *** title: Opções sobre Futuros description: >- Como usar a API de opções sobre futuros (boi, café, milho, soja e outros). Veja os termos, o passo a passo e qual endpoint usar. full: true keywords: brapi, api, opções sobre futuros, BGI, ICF, CCM, SJC, calls, puts, vencimento, strike openGraph: title: Opções sobre Futuros description: >- Como usar a API de opções sobre futuros, com passo a passo e exemplos. type: website locale: pt\_BR lastUpdated: '2026-05-21T12:00:00.000Z' lang: pt-BR ----------- import { Callout } from 'fumadocs-ui/components/callout'; import { Card, Cards } from 'fumadocs-ui/components/card'; import { Step, Steps } from 'fumadocs-ui/components/steps'; import { Tab, Tabs } from 'fumadocs-ui/components/tabs'; Use esta API para consultar opções cujo ativo-base é um contrato futuro. Ela é útil para telas de cadeia, histórico EOD, gregas e volatilidade implícita de commodities e futuros financeiros. Na bolsa brasileira, os principais ativos são: * **Boi gordo** (`BGI`) * **Café arábica** (`ICF`) * **Milho** (`CCM`) * **Soja** (`SJC`) * Outros menores: `CNL`, `D11`–`D17` (DI), `ETH`, `GLD`, `ISP`, `SOY`. Esta seção é para opções **sobre futuros**. Para opções de **ações, ETFs e índices** (PETR4, VALE3, BOVA11 etc.), veja [Opções](/docs/opcoes). A API entrega vencimentos, strikes, cadeia de opções, histórico EOD, volatilidade implícita e gregas calculadas para opções europeias e americanas. ## Cobertura e atualização * **Histórico:** cerca de **1 ano**, atualizado após o pregão. * **Quando atualiza:** **após as 19h** (horário de Brasília). * **Contratos:** opções listadas sobre futuros (commodities e financeiros). * **Analytics:** volatilidade implícita e gregas EOD calculadas para opções europeias (Black-76) e americanas (aproximação binomial). * **Fuso horário:** `America/Sao_Paulo`. Em respostas de preços/histórico, `date` é um número (Unix em segundos); em respostas de analytics, `date` vem em `YYYY-MM-DD`. ## Termos * **Ativo (`underlyingAsset`):** o código do **futuro** que serve de base (ex.: `BGI`, `ICF`). * **Código da opção (`symbol`):** padrão do mercado `{ATIVO}{LETRA_MÊS_FUTURO}{ANO}{C|P}{STRIKE×100}`. Ex.: `BGIH27C028550` = call sobre BGI, vencimento março/2027, strike R$ 285,50. * **Estilo (`optionStyle`):** `american` (pode exercer a qualquer momento) ou `european` (só no vencimento). Opções sobre commodities são quase sempre **american**. * **Tipo (`optionType`):** `call` (compra) ou `put` (venda). * **Strike (`strike`):** preço combinado, em reais. * **Multiplicador (`contractMultiplier`):** vem do futuro. Ex.: opções de boi têm multiplicador `330` (arrobas). * **Lote (`allocationRoundLot`):** quase sempre `1`. * **Exercício automático (`automaticExercise`):** se `true`, a opção é exercida sozinha no vencimento quando vale a pena. ## Acesso Opções sobre futuros estão no plano **Pro**, junto com os futuros. | Plano | Acesso | | ------------------- | ------------------- | | Sem token (sandbox) | BGI (boi gordo) | | Free | Não incluso | | Startup | Não incluso | | **Pro** | **Todos os ativos** | ## Comece rápido Exemplo do fluxo `vencimentos → cadeia → histórico` para opções de **boi gordo (BGI)**. Funciona no sandbox sem token. ```bash # 1) Vencimentos disponíveis curl "https://brapi.dev/api/v2/futures/options/expirations?underlying=BGI" # 2) Cadeia (calls + puts) de um vencimento curl "https://brapi.dev/api/v2/futures/options/chain?underlying=BGI&expirationDate=2026-05-29" # 3) Histórico de uma série curl "https://brapi.dev/api/v2/futures/options/historical?symbol=BGIK26C034300" ``` ```typescript const BASE = 'https://brapi.dev/api/v2/futures/options'; const token = process.env.BRAPI_TOKEN; // opcional para BGI no sandbox const headers = token ? { Authorization: `Bearer ${token}` } : undefined; // 1) Vencimentos const exps = await fetch(`${BASE}/expirations?underlying=BGI`, { headers, }).then((r) => r.json()); const nextExp = exps.expirations[0]; // 2) Cadeia const chain = await fetch( `${BASE}/chain?underlying=BGI&expirationDate=${nextExp}`, { headers }, ).then((r) => r.json()); // 3) Histórico da série mais próxima do preço const atm = chain.series[0]; const history = await fetch( `${BASE}/historical?symbol=${atm.symbol}`, { headers }, ).then((r) => r.json()); console.log(history); ``` ```python import os import requests BASE = "https://brapi.dev/api/v2/futures/options" token = os.getenv("BRAPI_TOKEN") # opcional para BGI no sandbox headers = {"Authorization": f"Bearer {token}"} if token else {} # 1) Vencimentos exps = requests.get( f"{BASE}/expirations", params={"underlying": "BGI"}, headers=headers ).json() next_exp = exps["expirations"][0] # 2) Cadeia chain = requests.get( f"{BASE}/chain", params={"underlying": "BGI", "expirationDate": next_exp}, headers=headers, ).json() # 3) Histórico atm = chain["series"][0] history = requests.get( f"{BASE}/historical", params={"symbol": atm["symbol"]}, headers=headers ).json() print(history) ``` ## Passo a passo #### Vencimentos Comece em [`/api/v2/futures/options/expirations`](/docs/futuros/opcoes/vencimentos) com o ativo do subjacente (ex.: `BGI`, `ICF`). #### Strikes Use [`/api/v2/futures/options/strikes`](/docs/futuros/opcoes/precos-de-exercicio) para ver os strikes do vencimento. Filtre por `side=call` ou `side=put`. #### Cadeia Use [`/api/v2/futures/options/chain`](/docs/futuros/opcoes/series) para todas as séries do vencimento, com último preço. #### Gregas e IV Use [`/api/v2/futures/options/analytics`](/docs/futuros/opcoes/analytics) para a foto EOD de um vencimento, ou [`/api/v2/futures/options/analytics/history`](/docs/futuros/opcoes/analytics-historico) para a série temporal de uma opção específica. #### Histórico Quando souber a série, use [`/api/v2/futures/options/historical`](/docs/futuros/opcoes/historico). ## Casos comuns * **Tela de opções de commodity:** `expirations → chain` * **Filtro por faixa de strike:** `chain?minStrike=X&maxStrike=Y` * **Gregas e volatilidade implícita por vencimento:** `expirations → analytics` * **Backtest de boi/café/milho/soja:** `chain` para escolher a série, depois `historical` e `analytics/history`. ## Perguntas frequentes ## Endpoints # Strikes de Opções sobre Futuros URL: /docs/futuros/opcoes/precos-de-exercicio.mdx Strikes disponíveis para opções sobre um futuro num vencimento, com filtro por call/put. *** title: Strikes de Opções sobre Futuros description: >- Strikes disponíveis para opções sobre um futuro num vencimento, com filtro por call/put. full: true keywords: brapi, api, opções sobre futuros, strikes, preço de exercício openGraph: title: Strikes de Opções sobre Futuros description: >- Strikes disponíveis para opções sobre um futuro. type: website locale: pt\_BR lastUpdated: '2026-05-21T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/futures/options/strikes structuredData: headings: \[] contents: * content: >- Strikes disponíveis para opções sobre um futuro num vencimento. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna a lista de strikes do vencimento, para o ativo pedido. Filtre por `side=call` ou `side=put` se precisar. Use este endpoint quando quiser ver a faixa de strikes antes de chamar a [cadeia](/docs/futuros/opcoes/series) — assim dá para limitar a cadeia com `minStrike` e `maxStrike`. **Plano Pro.** Sem token, aceita só `underlying=BGI`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/futures/options/strikes Single endpoint documentation for /api/v2/futures/options/strikes ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/futures/options/strikes **Summary:** Strikes Lista os strikes disponíveis para um ativo num vencimento. Filtra por call ou put. **Tags:** Opções sobre Futuros ### Parameters - **underlying** (query) *required* - **expirationDate** (query) *required* - **side** (query) ### Responses #### 200 Strikes. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FutureOptionStrikesResponse **Properties:** - **underlying** (string) *(required)* - **expirationDate** (string) *(required)* - **side** (string) - Options: `call`, `put` *(nullable)* *(required)* - **strikes** (array) *(required)* Array items: **Type:** number - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # Cadeia de Opções sobre Futuros URL: /docs/futuros/opcoes/series.mdx Cadeia (calls + puts) de opções sobre um futuro num vencimento, com preço, volume, estilo e multiplicador. *** title: Cadeia de Opções sobre Futuros description: >- Cadeia (calls + puts) de opções sobre um futuro num vencimento, com preço, volume, estilo e multiplicador. full: true keywords: brapi, api, opções sobre futuros, cadeia, chain, calls, puts, série openGraph: title: Cadeia de Opções sobre Futuros description: >- Cadeia (calls + puts) de opções sobre um futuro num vencimento. type: website locale: pt\_BR lastUpdated: '2026-05-21T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/futures/options/chain structuredData: headings: \[] contents: * content: >- Cadeia (calls e puts) de opções sobre um futuro num vencimento, com o último preço. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna todas as séries (calls e puts) do vencimento, com o último preço até a data pedida. Cada série tem: * **Dados do contrato:** `symbol`, `optionType` (call/put), `optionStyle` (american/european), `strike`, `expirationDate`, `contractMultiplier`, `allocationRoundLot`, `automaticExercise`. * **Cotação do dia:** OHLC, `referencePrice`, `oscillationPct`, `trades`, `volume`, `financialVolume`. Filtros opcionais: `side=call|put`, `minStrike`, `maxStrike`. A maioria das séries longe do preço atual tem pouca negociação. `close` pode vir `null` em muitas linhas — o `referencePrice` pode estar preenchido mesmo sem negócio. **Plano Pro.** Sem token, aceita só `underlying=BGI`. ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/futures/options/chain Single endpoint documentation for /api/v2/futures/options/chain ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/futures/options/chain **Summary:** Cadeia (calls + puts) Cadeia completa de calls e puts de um vencimento, com o último preço de cada série. **Tags:** Opções sobre Futuros ### Parameters - **underlying** (query) *required* - **expirationDate** (query) *required* - **date** (query) - **side** (query) - **minStrike** (query) - **maxStrike** (query) ### Responses #### 200 Cadeia. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 404 Não encontrado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FutureOptionChainResponse **Properties:** - **underlying** (string) *(required)* - **expirationDate** (string) *(required)* - **date** (string) *(required)* - **series** (array) *(required)* Array items: Reference to: **FutureOptionQuote** - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos ### FutureOptionQuote **Properties:** - **symbol** (string) *(required)* Código da opção (ex.: `BGIH27C028550`). - **underlyingAsset** (string) *(required)* Código do ativo (ex.: `BGI`). - **underlyingFuture** (string) *(nullable)* *(required)* Contrato futuro de base, quando existir. - **optionType** (string) - Options: `call`, `put` *(required)* `call` (compra) ou `put` (venda). - **optionStyle** (string) - Options: `american`, `european` *(nullable)* *(required)* `american` (exerce a qualquer momento) ou `european` (só no vencimento). - **segment** (string) - Options: `financial`, `agribusiness` *(required)* `financial` ou `agribusiness`. - **strike** (number) *(required)* Strike (preço combinado). - **expirationDate** (string) *(required)* Data de vencimento (YYYY-MM-DD). - **firstTradeDate** (string) *(nullable)* *(required)* Data do primeiro pregão. - **lastTradeDate** (string) *(nullable)* *(required)* Data do último pregão. - **contractMultiplier** (number) *(nullable)* *(required)* Multiplicador (vem do futuro de base). - **allocationRoundLot** (integer) *(nullable)* *(required)* Tamanho do lote. - **exerciseType** (string) *(nullable)* *(required)* Tipo de exercício. - **automaticExercise** (boolean) *(nullable)* *(required)* `true` se a opção é exercida sozinha no vencimento. - **premiumUpfront** (boolean) *(nullable)* *(required)* `true` se o prêmio é pago à vista, `false` se é diferido. - **isin** (string) *(nullable)* *(required)* Código ISIN. - **cficCode** (string) *(nullable)* *(required)* Código CFI. - **date** (integer) *(required)* Data do pregão (Unix em segundos). - **open** (number) *(nullable)* *(required)* Abertura. - **high** (number) *(nullable)* *(required)* Máxima. - **low** (number) *(nullable)* *(required)* Mínima. - **average** (number) *(nullable)* *(required)* Preço médio. - **close** (number) *(nullable)* *(required)* Fechamento. - **referencePrice** (number) *(nullable)* *(required)* Preço de referência oficial. - **oscillationPct** (number) *(nullable)* *(required)* Variação % em relação ao dia anterior. - **trades** (number) *(nullable)* *(required)* Número de negócios. - **volume** (number) *(nullable)* *(required)* Quantidade de contratos negociados. - **financialVolume** (number) *(nullable)* *(required)* Volume em reais (BRL). # Vencimentos de Opções sobre Futuros URL: /docs/futuros/opcoes/vencimentos.mdx Vencimentos disponíveis para opções sobre um futuro (boi, café, milho, soja e outros). *** title: Vencimentos de Opções sobre Futuros description: >- Vencimentos disponíveis para opções sobre um futuro (boi, café, milho, soja e outros). full: true keywords: brapi, api, opções sobre futuros, vencimentos, BGI, ICF, CCM, SJC openGraph: title: Vencimentos de Opções sobre Futuros description: >- Vencimentos disponíveis para opções sobre um futuro. type: website locale: pt\_BR lastUpdated: '2026-05-21T12:00:00.000Z' lang: pt-BR \_openapi: method: GET route: /api/v2/futures/options/expirations structuredData: headings: \[] contents: * content: >- Vencimentos disponíveis para opções sobre um futuro. *** import { Callout } from 'fumadocs-ui/components/callout'; Retorna a lista de vencimentos das opções de um ativo. Use `underlying` com o código do **futuro** (ex.: `BGI`, `ICF`, `CCM`, `SJC`). Os vencimentos das opções **nem sempre coincidem** com os do futuro — cada opção tem seu próprio calendário. **Plano Pro.** Sem token, aceita só `underlying=BGI` (boi gordo). ## Swagger Documentation # brapi - API do Mercado Financeiro Brasileiro - /api/v2/futures/options/expirations Single endpoint documentation for /api/v2/futures/options/expirations ## Base URLs - `https://brapi.dev` - Servidor principal da API brapi - `http://localhost:3001` - Servidor local para desenvolvimento ## GET /api/v2/futures/options/expirations **Summary:** Vencimentos Lista os vencimentos disponíveis das opções sobre um futuro. **Tags:** Opções sobre Futuros ### Parameters - **underlying** (query) *required* - **includeExpired** (query) ### Responses #### 200 Vencimentos. #### 400 Requisição inválida #### 401 Não autorizado #### 403 Acesso negado #### 500 Erro interno do servidor ## Schemas The following schemas are used by this endpoint: ### ErrorResponse Erro interno do servidor **Properties:** - **error** (boolean) - Options: `true` *(required)* - **message** (string) *(required)* - **code** (string) ### FutureOptionExpirationsResponse **Properties:** - **underlying** (string) *(required)* - **expirations** (array) *(required)* Array items: **Type:** string - **requestedAt** (string, date-time) *(required)* Data e hora da requisição em formato ISO 8601 - **took** (integer) *(required)* Tempo de processamento em milissegundos # Acesso Gratuito e Ilimitado a Ações Brasileiras: Teste a brapi sem Limitações URL: /blog/acesso-gratuito-ilimitado-acoes-teste-brapi.mdx Acesse dados completos de PETR4, MGLU3, VALE3 e ITUB4 grátis! Teste a API brapi sem limitações antes de assinar ✓ *** searchable: false title: 'Acesso Gratuito e Ilimitado a Ações Brasileiras: Teste a brapi sem Limitações' description: 'Acesse dados completos de PETR4, MGLU3, VALE3 e ITUB4 grátis! Teste a API brapi sem limitações antes de assinar ✓' date: '2026-01-01' keywords: 'API gratuita Brasil 2026, dados ações gratuitos, PETR4 MGLU3 VALE3 ITUB4, teste API brapi, desenvolvimento apps financeiros, dados bolsa gratuitos' author: 'Equipe brapi.dev' category: 'API e Desenvolvimento' subcategory: 'Acesso Gratuito' readingTime: '8 min' tags: \['API Gratuita', 'Desenvolvimento', 'PETR4', 'MGLU3', 'VALE3', 'ITUB4', 'Teste', 'Dados Financeiros'] relatedPosts: \['b3-api-gratuita-como-usar-cotacoes', 'listar-acoes-b3-api-tickers-setores-python', 'como-acompanhar-a-bolsa-de-valores-em-tempo-real', 'api-b3-python-requests-guia-pratico'] featured: false expertise: 'Equipe técnica da brapi.dev especializada em APIs financeiras e democratização de dados' lastReviewed: '2026-01-01' -------------------------- import { Author, Authors } from '~/components/Authors'; > Imagina poder testar todos os recursos da brapi, incluindo dados fundamentalistas > e histórico completo, sem precisar de token ou limitações? Agora isso é realidade! > Liberamos acesso total a quatro das principais ações brasileiras para que você > possa desenvolver e validar sua aplicação antes mesmo de assinar qualquer plano. ## A revolução chegou: teste antes de pagar Como desenvolvedor, você já passou por aquela situação frustrante de precisar assinar um serviço para descobrir se ele realmente atende suas necessidades? Ou de ficar limitado a dados básicos que não mostram o verdadeiro potencial de uma API? Pensando exatamente nisso, implementei uma mudança que vai transformar completamente como você experimenta a brapi. ## Quatro ações, acesso total, zero limitações A partir de hoje, você tem acesso **completamente irrestrito** a quatro das principais ações do mercado brasileiro: * **PETR4** (Petrobras PN) - O gigante do petróleo brasileiro * **MGLU3** (Magazine Luiza ON) - Líder do varejo digital * **VALE3** (Vale ON) - A maior mineradora das Américas * **ITUB4** (Itaú Unibanco PN) - O maior banco privado do país ### O que isso significa na prática? ```bash curl "https://brapi.dev/api/quote/PETR4" # Histórico completo? Sem problemas! curl "https://brapi.dev/api/quote/VALE3?range=2y&interval=1d" # Todos os módulos avançados? Pode usar! curl "https://brapi.dev/api/quote/PETR4,MGLU3,VALE3,ITUB4?modules=summaryProfile,balanceSheetHistory,defaultKeyStatistics÷nds=true" ``` ## Vantagens que fazem a diferença ### 🚀 **Desenvolvimento sem barreiras** Você pode construir sua aplicação completa usando essas ações como base, testando todos os endpoints e funcionalidades antes de decidir por um plano pago. ### 📊 **Validação real dos dados** Acesse dados fundamentalistas reais, histórico de dividendos, balanços patrimoniais e todos os indicadores financeiros. Você vê exatamente a qualidade e estrutura dos dados que terá no plano pago. ### ⚡ **Performance em produção** Os dados dessas ações são atualizados com a mesma frequência dos planos pagos (5 minutos), então você testa a API em condições reais de uso. ### 🛠️ **Prototipagem rápida** Perfeito para hackathons, MVPs, provas de conceito e demonstrações. Você mostra o valor real da sua ideia com dados de qualidade. ## Como funciona a integração ### Acesso simples e direto ```javascript // Sem necessidade de token para as ações de teste const response = await fetch('https://brapi.dev/api/quote/PETR4,MGLU3'); const data = await response.json(); console.log(data.results); // Dados completos das duas ações ``` ### Recursos avançados inclusos ```bash # Balanço patrimonial dos últimos anos curl "https://brapi.dev/api/quote/VALE3?modules=balanceSheetHistory" # Indicadores fundamentalistas completos curl "https://brapi.dev/api/quote/ITUB4?modules=defaultKeyStatistics" # Histórico de dividendos curl "https://brapi.dev/api/quote/PETR4?dividends=true" ``` ### Integração inteligente O sistema é inteligente: se você consultar **apenas** as ações de teste, não precisa de autenticação. Mas se misturar com outras ações, o token continua obrigatório: ```bash # ✅ Funciona sem token (só ações de teste) curl "https://brapi.dev/api/quote/PETR4,VALE3" # ❌ Precisa de token (mistura teste + outras) curl "https://brapi.dev/api/quote/PETR4,BBAS3" # Requer Authorization header ``` ## Por que essas ações específicas? Escolhi essas quatro empresas estrategicamente: * **Setores diversificados**: Petróleo, varejo, mineração e bancos * **Liquidez alta**: São algumas das ações mais negociadas da bolsa brasileira * **Dados ricos**: Possuem histórico extenso e fundamentais robustos * **Relevância**: Representam bem o mercado brasileiro ## Cases de uso perfeitos ### **Fintech em desenvolvimento** Teste sua lógica de análise fundamentalista com dados reais antes de investir em uma API paga. ### **Dashboard de investimentos** Construa a interface e funcionalidades usando essas ações como exemplo, depois escale para o portfólio completo. ### **Bot de trading** Valide suas estratégias e algoritmos com dados históricos reais e atualizações em tempo real. ### **Aplicativo educacional** Ensine conceitos de investimento com dados reais e atualizados das principais empresas brasileiras. ## A diferença que isso faz Essa funcionalidade elimina a principal barreira para desenvolvedores testarem a brapi: a necessidade de comprometimento financeiro antes de validar se a API atende suas necessidades. Agora você pode: * ✅ Testar a qualidade e estrutura dos dados * ✅ Validar a performance da API * ✅ Desenvolver features complexas * ✅ Demonstrar valor para stakeholders * ✅ Fazer provas de conceito robustas Tudo isso **antes** de assinar qualquer plano. ## Próximos passos Ready para começar? Aqui está o que você pode fazer agora: 1. **Explore a [documentação](https://brapi.dev/docs)** para entender todos os endpoints disponíveis 2. **Teste os exemplos** diretamente no seu terminal ou ferramenta favorita 3. **Desenvolva sua aplicação** usando as quatro ações como base 4. **Quando estiver pronto para escalar**, escolha o [plano](https://brapi.dev/pricing) que faz sentido para o seu projeto ## Conclusão Essa mudança representa minha visão de como APIs devem funcionar: transparentes, acessíveis e focadas na experiência do desenvolvedor. Você não deveria precisar "comprar para experimentar" quando se trata de ferramentas que vão impactar diretamente o sucesso do seu projeto. A brapi continua sendo a API de dados financeiros mais completa do Brasil, e agora também é a mais acessível para começar. **Comece hoje mesmo.** Teste, desenvolva, valide e, quando estiver convencido do valor, escale para o universo completo de dados financeiros que a brapi oferece. *** *Tem dúvidas ou sugestões? Entre em contato pelo [Twitter](https://x.com/alissonsleal) ou através da nossa [página de contato](https://brapi.dev/contact). Adoraria saber como você está usando essa nova funcionalidade!* # Ações de Bancos em 2026: Análise Setorial Completa do Setor Bancário Brasileiro URL: /blog/acoes-bancos-analise-setorial-2026.mdx Guia completo do setor bancário: análise de ITUB4, BBDC4, BBAS3, SANB11. Como avaliar bancos, indicadores-chave e melhores oportunidades. *** searchable: true title: 'Ações de Bancos em 2026: Análise Setorial Completa do Setor Bancário Brasileiro' description: 'Guia completo do setor bancário: análise de ITUB4, BBDC4, BBAS3, SANB11. Como avaliar bancos, indicadores-chave e melhores oportunidades.' date: '2026-01-01' keywords: 'ações de bancos 2026, itub4, bbdc4, bbas3, sanb11, setor bancário brasil, investir em bancos, dividendos bancos, análise bancos brasileiros, melhores bancos bolsa' author: 'Equipe brapi.dev' category: 'Ações' subcategory: 'Setores' readingTime: '22 min' tags: \['Bancos', 'Ações', 'ITUB4', 'BBDC4', 'BBAS3', 'Dividendos', 'Análise Setorial'] relatedPosts: \['melhores-acoes-pagadoras-dividendos-2026', 'como-analisar-acoes-guia-iniciantes-2026', 'melhores-acoes-setor-eletrico-2026-dividendos-taee11-trpl4', 'analise-fundamentalista-acoes-indicadores-essenciais-investir-b3', 'setor-seguros-bbse3-cxse3-pssa3-analise-2026'] featured: true expertise: 'Análise do setor bancário brasileiro' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > O setor bancário brasileiro é um dos mais rentáveis do mundo. Aprenda como funcionam os bancos, como analisá-los e quais são as melhores oportunidades. *** ## Resumo: Principais Bancos na Bolsa | Banco | Ticker | Tipo | ROE | DY Estimado | P/L | Perfil | | ------------------- | ------ | ------------------ | ------ | ----------- | ------ | -------------------- | | **Itaú Unibanco** | ITUB4 | Privado | 20-22% | 5-7% | 8-10x | Líder, qualidade | | **Bradesco** | BBDC4 | Privado | 10-14% | 6-8% | 6-8x | Recovery, descontado | | **Banco do Brasil** | BBAS3 | Estatal | 18-22% | 8-10% | 4-6x | Dividendos, barato | | **Santander** | SANB11 | Privado (espanhol) | 12-16% | 5-7% | 6-8x | Consistente | | **BTG Pactual** | BPAC11 | Investimentos | 18-22% | 2-4% | 10-12x | Crescimento | | **Banrisul** | BRSR6 | Estatal (RS) | 10-14% | 8-12% | 3-5x | Dividendos, regional | | **ABC Brasil** | ABCB4 | Corporativo | 14-18% | 5-7% | 5-7x | Nicho, consistente | | **Banco Pan** | BPAN4 | Digital/Consignado | 8-12% | 2-4% | 8-10x | Crescimento | *** ## Como Funcionam os Bancos ### O Modelo de Negócio Depósitos
juros baixos] --> B[Spread
Diferença = LUCRO] B --> C[Empréstimo
Crédito
juros altos] style A fill:#2563eb,color:#fff style B fill:#16a34a,color:#fff style C fill:#ea580c,color:#fff `} /> **Exemplo prático:** * Capta CDB pagando 10% ao ano * Empresta a 25% ao ano * Spread bruto: 15 pontos percentuais ### Fontes de Receita | Fonte | Descrição | % Receita Típica | | --------------------------- | --------------------- | ---------------- | | **Margem Financeira (NII)** | Spread de crédito | 50-60% | | **Tarifas e Serviços** | Taxas, cartões, conta | 20-30% | | **Seguros** | Bancassurance | 10-15% | | **Tesouraria** | Trading, câmbio | 5-10% | | **Asset Management** | Fundos, previdência | 5-10% | ### Estrutura de um Banco V[Varejo - Pessoas Físicas] B --> E[Empresas - PJ] B --> W[Wealth Management] B --> I[Investimentos] V --> V1[Conta corrente] V --> V2[Crédito pessoal/consignado] V --> V3[Financiamento imobiliário] V --> V4[Cartões de crédito] E --> E1[Capital de giro] E --> E2[Financiamento] E --> E3[Câmbio e comércio exterior] W --> W1[Private banking] W --> W2[Asset management] I --> I1[Investment banking] I --> I2[Tesouraria] style B fill:#1e40af,color:#fff `} /> *** ## Indicadores-Chave para Bancos ### 1. ROE (Return on Equity) O indicador MAIS importante para bancos. **Fórmula:** ROE = Lucro Líquido / Patrimônio Líquido | Faixa | Classificação | Exemplos | | ------ | ------------- | -------------- | | > 20% | Excelente | Itaú, BB | | 15-20% | Bom | — | | 10-15% | Regular | Bradesco atual | | \< 10% | Ruim | — | ### 2. Índice de Eficiência Quanto menor, melhor (menos custo para gerar receita). **Fórmula:** Índice de Eficiência = Despesas Operacionais / Receitas | Faixa | Classificação | | ------ | ------------- | | \< 40% | Excelente | | 40-50% | Bom | | 50-60% | Regular | | > 60% | Ruim | ### 3. Índice de Inadimplência **Fórmula:** Inadimplência = Operações em Atraso > 90 dias / Carteira Total | Faixa | Nível | | ----- | ----------- | | \< 3% | Saudável | | 3-5% | Atenção | | 5-7% | Preocupante | | > 7% | Crítico | ### 4. Índice de Cobertura **Fórmula:** Cobertura = Provisões (PDD) / Operações em Atraso > 90 dias | Faixa | Interpretação | | -------- | ----------------- | | > 200% | Muito conservador | | 150-200% | Conservador | | 100-150% | Adequado | | \< 100% | Insuficiente | ### 5. Índice de Basileia Mede a solidez do banco (exigido pelo Banco Central). | Faixa | Classificação | | ----- | ------------------ | | 10,5% | Mínimo regulatório | | > 12% | Ideal | | > 15% | Muito capitalizado | *** ## Análise dos Principais Bancos ### Itaú Unibanco (ITUB4) **O maior banco privado da América Latina.** | Característica | Detalhes | | -------------- | -------------------------- | | **Posição** | Líder de mercado | | **ROE** | 20-22% | | **Eficiência** | \~40% (melhor do setor) | | **Estratégia** | Qualidade sobre quantidade | | **Digital** | Itaú, Iti, Íon | **Pontos Fortes**: * ✅ Maior ROE entre grandes bancos * ✅ Melhor eficiência operacional * ✅ Gestão reconhecida * ✅ Diversificação de receitas * ✅ Liderança em wealth management **Pontos de Atenção**: * ⚠️ Valuation mais alto que pares * ⚠️ Crescimento de crédito conservador * ⚠️ Competição de fintechs **Valuation típico**: P/L 8-10x, P/VP 1,5-2,0x *** ### Bradesco (BBDC4) **O banco em reestruturação.** | Característica | Detalhes | | -------------- | ---------------------------- | | **Posição** | 2º maior privado | | **ROE** | 10-14% (abaixo do histórico) | | **Eficiência** | \~48% | | **Estratégia** | Turnaround em andamento | | **Seguros** | Bradesco Seguros (líder) | **Pontos Fortes**: * ✅ Bradesco Seguros (muito rentável) * ✅ Valuation descontado * ✅ Base de clientes enorme * ✅ Potencial de recuperação **Pontos de Atenção**: * ⚠️ ROE abaixo do potencial * ⚠️ Problemas de eficiência * ⚠️ Inadimplência acima dos pares * ⚠️ Execução do turnaround **Valuation típico**: P/L 6-8x, P/VP 0,8-1,2x *** ### Banco do Brasil (BBAS3) **O banco estatal que surpreende.** | Característica | Detalhes | | --------------- | ---------------------------- | | **Posição** | Maior banco do Brasil | | **Controlador** | Governo Federal (50%+) | | **ROE** | 18-22% | | **Eficiência** | \~28% (melhor entre grandes) | | **Agro** | Líder em crédito rural | **Pontos Fortes**: * ✅ ROE elevado e consistente * ✅ Dividend yield mais alto * ✅ Valuation muito descontado * ✅ Liderança em agronegócio * ✅ Eficiência operacional **Pontos de Atenção**: * ⚠️ Risco político/governança * ⚠️ Desconto por ser estatal * ⚠️ Possibilidade de interferência **Valuation típico**: P/L 4-6x, P/VP 0,8-1,0x *** ### Santander Brasil (SANB11) **O player espanhol no Brasil.** | Característica | Detalhes | | --------------- | ----------------------- | | **Posição** | 3º maior privado | | **Controlador** | Santander Espanha | | **ROE** | 12-16% | | **Eficiência** | \~40% | | **Estratégia** | Varejo e financiamentos | **Pontos Fortes**: * ✅ Gestão consistente * ✅ Boa eficiência * ✅ Dividendos regulares * ✅ Forte em financiamento de veículos **Pontos de Atenção**: * ⚠️ Crescimento limitado * ⚠️ Menos diferenciado * ⚠️ Remessa de dividendos para matriz **Valuation típico**: P/L 6-8x, P/VP 1,0-1,4x *** ### BTG Pactual (BPAC11) **O banco de investimentos que virou universal.** | Característica | Detalhes | | -------------- | ---------------------------- | | **Posição** | Maior banco de investimentos | | **ROE** | 18-22% | | **Estratégia** | Wealth + Varejo digital | | **Digital** | BTG Pactual Digital | **Pontos Fortes**: * ✅ Crescimento acelerado * ✅ Liderança em wealth * ✅ Alta rentabilidade * ✅ Gestão empreendedora **Pontos de Atenção**: * ⚠️ Valuation mais caro * ⚠️ Menor dividend yield * ⚠️ Exposição a mercado de capitais **Valuation típico**: P/L 10-12x, P/VP 2,0-2,5x *** ## Comparativo com brapi.dev Analise os principais bancos brasileiros em uma única requisição: ```typescript const bancos = 'ITUB4,BBDC4,BBAS3,SANB11,BPAC11,BRSR6,ABCB4' const response = await fetch( `https://brapi.dev/api/quote/${bancos}?modules=defaultKeyStatistics,financialData÷nds=true`, { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() ``` **Exemplo de Análise Comparativa (ordenado por ROE):** | Ticker | Preço | DY | P/L | P/VP | ROE | Avaliação | | ------ | -------- | ---- | ----- | ---- | ----- | ------------ | | ITUB4 | R$ 32,50 | 4,8% | 8,5x | 1,7 | 20,1% | 🟢 ROE alto | | BBAS3 | R$ 28,00 | 8,2% | 5,2x | 0,9 | 18,5% | 🟢 ROE alto | | BBDC4 | R$ 14,50 | 7,5% | 7,8x | 1,0 | 14,2% | 🟡 ROE médio | | SANB11 | R$ 27,00 | 6,1% | 6,5x | 1,1 | 13,8% | 🟡 ROE médio | | BPAC11 | R$ 32,00 | 1,2% | 12,0x | 1,8 | 15,0% | 🟡 ROE médio | **Onde encontrar os dados:** * DY: `defaultKeyStatistics.dividendYield` * P/L: `defaultKeyStatistics.trailingPE` * P/VP: `defaultKeyStatistics.priceToBook` * ROE: `financialData.returnOnEquity` > **Referência ROE:** 🟢 > 18% | 🟡 12-18% | 🔴 \< 12% *** ## Bancos vs Fintechs ### O Novo Cenário Competitivo **Fintechs que ameaçam os bancões:** * Nubank (NU) — Maior banco digital do mundo * Inter (INBR32) — Super app * C6 Bank — Crescimento acelerado * PicPay — Pagamentos + banco * Neon, Next, Original... **Impactos nos incumbentes:** * Pressão em tarifas * Perda de clientes jovens * Necessidade de investir em tech * Compressão de spreads * Mas... incumbentes ainda dominam crédito ### Resiliência dos Grandes Bancos **Por que os bancões ainda ganham:** * Custo de funding muito mais baixo * Experiência em análise de crédito * Base de clientes estabelecida * Cross-selling eficiente * Capital abundante * Regulação mais amigável *** ## Estratégias de Investimento ### Estratégia 1: Dividendos Foco em bancos com alto DY e consistência. **Carteira Dividendos Bancos:** | Peso | Ticker | Tese | | ---- | ------ | ---------------------- | | 40% | BBAS3 | Maior DY, desconto | | 30% | ITUB4 | Qualidade + dividendos | | 20% | SANB11 | Consistência | | 10% | BRSR6 | Regional, alto DY | > Meta: DY médio 7-9% ### Estratégia 2: Valor (Value) Foco em bancos descontados com potencial de recuperação. **Carteira Value Bancos:** | Peso | Ticker | Tese | | ---- | ------ | ---------------------- | | 40% | BBAS3 | P/VP \< 1x, ROE alto | | 35% | BBDC4 | Turnaround, descontado | | 25% | ABCB4 | Nicho, ignorado | > Meta: Capturar re-rating ### Estratégia 3: Qualidade + Crescimento Foco nos melhores gestores e crescimento. **Carteira Quality Bancos:** | Peso | Ticker | Tese | | ---- | ------ | ------------------ | | 50% | ITUB4 | Melhor ROE privado | | 30% | BPAC11 | Crescimento | | 20% | BBAS3 | ROE + dividendos | > Meta: Alpha de longo prazo ### Estratégia 4: Concentrada no Campeão Só investir no melhor. **Carteira Concentrada:** * 100% ITUB4 > Lógica: Se só pode ter um banco, escolha o de maior ROE e melhor gestão. *** ## Ciclos e Timing ### Bancos e Ciclo Econômico Inadimplência sobe
Lucros caem
Ações despencam
HORA DE COMPRAR] --> V[RECUPERAÇÃO
Provisões diminuem
Lucros se recuperam
Ações sobem
Manter posição] V --> E[EXPANSÃO
Crédito cresce
Spreads saudáveis
Lucros recordes
Cuidado com euforia] E --> P[PICO
Excessos de crédito
Valuations esticados
HORA DE REDUZIR] P --> R style R fill:#dc2626,color:#fff style V fill:#ea580c,color:#fff style E fill:#16a34a,color:#fff style P fill:#ca8a04,color:#fff `} /> ### Bancos e Selic | Movimento | Curto prazo | Médio prazo | Observação | | ----------------- | ----------------------- | -------------------------- | -------------------------- | | **Selic subindo** | Spreads podem comprimir | Repricing beneficia bancos | Tesouraria pode ter perdas | | **Selic caindo** | Margens podem cair | Crédito cresce | Inadimplência tende a cair | *** ## Riscos Setoriais ### 1. Risco de Crédito **Inadimplência pode disparar em:** * Recessão econômica * Desemprego alto * Juros muito altos * Bolha de crédito * Eventos específicos (segmentos) ### 2. Risco Regulatório **Banco Central pode:** * Aumentar exigências de capital * Limitar tarifas * Regular spreads * Mudar regras de provisão * Interferir em bancos estatais ### 3. Risco de Disrupção **Fintechs e BigTechs:** * Pix reduziu receita de transferências * Open Banking aumenta competição * Carteiras digitais avançam * BaaS (Banking as a Service) * IA mudando análise de crédito ### 4. Risco Político (Estatais) **BBAS3 tem risco adicional:** * Mudança de governo * Pressão por crédito subsidiado * Nomeações políticas * Programas "sociais" * Dividendos menores *** ## Screener de Bancos Para filtrar as melhores oportunidades no setor bancário, aplique critérios objetivos: ```typescript const bancos = 'ITUB4,BBDC4,BBAS3,SANB11,BPAC11,BRSR6,ABCB4,BPAN4,BMGB4' const response = await fetch( `https://brapi.dev/api/quote/${bancos}?modules=defaultKeyStatistics,financialData÷nds=true`, { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Filtre os resultados com os critérios abaixo ``` **Critérios de Filtragem Sugeridos:** | Critério | Valor Mínimo/Máximo | Justificativa | | -------- | ------------------- | -------------------------------- | | ROE | > 12% | Rentabilidade mínima aceitável | | P/L | \< 10x | Valuation atrativo | | DY | > 4% | Rendimento superior à renda fixa | **Sistema de Score (exemplo):** **Fórmula:** `Score = (ROE / 20) × 3 + (10 / P/L) × 2 + (DY / 10) × 1` **Exemplo de Resultados do Screener:** | Rank | Ticker | ROE | P/L | P/VP | DY | Score | | ---- | ------ | ----- | ---- | ---- | ---- | ----- | | 1 | BBAS3 | 18,5% | 5,2x | 0,9 | 8,2% | 6,8 ⭐ | | 2 | BBDC4 | 14,2% | 7,8x | 1,0 | 7,5% | 5,2 ⭐ | | 3 | SANB11 | 13,8% | 6,5x | 1,1 | 6,1% | 4,9 ⭐ | > **Top Pick:** O banco com maior score combina alta rentabilidade, valuation atrativo e bons dividendos. *** ## Monitorando Bancos ### Métricas Trimestrais a Acompanhar **A cada resultado trimestral, verifique:** * Lucro líquido vs estimativas * ROE (tendência) * Margem financeira (NII) * Inadimplência (NPL) * Índice de cobertura * Eficiência operacional * Crescimento da carteira * Guidance atualizado ### Dashboard de Acompanhamento Acompanhe os principais bancos e compare com a taxa Selic: ```typescript // Dados dos bancos const bancos = 'ITUB4,BBDC4,BBAS3,SANB11' const response = await fetch( `https://brapi.dev/api/quote/${bancos}?modules=defaultKeyStatistics÷nds=true`, { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Taxa Selic para comparativo via /api/v2/macro const selicResponse = await fetch( 'https://brapi.dev/api/v2/macro/latest?symbols=selic', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const { results } = await selicResponse.json() const selic = results[0].latest.value ``` **Exemplo de Dashboard Diário:** | Banco | Preço | Dia | DY | P/L | | ------ | -------- | --------- | ----- | ---- | | ITUB4 | R$ 32,50 | +1,25% 🟢 | 4,80% | 8,5x | | BBDC4 | R$ 14,50 | -0,85% 🔴 | 7,50% | 7,8x | | BBAS3 | R$ 28,00 | +0,50% 🟢 | 8,20% | 5,2x | | SANB11 | R$ 27,00 | +0,30% 🟢 | 6,10% | 6,5x | **Médias do Setor:** * Variação média do dia: +0,30% * DY médio: 6,65% * P/L médio: 7,0x **Comparativo com Selic:** * Selic atual: 12,25% * Prêmio do setor (DY + valorização esperada): \~10,65% > O DY dos bancos, somado à expectativa de valorização, oferece prêmio sobre a renda fixa quando os fundamentos são sólidos. *** ## Valuation de Bancos ### Múltiplos Tradicionais | Múltiplo | Fórmula | Uso | | ------------- | ----------------- | --------------------------- | | **P/L** | Preço / LPA | Comparação direta | | **P/VP** | Preço / VPA | Valuation fundamental | | **P/L / ROE** | (P/L) / ROE | Normaliza por rentabilidade | | **DY** | Dividendo / Preço | Renda | ### Modelo de Gordon Simplificado **Fórmula:** `Preço Justo = DPA × (1 + g) / (k - g)` Onde: * DPA = Dividendo por ação * g = Crescimento esperado * k = Custo de capital (retorno exigido) **Exemplo BBAS3:** | Variável | Valor | | --------------- | -------------------------------------- | | DPA | R$ 4,00 | | g | 5% ao ano | | k | 14% (Selic + prêmio) | | Cálculo | 4 × 1,05 / (0,14 − 0,05) = 4,20 / 0,09 | | **Preço Justo** | **R$ 46,67** | ### P/VP x ROE **Regra geral para bancos:** | ROE | P/VP correspondente | | ------ | ------------------- | | > 15% | Merece P/VP > 1x | | = 15% | P/VP justo = 1x | | \< 15% | P/VP \< 1x | **Exemplos:** | Banco | ROE | P/VP esperado | | ----- | --- | ----------------------------- | | ITUB4 | 21% | \~1,5-2,0x | | BBAS3 | 20% | \~1,3-1,7x (desconto estatal) | | BBDC4 | 12% | \~0,8-1,0x faz sentido | *** ## Checklist: Investindo em Bancos **ANÁLISE INICIAL** * [ ] Entendo o modelo de negócio bancário? * [ ] Sei diferenciar varejo, atacado, investimentos? * [ ] Conheço os principais indicadores? **ANÁLISE DA EMPRESA** * [ ] Verifiquei ROE histórico (5 anos)? * [ ] Analisei tendência de inadimplência? * [ ] Verifiquei índice de eficiência? * [ ] Estudei o índice de cobertura? * [ ] Analisei Basileia? * [ ] Li o último ITR/DFP? **VALUATION** * [ ] Comparei P/L com pares? * [ ] Analisei P/VP vs ROE? * [ ] Verifiquei DY histórico? * [ ] Considerei ciclo econômico? **RISCOS ESPECÍFICOS** * [ ] Entendo riscos de bancos estatais? * [ ] Avaliei exposição a ciclo econômico? * [ ] Considerei impacto de fintechs? **GESTÃO DE CARTEIRA** * [ ] Não concentrei demais em bancos? * [ ] Diversifiquei entre tipos de bancos? * [ ] Defini horizonte de investimento? *** ## Erros Comuns ### ❌ Erro 1: Só Olhar P/L > BBAS3 tem P/L 4x, ITUB4 tem P/L 9x — "BBAS3 é mais barato!" Mas... BBAS3 tem desconto por ser estatal. Se ajustar pelo risco, pode não ser tão barato. ### ❌ Erro 2: Ignorar Ciclo **Comprar banco no topo do ciclo:** * Inadimplência baixíssima * Lucros recordes * Valuation esticado * Recessão vem depois = queda de 40-50% ### ❌ Erro 3: Não Entender ROE Banco com ROE de 8% consistente **vs** Banco com ROE de 20% consistente: o segundo vale 2-3x mais em P/VP! ### ❌ Erro 4: Concentrar Demais > "Bancos são seguros, vou colocar 50% neles" **Problema:** Setor inteiro pode cair junto em crise. *** ## Próximos Passos 1. **Escolha sua estratégia**: dividendos, valor ou qualidade 2. **Use o screener** para filtrar bancos 3. **Compare os indicadores** usando brapi.dev 4. **Leia os últimos resultados** das empresas escolhidas 5. **Monte posição gradual** 6. **Monitore trimestralmente** ### Leitura Complementar * [Melhores Ações de Dividendos](/blog/melhores-acoes-pagadoras-dividendos-2026) * [Como Analisar Ações](/blog/como-analisar-acoes-guia-iniciantes-2026) * [Ações do Setor Elétrico](/blog/melhores-acoes-setor-eletrico-2026-dividendos-taee11-trpl4) * [Renda Fixa vs Renda Variável](/blog/renda-fixa-vs-renda-variavel-2026) *** ## Conclusão O setor bancário brasileiro oferece oportunidades únicas: 1. **Itaú (ITUB4)**: Para quem quer o melhor banco, com maior ROE 2. **Banco do Brasil (BBAS3)**: Para dividendos e valuation descontado 3. **Bradesco (BBDC4)**: Para apostas em recuperação 4. **BTG (BPAC11)**: Para exposição a crescimento A chave é entender que **ROE é o indicador mais importante** para bancos. Um banco com ROE alto e consistente merece valuation premium. Use a [brapi.dev](https://brapi.dev) para monitorar seus investimentos no setor bancário e tomar decisões baseadas em dados atualizados. *** *Última atualização: Janeiro de 2026* # Ações Baratas Abaixo de R$ 5: Vale a Pena Investir? Guia Completo 2026 URL: /blog/acoes-baratas-abaixo-5-reais.mdx Análise de ações baratas na bolsa brasileira. Descubra se ações abaixo de R$ 5 são oportunidades ou armadilhas. Riscos, como analisar e exemplos práticos ✓ *** searchable: true title: 'Ações Baratas Abaixo de R$ 5: Vale a Pena Investir? Guia Completo 2026' description: 'Análise de ações baratas na bolsa brasileira. Descubra se ações abaixo de R$ 5 são oportunidades ou armadilhas. Riscos, como analisar e exemplos práticos ✓' date: '2026-01-01' keywords: 'acoes baratas 2026, acoes abaixo 5 reais, penny stocks brasil, acoes centavos bolsa brasileira, mico bolsa, small caps baratas, vale a pena acoes baratas' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Ações' readingTime: '18 min' tags: \['Ações Baratas', 'Penny Stocks', 'Small Caps', 'Riscos', 'Bolsa Brasileira'] relatedPosts: \[ 'small-caps-brasil-como-investir-empresas-menores', 'margem-de-seguranca-benjamin-graham', 'value-investing-como-encontrar-acoes-baratas', 'como-analisar-acoes-guia-iniciantes-2026', ] featured: false expertise: 'Equipe de analistas especializados em mercado de ações brasileiro' lastReviewed: 2026-01-03 ------------------------ ## Introdução Ações negociadas abaixo de R$ 5 exercem um fascínio especial sobre investidores iniciantes. A ideia de comprar "muitas ações com pouco dinheiro" e ver multiplicações de 10x ou 20x é tentadora. Mas será que **preço baixo significa oportunidade**? Neste guia completo, vamos analisar: * O que são "penny stocks" no Brasil * Por que uma ação tem preço baixo * Riscos e armadilhas * Como identificar oportunidades reais * Casos de sucesso e fracasso * Estratégia de análise com brapi.dev {/* Separator */} *** ## O que são Ações Baratas (Penny Stocks)? ### Definição No Brasil, ações abaixo de R$ 5 são frequentemente chamadas de "micos" ou "penny stocks", embora o termo original se refira a ações abaixo de $1 no mercado americano. ``` ┌─────────────────────────────────────────────────────────────┐ │ CLASSIFICAÇÃO POR PREÇO │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Ultra-baratas (< R$ 1) │ │ ├─ Empresas em recuperação judicial │ │ ├─ Risco extremamente alto │ │ └─ Liquidez muito baixa │ │ │ │ Baratas (R$ 1 - R$ 5) │ │ ├─ Podem ser oportunidades OU armadilhas │ │ ├─ Análise fundamentalista é essencial │ │ └─ Muitas são empresas problemáticas │ │ │ │ Acessíveis (R$ 5 - R$ 20) │ │ ├─ Podem incluir small caps de qualidade │ │ └─ Menor correlação preço-qualidade │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### O Mito do Preço Baixo > ⚠️ **Atenção**: Uma ação de R$ 2 NÃO é mais barata que uma de R$ 50. > O preço da ação depende de quantas ações existem, não do valor da empresa. **Exemplo: Comparando duas empresas pelo preço da ação** | Característica | Empresa A (R$ 2) | Empresa B (R$ 50) | | ---------------- | ---------------- | ----------------- | | Preço da ação | R$ 2,00 | R$ 50,00 | | Ações totais | 5 bilhões | 100 milhões | | Valor de mercado | R$ 10 bilhões | R$ 5 bilhões | | Lucro anual | R$ 500 milhões | R$ 1 bilhão | | **P/L** | **20x** | **5x** | **Conclusão**: A Empresa B com ação de R$ 50 é mais barata (P/L 5x) que a Empresa A com ação de R$ 2 (P/L 20x). *** ## Por que uma Ação tem Preço Baixo? ### Motivos Legítimos | Motivo | Exemplo | Oportunidade? | | --------------------------- | ----------------------------- | ------------- | | Muitas ações emitidas | Empresa grande, diluída | Neutro | | IPO recente com preço baixo | Estratégia comercial | Avaliar caso | | Recuperação de crise | Empresa se reestruturando | Possível | | Setor em baixa | Commodities em ciclo negativo | Possível | ### Motivos Problemáticos (Red Flags) | Motivo | Exemplo | Risco | | --------------------- | ------------------------ | ---------- | | Prejuízos recorrentes | Empresa queima caixa | Alto | | Recuperação judicial | Risco de falência | Muito alto | | Governança ruim | Fraudes, insider trading | Extremo | | Setor obsoleto | Tecnologia superada | Alto | | Dívida impagável | Alavancagem excessiva | Muito alto | *** ## Os Riscos das Penny Stocks ### 1. Baixa Liquidez ``` ┌─────────────────────────────────────────────────────────────┐ │ PROBLEMA DE LIQUIDEZ │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Volume diário: R$ 50.000 │ │ Você quer comprar: R$ 10.000 │ │ │ │ PROBLEMAS: │ │ ├─ Spread alto: Compra a R$ 2,10, vende a R$ 1,90 │ │ ├─ Impacto no preço: Sua compra sobe a cotação │ │ └─ Difícil sair: Pode levar dias para vender │ │ │ │ RESULTADO: Você pode perder 10-20% só no spread │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### 2. Manipulação de Preço ``` Esquema clássico "Pump and Dump": 1. Grupo compra ação de R$ 0,50 (baixa liquidez) 2. Espalham rumores de "oportunidade imperdível" 3. Iniciantes compram → preço sobe para R$ 1,50 4. Grupo vende tudo → preço despenca para R$ 0,30 5. Iniciantes ficam com prejuízo de 80% ⚠️ NUNCA compre baseado em "dicas quentes" de grupos de WhatsApp/Telegram ``` ### 3. Falta de Cobertura e Informação | Ação | Analistas Cobrindo | Relatórios/Ano | | ------------------- | ------------------ | -------------- | | PETR4 | 25+ | 50+ | | VALE3 | 25+ | 50+ | | Small Cap Conhecida | 5-10 | 10-20 | | Penny Stock | 0-2 | 0-5 | ### 4. Volatilidade Extrema **Comparação de Volatilidade:** | Tipo de Ação | Variação Diária Média | Max Drawdown Anual | | ------------ | --------------------- | ------------------ | | Blue Chip | 1-2% | 20-30% | | Penny Stock | 5-15% | 50-90% | > Você aguenta ver R$ 10.000 virar R$ 1.000 em meses? *** ## Como Identificar Oportunidades Reais ### Checklist de Análise ``` ┌─────────────────────────────────────────────────────────────┐ │ CHECKLIST - AÇÕES BARATAS │ ├─────────────────────────────────────────────────────────────┤ │ │ │ ELIMINATÓRIOS (Se falhar, evite) │ │ ☐ Empresa tem lucro? (últimos 3 anos) │ │ ☐ Dívida controlada? (Dívida/EBITDA < 3) │ │ ☐ Liquidez mínima? (Volume > R$ 500k/dia) │ │ ☐ Governança ok? (Sem fraudes, RI funcionando) │ │ │ │ QUALIDADE (Quanto mais, melhor) │ │ ☐ ROE > 10%? │ │ ☐ Margem líquida positiva? │ │ ☐ Receita crescente (5 anos)? │ │ ☐ Paga dividendos? │ │ ☐ Setor com perspectiva? │ │ │ │ VALUATION (Está realmente barata?) │ │ ☐ P/L abaixo da média setorial? │ │ ☐ P/VP abaixo de 1? │ │ ☐ EV/EBITDA atrativo? │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Screener com brapi.dev Para encontrar ações abaixo de R$ 5 com fundamentos sólidos, você pode usar a API brapi.dev: ```typescript // Buscar lista de ações e filtrar por preço e fundamentos const response = await fetch( "https://brapi.dev/api/quote/list?limit=100", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { stocks } = await response.json(); // Filtrar ações abaixo de R$ 5 const baratas = stocks.filter( (s) => s.close < 5.0 && s.close > 0.5 ); // Para cada ação, buscar dados fundamentalistas for (const acao of baratas.slice(0, 10)) { const details = await fetch( `https://brapi.dev/api/quote/${acao.stock}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await details.json(); // Analisar P/L, ROE, margem líquida, etc. } ``` **Critérios de qualidade para filtrar:** | Critério | Mínimo Recomendado | Objetivo | | -------------- | ------------------ | ------------------------ | | P/L | > 0 e \< 15 | Lucro consistente | | ROE | > 8% | Retorno sobre patrimônio | | Dívida/PL | \< 2x | Alavancagem controlada | | Volume diário | > 500k | Liquidez mínima | | Margem líquida | > 5% | Rentabilidade | ### Output Esperado ``` 🔍 AÇÕES ABAIXO DE R$ 5 COM FUNDAMENTOS SÓLIDOS ----------------------------------------------------------------- Ticker Preço P/L ROE Volume ----------------------------------------------------------------- XXXX3 R$ 3.50 8.5 15.2% 2,350,000 YYYY4 R$ 4.20 6.2 12.8% 1,890,000 ZZZZ3 R$ 2.80 10.1 11.5% 980,000 ... ``` *** ## Casos Reais: Sucessos e Fracassos ### Casos de Sucesso (Raros) #### Magazine Luiza (MGLU3) - 2016-2020 ``` 2016: ~R$ 0,50 (ajustado por splits) 2020: ~R$ 25,00 Valorização: ~5.000% POR QUE FUNCIONOU: ✓ Turnaround digital bem executado ✓ Gestão competente ✓ Mercado de e-commerce em expansão ✓ Lucro crescente ano após ano ``` #### Via (VIIA3) - 2019-2020 ``` 2019: ~R$ 3,00 2020: ~R$ 18,00 Valorização: ~500% POR QUE FUNCIONOU (temporariamente): ✓ Pandemia beneficiou e-commerce ✓ Expectativa de turnaround ✗ Depois: Voltou a cair 90%+ ``` ### Casos de Fracasso (Comuns) #### OGX (OGXP3) - 2008-2013 ``` 2010: ~R$ 23,00 2013: ~R$ 0,05 Queda: -99,8% POR QUE FALHOU: ✗ Promessas irreais de petróleo ✗ Gestão questionável ✗ Recuperação judicial ✗ Investidores perderam tudo ``` #### Empresas em Recuperação Judicial ``` Padrão comum: 1. Ação cai 80-90% 2. Investidores iniciantes veem "oportunidade" 3. Empresa não se recupera 4. Ação vai a R$ 0,01 ou deslistagem 5. Perda total ``` *** ## Estratégia para Investir em Ações Baratas ### Regra 1: Limite a Exposição **Alocação Máxima Recomendada por Perfil:** | Perfil | % Máximo em Penny Stocks | Exemplo (Patrimônio R$ 100k) | Max por Ação | | ----------- | ------------------------ | ---------------------------- | ------------ | | Conservador | 0% | R$ 0 | R$ 0 | | Moderado | 2% | R$ 2.000 | R$ 400 | | Arrojado | 5% | R$ 5.000 | R$ 1.000 | | Agressivo | 10% | R$ 10.000 | R$ 2.000 | > **Regra**: Nunca mais que R$ 5.000 em uma única ação barata. Se o limite total for maior, divida em pelo menos 5 ações diferentes. ### Regra 2: Diversifique Dentro da Categoria ``` NÃO: R$ 5.000 em uma única ação barata SIM: R$ 1.000 em 5 ações baratas diferentes (Se 3 falharem e 2 derem 5x, você ganha) ``` ### Regra 3: Defina Critérios de Saída **Critérios de Saída para Penny Stocks:** | Situação | Retorno | Ação | Motivo | | ------------- | ------------------------ | ------------- | --------------------------------- | | Stop Loss | \< -30% | VENDER | Limitar perdas | | Lucro Parcial | > +100% | Vender metade | Realizar lucro e manter exposição | | Objetivo | > +300% | Vender tudo | Meta atingida | | Tempo | > 2 anos, retorno \< 20% | Reavaliar | Tempo longo sem resultado | > **Importante**: Defina esses critérios ANTES de comprar e siga-os rigorosamente. ### Regra 4: Nunca Use Dinheiro que Você Precisa ``` ⚠️ REGRA DE OURO: Só invista em ações baratas/arriscadas com dinheiro que você pode PERDER 100% sem impactar sua vida. Se perder esse dinheiro vai te atrapalhar, você não deveria estar investindo em penny stocks. ``` *** ## Alternativas às Penny Stocks ### ETFs de Small Caps **ETFs de Small Caps disponíveis na bolsa brasileira:** | ETF | Descrição | | ------ | -------------------- | | SMLL11 | Índice de Small Caps | | SMAL11 | ETF de Small Caps | **Vantagens dos ETFs vs Penny Stocks:** * Diversificação automática * Gestão profissional * Menor risco individual * Liquidez adequada ### Ações de Qualidade em Queda Uma alternativa melhor que penny stocks é buscar blue chips que caíram significativamente: ```typescript // Buscar blue chips e identificar quedas significativas const blueChips = ["ITUB4", "BBDC4", "VALE3", "PETR4", "WEGE3", "ABEV3", "RENT3", "EGIE3"]; const response = await fetch( `https://brapi.dev/api/quote/${blueChips.join(",")}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // Identificar ações que caíram mais de 20% da máxima const oportunidades = results .filter((acao) => { const queda = ((acao.fiftyTwoWeekHigh - acao.regularMarketPrice) / acao.fiftyTwoWeekHigh) * 100; return queda > 20; }) .sort((a, b) => { const quedaA = (a.fiftyTwoWeekHigh - a.regularMarketPrice) / a.fiftyTwoWeekHigh; const quedaB = (b.fiftyTwoWeekHigh - b.regularMarketPrice) / b.fiftyTwoWeekHigh; return quedaB - quedaA; }); ``` > **Dica**: Blue chips em queda são geralmente melhores oportunidades que penny stocks. Empresas consolidadas têm mais chances de recuperação. *** ## Resumo: Vale a Pena? ### Matriz de Decisão ``` ┌─────────────────────────────────────────────────────────────┐ │ VALE A PENA INVESTIR EM PENNY STOCKS? │ ├─────────────────────────────────────────────────────────────┤ │ │ │ PROVAVELMENTE NÃO, se você: │ │ ├─ É iniciante │ │ ├─ Não tem tempo para analisar │ │ ├─ Precisa do dinheiro │ │ ├─ Não aguenta ver -50% │ │ └─ Está buscando "ficar rico rápido" │ │ │ │ TALVEZ SIM, se você: │ │ ├─ Tem experiência em análise │ │ ├─ Limita a 2-5% do patrimônio │ │ ├─ Faz due diligence rigorosa │ │ ├─ Diversifica em 5+ posições │ │ ├─ Define stops claros │ │ └─ Aceita perder 100% │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Estatísticas (Aproximadas) | Cenário | Probabilidade | | ------------------------ | ------------- | | Perda de 50%+ | \~50% | | Perda de 100% (falência) | \~20% | | Retorno modesto (0-50%) | \~15% | | Retorno alto (50-200%) | \~10% | | Multiplicação (>3x) | \~5% | ### Conclusão 1. **Preço baixo ≠ Ação barata** - Use P/L, P/VP, valuation real 2. **A maioria das penny stocks são armadilhas** - Estatísticas são contra você 3. **Se for investir, limite exposição** - Máximo 5% do patrimônio 4. **Prefira qualidade em queda** - Blue chips descontadas são melhores 5. **Faça análise rigorosa** - Nunca compre por "dica quente" *** **Quer analisar ações com dados confiáveis?** [Crie sua conta grátis](/signup) na brapi.dev e filtre ações por indicadores fundamentalistas, não apenas por preço! # Ações Growth vs Value: Qual Estratégia Escolher em 2026? URL: /blog/acoes-growth-vs-value-brasil.mdx Entenda as diferenças entre ações de crescimento e valor ✓ Características, exemplos na bolsa brasileira, quando usar cada estratégia e como montar carteira balanceada *** searchable: true title: 'Ações Growth vs Value: Qual Estratégia Escolher em 2026?' description: 'Entenda as diferenças entre ações de crescimento e valor ✓ Características, exemplos na bolsa brasileira, quando usar cada estratégia e como montar carteira balanceada' date: '2026-01-01' keywords: 'growth investing 2026, value investing, ações crescimento, ações valor, growth vs value, estratégia investimento, WEGE3, VALE3, estilo investimento' author: 'Equipe brapi.dev' category: 'Estratégias de Investimento' subcategory: 'Estilos de Investimento' readingTime: '20 min' tags: \['Growth Investing', 'Value Investing', 'Estratégias', 'Ações', 'Carteira'] relatedPosts: \['value-investing-como-encontrar-acoes-baratas', 'buy-and-hold-estrategia-investimento-longo-prazo', 'dividendos-como-construir-renda-passiva', 'dollar-cost-averaging-estrategia-aporte-mensal', 'indicador-peg-ratio-como-usar'] featured: true expertise: 'Especialistas em estratégias de investimento e alocação de carteira' lastReviewed: 2026-01-03 ------------------------ ## Growth vs Value: O Debate Eterno A divisão entre **Growth (Crescimento)** e **Value (Valor)** é uma das mais fundamentais no mundo dos investimentos. Cada estilo tem seus defensores fervorosos, mas a verdade é que ambos podem funcionar dependendo do contexto, perfil e horizonte do investidor. Neste guia, vamos explorar as características de cada estilo, identificar exemplos na bolsa brasileira, e ajudá-lo a decidir qual abordagem faz mais sentido para você. ### Definições Básicas | Aspecto | Growth (Crescimento) | Value (Valor) | | ------------------ | -------------------- | ------------------------------- | | **Foco** | Potencial futuro | Preço atual vs valor intrínseco | | **Múltiplos** | P/L e P/VP altos | P/L e P/VP baixos | | **Dividendos** | Baixos ou zero | Geralmente altos | | **Reinvestimento** | Lucros reinvestidos | Lucros distribuídos | | **Volatilidade** | Alta | Menor | | **Horizonte** | Longo prazo | Médio a longo prazo | ## Ações Growth: Apostando no Futuro Ações de crescimento são empresas que reinvestem seus lucros para expandir rapidamente. O mercado paga um prêmio por essas empresas na expectativa de lucros muito maiores no futuro. ### Características das Ações Growth **Perfil da Ação Growth:** | Dimensão | Características | | ----------------------------- | ------------------------------------------------------------------------------- | | 📈 **Crescimento acelerado** | Receita > 15% a.a., lucros expandindo rapidamente, market share em expansão | | 💰 **Reinvestimento intenso** | Pouco ou nenhum dividendo, CapEx elevado, aquisições estratégicas | | 📊 **Múltiplos elevados** | P/L > 20x (frequentemente > 30x), P/VP > 3x, EV/EBITDA > 12x | | 🎯 **Expectativas altas** | Mercado precifica crescimento futuro, sensível a revisões, volatilidade elevada | ### Exemplos de Growth na Bolsa Brasileira **Critérios Growth:** P/L > 15x, Dividend Yield \< 3%, Crescimento positivo | Ticker | Preço | P/L | P/VP | DY | ROE | Score | | ------ | -------- | ----- | ----- | ----- | ----- | ----- | | WEGE3 | R$ 52,80 | 35,2x | 11,5x | 1,20% | 28,5% | 7 | | TOTS3 | R$ 28,45 | 22,8x | 4,2x | 0,85% | 18,3% | 6 | | RENT3 | R$ 45,30 | 18,5x | 3,8x | 2,10% | 22,1% | 6 | | PRIO3 | R$ 42,15 | 8,2x | 2,9x | 0,00% | 35,2% | 5 | | ARZZ3 | R$ 58,90 | 20,4x | 3,5x | 1,50% | 16,8% | 5 | **Como calcular o Score Growth:** * Crescimento > 20% → +3 pontos * Crescimento 10-20% → +2 pontos * DY \< 2% → +2 pontos * ROE > 20% → +2 pontos ### WEG (WEGE3): O Case Clássico de Growth A WEG é o exemplo mais emblemático de growth stock brasileira: ```typescript const response = await fetch("https://brapi.dev/api/quote/WEGE3?modules=defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }, }); const { results } = await response.json(); const weg = results[0]; ``` **CASE STUDY: WEG (WEGE3) - Growth Stock Brasileira** | Categoria | Métrica | Valor | | --------------------------------- | -------------- | -------------- | | **Dados Atuais** | Preço | R$ 52,80 | | | Market Cap | R$ 221 bilhões | | **Múltiplos (típicos de Growth)** | P/L | 35,2x | | | P/VP | 11,5x | | | EV/EBITDA | 25,8x | | **Dividendos (baixos)** | Dividend Yield | 1,20% | | **Rentabilidade (alta)** | ROE | 28,5% | | | Margem Líquida | 15,8% | **Por que WEG é Growth:** * Reinveste grande parte dos lucros em P\&D e expansão * Crescimento consistente de receita e lucro por décadas * Expansão internacional (>50% receita exterior) * Múltiplos premium justificados pelo track record * Setor beneficiado por transição energética * Baixo payout de dividendos (\~30%) ## Ações Value: Comprando Barganhas Ações de valor são empresas negociadas abaixo do seu valor intrínseco. O investidor value busca a "margem de segurança" entre o preço de mercado e o valor real da empresa. ### Características das Ações Value **Perfil da Ação Value:** | Dimensão | Características | | ----------------------------------- | ---------------------------------------------------------------------------- | | 📉 **Múltiplos baixos** | P/L \< 10x, P/VP \< 1,5x, EV/EBITDA \< 8x | | 💵 **Dividendos atrativos** | Dividend Yield > 5%, payout elevado, histórico consistente | | 🏢 **Negócio maduro** | Crescimento estável/moderado, posição consolidada, fluxo de caixa previsível | | ⚠️ **Pode estar barata por motivo** | Setor em declínio, problemas temporários, ignorada pelo mercado | ### Exemplos de Value na Bolsa Brasileira **Critérios Value:** P/L \< 12x, Dividend Yield > 4% | Ticker | Preço | P/L | P/VP | DY | ROE | Score | | ------ | -------- | ---- | ---- | ------ | ----- | ----- | | VALE3 | R$ 58,20 | 5,8x | 1,2x | 9,50% | 22,8% | 8 | | BBAS3 | R$ 28,45 | 4,5x | 0,8x | 10,20% | 18,5% | 9 | | PETR4 | R$ 38,90 | 4,2x | 1,4x | 12,80% | 35,2% | 8 | | CPLE6 | R$ 10,25 | 7,8x | 1,1x | 7,50% | 14,2% | 6 | | TAEE11 | R$ 35,60 | 8,5x | 1,8x | 8,90% | 21,5% | 6 | **Como calcular o Score Value:** * P/L \< 6x → +3 pontos * P/L 6-10x → +2 pontos * P/VP \< 1x → +3 pontos * DY > 8% → +3 pontos * DY 6-8% → +2 pontos ### Vale (VALE3): O Case Clássico de Value A Vale frequentemente aparece como value stock devido aos múltiplos baixos e dividendos altos: ```typescript const response = await fetch("https://brapi.dev/api/quote/VALE3?modules=defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }, }); const { results } = await response.json(); const vale = results[0]; ``` **CASE STUDY: VALE (VALE3) - Value Stock Brasileira** | Categoria | Métrica | Valor | | -------------------------------- | -------------- | -------------- | | **Dados Atuais** | Preço | R$ 58,20 | | | Market Cap | R$ 245 bilhões | | **Múltiplos (típicos de Value)** | P/L | 5,8x | | | P/VP | 1,2x | | | EV/EBITDA | 4,5x | | **Dividendos (altos)** | Dividend Yield | 9,50% | | **Rentabilidade** | ROE | 22,8% | | | Margem EBITDA | 48,5% | **Por que VALE é Value:** * Múltiplos baixos (P/L frequentemente \< 8x) * Dividend Yield elevado (>8% em muitos anos) * Negócio maduro e consolidado * Geração de caixa robusta * Líder global em minério de ferro **Riscos que justificam desconto:** * Commodity cíclica (preço do minério) * Dependência da China * Riscos ESG (Brumadinho, Mariana) * Volatilidade cambial ## Comparativo Direto: Growth vs Value Vamos comparar diretamente empresas growth e value: **Ações Growth:** | Ticker | P/L | P/VP | DY | ROE | Margem | | ------ | ----- | ----- | ----- | ----- | ------ | | WEGE3 | 35,2x | 11,5x | 1,20% | 28,5% | 15,8% | | TOTS3 | 22,8x | 4,2x | 0,85% | 18,3% | 12,5% | | RENT3 | 18,5x | 3,8x | 2,10% | 22,1% | 8,2% | **Ações Value:** | Ticker | P/L | P/VP | DY | ROE | Margem | | ------ | ---- | ---- | ------ | ----- | ------ | | VALE3 | 5,8x | 1,2x | 9,50% | 22,8% | 32,5% | | BBAS3 | 4,5x | 0,8x | 10,20% | 18,5% | 25,8% | | PETR4 | 4,2x | 1,4x | 12,80% | 35,2% | 28,3% | **Médias por Estilo:** | Estilo | P/L Médio | DY Médio | | ---------- | --------- | -------- | | **Growth** | 25,5x | 1,38% | | **Value** | 4,8x | 10,83% | > **Observação:** Growth = múltiplos altos, dividendos baixos. Value = múltiplos baixos, dividendos altos. ## Quando Escolher Growth Growth investing funciona melhor em determinados cenários: ### Cenários Favoráveis para Growth | Fator | Por Quê Favorece Growth | | ------------------------ | ---------------------------------------- | | **Juros baixos** | Múltiplos expandem, custo de capital cai | | **Economia acelerando** | Empresas capturam crescimento | | **Inovação tecnológica** | Disruptores ganham mercado | | **Inflação baixa** | Lucros futuros valem mais | | **Mercado otimista** | Investidores pagam por potencial | ### Perfil do Investidor Growth **Você é um investidor Growth se...** * ✅ Horizonte de longo prazo (>10 anos) * ✅ Tolera volatilidade alta * ✅ Não precisa de renda passiva imediata * ✅ Acredita em inovação e disrupção * ✅ Aceita múltiplos altos por qualidade * ✅ Foco em valorização de capital **Growth NÃO é para você se:** * ❌ Precisa de dividendos para viver * ❌ Não aguenta ver -30% no portfólio * ❌ Quer retornos imediatos ## Quando Escolher Value Value investing tem seus momentos de brilho: ### Cenários Favoráveis para Value | Fator | Por Quê Favorece Value | | ---------------------- | ------------------------------- | | **Juros altos** | Múltiplos comprimem, DY compete | | **Recessão/crise** | Flight to quality | | **Inflação alta** | Ativos reais valorizam | | **Mercado pessimista** | Barganhas aparecem | | **Rotação setorial** | De growth para value | ### Perfil do Investidor Value **Você é um investidor Value se...** * ✅ Gosta de comprar "barato" * ✅ Valoriza dividendos e renda passiva * ✅ Prefere negócios estabelecidos * ✅ Tem paciência para esperar o mercado reconhecer valor * ✅ Aceita que algumas apostas podem demorar anos * ✅ Consegue ir contra o consenso **Value NÃO é para você se:** * ❌ Quer surfar tendências de alta * ❌ Não aceita investir em empresas "fora de moda" * ❌ Espera valorização rápida ## A Armadilha do Value Trap Nem toda ação barata é uma boa oportunidade. O "value trap" acontece quando uma ação parece barata mas tem problemas estruturais: ```typescript const response = await fetch("https://brapi.dev/api/quote/MGLU3?modules=defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }, }); const { results } = await response.json(); // Analisar indicadores para detectar value traps ``` **Checklist de Value Trap:** | Indicador | Valor Crítico | Risco | | ------------------- | ------------- | --------------------------- | | ROE | \< 5% | Baixa rentabilidade | | Margem Líquida | \< 3% | Competição destruindo valor | | Crescimento Receita | \< -5% | Perdendo relevância | | Dívida/Equity | > 200% | Endividamento elevado | **Exemplo de Análise (MGLU3):** | Métrica | Valor | Status | | ------------------- | ------------ | -------- | | P/L | 15x (era 5x) | - | | ROE | 2,5% | Red flag | | Margem | 1,2% | Red flag | | Crescimento Receita | -8,5% | Red flag | > **Alerta:** Se P/L \< 8x mas 2+ red flags = possível Value Trap. Investigar mais antes de investir! ### Sinais de Value Trap | Sinal | Por Quê é Problema | | ----------------------- | ------------------------------------ | | **Setor em declínio** | Empresa barata por motivo estrutural | | **Margem em queda** | Competição destruindo valor | | **Dívida crescente** | Usando dívida para manter dividendos | | **Receita caindo** | Perdendo relevância | | **Management vendendo** | Insiders sabem algo | | **Governança fraca** | Risco de fraude/má gestão | ## O Melhor dos Dois Mundos: GARP **GARP (Growth at a Reasonable Price)** combina elementos de ambos os estilos: **Critérios GARP:** P/L \< 25x | ROE > 12% | Crescimento > 5% | PEG \< 2.0 | Ticker | P/L | PEG | ROE | Crescimento | Score | | ------ | ----- | ---- | ----- | ----------- | ----- | | PRIO3 | 8,2x | 0,45 | 35,2% | 18,2% | 5,08 | | ITUB4 | 9,5x | 0,95 | 21,5% | 10,0% | 2,49 | | RENT3 | 18,5x | 1,54 | 22,1% | 12,0% | 1,34 | | FLRY3 | 15,2x | 1,69 | 15,8% | 9,0% | 1,13 | | RADL3 | 22,4x | 1,87 | 18,2% | 12,0% | 0,91 | **Fórmula PEG:** ``` PEG = P/L ÷ Crescimento de Lucros (%) ``` * **PEG \< 1:** Ação potencialmente subvalorizada * **PEG 1-2:** Valuation justo * **PEG > 2:** Ação cara para o crescimento > **GARP** combina o melhor dos dois mundos: crescimento com valuation razoável. ## Montando uma Carteira Balanceada A melhor estratégia para muitos investidores é combinar growth e value: **Alocação por Perfil (capital R$ 100.000):** | Perfil | Growth | Value | Renda Fixa | Descrição | | --------------- | --------------- | --------------- | --------------- | ----------------------------------------- | | **Conservador** | R$ 20.000 (20%) | R$ 50.000 (50%) | R$ 30.000 (30%) | Foco em preservação com algum crescimento | | **Moderado** | R$ 40.000 (40%) | R$ 40.000 (40%) | R$ 20.000 (20%) | Equilíbrio entre crescimento e renda | | **Arrojado** | R$ 60.000 (60%) | R$ 30.000 (30%) | R$ 10.000 (10%) | Foco em valorização de capital | | **Agressivo** | R$ 80.000 (80%) | R$ 15.000 (15%) | R$ 5.000 (5%) | Máxima exposição a crescimento | **Sugestões de Ações:** | Estilo | Sugestões | | ---------- | -------------------- | | **Growth** | WEGE3, TOTS3, RENT3 | | **Value** | VALE3, BBAS3, TAEE11 | > **Dica:** Rebalanceie anualmente para manter a alocação desejada. ## Ciclos de Mercado: Quando Cada Estilo Brilha |GROWTH
otimismo, múltiplos sobem| ET[Expansão tardia] ET -->|GARP
seletividade aumenta| PE[Pico / Euforia] PE -->|VALUE
rotação começa| R[Recessão] R -->|VALUE
defensivo, dividendos| RC[Recuperação] RC -->|GROWTH
retomada do risco| EI style EI fill:#16a34a,color:#fff style ET fill:#2563eb,color:#fff style PE fill:#ca8a04,color:#fff style R fill:#dc2626,color:#fff style RC fill:#ea580c,color:#fff `} /> **Fases históricas recentes:** | Período | Estilo dominante | Contexto | | --------- | ---------------- | ----------------------- | | 2020-2021 | Growth dominou | Juros zero, tech boom | | 2022-2024 | Value retornou | Juros altos, rotação | | 2025-2026 | Value favorecido | Ambiente de juros altos | ## Conclusão: Não é Uma ou Outra A resposta para "Growth ou Value?" não precisa ser binária: ### Princípios Finais 1. **Conheça seu perfil**: Horizonte, tolerância a risco, necessidade de renda 2. **Diversifique estilos**: Combine growth e value na carteira 3. **Adapte ao ciclo**: Ajuste pesos conforme condições de mercado 4. **Qualidade primeiro**: Em ambos os estilos, qualidade importa 5. **Paciência**: Ambas estratégias requerem tempo para funcionar ### Resumo Prático | Se você... | Considere... | | ---------------------------- | ---------------------------- | | É jovem e acumula patrimônio | Maior peso em growth | | Quer renda passiva | Maior peso em value | | Está perto da aposentadoria | Balance growth + value | | Tem horizonte curto | Prefira value com dividendos | | Aguenta volatilidade | Pode ter mais growth | ### Próximos Passos Aprofunde em cada estilo: 1. **[Value Investing](/blog/value-investing-como-encontrar-acoes-baratas)** - Encontre barganhas 2. **[PEG Ratio](/blog/indicador-peg-ratio-como-usar)** - Avalie growth stocks 3. **[Dividendos](/blog/dividendos-como-construir-renda-passiva)** - Renda passiva com value 4. **[Buy and Hold](/blog/buy-and-hold-estrategia-investimento-longo-prazo)** - Estratégia de longo prazo ## Automatize Sua Análise com brapi.dev A API da brapi.dev permite criar screeners personalizados para identificar ações growth e value: * Múltiplos fundamentalistas * Indicadores de crescimento * Dividend yields * Histórico de resultados **Comece gratuitamente** em [brapi.dev](https://brapi.dev) e crie suas próprias estratégias de investimento automatizadas. # Ações de Logística e Infraestrutura 2026: Rumo, CCR, Santos Brasil e o Futuro do Brasil URL: /blog/acoes-logistica-infraestrutura-rumo-ccr-santos-brasil.mdx Análise completa do setor de logística e infraestrutura na bolsa brasileira. Conheça Rumo, CCR, Santos Brasil, Ecorodovias. Indicadores, concessões, riscos e oportunidades. *** searchable: true title: 'Ações de Logística e Infraestrutura 2026: Rumo, CCR, Santos Brasil e o Futuro do Brasil' description: 'Análise completa do setor de logística e infraestrutura na bolsa brasileira. Conheça Rumo, CCR, Santos Brasil, Ecorodovias. Indicadores, concessões, riscos e oportunidades.' date: '2026-01-01' keywords: 'acoes logistica, rumo rail3, ccr ccro3, santos brasil stbp3, infraestrutura brasil, concessoes rodovias, ferrovias brasil, portos bolsa brasileira, 2026' author: 'Equipe brapi.dev' category: 'Análise Setorial' subcategory: 'Logística e Infraestrutura' readingTime: '18 min' tags: \['Logística', 'Infraestrutura', 'Rumo', 'CCR', 'Santos Brasil', 'Concessões', 'Análise Setorial', 'Bolsa Brasileira'] relatedPosts: \['divida-liquida-ebitda-alavancagem-analise-2026', 'valuation-dcf-multiplos-guia-completo-2026', 'agronegocio-bolsa-slce3-agro3-analise-2026'] featured: true expertise: 'Equipe técnica especializada em análise setorial e mercado de capitais' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > O Brasil é um país continental com gargalos logísticos históricos. Neste guia, você vai conhecer as empresas que movem a economia brasileira - ferrovias, rodovias, portos e aeroportos - e como investir nesse setor essencial. *** ## O Custo Brasil e a Oportunidade **Custo logístico:** \~12% do PIB (vs. 8% em países desenvolvidos). **Matriz de transporte do Brasil:** | Modal | Participação | | -------------------------- | -------------- | | Rodoviário | 65% das cargas | | Ferroviário | 15% das cargas | | Aquaviário | 12% das cargas | | Outros (aéreo, dutoviário) | 8% | * **Problema:** Dependência excessiva de rodovias * **Solução:** Investimento em ferrovias e cabotagem * **Investimento necessário:** R$ 100+ bilhões/ano * **Investimento atual:** R$ 40-50 bilhões/ano ### Por Que Investir em Logística e Infraestrutura? | Vantagem | Descrição | | -------------------------- | ------------------------------------------- | | **Receitas previsíveis** | Contratos de longo prazo, pedágios, tarifas | | **Proteção inflacionária** | Reajustes por IGP-M, IPCA | | **Barreiras de entrada** | Concessões exclusivas, ativos únicos | | **Demanda inelástica** | Economia precisa de transporte | | **Dividendos estáveis** | Fluxo de caixa previsível | | **Crescimento secular** | Déficit de infraestrutura garante demanda | *** ## Mapa do Setor na Bolsa Brasileira | Segmento | Empresas | | ------------------------- | -------------------------------------------------------------------- | | **Ferrovias** | Rumo (RAIL3), MRS Logística (não listada) | | **Rodovias** | CCR (CCRO3), Ecorodovias (ECOR3), Triunfo (TPIS3) | | **Portos** | Santos Brasil (STBP3), Wilson Sons (PORT3), Hidrovias Brasil (HBSA3) | | **Aeroportos** | CCR (também), concessionárias privadas | | **Locadoras** | Localiza (RENT3), Movida (MOVI3), Unidas (LCAM3) | | **Energia (transmissão)** | Transmissoras (TAEE11 e outras — setor próprio) | ### Empresas Listadas - Visão Geral | Ticker | Empresa | Segmento | Market Cap | | --------- | ---------------- | -------------------------------- | ------------- | | **RAIL3** | Rumo | Ferrovias (grãos) | \~R$ 35-45 bi | | **CCRO3** | CCR | Rodovias, aeroportos, mobilidade | \~R$ 25-35 bi | | **ECOR3** | Ecorodovias | Rodovias | \~R$ 8-12 bi | | **STBP3** | Santos Brasil | Terminal portuário | \~R$ 12-18 bi | | **PORT3** | Wilson Sons | Rebocadores, terminais | \~R$ 4-6 bi | | **HBSA3** | Hidrovias Brasil | Navegação interior | \~R$ 2-4 bi | | **TPIS3** | Triunfo | Rodovias, portos | \~R$ 1-2 bi | *** ## Rumo (RAIL3) ### Visão Geral A **Rumo** é a maior operadora ferroviária do Brasil, focada no transporte de commodities agrícolas do Centro-Oeste para os portos. **Perfil corporativo:** * Controlador: Cosan * Fundação: 2015 (fusão ALL + Rumo Logística) * Sede: Curitiba — PR **Malha ferroviária:** * \~14.000 km de extensão * Estados atendidos: MT, MS, GO, SP, PR, SC, RS * Conexão: interior agrícola → portos * Capacidade: \~80 bilhões de TKU/ano (TKU = tonelada por quilômetro útil) **Principais cargas:** | Produto | Participação | | ------------- | ------------ | | Soja | \~45% | | Milho | \~25% | | Açúcar | \~10% | | Fertilizantes | \~10% | | Outros | \~10% | ### Corredores Logísticos **Malha Norte (foco de crescimento):** soja / milho] --> R[Rondonópolis
terminal] R --> S[Santos
porto] style MT fill:#16a34a,color:#fff style R fill:#2563eb,color:#fff style S fill:#f59e0b,color:#fff `} /> * Extensão: \~1.600 km * Vantagem: custo 30-50% menor que rodovia * Expansão: Ferrovia de Integração (até Lucas do Rio Verde) **Malha Sul (madura):** grãos] --> P[Paranaguá / Rio Grande
portos] style PR fill:#16a34a,color:#fff style P fill:#f59e0b,color:#fff `} /> * Mais antiga, capacidade limitada * Foco: manutenção e eficiência ### Indicadores Financeiros | Indicador | Valor | Comentário | | ---------------------- | ------------- | -------------------------------- | | **Receita** | \~R$ 12-14 bi | Crescimento consistente | | **EBITDA** | \~R$ 5-6 bi | Margem \~45% | | **Dívida Líq./EBITDA** | \~2,5-3,5x | Alavancagem alta (investimentos) | | **ROE** | 10-15% | Melhorando com escala | | **Dividend Yield** | 1-3% | Prioriza investimentos | ### Tese de Investimento **Pontos Fortes:** 1. **Monopólio natural** - única ferrovia no corredor MT→Santos 2. **Custo competitivo** - ferrovia é mais barata que caminhão 3. **Demanda garantida** - agronegócio cresce 3-5% ao ano 4. **Expansão em andamento** - Ferrovia de Integração aumenta capacidade 5. **ESG favorável** - menor emissão de CO2 vs. rodovias **Riscos:** 1. Alavancagem elevada 2. Dependência de safra agrícola 3. Regulação (ANTT) 4. Capex pesado nos próximos anos 5. Concorrência futura (Ferrogrão?) ### Gatilhos de Valor **Curto prazo (1-2 anos):** * Safra cheia = volume recorde * Reajuste tarifário * Desalavancagem **Médio prazo (3-5 anos):** * Ferrovia de Integração operando * Aumento de capacidade +30-50% * Margem EBITDA → 50%+ * Início de dividendos relevantes **Longo prazo (5-10 anos):** * Consolidação como maior ferrovia da LatAm * Novos corredores (Norte?) * Potencial de rerating *** ## CCR (CCRO3) ### Visão Geral A **CCR** é uma das maiores empresas de concessões de infraestrutura da América Latina, com atuação diversificada em rodovias, mobilidade urbana e aeroportos. **Perfil corporativo:** * Fundação: 1999 * Sede: São Paulo — SP * Controladores: Mover Participações + Soares Penido **Segmentos de atuação:** * **Rodovias (\~60% da receita):** * CCR AutoBAn (Anhanguera-Bandeirantes) * CCR ViaOeste (Castelo Branco) * CCR RodoNorte (PR) * CCR MSVia (MS) * CCR ViaSul (RS) * CCR SPVias (interior SP) * demais concessões * **Mobilidade (\~25% da receita):** * Metrô SP (Linhas 4 e 5) * ViaQuatro (Linha 4) * ViaMobilidade (Linhas 5, 8, 9) * Barcas RJ * VLT Carioca * **Aeroportos (\~15% da receita):** * BH Airport (Confins) * Aeroportos internacionais * Operação + manutenção ### Modelo de Negócio Prazo 20-35 anos] --> B[2. Investimento inicial
Capex concentrado] B --> C[3. Operação
Pedágio com reajuste
IGP-M / IPCA] C --> D[4. Manutenção
obras periódicas] D --> E{5. Renovação
ou devolução?} E -->|Renova| C E -->|Devolve| F[Ativo volta
ao governo] style A fill:#2563eb,color:#fff style C fill:#16a34a,color:#fff style F fill:#dc2626,color:#fff `} /> ### Indicadores Financeiros | Indicador | Valor | Comentário | | ---------------------- | ------------- | -------------------- | | **Receita** | \~R$ 18-22 bi | Diversificada | | **EBITDA** | \~R$ 10-12 bi | Margem \~55% | | **Dívida Líq./EBITDA** | \~2,5-3x | Controlada | | **ROE** | 12-18% | Bom retorno | | **Dividend Yield** | 4-6% | Pagadora consistente | ### Diferenciais Competitivos 1. **Diversificação** - não depende de um único ativo 2. **Ativos premium** - rodovias de alto tráfego (SP) 3. **Experiência** - 25+ anos em concessões 4. **Governança** - tag along 100%, Novo Mercado 5. **Pipeline** - oportunidade em novas licitações ### Riscos * **Regulatório** - ARTESP, ANTT podem impor restrições * **Tráfego** - sensível à economia (PIB) * **Político** - pressão por redução de pedágio * **Renovação** - incerteza sobre extensão de concessões * **Mobilidade** - segmento mais arriscado (demanda volátil) *** ## Santos Brasil (STBP3) ### Visão Geral A **Santos Brasil** é a maior operadora de terminais portuários do Brasil, com foco no Porto de Santos. **Perfil corporativo:** * Fundação: 1997 * Sede: Santos — SP * Controlador: Opportunity (fundos) **Terminais e participação na receita:** | Terminal | Localização | Participação na receita | Destaques | | ---------------------------- | ----------- | ----------------------- | ----------------------------------------------------------------------------------------------- | | **Tecon Santos** (principal) | SP | \~65% | Maior terminal de contêineres do Brasil; capacidade \~2,5 mi TEUs/ano; localização privilegiada | | **Tecon Imbituba** | SC | \~10% | Contêineres e carga geral | | **Tecon Vila do Conde** | PA | \~5% | Norte do Brasil | | **TEV (Veículos)** | Santos | \~15% | Terminal de veículos | | **Logística Integrada** | — | — | Armazéns, transporte | ### O Porto de Santos **Santos: o maior porto da América Latina** * \~140 milhões de toneladas/ano * \~30% do comércio exterior brasileiro * \~4 milhões de TEUs (contêineres)/ano * Principal porta de entrada/saída do país **Vantagens da Santos Brasil:** * Localização no canal principal * Profundidade de calado * Infraestrutura moderna * Conexão rodo-ferroviária * Clientes cativos (armadores) ### Indicadores Financeiros | Indicador | Valor | Comentário | | ---------------------- | ------------------ | -------------------- | | **Receita** | \~R$ 2-2,5 bi | Crescimento moderado | | **EBITDA** | \~R$ 800 mi - 1 bi | Margem \~40% | | **Dívida Líq./EBITDA** | \~1-2x | Baixa alavancagem | | **ROE** | 15-25% | Excelente retorno | | **Dividend Yield** | 4-7% | Boa pagadora | ### Tese de Investimento **Pontos Fortes:** 1. **Ativo irreplicável** - não há como construir outro Tecon Santos 2. **Barreira de entrada** - concessão exclusiva 3. **Demanda crescente** - comércio exterior só cresce 4. **Margens altas** - negócio capital-intensivo com escala 5. **Baixa alavancagem** - capacidade de investir/dividendos **Riscos:** 1. Vencimento da concessão (atenção ao prazo) 2. Concorrência de outros portos (Itapoá, Navegantes) 3. Greves e paralisações 4. Dependência de poucos clientes (armadores) 5. Crise no comércio global ### Aquisição pela CMA CGM (2024) Em 2024, a **CMA CGM** (terceira maior armadora do mundo) adquiriu o controle da Santos Brasil. Isso representa: * **Positivo:** Investimentos, know-how, volume garantido * **Risco:** Minoritários podem ser prejudicados *** ## Ecorodovias (ECOR3) ### Visão Geral * **Controlador:** Grupo Gavio (Itália) + IG4 Capital * **Foco:** Concessões rodoviárias * **Diferencial:** foco em rodovias de alto tráfego **Principais concessões:** * Ecovias (Imigrantes) — SP * Ecopistas (Ayrton Senna) — SP * Eco101 (BR-101) — ES/BA * Ecosul — RS * Ecoponte (Niterói) — RJ * Outras rodovias ### Comparativo CCR vs. Ecorodovias | Aspecto | CCR | Ecorodovias | | ------------------ | ---------------------------------- | ----------------------- | | **Tamanho** | Maior | Menor | | **Diversificação** | Rodovias + mobilidade + aeroportos | Principalmente rodovias | | **Alavancagem** | Moderada | Moderada/Alta | | **Dividend Yield** | 4-6% | 3-5% | | **Liquidez** | Alta | Média | | **Governança** | Novo Mercado | Novo Mercado | *** ## Outras Empresas do Setor ### Hidrovias do Brasil (HBSA3) **Modelo de negócio:** * Navegação interior (rios) * Corredor Norte: Araguaia-Tocantins * Corredor Sul: Hidrovia Paraná-Paraguai * Foco: grãos e fertilizantes **Vantagem:** * Custo baixíssimo por tonelada * Alternativa a ferrovias e rodovias **Desafio:** * Sazonalidade (nível dos rios) * Infraestrutura limitada * Dependência de dragagem ### Wilson Sons (PORT3) **Atuação:** * Rebocadores (maior frota do Brasil) * Terminais de contêineres (Salvador, Rio Grande) * Logística offshore * Estaleiros **Diferencial:** * Receita em dólar (offshore) * Diversificação de negócios * 180+ anos de história ### Triunfo (TPIS3) **Situação:** * Reestruturação após problemas * Vendeu ativos * Focada em Concer (BR-040) * Menor e mais arriscada > Atenção: histórico de governança problemático. *** ## Como Analisar Ações de Infraestrutura ### Métricas Específicas do Setor Para analisar empresas de infraestrutura, busque dados fundamentalistas via API: ```typescript const response = await fetch( 'https://brapi.dev/api/quote/RAIL3?modules=summaryProfile,defaultKeyStatistics,financialData', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() const stock = data.results[0] ``` **Indicadores-Chave para Infraestrutura:** | Indicador | Onde Encontrar | Importância | | -------------- | ----------------------------------------- | ------------------------- | | P/L | `defaultKeyStatistics.forwardPE` | Valuation | | EV/EBITDA | `defaultKeyStatistics.enterpriseToEbitda` | Avalia dívida junto | | Margem EBITDA | `financialData.ebitdaMargins` | Eficiência operacional | | ROE | `financialData.returnOnEquity` | Retorno sobre patrimônio | | Dividend Yield | `defaultKeyStatistics.dividendYield` | Renda passiva | | Dívida Total | `financialData.totalDebt` | Crucial p/ infraestrutura | | Caixa | `financialData.totalCash` | Liquidez | > **Importante:** No setor de infraestrutura, a análise de endividamento é fundamental devido aos altos investimentos em ativos fixos. ### Métricas Chave por Segmento | Segmento | Métrica Principal | O Que Observar | | -------------- | ----------------- | ------------------- | | **Ferrovias** | TKU (ton-km útil) | Volume transportado | | **Rodovias** | Tráfego pedagiado | Veículos/dia | | **Portos** | TEUs movimentados | Contêineres/ano | | **Aeroportos** | PAX (passageiros) | Passageiros/ano | ### Avaliação de Concessões **1. Prazo remanescente:** * Quanto tempo falta para vencer? * Possibilidade de renovação? * Impacto no valuation **2. Taxa Interna de Retorno (TIR):** * Retorno implícito do contrato * Comparar com custo de capital * TIR > 10% = atrativo **3. Obrigações contratuais:** * Investimentos obrigatórios * Metas de qualidade * Penalidades por descumprimento **4. Reequilíbrio econômico:** * Obras extras = reequilíbrio * Pode estender o prazo * Ou aumentar a tarifa *** ## Comparativo de Múltiplos | Empresa | P/L | EV/EBITDA | Dív.Líq./EBITDA | DY | ROE | | --------- | ------ | --------- | --------------- | ---- | ------ | | **RAIL3** | 15-25x | 6-8x | 2,5-3,5x | 1-3% | 10-15% | | **CCRO3** | 12-18x | 6-8x | 2,5-3x | 4-6% | 12-18% | | **ECOR3** | 10-15x | 5-7x | 2-3x | 3-5% | 10-15% | | **STBP3** | 12-18x | 7-10x | 1-2x | 4-7% | 15-25% | | **PORT3** | 8-12x | 5-7x | 1-2x | 4-6% | 12-18% | > **Observação:** Múltiplos variam significativamente com ciclo econômico e taxas de juros. *** ## Riscos do Setor ### Riscos Regulatórios **Agências reguladoras:** * ANTT (ferrovias, rodovias federais) * ARTESP (rodovias SP) * ANTAQ (portos, hidrovias) * ANAC (aeroportos) **Riscos:** * Mudança nas regras de reajuste * Revisão tarifária extraordinária * Novas obrigações de investimento * Multas por descumprimento * Não renovação de concessões **Mitigação:** * Diversificação de concessões * Bom relacionamento institucional * Cumprimento rigoroso de contratos ### Riscos Macroeconômicos | Fator | Impacto | Empresas Mais Afetadas | | ---------------- | --------------------------- | ------------------------------- | | **Juros altos** | Aumenta custo da dívida | RAIL3, CCRO3 (mais alavancadas) | | **Recessão** | Reduz tráfego/volume | CCRO3, ECOR3 (rodovias) | | **Câmbio** | Impacta dívida em dólar | RAIL3 (dívida USD) | | **Inflação** | Reajusta tarifas (positivo) | Todas (IGP-M/IPCA) | | **Crise global** | Reduz comércio exterior | STBP3, PORT3 (portos) | ### Riscos Operacionais * **Acidentes** - responsabilidade civil * **Greves** - paralisação de operações * **Clima** - enchentes, deslizamentos * **Manutenção** - custos inesperados * **Tecnologia** - necessidade de atualização *** ## Estratégias de Investimento ### Para Diferentes Perfis | Perfil | Estratégia | Empresas Sugeridas | | --------------- | ------------------------ | ------------------ | | **Conservador** | Foco em dividendos | CCRO3, STBP3 | | **Moderado** | Mix rodovias + ferrovias | CCRO3, RAIL3 | | **Agressivo** | Crescimento + turnaround | RAIL3, HBSA3 | | **Renda** | Máximo yield | CCRO3, PORT3 | ### Timing e Ciclos **Melhores momentos para comprar:** * Início de ciclo de corte de juros (beneficia alavancadas) * Após revisão tarifária favorável * Vitória em nova licitação * Quando o tráfego está deprimido (mas a economia vai melhorar) **Cuidado ao comprar:** * Final de ciclo de alta de juros * Antes de vencimento de concessão * Quando a alavancagem está muito alta * Incerteza regulatória elevada ### Combinando com Agro O agronegócio brasileiro depende da logística. Boa safra = mais volume para Rumo e portos. **Estratégia:** * SLCE3 (produção) + RAIL3 (transporte) * AGRO3 (terras) + STBP3 (exportação) * Correlação positiva em anos de safra cheia *** ## Monitorando o Setor ### Fontes de Informação | Fonte | O Que Acompanhar | | -------------------------------- | ----------------------------- | | **ANTT** | Dados de tráfego, regulação | | **ARTESP** | Rodovias de SP | | **ANTAQ** | Movimentação portuária | | **Ministério da Infraestrutura** | Licitações, projetos | | **bolsa brasileira** | Fatos relevantes das empresas | ### Dashboard com brapi Monitore as principais ações de infraestrutura em uma única requisição: ```typescript const tickers = 'RAIL3,CCRO3,ECOR3,STBP3,PORT3,HBSA3' const response = await fetch( `https://brapi.dev/api/quote/${tickers}`, { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // data.results → Array com dados de todas as ações ``` **Exemplo de Painel de Infraestrutura:** | Ticker | Segmento | O que Acompanhar | | ------ | --------- | -------------------------- | | RAIL3 | Ferrovias | Volume TKU, safra agrícola | | CCRO3 | Rodovias | Tráfego pedagiado | | ECOR3 | Rodovias | Tráfego, margens | | STBP3 | Portos | TEUs, exportações | | PORT3 | Portos | Movimentação grãos | | HBSA3 | Logística | Diversificação operações | ```` ### Acompanhando Tráfego Para análise histórica de preços (útil para correlacionar com dados de tráfego): ```typescript const response = await fetch( 'https://brapi.dev/api/quote/RAIL3?range=1y&interval=1mo', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // data.results[0].historicalDataPrice → Histórico mensal de 12 meses ```` > **Dica:** Cruze os dados históricos de preço com os relatórios mensais de tráfego divulgados pelas empresas para identificar correlações. ``` --- ## FAQ ### Qual a melhor ação de infraestrutura? Depende do objetivo: - **Dividendos:** CCRO3, STBP3 - **Crescimento:** RAIL3 - **Menor risco:** CCRO3 (diversificada) - **Valor:** depende do momento ### Rumo é uma boa ação? Rumo é uma excelente empresa com tese de longo prazo forte (expansão ferroviária), mas: - Alavancagem é alta - Dividendos são baixos - Melhor para quem busca crescimento ### CCR ou Ecorodovias? | Critério | Vencedor | |----------|----------| | Tamanho/Liquidez | CCR | | Dividendos | CCR | | Diversificação | CCR | | Valor (mais barata) | Depende do momento | | Upside | Depende da análise | ### Como os juros afetam o setor? - **Juros altos:** Aumentam custo da dívida, reduzem valuation - **Juros baixos:** Reduzem custo da dívida, aumentam valuation - Empresas alavancadas (Rumo) são mais sensíveis ### O que são TEUs? TEU = Twenty-foot Equivalent Unit (Unidade Equivalente a Contêiner de 20 pés) É a unidade padrão para medir movimentação de contêineres em portos. --- ## Novas Oportunidades ### Projetos em Andamento **Ferrogrão (MT → PA):** - Nova ferrovia de grãos pelo Norte - Concorrente da Rumo - Ainda em licenciamento **Nova Dutra:** - Relicitação da Via Dutra - CCR perdeu para a Ecorodovias - Impacto nos resultados **Cabotagem:** - Navegação costeira - Potencial enorme - Poucos players listados **Ferrovias regionais:** - Novos trechos sendo licitados - Oportunidade para incumbentes ### Tendências Estruturais 1. **Descarbonização** - ferrovias e cabotagem ganham espaço 2. **Digitalização** - pedágio eletrônico, automação portuária 3. **Consolidação** - fusões e aquisições no setor 4. **Investimento estrangeiro** - entrada de players globais 5. **PPPs** - novas formas de parceria público-privada --- ## Conclusão O setor de logística e infraestrutura oferece oportunidades únicas: 1. ✅ **Receitas previsíveis** - contratos de longo prazo 2. ✅ **Proteção inflacionária** - reajustes anuais 3. ✅ **Barreiras de entrada** - ativos únicos 4. ✅ **Demanda estrutural** - Brasil precisa de infraestrutura 5. ⚠️ **Atenção à alavancagem** - algumas empresas são muito endividadas 6. ⚠️ **Risco regulatório** - sempre presente **Lembre-se:** O setor é sensível a juros. Em ciclos de corte, tende a performar bem. --- ## Próximos Passos - **[Cadastre-se na brapi](https://brapi.dev)** para acompanhar cotações - **[Análise fundamentalista](/blog/analise-fundamentalista-acoes-b3-guia-completo-indicadores)** para aprofundar - **[Agronegócio](/blog/agronegocio-bolsa-slce3-agro3-analise-2026)** para entender a conexão - **[Stock screener](/blog/stock-screener-python-brapi-filtrar-acoes)** para filtrar ações --- *Este artigo tem caráter educacional e não constitui recomendação de investimento. Faça sua própria análise.* ``` # Ações de Saneamento 2026: SBSP3, CSMG3 e SAPR11 URL: /blog/acoes-saneamento-sbsp3-csmg3-sapr11-analise-2026.mdx Análise do setor de saneamento na bolsa brasileira em 2026: Sabesp SBSP3, Copasa CSMG3, Sanepar SAPR11, Marco Legal, privatização, dividendos e riscos. *** searchable: true title: 'Ações de Saneamento 2026: SBSP3, CSMG3 e SAPR11' description: 'Análise do setor de saneamento na bolsa brasileira em 2026: Sabesp SBSP3, Copasa CSMG3, Sanepar SAPR11, Marco Legal, privatização, dividendos e riscos.' date: '2026-01-01' keywords: 'ações saneamento 2026, SBSP3, CSMG3, SAPR11, Sabesp, Copasa, Sanepar, setor saneamento, dividendos saneamento, privatização Sabesp, marco legal saneamento' author: 'Equipe brapi.dev' category: 'Análise Setorial' subcategory: 'Saneamento' readingTime: '12 min' tags: \['Saneamento', 'SBSP3', 'CSMG3', 'SAPR11', 'Análise Setorial', 'Dividendos', 'Privatização'] relatedPosts: \['melhores-acoes-setor-eletrico-2026-dividendos-taee11-trpl4', 'dividendos-como-construir-renda-passiva', 'melhores-acoes-pagadoras-dividendos-2026', 'setor-seguros-bbse3-cxse3-pssa3-analise-2026', 'acoes-bancos-analise-setorial-2026'] featured: true expertise: 'Análise setorial desenvolvida por especialistas em infraestrutura e utilities brasileiras.' lastReviewed: '2026-04-23' faqSchema: * question: 'Quais são as principais ações de saneamento na bolsa brasileira?' answer: 'As principais ações de saneamento acompanhadas por investidores são Sabesp (SBSP3), Copasa (CSMG3) e Sanepar (SAPR11).' * question: 'A privatização da Sabesp muda a tese de SBSP3?' answer: 'Sim. SBSP3 passou a ser analisada mais como tese de eficiência, universalização e crescimento regulado, e menos como estatal pagadora de dividendos no curto prazo.' * question: 'Saneamento é setor bom para dividendos?' answer: 'Pode ser, mas depende do ciclo de investimentos. Empresas com CAPEX elevado podem reter mais caixa, mesmo quando têm receita previsível.' *** import { Authors, Author } from '~/components/Authors'; O setor de saneamento combina características defensivas com uma avenida de investimentos grande até a universalização. Para o investidor, isso cria uma tensão importante: **as empresas têm receita essencial e previsível, mas precisam investir muito capital**. Por isso, nem toda ação de saneamento deve ser analisada apenas pelo dividend yield. Neste guia, comparamos **Sabesp (SBSP3)**, **Copasa (CSMG3)** e **Sanepar (SAPR11)** em 2026, considerando Marco Legal do Saneamento, privatização da Sabesp, risco político, dividendos e eficiência operacional. ## Resumo Direto | Empresa | Ticker | Controle | Tese principal | Risco principal | | ------- | ------ | ---------------------------------------------------------------- | --------------------------------------------------- | --------------------------------- | | Sabesp | SBSP3 | Companhia desestatizada, Equatorial como acionista de referência | Eficiência e universalização acelerada | Execução de CAPEX e regulação | | Copasa | CSMG3 | Estatal de Minas Gerais | Dividendos e eventual opcionalidade de privatização | Interferência política | | Sanepar | SAPR11 | Controle estatal com capital privado | Equilíbrio entre dividendos e operação madura | Regulação e dependência do Paraná | SBSP3 é hoje mais uma tese de transformação. CSMG3 costuma ser olhada por dividendos e desconto. SAPR11 fica no meio: operação madura, governança mista e renda potencialmente mais previsível. ## Por Que Saneamento Entrou no Radar O Marco Legal do Saneamento estabeleceu metas de universalização até 2033, com objetivo de levar água tratada e esgoto a uma parcela muito maior da população. Isso exige investimentos bilionários, concessões mais claras e maior participação privada. Para empresas listadas, o setor oferece três motores de valor: | Motor | Como afeta as empresas | | --------------- | -------------------------------------------- | | Universalização | Aumenta base de clientes e ativos regulados | | Eficiência | Reduz perdas de água, custos e inadimplência | | Regulação | Define tarifas, retorno permitido e metas | O lado negativo é que saneamento é capital intensivo. Empresas que investem muito podem reduzir dividendos no curto prazo para financiar obras. ## SBSP3: Sabesp Pós-Desestatização A Sabesp foi desestatizada em 2024. A oferta pública teve a Equatorial como investidora de referência com 15% das ações, e o Estado de São Paulo permaneceu com participação relevante. O novo ciclo mudou a tese: a empresa passou a ser analisada pela capacidade de executar investimentos, reduzir perdas e antecipar metas de universalização. Segundo materiais do Governo de SP e da própria Sabesp, a desestatização foi concluída em julho de 2024, com captação em torno de R$ 14,8 bilhões e preço de R$ 67 por ação na oferta. O plano envolve investimentos relevantes até 2029 e metas de expansão de água e esgoto. Para o investidor, a pergunta sobre SBSP3 é simples: a empresa conseguirá investir mais, melhorar eficiência e ainda gerar retorno adequado sobre a base regulatória? Se sim, a tese é de crescimento e valorização. Se a regulação ou execução decepcionar, o retorno pode ficar abaixo do esperado. ## CSMG3: Copasa e o Desconto Estatal Copasa opera em Minas Gerais e costuma aparecer em carteiras de dividendos por negociar com múltiplos baixos em alguns ciclos. O desconto existe por um motivo: controle estatal, risco político e incerteza sobre privatização. CSMG3 pode ser interessante para quem busca renda e aceita risco de governança. O investidor deve acompanhar política de dividendos, perdas de água, reajustes tarifários, endividamento e capacidade de investimento. Uma possível privatização seria um gatilho positivo, mas não deve ser a única base da tese. ## SAPR11: Sanepar e Equilíbrio Sanepar atende o Paraná e tem uma estrutura de controle misto. A ação unit SAPR11 costuma ser analisada como uma tese mais equilibrada: menos transformacional que Sabesp, menos dependente de evento político que Copasa, e com histórico relevante de distribuição. O ponto de atenção é que a empresa continua exposta a decisões estaduais, revisões tarifárias e necessidade de investimento. Como em todo saneamento, dividendos precisam ser avaliados junto com CAPEX e metas regulatórias. ## Como Comparar as Três Use dados atualizados de preço e indicadores. O exemplo abaixo consulta os três tickers pela brapi.dev: ```typescript const response = await fetch( 'https://brapi.dev/api/quote/SBSP3,CSMG3,SAPR11?modules=defaultKeyStatistics,financialData', { headers: { Authorization: 'Bearer SEU_TOKEN' } }, ); const { results } = await response.json(); const saneamento = results.map((acao) => { const stats = acao.defaultKeyStatistics ?? {}; const financials = acao.financialData ?? {}; return { ticker: acao.symbol, preco: acao.regularMarketPrice, pl: acao.priceEarnings ?? stats.trailingPE, pvp: stats.priceToBook, dy: stats.dividendYield, roe: financials.returnOnEquity, }; }); ``` Indicadores úteis: | Indicador | Por que importa | | --------------------- | -------------------------------------------- | | P/L | Ajuda a comparar preço e lucro recorrente | | P/VP | Relevante em empresas intensivas em ativos | | Dividend yield | Mede renda passada, não garantia futura | | Dívida líquida/EBITDA | Mostra capacidade de financiar investimentos | | Margem EBITDA | Indica eficiência operacional | ## Riscos do Setor Saneamento parece defensivo, mas não é livre de risco. Revisões tarifárias podem reduzir retorno, governos podem interferir em decisões, secas aumentam custos, perdas de água corroem margens e obras podem atrasar. Além disso, o investidor precisa aceitar que universalização exige CAPEX. Em muitos casos, a empresa que paga menos dividendos hoje pode estar construindo uma base de ativos maior para o futuro. B[Fluxo previsível] B --> C[Dividendos potenciais] A --> D[Metas de universalização] D --> E[CAPEX elevado] E --> F[Menos caixa livre no curto prazo] `} /> ## Qual Perfil Combina com Cada Ação | Perfil do investidor | Ação que costuma entrar no radar | Lógica | | ---------------------------------------- | -------------------------------- | ----------------------------------------- | | Busca transformação | SBSP3 | Eficiência pós-desestatização | | Busca dividendos e aceita risco político | CSMG3 | Desconto e payout potencial | | Busca equilíbrio | SAPR11 | Operação madura e diversificada no Paraná | Não use essa tabela como recomendação. Ela serve para organizar a análise conforme objetivo e tolerância a risco. ## Fontes Revisadas [Sabesp: Relatório de Sustentabilidade 2024](https://www.sabesp.com.br/site/toq/x/y/relatorio-sustentabilidade-2024.pdf) · [Governo de SP: oferta pública da Sabesp](https://semil.sp.gov.br/2024/07/oferta-publica-da-sabesp-bate-recorde-como-maior-da-historia-do-pais-em-saneamento-e-capta-r-147-bilhoes/) · [PPI SP: projeto Sabesp](https://www.ppi.sp.gov.br/projeto/sabesp-cia-de-saneamento-basico-do-estado-de-sao-paulo-selo-leiloado/) ## Perguntas Frequentes ### Qual é a melhor ação de saneamento para dividendos? Depende do preço e do momento. Copasa e Sanepar costumam aparecer mais em análises de renda, enquanto Sabesp pode priorizar investimento e expansão após a desestatização. ### A privatização da Sabesp foi boa para SBSP3? Ela mudou a tese. O potencial de eficiência aumentou, mas também aumentou a necessidade de acompanhar execução de investimentos, metas regulatórias e retorno permitido. ### Saneamento protege contra inflação? Parcialmente. Tarifas e contratos podem ter reajustes, mas regulação, política tarifária, inadimplência e CAPEX podem reduzir a proteção no resultado do acionista. ## Conclusão Ações de saneamento em 2026 devem ser analisadas como infraestrutura regulada, não apenas como pagadoras de dividendos. SBSP3 é a tese mais transformacional, CSMG3 carrega desconto e risco político, e SAPR11 oferece uma alternativa mais equilibrada. Para acompanhar cotações, indicadores fundamentalistas e histórico, use a [API da brapi.dev](/docs). *Este conteúdo é educacional e não constitui recomendação de investimento.* # Ações vs FIIs: Qual Investir em 2026? Comparativo Completo URL: /blog/acoes-vs-fiis-comparativo-qual-investir-2026.mdx Descubra as diferenças entre ações e fundos imobiliários (FIIs). Comparativo de rentabilidade, dividendos, tributação, riscos e quando cada um é melhor em 2026. *** searchable: true title: 'Ações vs FIIs: Qual Investir em 2026? Comparativo Completo' description: 'Descubra as diferenças entre ações e fundos imobiliários (FIIs). Comparativo de rentabilidade, dividendos, tributação, riscos e quando cada um é melhor em 2026.' date: '2026-01-01' keywords: 'acoes vs fiis 2026, fiis ou acoes, fundos imobiliarios vs acoes, investir em fiis ou acoes, dividendos fiis, dividendos acoes, renda passiva, comparativo investimentos' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Comparativos' readingTime: '15 min' tags: \['Ações', 'FIIs', 'Fundos Imobiliários', 'Dividendos', 'Renda Passiva', 'Comparativo'] relatedPosts: \['fundos-imobiliarios-fiis-guia-completo-iniciantes', 'dividendos-como-construir-renda-passiva', 'melhores-acoes-pagadoras-dividendos-2026', 'fiis-de-papel-vs-tijolo-comparativo-2026', 'renda-fixa-vs-renda-variavel-2026'] featured: true expertise: 'Análise comparativa desenvolvida por especialistas em renda variável' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; Uma das dúvidas mais comuns entre investidores brasileiros é escolher entre **ações** e **fundos imobiliários (FIIs)**. Ambos são ativos de renda variável negociados na bolsa brasileira, mas possuem características bem diferentes em termos de rentabilidade, dividendos, tributação e riscos. Neste guia comparativo, vamos analisar cada aspecto para ajudá-lo a decidir qual (ou qual proporção de cada) faz mais sentido para seus objetivos de investimento. ## Resumo Comparativo | Característica | Ações | FIIs | | ----------------------------- | ------------------------ | -------------------------------- | | **O que é** | Participação em empresas | Cotas de fundos imobiliários | | **Rendimento** | Dividendos + Valorização | Dividendos mensais + Valorização | | **Frequência dividendos** | Trimestral/Anual | Mensal | | **IR sobre dividendos** | Isento (PF) | Isento (PF) | | **IR sobre ganho de capital** | 15% (swing trade) | 20% | | **Isenção mensal** | Até R$ 20.000 | Não há | | **Volatilidade** | Alta | Média | | **Liquidez** | Alta | Média | | **Gestão** | Passiva (investidor) | Profissional (gestor) | ## O Que São Ações? Ações representam **participação societária** em empresas de capital aberto. Ao comprar ações, você se torna sócio da empresa, com direito a: * Receber dividendos proporcionais * Participar das assembleias (ações ordinárias) * Beneficiar-se da valorização da empresa ### Tipos de Ações | Tipo | Código | Características | | ---------------------- | --------------- | ----------------------------- | | **Ordinárias (ON)** | 3 (ex: PETR3) | Direito a voto em assembleias | | **Preferenciais (PN)** | 4 (ex: PETR4) | Preferência nos dividendos | | **Units** | 11 (ex: TAEE11) | Combinação de ON + PN | ### Exemplos de Ações por Perfil **Dividendos (renda passiva):** * TAEE11 (Taesa) - Setor elétrico * BBAS3 (Banco do Brasil) - Bancário * ITSA4 (Itaúsa) - Holding **Crescimento (valorização):** * WEGE3 (WEG) - Industrial * PRIO3 (PetroRio) - Petróleo * TOTS3 (Totvs) - Tecnologia ## O Que São FIIs? Fundos Imobiliários são **veículos de investimento coletivo** que aplicam recursos em ativos imobiliários. São negociados na bolsa como ações, mas funcionam como fundos. ### Tipos de FIIs | Tipo | Características | Exemplos | | ----------- | ------------------------------------------- | ---------------------- | | **Tijolo** | Imóveis físicos (shoppings, galpões, lajes) | HGLG11, XPLG11, VISC11 | | **Papel** | CRIs, LCIs, títulos imobiliários | KNCR11, MXRF11, RECR11 | | **FOF** | Cotas de outros FIIs | BCFF11, HFOF11 | | **Híbrido** | Combinação de tijolo e papel | KNRI11, BRCR11 | ### Vantagens dos FIIs 1. **Dividendos mensais**: Distribuição obrigatória de 95% dos lucros 2. **Isenção de IR**: Dividendos isentos para pessoa física 3. **Diversificação imobiliária**: Acesso a grandes empreendimentos 4. **Gestão profissional**: Administrador cuida dos imóveis 5. **Baixo valor inicial**: A partir de R$ 10-100 ## Comparativo de Rentabilidade ### Histórico: Ações vs FIIs Analisando os últimos anos: | Período | IBOV | IFIX | CDI | | ------- | ------ | ------ | ------ | | 2020 | +2,9% | -10,2% | +2,8% | | 2021 | -11,9% | -2,3% | +4,4% | | 2022 | +4,7% | +2,2% | +12,4% | | 2023 | +22,3% | +15,5% | +13,0% | | 2024\* | +10,5% | +8,2% | +10,8% | \*Dados parciais ### Simulação Comparativa com brapi.dev ```typescript // Buscar dados de ações e FIIs para comparação const headers = { 'Authorization': 'Bearer SEU_TOKEN' } // Ações: cotações com histórico e dividendos const acoes = await fetch( 'https://brapi.dev/api/quote/PETR4,VALE3,ITUB4,BBDC4,WEGE3?range=1y&interval=1mo÷nds=true', { headers } ) // FIIs: indicadores detalhados via endpoint especializado const fiis = await fetch( 'https://brapi.dev/api/v2/fii/indicators?symbols=HGLG11,XPLG11,KNCR11,MXRF11,VISC11', { headers } ) ``` #### Exemplo de Comparação (12 meses, aporte R$ 1.000/mês) | Métrica | Ações | FIIs | | ------------------------- | -------------- | ----------------- | | **Aporte total** | R$ 12.000 | R$ 12.000 | | **Retorno médio** | +15% | +10% | | **Patrimônio final** | R$ 14.200 | R$ 13.400 | | **Dividendos acumulados** | R$ 840 (7% DY) | R$ 1.200 (10% DY) | | **Volatilidade** | Alta | Moderada | **Observação:** Resultados variam conforme período e ativos escolhidos. Use a API para análises atualizadas. ## Comparativo de Dividendos ### Dividend Yield Médio | Tipo | DY Médio Anual | Frequência | | ---------------- | -------------- | -------------------- | | **Ações (IDIV)** | 6% a 10% | Trimestral/Semestral | | **FIIs (IFIX)** | 8% a 12% | Mensal | ### Simulação de Renda Passiva #### Simulação de Renda Passiva (Patrimônio: R$ 500.000) | Classe | DY Anual | Renda Anual | Renda Mensal | Frequência | | ------------- | -------- | ----------- | ---------------- | ---------- | | **Ações** | 7% | R$ 35.000 | R$ 2.917 (média) | Trimestral | | **FIIs** | 10% | R$ 50.000 | R$ 4.167 | Mensal | | **Diferença** | +3% | +R$ 15.000 | +R$ 1.250 | - | **Conclusão:** Para renda passiva regular, FIIs oferecem maior yield e pagamentos mensais. **Resultado do exemplo:** * Patrimônio: R$ 500.000 * Ações (DY 7%): R$ 2.917/mês (média) * FIIs (DY 10%): R$ 4.167/mês * FIIs pagam R$ 1.250/mês a mais ## Tributação: Diferenças Importantes ### Imposto de Renda | Operação | Ações | FIIs | | --------------------------------- | ----------------------- | ---------------- | | **Dividendos** | Isento | Isento | | **Venda com lucro (swing trade)** | 15% | 20% | | **Venda com lucro (day trade)** | 20% | 20% | | **Isenção mensal** | Até R$ 20.000 em vendas | Não há | | **Compensação de prejuízos** | Sim (mesmo tipo) | Sim (mesmo tipo) | ### Impacto Prático A **isenção de R$ 20.000 mensais** para ações é uma vantagem significativa para pequenos investidores: #### Comparativo de Tributação na Venda | Cenário | Valor Venda | Lucro | IR Ações | IR FIIs | Vantagem | | ----------------- | ----------- | --------- | -------------- | -------------- | ------------- | | **Venda pequena** | R$ 15.000 | R$ 3.000 | R$ 0 (isento) | R$ 600 (20%) | Ações: R$ 600 | | **Venda grande** | R$ 50.000 | R$ 10.000 | R$ 1.500 (15%) | R$ 2.000 (20%) | Ações: R$ 500 | **Regras:** * **Ações:** Isenção de IR para vendas até R$ 20.000/mês. Acima disso, 15% sobre o lucro * **FIIs:** Sem isenção. Sempre 20% sobre o lucro, independente do valor vendido **Dica:** Para pequenos investidores, a isenção de R$ 20.000 das ações é uma vantagem significativa. ## Riscos: O Que Considerar ### Riscos das Ações | Risco | Descrição | Mitigação | | -------------- | ---------------------------------- | ------------------------------ | | **Mercado** | Volatilidade do Ibovespa | Diversificação por setores | | **Empresa** | Problemas específicos da companhia | Análise fundamentalista | | **Setorial** | Crise em setor específico | Diversificação setorial | | **Liquidez** | Dificuldade de vender | Preferir ações líquidas | | **Governança** | Má gestão, fraudes | Avaliar governança corporativa | ### Riscos dos FIIs | Risco | Descrição | Mitigação | | ----------------- | -------------------------------- | ---------------------------- | | **Vacância** | Imóveis desocupados | FIIs com contratos longos | | **Inadimplência** | Locatários não pagam | Diversificação de inquilinos | | **Juros** | Alta de juros reduz atratividade | FIIs de papel se beneficiam | | **Concentração** | Poucos imóveis/inquilinos | FOFs e fundos diversificados | | **Gestão** | Decisões ruins do administrador | Avaliar histórico do gestor | ### Volatilidade Comparada ```typescript const response = await fetch( 'https://brapi.dev/api/quote/PETR4,VALE3,HGLG11,XPLG11?range=3mo&interval=1d', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const { results } = await response.json() // Calcular desvio padrão dos retornos diários para volatilidade ``` #### Volatilidade Comparada (Desvio Padrão Diário) | Classe | Volatilidade Média | Interpretação | | -------------------- | ------------------ | --------------------- | | **Ações Blue Chips** | 2,0% - 3,0% | Alta oscilação diária | | **Ações Small Caps** | 3,0% - 5,0% | Muito alta oscilação | | **FIIs Tijolo** | 1,0% - 1,5% | Oscilação moderada | | **FIIs Papel** | 0,8% - 1,2% | Baixa oscilação | **Conclusão:** FIIs são tipicamente 2x menos voláteis que ações, tornando-os mais adequados para investidores conservadores. ## Quando Escolher Ações ### Perfil Ideal para Ações * **Horizonte longo**: 5+ anos * **Tolerância a volatilidade**: Alta * **Objetivo**: Crescimento patrimonial * **Tempo para análise**: Disponível para acompanhar empresas * **Estratégia**: Buy and hold ou value investing ### Melhores Cenários 1. **Jovem em fase de acumulação**: Pode assumir mais risco 2. **Busca crescimento agressivo**: Empresas de tecnologia, small caps 3. **Quer participar de setores específicos**: Bancos, commodities 4. **Prefere empresas com governança**: Tag along, Novo Mercado ## Quando Escolher FIIs ### Perfil Ideal para FIIs * **Objetivo**: Renda passiva regular * **Tolerância a volatilidade**: Média * **Prefere simplicidade**: Gestão profissional * **Busca previsibilidade**: Dividendos mensais * **Alocação imobiliária**: Sem capital para imóveis físicos ### Melhores Cenários 1. **Já aposentado ou perto**: Precisa de renda mensal 2. **Complementar renda do trabalho**: Dividendos mensais 3. **Diversificação imobiliária**: Acesso a shoppings, galpões 4. **Gestão passiva**: Não quer acompanhar empresas ## Estratégia Híbrida: O Melhor dos Dois Mundos ### Alocação por Idade #### Alocação Sugerida por Idade | Idade | Ações | FIIs | Renda Fixa | Estratégia | | ----------- | ----- | ----- | ---------- | --------------------- | | **25 anos** | 52,5% | 22,5% | 25% | Crescimento agressivo | | **35 anos** | 39% | 26% | 35% | Crescimento moderado | | **45 anos** | 27,5% | 27,5% | 45% | Equilíbrio | | **55 anos** | 18% | 27% | 55% | Preservação + renda | | **65 anos** | 10,5% | 24,5% | 65% | Renda passiva | **Lógica:** * **Renda Variável (RV):** 100 - idade (mínimo 20%, máximo 80%) * **Dentro de RV:** Quanto mais jovem, mais ações. Quanto mais velho, mais FIIs * **FIIs aumentam** proporcionalmente com a idade para gerar renda mensal ### Alocação por Objetivo | Objetivo | Ações | FIIs | Renda Fixa | | ------------------------- | ----- | ---- | ---------- | | **Crescimento agressivo** | 60% | 20% | 20% | | **Crescimento moderado** | 45% | 30% | 25% | | **Renda + Crescimento** | 30% | 40% | 30% | | **Renda passiva** | 20% | 50% | 30% | | **Preservação** | 15% | 25% | 60% | ## Checklist: Como Decidir ### Perguntas para Reflexão **Sobre seu perfil:** * [ ] Qual sua tolerância a ver patrimônio cair 30-50%? * [ ] Quanto tempo tem para acompanhar investimentos? * [ ] Prefere renda mensal ou valorização? * [ ] Qual seu horizonte de investimento? **Sobre seus objetivos:** * [ ] Está em fase de acumulação ou usufruto? * [ ] Precisa de renda passiva agora? * [ ] Quer diversificação imobiliária? * [ ] Busca proteção contra inflação? **Sobre o mercado:** * [ ] Como está a taxa de juros (Selic)? * [ ] FIIs estão com desconto no P/VP? * [ ] Bolsa está barata (P/L histórico)? ## Monitorando sua Carteira ### API brapi.dev para Acompanhamento ```typescript const headers = { 'Authorization': 'Bearer SEU_TOKEN' } // Ações: cotações e dividendos via /api/quote const acoes = await fetch( 'https://brapi.dev/api/quote/PETR4,VALE3?dividends=true', { headers } ).then(r => r.json()) // FIIs: indicadores detalhados via endpoint especializado const fiis = await fetch( 'https://brapi.dev/api/v2/fii/indicators?symbols=HGLG11,XPLG11', { headers } ).then(r => r.json()) // Combinar para calcular valor total e dividendos por classe ``` #### Exemplo de Carteira Híbrida Monitorada | Ativo | Tipo | Quantidade | Preço | Valor | DY Estimado | | --------- | ---- | ---------- | --------- | ------------- | ----------- | | PETR4 | Ação | 100 | R$ 38,00 | R$ 3.800 | 8% | | VALE3 | Ação | 50 | R$ 62,00 | R$ 3.100 | 7% | | HGLG11 | FII | 30 | R$ 160,00 | R$ 4.800 | 9% | | XPLG11 | FII | 40 | R$ 105,00 | R$ 4.200 | 10% | | **Total** | - | - | - | **R$ 15.900** | - | **Alocação atual:** Ações 43% / FIIs 57%\ **Dividendos anuais estimados:** R$ 1.350 (8,5% médio) ## Perguntas Frequentes ### Posso ter ações e FIIs na mesma carteira? Sim, é uma estratégia comum e recomendada para diversificação. Muitos investidores mantêm ambos em proporções diferentes conforme objetivos. ### FIIs são mais seguros que ações? Não necessariamente. Ambos são renda variável com riscos. FIIs tendem a ser menos voláteis no dia a dia, mas também sofrem em crises. ### Qual rende mais no longo prazo? Historicamente, ações tendem a render mais no longo prazo (15-20 anos), mas FIIs oferecem renda mais constante. A resposta depende do período analisado. ### Devo reinvestir os dividendos? Depende do objetivo. Em fase de acumulação, reinvestir acelera o crescimento. Em fase de usufruto, use para despesas. ### Como declarar ações e FIIs no IR? Ambos devem ser declarados na ficha de Bens e Direitos. Dividendos são isentos e declarados em Rendimentos Isentos. ## Conclusão Não existe resposta única para "ações ou FIIs". A melhor escolha depende de: **Escolha Ações se:** * Busca crescimento de longo prazo * Tolera volatilidade * Quer participar de empresas específicas * Aproveita isenção de R$ 20.000 **Escolha FIIs se:** * Precisa de renda mensal * Prefere menos volatilidade * Quer exposição imobiliária * Valoriza gestão profissional **Ideal: Combine ambos** ajustando a proporção conforme idade, objetivos e tolerância a risco. Use a [API da brapi.dev](https://brapi.dev) para monitorar ambas as classes de ativos em um único dashboard. *** *Disclaimer: Este conteúdo é educacional e não constitui recomendação de investimento. Cada investidor deve avaliar seu perfil antes de tomar decisões.* # Agronegócio na Bolsa 2026: SLC Agrícola (SLCE3) e BrasilAgro (AGRO3) URL: /blog/agronegocio-bolsa-slce3-agro3-analise-2026.mdx Como investir no agronegócio pela bolsa em 2026? Análise de SLCE3, AGRO3 e Fiagros. A tese de valorização da terra e dividendos do campo. *** searchable: true title: 'Agronegócio na Bolsa 2026: SLC Agrícola (SLCE3) e BrasilAgro (AGRO3)' description: 'Como investir no agronegócio pela bolsa em 2026? Análise de SLCE3, AGRO3 e Fiagros. A tese de valorização da terra e dividendos do campo.' date: '2025-12-31' keywords: 'agronegocio bolsa 2026, slce3 vale a pena, agro3 dividendos, fiagro 2026, soja milho preço 2026, terra agrícola valorização' author: 'Equipe brapi.dev' category: 'Ações' subcategory: 'Setores' readingTime: '13 min' tags: \['Agronegócio', 'SLCE3', 'AGRO3', 'Fiagro', 'Commodities', 'Terras'] relatedPosts: \['onde-investir-2026-guia-completo-melhores-investimentos', 'vale3-petr4-commodities-analise-2026', 'fiis-de-papel-vs-tijolo-comparativo-2026'] featured: false expertise: 'Análise do setor mais forte do PIB brasileiro e suas oportunidades no mercado de capitais.' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; O Brasil é o "celeiro do mundo" e o Agronegócio representa quase 30% do nosso PIB. No entanto, por muito tempo, o investidor pessoa física teve dificuldade de acessar esse setor pujante diretamente pela Bolsa. Isso mudou. Em 2026, temos opções consolidadas em ações — como **SLC Agrícola (SLCE3)** e **BrasilAgro (AGRO3)** — e a popularização dos **Fiagros** (Fundos de Investimento nas Cadeias Produtivas Agroindustriais). Neste artigo, vamos analisar como colher os frutos do campo diretamente na sua conta da corretora. *** ## A Tese do Agro: Terras + Commodities Investir em empresas agrícolas envolve entender dois *drivers* de valor principais: 1. **Operação Agrícola (Cash Yield):** O lucro da venda da soja, milho e algodão. Depende do clima (El Niño/La Niña), produtividade e preço internacional das commodities (Chicago). 2. **Imobiliário (Land Appreciation):** A valorização da terra nua. O Brasil é um dos poucos países com fronteira agrícola expansível e produtiva. Transformar terra bruta em terra produtiva gera um valor imenso. *** ## 1. SLC Agrícola (SLCE3): A Máquina de Eficiência A SLC é uma das maiores produtoras de grãos e fibras do mundo, focada em alta escala e tecnologia. * **Modelo de Negócio:** Foca na **operação**. Arrenda muitas terras (Asset Light) e possui terras próprias. É extremamente eficiente no plantio e colheita ("fábrica a céu aberto"). * **Destaque 2026:** A SLC tem focado em reduzir custos e aumentar produtividade por hectare. É uma ação que paga bons dividendos e tem uma gestão considerada referência global. * **Para quem é:** Para quem quer exposição direta ao preço da Soja/Milho/Algodão e à eficiência operacional, com dividendos recorrentes. ## 2. BrasilAgro (AGRO3): A Imobiliária Rural A BrasilAgro tem um modelo diferente. O *core business* dela é **comprar terra barata, desenvolver e vender caro**. A produção agrícola paga as contas enquanto a terra valoriza. * **Modelo de Negócio:** Imobiliário. O lucro explode quando ela vende uma fazenda. * **Destaque 2026:** Em anos de commodities com preços mais baixos, a BrasilAgro pode vender terras para destravar valor e distribuir dividendos extraordinários. É uma proteção contra a inflação (terra real). * **Para quem é:** Para quem busca ganho de capital com valorização imobiliária rural e dividendos "pancada" (não recorrentes, mas gigantes quando ocorrem). *** ## 3. Fiagros: A Renda Mensal do Campo Se as ações são voláteis, os Fiagros surgiram para oferecer renda mensal (como os FIIs), investindo na dívida do agro (CRAs) ou em terras. * **Fiagros de Papel (SNAG11, KNCA11, RURA11, etc.):** Investem em CRAs (Certificados de Recebíveis do Agronegócio). Pagam dividendos isentos de IR, geralmente indexados ao CDI + spread. * **Risco 2026:** Inadimplência. Com juros altos ou quebra de safra, produtores menores podem não pagar suas dívidas. Prefira gestoras renomadas e carteiras pulverizadas. * **Fiagros de Terra:** Compram a terra e arrendam para o produtor. Parecido com FII de tijolo. *** ## Comparativo: SLCE3 vs AGRO3 | Característica | SLC Agrícola (SLCE3) | BrasilAgro (AGRO3) | | :------------------- | :---------------------------- | :------------------------------ | | **Foco Principal** | Produção Agrícola (Commodity) | Venda de Fazendas (Imobiliário) | | **Recorrência** | Alta (Safra anual) | Variável (Depende de vendas) | | **Dividendos** | Consistentes | Voláteis (mas altos na venda) | | **Correlação Dólar** | Alta (Receita exportadora) | Média/Alta | | **Risco Climático** | Alto (Afeta a safra) | Médio (Terra continua lá) | *** ## Análise de Preço de Commodities (Python + Brapi) Para investir em agro, é vital monitorar o preço das commodities. Embora a API da brapi foque em mercado financeiro, o preço das ações SLCE3 e AGRO3 segue de perto os contratos futuros. ```typescript // Performance SLCE3 e AGRO3 nos últimos 12 meses const response = await fetch( 'https://brapi.dev/api/quote/SLCE3,AGRO3?range=1y&interval=1mo', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const { results } = await response.json() // results[].historicalDataPrice contém o histórico mensal // Calcule: ((preço_fim - preço_inicio) / preço_inicio) * 100 ``` *** ## Conclusão: Como Plantar em 2026? O agro é cíclico. * **Ciclo de Alta das Commodities:** SLCE3 brilha, margens explodem. * **Ciclo de Baixa:** Margens apertam, mas terras continuam valorizando no longo prazo (AGRO3 brilha na venda). **Estratégia Recomendada:** Tenha uma pequena exposição (5-10%) ao setor Agro na carteira de ações para diversificação descorrelacionada do "Risco Brasil Urbano". Combine **SLCE3** (para fluxo de caixa) e alguns **Fiagros High Grade** (para renda mensal isenta). O campo não para, e sua carteira também não deveria ignorar o motor do Brasil. *** ## Leia Mais * **[Commodities: Vale e Petrobras](/blog/vale3-petr4-commodities-analise-2026)** * **[FIIs de Papel vs Tijolo](/blog/fiis-de-papel-vs-tijolo-comparativo-2026)** # Alertas de Preço em Tempo Real com Python 2026: Tutorial Completo URL: /blog/alertas-preco-tempo-real-python-tutorial.mdx Aprenda a criar alertas de preço de ações em tempo real com Python e brapi. Tutorial: notificações por email, Telegram, WhatsApp e desktop. *** searchable: true title: 'Alertas de Preço em Tempo Real com Python 2026: Tutorial Completo' description: 'Aprenda a criar alertas de preço de ações em tempo real com Python e brapi. Tutorial: notificações por email, Telegram, WhatsApp e desktop.' date: '2025-12-29' keywords: 'alertas de preco acoes, alerta cotacao tempo real, notificacao preco python, monitorar acoes python, brapi alertas, alerta telegram acoes, 2026' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Automação' readingTime: '15 min' tags: \['Python', 'Alertas', 'Automação', 'API', 'Telegram', 'Email', 'Notificações'] relatedPosts: \['bot-telegram-cotacoes-acoes-python-tutorial', 'stock-screener-python-brapi-filtrar-acoes', 'backtesting-estrategias-python-brapi-guia-completo'] featured: false expertise: 'Equipe técnica especializada em automação e integração de sistemas' lastReviewed: '2026-01-17' -------------------------- import { Authors, Author } from '~/components/Authors'; > Nunca mais perca uma oportunidade de compra ou venda. Neste tutorial, você vai criar um sistema de alertas de preço que monitora suas ações e envia notificações por email, Telegram ou desktop. *** ## O Que Você Vai Criar ``` ┌─────────────────────────────────────────────────────────────┐ │ SISTEMA DE ALERTAS │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Monitoramento │ │ ├─ Preço acima de X │ │ ├─ Preço abaixo de Y │ │ ├─ Variação diária > Z% │ │ └─ Cruzamento de médias │ │ │ │ Notificações │ │ ├─ 📧 Email │ │ ├─ 📱 Telegram │ │ ├─ 💻 Desktop (Windows/Mac/Linux) │ │ └─ 📝 Log em arquivo │ │ │ │ Execução │ │ ├─ Script rodando continuamente │ │ ├─ Cron job (Linux/Mac) │ │ └─ Task Scheduler (Windows) │ │ │ └─────────────────────────────────────────────────────────────┘ ``` *** ## Setup do Ambiente ### Instalação ```bash pip install requests schedule plyer python-telegram-bot ``` ### Estrutura do Projeto ``` price-alerts/ ├── src/ │ ├── alerts/ │ │ ├── base.py # Classe base de alerta │ │ ├── price_alert.py # Alertas de preço │ │ └── technical.py # Alertas técnicos │ ├── notifiers/ │ │ ├── base.py # Interface de notificação │ │ ├── telegram.py # Notificação Telegram │ │ ├── email.py # Notificação Email │ │ └── desktop.py # Notificação Desktop │ └── monitor.py # Monitor principal ├── config.py # Configurações ├── main.py # Script principal └── requirements.txt ``` *** ## Buscando Dados da brapi ### Cliente de Dados ```python import requests from typing import Optional from dataclasses import dataclass @dataclass class StockQuote: """Representa uma cotação de ação""" symbol: str name: str price: float change: float change_percent: float volume: int previous_close: float market_time: str class BrapiClient: """Cliente para API da brapi""" BASE_URL = "https://brapi.dev/api" def __init__(self, token: str): self.token = token def get_quote(self, ticker: str) -> Optional[StockQuote]: """Busca cotação de uma ação""" url = f"{self.BASE_URL}/quote/{ticker}" params = {"token": self.token} try: response = requests.get(url, params=params, timeout=10) response.raise_for_status() data = response.json() if not data.get("results"): return None result = data["results"][0] return StockQuote( symbol=result.get("symbol", ticker), name=result.get("longName", result.get("shortName", "")), price=result.get("regularMarketPrice", 0), change=result.get("regularMarketChange", 0), change_percent=result.get("regularMarketChangePercent", 0), volume=result.get("regularMarketVolume", 0), previous_close=result.get("regularMarketPreviousClose", 0), market_time=result.get("regularMarketTime", "") ) except Exception as e: print(f"Erro ao buscar {ticker}: {e}") return None def get_multiple_quotes(self, tickers: list[str]) -> dict[str, StockQuote]: """Busca cotação de múltiplas ações""" # Juntar tickers com vírgula tickers_str = ",".join(tickers) url = f"{self.BASE_URL}/quote/{tickers_str}" params = {"token": self.token} try: response = requests.get(url, params=params, timeout=10) response.raise_for_status() data = response.json() quotes = {} for result in data.get("results", []): symbol = result.get("symbol", "") quotes[symbol] = StockQuote( symbol=symbol, name=result.get("longName", result.get("shortName", "")), price=result.get("regularMarketPrice", 0), change=result.get("regularMarketChange", 0), change_percent=result.get("regularMarketChangePercent", 0), volume=result.get("regularMarketVolume", 0), previous_close=result.get("regularMarketPreviousClose", 0), market_time=result.get("regularMarketTime", "") ) return quotes except Exception as e: print(f"Erro ao buscar cotações: {e}") return {} # Teste if __name__ == "__main__": client = BrapiClient("seu_token") quote = client.get_quote("PETR4") print(f"{quote.symbol}: R$ {quote.price:.2f} ({quote.change_percent:+.2f}%)") ``` *** ## Sistema de Alertas ### Classe Base ```python # src/alerts/base.py from abc import ABC, abstractmethod from dataclasses import dataclass from typing import Optional from enum import Enum class AlertType(Enum): PRICE_ABOVE = "price_above" PRICE_BELOW = "price_below" CHANGE_PERCENT = "change_percent" VOLUME_SPIKE = "volume_spike" CROSSING_UP = "crossing_up" CROSSING_DOWN = "crossing_down" @dataclass class AlertTrigger: """Resultado de um alerta disparado""" ticker: str alert_type: AlertType message: str current_value: float threshold: float triggered_at: str class Alert(ABC): """Classe base para alertas""" def __init__( self, ticker: str, alert_type: AlertType, threshold: float, enabled: bool = True, one_time: bool = False ): self.ticker = ticker self.alert_type = alert_type self.threshold = threshold self.enabled = enabled self.one_time = one_time self.triggered = False @abstractmethod def check(self, quote) -> Optional[AlertTrigger]: """Verifica se o alerta deve ser disparado""" pass def reset(self): """Reseta o estado do alerta""" self.triggered = False ``` ### Alertas de Preço ```python # src/alerts/price_alert.py from datetime import datetime from typing import Optional from .base import Alert, AlertType, AlertTrigger class PriceAboveAlert(Alert): """Alerta quando preço ultrapassa valor""" def __init__(self, ticker: str, threshold: float, **kwargs): super().__init__(ticker, AlertType.PRICE_ABOVE, threshold, **kwargs) def check(self, quote) -> Optional[AlertTrigger]: if not self.enabled or (self.one_time and self.triggered): return None if quote.price > self.threshold: self.triggered = True return AlertTrigger( ticker=self.ticker, alert_type=self.alert_type, message=f"🚀 {self.ticker} ultrapassou R$ {self.threshold:.2f}! Preço atual: R$ {quote.price:.2f}", current_value=quote.price, threshold=self.threshold, triggered_at=datetime.now().isoformat() ) return None class PriceBelowAlert(Alert): """Alerta quando preço cai abaixo de valor""" def __init__(self, ticker: str, threshold: float, **kwargs): super().__init__(ticker, AlertType.PRICE_BELOW, threshold, **kwargs) def check(self, quote) -> Optional[AlertTrigger]: if not self.enabled or (self.one_time and self.triggered): return None if quote.price < self.threshold: self.triggered = True return AlertTrigger( ticker=self.ticker, alert_type=self.alert_type, message=f"📉 {self.ticker} caiu abaixo de R$ {self.threshold:.2f}! Preço atual: R$ {quote.price:.2f}", current_value=quote.price, threshold=self.threshold, triggered_at=datetime.now().isoformat() ) return None class ChangePercentAlert(Alert): """Alerta quando variação diária excede percentual""" def __init__(self, ticker: str, threshold: float, **kwargs): super().__init__(ticker, AlertType.CHANGE_PERCENT, threshold, **kwargs) def check(self, quote) -> Optional[AlertTrigger]: if not self.enabled or (self.one_time and self.triggered): return None if abs(quote.change_percent) >= self.threshold: self.triggered = True direction = "📈 subiu" if quote.change_percent > 0 else "📉 caiu" return AlertTrigger( ticker=self.ticker, alert_type=self.alert_type, message=f"{self.ticker} {direction} {abs(quote.change_percent):.2f}% hoje! Preço: R$ {quote.price:.2f}", current_value=quote.change_percent, threshold=self.threshold, triggered_at=datetime.now().isoformat() ) return None class VolumeSpikeAlert(Alert): """Alerta quando volume é muito acima do normal""" def __init__(self, ticker: str, threshold: float, avg_volume: int, **kwargs): super().__init__(ticker, AlertType.VOLUME_SPIKE, threshold, **kwargs) self.avg_volume = avg_volume def check(self, quote) -> Optional[AlertTrigger]: if not self.enabled or (self.one_time and self.triggered): return None if self.avg_volume > 0: volume_ratio = quote.volume / self.avg_volume if volume_ratio >= self.threshold: self.triggered = True return AlertTrigger( ticker=self.ticker, alert_type=self.alert_type, message=f"📊 {self.ticker} com volume {volume_ratio:.1f}x acima da média! Volume: {quote.volume:,}", current_value=volume_ratio, threshold=self.threshold, triggered_at=datetime.now().isoformat() ) return None ``` *** ## Sistema de Notificações ### Interface Base ```python # src/notifiers/base.py from abc import ABC, abstractmethod from src.alerts.base import AlertTrigger class Notifier(ABC): """Interface para notificadores""" @abstractmethod def send(self, trigger: AlertTrigger) -> bool: """Envia notificação. Retorna True se sucesso.""" pass ``` ### Notificação Desktop ```python # src/notifiers/desktop.py from plyer import notification from .base import Notifier from src.alerts.base import AlertTrigger class DesktopNotifier(Notifier): """Notificação desktop (Windows/Mac/Linux)""" def __init__(self, app_name: str = "Alertas de Ações"): self.app_name = app_name def send(self, trigger: AlertTrigger) -> bool: try: notification.notify( title=f"Alerta: {trigger.ticker}", message=trigger.message, app_name=self.app_name, timeout=10 ) return True except Exception as e: print(f"Erro na notificação desktop: {e}") return False ``` ### Notificação Telegram ```python # src/notifiers/telegram.py import requests from .base import Notifier from src.alerts.base import AlertTrigger class TelegramNotifier(Notifier): """Notificação via Telegram""" def __init__(self, bot_token: str, chat_id: str): self.bot_token = bot_token self.chat_id = chat_id self.api_url = f"https://api.telegram.org/bot{bot_token}" def send(self, trigger: AlertTrigger) -> bool: try: url = f"{self.api_url}/sendMessage" # Formatar mensagem message = f""" 🔔 *ALERTA DE PREÇO* *{trigger.ticker}* {trigger.message} ⏰ {trigger.triggered_at} """ payload = { "chat_id": self.chat_id, "text": message, "parse_mode": "Markdown" } response = requests.post(url, json=payload, timeout=10) return response.status_code == 200 except Exception as e: print(f"Erro na notificação Telegram: {e}") return False # Como obter bot_token e chat_id: """ 1. Crie um bot com @BotFather no Telegram - Envie /newbot - Siga as instruções - Copie o token fornecido 2. Obtenha seu chat_id: - Inicie conversa com seu bot - Acesse: https://api.telegram.org/bot/getUpdates - Procure "chat":{"id": 123456789} """ ``` ### Notificação Email ```python # src/notifiers/email.py import smtplib from email.mime.text import MIMEText from email.mime.multipart import MIMEMultipart from .base import Notifier from src.alerts.base import AlertTrigger class EmailNotifier(Notifier): """Notificação via Email""" def __init__( self, smtp_server: str, smtp_port: int, sender_email: str, sender_password: str, recipient_email: str ): self.smtp_server = smtp_server self.smtp_port = smtp_port self.sender_email = sender_email self.sender_password = sender_password self.recipient_email = recipient_email def send(self, trigger: AlertTrigger) -> bool: try: # Criar mensagem msg = MIMEMultipart("alternative") msg["Subject"] = f"🔔 Alerta: {trigger.ticker}" msg["From"] = self.sender_email msg["To"] = self.recipient_email # Corpo do email text_content = f""" ALERTA DE PREÇO Ticker: {trigger.ticker} {trigger.message} Valor atual: R$ {trigger.current_value:.2f} Limite configurado: R$ {trigger.threshold:.2f} Hora: {trigger.triggered_at} --- Sistema de Alertas brapi.dev """ html_content = f"""

🔔 Alerta de Preço

Ticker:{trigger.ticker}
Mensagem:{trigger.message}
Valor atual:R$ {trigger.current_value:.2f}
Limite:R$ {trigger.threshold:.2f}
Hora:{trigger.triggered_at}

Sistema de Alertas brapi.dev

""" msg.attach(MIMEText(text_content, "plain")) msg.attach(MIMEText(html_content, "html")) # Enviar with smtplib.SMTP(self.smtp_server, self.smtp_port) as server: server.starttls() server.login(self.sender_email, self.sender_password) server.sendmail( self.sender_email, self.recipient_email, msg.as_string() ) return True except Exception as e: print(f"Erro na notificação Email: {e}") return False # Configuração para Gmail: """ smtp_server = "smtp.gmail.com" smtp_port = 587 sender_email = "seu_email@gmail.com" sender_password = "sua_senha_de_app" # Não é a senha normal! Para criar senha de app no Gmail: 1. Ative 2FA em sua conta Google 2. Acesse: https://myaccount.google.com/apppasswords 3. Gere uma senha para "Mail" """ ``` *** ## Monitor Principal ### Implementação ```python # src/monitor.py import time import logging from datetime import datetime from typing import Optional from src.data_client import BrapiClient from src.alerts.base import Alert, AlertTrigger from src.notifiers.base import Notifier # Configurar logging logging.basicConfig( level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s", handlers=[ logging.FileHandler("alerts.log"), logging.StreamHandler() ] ) logger = logging.getLogger(__name__) class PriceMonitor: """Monitor de preços com alertas""" def __init__( self, brapi_token: str, notifiers: list[Notifier] = None, check_interval: int = 60 # segundos ): self.client = BrapiClient(brapi_token) self.notifiers = notifiers or [] self.check_interval = check_interval self.alerts: list[Alert] = [] self.running = False def add_alert(self, alert: Alert): """Adiciona um alerta""" self.alerts.append(alert) logger.info(f"Alerta adicionado: {alert.ticker} - {alert.alert_type.value}") def remove_alert(self, ticker: str, alert_type = None): """Remove alertas por ticker""" self.alerts = [ a for a in self.alerts if not (a.ticker == ticker and (alert_type is None or a.alert_type == alert_type)) ] def add_notifier(self, notifier: Notifier): """Adiciona um notificador""" self.notifiers.append(notifier) def _notify(self, trigger: AlertTrigger): """Envia notificação por todos os canais""" for notifier in self.notifiers: try: success = notifier.send(trigger) if success: logger.info(f"Notificação enviada: {type(notifier).__name__}") else: logger.warning(f"Falha na notificação: {type(notifier).__name__}") except Exception as e: logger.error(f"Erro ao notificar: {e}") def check_alerts(self): """Verifica todos os alertas""" # Agrupar tickers únicos tickers = list(set(a.ticker for a in self.alerts if a.enabled)) if not tickers: return # Buscar cotações quotes = self.client.get_multiple_quotes(tickers) # Verificar cada alerta for alert in self.alerts: if not alert.enabled: continue quote = quotes.get(alert.ticker) if not quote: continue trigger = alert.check(quote) if trigger: logger.info(f"ALERTA DISPARADO: {trigger.message}") self._notify(trigger) # Desativar se for one-time if alert.one_time: alert.enabled = False def run(self): """Inicia o monitoramento""" self.running = True logger.info(f"Monitor iniciado. Verificando a cada {self.check_interval}s") logger.info(f"Alertas ativos: {len([a for a in self.alerts if a.enabled])}") while self.running: try: self.check_alerts() except Exception as e: logger.error(f"Erro no ciclo de verificação: {e}") time.sleep(self.check_interval) def stop(self): """Para o monitoramento""" self.running = False logger.info("Monitor parado") def status(self) -> dict: """Retorna status do monitor""" return { "running": self.running, "total_alerts": len(self.alerts), "active_alerts": len([a for a in self.alerts if a.enabled]), "notifiers": len(self.notifiers), "check_interval": self.check_interval } ``` *** ## Script Principal ### Configuração e Execução ```python # config.py import os # Token da brapi (obtenha em https://brapi.dev) BRAPI_TOKEN = os.getenv("BRAPI_TOKEN", "seu_token_aqui") # Telegram (opcional) TELEGRAM_BOT_TOKEN = os.getenv("TELEGRAM_BOT_TOKEN", "") TELEGRAM_CHAT_ID = os.getenv("TELEGRAM_CHAT_ID", "") # Email (opcional) EMAIL_CONFIG = { "smtp_server": "smtp.gmail.com", "smtp_port": 587, "sender_email": os.getenv("EMAIL_SENDER", ""), "sender_password": os.getenv("EMAIL_PASSWORD", ""), "recipient_email": os.getenv("EMAIL_RECIPIENT", "") } # Intervalo de verificação em segundos CHECK_INTERVAL = 60 # Alertas configurados ALERTS_CONFIG = [ # Preço acima {"type": "price_above", "ticker": "PETR4", "threshold": 40.00}, {"type": "price_above", "ticker": "VALE3", "threshold": 70.00}, # Preço abaixo {"type": "price_below", "ticker": "PETR4", "threshold": 30.00}, {"type": "price_below", "ticker": "ITUB4", "threshold": 28.00}, # Variação diária {"type": "change_percent", "ticker": "MGLU3", "threshold": 5.0}, {"type": "change_percent", "ticker": "PETR4", "threshold": 3.0}, ] ``` ```python # main.py from config import * from src.monitor import PriceMonitor from src.alerts.price_alert import ( PriceAboveAlert, PriceBelowAlert, ChangePercentAlert ) from src.notifiers.desktop import DesktopNotifier from src.notifiers.telegram import TelegramNotifier from src.notifiers.email import EmailNotifier def create_alert(config: dict): """Cria alerta a partir de configuração""" alert_type = config["type"] ticker = config["ticker"] threshold = config["threshold"] if alert_type == "price_above": return PriceAboveAlert(ticker, threshold) elif alert_type == "price_below": return PriceBelowAlert(ticker, threshold) elif alert_type == "change_percent": return ChangePercentAlert(ticker, threshold) else: raise ValueError(f"Tipo de alerta desconhecido: {alert_type}") def main(): print(""" ╔═══════════════════════════════════════════╗ ║ SISTEMA DE ALERTAS DE PREÇO ║ ║ brapi.dev ║ ╚═══════════════════════════════════════════╝ """) # Criar monitor monitor = PriceMonitor( brapi_token=BRAPI_TOKEN, check_interval=CHECK_INTERVAL ) # Adicionar notificadores monitor.add_notifier(DesktopNotifier()) if TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID: monitor.add_notifier(TelegramNotifier( bot_token=TELEGRAM_BOT_TOKEN, chat_id=TELEGRAM_CHAT_ID )) print("✓ Notificações Telegram ativadas") if EMAIL_CONFIG["sender_email"]: monitor.add_notifier(EmailNotifier(**EMAIL_CONFIG)) print("✓ Notificações Email ativadas") # Adicionar alertas for config in ALERTS_CONFIG: alert = create_alert(config) monitor.add_alert(alert) print(f"\n📊 Alertas configurados: {len(ALERTS_CONFIG)}") print(f"⏱️ Intervalo de verificação: {CHECK_INTERVAL}s") print("\nPressione Ctrl+C para parar\n") # Iniciar monitoramento try: monitor.run() except KeyboardInterrupt: print("\n\nEncerrando...") monitor.stop() if __name__ == "__main__": main() ``` *** ## Interface de Linha de Comando ### CLI Interativa ```python # cli.py import argparse import json from src.monitor import PriceMonitor from src.data_client import BrapiClient from src.alerts.price_alert import PriceAboveAlert, PriceBelowAlert, ChangePercentAlert from src.notifiers.desktop import DesktopNotifier from config import BRAPI_TOKEN def cmd_quote(args): """Mostra cotação atual""" client = BrapiClient(BRAPI_TOKEN) for ticker in args.tickers: quote = client.get_quote(ticker) if quote: print(f"{quote.symbol}: R$ {quote.price:.2f} ({quote.change_percent:+.2f}%)") else: print(f"{ticker}: Não encontrado") def cmd_watch(args): """Monitora preço com alerta""" monitor = PriceMonitor(BRAPI_TOKEN, check_interval=args.interval) monitor.add_notifier(DesktopNotifier()) if args.above: monitor.add_alert(PriceAboveAlert(args.ticker, args.above)) print(f"Alerta: {args.ticker} > R$ {args.above:.2f}") if args.below: monitor.add_alert(PriceBelowAlert(args.ticker, args.below)) print(f"Alerta: {args.ticker} < R$ {args.below:.2f}") if args.change: monitor.add_alert(ChangePercentAlert(args.ticker, args.change)) print(f"Alerta: {args.ticker} variação > {args.change}%") print(f"\nMonitorando... (Ctrl+C para parar)") try: monitor.run() except KeyboardInterrupt: monitor.stop() def main(): parser = argparse.ArgumentParser(description="Sistema de Alertas de Preço") subparsers = parser.add_subparsers(dest="command") # Comando: quote quote_parser = subparsers.add_parser("quote", help="Mostra cotação") quote_parser.add_argument("tickers", nargs="+", help="Códigos das ações") # Comando: watch watch_parser = subparsers.add_parser("watch", help="Monitora com alertas") watch_parser.add_argument("ticker", help="Código da ação") watch_parser.add_argument("--above", type=float, help="Alerta se preço acima de X") watch_parser.add_argument("--below", type=float, help="Alerta se preço abaixo de X") watch_parser.add_argument("--change", type=float, help="Alerta se variação > X%") watch_parser.add_argument("--interval", type=int, default=60, help="Intervalo em segundos") args = parser.parse_args() if args.command == "quote": cmd_quote(args) elif args.command == "watch": cmd_watch(args) else: parser.print_help() if __name__ == "__main__": main() ``` **Uso:** ```bash # Ver cotação python cli.py quote PETR4 VALE3 ITUB4 # Monitorar com alerta python cli.py watch PETR4 --above 40 --below 30 # Monitorar variação python cli.py watch MGLU3 --change 5 --interval 30 ``` *** ## Executando em Background ### Linux/Mac (Cron) ```bash # Editar crontab crontab -e # Executar a cada 5 minutos durante horário de pregão (10h-18h) */5 10-17 * * 1-5 /usr/bin/python3 /caminho/para/main.py >> /var/log/alerts.log 2>&1 ``` ### Linux (Systemd Service) ```ini # /etc/systemd/system/price-alerts.service [Unit] Description=Price Alerts Service After=network.target [Service] Type=simple User=seu_usuario WorkingDirectory=/caminho/para/price-alerts ExecStart=/usr/bin/python3 main.py Restart=always RestartSec=10 [Install] WantedBy=multi-user.target ``` ```bash # Ativar serviço sudo systemctl enable price-alerts sudo systemctl start price-alerts sudo systemctl status price-alerts ``` ### Windows (Task Scheduler) 1. Abra o Agendador de Tarefas 2. Criar Tarefa Básica 3. Nome: "Alertas de Preço" 4. Disparador: Diariamente, repetir a cada 5 minutos 5. Ação: Iniciar programa * Programa: `python.exe` * Argumentos: `C:\caminho\para\main.py` * Iniciar em: `C:\caminho\para\` *** ## Alertas Avançados ### Cruzamento de Médias Móveis ```python # src/alerts/technical.py from typing import Optional from collections import deque from .base import Alert, AlertType, AlertTrigger class MovingAverageCrossAlert(Alert): """Alerta de cruzamento de médias móveis""" def __init__( self, ticker: str, short_period: int = 20, long_period: int = 50, **kwargs ): super().__init__(ticker, AlertType.CROSSING_UP, 0, **kwargs) self.short_period = short_period self.long_period = long_period self.prices = deque(maxlen=long_period + 1) self.last_short_above = None def check(self, quote) -> Optional[AlertTrigger]: if not self.enabled: return None # Adicionar preço self.prices.append(quote.price) # Precisa de dados suficientes if len(self.prices) < self.long_period: return None # Calcular médias prices_list = list(self.prices) short_ma = sum(prices_list[-self.short_period:]) / self.short_period long_ma = sum(prices_list) / self.long_period short_above = short_ma > long_ma # Detectar cruzamento if self.last_short_above is not None: if short_above and not self.last_short_above: # Cruzamento para cima (golden cross) self.last_short_above = short_above return AlertTrigger( ticker=self.ticker, alert_type=AlertType.CROSSING_UP, message=f"📈 {self.ticker}: Média de {self.short_period} cruzou ACIMA da média de {self.long_period}!", current_value=quote.price, threshold=0, triggered_at=quote.market_time ) elif not short_above and self.last_short_above: # Cruzamento para baixo (death cross) self.last_short_above = short_above return AlertTrigger( ticker=self.ticker, alert_type=AlertType.CROSSING_DOWN, message=f"📉 {self.ticker}: Média de {self.short_period} cruzou ABAIXO da média de {self.long_period}!", current_value=quote.price, threshold=0, triggered_at=quote.market_time ) self.last_short_above = short_above return None ``` *** ## FAQ ### Qual o intervalo ideal de verificação? | Perfil | Intervalo | Uso | | ------------ | --------- | ------------------ | | Day trader | 10-30s | Scalping, momentum | | Swing trader | 1-5 min | Entradas/saídas | | Investidor | 15-60 min | Oportunidades | ### Posso rodar 24/7? Sim, mas considere: * Mercado de ações brasileiras funciona 10h-17h (horário normal) * Fora do pregão, preços não mudam * Use cron para rodar apenas no horário de mercado ### Como evitar alertas duplicados? Use o parâmetro `one_time=True` ou implemente cooldown: ```python class AlertWithCooldown(Alert): def __init__(self, cooldown_minutes: int = 30, **kwargs): super().__init__(**kwargs) self.cooldown = cooldown_minutes * 60 self.last_trigger = 0 def check(self, quote): import time if time.time() - self.last_trigger < self.cooldown: return None trigger = super().check(quote) if trigger: self.last_trigger = time.time() return trigger ``` *** ## Conclusão Você agora tem um sistema completo de alertas de preço que: 1. ✅ Monitora múltiplas ações simultaneamente 2. ✅ Suporta alertas de preço, variação e volume 3. ✅ Envia notificações por desktop, Telegram e email 4. ✅ Pode rodar em background continuamente 5. ✅ É extensível para alertas técnicos avançados *** ## Próximos Passos * **[Cadastre-se na brapi](https://brapi.dev)** para obter seu token * **[Bot de Telegram](/blog/bot-telegram-cotacoes-acoes-python-tutorial)** para interface completa * **[Stock screener](/blog/stock-screener-python-brapi-filtrar-acoes)** para encontrar ações * **[Backtesting](/blog/backtesting-estrategias-python-brapi-guia-completo)** para testar estratégias *** *Este artigo tem caráter educacional. Alertas não substituem análise de investimentos.* # Alocação de ativos por idade: use a regra sem cair na fórmula URL: /blog/alocacao-de-ativos-por-idade-carteira-ideal-2026.mdx Idade ajuda a pensar no risco, mas prazo, renda e objetivos importam mais. Veja exemplos simples de alocação. *** searchable: true title: 'Alocação de ativos por idade: use a regra sem cair na fórmula' description: 'Idade ajuda a pensar no risco, mas prazo, renda e objetivos importam mais. Veja exemplos simples de alocação.' date: '2026-01-01' keywords: 'alocação de ativos por idade, carteira de investimentos por idade, quanto investir em ações, renda fixa ou variável, diversificação por idade' author: 'Alisson Leal' category: 'Estratégias' subcategory: 'Alocação' readingTime: '9 min' tags: \['Alocação de Ativos', 'Estratégias', 'Diversificação', 'Carteira'] relatedPosts: \['como-comecar-investir-do-zero-guia-iniciantes-2026', 'rebalanceamento-carteira-como-quando-fazer-2026', 'renda-fixa-vs-renda-variavel-2026', 'guia-bogleheads-brasil-investimento-passivo-etfs'] featured: true expertise: 'Alocação de ativos e carteiras de longo prazo' lastReviewed: '2026-06-23' faqSchema: * question: 'A regra de 100 menos a idade funciona?' answer: 'Ela pode iniciar a conversa, mas não define uma carteira. Prazo dos objetivos, estabilidade da renda, reserva e tolerância a perdas também precisam entrar na decisão.' * question: 'A reserva de emergência entra na alocação?' answer: 'É mais claro tratar a reserva separadamente. Ela existe para liquidez e segurança, não para cumprir o percentual da carteira de longo prazo.' * question: 'Quando devo reduzir o risco da carteira?' answer: 'Reduza o risco quando o uso do dinheiro estiver mais próximo, quando sua capacidade de suportar perdas cair ou quando sua situação financeira mudar.' *** import { Authors, Author } from '~/components/Authors'; A regra "100 menos a idade" tenta responder quanto da carteira deveria ficar em ações. Uma pessoa de 30 anos teria 70% em renda variável. Aos 60, teria 40%. É uma referência fácil de lembrar. Também é fácil levar a sério demais. Duas pessoas com a mesma idade podem precisar de carteiras opostas. Uma tem emprego estável, reserva pronta e investe para daqui a 30 anos. A outra pretende comprar uma casa em três anos e depende de renda variável. ## O que a idade consegue dizer Em geral, quem tem muitas décadas antes de usar o dinheiro pode esperar a recuperação de uma queda. Quem já depende da carteira precisa de mais liquidez e menos oscilação. Essa lógica faz sentido. O erro é transformar idade em resposta pronta. Use a idade como uma pergunta: "quanto tempo tenho para me recuperar?". Depois olhe o resto. ## As quatro perguntas que importam mais ### Quando o dinheiro será usado? O prazo é o primeiro filtro. Dinheiro para o próximo ano não deveria depender da bolsa. Dinheiro para aposentadoria em 25 anos pode aceitar mais oscilação. ### Sua renda é estável? Quem tem renda instável costuma precisar de uma reserva maior e de mais proteção. A carteira não pode virar o caixa do mês ruim. ### Quanto de queda você suporta? Não pense na resposta ideal. Pense no que você fez na última crise ou no que faria ao ver R$ 100 mil virarem R$ 70 mil. Se a resposta for vender, a parcela de risco está alta demais. ### Existem outras fontes de renda? INSS, previdência, aluguel e trabalho parcial mudam quanto você dependerá da carteira. Mas não conte com renda incerta ou herança futura como se já estivesse disponível. ## Três exemplos, não três receitas Os percentuais abaixo servem para visualizar escolhas. Eles não são recomendação. ### Horizonte longo e renda estável Uma carteira assim pode servir a alguém de 30 ou 50 anos. O que manda é o horizonte e a capacidade de risco. ### Objetivos divididos entre médio e longo prazo Aqui, a renda fixa pode ser separada por vencimento. A parte de curto prazo pede liquidez. A parte de longo prazo pode usar títulos alinhados aos objetivos. ### Uso próximo ou dependência da carteira Ter alguma renda variável ainda pode ajudar uma aposentadoria longa. O tamanho dessa parcela depende de gastos, outras rendas e flexibilidade para reduzir retiradas em anos ruins. ## E as regras de 100, 110 ou 120? As três usam a mesma conta: ```text Percentual em ações = número base menos idade ``` Trocar 100 por 120 apenas aumenta o risco sugerido. A fórmula não sabe se você: * tem dívida; * vai usar o dinheiro em dois anos; * sustenta outras pessoas; * recebe renda variável; * vende quando a bolsa cai. Use o resultado como comparação, não como ordem. ## Separe a reserva da carteira Tratar a reserva de emergência como parte da renda fixa da aposentadoria confunde duas funções. A reserva precisa estar disponível para imprevistos. A renda fixa de longo prazo pode ter vencimentos maiores e oscilar antes deles. Mantenha as contas separadas: 1. reserva para emergências; 2. dinheiro para objetivos com data; 3. carteira de longo prazo. Isso evita usar um único percentual para necessidades diferentes. ## O que entra em cada parte Uma alocação simples pode usar: | Parte | Função | Exemplos | | ----------------------- | -------------------------- | -------------------------------------- | | Caixa e reserva | Liquidez | Tesouro Selic, CDB com liquidez diária | | Renda fixa de objetivos | Preservar e casar prazos | Títulos com vencimento compatível | | Renda variável | Crescimento de longo prazo | ETFs amplos do Brasil e do exterior | FIIs e ações pagadoras de dividendos continuam sendo renda variável. Renda mensal não transforma um ativo em seguro. ## Como reduzir o risco ao longo do tempo Você não precisa mudar a carteira em todo aniversário. Revise quando: * um objetivo se aproximar; * sua renda ficar menos estável; * você passar a depender dos investimentos; * uma mudança familiar alterar despesas; * a alocação se afastar muito da meta. Se a aposentadoria está a dez anos, por exemplo, você pode transferir aos poucos o dinheiro dos primeiros anos de gastos para renda fixa. Isso é mais útil do que reduzir um ponto percentual de ações por ano só porque a fórmula mandou. ## Rebalanceamento Suponha uma meta de 50% em ações e 50% em renda fixa. Depois de uma alta, as ações chegam a 58%. Direcione novos aportes para renda fixa. Se isso não resolver, rebalanceie vendendo uma parte da classe acima da meta. Uma revisão anual ou uma faixa de tolerância, como cinco pontos percentuais, costuma ser mais prática do que ajustes constantes. ## Um processo melhor que a fórmula 1. Separe a reserva. 2. Liste objetivos e datas. 3. Defina quanto de queda cada objetivo suporta. 4. Escolha uma divisão inicial. 5. Simule uma queda forte na parte de ações. 6. Reduza o risco se você não conseguiria manter o plano. 7. Revise uma vez por ano ou quando a vida mudar. A carteira certa não é a mais agressiva que uma tabela permite. É a que atende seus prazos e continua de pé quando o mercado fica ruim. Para montar a base, veja [como começar a investir do zero](/blog/como-comecar-investir-do-zero-guia-iniciantes-2026). Para uma estratégia simples de longo prazo, leia o [guia Bogleheads](/blog/guia-bogleheads-brasil-investimento-passivo-etfs). *Conteúdo educacional. Não é recomendação de investimento.* # Altcoins Promissoras 2026: Análise Completa de XRP, Cardano, Polkadot e Chainlink URL: /blog/altcoins-promissoras-analise-2026.mdx Altcoins promissoras 2026 no Brasil. Análise de XRP, Cardano (ADA), Polkadot (DOT) e Chainlink (LINK) ✓ *** searchable: true title: 'Altcoins Promissoras 2026: Análise Completa de XRP, Cardano, Polkadot e Chainlink' description: 'Altcoins promissoras 2026 no Brasil. Análise de XRP, Cardano (ADA), Polkadot (DOT) e Chainlink (LINK) ✓' date: '2026-01-01' keywords: 'altcoins promissoras 2026, XRP brasil, cardano ADA análise, polkadot DOT investir, chainlink LINK, melhores criptomoedas 2026, altcoins para investir, 2026' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Criptomoedas' readingTime: '22 min' tags: \['Criptomoedas', 'Altcoins', 'XRP', 'Cardano', 'Polkadot', 'Chainlink', 'Análise Fundamentalista'] relatedPosts: \['bitcoin-brasil-como-investir-analise', 'ethereum-eth-guia-completo-brasil-2026', 'solana-sol-guia-completo-brasil-2026', 'como-declarar-criptomoedas-imposto-renda-2026', 'stablecoins-brasil-usdt-brz-drex-guia-2026'] featured: true expertise: 'Análise técnica e fundamentalista elaborada por especialistas em criptoativos com dados de mercado atualizados' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; Enquanto Bitcoin e Ethereum dominam as manchetes, as **altcoins** (criptomoedas alternativas) oferecem oportunidades únicas de investimento para 2026. Neste guia completo, analisamos quatro das altcoins mais promissoras: **XRP**, **Cardano (ADA)**, **Polkadot (DOT)** e **Chainlink (LINK)**. Cada uma dessas criptomoedas resolve problemas específicos do mercado e possui fundamentos sólidos que as diferenciam das milhares de tokens especulativos. Vamos analisar o que torna cada uma delas relevante para investidores brasileiros em 2026. *** ## O que São Altcoins e Por Que Investir? **Altcoins** são todas as criptomoedas que não são Bitcoin. O termo vem de "alternative coins" (moedas alternativas). Enquanto o Bitcoin é considerado "ouro digital" e reserva de valor, as altcoins geralmente oferecem: | Característica | Bitcoin | Altcoins | | ------------------------ | ---------------- | --------------------------- | | Propósito | Reserva de valor | Funcionalidades específicas | | Volatilidade | Moderada | Alta | | Potencial de valorização | Moderado | Alto (com maior risco) | | Maturidade | 16+ anos | Variável | | Adoção institucional | Alta | Crescente | ### Por Que Considerar Altcoins em 2026? 1. **Diversificação**: Não colocar todos os ovos na mesma cesta 2. **Casos de uso reais**: Muitas altcoins resolvem problemas específicos 3. **Potencial de crescimento**: Menor capitalização = maior potencial de valorização 4. **Ciclo de mercado**: Historicamente, altcoins performam bem após rallies do Bitcoin ### Ciclo de Mercado Cripto | Fase | Descrição | | ----------------- | ---------------------------------- | | 1. Bitcoin Rally | BTC sobe primeiro | | 2. Ethereum Rally | ETH segue | | 3. Altcoin Season | XRP, ADA, DOT, LINK e outros sobem | **Fluxo de capital:** Fiat → BTC → ETH → Large caps → Small caps *** ## 1. XRP (Ripple): A Criptomoeda dos Pagamentos Internacionais ### O que é XRP? XRP é a criptomoeda nativa da rede **Ripple**, projetada para facilitar transferências internacionais de forma rápida e barata. Diferente do Bitcoin, que é descentralizado, a Ripple Labs é uma empresa que desenvolve soluções de pagamento para bancos e instituições financeiras. ### Dados Fundamentais (Janeiro 2026) | Métrica | Valor | | ----------------------- | ------------------------------------------ | | Ranking por Market Cap | Top 5 | | Mecanismo de Consenso | RPCA (Ripple Protocol Consensus Algorithm) | | Tempo de Transação | 3-5 segundos | | Taxa por Transação | \~$0.0002 | | Fornecimento Máximo | 100 bilhões XRP | | Fornecimento Circulante | \~55 bilhões XRP | ### Caso de Uso: RippleNet e ODL O XRP é usado no **On-Demand Liquidity (ODL)**, sistema que permite que instituições financeiras façam transferências internacionais sem pré-financiamento: ### Como Funciona o ODL (On-Demand Liquidity) | Etapa | Descrição | | ----- | ---------------------------------------------- | | 1 | Banco A (Brasil) envia BRL para exchange local | | 2 | Exchange converte BRL → XRP em segundos | | 3 | XRP é transferido para exchange no destino | | 4 | Exchange converte XRP → JPY (ou outra moeda) | | 5 | Banco B (Japão) recebe JPY | | Método | Tempo | Custo | | ------------------- | -------------- | ------------- | | Tradicional (SWIFT) | 3-5 dias úteis | Taxas altas | | Com XRP (ODL) | 3-5 segundos | Taxas mínimas | ### Vitória Legal SEC vs Ripple Em 2023-2026, a Ripple obteve uma vitória parcial importante contra a SEC (Securities and Exchange Commission) dos EUA. O juiz determinou que vendas de XRP em exchanges **não são títulos mobiliários** (securities), o que abriu caminho para: * Listagem em mais exchanges americanas * Maior confiança institucional * Possível ETF de XRP nos EUA ### Parcerias Relevantes * **SBI Holdings** (Japão): Principal parceiro asiático * **Santander**: Utiliza RippleNet para transferências * **MoneyGram**: Parceria encerrada, mas validou o conceito * **Tranglo**: Pagamentos no Sudeste Asiático * **Bancos centrais**: Pilotos de CBDC em vários países ### Análise: Prós e Contras | Prós | Contras | | ------------------------------- | ---------------------------------------- | | ✅ Velocidade e baixo custo | ❌ Centralização (Ripple Labs controla) | | ✅ Adoção institucional real | ❌ Grande parte do supply está com Ripple | | ✅ Clareza regulatória (pós-SEC) | ❌ Depende de parcerias corporativas | | ✅ Tecnologia comprovada | ❌ Competição de CBDCs | ### Como Acompanhar XRP no Brasil Consulte dados do XRP em tempo real usando a API da brapi: ```ts const response = await fetch( "https://brapi.dev/api/v2/crypto?coin=XRP¤cy=BRL", { headers: { "Authorization": "Bearer SEU_TOKEN" } } ); const data = await response.json(); const xrp = data.coins[0]; console.log({ preco: xrp.regularMarketPrice, variacao24h: xrp.regularMarketChangePercent, marketCap: xrp.marketCap, volume24h: xrp.regularMarketVolume, }); ``` *** ## 2. Cardano (ADA): A Blockchain Acadêmica ### O que é Cardano? **Cardano** é uma blockchain de terceira geração criada por **Charles Hoskinson**, co-fundador do Ethereum. O diferencial do Cardano é sua abordagem **científica**: todo desenvolvimento é baseado em pesquisas acadêmicas revisadas por pares (peer-reviewed). ### Dados Fundamentais (Janeiro 2026) | Métrica | Valor | | ---------------------- | -------------------------- | | Ranking por Market Cap | Top 10 | | Mecanismo de Consenso | Ouroboros (Proof of Stake) | | Tempo de Bloco | \~20 segundos | | Taxa por Transação | \~$0.20-0.50 | | Fornecimento Máximo | 45 bilhões ADA | | Staking APY | \~3-5% | ### Arquitetura em Camadas Cardano usa uma arquitetura de duas camadas: **Camada 1: CSL (Cardano Settlement Layer)** * Transferências de ADA * Registro de transações * Staking e delegação **Camada 2: CCL (Cardano Computation Layer)** * Smart Contracts (Plutus) * dApps * Tokens nativos A separação em camadas permite que Cardano atualize cada parte independentemente, aumentando flexibilidade e segurança. ### Ecossistema e dApps O ecossistema Cardano cresceu significativamente: | Categoria | Projetos Principais | | ----------- | ------------------------------- | | DEXs | Minswap, SundaeSwap, WingRiders | | NFTs | JPG Store, CNFT.io | | Stablecoins | Djed (algorítmica), iUSD | | Lending | Liqwid Finance, Lenfi | | Identity | Atala PRISM | ### Governança: Projeto Voltaire Cardano está implementando governança on-chain através do **Projeto Voltaire**: * **Catalyst**: Fundo de tesouraria para financiar projetos * **Voting**: Holders de ADA votam em propostas * **CIP-1694**: Nova estrutura de governança ### Análise: Prós e Contras | Prós | Contras | | ---------------------------- | ------------------------------------ | | ✅ Base científica sólida | ❌ Desenvolvimento lento | | ✅ Proof of Stake eficiente | ❌ Ecossistema menor que Ethereum | | ✅ Governança descentralizada | ❌ Smart contracts complexos (Plutus) | | ✅ Staking nativo fácil | ❌ Adoção institucional limitada | | ✅ Foco em países emergentes | ❌ TVL baixo comparado a concorrentes | ### Staking de ADA O staking de Cardano é um dos mais acessíveis do mercado: ### Exemplo: Staking de ADA **Investimento:** 10.000 ADA (R$ 25.000) | **APY:** 4% | Ano | ADA Acumulado | Ganho | Valor (preço constante) | | --- | ------------- | ----- | ----------------------- | | 1 | 10.408 | +408 | R$ 26.020 | | 2 | 10.833 | +425 | R$ 27.082 | | 3 | 11.275 | +442 | R$ 28.187 | **Vantagem do staking ADA:** Não há lock-up period. Você pode movimentar a qualquer momento enquanto continua recebendo recompensas a cada epoch (\~5 dias). ```` --- ## 3. Polkadot (DOT): A Internet das Blockchains ### O que é Polkadot? **Polkadot** foi criada por **Gavin Wood**, outro co-fundador do Ethereum. Seu objetivo é resolver o problema de **interoperabilidade**: permitir que diferentes blockchains se comuniquem e compartilhem dados de forma segura. ### Dados Fundamentais (Janeiro 2026) | Métrica | Valor | |---------|-------| | Ranking por Market Cap | Top 15 | | Mecanismo de Consenso | NPoS (Nominated Proof of Stake) | | Tempo de Bloco | ~6 segundos | | Fornecimento | Inflacionário (~10% ao ano) | | Parachains Ativas | 40+ | | Staking APY | ~14-18% | ### Arquitetura: Relay Chain e Parachains **Relay Chain (Principal):** Responsável pela segurança e consenso de toda a rede. **Parachains (Conectadas):** Blockchains especializadas que herdam segurança da Relay Chain: - Acala (DeFi) - Moonbeam (EVM compatível) - Astar (dApps) **Bridges:** Conexões com outras redes como Ethereum e Bitcoin. A arquitetura permite que cada parachain seja otimizada para seu caso de uso específico, enquanto compartilham segurança e interoperabilidade. ### Principais Parachains | Parachain | Função | Destaque | |-----------|--------|----------| | **Acala** | DeFi Hub | Stablecoin aUSD, DEX | | **Moonbeam** | Compatibilidade EVM | Deploy de dApps Ethereum | | **Astar** | dApps multichain | Maior ecossistema dApps | | **Phala** | Computação confidencial | Privacy computing | | **Centrifuge** | RWA (ativos reais) | Tokenização de ativos | ### DOT 2.0: Agile Coretime Em 2026-2026, Polkadot está migrando do modelo de **Parachain Auctions** para **Agile Coretime**, que permite: - Compra flexível de tempo de computação - Menor barreira de entrada para novos projetos - Uso mais eficiente de recursos ### Análise: Prós e Contras | Prós | Contras | |------|---------| | ✅ Interoperabilidade real | ❌ Complexidade técnica alta | | ✅ Staking com alto APY | ❌ Inflação do token | | ✅ Governança on-chain (OpenGov) | ❌ Adoção menor que esperado | | ✅ Ecossistema diversificado | ❌ Parachains com baixo TVL | | ✅ Tecnologia inovadora | ❌ Competição forte (Cosmos, LayerZero) | ### Monitorando Polkadot Consulte dados do DOT em tempo real: ```ts const response = await fetch( "https://brapi.dev/api/v2/crypto?coin=DOT¤cy=BRL", { headers: { "Authorization": "Bearer SEU_TOKEN" } } ); const data = await response.json(); const dot = data.coins[0]; console.log({ preco: dot.regularMarketPrice, variacao24h: dot.regularMarketChangePercent, marketCap: dot.marketCap, }); ```` **Informações do ecossistema Polkadot:** | Métrica | Valor | | -------------------- | ------------------ | | Parachains ativas | 43 | | Staking APY estimado | \~15% | | DOT em staking | \~50% | | Governança | OpenGov (on-chain) | ``` --- ## 4. Chainlink (LINK): A Ponte Entre Blockchains e Mundo Real ### O que é Chainlink? **Chainlink** é uma rede de **oráculos descentralizados** que fornece dados externos para smart contracts. Oráculos são essenciais porque blockchains não conseguem acessar dados fora de sua rede (preços, clima, resultados esportivos, etc.). ### Dados Fundamentais (Janeiro 2026) | Métrica | Valor | |---------|-------| | Ranking por Market Cap | Top 15 | | Tipo | Rede de Oráculos | | Blockchains Suportadas | 15+ (Ethereum, BSC, Polygon, Arbitrum, etc.) | | TVE (Total Value Enabled) | $75+ bilhões | | Fornecimento Máximo | 1 bilhão LINK | | Staking | Disponível (LINK Staking v0.2) | ### Como Funcionam os Oráculos **Mundo Real → Chainlink → Blockchain** | Fonte de dados | Exemplo | Usuário | |----------------|---------|---------| | APIs de preço (Exchanges) | Preço ETH/USD | Aave, Compound | | Dados de clima | Temperatura, precipitação | Seguros agrícolas | | Resultados esportivos | Placares de jogos | Casas de apostas | **Por que Chainlink é essencial:** Smart contracts não conseguem acessar dados externos. Chainlink agrega, verifica e publica esses dados de forma confiável na blockchain. Sem oráculos como Chainlink, protocolos DeFi não saberiam o preço real dos ativos e não poderiam funcionar. ### Produtos Chainlink | Produto | Descrição | Usuários | |---------|-----------|----------| | **Price Feeds** | Preços de ativos | Aave, Compound, Synthetix | | **VRF** | Números aleatórios verificáveis | NFTs, jogos, loterias | | **Automation** | Execução automática de contratos | Manutenção de protocolos | | **CCIP** | Mensagens cross-chain | Bridges, interoperabilidade | | **Functions** | APIs customizadas | Qualquer dado externo | ### CCIP: Cross-Chain Interoperability Protocol O **CCIP** é o produto mais importante do Chainlink para 2026, permitindo: - Transferência de tokens entre blockchains - Mensagens cross-chain seguras - Interoperabilidade padronizada Instituições como **SWIFT** e **ANZ Bank** estão testando o CCIP para tokenização de ativos. ### Tokenomics e Staking ### Tokenomics do LINK | Métrica | Valor | |---------|-------| | Supply Total | 1.000.000.000 LINK | | Supply Circulante | ~608.000.000 LINK | | Percentual Circulante | 60.8% | | LINK em Staking | ~7.4% | **Distribuição:** | Categoria | Percentual | |-----------|------------| | Node Operators & Ecosystem | 35% | | Team & Development | 35% | | Public Sale | 30% | **Staking LINK:** Versão v0.2 disponível, com pool de 45M LINK e APY base de ~5%. ``` ### Análise: Prós e Contras | Prós | Contras | | ------------------------------------ | ----------------------------------------- | | ✅ Infraestrutura essencial para DeFi | ❌ Uso de token pode diminuir (eficiência) | | ✅ Parcerias institucionais (SWIFT) | ❌ Centralização de node operators | | ✅ Tecnologia líder em oráculos | ❌ Competição crescente (Pyth, API3) | | ✅ CCIP para interoperabilidade | ❌ Tokenomics com grande unlock futuro | | ✅ Staking disponível | ❌ APY de staking relativamente baixo | *** ## Comparativo: Qual Altcoin Escolher? ### Matriz de Comparação | Critério | XRP | ADA | DOT | LINK | | ------------------------ | ---------- | --------------- | ------------------ | -------- | | **Caso de uso** | Pagamentos | Smart Contracts | Interoperabilidade | Oráculos | | **Staking** | ❌ | ✅ \~4% | ✅ \~15% | ✅ \~5% | | **Descentralização** | Baixa | Alta | Alta | Média | | **Adoção institucional** | Alta | Média | Baixa | Alta | | **Risco regulatório** | Médio | Baixo | Baixo | Baixo | | **Potencial upside** | Médio | Alto | Alto | Médio | | **Maturidade** | Alta | Média | Média | Alta | ### Perfis de Investidor ### Qual Altcoin Para Você? **Perfil Conservador (foco em adoção real):** 1. XRP - Parcerias bancárias, clareza regulatória 2. LINK - Infraestrutura essencial, SWIFT **Perfil Moderado (staking + crescimento):** 1. ADA - Staking fácil, governança 2. DOT - Alto APY, ecossistema diversificado **Perfil Agressivo (máximo upside):** 1. DOT - Maior potencial de valorização 2. ADA - Ecossistema em crescimento *** ## Onde Comprar Altcoins no Brasil ### Exchanges com Maior Liquidez | Exchange | XRP | ADA | DOT | LINK | Depósito PIX | | --------------- | --- | --- | --- | ---- | ------------ | | Binance | ✅ | ✅ | ✅ | ✅ | ✅ | | Mercado Bitcoin | ✅ | ✅ | ✅ | ✅ | ✅ | | Foxbit | ✅ | ✅ | ❌ | ✅ | ✅ | | Bitso | ✅ | ✅ | ✅ | ✅ | ✅ | | NovaDAX | ✅ | ✅ | ✅ | ✅ | ✅ | ### Via ETFs na Bolsa Brasileira Alternativa para quem quer exposição via bolsa brasileira: | ETF | Ativos | Taxa Adm. | | ---------- | ----------------------------------- | ---------- | | **HASH11** | BTC, ETH, SOL, XRP, ADA, LINK, etc. | 1,3% a.a. | | **QDFI11** | DeFi tokens (inclui LINK) | 0,75% a.a. | *** ## Monitorando Múltiplas Altcoins Acompanhe múltiplas altcoins em tempo real: ```ts const altcoins = ["XRP", "ADA", "DOT", "LINK"]; const fetchAltcoin = async (coin: string) => { const response = await fetch( `https://brapi.dev/api/v2/crypto?coin=${coin}¤cy=BRL`, { headers: { "Authorization": "Bearer SEU_TOKEN" } } ); const data = await response.json(); return data.coins[0]; }; const dashboard = await Promise.all(altcoins.map(fetchAltcoin)); dashboard.forEach((coin) => { console.log({ simbolo: coin.coin, preco: coin.regularMarketPrice, variacao24h: coin.regularMarketChangePercent, }); }); ``` ``` --- ## Estratégia de Investimento em Altcoins ### Alocação Sugerida por Perfil ### Alocação Sugerida por Perfil **Exemplo: R$ 10.000 para investir em altcoins** | Perfil | XRP | ADA | DOT | LINK | |--------|-----|-----|-----|------| | **Conservador** | 35% (R$ 3.500) | 15% (R$ 1.500) | 15% (R$ 1.500) | 35% (R$ 3.500) | | **Moderado** | 25% (R$ 2.500) | 30% (R$ 3.000) | 25% (R$ 2.500) | 20% (R$ 2.000) | | **Agressivo** | 20% (R$ 2.000) | 30% (R$ 3.000) | 35% (R$ 3.500) | 15% (R$ 1.500) | ``` ### DCA: Dollar Cost Averaging Para altcoins voláteis, considere investir valores fixos periodicamente: ### Exemplo: DCA em Cardano (ADA) **Estratégia:** Investir R$ 500/mês durante 12 meses | Mês | Preço ADA | ADA Comprado | Total ADA | Preço Médio | | --- | --------- | ------------ | --------- | ----------- | | 1 | R$ 2,00 | 250 | 250 | R$ 2,00 | | 3 | R$ 2,20 | 227 | 715 | R$ 2,10 | | 6 | R$ 2,10 | 238 | 1.440 | R$ 2,08 | | 12 | R$ 3,50 | 143 | 2.650 | R$ 2,26 | **Resultado após 12 meses:** * Total investido: R$ 6.000 * ADA acumulado: \~2.650 ADA * Preço médio: R$ 2,26 * Valor final (preço R$ 3,50): R$ 9.275 * Retorno: +54,6% **DCA (Dollar Cost Averaging)** reduz o impacto da volatilidade comprando mais quando o preço está baixo e menos quando está alto. ``` --- ## Riscos e Considerações Importantes ### Riscos Específicos por Altcoin | Altcoin | Risco Principal | Mitigação | |---------|-----------------|-----------| | **XRP** | Dependência de Ripple Labs | Diversificar portfólio | | **ADA** | Desenvolvimento lento | Paciência, foco em longo prazo | | **DOT** | Inflação alta (~10% a.a.) | Stake para compensar | | **LINK** | Competição (Pyth, API3) | Acompanhar adoção | ### Bandeiras Vermelhas para Evitar - ❌ Altcoins sem caso de uso claro - ❌ Projetos com tokenomics predatórios (muitos unlocks) - ❌ Times anônimos ou sem histórico - ❌ Promessas de retornos garantidos - ❌ Baixa liquidez em exchanges --- ## Perguntas Frequentes (FAQ) ### 1. Qual a melhor altcoin para iniciantes? **Cardano (ADA)** é frequentemente recomendada para iniciantes por: - Staking nativo sem lock-up - Interface simples de carteiras - Comunidade ativa e educativa ### 2. Devo investir em altcoins ou focar só em Bitcoin? Recomendação comum: 50-70% em Bitcoin/Ethereum, 30-50% em altcoins selecionadas. Altcoins oferecem maior potencial de valorização, mas com risco proporcional. ### 3. Como declarar altcoins no IR? Use o código **08-02** (Outras criptomoedas) na ficha Bens e Direitos. A isenção de R$ 35 mil/mês se aplica ao total de todas as criptomoedas vendidas. ### 4. XRP é seguro após o caso SEC? A vitória parcial contra a SEC reduziu significativamente o risco regulatório. Vendas em exchanges não são consideradas securities. Entretanto, o risco de centralização permanece. ### 5. Vale a pena fazer staking de DOT mesmo com inflação? Sim, se você planeja manter DOT no longo prazo. O staking (~15% APY) supera a inflação (~10%), resultando em ganho real de ~5% ao ano em DOT. ### 6. Chainlink pode ser substituído por concorrentes? Possível, mas improvável no curto prazo. LINK tem a maior adoção, melhores parcerias institucionais e vantagem de first-mover. CCIP fortalece ainda mais a posição. --- ## Conclusão As altcoins **XRP**, **Cardano (ADA)**, **Polkadot (DOT)** e **Chainlink (LINK)** representam projetos sólidos com casos de uso distintos: | Altcoin | Resumo | |---------|--------| | **XRP** | Pagamentos internacionais, adoção institucional | | **ADA** | Smart contracts com base científica, staking fácil | | **DOT** | Interoperabilidade entre blockchains | | **LINK** | Oráculos essenciais para DeFi e dados on-chain | **Recomendações finais:** 1. Nunca invista mais do que pode perder 2. Diversifique entre diferentes altcoins e classes de ativos 3. Faça sua própria pesquisa (DYOR) 4. Considere estratégia DCA para reduzir impacto da volatilidade 5. Aproveite staking quando disponível Use a API da brapi.dev para acompanhar suas altcoins e tomar decisões baseadas em dados atualizados. --- *Disclaimer: Este conteúdo é educativo e não constitui recomendação de investimento. Criptomoedas são ativos de alto risco. Consulte um profissional antes de investir.* ``` # AMD e IA 2026: Análise Completa de Riscos e Oportunidades no Setor URL: /blog/amd-boom-ia-analise-mercado-acoes.mdx Análise completa da AMD no boom da IA! Oportunidades, riscos e potencial de crescimento no mercado de semicondutores ✓ *** searchable: true title: 'AMD e IA 2026: Análise Completa de Riscos e Oportunidades no Setor' description: 'Análise completa da AMD no boom da IA! Oportunidades, riscos e potencial de crescimento no mercado de semicondutores ✓' date: '2026-01-01' keywords: 'AMD ações 2026, investimento IA, semicondutores, análise AMD, ações tecnologia, mercado IA, chips inteligência artificial, AMD vs NVIDIA, investir tecnologia' author: 'Equipe brapi.dev' category: 'Análise Setorial' subcategory: 'Tecnologia e IA' readingTime: '13 min' tags: \['AMD', 'Inteligência Artificial', 'Semicondutores', 'Tecnologia', 'Análise Setorial', 'Ações Tech', 'IA', 'Investimentos'] relatedPosts: \['analise-setorial-acoes-como-comparar-empresas-mesmo-segmento-b3', 'enterprise-value-ev-como-calcular-valor-real-empresa', 'analise-fundamentalista-acoes-indicadores-essenciais-investir-b3', 'bdrs-guia-completo-investir-empresas-americanas-2026'] featured: false expertise: 'Análise especializada em setor de tecnologia e semicondutores com foco em mercados globais' lastReviewed: '2026-01-01' -------------------------- import { Authors, Author } from '~/components/Authors'; > Advanced Micro Devices, Inc. [AMD34](https://brapi.dev/quote/AMD) está > causando um grande burburinho no mundo dos investimentos com a introdução de > seu novo chip de IA, o MI300X. Investidores entusiasmados têm impulsionado as > ações da AMD perto de recordes históricos, antecipando o potencial que essa > nova tecnologia possui. Mas, antes de mergulhar de cabeça, é importante dar > uma olhada abrangente no negócio mais amplo da AMD e no cenário competitivo do > mercado de IA. ## O Mercado de IA: Uma Paisagem Competitiva O mercado de Inteligência artificial (IA) é atualmente um campo fértil de competição, com gigantes do mercado como [Nvidia](https://brapi.dev/quote/NVDA) e [Intel](https://brapi.dev/quote/INTC) também fazendo avanços significativos. O mercado deve atingir um valor impressionante de $190 bilhões até 2026, crescendo a uma taxa composta de crescimento anual (CAGR) de 36,62% de 2020 a 2026. O chip MI300X da AMD é um jogador chave nesta corrida, sendo divulgado para ter um desempenho compatível com os chips da Nvidia no treinamento de IA, mas superando-os no uso da IA treinada. No entanto, o ritmo rápido dos avanços tecnológicos e a volatilidade do mercado tornam este um setor de alto risco e alta recompensa. Embora o novo chip da AMD pareça promissor, a empresa ainda está atrás da Nvidia em vendas, indicando um caminho desafiador pela frente. ## Negócio Mais Amplo da AMD: Mais do que Apenas IA Embora a IA seja de fato um segmento lucrativo, a proposta de valor da AMD vai além disso. A empresa é uma líder no mercado de microprocessadores e processadores gráficos, que contribuem significativamente para seu valor. Os segmentos de consoles de jogos e PCs, em particular, oferecem estabilidade e potencial de crescimento, tornando-os considerações importantes para potenciais investidores. ## Justificativa de Avaliação: A AMD está Superestimada? Atualmente, as ações da AMD estão sendo negociadas com um prêmio. No entanto, os fortes fundamentos e vantagens competitivas da empresa justificam essa avaliação. Sua posição forte no mercado, portfólio de produtos inovadores e crescimento em setores de alta demanda, como jogos e data centers, fornecem uma base sólida para sua alta avaliação. ## Opções de Investimento Alternativas: Nvidia e Intel Investidores que procuram exposição ao mercado de IA têm outras opções a considerar. A Nvidia, concorrente direta da AMD, tem uma forte presença no mercado de IA. A Intel, com sua gama de produtos de IA, também apresenta uma proposta de investimento convincente. Avaliar essas alternativas pode fornecer uma perspectiva mais ampla e uma estratégia de investimento mais equilibrada. Em conclusão, embora o novo chip de IA da AMD apresente uma oportunidade tentadora, é importante que os investidores considerem o desempenho geral da empresa e o cenário competitivo da IA. Ainda são os primeiros dias para a IA, e projeções financeiras específicas para o segmento de IA da AMD ainda estão para ser lançadas. Portanto, os investidores devem ficar de olho nesses números e no cenário do mercado de IA que se desenrola antes de tomar quaisquer decisões de investimento significativas. # Como Analisar a DRE (Demonstracao do Resultado do Exercicio) 2026: Guia Completo URL: /blog/analise-dre-demonstracao-resultados.mdx Aprenda a interpretar a DRE para avaliar a lucratividade das empresas ✓ Receitas, custos, margens e lucro liquido explicados com exemplos práticos *** searchable: true title: 'Como Analisar a DRE (Demonstracao do Resultado do Exercicio) 2026: Guia Completo' description: 'Aprenda a interpretar a DRE para avaliar a lucratividade das empresas ✓ Receitas, custos, margens e lucro liquido explicados com exemplos práticos' date: '2026-01-01' keywords: 'DRE 2026, demonstracao resultado exercicio, análise DRE, receita liquida, lucro bruto, EBITDA, lucro liquido, margem liquida, análise fundamentalista' author: 'Equipe brapi.dev' category: 'Análise Fundamentalista' subcategory: 'Demonstrativos Financeiros' readingTime: '22 min' tags: \['DRE', 'Demonstrativos Financeiros', 'Análise Fundamentalista', 'Lucratividade', 'Margens'] relatedPosts: \['como-ler-balanco-patrimonial', 'guia-ebit-e-ebitda', 'indicador-ev-ebitda-como-analisar', 'fluxo-de-caixa-descontado-valuation', 'balanco-patrimonial-acoes'] featured: true expertise: 'Especialistas em análise de demonstrativos financeiros e valuation de empresas brasileiras' lastReviewed: 2026-01-03 ------------------------ ## O Que e a DRE e Por Que Você Precisa Entendê-la A **Demonstracao do Resultado do Exercicio (DRE)** e o demonstrativo financeiro que revela se uma empresa está realmente ganhando dinheiro. Enquanto o balanco patrimonial mostra uma fotografia dos ativos e passivos em determinado momento, a DRE conta a historia de como a empresa gerou (ou perdeu) dinheiro durante um periodo. Pense na DRE como o "filme" da operacao da empresa: ela mostra quanto entrou de receita, quanto saiu em custos e despesas, e quanto sobrou no final. É o demonstrativo que responde à pergunta mais importante: **a empresa e lucrativa?** ### Por Que a DRE e Essencial para Investidores A DRE revela informacões que nenhum outro demonstrativo oferece: | Informacao | O Que Revela | Por Que Importa | | ------------------- | ---------------------------- | -------------------------------------- | | **Receita Liquida** | Capacidade de vender | Tamanho e crescimento do negocio | | **Lucro Bruto** | Eficiência produtiva | Poder de precificacao | | **EBITDA** | Geracao operacional de caixa | Capacidade de investir e pagar dividas | | **Lucro Liquido** | Resultado final | Retorno real para acionistas | | **Margens** | Eficiência em cada etapa | Vantagem competitiva sustentável | ## Estrutura Completa da DRE: Linha por Linha A DRE segue uma estrutura logica que parte das vendas ate chegar ao lucro liquido. Vamos analisar cada componente: ``` ESTRUTURA DA DRE (+) Receita Bruta de Vendas (-) Deducões (impostos, devolucões, abatimentos) ════════════════════════════════════════════════ (=) RECEITA LÍQUIDA (-) Custo dos Produtos/Servicos Vendidos (CPV/CSV) ════════════════════════════════════════════════ (=) LUCRO BRUTO (-) Despesas Operacionais • Vendas e Marketing • Gerais e Administrativas • Pesquisa e Desenvolvimento (+) Outras Receitas Operacionais ════════════════════════════════════════════════ (=) EBIT (Lucro Operacional) (+) Receitas Financeiras (-) Despesas Financeiras ════════════════════════════════════════════════ (=) LUCRO ANTES DO IR (EBT) (-) Imposto de Renda e CSLL ════════════════════════════════════════════════ (=) LUCRO LÍQUIDO ``` ### 1. Receita Bruta vs Receita Liquida A **Receita Bruta** e o valor total das vendas antes de qualquer deducao. Já a **Receita Liquida** e o que efetivamente entra no caixa apos: * **Impostos sobre vendas**: ICMS, PIS, COFINS, ISS * **Devolucões**: Produtos retornados por clientes * **Abatimentos**: Descontos concedidos ```typescript // Analisar evolucao da receita usando brapi.dev const response = await fetch( "https://brapi.dev/api/quote/WEGE3?modules=incomeStatementHistory,defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const incomeStatements = results[0].incomeStatementHistory.incomeStatementHistory; ``` **Exemplo - Evolucao de Receita WEGE3:** | Periodo | Receita (Mi) | Lucro Bruto (Mi) | Lucro Liquido (Mi) | Margem Bruta | Margem Liquida | | ------- | ------------ | ---------------- | ------------------ | ------------ | -------------- | | 2024 | R$ 36.500 | R$ 12.200 | R$ 5.100 | 33,4% | 14,0% | | 2023 | R$ 32.400 | R$ 10.800 | R$ 4.500 | 33,3% | 13,9% | | 2022 | R$ 28.900 | R$ 9.600 | R$ 3.900 | 33,2% | 13,5% | | 2021 | R$ 23.500 | R$ 7.700 | R$ 3.100 | 32,8% | 13,2% | ### 2. Custo dos Produtos/Servicos Vendidos (CPV/CSV) O **CPV** representa todos os custos diretamente ligados à producao ou prestacao de servicos: | Tipo de Empresa | Componentes do CPV | | --------------- | ------------------------------------------------------------------------------ | | **Indústria** | Materia-prima, mao de obra direta, energia da fábrica, depreciacao de máquinas | | **Varejo** | Custo de aquisicao das mercadorias | | **Servicos** | Mao de obra direta, materiais usados no servico | | **Software** | Custos de hospedagem, suporte tecnico direto | ### 3. Lucro Bruto e Margem Bruta O **Lucro Bruto** e a diferenca entre Receita Liquida e CPV. A **Margem Bruta** mostra quanto sobra de cada real vendido apos cobrir os custos diretos: ``` Margem Bruta = (Lucro Bruto / Receita Liquida) × 100 ``` **Interpretacao da Margem Bruta por Setor:** | Setor | Margem Bruta Tipica | Exemplo | | ------------------- | ------------------- | ------------ | | **Software/SaaS** | 70-90% | TOTS3: \~55% | | **Farmacêutico** | 60-80% | RADL3: \~28% | | **Bens de Capital** | 25-40% | WEGE3: \~33% | | **Varejo** | 20-35% | MGLU3: \~25% | | **Commodities** | 15-30% | VALE3: \~40% | | **Supermercados** | 20-25% | CRFB3: \~21% | > **Insight importante:** Margens brutas altas indicam poder de precificacao e/ou eficiência produtiva. Empresas com margens brutas consistentemente acima dos concorrentes geralmente têm vantagens competitivas. ### 4. Despesas Operacionais As despesas operacionais sao custos necessários para manter a empresa funcionando, mas nao diretamente ligados à producao: **Despesas com Vendas:** * Comissões de vendedores * Marketing e publicidade * Logistica de distribuicao * Pos-venda e garantia **Despesas Gerais e Administrativas (G\&A):** * Salários administrativos * Aluguel de escritorios * Sistemas e TI * Servicos profissionais (contabilidade, juridico) **Pesquisa e Desenvolvimento (P\&D):** * Salários de engenheiros e pesquisadores * Testes e prototipos * Patentes e propriedade intelectual ### 5. EBIT e EBITDA O **EBIT (Earnings Before Interest and Taxes)** e o lucro operacional, antes de juros e impostos. Mostra quanto a empresa gera apenas com sua operacao principal. O **EBITDA** adiciona de volta depreciacao e amortizacao, mostrando a geracao de caixa operacional: ``` EBITDA = EBIT + Depreciacao + Amortizacao ``` ```typescript // Obter EBITDA e margem via brapi.dev const response = await fetch( "https://brapi.dev/api/quote/WEGE3,VALE3,ITUB4,MGLU3,PETR4?modules=defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); // Acesso a ebitda, totalRevenue, ebitdaMargins ``` **Comparativo de Margens EBITDA:** | Ticker | Empresa | EBITDA (Bi) | Margem EBITDA | | ------ | -------------- | ----------- | ------------- | | PETR4 | Petrobras | R$ 280,0 | 48,5% | | VALE3 | Vale | R$ 95,0 | 42,0% | | ITUB4 | Itaú Unibanco | R$ 45,0 | 38,0% | | WEGE3 | WEG | R$ 6,8 | 18,6% | | MGLU3 | Magazine Luiza | R$ 1,2 | 4,5% | ``` ### 6. Resultado Financeiro O resultado financeiro mostra o impacto das decisões de financiamento: **Receitas Financeiras:** - Rendimentos de aplicacões - Juros recebidos - Variacao cambial positiva **Despesas Financeiras:** - Juros sobre emprestimos - Variacao cambial negativa - Custos de hedge > **Atencao:** Empresas muito endividadas podem ter lucro operacional positivo mas prejuizo liquido devido às despesas financeiras. Sempre analise o endividamento junto com a DRE. ### 7. Lucro Liquido e Margem Liquida O **Lucro Liquido** e o resultado final apos todos os custos, despesas, juros e impostos. É o que efetivamente pertence aos acionistas. ``` Margem Liquida = (Lucro Liquido / Receita Liquida) × 100 ```` **Benchmarks de Margem Liquida:** | Classificacao | Margem Liquida | Interpretacao | |---------------|----------------|---------------| | **Excepcional** | > 20% | Vantagem competitiva forte | | **Boa** | 10-20% | Empresa eficiente | | **Media** | 5-10% | Normal para maioria dos setores | | **Baixa** | 2-5% | Negocio commoditizado | | **Muito baixa** | menor que 2% | Risco operacional alto | ## Análise Vertical e Horizontal da DRE ### Análise Vertical A análise vertical expressa cada linha da DRE como percentual da Receita Liquida: ```typescript // Análise vertical da DRE const response = await fetch( "https://brapi.dev/api/quote/WEGE3?modules=incomeStatementHistory,defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const statement = results[0].incomeStatementHistory.incomeStatementHistory[0]; // Calcular cada linha como % da receita ```` **Exemplo - Análise Vertical WEGE3 (2024):** | Linha | Valor | % Receita | | ------------------------- | ---------- | --------- | | Receita Liquida | R$ 36,5 bi | 100,0% | | (-) Custo Receita | R$ 24,3 bi | 66,6% | | (=) Lucro Bruto | R$ 12,2 bi | 33,4% | | (-) Despesas Operacionais | R$ 5,8 bi | 15,9% | | (=) EBIT | R$ 6,4 bi | 17,5% | | (+/-) Result. Financeiro | -R$ 0,2 bi | -0,5% | | (=) Lucro Antes IR | R$ 6,2 bi | 17,0% | | (-) IR/CSLL | R$ 1,1 bi | 3,0% | | (=) Lucro Liquido | R$ 5,1 bi | 14,0% | ```` ### Análise Horizontal A análise horizontal compara a evolucao das linhas ao longo do tempo: ```typescript // Análise horizontal - comparar periodos const response = await fetch( "https://brapi.dev/api/quote/WEGE3?modules=incomeStatementHistory,defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const statements = results[0].incomeStatementHistory.incomeStatementHistory; // Comparar statements[0] (atual) com statements[1] (anterior) ```` **Exemplo - Análise Horizontal WEGE3 (2023 → 2024):** | Metrica | 2023 | 2024 | Variacao | | ------------- | ---------- | ---------- | -------- | | Receita | R$ 32,4 bi | R$ 36,5 bi | +12,7% | | Lucro Bruto | R$ 10,8 bi | R$ 12,2 bi | +13,0% | | EBIT | R$ 5,7 bi | R$ 6,4 bi | +12,3% | | Lucro Liquido | R$ 4,5 bi | R$ 5,1 bi | +13,3% | > Crescimento equilibrado entre receita e lucro indica manutencao de margens. ``` ## Red Flags na DRE: Sinais de Alerta Ao analisar a DRE, fique atento a estes sinais de alerta: ### 1. Receita Crescendo, Lucro Caindo ``` ┌──────────────────────────────────────────────────┐ │ RED FLAG: Compressao de Margens │ ├──────────────────────────────────────────────────┤ │ │ │ Receita: ████████████████████████ +15% │ │ Lucro: ████████████ -8% │ │ │ │ Possiveis causas: │ │ • Aumento de custos nao repassado │ │ • Guerra de precos com concorrentes │ │ • Perda de eficiência operacional │ │ • Aquisicões mal integradas │ │ │ └──────────────────────────────────────────────────┘ ```` ### 2. Despesas Financeiras Crescentes Quando as despesas financeiras crescem mais rápido que o EBIT, a empresa está se alavancando demais. ### 3. Lucro Liquido Muito Diferente do Lucro Operacional Quando o lucro liquido e muito maior ou menor que o EBIT, investigue: | Situacao | Possivel Causa | Acao | |----------|---------------|------| | LL maior maior que EBIT | Ganhos nao recorrentes, venda de ativos | Desconsiderar para projecões | | LL menor menor que EBIT | Despesas financeiras altas, IR alto | Verificar endividamento | | LL negativo, EBIT positivo | Divida excessiva | Avaliar capacidade de desalavancagem | ### 4. Margem Bruta em Queda Consistente ```typescript // Analisar tendência das margens const response = await fetch( "https://brapi.dev/api/quote/WEGE3?modules=incomeStatementHistory,defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const statements = results[0].incomeStatementHistory.incomeStatementHistory; // Comparar margens ao longo dos periodos ```` **Exemplo - Tendência de Margens:** | Periodo | Margem Bruta | Margem Liquida | Status | | ------- | ------------ | -------------- | ------- | | 2024 | 33,4% | 14,0% | Estável | | 2023 | 33,3% | 13,9% | Estável | | 2022 | 33,2% | 13,5% | Estável | | 2021 | 32,8% | 13,2% | OK | > **Alerta:** Se margem bruta cair mais de 5 pontos percentuais em 3 anos, investigue a causa. ## Comparando DREs de Empresas do Mesmo Setor A análise comparativa e fundamental para identificar quais empresas sao mais eficientes: ```typescript // Comparar DRE de múltiplas empresas do mesmo setor const tickers = "ITUB4,BBDC4,BBAS3,SANB11"; const response = await fetch( `https://brapi.dev/api/quote/${tickers}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); // Acesso a grossMargins, ebitdaMargins, profitMargins, returnOnEquity ``` **Comparativo de Margens - Setor Bancário:** | Ticker | Margem Bruta | Margem EBITDA | Margem Liquida | ROE | | ------ | ------------ | ------------- | -------------- | ----- | | ITUB4 | 58,5% | 42,0% | 22,5% | 20,8% | | BBAS3 | 55,2% | 38,5% | 18,2% | 16,5% | | BBDC4 | 52,8% | 35,2% | 15,8% | 12,4% | | SANB11 | 48,5% | 32,0% | 12,5% | 10,2% | ```` ## Case Study: Análise da DRE da WEG (WEGE3) Vamos fazer uma análise completa da DRE da WEG, uma das empresas mais admiradas da bolsa brasileira: ```typescript // Análise completa da DRE da WEG const response = await fetch( "https://brapi.dev/api/quote/WEGE3?modules=incomeStatementHistory,defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const weg = results[0]; ```` **WEG S.A. (WEGE3) - Case Study:** | Metrica | Valor | | -------------- | ---------------------------------------- | | **Setor** | Bens de Capital / Equipamentos Eletricos | | **Market Cap** | R$ 220+ bilhões | **Métricas de Lucratividade:** | Indicador | Valor | | ------------- | --------------- | | Receita (12m) | R$ 36,5 bilhões | | EBITDA | R$ 6,8 bilhões | | Lucro Liquido | R$ 5,1 bilhões | **Margens:** | Margem | Valor | | -------------- | ----- | | Margem Bruta | 33,4% | | Margem EBITDA | 18,6% | | Margem Liquida | 14,0% | **Eficiência:** | Indicador | Valor | | --------- | ----- | | ROE | 28,5% | | ROA | 12,8% | **Análise:** A WEG demonstra caracteristicas tipicas de uma empresa de qualidade: * ✓ Margens consistentes ao longo dos anos * ✓ ROE elevado (acima de 20%) * ✓ Crescimento de receita sustentável * ✓ Baixo endividamento * ✓ Diversificacao geográfica (mais de 50% internacional) **Pontos de atencao:** * Múltiplo P/L elevado (30x+) * Exposicao cambial significativa * Ciclo de commodities afeta custos ## DRE Trimestral vs Anual: Quando Usar Cada Uma | Aspecto | DRE Trimestral | DRE Anual | | --------------------------- | ------------------------------------------- | ------------------------------- | | **Sazonalidade** | Revela padrões sazonais | Normaliza efeitos sazonais | | **Tendências** | Identifica mudancas recentes | Mostra tendência de longo prazo | | **Comparacao** | Compare com mesmo trimestre do ano anterior | Compare anos consecutivos | | **Eventos nao recorrentes** | Pode distorcer análise | Diluidos no periodo maior | ### Ajustando para Sazonalidade ```typescript // Identificar padrões sazonais na receita const response = await fetch( "https://brapi.dev/api/quote/MGLU3?modules=incomeStatementHistoryQuarterly,defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); // Agrupar por trimestre para identificar sazonalidade ``` **Exemplo - Sazonalidade no Varejo:** | Trimestre | Caracteristica | | ------------ | -------------------------------- | | Q1 (Jan-Mar) | Mais fraco - pos-festas | | Q2 (Abr-Jun) | Dia das Maes | | Q3 (Jul-Set) | Dia dos Pais | | Q4 (Out-Dez) | Mais forte - Black Friday, Natal | > **Recomendacao:** Compare sempre trimestres equivalentes (YoY) para evitar distorcões sazonais. ## Integrando DRE com Outros Demonstrativos A DRE ganha ainda mais poder quando analisada junto com outros demonstrativos: ``` ANÁLISE INTEGRADA DRE Balanco DFC Lucro Liquido ► Patrimônio ◄ Caixa Gerado ▼ ▼ ▼ ROE = LL / PL Alavancagem FCO vs LL Se FCO menor que LL consistentemente → Qualidade do lucro baixa Se ROE > 20% com baixa alavancagem → Empresa de qualidade ``` ## Conclusao: Checklist de Análise da DRE Ao analisar qualquer DRE, siga este checklist: ### Checklist de Análise da DRE * [ ] **Crescimento de Receita**: Está acima da inflacao? Acima do setor? * [ ] **Margem Bruta**: Estável ou crescendo? Acima dos concorrentes? * [ ] **Margem EBITDA**: Demonstra eficiência operacional? * [ ] **Resultado Financeiro**: Despesas financeiras sao sustentáveis? * [ ] **Margem Liquida**: Compativel com o setor? * [ ] **Tendência**: Margens estao melhorando ou piorando? * [ ] **Qualidade**: Lucro e recorrente ou há itens extraordinários? * [ ] **Consistência**: Resultados sao previsiveis? ### Proximos Passos Agora que você domina a DRE, complete sua análise fundamentalista: 1. **[Como Ler o Balanco Patrimonial](/blog/como-ler-balanco-patrimonial)** - Entenda a saúde financeira 2. **[Guia de EBIT e EBITDA](/blog/guia-ebit-e-ebitda)** - Aprofunde na geracao de caixa 3. **[EV/EBITDA](/blog/indicador-ev-ebitda-como-analisar)** - Use a DRE para valuation 4. **[Fluxo de Caixa Descontado](/blog/fluxo-de-caixa-descontado-valuation)** - Projete resultados futuros ## Automatize Sua Análise com brapi.dev A API da brapi.dev oferece acesso completo aos dados da DRE de todas as empresas listadas na bolsa brasileira. Com uma única chamada, você obtem: * Historico de demonstrativos anuais e trimestrais * Todas as linhas da DRE * Margens pre-calculadas * Dados atualizados automaticamente **Comece gratuitamente** em [brapi.dev](https://brapi.dev) e automatize suas análises de DRE com Python, JavaScript ou qualquer linguagem de sua preferência. # Análise de Balanço Patrimonial 2025: Usando balanceSheetHistory da API brapi URL: /blog/analise-financeira-com-modulo-balance-sheet-history.mdx Domine análise de balanço patrimonial com a API brapi! Use o módulo balanceSheetHistory para análise financeira ✓ *** searchable: true title: 'Análise de Balanço Patrimonial 2025: Usando balanceSheetHistory da API brapi' description: 'Domine análise de balanço patrimonial com a API brapi! Use o módulo balanceSheetHistory para análise financeira ✓' date: '2025-08-22' keywords: 'balanço patrimonial API, balanceSheetHistory brapi, análise financeira, demonstrações financeiras, API dados financeiros, análise fundamentalista programática' author: 'Equipe brapi.dev' category: 'API e Desenvolvimento' subcategory: 'Módulos Financeiros' readingTime: '11 min' tags: \['Balanço Patrimonial', 'API brapi', 'balanceSheetHistory', 'Análise Financeira', 'Desenvolvimento', 'Dados Financeiros', 'Programação', 'Módulos'] relatedPosts: \['b3-api-gratuita-como-usar-cotacoes', 'demonstrativos-financeiros-um-olhar-detalhado-na-saude-financeira-da-empresa', 'balanco-patrimonial-acoes'] featured: false expertise: 'Equipe técnica especializada em APIs financeiras e estruturação de dados fundamentalistas' lastReviewed: '2025-08-22' howToSteps: * name: 'Entender o módulo balanceSheetHistory' text: 'Compreenda que o módulo retorna dados de ativos, passivos e patrimônio líquido de uma empresa ao longo do tempo para análise de saúde financeira.' * name: 'Fazer requisição à API brapi.dev' text: 'Execute GET para [https://brapi.dev/api/quote/TICKER?modules=balanceSheetHistory](https://brapi.dev/api/quote/TICKER?modules=balanceSheetHistory) com o header Authorization: Bearer SEU\_TOKEN para obter dados anuais do balanço patrimonial.' * name: 'Obter dados trimestrais' text: 'Para análise mais granular, use o módulo balanceSheetHistoryQuarterly que retorna dados por trimestre.' * name: 'Interpretar dados de ativos' text: 'Analise ativos circulantes (caixa, investimentos curto prazo, recebíveis) e ativos de longo prazo (imobilizado, intangíveis) para entender a composição patrimonial.' * name: 'Avaliar passivos e obrigações' text: 'Examine passivos circulantes e de longo prazo, incluindo dívidas, para avaliar a capacidade de pagamento e risco financeiro.' * name: 'Calcular indicadores de solvência' text: 'Use os dados para calcular liquidez corrente, endividamento e outros ratios de saúde financeira.' * name: 'Acompanhar evolução temporal' text: 'Compare dados de diferentes períodos para identificar tendências na estrutura patrimonial da empresa.' howToTools: * 'API brapi.dev' * 'Cliente HTTP (curl, Postman, código)' * 'Planilha ou Python para análise' howToSupplies: * 'Token de acesso brapi.dev' * 'Ticker da empresa a analisar' * 'Conhecimento de contabilidade básica' *** import { Authors, Author } from '~/components/Authors'; > Olá, leitores do blog da brapi! Hoje, estamos mergulhando na análise > financeira com o módulo `balanceSheetHistory`. Esta ferramenta poderosa > fornece uma visão detalhada da saúde financeira de uma empresa ao longo do > tempo, permitindo a tomada de decisões de investimento informadas. ## O que é `balanceSheetHistory`? Em termos simples, `balanceSheetHistory` é um módulo que permite uma análise minuciosa dos ativos, passivos e patrimônio líquido de uma empresa em um determinado período. Estes dados são fundamentais para avaliar a saúde financeira da empresa e seu desempenho ao longo do tempo. [Ler documentação da API da brapi](https://brapi.dev/docs/acoes#modules-opcional) ## Como funciona? Ao fazer uma solicitação para o módulo `balanceSheetHistory`, a brapi retorna uma série de dados relacionados aos ativos, passivos e patrimônio líquido da empresa para o período especificado. Isso inclui ativos de curto e longo prazo, passivos de curto e longo prazo, e detalhes do patrimônio líquido. * Exemplo de requisição: ```sh GET https://brapi.dev/api/quote/BBDC3?modules=balanceSheetHistory Authorization: Bearer SEU_TOKEN ``` Para obter dados trimestrais, basta utilizar o módulo *balanceSheetHistoryQuarterly*: ```sh GET https://brapi.dev/api/quote/BBDC3?modules=balanceSheetHistoryQuarterly Authorization: Bearer SEU_TOKEN ``` ## Por que isso é importante? A análise do balanço financeiro de uma empresa é um pilar fundamental da análise financeira e estatística. Ela fornece uma visão instantânea da posição financeira da empresa - o que ela possui (ativos), o que ela deve (passivos), e o valor que restaria se a empresa liquidasse todos os seus ativos e pagasse todos os seus passivos (patrimônio líquido). Os ativos e passivos são divididos entre correntes (que serão liquidados no próximo ano) e de longo prazo. A capacidade da empresa de cumprir suas obrigações de curto prazo é um indicador importante de sua solvência e risco financeiro. ## Exemplo prático Vamos dar uma olhada em um exemplo prático. Digamos que estamos analisando a empresa BBDC3. Fazemos uma solicitação para o módulo `balanceSheetHistory` e recebemos um conjunto de dados que detalham os ativos, passivos e patrimônio líquido da empresa. * Exemplo da resposta: ```json { "endDate": "2022-12-31T00:00:00.000Z", "cash": 20548372000, "shortTermInvestments": 109054313000, "netReceivables": 7706021000, "inventory": 1236931000, "otherCurrentAssets": 136876324000, "totalCurrentAssets": 297421734000, "longTermInvestments": 721810397000, "propertyPlantEquipment": 11971122000, "goodWill": 6542091000, "intangibleAssets": 12257722000, "otherAssets": 749612609000, "deferredLongTermAssetCharges": 85068043000, "totalAssets": 1799615675000, "accountsPayable": 593422900000, "shortLongTermDebt": 108819093000, "otherCurrentLiab": 43152274000, "longTermDebt": 235811267000, "otherLiab": 411157035000, "deferredLongTermLiab": 1285383000, "minorityInterest": 475906000, "totalCurrentLiabilities": 990312960000, "totalLiab": 1640874411000, "commonStock": 87100000000, "retainedEarnings": 74387465000, "treasuryStock": -3292603000, "capitalSurplus": 70496000, "otherStockholderEquity": -3068226000, "totalStockholderEquity": 158265358000, "netTangibleAssets": 143020180000 } ``` A partir desses dados, podemos ver que a empresa tem um total de ativos de R$1.799.615.675.000 (representado por `totalAssets`). Seus passivos totais (totalLiab) são R$1.640.874.411.000. A diferença entre esses dois, ou seja, o patrimônio líquido, é de por volta de R$158.265.358.000 (`totalStockholderEquity`). Essa informação nos diz que, se a BBDC3 liquidasse todos os seus ativos e pagasse todos os seus passivos hoje, restariam 158.265.358.000 para os acionistas. Isso é um indicador do valor intrínseco da empresa e pode ser usado para comparar com o valor de mercado atual para determinar se a empresa está subavaliada ou superavaliada. Além disso, ao analisar esses dados ao longo do tempo, podemos identificar tendências em termos de crescimento de ativos, acúmulo de passivos e aumento ou diminuição do patrimônio líquido. Isso nos ajuda a fazer previsões informadas sobre o futuro financeiro da empresa. ## Conclusão O módulo `balanceSheetHistory` é uma ferramenta poderosa para qualquer pessoa interessada em fazer uma análise financeira detalhada. Ele fornece uma visão abrangente da saúde financeira de uma empresa ao longo do tempo, permitindo a tomada de decisões de investimento informadas. Então, que tal experimentar o módulo `balanceSheetHistory` hoje e ver por si mesmo o quão útil ele pode ser? [Começar na brapi](https://brapi.dev/dashboard) # Análise Fundamentalista 2025: Framework Completo para Ações Brasileiras URL: /blog/analise-fundamentalista-acoes-indicadores-essenciais-investir-b3.mdx Domine análise fundamentalista de ações! Framework completo com P/L, ROE, EBITDA, margens e indicadores essenciais. Guia prático para investir melhor na bolsa brasileira ✓ *** searchable: true title: 'Análise Fundamentalista 2025: Framework Completo para Ações Brasileiras' description: 'Domine análise fundamentalista de ações! Framework completo com P/L, ROE, EBITDA, margens e indicadores essenciais. Guia prático para investir melhor na bolsa brasileira ✓' date: '2025-08-22' keywords: 'análise fundamentalista, framework análise ações, indicadores financeiros, P/L, ROE, EBITDA, margem líquida, bolsa brasileira, valuation, investimento ações, brapi' author: 'Equipe brapi.dev' category: 'Análise Fundamentalista' subcategory: 'Framework de Análise' readingTime: '22 min' tags: \['Análise Fundamentalista', 'Framework Análise', 'Bolsa Brasileira', 'Indicadores', 'Investimentos', 'Valuation', 'Múltiplos'] relatedPosts: \['entendendo-indicador-preco-lucro-pl-analise-fundamentalista', 'roe-retorno-sobre-patrimonio-como-analisar', 'guia-completo-indicadores-fundamentalistas-bovespa'] featured: true expertise: 'Framework de análise fundamentalista com 8+ anos de experiência no mercado brasileiro' lastReviewed: 2026-01-03 howToSteps: * name: 'Compreender os pilares da análise fundamentalista' text: 'Estude os três pilares: análise quantitativa (demonstrações financeiras, indicadores), análise qualitativa (gestão, vantagem competitiva) e análise macroeconômica (cenário econômico, juros, inflação).' * name: 'Configurar acesso à API brapi.dev' text: 'Obtenha seu token de API em brapi.dev e configure o ambiente Python com a classe AnalisadorFundamentalista para acessar dados fundamentalistas programaticamente.' * name: 'Analisar indicadores de valuation' text: 'Calcule e interprete múltiplos como P/L, P/VP, EV/EBITDA para avaliar se a ação está cara ou barata em relação aos fundamentos.' * name: 'Avaliar indicadores de rentabilidade' text: 'Analise ROE, ROIC, margens operacionais e líquidas para entender a eficiência da empresa em gerar lucros.' * name: 'Verificar saúde financeira e endividamento' text: 'Examine índices de dívida líquida/EBITDA, cobertura de juros e estrutura de capital para avaliar riscos financeiros.' * name: 'Comparar com setor e histórico' text: 'Compare os indicadores da empresa com concorrentes do mesmo setor e com seu próprio histórico para identificar tendências e posição relativa.' * name: 'Tomar decisão de investimento' text: 'Combine análise quantitativa com fatores qualitativos para definir preço-alvo e estratégia de entrada/saída.' howToTools: * 'API brapi.dev' * 'Python ou JavaScript' * 'Planilha de análise' * 'Calculadora financeira' howToSupplies: * 'Token de acesso brapi.dev' * 'Demonstrações financeiras da empresa' * 'Dados históricos de cotações' * 'Informações setoriais' *** import { Authors, Author } from '~/components/Authors'; > A análise fundamentalista é a base para investimentos consistentes no longo prazo. Aprenda como analisar empresas usando indicadores financeiros, múltiplos de valuation e dados qualitativos para tomar decisões de investimento mais assertivas no mercado brasileiro. *** ## O que é Análise Fundamentalista? A **análise fundamentalista** é um método de avaliação de investimentos que examina fatores econômicos, financeiros e qualitativos que podem afetar o valor intrínseco de uma empresa. Diferentemente da análise técnica, que foca em padrões de preços, a análise fundamentalista busca determinar o valor real de um negócio. ### Pilares da Análise Fundamentalista #### 1. **Análise Quantitativa** * Demonstrações financeiras * Indicadores e múltiplos * Métricas de rentabilidade * Estrutura de capital #### 2. **Análise Qualitativa** * Qualidade da gestão * Vantagem competitiva * Posição no mercado * Governança corporativa #### 3. **Análise Macroeconômica** * Cenário econômico * Taxas de juros * Inflação * Políticas governamentais ## Framework de Análise com brapi.dev ### Estrutura Completa de Análise Para realizar uma análise fundamentalista completa via brapi, busque dados com os módulos relevantes: ```typescript // Buscar dados fundamentalistas completos const response = await fetch( "https://brapi.dev/api/quote/PETR4?modules=summaryProfile,defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); const { summaryProfile, defaultKeyStatistics, financialData } = results[0]; // Use os dados para sua análise fundamentalista ``` **Framework de Análise Fundamentalista:** A análise completa deve cobrir 4 dimensões principais, cada uma com seu peso no score final: | Dimensão | Peso | O que avaliar | | ----------------- | ---- | ------------------------------------ | | **Múltiplos** | 30% | P/L, P/VP, EV/EBITDA, Dividend Yield | | **Rentabilidade** | 35% | ROE, ROA, Margens | | **Endividamento** | 20% | Liquidez, Dívida/Patrimônio | | **Crescimento** | 15% | Receita, Lucro, Reinvestimento | #### Sistema de Scoring para Múltiplos | Indicador | Excelente (100) | Bom (80) | Regular (60) | Alerta (40) | Ruim (20) | | ------------------ | --------------- | -------- | ------------ | ----------- | --------- | | **P/L** | ≤ 8 | 8-12 | 12-18 | 18-25 | > 25 | | **P/VP** | ≤ 1,0 | 1,0-1,5 | 1,5-2,0 | 2,0-3,0 | > 3,0 | | **EV/EBITDA** | ≤ 6 | 6-10 | 10-15 | 15-20 | > 20 | | **Dividend Yield** | ≥ 8% | 6-8% | 4-6% | 2-4% | \< 2% | #### Sistema de Scoring para Rentabilidade | Indicador | Excelente (100) | Bom (80) | Regular (60) | Alerta (40) | Ruim (20) | | ------------------ | --------------- | -------- | ------------ | ----------- | --------- | | **ROE** | ≥ 25% | 20-25% | 15-20% | 10-15% | \< 10% | | **ROA** | ≥ 15% | 10-15% | 7-10% | 5-7% | \< 5% | | **Margem Líquida** | ≥ 20% | 15-20% | 10-15% | 5-10% | \< 5% | #### Sistema de Scoring para Endividamento | Indicador | Excelente (100) | Bom (80) | Regular (60) | Alerta (40) | Ruim (20) | | --------------------- | --------------- | -------- | ------------ | ----------- | --------- | | **Liquidez Corrente** | ≥ 2,0 | 1,5-2,0 | 1,2-1,5 | 1,0-1,2 | \< 1,0 | | **Dívida/Patrimônio** | ≤ 0,3 | 0,3-0,5 | 0,5-0,8 | 0,8-1,2 | > 1,2 | #### Sistema de Scoring para Crescimento | Crescimento Médio (Receita + Lucro) | Score | | ----------------------------------- | --------------- | | ≥ 20% | 100 (Excelente) | | 15-20% | 80 (Bom) | | 10-15% | 60 (Regular) | | 5-10% | 40 (Moderado) | | \< 5% | 20 (Baixo) | #### Cálculo do Score Final O score final é a média ponderada das 4 dimensões: ``` Score Final = (Múltiplos × 0,30) + (Rentabilidade × 0,35) + (Endividamento × 0,20) + (Crescimento × 0,15) ``` #### Sistema de Recomendações | Score Final | Recomendação | Descrição | | ----------- | ---------------- | ---------------------------------- | | ≥ 80 | **COMPRA FORTE** | Empresa com excelentes fundamentos | | 60-79 | **COMPRA** | Empresa com bons fundamentos | | 40-59 | **NEUTRO** | Empresa com fundamentos medianos | | 20-39 | **VENDA** | Empresa com fundamentos fracos | | \< 20 | **VENDA FORTE** | Empresa com fundamentos ruins | **Exemplo de Análise Completa:** | Categoria | Indicador | Valor | Score | | ----------------- | ----------------------- | ----- | ---------------- | | **Empresa** | PETR4 - Petrobras | - | - | | **Múltiplos** | P/L | 4,5x | 100 | | | P/VP | 1,2x | 80 | | | EV/EBITDA | 3,8x | 100 | | | Dividend Yield | 12,5% | 100 | | | **Média Múltiplos** | - | **95** | | **Rentabilidade** | ROE | 28,5% | 100 | | | ROA | 12,3% | 80 | | | Margem Líquida | 18,5% | 80 | | | **Média Rentabilidade** | - | **87** | | **Endividamento** | Liquidez Corrente | 1,35x | 60 | | | Dívida/Patrimônio | 0,65x | 60 | | | **Média Endividamento** | - | **60** | | **Crescimento** | Receita TTM | +15% | 80 | | | Lucro TTM | +22% | 100 | | | **Média Crescimento** | - | **90** | | **SCORE FINAL** | - | - | **83,5** | | **RECOMENDAÇÃO** | - | - | **COMPRA FORTE** | ## Análise de Demonstrações Financeiras ### Demonstração de Resultados (DRE) Para analisar a DRE, busque o módulo `incomeStatementHistory`: ```typescript // Buscar demonstrações de resultado históricos const response = await fetch( "https://brapi.dev/api/quote/WEGE3?modules=incomeStatementHistory", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); const incomeStatements = results[0].incomeStatementHistory; // Analise os últimos 3 anos de resultados ``` **Estrutura de Análise da DRE:** | Campo | Descrição | Como Calcular Margem | | --------------------- | ----------------- | --------------------------- | | **Receita Líquida** | `totalRevenue` | Base (100%) | | **Lucro Bruto** | `grossProfit` | Lucro Bruto ÷ Receita × 100 | | **Lucro Operacional** | `operatingIncome` | Lucro Op. ÷ Receita × 100 | | **Lucro Líquido** | `netIncome` | Lucro Líq. ÷ Receita × 100 | **Exemplo de Análise DRE (3 anos):** | Ano | Receita (R$ B) | Lucro Líquido (R$ B) | Margem Líquida | | ---- | -------------- | -------------------- | -------------- | | 2024 | 35,2 | 5,8 | 16,5% | | 2023 | 32,1 | 5,2 | 16,2% | | 2022 | 28,5 | 4,5 | 15,8% | **Tendências a Observar:** | Métrica | Cálculo | O que Indica | | ----------------------- | --------------------------------------------- | ------------------------------- | | **Crescimento Receita** | (Receita Ano - Receita Ano-1) ÷ Receita Ano-1 | Expansão do negócio | | **Crescimento Lucro** | (Lucro Ano - Lucro Ano-1) ÷ Lucro Ano-1 | Eficiência operacional | | **Evolução Margem** | Margem Ano - Margem Ano-1 (em p.p.) | Melhoria/piora de rentabilidade | ### Balanço Patrimonial Para analisar o balanço, busque o módulo `balanceSheetHistory`: ```typescript // Buscar balanço patrimonial const response = await fetch( "https://brapi.dev/api/quote/ITUB4?modules=balanceSheetHistory", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); const balanceSheets = results[0].balanceSheetHistory?.balanceSheetStatements; // Analise a estrutura patrimonial ``` **Campos Principais do Balanço:** | Campo | Chave API | Descrição | | ---------------------- | ------------------------- | ------------------------- | | **Ativo Circulante** | `totalCurrentAssets` | Bens de curto prazo | | **Ativo Total** | `totalAssets` | Todos os bens da empresa | | **Passivo Circulante** | `totalCurrentLiabilities` | Obrigações de curto prazo | | **Dívida Total** | `totalLiab` | Todas as obrigações | | **Patrimônio Líquido** | `totalStockholderEquity` | Valor dos acionistas | **Indicadores Calculados do Balanço:** | Indicador | Fórmula | Interpretação | | ---------------------- | ------------------------------- | -------------------- | | **Liquidez Corrente** | Ativo Circ. ÷ Passivo Circ. | > 1,0 = saudável | | **Debt to Equity** | Dívida ÷ Patrimônio | \< 1,0 = conservador | | **% Ativo Circulante** | Ativo Circ. ÷ Ativo Total × 100 | > 50% = mais líquido | **Exemplo de Análise do Balanço:** | Indicador | Valor | Avaliação | | ------------------ | ------------ | -------------------------- | | Ativo Total | R$ 2.150,5 B | - | | Patrimônio Líquido | R$ 185,2 B | - | | Dívida Total | R$ 1.965,3 B | Alto (normal para bancos) | | Liquidez Corrente | 1,15x | Adequada | | Debt/Equity | 10,6x | Típico para setor bancário | ```` ## Screening Fundamentalista Avançado ### Sistema de Filtros Múltiplos Para fazer screening fundamentalista, busque dados de múltiplas ações: ```typescript // Buscar dados de múltiplas ações para screening const acoes = ["PETR4", "VALE3", "ITUB4", "WEGE3", "EGIE3"]; const tickersParam = acoes.join(","); const response = await fetch( `https://brapi.dev/api/quote/${tickersParam}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // Aplique seus critérios de filtro aos resultados ```` **Critérios de Screening Fundamentalista:** | Categoria | Critério | Limite | Objetivo | | ----------------- | -------------------------- | ------ | ------------------------ | | **Múltiplos** | P/L Máximo | ≤ 20 | Evitar ações caras | | | P/VP Máximo | ≤ 3,0 | Evitar prêmio excessivo | | | EV/EBITDA Máximo | ≤ 15 | Valuation razoável | | **Rentabilidade** | ROE Mínimo | ≥ 15% | Alta eficiência | | | Margem Líquida Mínima | ≥ 5% | Lucratividade | | **Endividamento** | Liquidez Mínima | ≥ 1,2 | Saúde financeira | | | Dívida/Patrimônio Máximo | ≤ 1,0 | Endividamento controlado | | **Crescimento** | Crescimento Receita Mínimo | ≥ 0% | Pelo menos estável | **Universo Sugerido para Screening (Top Liquidez Brasileira):** | Setor | Ações Sugeridas | | --------------- | --------------------------- | | **Commodities** | PETR4, VALE3, SUZB3, KLBN11 | | **Financeiro** | ITUB4, BBDC4, BBAS3, SANB11 | | **Consumo** | ABEV3, LREN3, MGLU3, BRFS3 | | **Utilities** | EGIE3, SBSP3, CPLE6, TAEE11 | | **Industrial** | WEGE3, EMBR3, GGBR4, USIM5 | | **Logística** | RAIL3, RENT3, GOAU4 | **Exemplo de Resultado de Screening:** | Pos | Ticker | Score | P/L | ROE | DY | Recomendação | | --- | ------ | ----- | ----- | ----- | ----- | ------------ | | 1 | WEGE3 | 82,5 | 25,3x | 28,5% | 1,8% | COMPRA FORTE | | 2 | EGIE3 | 78,2 | 8,5x | 22,1% | 5,2% | COMPRA | | 3 | ITUB4 | 72,8 | 9,2x | 21,5% | 4,2% | COMPRA | | 4 | PETR4 | 68,5 | 4,5x | 28,5% | 12,5% | COMPRA | | 5 | TAEE11 | 65,2 | 7,8x | 18,2% | 9,8% | COMPRA | **Processo de Screening:** 1. Defina seu universo de ações (por liquidez, setor, índice) 2. Aplique filtros eliminatórios (P/L max, ROE min, etc.) 3. Calcule score para ações que passaram nos filtros 4. Ordene por score decrescente 5. Analise qualitativamente o top 10 ``` ## Análise Qualitativa ### Framework de Avaliação Qualitativa Além dos números, a análise qualitativa é essencial para entender o contexto do negócio: **Critérios de Avaliação Qualitativa:** | Critério | Peso | Fatores a Avaliar | |----------|------|-------------------| | **Gestão** | 25% | Histórico, transparência, estratégia, governança | | **Vantagem Competitiva** | 30% | Diferenciação, barreiras de entrada, posição de mercado, distribuição | | **Mercado** | 20% | Tamanho, crescimento, competitividade, regulamentação | | **Financeiro Qualitativo** | 15% | Qualidade dos lucros, geração de caixa, política de dividendos | | **Sustentabilidade** | 10% | Práticas ESG, responsabilidade social, compliance | **Exemplos de Análise Qualitativa:** | Empresa | Critério | Score | Comentário | |---------|----------|-------|------------| | **WEGE3** | Gestão | 90 | Gestão familiar profissionalizada, foco em inovação | | | Vantagem Competitiva | 85 | Líder em motores elétricos, marca forte, P&D robusto | | | Mercado | 80 | Mercado de automação industrial em crescimento | | **VALE3** | Gestão | 70 | Governança melhorada pós-Brumadinho | | | Vantagem Competitiva | 95 | Baixo custo de produção, reservas de qualidade | | | Mercado | 60 | Mercado cíclico, dependência da China | **Perguntas-Chave para Análise Qualitativa:** | Área | Perguntas | |------|-----------| | **Gestão** | A gestão tem track record? Comunicação transparente? Estratégia clara? | | **Vantagem Competitiva** | O que diferencia a empresa? É difícil de copiar? Tem pricing power? | | **Mercado** | O mercado está crescendo? Há muitos concorrentes? Regulação favorável? | | **Riscos** | Quais são os principais riscos? Concentração de clientes? Dependência cambial? | ``` ## Relatório de Análise Completa ### Gerador de Relatório Automático ```typescript const response = await fetch( 'https://brapi.dev/api/quote/WEGE3?modules=summaryProfile,defaultKeyStatistics,financialData,balanceSheetHistory,incomeStatementHistory', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Dados completos para montar relatório de análise ``` #### Estrutura do Relatório de Análise Um relatório fundamentalista completo deve conter: | Seção | Conteúdo | Fonte de Dados | | -------------------- | ------------------------------------------ | ---------------------- | | **Resumo Executivo** | Score final, classificação, recomendação | Análise consolidada | | **Dados da Empresa** | Setor, indústria, market cap, funcionários | `summaryProfile` | | **Múltiplos** | P/L, P/VP, EV/EBITDA, Dividend Yield | `defaultKeyStatistics` | | **Rentabilidade** | ROE, ROA, margens | `financialData` | | **Endividamento** | Dívida/PL, dívida líquida/EBITDA | `balanceSheetHistory` | | **Demonstrações** | DRE resumida, balanço patrimonial | Módulos específicos | #### Critérios de Classificação | Score | Classificação | Descrição | | ----- | ------------- | ------------------------------------------------ | | ≥ 80 | **Excelente** | Empresa de alta qualidade em todos os critérios | | 60-79 | **Boa** | Fundamentos sólidos com alguns pontos de atenção | | 40-59 | **Mediana** | Requer análise mais detalhada antes de investir | | \< 40 | **Fraca** | Fundamentos preocupantes, alto risco | #### Identificação de Pontos Fortes e Fracos **Pontos Fortes (score > 70):** * ✅ Múltiplos de valuation atrativos * ✅ Alta rentabilidade e eficiência operacional * ✅ Estrutura de capital sólida **Pontos de Atenção (score \< 40):** * ⚠️ Múltiplos de valuation elevados * ⚠️ Rentabilidade abaixo da média * ⚠️ Endividamento elevado ## Conclusão A análise fundamentalista é uma ferramenta poderosa para identificar empresas de qualidade e oportunidades de investimento no longo prazo. Através da combinação de análise quantitativa e qualitativa, é possível tomar decisões mais informadas e consistentes. ### Pontos-Chave da Análise Fundamentalista: 1. **Visão Holística**: Combine múltiplos, rentabilidade, endividamento e crescimento 2. **Contexto Setorial**: Compare sempre com empresas do mesmo setor 3. **Análise Temporal**: Observe tendências históricas, não apenas dados pontuais 4. **Fatores Qualitativos**: Gestão e vantagem competitiva são fundamentais 5. **Disciplina**: Mantenha critérios consistentes e objetivos ### Próximos Passos: * **[Explore nossa API completa](/docs)** para dados fundamentalistas detalhados * **[Use nossa plataforma](/quotes)** para análises interativas * **Implemente os frameworks** apresentados neste guia * **Combine com análise setorial** para maior precisão ### Recursos Adicionais: * **[Dados históricos](/docs)** para análise de tendências * **[Módulos especializados](/docs/acoes)** para diferentes tipos de análise * **[Exemplos práticos](/docs/examples)** de implementação **Lembre-se**: A análise fundamentalista requer tempo e dedicação. Não há atalhos para uma análise de qualidade, mas com as ferramentas certas e metodologia consistente, os resultados compensam o esforço investido! # Análise do Setor de Commodities Brasil 2026: VALE3, SUZB3, KLBN11 e Mais URL: /blog/analise-setor-commodities-brasil.mdx Análise completa do setor de commodities brasileiro com indicadores específicos, comparativo entre empresas e código Python para automatizar análises ✓ *** searchable: true title: 'Análise do Setor de Commodities Brasil 2026: VALE3, SUZB3, KLBN11 e Mais' description: 'Análise completa do setor de commodities brasileiro com indicadores específicos, comparativo entre empresas e código Python para automatizar análises ✓' date: '2026-01-01' keywords: 'setor commodities brasil 2026, VALE3, SUZB3, KLBN11, CSNA3, análise commodities, ações commodities, vale, suzano, klabin, mineração, celulose' author: 'Equipe brapi.dev' category: 'Análise Setorial' subcategory: 'Commodities' readingTime: '22 min' tags: \['Commodities', 'Análise Setorial', 'VALE3', 'SUZB3', 'KLBN11', 'Mineração', 'Celulose', 'Ações', 'Bolsa Brasileira'] relatedPosts: \['acoes-bancos-analise-setorial-2026', 'analise-setor-varejo-brasil', 'analise-setor-saude-brasil', 'value-investing-como-encontrar-acoes-baratas', 'indicador-ev-ebitda-como-analisar'] featured: true expertise: 'Especialistas em análise setorial do mercado brasileiro' lastReviewed: 2026-01-03 ------------------------ import { Callout } from 'fumadocs-ui/components/callout'; ## Introdução ao Setor de Commodities Brasileiro O Brasil é uma potência global em commodities, sendo um dos maiores produtores e exportadores mundiais de minério de ferro, celulose, soja, carne e petróleo. Para investidores, o setor oferece exposição ao ciclo econômico global e proteção natural contra desvalorização do real. Neste guia completo, vamos analisar: * Panorama do setor de commodities no Brasil * Principais subsegmentos e empresas * Indicadores específicos do setor * Comparativo detalhado entre concorrentes * Código Python para automatizar análises ``` ┌─────────────────────────────────────────────────────────────────┐ │ ECOSSISTEMA DE COMMODITIES BRASILEIRO │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ MINERAÇÃO PAPEL E CELULOSE SIDERURGIA │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ VALE3 │ │ SUZB3 │ │ CSNA3 │ │ │ │ CMIN3 │ │ KLBN11 │ │ GGBR4 │ │ │ │ │ │ RANI3 │ │ USIM5 │ │ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │ │ │ PETRÓLEO E GÁS AGRONEGÓCIO FRIGORÍFICOS │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ PETR4 │ │ SLCE3 │ │ JBSS3 │ │ │ │ PRIO3 │ │ AGRO3 │ │ BRFS3 │ │ │ │ RECV3 │ │ SMTO3 │ │ MRFG3 │ │ │ │ ENAT3 │ │ TTEN3 │ │ BEEF3 │ │ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` ## Por Que Investir em Commodities? ### Características do Setor | Característica | Descrição | Impacto | | -------------- | ------------------------------ | ----------------- | | Ciclicidade | Preços seguem ciclos globais | Alta volatilidade | | Dólar | Receitas em USD, custos em BRL | Hedge natural | | Escala | Empresas de grande porte | Alta liquidez | | Dividendos | Distribuição em picos de ciclo | Yields variáveis | | Barreiras | Alto CAPEX inicial | Oligopólios | ### Proteção Cambial Natural **Exemplo: Dólar sobe de R$ 5,00 para R$ 6,00 (+20%)** | Item | Valor | | ---------------------------- | ------------------------------------ | | Receita (USD 1 bi × R$ 5,00) | R$ 5,0 bilhões | | Receita (USD 1 bi × R$ 6,00) | R$ 6,0 bilhões (+20%) | | Custos (em BRL) | R$ 3,0 bilhões (estável) | | Lucro antes | R$ 2,0 bilhões | | Lucro depois | R$ 3,0 bilhões (**+50%**) | | **Alavancagem** | **2,5x** (lucro sobe mais que dólar) | **Efeito alavancagem:** Como custos são em reais e receitas em dólares, o lucro cresce proporcionalmente mais que a variação cambial. ``` EFEITO DO DÓLAR NO LUCRO DE EXPORTADORAS Cenário: Dólar sobe de R$ 5,00 para R$ 6,00 (+20%) ┌────────────────────────────────────────────────────────┐ │ │ │ RECEITA (USD → BRL) │ │ ████████████████████████████████████ +20% │ │ │ │ CUSTOS (BRL) │ │ ████████████████████████ 0% (estável) │ │ │ │ LUCRO │ │ ████████████████████████████████████████████ +50%+ │ │ │ │ → Lucro cresce MAIS que o dólar (alavancagem) │ │ │ └────────────────────────────────────────────────────────┘ ``` ## Análise dos Principais Subsegmentos ### 1. Mineração - VALE3, CMIN3 A Vale é a maior exportadora de minério de ferro do mundo e uma das maiores mineradoras globais. **Indicadores VALE3 (Dezembro 2026):** * Preço: R$ 71,96 * P/L: 10,82 * P/VP: 1,50 * Dividend Yield: 10,59% * ROE: 13,84% * Dívida Líq./EBITDA: 1,11x **Drivers do Preço do Minério:** | Fator | Detalhes | | ----------------------- | ------------------------------------------------------------------------------------- | | **Demanda China** | 65% do consumo global. Indicadores: PMI industrial, produção de aço, construção civil | | **Oferta global** | Top 3 (Vale, Rio Tinto, BHP) = 60% da oferta mundial | | **Custo produção Vale** | \~USD 20,5/ton (C1 cost) vs preço \~USD 100/ton → margem de \~USD 80/ton | | **Qualidade Vale** | Teor de ferro 65% vs média mercado 62% → prêmio de qualidade | **Riscos Específicos:** * Dependência da China (65%+ das exportações) * Preço do minério volátil * Passivos ambientais (Brumadinho, Mariana) * Transição energética (longo prazo) ### 2. Papel e Celulose - SUZB3, KLBN11 A Suzano é a maior produtora de celulose do mundo, e a Klabin combina celulose com papéis e embalagens. **Indicadores SUZB3 (Dezembro 2026):** * Preço: R$ 51,45 * P/L: 9,93 * P/VP: 1,44 * Dividend Yield: 2,17% * ROE: 14,52% * Margem EBITDA: 73,45% * Dívida Líq./EBITDA: 1,85x **Ciclo da Celulose:** ``` CICLO DO PREÇO DA CELULOSE Preço USD/ton │ 1200├─────────────────────────────────●──────────── │ ╱ ╲ 1000├─────────────────────────●───╱ ╲───────── │ ╱ ╲ 800├───────────────●─────╯ ╲──── │ ╱ ╲ 600├─────●─────╯ ╲─ │ ╱ 400├─●────────────────────────────────────────── │ └──2019──2020──2021──2022──2023──2024──2026── FASES DO CICLO: 1. Baixa demanda → Preços caem → Produtores cortam CAPEX 2. Oferta reduz → Estoques baixam → Preços sobem 3. Alta margem → Produtores investem → Nova capacidade 4. Oferta sobe → Preços caem → Ciclo reinicia Duração média do ciclo: 5-7 anos ``` **Diferenças SUZB3 vs KLBN11:** | Aspecto | SUZB3 (Suzano) | KLBN11 (Klabin) | | ---------------- | --------------- | --------------------- | | Foco | Celulose pura | Celulose + Embalagens | | Receita celulose | \~90% | \~50% | | Ciclicidade | Alta | Média | | Margem EBITDA | 70-75% | 35-40% | | Dividend Yield | 2-4% | 4-7% | | Dívida | Mais alavancada | Moderada | ### 3. Siderurgia - CSNA3, GGBR4, USIM5 As siderúrgicas transformam minério em aço para construção civil, automotivo e infraestrutura. **Cadeia Produtiva Siderúrgica:** | Etapa | Empresas | Margem EBITDA Típica | Posição | | ---------------- | ------------------- | -------------------- | ------------- | | **Mineração** | VALE3 | 45-55% | Fornecedor | | **Siderurgia** | CSNA3, GGBR4, USIM5 | 15-25% | Transformação | | **Distribuição** | GOAU4 | 3-8% | Intermediário | **Spread aço vs minério:** Preço aço (\~R$ 4.500/ton) menos custo minério (\~R$ 900/ton para 1,5 ton) = \~R$ 3.600/ton de spread. Quando spread comprime, margens da siderurgia caem. ### 4. Petróleo e Gás - PETR4, PRIO3 O setor de óleo e gás é dominado pela Petrobras, mas juniors como PRIO crescem rapidamente. **Comparativo Petróleo:** ```typescript // Comparar empresas de petróleo via brapi.dev const tickers = ["PETR4", "PRIO3", "RECV3", "RRRP3", "ENAT3"]; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(",")}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); // Ordenar por EV/EBITDA para encontrar mais baratas const ranking = results .map(e => ({ ticker: e.symbol, evEbitda: e.defaultKeyStatistics?.enterpriseToEbitda ?? null, dy: e.defaultKeyStatistics?.dividendYield })) .sort((a, b) => (a.evEbitda || 999) - (b.evEbitda || 999)); ``` ## Indicadores Específicos para Commodities ### 1. Cash Cost (Custo Caixa) O custo caixa por unidade produzida é fundamental para avaliar competitividade: **Exemplo: Vale - Minério de Ferro** | Métrica | Valor | | ------------------- | ------------------------ | | Custo total anual | USD 4,1 bilhões | | Produção | 200 milhões de toneladas | | **Cash Cost** | **USD 20,50/ton** | | Preço de venda | USD 100/ton | | Margem unitária | USD 79,50/ton (79,5%) | | Breakeven | USD 20,50/ton | | Buffer vs breakeven | **+388%** (muito seguro) | Empresas com cash cost baixo sobrevivem aos vales do ciclo enquanto concorrentes de custo alto quebram. ### 2. Dívida Líquida/EBITDA Fundamental para commodities cíclicas - empresas precisam sobreviver aos vales: **Limites por Setor:** | Setor | Ideal | Aceitável | Risco | | ---------- | ------- | --------- | ------ | | Mineração | \< 1,0x | \< 2,0x | > 3,0x | | Petróleo | \< 1,5x | \< 2,5x | > 3,5x | | Celulose | \< 2,0x | \< 3,0x | > 4,0x | | Siderurgia | \< 1,5x | \< 2,5x | > 3,5x | **Exemplos atuais:** * VALE3: 1,1x → Excelente * SUZB3: 1,9x → Aceitável Celulose tolera mais dívida porque o ciclo é mais longo e previsível. Mineração precisa de balanço limpo pela alta volatilidade do minério. ### 3. EBITDA/Tonelada Mede eficiência operacional de forma comparável entre empresas do mesmo setor. Quanto maior o EBITDA por tonelada produzida, mais eficiente é a operação. ## Análise Comparativa com brapi.dev ```typescript // Obter dados do setor de commodities const tickers = [ "VALE3", "CMIN3", // Mineração "SUZB3", "KLBN11", "RANI3", // Papel e Celulose "CSNA3", "GGBR4", "USIM5", // Siderurgia "PETR4", "PRIO3", // Petróleo "JBSS3", "BRFS3" // Frigoríficos ]; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(",")}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); // Criar ranking por EV/EBITDA const ranking = results .map(e => ({ ticker: e.symbol, setor: identificarSetor(e.symbol), evEbitda: e.defaultKeyStatistics?.enterpriseToEbitda?.toFixed(2) ?? null, dy: e.defaultKeyStatistics?.dividendYield, margem: e.financialData?.profitMargins })) .sort((a, b) => (a.evEbitda || 999) - (b.evEbitda || 999)); ``` **Setores por ticker:** | Ticker | Setor | | -------------------- | ------------ | | VALE3, CMIN3 | Mineração | | SUZB3, KLBN11, RANI3 | Celulose | | CSNA3, GGBR4, USIM5 | Siderurgia | | PETR4, PRIO3 | Petróleo | | JBSS3, BRFS3 | Frigoríficos | ``` ## Estratégias de Investimento ### Estratégia 1: Ciclo de Commodities **Identificando a Fase do Ciclo:** | Preço vs Média 5 Anos | Estoques | Demanda | Fase | Ação | |----------------------|----------|---------|------|------| | < -20% | Alto | Baixa | **FUNDO** | Acumular low-cost producers | | -20% a 0% | Médio | Crescendo | **RECUPERAÇÃO** | Aumentar exposição | | 0% a +30% | Baixo | Alta | **EXPANSÃO** | Manter, colher dividendos | | > +30% | Baixo | Alta | **PICO** | Realizar lucros parciais | **Exemplo atual - Minério de ferro:** - Preço: USD 100/ton - Média 5 anos: USD 110/ton - Posição: -9% vs média → **Fase de recuperação** se demanda crescer ``` ### Estratégia 2: Produtores de Baixo Custo Filtre empresas com **margem EBITDA no quartil superior** do setor (top 25%). Essas empresas: * Sobrevivem aos vales do ciclo * Ganham market share quando concorrentes quebram * Expandem quando commodity volta a subir **Critério prático:** Margem EBITDA > média do setor + 10 pontos percentuais ### Estratégia 3: Dividendos em Pico de Ciclo **Cuidado com dividend yields muito altos em commodities!** DY de 15%+ geralmente indica pico de ciclo, não sustentabilidade. **Como identificar:** | Preço Commodity vs Média 3 Anos | DY Atual | Avaliação | | ------------------------------- | -------- | --------------------------------- | | > +30% | > 10% | ⚠️ DY alto pode ser insustentável | | -20% a +30% | 4-8% | ✅ Provavelmente sustentável | | \< -20% | \< 3% | ✅ Normal em baixa de ciclo | ## Riscos Específicos do Setor ### 1. Risco de Preço de Commodity ``` VOLATILIDADE HISTÓRICA (12 meses) Minério de Ferro ████████████████████████████████ 40-60% Petróleo ██████████████████████████ 30-45% Celulose ████████████████████ 25-35% Aço ██████████████████████████ 30-40% Comparação: Ibovespa ██████████████ 20-25% Renda Fixa ████ 5-8% ``` ### 2. Risco China **Exposição à demanda chinesa:** | Ticker | Exposição China | Nível de Risco | Impacto se China Desacelerar | | ------ | --------------- | -------------- | ---------------------------- | | VALE3 | 65% | Alto | Alto | | SUZB3 | 35% | Moderado | Moderado | | JBSS3 | 25% | Moderado | Moderado | | CSNA3 | 10% | Baixo | Baixo | | PETR4 | 5% | Baixo | Baixo | ### 3. Risco Cambial **Cenários de impacto do dólar (empresa com 85% receita USD, 25% custo USD):** | Cenário | Variação Dólar | Impacto Lucro | Lucro Estimado\* | | -------------- | -------------- | ------------- | ---------------- | | Dólar cai 10% | -10% | -6,0% | R$ 28,2 bi | | Estável | 0% | 0% | R$ 30,0 bi | | Dólar sobe 10% | +10% | +6,0% | R$ 31,8 bi | | Dólar sobe 20% | +20% | +12,0% | R$ 33,6 bi | \*Base: lucro de R$ 30 bi **Fórmula simplificada:** Impacto líquido = (% receita USD × variação) - (% custo USD × variação) ```` ## Dashboard de Monitoramento ```typescript // Dashboard consolidado do setor de commodities const tickers = ["VALE3", "SUZB3", "KLBN11", "CSNA3", "PETR4", "PRIO3", "JBSS3"]; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(",")}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); // Agrupar por segmento const segmentos = { "Mineração": results.filter(e => ["VALE3"].includes(e.symbol)), "Celulose": results.filter(e => ["SUZB3", "KLBN11"].includes(e.symbol)), "Siderurgia": results.filter(e => ["CSNA3"].includes(e.symbol)), "Petróleo": results.filter(e => ["PETR4", "PRIO3"].includes(e.symbol)), "Frigoríficos": results.filter(e => ["JBSS3"].includes(e.symbol)) }; // Calcular métricas por segmento Object.entries(segmentos).forEach(([setor, empresas]) => { const variacaoMedia = empresas.reduce((sum, e) => sum + (e.regularMarketChangePercent || 0), 0) / empresas.length; const dyMedio = empresas.reduce((sum, e) => sum + (e.defaultKeyStatistics?.dividendYield || 0), 0) / empresas.length; console.log(`${setor}: Variação ${variacaoMedia.toFixed(2)}% | DY ${dyMedio.toFixed(2)}%`); }); ```` ## Conclusão: Investindo em Commodities O setor de commodities brasileiro oferece exposição única ao crescimento global e proteção cambial: ### Resumo por Subsegmento | Subsegmento | Destaque | Risco Principal | Momento | | ------------ | ----------- | ------------------- | ---------- | | Mineração | VALE3 | Preço minério/China | Neutro | | Celulose | SUZB3 | Ciclo de preços | Favorável | | Siderurgia | GGBR4 | Spread aço/minério | Desafiador | | Petróleo | PETR4/PRIO3 | Preço do petróleo | Estável | | Frigoríficos | JBSS3 | Sanidade/Tarifas | Atenção | ### Critérios de Seleção 1. **Custo no quartil inferior** do setor 2. **Dívida Líq./EBITDA \< 2.0x** 3. **ROE consistente** (> 12% na média do ciclo) 4. **Exposição cambial favorável** (receita USD > custos USD) 5. **Dividend Yield sustentável** (não apenas no pico) ### Quando Investir * ✅ Commodity em baixa de ciclo (acumular low-cost producers) * ✅ Dólar se fortalecendo vs Real * ✅ Valuations abaixo da média histórica * ⚠️ Cuidado com DY muito alto (pico de ciclo) * ❌ Evitar empresas muito alavancadas em baixa de ciclo ## Próximos Passos Para aprofundar sua análise de commodities: 1. **Acesse a brapi.dev** - Dados fundamentalistas atualizados 2. **Monitore preços das commodities** - Referência global 3. **Acompanhe câmbio e China** - Principais drivers 4. **Automatize com Python** - Use os códigos deste guia A [brapi.dev](https://brapi.dev) oferece todos os dados necessários para análise profunda das empresas de commodities listadas na bolsa brasileira. *** *Disclaimer: Este conteúdo é educacional. Commodities são voláteis - diversifique e faça sua própria análise.* # Análise do Setor de Saúde Brasil 2026: HAPV3, RDOR3, FLRY3 e Mais URL: /blog/analise-setor-saude-brasil.mdx Análise completa do setor de saúde brasileiro com indicadores específicos, comparativo entre empresas e código Python para automatizar suas análises ✓ *** searchable: true title: 'Análise do Setor de Saúde Brasil 2026: HAPV3, RDOR3, FLRY3 e Mais' description: 'Análise completa do setor de saúde brasileiro com indicadores específicos, comparativo entre empresas e código Python para automatizar suas análises ✓' date: '2026-01-01' keywords: 'setor saúde brasil 2026, HAPV3, RDOR3, FLRY3, QUAL3, ações saúde, hapvida, rede dor, fleury, análise setorial' author: 'Equipe brapi.dev' category: 'Análise Setorial' subcategory: 'Saúde' readingTime: '20 min' tags: \['Saúde', 'Análise Setorial', 'HAPV3', 'RDOR3', 'FLRY3', 'Ações', 'Bolsa Brasileira'] relatedPosts: \['acoes-bancos-analise-setorial-2026', 'analise-setor-varejo-brasil', 'analise-setor-tecnologia-brasil', 'analise-setor-commodities-brasil', 'value-investing-como-encontrar-acoes-baratas'] featured: true expertise: 'Especialistas em análise setorial do mercado brasileiro' lastReviewed: 2026-01-03 ------------------------ ## Introdução ao Setor de Saúde Brasileiro O setor de saúde é um dos mais defensivos e resilientes da bolsa brasileira. Com o envelhecimento da população e aumento da demanda por serviços médicos, empresas bem posicionadas podem oferecer crescimento consistente por décadas. Neste guia completo, vamos analisar: * Panorama do setor de saúde no Brasil * Principais subsegmentos e empresas * Indicadores específicos do setor * Comparativo detalhado entre concorrentes * Código Python para automatizar análises ``` ┌─────────────────────────────────────────────────────────────────┐ │ ECOSSISTEMA DE SAÚDE BRASILEIRO │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ OPERADORAS DE HOSPITAIS E DIAGNÓSTICOS │ │ PLANOS DE SAÚDE CLÍNICAS E LABS │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ HAPV3 │ │ RDOR3 │ │ FLRY3 │ │ │ │ QUAL3 │ │ MATD3 │ │ AALR3 │ │ │ │ GNDI3* │ │ ONCO3 │ │ PARD3 │ │ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │ │ │ FARMÁCIAS ODONTOLOGIA OUTROS │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ RADL3 │ │ ODPV3 │ │ HYPE3 │ │ │ │ PNVL3 │ │ │ │ BLAU3 │ │ │ │ PGMN3 │ │ │ │ VVEO3 │ │ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │ │ │ * GNDI3 fundiu com HAPV3 │ └─────────────────────────────────────────────────────────────────┘ ``` ## Por Que o Setor de Saúde é Atrativo? ### Drivers Estruturais de Longo Prazo ``` FATORES QUE IMPULSIONAM O SETOR 📈 DEMOGRÁFICOS ├── Envelhecimento populacional ├── Aumento da expectativa de vida ├── Maior incidência de doenças crônicas └── População 60+ cresce 3x mais que média 💰 ECONÔMICOS ├── Crescimento da renda média ├── Expansão da classe média ├── Maior capacidade de pagar planos └── Formalização do emprego 🏥 ESTRUTURAIS ├── Subpenetração de planos de saúde ├── SUS sobrecarregado ├── Migração para planos privados └── Consolidação do setor 📊 NÚMEROS DO SETOR ├── ~50 milhões com plano de saúde ├── ~25% da população coberta ├── Gasto per capita cresce 8% a.a. └── Mercado de R$ 300+ bilhões ``` ### Características Defensivas | Característica | Por Quê É Defensivo | | -------------------- | ---------------------------------------------- | | Demanda inelástica | Saúde é prioridade, pessoas não deixam de usar | | Receita recorrente | Mensalidades de planos são previsíveis | | Baixa correlação PIB | Demanda menos afetada por recessões | | Envelhecimento | Tendência estrutural irreversível | | Barreiras de entrada | Regulação, capital, know-how | ## Análise dos Principais Subsegmentos ### 1. Operadoras de Planos de Saúde **Modelo de Negócio:** * Recebem mensalidades dos beneficiários * Pagam prestadores (hospitais, médicos, labs) * Lucro = Receita - Sinistralidade - Despesas **Indicador-Chave: Sinistralidade** A **taxa de sinistralidade** (MLR - Medical Loss Ratio) mede quanto da receita vai para custos médicos: **Fórmula:** Sinistralidade = (Despesas Médicas ÷ Receita Operacional) × 100 | Sinistralidade | Classificação | Interpretação | | -------------- | ------------- | ----------------------------- | | \< 70% | 🟢 Excelente | Alta margem operacional | | 70-75% | 🟢 Boa | Margem saudável | | 75-80% | 🟡 Regular | Margem apertada | | 80-85% | 🔴 Ruim | Margens pressionadas | | > 85% | 🚨 Crítico | Prejuízo operacional provável | **Exemplo:** * Despesas Médicas: R$ 7,5 bilhões * Receita Operacional: R$ 10 bilhões * Sinistralidade: 75% (Regular) * Margem Bruta: 25% ``` BENCHMARK DE SINISTRALIDADE < 70% ████████████████████████████████ Excelente 70-75% ██████████████████████████ Bom 75-80% ████████████████████ Regular 80-85% ██████████████ Ruim > 85% ████████ Crítico HAPV3 (Hapvida+GNDI): ~73-78% Médias de mercado: ~75-82% ``` ### 2. Hospitais e Clínicas **Modelo de Negócio:** * Prestam serviços médicos * Recebem de operadoras e particulares * Lucro depende de ocupação e ticket médio **Indicadores-Chave:** | Indicador | Fórmula | Ideal | | --------------------- | ------------------------------ | ---------------------- | | **Taxa de Ocupação** | Leitos Ocupados ÷ Total Leitos | 75-85% | | **Receita por Leito** | Receita ÷ Total Leitos | Quanto maior, melhor | | **Ticket Médio** | Receita ÷ Total Internações | Varia por complexidade | | Ocupação | Classificação | | -------- | ------------------- | | > 80% | 🟢 Alta eficiência | | 70-80% | 🟡 Média eficiência | | \< 70% | 🔴 Baixa eficiência | ### 3. Laboratórios e Diagnósticos **Modelo de Negócio:** * Realizam exames e diagnósticos * Alta escala e padronização * Margens dependem de volume **Indicadores-Chave:** | Indicador | Fórmula | Interpretação | | ----------------------- | ------------------------ | ------------------ | | **Receita por Unidade** | Receita ÷ Total Unidades | Produtividade | | **Ticket Médio** | Receita ÷ Total Exames | Complexidade | | **Exames por Unidade** | Total Exames ÷ Unidades | Escala operacional | | Exames/Unidade | Escala | | -------------- | -------- | | > 50.000/ano | 🟢 Alta | | \< 50.000/ano | 🟡 Média | ## Análise das Principais Empresas ### HAPV3 - Hapvida (após fusão com GNDI) A Hapvida é a maior operadora de planos de saúde do Brasil após a fusão com Notre Dame Intermédica (GNDI). **Pontos Fortes:** * Líder de mercado com \~15 milhões de beneficiários * Modelo verticalmente integrado (operadora + hospitais) * Forte presença no Nordeste e Norte * Ticket médio competitivo * Sinistralidade historicamente baixa **Pontos de Atenção:** * Integração GNDI ainda em andamento * Pressão regulatória (ANS) * Sinistralidade pressionada pós-COVID * Endividamento elevado após fusão ### RDOR3 - Rede D'Or São Luiz A Rede D'Or é a maior rede hospitalar privada da América Latina. **Pontos Fortes:** * Líder em hospitais premium * Presença nas principais capitais * Track record de aquisições * Alta qualidade assistencial * Margens superiores **Pontos de Atenção:** * Valuation premium * Dependência de operadoras de saúde * Integração de aquisições * Expansão para mercados menores ### FLRY3 - Fleury O Fleury é líder em medicina diagnóstica no Brasil. **Pontos Fortes:** * Marca premium reconhecida * Diversificação de serviços * Aquisição de Hermes Pardini (sinergia) * Alta produtividade por unidade * Gestão de excelência **Pontos de Atenção:** * Mercado competitivo * Dependência do eixo SP-RJ * Pressão de preços de operadoras * Integração Pardini ## Indicadores Específicos do Setor ### MLR (Medical Loss Ratio) - Taxa de Sinistralidade **Comparativo de Sinistralidade entre Operadoras:** | Ticker | Sinistralidade | Beneficiários | | ------ | -------------- | ------------- | | HAPV3 | \~73-75% | \~15M | | QUAL3 | \~80-82% | \~4M | > **Nota:** Menor sinistralidade = maior eficiência operacional ### Ticket Médio e Crescimento Orgânico **Análise de crescimento orgânico vs inorgânico:** | Componente | Fórmula | | ------------------------ | ----------------------------------------------------------- | | **Crescimento Total** | (Receita Atual ÷ Receita Anterior − 1) × 100 | | **Crescimento Orgânico** | ((Receita Atual − Aquisições) ÷ Receita Anterior − 1) × 100 | | **Contribuição de M\&A** | Crescimento Total − Crescimento Orgânico | | Crescimento Orgânico | Qualidade | | -------------------- | --------------------------- | | > 10% | 🟢 Alta | | 5-10% | 🟡 Média | | \< 5% | 🟠 Dependente de aquisições | ## Análise Comparativa com brapi.dev ```typescript const tickers = ['HAPV3', 'RDOR3', 'FLRY3', 'RADL3', 'PNVL3', 'ODPV3', 'QUAL3']; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(',')}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); ``` **Campos disponíveis para análise:** | Campo | Descrição | | -------------------- | ---------------- | | `regularMarketPrice` | Preço atual | | `priceEarnings` | P/L | | `priceToBook` | P/VP | | `returnOnEquity` | ROE | | `netMargin` | Margem Líquida | | `dividendYield` | Dividend Yield | | `marketCap` | Valor de Mercado | **Critérios de Score para Ranking:** | Critério | Pontos | | ------------ | ------ | | ROE > 15% | +25 | | ROE 10-15% | +15 | | P/L \< 15 | +25 | | P/L 15-25 | +15 | | Margem > 10% | +25 | | Margem 5-10% | +15 | ## Riscos Específicos do Setor ### 1. Risco Regulatório ``` RISCOS REGULATÓRIOS NO SETOR DE SAÚDE ANS (Agência Nacional de Saúde Suplementar) ├── Controle de reajustes de planos individuais ├── Fiscalização de sinistralidade ├── Rol de procedimentos obrigatórios └── Penalidades e multas ANVISA ├── Regulação de medicamentos ├── Registro de produtos └── Fiscalização sanitária CADE ├── Aprovação de fusões/aquisições ├── Análise de concentração de mercado └── Remédios para aprovação de deals ``` ### 2. Risco de Sinistralidade **Simulação de impacto de variação na sinistralidade:** Para uma operadora com R$ 10 bilhões de receita e sinistralidade de 75%: | Variação | Nova Sinistralidade | Impacto no Lucro Bruto | | -------- | ------------------- | ---------------------- | | +1pp | 76% | -R$ 100M (-4%) | | +2pp | 77% | -R$ 200M (-8%) | | +3pp | 78% | -R$ 300M (-12%) | | +5pp | 80% | -R$ 500M (-20%) | > **Conclusão:** Cada 1pp de aumento na sinistralidade pode representar 4% de queda no lucro bruto. Por isso operadoras investem tanto em controle de custos. ### 3. Risco de Judicialização O setor de saúde enfrenta crescente judicialização: * Negativas de cobertura contestadas * Procedimentos não previstos em contrato * Medicamentos de alto custo * Provisões podem impactar resultados ## Estratégias de Investimento ### Estratégia 1: Líderes de Segmento **Líderes por subsegmento no setor de saúde:** | Subsegmento | Empresas | Critério de Liderança | | ---------------- | ------------ | --------------------- | | **Operadoras** | HAPV3, QUAL3 | Maior market cap | | **Hospitais** | RDOR3, MATD3 | Rede mais extensa | | **Diagnósticos** | FLRY3, AALR3 | Volume de exames | | **Farmácias** | RADL3, PNVL3 | Quantidade de lojas | | **Odonto** | ODPV3 | Market share | > **Estratégia:** Investir nos líderes de cada subsegmento diversifica o risco e captura as melhores empresas do setor. ### Estratégia 2: Value no Setor Defensivo **Critérios para encontrar value em saúde:** | Critério | Limite | Justificativa | | -------- | ------ | --------------------------- | | P/L | \< 18 | Desconto vs média do setor | | P/VP | \< 3,0 | Não pagar premium excessivo | | ROE | > 10% | Empresa rentável | **Cálculo de upside potencial:** Upside = (P/L Alvo ÷ P/L Atual − 1) × 100 Exemplo: P/L atual 12, alvo 18 → Upside de 50% > **Dica:** O setor de saúde é defensivo (demanda inelástica), o que justifica pagar múltiplos um pouco mais altos que setores cíclicos. ## Valuation do Setor ### Múltiplos Históricos ``` EV/EBITDA MÉDIO POR SUBSEGMENTO Operadoras ██████████████ 8-12x Hospitais ████████████████████ 12-18x Diagnósticos ████████████████ 10-14x Farmácias ████████████ 8-12x ``` ### Comparação com Mercados Internacionais **P/L médio: Brasil vs EUA:** | Empresa/Mercado | P/L Médio | | --------------------- | --------- | | Brasil - Operadoras | 10x | | EUA - HCA (hospitais) | 10x | | Brasil - Labs | 12x | | EUA - Quest (labs) | 11x | | Brasil - Hospitais | 14x | | EUA - UNH (operadora) | 16x | > **Observação:** Empresas brasileiras de saúde negociam com múltiplos similares ou até com desconto em relação aos pares americanos, apesar do maior potencial de crescimento. ## Dashboard de Monitoramento Para monitorar o setor de saúde, busque as principais métricas via API: ```typescript const tickers = ['HAPV3', 'RDOR3', 'FLRY3', 'RADL3', 'PNVL3', 'ODPV3', 'QUAL3']; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(',')}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); ``` **Métricas para acompanhar no dashboard:** | Métrica | O que monitorar | | --------------- | -------------------------------------------- | | Variação do dia | Sentimento do mercado com o setor | | Maior alta | Empresa com momentum positivo | | Maior queda | Possível oportunidade ou problema | | Melhor ROE | Empresa mais rentável | | Menor P/L | Empresa mais barata (cuidado com armadilhas) | ## Conclusão: Investindo em Saúde O setor de saúde brasileiro oferece combinação única de crescimento e defensividade: ### Resumo por Subsegmento | Subsegmento | Destaque | Risco Principal | | ------------ | -------- | ----------------- | | Operadoras | HAPV3 | Sinistralidade | | Hospitais | RDOR3 | Valuation premium | | Diagnósticos | FLRY3 | Competição | | Farmácias | RADL3 | Margens apertadas | ### Critérios de Seleção 1. **Sinistralidade controlada** (operadoras \< 78%) 2. **ROE consistente** (> 12%) 3. **Crescimento orgânico** (> 8% a.a.) 4. **Endividamento moderado** (Dív/EBITDA \< 2.5x) 5. **Valuation razoável** (P/L \< 20x para setor) ### Quando Investir * ✅ Empresas líderes em consolidação * ✅ Momentos de pessimismo setorial (oportunidade) * ✅ Tese de envelhecimento populacional * ⚠️ Cuidado com valuation esticados após altas ## Próximos Passos Para aprofundar sua análise do setor de saúde: 1. **Crie conta na brapi.dev** - Dados fundamentalistas completos 2. **Acompanhe releases trimestrais** - Sinistralidade é key 3. **Monitore regulação ANS** - Impacta operadoras 4. **Automatize com Python** - Use os códigos deste guia A [brapi.dev](https://brapi.dev) oferece todos os dados necessários para análise profunda das empresas de saúde listadas na bolsa brasileira. *** *Disclaimer: Este conteúdo é educacional. Faça sua própria análise antes de investir.* # Análise do Setor de Tecnologia Brasileiro 2026: TOTS3, LWSA3, POSI3 e Mais URL: /blog/analise-setor-tecnologia-brasil.mdx Guia completo das ações de tecnologia brasileiras ✓ Análise fundamentalista de TOTS3, LWSA3, POSI3, CASH3 e MLAS3 com indicadores e perspectivas *** searchable: true title: 'Análise do Setor de Tecnologia Brasileiro 2026: TOTS3, LWSA3, POSI3 e Mais' description: 'Guia completo das ações de tecnologia brasileiras ✓ Análise fundamentalista de TOTS3, LWSA3, POSI3, CASH3 e MLAS3 com indicadores e perspectivas' date: '2026-01-01' keywords: 'ações tecnologia brasil 2026, TOTS3, LWSA3, POSI3, CASH3, MLAS3, setor tech brasileiro, software brasil, SaaS brasileiro' author: 'Equipe brapi.dev' category: 'Análise Setorial' subcategory: 'Tecnologia' readingTime: '25 min' tags: \['Tecnologia', 'Análise Setorial', 'TOTS3', 'LWSA3', 'POSI3', 'SaaS', 'Software'] relatedPosts: \['acoes-bancos-analise-setorial-2026', 'analise-setor-varejo-brasil', 'analise-setor-saude-brasil', 'roe-retorno-sobre-patrimonio-como-analisar', 'indicador-ev-ebitda-como-analisar'] featured: true expertise: 'Especialistas em análise do setor de tecnologia e empresas de software brasileiras' lastReviewed: 2026-01-03 ------------------------ ## O Setor de Tecnologia Brasileiro: Panorama 2026 O setor de tecnologia brasileiro ainda é pequeno comparado aos mercados desenvolvidos, mas representa algumas das empresas mais inovadoras da bolsa. Diferente dos EUA, onde tech domina o S\&P 500, no Brasil as techs representam menos de 3% do Ibovespa. Isso cria tanto desafios quanto oportunidades: **menos opções, mas potencial de crescimento significativo** à medida que a digitalização avança no país. ### Características do Setor Tech Brasileiro | Aspecto | Realidade Brasil | Comparação EUA | | ---------------------- | ------------------------- | -------------------- | | **Peso no índice** | \~2-3% do Ibovespa | \~30% do S\&P 500 | | **Modelo de negócio** | Majoritariamente B2B | Mix B2B e B2C | | **Receita recorrente** | Em transição para SaaS | SaaS maduro | | **Margens** | Menores que EUA | Margens altas (70%+) | | **Valuation** | Desconto vs pares globais | Múltiplos elevados | ### Principais Empresas de Tecnologia Brasileiras ``` ┌─────────────────────────────────────────────────────────────────┐ │ MAPA DO SETOR TECH BRASILEIRO │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ SOFTWARE EMPRESARIAL (ERP/Gestão) │ │ ├── TOTS3 (TOTVS) ──────── Líder em ERP Brasil │ │ └── LWSA3 (Locaweb) ────── Hosting + SaaS para PMEs │ │ │ │ HARDWARE & DISPOSITIVOS │ │ └── POSI3 (Positivo) ───── PCs, tablets, servidores │ │ │ │ FINTECHS (Tech + Financeiro) │ │ ├── CASH3 (Méliuz) ─────── Cashback e serviços financeiros │ │ └── MLAS3 (Mercado Livre)* ── E-commerce + Fintech │ │ │ │ * MLAS3 é BDR, sede na Argentina, listagem principal Nasdaq │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` ## TOTVS (TOTS3): A Gigante do Software Brasileiro A TOTVS é a maior empresa de software do Brasil e uma das maiores da América Latina. Seu core business é software de gestão empresarial (ERP), mas expandiu para novas verticais. ### Modelo de Negócio da TOTVS A empresa opera em três dimensões principais: **1. Gestão (ERP) - Core Business** * Software de gestão para empresas de todos os tamanhos * Segmentos: manufatura, varejo, serviços, agro, construção * Transição de licenças perpétuas para SaaS * Receita recorrente crescente **2. Techfin (RD Station + Supplier)** * Soluções de automação de marketing (RD Station) * Antecipação de recebíveis * Crédito para PMEs **3. Business Performance** * Consultoria e implementação * Customização de sistemas * Suporte e treinamento **Indicadores TOTVS (TOTS3):** | Categoria | Indicador | Valor Típico | | ----------------- | -------------- | --------------- | | **Preço** | Cotação | \~R$ 30 | | **Tamanho** | Market Cap | \~R$ 18 bilhões | | **Valuation** | P/L | 25-35x | | **Valuation** | P/VP | 4-6x | | **Valuation** | EV/EBITDA | 15-20x | | **Rentabilidade** | ROE | 15-20% | | **Rentabilidade** | Margem EBITDA | 22-26% | | **Rentabilidade** | Margem Líquida | 10-14% | ```typescript // Buscar dados fundamentalistas da TOTVS const response = await fetch("https://brapi.dev/api/quote/TOTS3?modules=defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }, }); const { results } = await response.json(); const totvs = results[0]; // totvs.regularMarketPrice, totvs.priceEarnings, totvs.financialData?.returnOnEquity, etc. ``` ### Análise SWOT da TOTVS | Forças | Fraquezas | | -------------------------------------- | --------------------------------- | | Líder absoluta em ERP Brasil | Margens menores que SaaS puros | | Base instalada gigante (+40k clientes) | Dependência do mercado brasileiro | | Receita recorrente crescente | Techfin ainda dando prejuízo | | Aquisições estratégicas | Alto investimento em M\&A | | Oportunidades | Ameaças | | ------------------------------ | ------------------------------------------ | | Digitalização de PMEs | Concorrência de ERPs globais (SAP, Oracle) | | Cross-sell para base existente | Fintechs especializadas | | Expansão LatAm | Economia brasileira fraca | | Cloud e SaaS | Retenção de talentos tech | ### Métricas-Chave para Acompanhar Para empresas de software como TOTVS, monitore: 1. **ARR (Annual Recurring Revenue)**: Receita recorrente anualizada 2. **Net Revenue Retention**: Quanto clientes existentes gastam a mais 3. **Churn Rate**: Taxa de cancelamento 4. **CAC Payback**: Tempo para recuperar custo de aquisição ## Locaweb (LWSA3): Do Hosting ao Ecossistema Digital A Locaweb começou como empresa de hospedagem de sites e evoluiu para um ecossistema completo de soluções digitais para PMEs. ### Evolução do Modelo de Negócio ``` ┌─────────────────────────────────────────────────────────────┐ │ EVOLUÇÃO LOCAWEB │ ├─────────────────────────────────────────────────────────────┤ │ │ │ 1998-2010: HOSTING TRADICIONAL │ │ ├── Hospedagem de sites │ │ ├── Registro de domínios │ │ └── E-mail corporativo │ │ │ │ 2010-2019: DIVERSIFICAÇÃO │ │ ├── E-commerce (Tray, Bagy) │ │ ├── Marketing digital │ │ └── Soluções para desenvolvedores │ │ │ │ 2020-2026: PLATAFORMA INTEGRADA │ │ ├── 20+ aquisições integradas │ │ ├── Commerce (Tray, Wake, Bling) │ │ ├── BeOnline (presença digital) │ │ └── SaaS para PMEs │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Segmentos de Negócio **Commerce (maior segmento)** * Tray: Plataforma de e-commerce * Bling: ERP para e-commerce * Melhor Envio: Logística * Octadesk: Atendimento **BeOnline** * Hospedagem * Criador de sites * E-mail marketing * Domínios **Indicadores Locaweb (LWSA3):** | Categoria | Indicador | Valor Típico | | ---------------- | ------------- | ---------------------- | | **Preço** | Cotação | \~R$ 5-7 | | **Tamanho** | Market Cap | \~R$ 3-5 bilhões | | **Valuation** | P/L | 20-40x (ou negativo) | | **Valuation** | P/VP | 1-2x | | **Valuation** | EV/EBITDA | 10-15x | | **Range 52 sem** | Mínima/Máxima | Verificar volatilidade | ```typescript // Buscar dados da Locaweb const response = await fetch("https://brapi.dev/api/quote/LWSA3?modules=defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }, }); const { results } = await response.json(); const locaweb = results[0]; // Calcular posição no range de 52 semanas const range = locaweb.fiftyTwoWeekHigh - locaweb.fiftyTwoWeekLow; const posicao = ((locaweb.regularMarketPrice - locaweb.fiftyTwoWeekLow) / range) * 100; ``` ### Desafios da Locaweb A empresa enfrentou desafios significativos após o IPO: 1. **Integração de aquisições**: 20+ empresas adquiridas precisam ser integradas 2. **Pressão nas margens**: Investimentos pesaram no resultado 3. **Competição intensa**: Shopify, VTEX, Nuvemshop 4. **Juros altos**: Afetam PMEs, seus principais clientes ## Positivo (POSI3): Hardware com Ambição de Serviços A Positivo é a maior fabricante de computadores do Brasil, mas vem diversificando para serviços e educação. ### Linhas de Negócio | Segmento | Produtos/Serviços | % Receita | | --------------- | ------------------------------------------ | --------- | | **Varejo** | PCs, notebooks, tablets, smartphones | \~45% | | **Corporativo** | Servidores, desktops, serviços | \~25% | | **Educacional** | Tablets para escolas, plataformas digitais | \~20% | | **Governo** | Projetos públicos de inclusão digital | \~10% | ### Diferenças vs Empresas de Software ``` ┌─────────────────────────────────────────────────────────────┐ │ HARDWARE vs SOFTWARE: MODELO DE NEGÓCIO │ ├─────────────────────────────────────────────────────────────┤ │ │ │ POSITIVO (Hardware) TOTVS (Software) │ │ ────────────────── ──────────────── │ │ • Margens brutas: 15-25% • Margens brutas: 50-60% │ │ • Capital intensivo • Asset light │ │ • Receita transacional • Receita recorrente │ │ • Ciclo de vendas curto • Contratos longos │ │ • Estoque relevante • Sem estoque físico │ │ • Depreciação alta • Amortização de software │ │ │ │ Resultado: P/L e múltiplos menores para hardware │ │ │ └─────────────────────────────────────────────────────────────┘ ``` **Indicadores Positivo Tecnologia (POSI3):** | Categoria | Indicador | Valor Típico | | ------------- | -------------- | ---------------- | | **Preço** | Cotação | \~R$ 8-12 | | **Tamanho** | Market Cap | \~R$ 800 milhões | | **Valuation** | P/L | 5-8x | | **Valuation** | P/VP | 0,8-1,2x | | **Renda** | Dividend Yield | 3-6% | | **Margens** | Bruta | 18-22% | | **Margens** | EBITDA | 6-10% | | **Margens** | Líquida | 2-5% | ```typescript // Buscar dados fundamentalistas da Positivo const response = await fetch("https://brapi.dev/api/quote/POSI3?modules=defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }, }); const { results } = await response.json(); const positivo = results[0]; ``` ## Méliuz (CASH3): A Fintech de Cashback O Méliuz é uma plataforma de cashback que expandiu para serviços financeiros após a aquisição do Bankly. ### Modelo de Negócio ``` ┌─────────────────────────────────────────────────────────────┐ │ MÉLIUZ - FLUXO │ ├─────────────────────────────────────────────────────────────┤ │ │ │ USUÁRIO ──► Compra via Méliuz ──► LOJISTA │ │ ▲ │ │ │ │ │ │ │ └──── Cashback ◄──── Comissão ◄─────┘ │ │ │ │ Méliuz fica com parte da comissão e repassa cashback │ │ │ │ NOVAS VERTICAIS: │ │ • Cartão de crédito (co-branded) │ │ • Conta digital (via Bankly) │ │ • Investimentos (shopping de investimentos) │ │ • Empréstimos (marketplace) │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Desafios Recentes O Méliuz enfrentou forte pressão após o IPO: 1. **Queima de caixa**: Investimentos em crescimento consumiram recursos 2. **Custo de aquisição alto**: CAC elevado para novos usuários 3. **Concorrência**: Picpay, bancos digitais, outros cashbacks 4. **Monetização**: Dificuldade em converter usuários em receita **Indicadores Méliuz (CASH3):** | Categoria | Indicador | Valor Típico | | ---------------- | ---------------- | ------------------------------- | | **Preço** | Cotação | \~R$ 3-8 | | **Tamanho** | Market Cap | \~R$ 300-600 milhões | | **Volatilidade** | Range 52 semanas | Alta amplitude | | **Status** | Momento | Turnaround em andamento | | **Foco** | Estratégia | Rentabilidade sobre crescimento | > **Nota**: Empresa em fase de turnaround, com foco em rentabilidade após período de queima de caixa. Alto risco e alta volatilidade. ```typescript // Buscar dados do Méliuz const response = await fetch("https://brapi.dev/api/quote/CASH3?modules=defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }, }); const { results } = await response.json(); const meliuz = results[0]; ``` ## Comparativo Completo do Setor Tech Vamos comparar todas as empresas de tecnologia brasileiras: ### Comparativo das Empresas de Tecnologia Brasileiras | Ticker | Empresa | Market Cap | P/L | P/VP | ROE | Margem Líq. | DY | | --------- | -------- | ----------- | ------ | -------- | -------- | ----------- | ---- | | **TOTS3** | TOTVS | \~R$ 18 bi | 25-35x | 4-6x | 15-20% | 10-15% | 1-2% | | **LWSA3** | Locaweb | \~R$ 3 bi | 15-25x | 1-2x | 5-10% | 3-8% | 0% | | **POSI3** | Positivo | \~R$ 800 mi | 5-8x | 0,8-1,2x | 10-15% | 2-5% | 3-6% | | **CASH3** | Méliuz | \~R$ 400 mi | N/A | 1-2x | Negativo | Negativo | 0% | **Ranking por Market Cap:** 1. TOTS3 (TOTVS) - Líder absoluta do setor 2. LWSA3 (Locaweb) - Segunda maior, foco em PMEs 3. POSI3 (Positivo) - Hardware e educação 4. CASH3 (Méliuz) - Menor, em fase de turnaround ```typescript // Buscar múltiplas empresas de tech de uma vez const response = await fetch( "https://brapi.dev/api/quote/TOTS3,LWSA3,POSI3,CASH3?modules=defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // results contém array com dados de todas as empresas ``` ## Métricas Específicas para Avaliar Empresas de Tech ### Para Empresas de Software (TOTVS, Locaweb) | Métrica | O Que Mede | Benchmark Bom | | ------------------------- | ------------------------------- | ------------- | | **ARR Growth** | Crescimento receita recorrente | > 20% a.a. | | **Net Revenue Retention** | Expansão em clientes existentes | > 110% | | **Gross Margin** | Eficiência do produto | > 70% | | **Rule of 40** | Crescimento + Margem EBITDA | > 40% | | **CAC Payback** | Meses para recuperar CAC | \< 18 meses | | **LTV/CAC** | Retorno sobre aquisição | > 3x | ### Para Hardware (Positivo) | Métrica | O Que Mede | Benchmark Bom | | ------------------- | ---------------------- | ------------- | | **Giro de Estoque** | Eficiência operacional | > 4x/ano | | **Margem Bruta** | Poder de precificação | > 20% | | **ROIC** | Retorno sobre capital | > 15% | | **Ciclo de Caixa** | Eficiência de capital | \< 60 dias | ### Para Fintechs (Méliuz) | Métrica | O Que Mede | Benchmark Bom | | ----------------------- | -------------------- | ---------------------- | | **GMV** | Volume transacionado | Crescimento > 30% | | **Take Rate** | Monetização do GMV | Estável ou crescente | | **Usuários Ativos** | Base engajada | Crescimento + retenção | | **ARPU** | Receita por usuário | Crescendo | | **Contribution Margin** | Margem por transação | Positiva | ## Riscos do Setor de Tecnologia ### Riscos Macroeconômicos ``` ┌─────────────────────────────────────────────────────────────┐ │ IMPACTO DOS JUROS EM TECH │ ├─────────────────────────────────────────────────────────────┤ │ │ │ SELIC ALTA (14-15%) │ │ ───────────────────── │ │ • Múltiplos comprimidos (P/L cai) │ │ • Custo de capital maior │ │ • PMEs (clientes) sofrem │ │ • M&A mais caro │ │ • Investidores preferem renda fixa │ │ │ │ SELIC BAIXA (< 8%) │ │ ───────────────────── │ │ • Múltiplos expandem │ │ • Funding mais barato │ │ • Clientes investem em tecnologia │ │ • M&A aquece │ │ • Fluxo para renda variável │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Riscos Específicos por Empresa | Empresa | Principal Risco | Mitigação | | --------- | --------------------------------- | ---------------------------------------- | | **TOTS3** | Concorrência global (SAP, Oracle) | Foco em mid-market, verticais | | **LWSA3** | Integração de aquisições | Foco em sinergias, não crescimento | | **POSI3** | Commoditização de hardware | Serviços e educação | | **CASH3** | Monetização insuficiente | Diversificação para serviços financeiros | ## Tese de Investimento: Quando Tech Faz Sentido ### Cenário Favorável para Tech * Juros em queda ou baixos * Economia crescendo * Digitalização acelerando * Múltiplos ainda descontados vs histórico ### Cenário Desfavorável * Juros altos e subindo * Recessão econômica * Competição de big techs globais * Múltiplos esticados ### Estratégia por Perfil **Alocação Sugerida em Tech por Perfil:** | Perfil | Max em Tech | Empresas Sugeridas | Motivo | | --------------- | ----------- | -------------------------- | -------------------------------------- | | **Conservador** | 5% | TOTS3 | Apenas líder consolidada com histórico | | **Moderado** | 10% | TOTS3, POSI3 | Líder + hardware com dividendos | | **Arrojado** | 20% | TOTS3, LWSA3, POSI3 | Diversificação no setor | | **Agressivo** | 30% | TOTS3, LWSA3, POSI3, CASH3 | Inclui turnarounds e small caps | > **Importante**: Estas são sugestões de alocação máxima em tecnologia, não recomendações de investimento. Avalie seu perfil de risco e objetivos antes de investir. ## Monitoramento Contínuo com brapi.dev Para monitorar o setor de tecnologia em tempo real, você pode criar um dashboard automatizado usando a API da brapi: ```typescript // Dashboard do setor de tecnologia const tickers = ["TOTS3", "LWSA3", "POSI3", "CASH3"]; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(",")}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // Calcular market cap total do setor const totalMarketCap = results.reduce( (sum, stock) => sum + (stock.marketCap || 0), 0 ); // Exibir dados de cada empresa for (const stock of results) { const variacao = stock.regularMarketChangePercent; const status = variacao > 0 ? "Alta" : variacao < 0 ? "Queda" : "Estável"; console.log(`${stock.symbol}: R$ ${stock.regularMarketPrice} (${status})`); } console.log(`Total Setor Tech: R$ ${(totalMarketCap / 1e9).toFixed(1)} bilhões`); ``` **O que monitorar no dashboard:** | Métrica | Descrição | Frequência | | ----------------------- | -------------------------- | ---------- | | Preço em tempo real | Cotação atual de cada ação | Contínuo | | Variação do dia | Performance diária | Diário | | Market Cap total | Tamanho do setor | Semanal | | Comparativo vs Ibovespa | Desempenho relativo | Semanal | ## Conclusão: O Futuro do Setor Tech Brasileiro O setor de tecnologia brasileiro ainda está em desenvolvimento, mas oferece oportunidades únicas: ### Pontos-Chave 1. **TOTVS é a aposta mais segura**: Líder consolidada, receita recorrente, diversificação 2. **Locaweb em reestruturação**: Precisa provar integração de aquisições 3. **Positivo é o outlier**: Hardware, não software, mas com dividendos 4. **Méliuz é turnaround**: Alto risco, potencial retorno se executar ### Tendências para Monitorar * Queda da Selic → múltiplos expandem * Consolidação do setor → M\&A * Expansão internacional → TOTVS LatAm * Inteligência Artificial → impacto em todas ### Próximos Passos Para aprofundar sua análise do setor de tecnologia: 1. **[Análise do Setor Bancário](/blog/acoes-bancos-analise-setorial-2026)** - Compare com fintechs 2. **[ROE: Como Analisar](/blog/roe-retorno-sobre-patrimonio-como-analisar)** - Métrica chave para tech 3. **[EV/EBITDA](/blog/indicador-ev-ebitda-como-analisar)** - Valuation de empresas de crescimento ## Automatize Sua Análise com brapi.dev A API da brapi.dev oferece dados em tempo real de todas as empresas de tecnologia brasileiras, incluindo: * Cotações e variações * Indicadores fundamentalistas * Dados históricos * Demonstrativos financeiros **Comece gratuitamente** em [brapi.dev](https://brapi.dev) e crie seus próprios dashboards de monitoramento do setor tech. # Análise do Setor de Varejo Brasil 2026: MGLU3, VIIA3, LREN3, ARZZ3 e Mais URL: /blog/analise-setor-varejo-brasil.mdx Análise completa do setor varejista brasileiro com indicadores fundamentalistas, comparativo entre empresas e código Python para automatizar análises ✓ *** searchable: true title: 'Análise do Setor de Varejo Brasil 2026: MGLU3, VIIA3, LREN3, ARZZ3 e Mais' description: 'Análise completa do setor varejista brasileiro com indicadores fundamentalistas, comparativo entre empresas e código Python para automatizar análises ✓' date: '2026-01-01' keywords: 'setor varejo brasil 2026, MGLU3, VIIA3, LREN3, ARZZ3, análise varejo, ações varejo, magazine luiza, via varejo, lojas renner, arezzo' author: 'Equipe brapi.dev' category: 'Análise Setorial' subcategory: 'Varejo' readingTime: '22 min' tags: \['Varejo', 'Análise Setorial', 'MGLU3', 'VIIA3', 'LREN3', 'ARZZ3', 'Ações', 'Bolsa Brasileira'] relatedPosts: \['acoes-bancos-analise-setorial-2026', 'analise-setor-tecnologia-brasil', 'analise-setor-saude-brasil', 'value-investing-como-encontrar-acoes-baratas', 'entendendo-indicador-preco-lucro-pl-analise-fundamentalista'] featured: true expertise: 'Especialistas em análise setorial do mercado brasileiro' lastReviewed: 2026-01-03 ------------------------ ## Introdução ao Setor de Varejo Brasileiro O setor de varejo é um dos mais importantes da economia brasileira, representando aproximadamente **20% do PIB nacional** e empregando milhões de trabalhadores. Para investidores, entender a dinâmica desse setor é fundamental para identificar oportunidades e riscos. Neste guia completo, vamos analisar: * Panorama do setor varejista brasileiro * Principais empresas listadas na bolsa brasileira * Indicadores fundamentalistas específicos do varejo * Comparativo detalhado entre concorrentes * Código Python para automatizar suas análises ``` ┌─────────────────────────────────────────────────────────────────┐ │ ECOSSISTEMA DO VAREJO BRASILEIRO │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ VESTUÁRIO ELETRO/MÓVEIS ALIMENTAR │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ LREN3 │ │ MGLU3 │ │ CRFB3 │ │ │ │ ARZZ3 │ │ VIIA3 │ │ ASAI3 │ │ │ │ SOMA3 │ │ BHIA3 │ │ PCAR3 │ │ │ │ CEAB3 │ │ │ │ GMAT3 │ │ │ └─────────┘ └─────────┘ └─────────┘ │ │ │ │ FARMÁCIAS E-COMMERCE DIVERSOS │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ RADL3 │ │ MELI34* │ │ AMER3 │ │ │ │ PNVL3 │ │ BKBR3 │ │ NTCO3 │ │ │ │ PGMN3 │ │ LWSA3 │ │ VIVA3 │ │ │ └─────────┘ └─────────┘ └─────────┘ │ │ │ │ * BDR - Mercado Livre │ └─────────────────────────────────────────────────────────────────┘ ``` ## Características Únicas do Setor de Varejo ### 1. Alta Sensibilidade ao Ciclo Econômico O varejo é **altamente cíclico**. Quando a economia vai bem, as vendas disparam. Em recessões, o setor sofre primeiro: | Fator Econômico | Impacto no Varejo | | ------------------------ | ---------------------------------------- | | Taxa de juros alta | Negativo - Crédito caro, menos consumo | | Desemprego alto | Muito negativo - Queda direta nas vendas | | Inflação alta | Negativo - Compressão de margens | | PIB em crescimento | Positivo - Mais consumo | | Massa salarial crescendo | Muito positivo - Mais poder de compra | ### 2. Margens Apertadas O varejo opera com **margens líquidas baixas** (1-8%), compensadas pelo alto giro de estoque: ``` ┌────────────────────────────────────────────────────┐ │ MARGENS TÍPICAS POR SEGMENTO │ ├────────────────────────────────────────────────────┤ │ │ │ Supermercados ████░░░░░░░░░░░░░░░░ 1-3% │ │ Eletro/Móveis ██████░░░░░░░░░░░░░░ 3-5% │ │ Vestuário ████████████░░░░░░░░ 8-12% │ │ Farmácias ██████░░░░░░░░░░░░░░ 3-5% │ │ Luxo/Premium ████████████████░░░░ 12-18% │ │ │ └────────────────────────────────────────────────────┘ ``` ### 3. Sazonalidade Forte As vendas concentram-se em datas específicas: * **Natal**: 25-35% do faturamento anual * **Black Friday**: 10-15% do faturamento anual * **Dia das Mães**: 8-12% do faturamento anual * **Dia dos Namorados**: 5-8% do faturamento anual ### 4. Transformação Digital O e-commerce revolucionou o setor. Empresas que não se adaptaram perderam relevância: ``` EVOLUÇÃO DO E-COMMERCE NO VAREJO BRASILEIRO 2019: ████████░░░░░░░░░░░░░░░░░░░░░░ 5% das vendas 2020: ████████████████░░░░░░░░░░░░░░ 11% (COVID) 2021: ██████████████████░░░░░░░░░░░░ 13% 2022: ████████████████░░░░░░░░░░░░░░ 11% 2023: ██████████████████░░░░░░░░░░░░ 12% 2024: ████████████████████░░░░░░░░░░ 14% ``` ## Análise das Principais Empresas ### MGLU3 - Magazine Luiza A Magazine Luiza é uma das maiores varejistas do Brasil, com forte presença tanto física quanto digital. **Modelo de Negócio:** * Lojas físicas + marketplace digital * Super App com ecossistema de serviços * Fintech (MagaluPay) * Logística própria (Magalu Entregas) **Pontos Fortes:** * Marca forte e reconhecida * Ecossistema integrado (físico + digital) * Cultura de inovação * Logística eficiente **Pontos de Atenção:** * Endividamento elevado * Margens pressionadas * Competição acirrada com Mercado Livre e Amazon * Dependência de juros baixos ### VIIA3/BHIA3 - Grupo Casas Bahia (ex-Via) O Grupo Casas Bahia passou por reestruturação significativa nos últimos anos. **Modelo de Negócio:** * Casas Bahia e Ponto (ex-Ponto Frio) * Marketplace digital * banQi (fintech) * Foco em classes C e D **Pontos Fortes:** * Capilaridade (lojas em todo Brasil) * Forte presença em móveis e eletrodomésticos * Crediário próprio **Pontos de Atenção:** * Reestruturação em andamento * Prejuízos recorrentes * Perda de market share para concorrentes digitais * Alto endividamento ### LREN3 - Lojas Renner A Renner é líder no varejo de moda no Brasil, com modelo verticalmente integrado. **Modelo de Negócio:** * Lojas Renner (moda feminina, masculina, infantil) * Camicado (casa e decoração) * Youcom (moda jovem) * Realize (financeira) **Pontos Fortes:** * Marca forte e posicionamento claro * Modelo fast fashion eficiente * Integração vertical (produção própria) * Financeira própria com boa rentabilidade * Gestão reconhecida **Pontos de Atenção:** * Dependência do mercado interno * Competição com fast fashion internacional (Shein, Zara) * Crescimento mais maduro ### ARZZ3 - Arezzo\&Co A Arezzo é líder no mercado de calçados, bolsas e acessórios premium no Brasil. **Modelo de Negócio:** * Multimarcas: Arezzo, Schutz, Anacapri, Alexandre Birman, Vans (licença) * Aquisições estratégicas (Reserva, BAW, Carol Bassi) * E-commerce forte * Expansão internacional **Pontos Fortes:** * Portfólio de marcas diversificado * Posicionamento premium com margens altas * Track record de aquisições bem-sucedidas * E-commerce representativo * Gestão de excelência **Pontos de Atenção:** * Valuation premium * Dependência do consumo de alta renda * Integração de aquisições ## Indicadores-Chave para Análise de Varejo ### 1. Same Store Sales (SSS) O crescimento de vendas nas mesmas lojas é crucial para avaliar a saúde orgânica: **Fórmula:** ``` Crescimento Nominal = (Receita Atual ÷ Receita Anterior - 1) × 100 Crescimento Real = Crescimento Nominal - Inflação ``` **Exemplo de Cálculo SSS:** | Métrica | Valor | | -------------------- | --------- | | Receita Anterior | R$ 10.000 | | Receita Atual | R$ 10.500 | | Crescimento Nominal | 5,0% | | Inflação (IPCA) | 4,5% | | **Crescimento Real** | **0,5%** | > **Interpretação:** SSS real positivo indica crescimento orgânico genuíno, acima da inflação. ### 2. Giro de Estoque Fundamental para varejo - quanto mais alto, melhor: **Fórmula:** ``` Giro de Estoque = CMV ÷ Estoque Médio Dias em Estoque = 365 ÷ Giro ``` **Benchmarks por Segmento:** | Segmento | Giro Ideal (anual) | Dias em Estoque | | ------------- | ------------------ | --------------- | | Supermercados | 12x | \~30 dias | | Farmácias | 8x | \~45 dias | | Eletro/Móveis | 6x | \~60 dias | | Vestuário | 4x | \~90 dias | > **Interpretação:** Giro acima do benchmark indica boa gestão de estoque e capital de giro eficiente. ### 3. Margem EBITDA A margem operacional mostra eficiência antes de juros e impostos: **Fórmula:** ``` Margem EBITDA = (EBITDA ÷ Receita Líquida) × 100 ``` **Benchmarks por Segmento do Varejo:** | Segmento | Margem EBITDA Benchmark | | --------------- | ----------------------- | | Vestuário | 15% | | Eletro/Móveis | 8% | | Farmácias | 7% | | Supermercados | 6% | | E-commerce puro | 5% | > **Avaliação:** Margens acima do benchmark indicam vantagem competitiva ou eficiência operacional superior. ## Análise Comparativa com brapi.dev **Consulta de dados do setor:** ```typescript const tickers = ['MGLU3', 'BHIA3', 'LREN3', 'ARZZ3', 'SOMA3', 'CEAB3']; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(',')}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); ``` ### Comparativo do Setor Varejo | Ticker | Empresa | P/L | P/VP | DY | ROE | Margem | Dív/PL | | ------ | ----------------- | ----- | ---- | ---- | ------ | ------ | ------ | | MGLU3 | Magazine Luiza | -15,2 | 1,8 | 0,0% | -12,5% | -2,1% | 2,5 | | BHIA3 | Grupo Casas Bahia | -3,5 | 0,2 | 0,0% | -45,0% | -8,5% | 4,2 | | LREN3 | Lojas Renner | 12,5 | 2,1 | 3,5% | 18,2% | 8,5% | 0,8 | | ARZZ3 | Arezzo | 18,2 | 3,5 | 2,8% | 22,5% | 10,2% | 0,4 | | SOMA3 | Grupo Soma | 25,0 | 1,2 | 1,5% | 8,5% | 5,2% | 1,2 | | CEAB3 | C\&A Brasil | -8,5 | 0,9 | 0,0% | -10,5% | -1,8% | 1,8 | > **Nota:** Dados ilustrativos. Consulte a API para valores atualizados em tempo real. ## Score de Qualidade para Varejistas Sistema de pontuação específico para o setor (0-100 pontos): ### Critérios de Pontuação | Critério | Peso | Excelente | Bom | Regular | Baixo | | -------------------------- | ------ | --------------- | --------------- | --------------- | ------------- | | **Rentabilidade (ROE)** | 30 pts | > 20% (30 pts) | > 15% (25 pts) | > 10% (15 pts) | > 0% (5 pts) | | **Endividamento (Dív/PL)** | 25 pts | \< 0,5 (25 pts) | \< 1,0 (20 pts) | \< 2,0 (10 pts) | > 2,0 (0 pts) | | **Margem Líquida** | 20 pts | > 8% (20 pts) | > 5% (15 pts) | > 2% (10 pts) | > 0% (5 pts) | | **Valuation (P/L)** | 15 pts | \< 10 (15 pts) | 10-15 (12 pts) | 15-25 (8 pts) | > 25 (3 pts) | | **Dividendos (DY)** | 10 pts | > 4% (10 pts) | > 2% (7 pts) | > 0% (3 pts) | 0% (0 pts) | ### Classificação Final | Score | Classificação | | ------ | --------------- | | 80-100 | ⭐⭐⭐⭐⭐ Excelente | | 60-79 | ⭐⭐⭐⭐ Muito Bom | | 40-59 | ⭐⭐⭐ Regular | | 20-39 | ⭐⭐ Fraco | | 0-19 | ⭐ Crítico | **Exemplo prático:** Uma empresa com ROE de 18% (25 pts), Dív/PL de 0,8 (20 pts), Margem de 6% (15 pts), P/L de 12 (12 pts) e DY de 3% (7 pts) teria score de **79 pontos** = Muito Bom. ## Análise de Múltiplos com Histórico **Consulta histórica de preços:** ```typescript const response = await fetch( `https://brapi.dev/api/quote/LREN3?range=5y&interval=1mo&modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const historico = results[0].historicalDataPrice; ``` ### Análise de Preço vs Média Histórica | Ticker | Preço Atual | Média 20 meses | vs Média | Mínima | Máxima | | ------ | ----------- | -------------- | -------- | -------- | -------- | | LREN3 | R$ 14,80 | R$ 18,50 | -20,0% | R$ 12,20 | R$ 28,50 | | ARZZ3 | R$ 55,20 | R$ 62,30 | -11,4% | R$ 48,00 | R$ 85,00 | | MGLU3 | R$ 12,50 | R$ 8,20 | +52,4% | R$ 1,80 | R$ 25,00 | **Interpretação:** * **Abaixo da média:** Pode indicar oportunidade de compra (se fundamentos sólidos) * **Acima da média:** Avaliar se crescimento justifica o prêmio * **Próximo de mínimas:** Alto risco, verificar se empresa está em dificuldades ## Fatores de Risco do Setor ### 1. Risco de Juros O varejo é altamente sensível à taxa Selic: ``` IMPACTO DA SELIC NO VAREJO Selic Alta (>10%) ├── Crédito mais caro → Menos vendas a prazo ├── Custo da dívida aumenta → Lucro cai ├── Consumidor poupa mais → Menos consumo └── Ações do setor despencam Selic Baixa (\<8%) ├── Crédito barato → Boom de vendas a prazo ├── Custo da dívida cai → Lucro aumenta ├── Consumidor gasta mais → Mais consumo └── Ações do setor valorizam ``` ### 2. Risco de Execução **Principais riscos operacionais específicos do varejo:** | Tipo de Risco | Indicador de Alerta | Nível | Descrição | | ---------------- | ------------------------ | ----- | -------------------------------------------------- | | **Integração** | > 2 aquisições recentes | Alto | Múltiplas aquisições para integrar simultaneamente | | **Digital** | E-commerce \< 20% vendas | Médio | Baixa penetração digital vs concorrentes | | **Concentração** | Top categoria > 60% | Médio | Alta dependência de uma única categoria | | **Estoque** | Giro \< 3x ao ano | Alto | Mercadorias encalhadas, risco de obsolescência | | **Crédito** | Inadimplência > 5% | Alto | Carteira de crediário deteriorando | **Sinais de alerta:** * Múltiplas trocas de CEO em curto período * Fechamento acelerado de lojas físicas * Queima de caixa operacional consecutiva * Renegociação de dívidas com bancos ### 3. Risco Competitivo O setor enfrenta competição de: * **Players digitais globais**: Amazon, Shopee, Shein * **Mercado Livre**: Líder em e-commerce na América Latina * **D2C (Direct to Consumer)**: Marcas vendendo direto * **Social commerce**: Vendas via redes sociais ## Estratégias de Investimento no Setor ### Estratégia 1: Quality + Value Foco em empresas de qualidade em momentos de desconto: **Critérios de Seleção Quality + Value:** | Indicador | Critério | Justificativa | | -------------- | -------------- | --------------------------------- | | ROE | > 15% | Empresa rentável e eficiente | | P/L | 0 \< P/L \< 20 | Valuation razoável, não está cara | | Dív/PL | \< 1,5 | Endividamento controlado | | Margem Líquida | > 5% | Operação saudável | **Ordenação:** Priorizar empresas com maior ROE dentro dos critérios. **Exemplo de filtro aplicado:** | Ticker | ROE | P/L | Dív/PL | Margem | Status | | ------ | ------ | ----- | ------ | ------ | ----------- | | ARZZ3 | 22,5% | 18,2 | 0,4 | 10,2% | ✅ Aprovada | | LREN3 | 18,2% | 12,5 | 0,8 | 8,5% | ✅ Aprovada | | SOMA3 | 8,5% | 25,0 | 1,2 | 5,2% | ❌ ROE baixo | | MGLU3 | -12,5% | -15,2 | 2,5 | -2,1% | ❌ Prejuízo | ### Estratégia 2: Turnaround Para investidores com maior apetite a risco: **Critérios para identificar candidatas a turnaround:** | Critério | Valor | Significado | | -------- | ------ | ---------------------------------------- | | P/VP | \< 0,5 | Empresa valendo menos que seu patrimônio | | Preço | > R$ 0 | Ainda está operando (não está em RJ) | | Operação | Ativa | Lojas funcionando, marca conhecida | **Cálculo do upside potencial:** Se P/VP = 0,3, significa que a empresa negocia a 30% do patrimônio. Se voltar ao valor patrimonial (P/VP = 1), o upside seria de +233%. **Candidatas históricas a turnaround:** | Ticker | P/VP | Preço | Upside p/ VP | Risco | | ------ | ---- | ------- | ------------ | ---------- | | BHIA3 | 0,2 | R$ 0,85 | +400% | Muito Alto | | CEAB3 | 0,9 | R$ 9,80 | +11% | Alto | > **Atenção:** Turnarounds são investimentos de alto risco. A maioria das empresas em dificuldades não se recupera. Invista apenas o que pode perder. ## Dashboard do Setor Varejo **Consulta consolidada do setor:** ```typescript const tickers = ['MGLU3', 'BHIA3', 'LREN3', 'ARZZ3', 'SOMA3', 'CEAB3', 'CRFB3', 'ASAI3', 'RADL3', 'PNVL3']; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(',')}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); ``` ### Visão Geral do Setor | Métrica | Valor | Interpretação | | ------------------- | ----- | --------------------------------- | | Total de empresas | 10 | Principais varejistas brasileiros | | Empresas lucrativas | 6 | 60% com lucro positivo | | Média P/L setor | 12,5 | Valuation moderado | | Média ROE setor | 8,2% | Rentabilidade baixa | ### Classificação das Empresas | Categoria | Empresas | Critério | | ------------- | -------------------------- | ----------------------------- | | **Destaques** | LREN3, ARZZ3, RADL3 | ROE > 15% e Margem > 5% | | **Em alerta** | MGLU3, BHIA3, CEAB3 | ROE negativo ou Margem \< -5% | | **Neutro** | SOMA3, CRFB3, ASAI3, PNVL3 | Resultados mistos | > **Dica:** Use a brapi.dev para monitorar esses indicadores em tempo real e criar alertas personalizados. ## Conclusão: Investindo no Varejo Brasileiro O setor de varejo brasileiro oferece oportunidades interessantes, mas requer análise cuidadosa: ### Critérios para Seleção 1. **ROE consistentemente acima de 15%** 2. **Margem líquida superior a 5%** 3. **Endividamento controlado (Dív/PL \< 1.5)** 4. **Crescimento de SSS acima da inflação** 5. **E-commerce relevante (>20% das vendas)** ### Top Picks por Categoria | Categoria | Empresa | Motivo | | --------------------- | ------- | ------------------------------------- | | Vestuário Premium | ARZZ3 | Margens altas, gestão excelente | | Vestuário Mass Market | LREN3 | Líder de mercado, financeira rentável | | Farmácias | RADL3 | Setor defensivo, consolidador | | Alimentar | ASAI3 | Atacarejo em crescimento | ### Quando Evitar o Setor * Selic em trajetória de alta * Desemprego em elevação * PIB em contração * Confiança do consumidor em queda ## Próximos Passos Para aprofundar sua análise do setor de varejo: 1. **Crie sua conta gratuita** na [brapi.dev](https://brapi.dev) para acessar dados em tempo real 2. **Explore a documentação** completa da API em [brapi.dev/docs](https://brapi.dev/docs) 3. **Automatize suas análises** usando os códigos Python deste guia 4. **Acompanhe os resultados trimestrais** das empresas do setor A brapi.dev oferece todos os dados fundamentalistas necessários para análise profunda do setor de varejo, incluindo balanços, demonstrativos de resultado e indicadores atualizados. *** *Disclaimer: Este conteúdo é educacional e não constitui recomendação de investimento. Faça sua própria análise antes de investir.* # Análise Setorial 2025: Como Comparar Empresas e Encontrar Líderes URL: /blog/analise-setorial-acoes-como-comparar-empresas-mesmo-segmento-b3.mdx Domine análise setorial na bolsa brasileira! Aprenda comparação de empresas, múltiplos setoriais, peer analysis e como identificar líderes e oportunidades por setor ✓ *** searchable: true title: 'Análise Setorial 2025: Como Comparar Empresas e Encontrar Líderes' description: 'Domine análise setorial na bolsa brasileira! Aprenda comparação de empresas, múltiplos setoriais, peer analysis e como identificar líderes e oportunidades por setor ✓' date: '2025-08-22' keywords: 'análise setorial, comparação empresas, múltiplos setoriais, bolsa brasileira, setores economia, líderes mercado, peer comparison, análise fundamentalista, brapi' author: 'Equipe brapi.dev' category: 'Análise Setorial' subcategory: 'Comparação Empresarial' readingTime: '20 min' tags: \['Análise Setorial', 'Comparação Empresas', 'Bolsa Brasileira', 'Múltiplos', 'Investimentos', 'Peer Analysis', 'Setores'] relatedPosts: \['analise-fundamentalista-acoes-indicadores-essenciais-investir-b3', 'como-construir-carteira-investimentos-diversificada-brapi', 'indicadores-economicos-brasil-selic-ipca-igpm-impacto-investimentos'] featured: true expertise: 'Análise setorial com 8+ anos de experiência no mercado brasileiro' lastReviewed: 2026-01-03 howToSteps: * name: 'Identificar o setor e subsetor da empresa' text: 'Classifique a empresa em um dos principais setores da bolsa brasileira: financeiro, utilities, commodities, consumo, tecnologia, saúde ou industrial, e identifique o subsetor específico.' * name: 'Mapear os principais players do setor' text: 'Liste as empresas concorrentes que operam no mesmo segmento para criar um grupo de comparação (peer group) relevante.' * name: 'Coletar dados via API brapi.dev' text: 'Use a API brapi.dev para obter dados fundamentalistas de todas as empresas do setor, incluindo múltiplos, margens e indicadores operacionais.' * name: 'Calcular múltiplos setoriais' text: 'Determine a média e mediana de P/L, EV/EBITDA, P/VP e margens do setor para estabelecer benchmarks de comparação.' * name: 'Analisar posição relativa' text: 'Compare cada empresa com a média setorial para identificar líderes, seguidores e empresas potencialmente subvalorizadas.' * name: 'Identificar vantagens competitivas' text: 'Avalie fatores qualitativos como market share, qualidade da gestão, barreiras de entrada e posicionamento estratégico.' * name: 'Selecionar as melhores oportunidades' text: 'Combine análise quantitativa e qualitativa para identificar as empresas com melhor relação risco-retorno no setor.' howToTools: * 'API brapi.dev' * 'Python para análise de dados' * 'Planilha comparativa' * 'Gráficos de dispersão' howToSupplies: * 'Token de acesso brapi.dev' * 'Lista de empresas por setor' * 'Dados setoriais históricos' * 'Relatórios de analistas do setor' *** import { Authors, Author } from '~/components/Authors'; > A análise setorial é fundamental para identificar as melhores oportunidades de investimento. Comparar empresas do mesmo setor permite encontrar líderes de mercado, identificar tendências e descobrir ações subvalorizadas. Aprenda como fazer essa análise usando dados da brapi.dev. *** ## Por que a Análise Setorial é Importante? A **análise setorial** permite comparar empresas que operam no mesmo ambiente competitivo, enfrentam regulamentações similares e são afetadas pelos mesmos fatores macroeconômicos. Essa comparação é essencial para: ### 1. **Contexto de Avaliação** * Múltiplos isolados podem enganar * Cada setor tem características únicas * Padrões de sazonalidade específicos ### 2. **Identificação de Líderes** * Empresas com vantagem competitiva * Gestão superior * Posição de mercado consolidada ### 3. **Oportunidades Relativas** * Ações subvalorizadas no setor * Disparidades de valuation * Momentos de entrada/saída ## Principais Setores da Bolsa Brasileira ### 1. **Setor Financeiro** **Características:** * Regulamentação específica (Banco Central) * Sensibilidade à taxa de juros * Alavancagem natural do negócio **Subsetores:** * Bancos comerciais * Seguradoras * Corretoras **Principais Players:** ITUB4, BBDC4, BBAS3, BBSE3 ### 2. **Utilities (Energia e Saneamento)** **Características:** * Concessões de longo prazo * Fluxo de caixa previsível * Regulamentação por agências (ANEEL, ANA) **Subsetores:** * Energia elétrica * Saneamento * Gás **Principais Players:** EGIE3, SBSP3, CPLE6, TAEE11 ### 3. **Commodities e Mineração** **Características:** * Ciclicidade elevada * Exposição a preços internacionais * Intensivo em capital **Subsetores:** * Mineração de ferro * Petróleo e gás * Celulose e papel **Principais Players:** VALE3, PETR4, SUZB3, KLBN11 ### 4. **Consumo e Varejo** **Características:** * Sensibilidade ao cenário econômico * Sazonalidade nas vendas * Diferentes canais de distribuição **Subsetores:** * Varejo físico * E-commerce * Alimentação **Principais Players:** MGLU3, LREN3, ABEV3, BRFS3 ## Métricas-Chave por Setor ### Setor Bancário #### Indicadores Específicos: ```javascript const analiseBanco = { eficiencia: 'Índice de Eficiência (< 50% é bom)', qualidadeCredito: 'Taxa de Inadimplência (< 5% é boa)', rentabilidade: 'ROE (15-25% é típico)', capitalização: 'Índice de Basileia (> 11% é obrigatório)', crescimento: 'Crescimento da Carteira de Crédito' }; ``` #### Análise Comparativa via API: ```typescript // Buscar dados fundamentalistas de bancos para comparação const bancos = ["ITUB4", "BBDC4", "BBAS3", "SANB11", "BPAC11"]; const tickersParam = bancos.join(","); const response = await fetch( `https://brapi.dev/api/quote/${tickersParam}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // Cada resultado contém: defaultKeyStatistics, financialData ``` **Exemplo de Ranking Setor Bancário:** | Posição | Ticker | ROE | P/VP | Dividend Yield | Avaliação | | ------- | ------ | ----- | ---- | -------------- | -------------------- | | 1 | ITUB4 | 21,5% | 1,8x | 4,2% | Líder em eficiência | | 2 | BBAS3 | 18,3% | 0,9x | 8,5% | Maior DY, menor P/VP | | 3 | BBDC4 | 16,8% | 1,2x | 5,1% | Recuperação em curso | | 4 | SANB11 | 15,2% | 1,4x | 6,3% | Bom dividend yield | | 5 | BPAC11 | 12,5% | 1,6x | 2,8% | Foco em crescimento | **Critérios de ordenação:** ROE (maior = melhor rentabilidade sobre patrimônio) ### Setor de Utilities #### Métricas Relevantes: ```typescript // Buscar dados de utilities para análise setorial const utilities = ["EGIE3", "SBSP3", "CPLE6", "TAEE11", "CMIG4"]; const tickersParam = utilities.join(","); const response = await fetch( `https://brapi.dev/api/quote/${tickersParam}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // Ordenar por dividend yield para utilities ``` **Exemplo de Ranking Utilities (ordenado por Dividend Yield):** | Ticker | EV/EBITDA | Dividend Yield | Margem Líquida | Característica | | ------ | --------- | -------------- | -------------- | --------------------------------- | | TAEE11 | 7,2x | 9,8% | 45,2% | Transmissão, alta previsibilidade | | CPLE6 | 5,8x | 7,5% | 28,3% | Distribuição, bom DY | | CMIG4 | 4,2x | 6,9% | 22,1% | Mista, desconto histórico | | EGIE3 | 8,5x | 5,2% | 35,6% | Geração, qualidade premium | | SBSP3 | 6,1x | 4,1% | 18,7% | Saneamento, crescimento | **Métricas-chave para Utilities:** * **EV/EBITDA:** Quanto menor, mais barato (média setor: 6-8x) * **Dividend Yield:** Prioridade para investidores de renda * **Margem Líquida:** Eficiência operacional ### Setor de Varejo #### Indicadores Específicos: ```typescript // Buscar dados de varejo para análise comparativa const varejo = ["MGLU3", "LREN3", "GUAR3", "SOMA3", "AZZA3"]; const tickersParam = varejo.join(","); const response = await fetch( `https://brapi.dev/api/quote/${tickersParam}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // Ordenar por ROE ou margem líquida ``` **Exemplo de Ranking Varejo (ordenado por ROE):** | Ticker | P/L | P/Vendas | Margem Líquida | ROE | Situação | | ------ | ----- | -------- | -------------- | -------- | ------------------------------ | | LREN3 | 12,5x | 1,2x | 8,5% | 18,2% | Líder em rentabilidade | | GUAR3 | 8,2x | 0,6x | 5,2% | 12,5% | Desconto, potencial turnaround | | SOMA3 | 15,8x | 1,8x | 6,8% | 14,3% | Premium, bom crescimento | | AZZA3 | 18,5x | 2,1x | 4,2% | 8,5% | Múltiplo elevado | | MGLU3 | N/A | 0,3x | -2,5% | Negativo | Reestruturação | **Indicadores-chave para Varejo:** * **P/Vendas:** Útil para empresas sem lucro * **Margem Líquida:** Eficiência operacional (média setor: 3-8%) * **ROE:** Rentabilidade para acionistas * **Liquidez Corrente:** Saúde financeira (>1,0 é saudável) ## Dashboard Setorial Interativo ### Implementação em React ```jsx import React, { useState, useEffect } from 'react'; import { BarChart, Bar, XAxis, YAxis, CartesianGrid, Tooltip, Legend, ScatterChart, Scatter } from 'recharts'; const DashboardSetorial = () => { const [setorSelecionado, setSetorSelecionado] = useState('bancos'); const [dadosSetor, setDadosSetor] = useState([]); const [loading, setLoading] = useState(false); const setores = { bancos: { nome: 'Setor Bancário', tickers: ['ITUB4', 'BBDC4', 'BBAS3', 'SANB11', 'BPAC11'], metricas: ['roe', 'p_vp', 'dividend_yield'], cor: '#3498db' }, utilities: { nome: 'Utilities', tickers: ['EGIE3', 'SBSP3', 'CPLE6', 'TAEE11', 'CMIG4'], metricas: ['ev_ebitda', 'dividend_yield', 'margem_liquida'], cor: '#2ecc71' }, varejo: { nome: 'Varejo', tickers: ['MGLU3', 'LREN3', 'AMER3', 'GUAR3', 'SOMA3'], metricas: ['p_l', 'margem_liquida', 'crescimento_receita'], cor: '#e74c3c' } }; useEffect(() => { const buscarDadosSetor = async () => { setLoading(true); try { const setor = setores[setorSelecionado]; const dados = await analisarSetor(setor.tickers, setorSelecionado); setDadosSetor(dados); } catch (error) { console.error('Erro ao buscar dados do setor:', error); } finally { setLoading(false); } }; buscarDadosSetor(); }, [setorSelecionado]); const analisarSetor = async (tickers, tipoSetor) => { const resultados = []; for (const ticker of tickers) { try { const response = await fetch(`https://brapi.dev/api/quote/${ticker}?modules=defaultKeyStatistics,financialData&token=${process.env.REACT_APP_BRAPI_TOKEN}`); const data = await response.json(); const acao = data.results[0]; const stats = acao.defaultKeyStatistics || {}; const financials = acao.financialData || {}; const dadosComuns = { ticker: acao.symbol, nome: acao.shortName, preco: acao.regularMarketPrice, variacao: acao.regularMarketChangePercent }; // Métricas específicas por setor if (tipoSetor === 'bancos') { resultados.push({ ...dadosComuns, roe: (financials.returnOnEquity || 0) * 100, p_vp: stats.priceToBook || 0, dividend_yield: (stats.dividendYield || 0) * 100 }); } else if (tipoSetor === 'utilities') { resultados.push({ ...dadosComuns, ev_ebitda: stats.enterpriseToEbitda || 0, dividend_yield: (stats.dividendYield || 0) * 100, margem_liquida: (financials.profitMargins || 0) * 100 }); } else if (tipoSetor === 'varejo') { resultados.push({ ...dadosComuns, p_l: stats.forwardPE || 0, margem_liquida: (financials.profitMargins || 0) * 100, roe: (financials.returnOnEquity || 0) * 100 }); } } catch (error) { console.error(`Erro ao processar ${ticker}:`, error); } } return resultados; }; const renderGraficoComparativo = () => { if (!dadosSetor.length) return null; const setor = setores[setorSelecionado]; return (

Comparação {setor.nome}

{/* Gráfico de barras para primeira métrica */}

ROE / EV/EBITDA / P/L

{/* Scatter plot para análise cruzada */}

Dividend Yield vs Margem Líquida

); }; const renderTabela = () => { if (!dadosSetor.length) return null; return (

Ranking Detalhado

{setorSelecionado === 'bancos' && ( <> )} {setorSelecionado === 'utilities' && ( <> )} {setorSelecionado === 'varejo' && ( <> )} {dadosSetor.map((empresa, index) => ( {setorSelecionado === 'bancos' && ( <> )} {setorSelecionado === 'utilities' && ( <> )} {setorSelecionado === 'varejo' && ( <> )} ))}
Posição Ticker Nome Preço VariaçãoROE (%) P/VP DY (%)EV/EBITDA DY (%) Margem (%)P/L ROE (%) Margem (%)
{index + 1} {empresa.ticker} {empresa.nome} R$ {empresa.preco.toFixed(2)} = 0 ? 'positivo' : 'negativo'}> {empresa.variacao >= 0 ? '+' : ''}{empresa.variacao.toFixed(2)}% {empresa.roe.toFixed(1)}% {empresa.p_vp.toFixed(2)} {empresa.dividend_yield.toFixed(1)}%{empresa.ev_ebitda.toFixed(1)}x {empresa.dividend_yield.toFixed(1)}% {empresa.margem_liquida.toFixed(1)}%{empresa.p_l.toFixed(1)}x {empresa.roe.toFixed(1)}% {empresa.margem_liquida.toFixed(1)}%
); }; return (

Análise Setorial - bolsa brasileira

{Object.entries(setores).map(([key, setor]) => ( ))}
{loading ? (
Carregando dados do setor...
) : ( <> {renderGraficoComparativo()} {renderTabela()} )}
); }; export default DashboardSetorial; ``` ## Análise de Ciclos Setoriais ### Identificando Momentos de Entrada Para analisar ciclos setoriais, busque dados históricos mensais via brapi: ```typescript // Buscar dados históricos para análise de ciclos const utilities = ["EGIE3", "SBSP3", "CPLE6", "TAEE11"]; const tickersParam = utilities.join(","); const response = await fetch( `https://brapi.dev/api/quote/${tickersParam}?range=5y&interval=1mo`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // Cada resultado contém historicalDataPrice para análise de ciclos ``` **Framework de Análise de Ciclos Setoriais:** | Momento do Ciclo | Performance Recente | Ação Sugerida | | ------------------ | ------------------------ | ----------------------------------- | | **Alta do ciclo** | > +2% ao mês (12 meses) | CUIDADO - Valuations esticados | | **Meio do ciclo** | Entre -2% e +2% ao mês | NEUTRO - Seletividade | | **Baixa do ciclo** | \< -2% ao mês (12 meses) | OPORTUNIDADE - Valuations atrativos | **Sazonalidade Típica por Setor (Melhores Meses):** | Setor | Meses Fortes | Meses Fracos | Motivo | | ----------- | ------------- | ------------- | ---------------------------------- | | Utilities | Jan, Jul, Nov | Fev, Mai, Ago | Reajustes tarifários, período seco | | Bancos | Mar, Ago, Dez | Jan, Abr, Set | Resultados trimestrais, dividendos | | Varejo | Nov, Dez, Mai | Jan, Fev, Mar | Black Friday, Natal, Dia das Mães | | Commodities | Mar, Set | Jun, Dez | Safras, demanda industrial | **Como interpretar:** 1. Compare a performance dos últimos 12 meses com a média móvel de longo prazo 2. Se performance recente > média de longo prazo = ciclo de alta 3. Use sazonalidade para timing de entrada/saída ## Estratégias de Pair Trading ### Identificando Pares para Trading Pair trading envolve comprar uma ação e vender outra do mesmo setor quando a relação entre elas diverge da média histórica. ```typescript // Buscar dados históricos para análise de pares const bancos = ["ITUB4", "BBDC4", "BBAS3", "SANB11"]; const tickersParam = bancos.join(","); const response = await fetch( `https://brapi.dev/api/quote/${tickersParam}?range=1y&interval=1d`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // Use historicalDataPrice para calcular correlações e ratios ``` **Conceitos de Pair Trading:** | Termo | Definição | Uso | | -------------- | ------------------------------------- | ------------------------- | | **Correlação** | Grau de movimentação conjunta (0 a 1) | > 0,7 indica par adequado | | **Ratio** | Preço Ação A / Preço Ação B | Base para análise | | **Z-Score** | Desvios do ratio vs média histórica | Sinal de entrada/saída | **Interpretação do Z-Score:** | Z-Score | Situação | Ação | | ----------- | ------------------------ | ---------------- | | > +2,0 | Ação A muito cara vs B | SHORT A / LONG B | | +1,0 a +2,0 | A moderadamente cara | Monitorar | | -1,0 a +1,0 | Equilíbrio | Sem oportunidade | | -2,0 a -1,0 | A moderadamente barata | Monitorar | | \< -2,0 | Ação A muito barata vs B | LONG A / SHORT B | **Exemplo de Oportunidades (Setor Bancário):** | Par | Correlação | Z-Score | Sugestão | | ------------ | ---------- | ------- | ------------------------- | | ITUB4/BBDC4 | 0,92 | +2,3 | SHORT ITUB4 / LONG BBDC4 | | BBAS3/SANB11 | 0,78 | -1,8 | Monitorar para LONG BBAS3 | | ITUB4/BBAS3 | 0,85 | +0,5 | Neutro | **Critérios para par válido:** * Correlação > 0,7 (alta correlação histórica) * p-value \< 0,05 (estatisticamente significativo) * Z-Score > |2,0| (divergência significativa) ## Relatório Setorial Automatizado ### Estrutura do Relatório Setorial Para gerar um relatório completo, busque dados fundamentalistas e técnicos via brapi: ```typescript // Buscar dados para relatório setorial completo const utilities = ["EGIE3", "SBSP3", "CPLE6", "TAEE11", "CMIG4"]; const tickersParam = utilities.join(","); const response = await fetch( `https://brapi.dev/api/quote/${tickersParam}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // Use os dados para montar seu relatório setorial ``` **Modelo de Relatório Setorial:** #### Resumo Executivo | Categoria | Empresa | Indicador | Motivo | | ------------------------ | ------- | --------- | ---------------------------- | | **Líder do Setor** | EGIE3 | ROE 22,5% | Maior eficiência operacional | | **Melhor Valor** | CMIG4 | P/L 5,8x | Menor múltiplo do setor | | **Maior Dividend Yield** | TAEE11 | DY 9,8% | Foco em distribuição | #### Ranking de Empresas | Pos | Ticker | ROE | P/L | DY | Score | | --- | ------ | ----- | ----- | ---- | ----- | | 1 | EGIE3 | 22,5% | 12,3x | 5,2% | 8,5 | | 2 | TAEE11 | 18,2% | 8,5x | 9,8% | 8,2 | | 3 | SBSP3 | 15,8% | 10,2x | 4,1% | 7,5 | | 4 | CPLE6 | 14,5% | 7,2x | 7,5% | 7,2 | | 5 | CMIG4 | 12,3% | 5,8x | 6,9% | 6,8 | #### Análise Técnica do Setor | Aspecto | Valor | | ------------------------ | --------------------------- | | **Tendência Geral** | Alta moderada | | **Força da Tendência** | Média | | **Suporte Setorial** | Índice setorial em R$ 1.850 | | **Resistência Setorial** | Índice setorial em R$ 2.100 | #### Recomendações | Tipo | Descrição | | ------------- | ----------------------------------------------------- | | **Compra** | CMIG4 - múltiplo descontado, potencial de reavaliação | | **Manter** | EGIE3, TAEE11 - qualidade, bom para renda | | **Monitorar** | CPLE6 - aguardar definição regulatória | | **Evitar** | Nenhuma empresa crítica no momento | **Componentes de um bom relatório setorial:** 1. Resumo executivo com destaques 2. Ranking quantitativo ordenado por score 3. Análise técnica do índice setorial 4. Recomendações acionáveis com justificativa ## Conclusão A análise setorial é uma ferramenta poderosa para investidores que buscam identificar as melhores oportunidades dentro de cada segmento da economia. Ao comparar empresas do mesmo setor, é possível: ### Benefícios da Análise Setorial: 1. **Contexto Apropriado**: Múltiplos e indicadores ganham significado real 2. **Identificação de Líderes**: Encontrar empresas com vantagem competitiva 3. **Oportunidades Relativas**: Descobrir ações subvalorizadas 4. **Timing de Investimento**: Identificar momentos de entrada/saída ### Próximos Passos: * **Explore nossa [API completa](/docs)** para dados setoriais * **Use nossa [plataforma](/quotes)** para comparações interativas * **Implemente os códigos** apresentados neste guia * **Crie seus próprios dashboards** setoriais ### Recursos Adicionais: * **[Dados fundamentalistas](/docs/acoes)** detalhados por empresa * **[Histórico completo](/docs)** para análise de tendências * **[Exemplos de código](/docs/examples)** em múltiplas linguagens **Lembre-se**: A análise setorial deve ser combinada com análise macroeconômica e gestão adequada de risco. Diversifique sempre entre setores para reduzir riscos específicos! # Análise Técnica de Ações: Suportes, Resistências e Médias Móveis Explicados URL: /blog/analise-tecnica-suportes-resistencias-medias-moveis.mdx Guia de análise técnica para iniciantes. Aprenda suportes, resistências, médias móveis e como identificar tendências ✓ *** searchable: true title: 'Análise Técnica de Ações: Suportes, Resistências e Médias Móveis Explicados' description: 'Guia de análise técnica para iniciantes. Aprenda suportes, resistências, médias móveis e como identificar tendências ✓' date: '2025-12-30' keywords: 'análise técnica ações, suporte e resistência, médias móveis, como analisar gráficos, candlestick, tendência ações, indicadores técnicos, day trade, 2026' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Análise Técnica' readingTime: '22 min' tags: \['Análise Técnica', 'Suporte', 'Resistência', 'Médias Móveis', 'Candlestick', 'Trading', 'Gráficos', 'Indicadores'] relatedPosts: \['entendendo-indicador-preco-lucro-pl-analise-fundamentalista', 'onde-investir-2026-guia-completo-melhores-investimentos', 'stock-screener-python-brapi-filtrar-acoes'] featured: true expertise: 'Equipe técnica especializada em análise de mercado financeiro' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > Aprenda a ler gráficos de ações como um profissional. Este guia explica suportes, resistências, médias móveis e os principais padrões de candlesticks para você tomar melhores decisões de investimento. *** ## O Que é Análise Técnica? A **análise técnica** é o estudo do comportamento histórico dos preços para prever movimentos futuros. Diferente da análise fundamentalista (que analisa balanços e indicadores), a análise técnica foca no **gráfico de preços** e no **volume negociado**. ### Análise Técnica vs Fundamentalista | Aspecto | Análise Técnica | Análise Fundamentalista | | ------------ | ----------------- | ----------------------- | | **Foco** | Preço e volume | Balanços e indicadores | | **Prazo** | Curto/médio prazo | Longo prazo | | **Pergunta** | "Quando comprar?" | "O que comprar?" | | **Base** | Padrões gráficos | Valor intrínseco | | **Uso** | Trading, timing | Investimento, seleção | **Importante:** As duas análises podem ser complementares. Muitos investidores usam fundamentalista para escolher QUAIS ações comprar e técnica para decidir QUANDO comprar. *** ## Princípios Fundamentais ### 1. O Preço Desconta Tudo Toda informação disponível (notícias, resultados, expectativas) já está refletida no preço atual da ação. ### 2. Preços se Movem em Tendências Os preços não se movem aleatoriamente — eles seguem tendências que podem ser identificadas e aproveitadas. ### 3. A História se Repete Padrões de comportamento do mercado tendem a se repetir porque refletem a psicologia humana (medo, ganância, esperança). *** ## Tendências de Mercado ### Tipos de Tendência ``` TENDÊNCIA DE ALTA (Bull Market) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📈 ● ● ● ● → Topos e fundos ascendentes ● ● TENDÊNCIA DE BAIXA (Bear Market) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ● ● ● → Topos e fundos descendentes ● ● ● 📉 TENDÊNCIA LATERAL (Consolidação) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ● ● ● ● ● ● → Preço oscila em faixa ● ● ● ↔️ ``` ### Como Identificar Tendências **Tendência de Alta:** * Topos cada vez mais altos (higher highs) * Fundos cada vez mais altos (higher lows) * Preço acima das médias móveis **Tendência de Baixa:** * Topos cada vez mais baixos (lower highs) * Fundos cada vez mais baixos (lower lows) * Preço abaixo das médias móveis **Consolidação/Lateral:** * Topos e fundos no mesmo nível * Preço oscilando entre suporte e resistência * Volume geralmente diminui *** ## Suporte e Resistência ### O Que São? **Suporte:** Nível de preço onde compradores entram com força, impedindo quedas maiores. "Chão" do preço. **Resistência:** Nível de preço onde vendedores entram com força, impedindo altas maiores. "Teto" do preço. ``` SUPORTE E RESISTÊNCIA ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ R$ 42.00 ─────────────────────── RESISTÊNCIA 🔴 ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● ● R$ 35.00 ─────────────────────── SUPORTE 🟢 O preço "bate" no suporte e resistência múltiplas vezes antes de romper ``` ### Por Que Funcionam? 1. **Memória do mercado:** Investidores lembram onde compraram/venderam 2. **Psicologia:** Números redondos (R$ 10, R$ 50, R$ 100) são significativos 3. **Ordens acumuladas:** Muitas ordens de compra/venda ficam nesses níveis 4. **Profecias autorrealizáveis:** Muitos traders olham os mesmos níveis ### Como Identificar Suportes e Resistências **Suportes fortes:** * Fundos anteriores onde o preço reverteu * Médias móveis importantes (21, 50, 200) * Números psicológicos (10, 20, 50, 100) * Gaps não preenchidos * Volume alto no nível **Resistências fortes:** * Topos anteriores onde o preço reverteu * Máximas históricas (all-time high) * Zonas de congestão anterior * Linhas de tendência de baixa ### Rompimentos (Breakouts) Quando o preço rompe um suporte ou resistência com volume, geralmente continua na direção do rompimento: ``` ROMPIMENTO DE RESISTÊNCIA ━━━━━━━━━━━━━━━━━━━━━━━━━━ ● → CONTINUAÇÃO ● ════════●════════ ← RESISTÊNCIA VIRA SUPORTE ● ● ● ● Volume alto no rompimento = mais confiável ``` **Regra importante:** Resistência rompida vira suporte. Suporte rompido vira resistência. *** ## Médias Móveis ### O Que São? Médias móveis suavizam o preço, mostrando a tendência mais claramente. São calculadas pela média dos últimos N períodos. ### Tipos de Médias Móveis | Tipo | Sigla | Característica | | ----------- | ------- | ------------------------------------- | | Simples | SMA/MMS | Todos os períodos têm mesmo peso | | Exponencial | EMA/MME | Períodos recentes têm mais peso | | Ponderada | WMA | Peso crescente para períodos recentes | ### Médias Mais Usadas | Período | Uso | Significado | | ------------ | ---------------- | --------------------- | | 9 períodos | Day trade, scalp | Muito curto prazo | | 21 períodos | Swing trade | Curto prazo (1 mês) | | 50 períodos | Position trade | Médio prazo (2 meses) | | 200 períodos | Investimento | Longo prazo (1 ano) | ### Calculando Médias Móveis Para calcular médias móveis, você precisa de dados históricos. A brapi fornece esses dados facilmente: ```typescript // Buscar dados históricos para cálculo de médias móveis const response = await fetch( "https://brapi.dev/api/quote/PETR4?range=1y&interval=1d", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); const historicalData = results[0].historicalDataPrice; // Use os dados para calcular SMA e EMA na sua aplicação ``` **Fórmulas das Médias Móveis:** | Tipo | Fórmula | Descrição | | --------------------- | ---------------------------------- | --------------------------------------- | | **SMA (Simples)** | Soma dos últimos N fechamentos ÷ N | Todos períodos têm mesmo peso | | **EMA (Exponencial)** | Preço × K + EMA anterior × (1-K) | K = 2 ÷ (N+1), peso maior para recentes | **Exemplo de Análise com Médias Móveis:** | Indicador | Valor Exemplo | Interpretação | | ---------- | ------------- | ---------------------------------------------- | | Fechamento | R$ 38,50 | Preço atual | | SMA 9 | R$ 37,80 | Preço acima = tendência curta de alta | | SMA 21 | R$ 36,50 | Preço acima = tendência de curto prazo de alta | | SMA 50 | R$ 35,20 | Preço acima = tendência de médio prazo de alta | | SMA 200 | R$ 32,00 | Preço acima = tendência de longo prazo de alta | ### Sinais de Compra e Venda **Cruzamento de Médias (Golden Cross / Death Cross):** ``` GOLDEN CROSS (Sinal de Alta) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ●──────────● SMA 50 (lenta) ●────X────● ●────● SMA 21 (rápida) ↑ COMPRA: Média rápida cruza acima da lenta DEATH CROSS (Sinal de Baixa) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ●────● SMA 21 (rápida) ●────X────● ●──────────● SMA 50 (lenta) ↑ VENDA: Média rápida cruza abaixo da lenta ``` **Sinais de Cruzamento de Médias:** | Sinal | Condição | Ação | Confiabilidade | | ------------------------ | ------------------------------------ | ------------------ | ----------------------------- | | **Golden Cross** | SMA rápida cruza acima da SMA lenta | COMPRA | Alta em tendência de alta | | **Death Cross** | SMA rápida cruza abaixo da SMA lenta | VENDA | Alta em tendência de baixa | | **Preço cruza SMA** | Preço cruza média de 21 ou 50 | Confirma tendência | Média | | **Afastamento da média** | Preço muito distante da SMA 21 | Possível correção | Baixa (necessita confirmação) | **Como identificar cruzamentos:** 1. Compare a posição relativa das médias no dia anterior e no dia atual 2. Se SMA 9 estava abaixo da SMA 21 e agora está acima = Golden Cross 3. Se SMA 9 estava acima da SMA 21 e agora está abaixo = Death Cross 4. Confirme sempre com volume alto no dia do cruzamento ### Preço vs Média como Suporte/Resistência * **Preço acima da SMA 200:** Tendência de longo prazo é de alta * **Preço abaixo da SMA 200:** Tendência de longo prazo é de baixa * **Médias servem como suporte/resistência dinâmicos** *** ## Candlesticks (Velas Japonesas) ### Anatomia de um Candlestick ``` CANDLESTICK DE ALTA CANDLESTICK DE BAIXA (Verde/Branco) (Vermelho/Preto) │ ← Sombra superior │ │ │ ┌───┴───┐ ← Fechamento ┌───┴───┐ ← Abertura │ │ │███████│ │ │ Corpo │███████│ Corpo │ │ │███████│ └───┬───┘ ← Abertura └───┬───┘ ← Fechamento │ │ │ ← Sombra inferior │ Fechou ACIMA da abertura Fechou ABAIXO da abertura ``` ### Padrões de Candlesticks Mais Importantes #### Padrões de Reversão de Alta (Compra) **1. Martelo (Hammer)** ``` │ ┌───┴───┐ │ │ ← Corpo pequeno no topo └───┬───┘ │ │ │ ← Sombra inferior longa (2-3x o corpo) │ Aparece após queda. Indica que vendedores perderam força. ``` **2. Engolfo de Alta (Bullish Engulfing)** ``` Dia 1 Dia 2 ┌─────┐ │█████│ ┌───────┐ │█████│ │ │ └──┬──┘ │ │ ← Corpo verde "engole" o vermelho │ │ │ └───┬───┘ │ Corpo verde maior que o corpo vermelho anterior. Sinal de reversão após queda. ``` **3. Estrela da Manhã (Morning Star)** ``` Dia 1 Dia 2 Dia 3 ┌─────┐ ┌───────┐ │█████│ │ │ │█████│ │ │ │█████│ ┌─┐ │ │ └──┬──┘ └─┘ └───────┘ Gap Padrão de 3 candles: vermelho grande + corpo pequeno + verde grande Forte sinal de reversão de alta. ``` #### Padrões de Reversão de Baixa (Venda) **1. Enforcado (Hanging Man)** ``` │ │ │ ← Sombra inferior longa │ ┌───┴───┐ │ │ ← Corpo pequeno no topo └───────┘ Similar ao martelo, mas aparece após ALTA. Indica que compradores podem estar perdendo força. ``` **2. Engolfo de Baixa (Bearish Engulfing)** ``` Dia 1 Dia 2 ┌───────┐ ┌─────┐ │███████│ │ │ │███████│ ← Corpo vermelho "engole" o verde │ │ │███████│ └──┬──┘ │███████│ │ └───┬───┘ │ Corpo vermelho maior que o corpo verde anterior. Sinal de reversão após alta. ``` **3. Estrela Cadente (Shooting Star)** ``` │ │ │ ← Sombra superior longa │ ┌───┴───┐ │ │ ← Corpo pequeno na base └───────┘ Aparece após alta. Indica rejeição do preço mais alto. ``` ### Padrões de Continuação **Doji (Indecisão)** ``` │ │ ────┼──── ← Abertura = Fechamento (corpo mínimo) │ │ Mercado indeciso. Pode indicar reversão se aparecer após movimento forte. ``` *** ## Indicadores Técnicos ### IFR - Índice de Força Relativa (RSI) Mede a força do movimento de preço em uma escala de 0-100. * **RSI > 70:** Sobrecomprado (possível correção para baixo) * **RSI \< 30:** Sobrevendido (possível recuperação) * **RSI = 50:** Neutro **Fórmula do RSI:** ``` RSI = 100 - (100 / (1 + RS)) RS = Média dos ganhos / Média das perdas (últimos 14 períodos) ``` **Interpretação do RSI:** | Zona | Valor RSI | Significado | Ação Sugerida | | ---------------- | --------- | ---------------------------- | ---------------------- | | 🔴 Sobrecomprado | > 70 | Possível correção para baixo | Cautela para compras | | 🟡 Neutro Alto | 50-70 | Tendência de alta moderada | Acompanhar | | ⚪ Neutro | 40-60 | Sem sinal claro | Aguardar | | 🟡 Neutro Baixo | 30-50 | Tendência de baixa moderada | Acompanhar | | 🟢 Sobrevendido | \< 30 | Possível recuperação | Oportunidade de compra | **Dica:** Divergências entre RSI e preço são sinais importantes. Se o preço faz nova máxima mas o RSI não acompanha, pode indicar fraqueza da tendência. ### MACD - Convergência/Divergência de Médias Móveis Identifica mudanças na força, direção e duração de uma tendência. **Componentes do MACD:** | Componente | Fórmula | Descrição | | ------------------ | ----------------- | ------------------------------------- | | **Linha MACD** | EMA(12) - EMA(26) | Diferença entre médias rápida e lenta | | **Linha de Sinal** | EMA(9) do MACD | Média do MACD para suavização | | **Histograma** | MACD - Sinal | Visualiza força do movimento | **Sinais do MACD:** | Situação | Sinal | Interpretação | | ----------------------------------- | ------------------ | --------------------------- | | MACD cruza acima da Linha de Sinal | **COMPRA** | Momentum virando positivo | | MACD cruza abaixo da Linha de Sinal | **VENDA** | Momentum virando negativo | | Histograma crescente | Alta | Força compradora aumentando | | Histograma decrescente | Baixa | Força vendedora aumentando | | MACD acima de zero | Tendência de alta | EMA curta > EMA longa | | MACD abaixo de zero | Tendência de baixa | EMA curta \< EMA longa | ### Bandas de Bollinger Mostram volatilidade e níveis de sobrecompra/sobrevenda. **Componentes das Bandas de Bollinger:** | Componente | Fórmula | Descrição | | ------------------ | -------------- | ---------------------------------- | | **Banda Central** | SMA(20) | Média móvel simples de 20 períodos | | **Banda Superior** | SMA(20) + 2×DP | Dois desvios padrão acima | | **Banda Inferior** | SMA(20) - 2×DP | Dois desvios padrão abaixo | **Interpretação das Bandas de Bollinger:** | Situação | Significado | Ação | | ------------------------------- | ------------------------ | ------------------------------- | | Preço próximo à banda superior | Sobrecomprado | Cautela para compras | | Preço próximo à banda inferior | Sobrevendido | Possível oportunidade | | Bandas se apertando (squeeze) | Baixa volatilidade | Prepare-se para movimento forte | | Bandas se expandindo | Alta volatilidade | Movimento em andamento | | Preço rompendo banda com volume | Continuação do movimento | Acompanhe a tendência | **Dica:** O "Bollinger Squeeze" (bandas muito próximas) geralmente precede movimentos fortes. Combine com outros indicadores para identificar a direção. *** ## Análise Técnica na Prática ### Sistema de Análise Técnica Completo Para fazer uma análise técnica completa, busque dados históricos via brapi e calcule os indicadores: ```typescript // Buscar dados históricos para análise técnica completa const response = await fetch( "https://brapi.dev/api/quote/PETR4?range=6mo&interval=1d", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); const { regularMarketPrice, historicalDataPrice } = results[0]; // Use os dados para calcular SMA, RSI, MACD e Bollinger na sua aplicação ``` **Checklist de Análise Técnica:** | Indicador | O que verificar | Sinal de Alta | Sinal de Baixa | | --------------- | -------------------------- | ------------------------ | ------------------------- | | **Tendência** | Posição do preço vs médias | Preço > SMA 21 > SMA 50 | Preço \< SMA 21 \< SMA 50 | | **RSI (14)** | Nível atual | \< 30 (sobrevendido) | > 70 (sobrecomprado) | | **MACD** | Cruzamentos | MACD > Linha de Sinal | MACD \< Linha de Sinal | | **Bollinger** | Posição nas bandas | Próximo à banda inferior | Próximo à banda superior | | **Volume** | Confirmação | Alto no rompimento | Alto na reversão | | **Suporte** | Mínima dos últimos 20 dias | Preço respeitando | Preço rompendo para baixo | | **Resistência** | Máxima dos últimos 20 dias | Preço rompendo para cima | Preço respeitando | **Sistema de Pontuação para Recomendação:** | Sinais de Alta | Recomendação | | -------------- | -------------------------------------------- | | 3 ou mais | **COMPRA** - Múltiplos indicadores alinhados | | 1-2 | **AGUARDAR** - Sinais mistos | | 0 | **VENDA** - Indicadores negativos | **Exemplo de Resultado de Análise:** | Campo | Valor Exemplo | | ---------------- | ------------- | | Ativo | PETR4 | | Preço Atual | R$ 38,50 | | Tendência | ALTA | | Suporte | R$ 35,20 | | Resistência | R$ 42,00 | | RSI | 55,3 (Neutro) | | MACD | COMPRA | | **Recomendação** | **AGUARDAR** | > **Importante:** Esta é uma análise educacional. Sempre faça sua própria pesquisa e considere seu perfil de risco antes de investir. *** ## Dicas Importantes ### ✅ Boas Práticas 1. **Combine indicadores:** Nunca use apenas um indicador 2. **Confirme com volume:** Movimentos com volume alto são mais confiáveis 3. **Respeite o stop loss:** Defina onde sair ANTES de entrar 4. **Opere a favor da tendência:** "The trend is your friend" 5. **Pratique em simuladores:** Não arrisque dinheiro real no início ### ❌ Erros Comuns 1. **Over-trading:** Operar demais por ansiedade 2. **Ignorar stop loss:** Deixar perdas crescerem 3. **Análise paralisia:** Usar muitos indicadores 4. **Operar contra tendência:** Tentar "pegar facas caindo" 5. **Não ter plano:** Entrar sem saber quando sair *** ## Conclusão A análise técnica é uma ferramenta poderosa quando usada corretamente. Os conceitos mais importantes são: 1. **Tendências:** Identifique se o mercado está em alta, baixa ou lateral 2. **Suporte/Resistência:** Níveis onde o preço tende a parar 3. **Médias Móveis:** Indicam tendência e servem como suporte/resistência 4. **Volume:** Confirma a força dos movimentos 5. **Indicadores:** RSI, MACD e Bollinger complementam a análise ### Próximos Passos 1. **[Crie sua conta na brapi](https://brapi.dev)** - Dados históricos para análise 2. **[Stock Screener](/blog/stock-screener-python-brapi-filtrar-acoes)** - Filtre ações automaticamente 3. **[Backtesting](/blog/backtesting-estrategias-brapi)** - Teste suas estratégias 4. **[Bot de Telegram](/blog/bot-telegram-cotacoes-acoes-python-tutorial)** - Receba alertas *** *Use dados da brapi.dev para suas análises técnicas. [Comece gratuitamente agora!](https://brapi.dev)* # Análise Técnica vs Fundamentalista 2026: Qual Escolher para Investir? URL: /blog/analise-tecnica-vs-fundamentalista-qual-escolher.mdx Comparativo completo entre análise técnica e fundamentalista ✓ Entenda as diferenças, quando usar cada uma e como combinar as duas estratégias. *** searchable: true title: 'Análise Técnica vs Fundamentalista 2026: Qual Escolher para Investir?' description: 'Comparativo completo entre análise técnica e fundamentalista ✓ Entenda as diferenças, quando usar cada uma e como combinar as duas estratégias.' date: '2026-01-01' keywords: 'análise técnica, análise fundamentalista, diferença análise técnica fundamentalista, como analisar ações, gráficos ações, indicadores fundamentalistas, qual análise usar, 2026' author: 'Equipe brapi.dev' category: 'Educação' subcategory: 'Análise de Investimentos' readingTime: '18 min' tags: \['Análise Técnica', 'Análise Fundamentalista', 'Gráficos', 'Indicadores', 'Trading', 'Investimentos'] relatedPosts: \['analise-fundamentalista-acoes-indicadores-essenciais-investir-b3', 'value-investing-como-encontrar-acoes-baratas', 'como-investir-em-acoes-guia-completo-iniciantes', 'como-analisar-acoes-guia-iniciantes-2026', 'day-trade-swing-trade-position-trade-2026'] featured: true expertise: 'Especialistas em métodos de análise de investimentos com experiência prática em ambas as abordagens.' lastReviewed: 2026-01-03 ------------------------ ## A Grande Questão: Técnica ou Fundamentalista? Uma das maiores dúvidas de quem começa a investir é: **devo usar análise técnica ou fundamentalista?** A resposta, como veremos, depende do seu perfil, objetivos e horizonte de tempo. Este guia apresenta ambas as metodologias de forma imparcial, mostrando quando cada uma funciona melhor e como você pode combiná-las. *** ## O que é Análise Fundamentalista A **análise fundamentalista** avalia o valor intrínseco de uma empresa com base em seus fundamentos econômicos e financeiros. O objetivo é descobrir se a ação está barata ou cara em relação ao seu valor real. ### Pilares da Análise Fundamentalista | Pilar | O que analisa | Exemplos | | ----------------------------- | ---------------------------- | ----------------------- | | **Demonstrações financeiras** | Balanço, DRE, Fluxo de Caixa | Lucro, receita, dívida | | **Indicadores** | Múltiplos de valuation | P/L, P/VP, EV/EBITDA | | **Qualidade** | Eficiência operacional | ROE, Margem, ROIC | | **Governança** | Gestão e estrutura | Composição do conselho | | **Setor** | Ambiente competitivo | Market share, barreiras | | **Macro** | Economia geral | Juros, PIB, inflação | ### Principais Indicadores Fundamentalistas **Consulta de dados fundamentalistas:** ```typescript const response = await fetch( `https://brapi.dev/api/quote/ITUB4?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const acao = results[0]; // Indicadores: priceEarnings, defaultKeyStatistics, financialData, etc. ``` **Indicadores de Valuation:** | Indicador | Campo na API | O que mede | | ---------- | ------------------------------------------ | -------------------------- | | P/L | `priceEarnings` | Preço ÷ Lucro por ação | | P/VP | `defaultKeyStatistics.priceToBook` | Preço ÷ Valor patrimonial | | EV/EBITDA | `defaultKeyStatistics.enterpriseToEbitda` | Valor da empresa ÷ EBITDA | | EV/Receita | `defaultKeyStatistics.enterpriseToRevenue` | Valor da empresa ÷ Receita | **Indicadores de Rentabilidade:** | Indicador | Campo na API | Interpretação | | -------------- | ------------------------------------ | -------------------------- | | ROE | `financialData.returnOnEquity` | > 15% = alta rentabilidade | | ROA | `financialData.returnOnAssets` | Eficiência dos ativos | | Margem Líquida | `financialData.profitMargins` | % do lucro sobre receita | | Dividend Yield | `defaultKeyStatistics.dividendYield` | Rendimento em dividendos | ### Quando Usar Análise Fundamentalista ✅ **Ideal para:** * Investimento de longo prazo (5+ anos) * Buy and Hold * Escolha de ações para carteira previdenciária * Avaliação de empresas para aquisição * Investidores que querem ser "sócios" *** ## O que é Análise Técnica A **análise técnica** estuda os movimentos de preço e volume para prever tendências futuras. Baseia-se na ideia de que "o preço desconta tudo" e que padrões históricos tendem a se repetir. ### Pilares da Análise Técnica | Pilar | O que analisa | Ferramentas | | ----------------------- | ---------------------- | ------------------------------ | | **Tendência** | Direção do mercado | Médias móveis, LTAs | | **Suporte/Resistência** | Níveis de preço | Linhas horizontais | | **Volume** | Força do movimento | OBV, Volume Profile | | **Momentum** | Velocidade da variação | RSI, MACD, Estocástico | | **Padrões gráficos** | Formações recorrentes | Triângulos, Ombro-Cabeça-Ombro | | **Candles** | Psicologia do mercado | Doji, Martelo, Engolfo | ### Principais Indicadores Técnicos **Consulta de dados históricos para análise técnica:** ```typescript const response = await fetch( `https://brapi.dev/api/quote/PETR4?range=6mo&interval=1d`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const historico = results[0].historicalDataPrice; // Calcular médias móveis, suportes e resistências a partir dos dados ``` **Médias Móveis (Moving Averages):** | Média Móvel | Uso Principal | Interpretação | | ----------- | ------------- | ------------------- | | MM9 | Curto prazo | Tendência imediata | | MM21 | Médio prazo | Tendência principal | | MM50 | Longo prazo | Tendência macro | **Sinais de Tendência:** | Condição | Sinal | | ------------------- | -------------------- | | Preço > MM21 | Tendência de alta | | Preço \< MM21 | Tendência de baixa | | MM9 > MM21 > MM50 | Alinhamento altista | | MM9 \< MM21 \< MM50 | Alinhamento baixista | | MMs cruzadas | Tendência indefinida | **Suporte e Resistência:** | Nível | Como Calcular | | ---------------- | ------------------------------------------------- | | Suporte | Mínima dos últimos 50 dias | | Resistência | Máxima dos últimos 50 dias | | Posição no range | (Preço - Suporte) ÷ (Resistência - Suporte) × 100 | ### Quando Usar Análise Técnica ✅ **Ideal para:** * Trading de curto prazo (day trade, swing trade) * Timing de entrada e saída * Operações com derivativos * Traders que operam tendências * Gestão de risco (stop loss) *** ## Comparativo: Técnica vs Fundamentalista ### Filosofia | Aspecto | Fundamentalista | Técnica | | ------------- | ----------------------- | ------------------- | | **Foco** | Valor da empresa | Movimento de preços | | **Pergunta** | "Quanto vale?" | "Para onde vai?" | | **Horizonte** | Longo prazo | Curto/médio prazo | | **Base** | Dados financeiros | Gráficos e volume | | **Crença** | Preço converge ao valor | Preço desconta tudo | ### Vantagens e Desvantagens **Análise Fundamentalista:** | Vantagens | Desvantagens | | --------------------------------------------- | ------------------------------------------ | | Baseada em dados concretos (lucros, receitas) | Não ajuda no timing de entrada | | Menor necessidade de acompanhamento diário | Empresa pode ficar barata por muito tempo | | Funciona bem no longo prazo | Dados podem estar defasados ou manipulados | | Menos suscetível a ruídos de curto prazo | Não funciona bem em crises de mercado | | Identifica valor real das empresas | Requer conhecimento contábil | **Análise Técnica:** | Vantagens | Desvantagens | | ------------------------------------------------- | ----------------------------------- | | Ajuda no timing (quando comprar/vender) | Não avalia valor intrínseco | | Funciona em qualquer ativo (ações, cripto, forex) | Pode gerar muitos sinais falsos | | Identifica tendências e pontos de entrada | Requer acompanhamento frequente | | Permite gestão de risco com stops | Custos de transação reduzem retorno | | Resposta rápida a mudanças de mercado | Alta dependência de disciplina | ### Perfil do Usuário | Fundamentalista | Técnico | | ------------------- | ------------------- | | Investidor | Trader | | Paciência alta | Reação rápida | | Olha balanços | Olha gráficos | | Foco em valor | Foco em tendência | | Menos operações | Mais operações | | Menor stress diário | Maior stress diário | *** ## Como Combinar as Duas Análises A melhor abordagem para muitos investidores é **combinar** ambas as metodologias. Use fundamentalista para escolher **O QUE** comprar e técnica para decidir **QUANDO** comprar. ### Estratégia Combinada **Consulta combinando dados fundamentalistas e técnicos:** ```typescript const response = await fetch( `https://brapi.dev/api/quote/BBAS3?modules=defaultKeyStatistics,financialData&range=3mo&interval=1d`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const acao = results[0]; // acao.priceEarnings (fundamentalista) + acao.historicalDataPrice (técnica) ``` **Critérios Fundamentalistas (O QUE comprar):** | Indicador | Aprovado se | Peso | | -------------- | --------------------- | ------- | | P/L | 0 \< P/L \< 15 | 1 ponto | | P/VP | \< 2,0 | 1 ponto | | ROE | > 15% | 1 ponto | | Dividend Yield | > 5% | 1 ponto | | **Veredicto** | ≥ 3 pontos = Aprovada | | **Critérios Técnicos (QUANDO comprar):** | Indicador | Aprovado se | Peso | | -------------------- | ------------------------ | ------- | | Preço vs MM21 | Preço > MM21 | 1 ponto | | Cruzamento de MMs | MM9 > MM21 | 1 ponto | | Distância do suporte | \< 5% | 1 ponto | | **Veredicto** | ≥ 2 pontos = Bom momento | | **Matriz de Decisão:** | Fundamentalista | Técnica | Decisão | | --------------- | ----------- | ------------------------------------ | | Aprovada | Bom momento | COMPRAR | | Aprovada | Aguardar | AGUARDAR (empresa boa, momento ruim) | | Reprovada | Qualquer | EVITAR | | Analisar | Qualquer | ANALISAR MAIS | ### Fluxo de Decisão Combinada ``` 1. FILTRO FUNDAMENTALISTA (O QUE comprar) ├── Empresa lucrativa? → Sim → Continua ├── P/L razoável? → Sim → Continua ├── Dívida controlada? → Sim → Continua └── ROE bom? → Sim → Vai para análise técnica → Não → Descarta 2. ANÁLISE TÉCNICA (QUANDO comprar) ├── Tendência de alta? → Sim → Ponto a favor ├── Próximo ao suporte? → Sim → Ponto a favor ├── Volume crescente? → Sim → Ponto a favor └── Médias alinhadas? → Sim → Comprar → Não → Aguardar momento ``` *** ## Casos de Uso Práticos ### Caso 1: Investidor de Longo Prazo **Foco: FUNDAMENTALISTA (90%)** * Selecionar empresas de qualidade * Avaliar indicadores fundamentais * Analisar histórico de lucros e dividendos **Uso de Técnica: SECUNDÁRIO (10%)** * Evitar comprar em topos óbvios * Identificar níveis de suporte para entrada * Não usar para vender posições **Exemplo prático:** 1. Identifica WEGE3 como empresa excelente (fundamentalista) 2. Aguarda correção de 10-15% ou suporte técnico 3. Compra e mantém por 10+ anos ### Caso 2: Swing Trader **Foco: TÉCNICA (70%)** * Identificar tendências * Definir pontos de entrada e saída * Usar stops e alvos técnicos **Uso de Fundamentalista: FILTRO (30%)** * Evitar empresas com problemas graves * Preferir ações líquidas e consolidadas * Verificar calendário de resultados **Exemplo prático:** 1. Filtra apenas ações com P/L positivo 2. Busca setups técnicos (rompimentos, pullbacks) 3. Opera com stop técnico e alvo de 5-15% ### Caso 3: Day Trader **Foco: TÉCNICA (95%)** * Análise de fluxo e volume * Suportes e resistências intraday * Padrões de candles * Tape reading **Fundamentalista: MÍNIMO (5%)** * Apenas verificar se há notícia relevante * Evitar operar em dia de balanço > **ALERTA:** Day trade tem taxa de sucesso menor que 10%. Requer capital, experiência e controle emocional. Não recomendado para iniciantes. *** ## O que a Ciência Diz ### Estudos sobre Análise Fundamentalista * **Eficácia comprovada** no longo prazo * Value investing supera o mercado em períodos de 10+ anos * Warren Buffett: 20% a.a. por 60+ anos (fundamentalista) * Fama-French: fatores de valor funcionam historicamente ### Estudos sobre Análise Técnica * **Resultados mistos** na literatura acadêmica * Alguns padrões têm validade estatística (momentum) * Eficiência varia por mercado e período * Custos de transação frequentemente eliminam ganhos ### Conclusão Científica > "A análise fundamentalista parece mais robusta no longo prazo, enquanto a técnica pode agregar valor em timing e gestão de risco, mas não como estratégia isolada." - Consenso acadêmico *** ## Ferramentas para Cada Análise ### Ferramentas Fundamentalistas **Dados financeiros:** * brapi.dev (dados fundamentalistas em tempo real) * Fundamentus * Status Invest * Investidor 10 **Relatórios:** * Site de RI das empresas * Releases de resultados * Formulário de referência (CVM) **Screeners:** * brapi.dev API (para screeners customizados) * Fundamentus screener * TradingView screener ### Ferramentas Técnicas **Plataformas gráficas:** * TradingView * Profit (Nelogica) * MetaTrader * Tryd **Indicadores:** * Médias móveis * RSI, MACD, Estocástico * Bandas de Bollinger * Volume Profile **Dados para backtest:** * brapi.dev (histórico de preços) * Yahoo Finance * Alpha Vantage *** ## Qual Escolher? Guia de Decisão **1. Qual seu horizonte de investimento?** | Resposta | Recomendação | | -------------- | --------------- | | Menos de 1 mês | Técnica | | 1 mês a 1 ano | Combinada | | Mais de 1 ano | Fundamentalista | **2. Quanto tempo você tem para acompanhar?** | Resposta | Recomendação | | ------------------------ | --------------- | | Várias horas por dia | Técnica | | Algumas horas por semana | Combinada | | Poucos minutos por mês | Fundamentalista | **3. Qual seu objetivo principal?** | Resposta | Recomendação | | -------------------------- | --------------- | | Ganhos rápidos | Técnica | | Crescimento patrimonial | Combinada | | Renda passiva (dividendos) | Fundamentalista | **4. Como você lida com volatilidade?** | Resposta | Recomendação | | -------------------- | --------------- | | Gosto de emoção | Técnica | | Tolero oscilações | Combinada | | Prefiro estabilidade | Fundamentalista | > A maioria das suas respostas indica sua melhor abordagem! *** ## Perguntas Frequentes ### Posso usar só análise técnica? **Sim**, mas com ressalvas. Para day trade e swing trade de curto prazo, é possível. Para investimentos, é arriscado ignorar completamente os fundamentos. ### Qual é mais difícil de aprender? **Fundamentalista** requer mais conhecimento contábil e financeiro inicial. **Técnica** parece mais simples, mas requer disciplina e controle emocional extremos. ### Warren Buffett usa análise técnica? **Não.** Buffett é puramente fundamentalista. Mas ele também tem horizonte de décadas e bilhões em capital - contexto diferente de um investidor individual. ### Preciso saber as duas? **Idealmente sim.** Mesmo que você foque em uma, entender a outra ajuda a tomar melhores decisões e entender o comportamento do mercado. *** ## Conclusão Não existe resposta única para "qual análise é melhor". A escolha depende do seu perfil, objetivos e horizonte de tempo: | Se você é... | Use principalmente... | | ------------------------- | ---------------------------------- | | Investidor de longo prazo | Fundamentalista | | Swing trader | Combinação (70% técnica, 30% fund) | | Day trader | Técnica | | Investidor de dividendos | Fundamentalista | **A melhor abordagem para a maioria** é combinar as duas: use fundamentalista para escolher O QUE comprar e técnica para decidir QUANDO comprar. Para acessar dados fundamentalistas e históricos de preços para suas análises, use a [API da brapi.dev](https://brapi.dev). *** ## Recursos Adicionais * [Documentação da API brapi.dev](/docs) * [Análise Fundamentalista - O que é](/blog/analise-fundamentalista-o-que-e) * [Value Investing](/blog/value-investing-como-encontrar-acoes-baratas) * [Como investir em ações](/blog/como-investir-em-acoes-guia-completo-iniciantes) # API de Ações com React e Next.js 2026: Tutorial Completo de Integração URL: /blog/api-acoes-react-nextjs-tutorial.mdx Aprenda a integrar a API brapi.dev com React e Next.js. Tutorial passo a passo com Server Components, hooks customizados, cache e dashboard de ações ✓ *** searchable: true title: 'API de Ações com React e Next.js 2026: Tutorial Completo de Integração' description: 'Aprenda a integrar a API brapi.dev com React e Next.js. Tutorial passo a passo com Server Components, hooks customizados, cache e dashboard de ações ✓' date: '2026-01-01' keywords: 'api acoes react 2026, nextjs api bolsa, react cotacoes acoes, nextjs server components api, brapi react tutorial, dashboard acoes react, fetch acoes nextjs, typescript api financeira' author: 'Equipe brapi.dev' category: 'Desenvolvimento' subcategory: 'Tutoriais' readingTime: '25 min' tags: \['React', 'Next.js', 'API', 'TypeScript', 'Tutorial', 'Server Components'] relatedPosts: \[ 'api-b3-typescript-javascript-integracao-completa', 'api-b3-python-requests-guia-pratico', 'b3-api-gratuita-como-usar-cotacoes', 'integracao-google-sheets-cotacoes-b3-tutorial-completo', ] featured: true expertise: 'Equipe de desenvolvedores especializados em React, Next.js e integrações financeiras' lastReviewed: '2026-01-01' -------------------------- ## Introdução Construir aplicações financeiras com **React** e **Next.js** nunca foi tão poderoso. Com o App Router do Next.js 14/15, Server Components e as APIs modernas de cache, você pode criar dashboards de ações rápidos, tipados e otimizados para SEO. Neste tutorial completo, vamos construir uma aplicação real que: * Busca cotações em tempo real * Exibe dados fundamentalistas * Implementa cache inteligente * Usa TypeScript para type-safety * Segue as melhores práticas do Next.js 2026 {/* Separator */} *** ## Por que React + Next.js para Aplicações Financeiras? ### Vantagens da Stack ``` ┌─────────────────────────────────────────────────────────────┐ │ NEXT.JS + BRAPI │ ├─────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ Server │ │ Edge │ │ Client │ │ │ │ Components │───▶│ Cache │───▶│ Hydration │ │ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │ │ │ │ │ ▼ ▼ │ │ ┌─────────────┐ ┌─────────────┐ │ │ │ brapi.dev │ │ Interativo │ │ │ │ API │ │ Dashboard │ │ │ └─────────────┘ └─────────────┘ │ │ │ └─────────────────────────────────────────────────────────────┘ ``` | Feature | Benefício | | ----------------- | ------------------------------------------------- | | Server Components | Fetch no servidor, zero JS no cliente | | Streaming | UI progressiva enquanto dados carregam | | Cache | Revalidação automática com stale-while-revalidate | | TypeScript | Type-safety end-to-end | | SEO | SSR/SSG para indexação perfeita | *** ## Setup do Projeto ### Criando o Projeto Next.js ```bash npx create-next-app@latest meu-dashboard-acoes --typescript --tailwind --app cd meu-dashboard-acoes ``` ### Estrutura de Pastas ``` meu-dashboard-acoes/ ├── app/ │ ├── layout.tsx │ ├── page.tsx │ ├── acoes/ │ │ ├── page.tsx │ │ └── [ticker]/ │ │ └── page.tsx │ └── api/ │ └── cotacao/ │ └── route.ts ├── components/ │ ├── stock-card.tsx │ ├── stock-table.tsx │ ├── price-chart.tsx │ └── loading-skeleton.tsx ├── lib/ │ ├── brapi.ts │ └── types.ts └── hooks/ └── use-stock-data.ts ``` ### Configurando Variáveis de Ambiente ```bash BRAPI_TOKEN=seu_token_aqui NEXT_PUBLIC_BRAPI_URL=https://brapi.dev/api ``` *** ## Tipos TypeScript Primeiro, vamos definir os tipos para garantir type-safety: ```typescript // lib/types.ts export interface StockQuote { symbol: string; shortName: string; longName: string; currency: string; regularMarketPrice: number; regularMarketChange: number; regularMarketChangePercent: number; regularMarketTime: string; regularMarketDayHigh: number; regularMarketDayLow: number; regularMarketVolume: number; regularMarketPreviousClose: number; regularMarketOpen: number; fiftyTwoWeekHigh: number; fiftyTwoWeekLow: number; priceEarnings?: number; earningsPerShare?: number; logourl?: string; } export interface StockFundamentals { priceEarnings?: number; earningsPerShare?: number; dividendYield?: number; priceToBook?: number; returnOnEquity?: number; debtToEquity?: number; currentRatio?: number; grossMargin?: number; operatingMargin?: number; netMargin?: number; } export interface StockData extends StockQuote { defaultKeyStatistics?: StockFundamentals; financialData?: { returnOnEquity?: number; debtToEquity?: number; currentRatio?: number; grossMargins?: number; operatingMargins?: number; profitMargins?: number; }; historicalDataPrice?: HistoricalPrice[]; } export interface HistoricalPrice { date: number; open: number; high: number; low: number; close: number; volume: number; adjustedClose: number; } export interface BrapiResponse { results: StockData[]; requestedAt: string; took: string; } export interface StockListItem { stock: string; name: string; close: number; change: number; volume: number; market_cap: number | null; logo: string; sector: string | null; type: string; } export interface StockListResponse { stocks: StockListItem[]; availableSectors: string[]; availableStockTypes: string[]; currentPage: number; totalPages: number; totalStocks: number; } ``` *** ## Cliente da API brapi.dev Agora vamos criar um cliente tipado para a API: ```typescript // lib/brapi.ts import type { BrapiResponse, StockListResponse } from './types'; const BRAPI_URL = process.env.NEXT_PUBLIC_BRAPI_URL || 'https://brapi.dev/api'; const BRAPI_TOKEN = process.env.BRAPI_TOKEN; interface FetchOptions { revalidate?: number | false; tags?: string[]; } /** * Busca cotação de uma ou mais ações */ export async function getQuote( tickers: string | string[], options: { modules?: string[]; dividends?: boolean; range?: '1d' | '5d' | '1mo' | '3mo' | '6mo' | '1y' | '5y'; interval?: '1d' | '1wk' | '1mo'; } = {}, fetchOptions: FetchOptions = {} ): Promise { const tickerString = Array.isArray(tickers) ? tickers.join(',') : tickers; const params = new URLSearchParams({ ...(options.modules?.length && { modules: options.modules.join(',') }), ...(options.dividends !== undefined && { dividends: String(options.dividends) }), ...(options.range && { range: options.range }), ...(options.interval && { interval: options.interval }), }); const url = `${BRAPI_URL}/quote/${tickerString}?${params}`; const response = await fetch(url, { headers: { ...(BRAPI_TOKEN && { Authorization: `Bearer ${BRAPI_TOKEN}` }), }, next: { revalidate: fetchOptions.revalidate ?? 300, // 5 minutos por padrão tags: fetchOptions.tags ?? ['stock-quote'], }, }); if (!response.ok) { throw new Error(`Erro ao buscar cotação: ${response.status}`); } return response.json(); } /** * Lista todas as ações disponíveis */ export async function listStocks( options: { search?: string; sortBy?: 'name' | 'close' | 'change' | 'volume' | 'market_cap'; sortOrder?: 'asc' | 'desc'; limit?: number; page?: number; sector?: string; type?: 'stock' | 'fund' | 'bdr'; } = {}, fetchOptions: FetchOptions = {} ): Promise { const params = new URLSearchParams(); if (options.search) params.set('search', options.search); if (options.sortBy) params.set('sortBy', options.sortBy); if (options.sortOrder) params.set('sortOrder', options.sortOrder); if (options.limit) params.set('limit', String(options.limit)); if (options.page) params.set('page', String(options.page)); if (options.sector) params.set('sector', options.sector); if (options.type) params.set('type', options.type); const url = `${BRAPI_URL}/quote/list?${params}`; const response = await fetch(url, { headers: { ...(BRAPI_TOKEN && { Authorization: `Bearer ${BRAPI_TOKEN}` }), }, next: { revalidate: fetchOptions.revalidate ?? 600, // 10 minutos tags: fetchOptions.tags ?? ['stock-list'], }, }); if (!response.ok) { throw new Error(`Erro ao listar ações: ${response.status}`); } return response.json(); } /** * Busca múltiplas ações em paralelo */ export async function getMultipleQuotes( tickers: string[], options: Parameters[1] = {} ): Promise { // brapi já suporta múltiplos tickers separados por vírgula return getQuote(tickers, options); } ``` *** ## Server Components ### Página Principal com Lista de Ações ```tsx // app/acoes/page.tsx import { Suspense } from 'react'; import { listStocks } from '@/lib/brapi'; import { StockTable } from '@/components/stock-table'; import { LoadingSkeleton } from '@/components/loading-skeleton'; export const metadata = { title: 'Lista de Ações Brasileiras | Meu Dashboard', description: 'Acompanhe todas as ações da bolsa brasileira em tempo real', }; // Componente que busca os dados (Server Component) async function StockList() { const data = await listStocks({ sortBy: 'volume', sortOrder: 'desc', limit: 50, }); return ; } // Página com Suspense para streaming export default function AcoesPage() { return (

Ações Brasileiras

}>
); } ``` ### Página de Detalhes da Ação ```tsx // app/acoes/[ticker]/page.tsx import { Suspense } from 'react'; import { notFound } from 'next/navigation'; import { getQuote } from '@/lib/brapi'; import { StockCard } from '@/components/stock-card'; import { PriceChart } from '@/components/price-chart'; import { FundamentalsTable } from '@/components/fundamentals-table'; import { LoadingSkeleton } from '@/components/loading-skeleton'; interface PageProps { params: { ticker: string }; } // Gera metadados dinâmicos export async function generateMetadata({ params }: PageProps) { const ticker = params.ticker.toUpperCase(); try { const data = await getQuote(ticker); const stock = data.results[0]; return { title: `${stock.shortName} (${ticker}) | Cotação e Análise`, description: `Cotação atual de ${stock.shortName}: R$ ${stock.regularMarketPrice.toFixed(2)}. Análise fundamentalista, gráficos e indicadores.`, }; } catch { return { title: `${ticker} | Ação não encontrada`, }; } } // Componente de dados da ação async function StockData({ ticker }: { ticker: string }) { try { const data = await getQuote( ticker, { modules: ['defaultKeyStatistics', 'financialData'], range: '1y', interval: '1d', }, { revalidate: 300, tags: [`stock-${ticker}`] } ); const stock = data.results[0]; if (!stock) { notFound(); } return (
{stock.historicalDataPrice && ( )} {stock.defaultKeyStatistics && ( )}
); } catch (error) { throw error; } } export default function TickerPage({ params }: PageProps) { const ticker = params.ticker.toUpperCase(); return (
}>
); } // Gera páginas estáticas para ações populares export async function generateStaticParams() { const popularTickers = [ 'PETR4', 'VALE3', 'ITUB4', 'BBDC4', 'ABEV3', 'WEGE3', 'RENT3', 'MGLU3', 'BBAS3', 'B3SA3' ]; return popularTickers.map((ticker) => ({ ticker: ticker.toLowerCase(), })); } ``` *** ## Componentes de UI ### Card de Ação ```tsx // components/stock-card.tsx import type { StockData } from '@/lib/types'; interface StockCardProps { stock: StockData; } export function StockCard({ stock }: StockCardProps) { const isPositive = stock.regularMarketChange >= 0; return (
{stock.logourl && ( {stock.shortName} )}

{stock.symbol}

{stock.shortName}

R$ {stock.regularMarketPrice.toFixed(2)}

{isPositive ? '+' : ''}{stock.regularMarketChange.toFixed(2)} ({isPositive ? '+' : ''}{stock.regularMarketChangePercent.toFixed(2)}%)

Abertura

R$ {stock.regularMarketOpen.toFixed(2)}

Máxima

R$ {stock.regularMarketDayHigh.toFixed(2)}

Mínima

R$ {stock.regularMarketDayLow.toFixed(2)}

Volume

{new Intl.NumberFormat('pt-BR').format(stock.regularMarketVolume)}

); } ``` ### Tabela de Ações ```tsx // components/stock-table.tsx import Link from 'next/link'; import type { StockListItem } from '@/lib/types'; interface StockTableProps { stocks: StockListItem[]; } export function StockTable({ stocks }: StockTableProps) { return (
{stocks.map((stock) => ( ))}
Ticker Nome Cotação Variação Volume Setor
{stock.logo && ( )} {stock.stock} {stock.name} R$ {stock.close.toFixed(2)} = 0 ? 'text-green-500' : 'text-red-500' }`}> {stock.change >= 0 ? '+' : ''}{stock.change.toFixed(2)}% {new Intl.NumberFormat('pt-BR', { notation: 'compact' }).format(stock.volume)} {stock.sector || '-'}
); } ``` ### Skeleton de Loading ```tsx // components/loading-skeleton.tsx interface LoadingSkeletonProps { rows?: number; } export function LoadingSkeleton({ rows = 5 }: LoadingSkeletonProps) { return (
{Array.from({ length: rows }).map((_, i) => (
))}
); } ``` *** ## Client Components e Hooks Para funcionalidades interativas, usamos Client Components: ### Hook para Busca de Ações ```tsx // hooks/use-stock-search.ts 'use client'; import { useState, useEffect, useCallback } from 'react'; import { useDebounce } from './use-debounce'; import type { StockListItem } from '@/lib/types'; export function useStockSearch(initialQuery = '') { const [query, setQuery] = useState(initialQuery); const [results, setResults] = useState([]); const [loading, setLoading] = useState(false); const [error, setError] = useState(null); const debouncedQuery = useDebounce(query, 300); const search = useCallback(async (searchQuery: string) => { if (!searchQuery.trim()) { setResults([]); return; } setLoading(true); setError(null); try { const response = await fetch( `/api/cotacao/search?q=${encodeURIComponent(searchQuery)}` ); if (!response.ok) { throw new Error('Erro na busca'); } const data = await response.json(); setResults(data.stocks); } catch (err) { setError(err instanceof Error ? err.message : 'Erro desconhecido'); setResults([]); } finally { setLoading(false); } }, []); useEffect(() => { search(debouncedQuery); }, [debouncedQuery, search]); return { query, setQuery, results, loading, error }; } ``` ### Componente de Busca Interativa ```tsx // components/stock-search.tsx 'use client'; import { useState, useRef, useEffect } from 'react'; import Link from 'next/link'; import { useStockSearch } from '@/hooks/use-stock-search'; export function StockSearch() { const { query, setQuery, results, loading, error } = useStockSearch(); const [isOpen, setIsOpen] = useState(false); const containerRef = useRef(null); // Fecha dropdown ao clicar fora useEffect(() => { function handleClickOutside(event: MouseEvent) { if (containerRef.current && !containerRef.current.contains(event.target as Node)) { setIsOpen(false); } } document.addEventListener('mousedown', handleClickOutside); return () => document.removeEventListener('mousedown', handleClickOutside); }, []); return (
{ setQuery(e.target.value); setIsOpen(true); }} onFocus={() => setIsOpen(true)} placeholder="Buscar ação (ex: PETR4, Vale, Itaú...)" className="w-full px-4 py-2 border rounded-lg focus:ring-2 focus:ring-blue-500" /> {isOpen && (query.length > 0) && (
{loading && (
Buscando...
)} {error && (
{error}
)} {!loading && results.length === 0 && query.length > 0 && (
Nenhuma ação encontrada
)} {results.map((stock) => ( setIsOpen(false)} className="flex items-center gap-3 p-3 hover:bg-gray-50" > {stock.logo && ( )}

{stock.stock}

{stock.name}

= 0 ? 'text-green-500' : 'text-red-500' }`}> R$ {stock.close.toFixed(2)} ))}
)}
); } ``` *** ## Route Handler para API Interna ```typescript // app/api/cotacao/search/route.ts import { NextRequest, NextResponse } from 'next/server'; import { listStocks } from '@/lib/brapi'; export async function GET(request: NextRequest) { const searchParams = request.nextUrl.searchParams; const query = searchParams.get('q') || ''; try { const data = await listStocks({ search: query, limit: 10, }); return NextResponse.json(data); } catch (error) { console.error('Erro na busca:', error); return NextResponse.json( { error: 'Erro ao buscar ações' }, { status: 500 } ); } } ``` *** ## Cache e Revalidação ### Estratégias de Cache ```typescript // lib/cache-config.ts export const cacheStrategies = { // Cotações em tempo real - cache curto realtime: { revalidate: 60, // 1 minuto }, // Dados fundamentalistas - cache médio fundamentals: { revalidate: 3600, // 1 hora }, // Lista de ações - cache longo stockList: { revalidate: 86400, // 24 horas }, // Dados históricos - cache muito longo historical: { revalidate: false, // Não revalida (dados não mudam) }, }; ``` ### Revalidação On-Demand ```typescript // app/api/revalidate/route.ts import { NextRequest, NextResponse } from 'next/server'; import { revalidateTag } from 'next/cache'; export async function POST(request: NextRequest) { const { tag, secret } = await request.json(); // Verificar secret para segurança if (secret !== process.env.REVALIDATION_SECRET) { return NextResponse.json({ error: 'Invalid secret' }, { status: 401 }); } try { revalidateTag(tag); return NextResponse.json({ revalidated: true, tag }); } catch (error) { return NextResponse.json({ error: 'Revalidation failed' }, { status: 500 }); } } ``` *** ## Gráfico de Preços com Chart.js ```tsx // components/price-chart.tsx 'use client'; import { useMemo } from 'react'; import { Chart as ChartJS, CategoryScale, LinearScale, PointElement, LineElement, Title, Tooltip, Legend, Filler, } from 'chart.js'; import { Line } from 'react-chartjs-2'; import type { HistoricalPrice } from '@/lib/types'; ChartJS.register( CategoryScale, LinearScale, PointElement, LineElement, Title, Tooltip, Legend, Filler ); interface PriceChartProps { data: HistoricalPrice[]; symbol: string; } export function PriceChart({ data, symbol }: PriceChartProps) { const chartData = useMemo(() => { const sortedData = [...data].sort((a, b) => a.date - b.date); return { labels: sortedData.map((d) => new Date(d.date * 1000).toLocaleDateString('pt-BR') ), datasets: [ { label: `${symbol} - Fechamento`, data: sortedData.map((d) => d.close), borderColor: 'rgb(59, 130, 246)', backgroundColor: 'rgba(59, 130, 246, 0.1)', fill: true, tension: 0.1, }, ], }; }, [data, symbol]); const options = { responsive: true, plugins: { legend: { position: 'top' as const, }, tooltip: { callbacks: { label: (context: any) => `R$ ${context.raw.toFixed(2)}`, }, }, }, scales: { y: { ticks: { callback: (value: number) => `R$ ${value.toFixed(2)}`, }, }, }, }; return (

Histórico de Preços

); } ``` *** ## Dashboard Completo ```tsx // app/page.tsx import { Suspense } from 'react'; import { getQuote, listStocks } from '@/lib/brapi'; import { StockCard } from '@/components/stock-card'; import { StockTable } from '@/components/stock-table'; import { StockSearch } from '@/components/stock-search'; import { LoadingSkeleton } from '@/components/loading-skeleton'; // Ações em destaque async function FeaturedStocks() { const data = await getQuote( ['PETR4', 'VALE3', 'ITUB4', 'WEGE3'], { modules: ['defaultKeyStatistics', 'financialData'] } ); return (
{data.results.map((stock) => ( ))}
); } // Top performers do dia async function TopPerformers() { const data = await listStocks({ sortBy: 'change', sortOrder: 'desc', limit: 10, type: 'stock', }); return ; } export default function HomePage() { return (

Dashboard de Ações

Acompanhe o mercado brasileiro em tempo real

Ações em Destaque

}>

Maiores Altas do Dia

}>
); } ``` *** ## Boas Práticas ### 1. Tratamento de Erros ```tsx // components/error-boundary.tsx 'use client'; import { useEffect } from 'react'; interface ErrorBoundaryProps { error: Error & { digest?: string }; reset: () => void; } export default function ErrorBoundary({ error, reset }: ErrorBoundaryProps) { useEffect(() => { console.error('Error:', error); }, [error]); return (

Algo deu errado

Não foi possível carregar os dados

); } ``` ### 2. Loading States com Streaming ```tsx // app/acoes/[ticker]/loading.tsx export default function Loading() { return (
); } ``` ### 3. Otimização de Imagens ```tsx // Usar next/image para logos import Image from 'next/image'; {stock.shortName} ``` *** ## Deploy para Produção ### Vercel ```bash # Deploy automático git push origin main # Ou deploy manual vercel --prod ``` ### Variáveis de Ambiente na Vercel ``` BRAPI_TOKEN=seu_token_de_producao NEXT_PUBLIC_BRAPI_URL=https://brapi.dev/api REVALIDATION_SECRET=sua_chave_secreta ``` *** ## Conclusão Neste tutorial, construímos uma aplicação completa de dashboard de ações com: * **Server Components** para fetch otimizado * **Streaming** para UI progressiva * **Cache inteligente** com revalidação * **TypeScript** para segurança de tipos * **Componentes reutilizáveis** e bem estruturados ### Próximos Passos 1. Adicionar autenticação com NextAuth.js 2. Implementar watchlist personalizada 3. Adicionar alertas de preço 4. Integrar análise técnica com gráficos avançados ### Recursos * [Documentação brapi.dev](/docs) * [Obter API Token](/dashboard) * [Exemplos no GitHub](https://github.com/brapi-dev/examples) *** **Pronto para construir seu dashboard de ações?** [Crie sua conta grátis](/signup) e comece a usar a API brapi.dev hoje! # Como Usar a API de Ações Brasileiras com Python: Guia Prático 2026 URL: /blog/api-b3-python-requests-guia-pratico.mdx Aprenda a integrar a API brapi.dev com Python usando requests. Exemplos práticos com classes, Pandas, Flask e exportação para CSV/Excel. *** searchable: true title: 'Como Usar a API de Ações Brasileiras com Python: Guia Prático 2026' description: 'Aprenda a integrar a API brapi.dev com Python usando requests. Exemplos práticos com classes, Pandas, Flask e exportação para CSV/Excel.' date: '2025-10-12' keywords: 'python api de ações brasileiras, requests python, cotações python, pandas bolsa brasileira, flask api, python stock market, brapi python' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Desenvolvimento Python' readingTime: '8 min' tags: \['Python', 'API', 'Requests', 'Pandas', 'Flask', 'Automação'] relatedPosts: \['dados-historicos-b3-python-pandas-api', 'listar-acoes-b3-api-tickers-setores-python', 'api-indicadores-fundamentalistas-b3-python', 'api-b3-typescript-javascript-integracao-completa'] featured: false expertise: 'Desenvolvimento Python para análise financeira - 7+ anos' lastReviewed: '2026-07-17' howToTools: \['Python 3.8+', 'pip', 'Conta brapi.dev'] howToSteps: * name: 'Instale a biblioteca requests' text: 'Execute pip install requests no terminal para instalar a biblioteca de requisições HTTP.' * name: 'Obtenha seu token da API' text: 'Crie uma conta gratuita em brapi.dev e copie seu token no painel de usuário.' * name: 'Faça sua primeira requisição' text: 'Use requests.get() com a URL [https://brapi.dev/api/quote/TICKER](https://brapi.dev/api/quote/TICKER) e o header Authorization: Bearer SEU\_TOKEN para buscar cotações.' * name: 'Processe os dados retornados' text: 'Acesse os resultados com response.json() e extraia os dados de cotação do campo results.' *** import { Author, Authors } from '~/components/Authors'; > Guia completo para buscar cotações de ações, ETFs e outros ativos da bolsa brasileira usando Python e a biblioteca requests. Para avançar depois da primeira chamada, veja os exemplos específicos de [histórico com pandas](/blog/dados-historicos-b3-python-pandas-api), [lista de tickers e setores](/blog/listar-acoes-b3-api-tickers-setores-python) e [indicadores fundamentalistas](/blog/api-indicadores-fundamentalistas-b3-python). ## Por Que Python para Análise Financeira? Python é a linguagem preferida para análise de dados e finanças por ser: * **Simples de aprender** - Sintaxe clara e intuitiva * **Poderosa** - Bibliotecas como Pandas, NumPy e Matplotlib * **Popular** - Grande comunidade e recursos * **Versátil** - Desde scripts até aplicações web ## Instalação ```bash pip install requests ``` ## Exemplo Básico ```python import requests token = 'SEU_TOKEN' ticker = 'PETR4' url = f'https://brapi.dev/api/quote/{ticker}' response = requests.get(url, headers={'Authorization': f'Bearer {token}'}) data = response.json() quote = data['results'][0] print(f"{quote['symbol']}: R$ {quote['regularMarketPrice']:.2f}") ``` ## Classe Cliente Profissional ```python import requests from typing import Dict, List, Optional from dataclasses import dataclass @dataclass class Quote: """Representa uma cotação de ativo""" symbol: str short_name: str regular_market_price: float regular_market_change_percent: float currency: str @classmethod def from_dict(cls, data: Dict) -> 'Quote': return cls( symbol=data['symbol'], short_name=data['shortName'], regular_market_price=data['regularMarketPrice'], regular_market_change_percent=data['regularMarketChangePercent'], currency=data['currency'] ) class BrapiClient: """Cliente para a API brapi.dev""" BASE_URL = 'https://brapi.dev/api' def __init__(self, token: str): self.token = token self.session = requests.Session() self.session.headers.update({ 'User-Agent': 'Python BrapiClient/1.0', 'Authorization': f'Bearer {token}' }) def get_quote(self, ticker: str) -> Optional[Quote]: """Busca cotação de um ativo""" url = f'{self.BASE_URL}/quote/{ticker}' try: response = self.session.get(url, timeout=10) response.raise_for_status() data = response.json() if data.get('results'): return Quote.from_dict(data['results'][0]) return None except requests.exceptions.RequestException as e: print(f'Erro ao buscar {ticker}: {e}') return None def get_multiple_quotes(self, tickers: List[str]) -> List[Quote]: """Busca cotações de múltiplos ativos""" tickers_param = ','.join(tickers) url = f'{self.BASE_URL}/quote/{tickers_param}' try: response = self.session.get(url, timeout=10) response.raise_for_status() data = response.json() return [Quote.from_dict(item) for item in data.get('results', [])] except requests.exceptions.RequestException as e: print(f'Erro ao buscar cotações: {e}') return [] def __enter__(self): return self def __exit__(self, *args): self.session.close() with BrapiClient('SEU_TOKEN') as client: quote = client.get_quote('PETR4') if quote: print(f'{quote.symbol}: R$ {quote.regular_market_price:.2f}') ``` ## Integração com Pandas ```python import pandas as pd def get_quotes_dataframe(tickers: List[str], token: str) -> pd.DataFrame: """Retorna cotações como DataFrame""" with BrapiClient(token) as client: quotes = client.get_multiple_quotes(tickers) if not quotes: return pd.DataFrame() data = [{ 'symbol': q.symbol, 'name': q.short_name, 'price': q.regular_market_price, 'change_percent': q.regular_market_change_percent, 'currency': q.currency } for q in quotes] return pd.DataFrame(data) # Uso df = get_quotes_dataframe(['PETR4', 'VALE3', 'ITUB4'], 'SEU_TOKEN') print(df) # Salvar em Excel df.to_excel('cotacoes.xlsx', index=False) # Salvar em CSV df.to_csv('cotacoes.csv', index=False) ``` ## Análise de Dados ```python # Estatísticas básicas print(df['price'].describe()) # Filtrar ações com variação positiva df_positivas = df[df['change_percent'] > 0] # Ordenar por variação df_sorted = df.sort_values('change_percent', ascending=False) # Calcular média de preços media_preco = df['price'].mean() ``` ## Aplicação Flask ```python from flask import Flask, jsonify import os app = Flask(__name__) BRAPI_TOKEN = os.environ.get('BRAPI_TOKEN') @app.route('/api/quote/') def get_quote_api(ticker): """Endpoint para buscar cotação""" with BrapiClient(BRAPI_TOKEN) as client: quote = client.get_quote(ticker) if not quote: return jsonify({'error': 'Quote not found'}), 404 return jsonify({ 'symbol': quote.symbol, 'name': quote.short_name, 'price': quote.regular_market_price, 'change_percent': quote.regular_market_change_percent }) if __name__ == '__main__': app.run(debug=True) ``` ## Script de Monitoramento ```python import time from datetime import datetime def monitor_stocks(tickers: List[str], token: str, interval: int = 60): """Monitora ações em tempo real""" print(f"Monitorando {len(tickers)} ativos...") while True: with BrapiClient(token) as client: quotes = client.get_multiple_quotes(tickers) print(f"\n=== {datetime.now().strftime('%H:%M:%S')} ===") for quote in quotes: color = '\033[92m' if quote.regular_market_change_percent > 0 else '\033[91m' reset = '\033[0m' print(f"{quote.symbol}: R$ {quote.regular_market_price:.2f} " f"{color}{quote.regular_market_change_percent:+.2f}%{reset}") time.sleep(interval) # Uso monitor_stocks(['PETR4', 'VALE3', 'ITUB4'], 'SEU_TOKEN', interval=60) ``` ## Salvando Histórico em CSV ```python import csv from datetime import datetime def save_quotes_to_csv(tickers: List[str], token: str, filename: str): """Salva cotações em arquivo CSV""" with BrapiClient(token) as client: quotes = client.get_multiple_quotes(tickers) if not quotes: print('Nenhuma cotação obtida') return with open(filename, 'a', newline='', encoding='utf-8') as csvfile: fieldnames = ['timestamp', 'symbol', 'name', 'price', 'change_percent'] writer = csv.DictWriter(csvfile, fieldnames=fieldnames) # Escreve cabeçalho se arquivo estiver vazio if csvfile.tell() == 0: writer.writeheader() timestamp = datetime.now().isoformat() for quote in quotes: writer.writerow({ 'timestamp': timestamp, 'symbol': quote.symbol, 'name': quote.short_name, 'price': quote.regular_market_price, 'change_percent': quote.regular_market_change_percent }) print(f'Cotações salvas em {filename}') # Uso - executa diariamente save_quotes_to_csv(['PETR4', 'VALE3', 'ITUB4'], 'SEU_TOKEN', 'historico.csv') ``` ## Boas Práticas ### 1. Use Variáveis de Ambiente ```python import os from dotenv import load_dotenv load_dotenv() # Carrega .env token = os.environ.get('BRAPI_TOKEN') if not token: raise ValueError('BRAPI_TOKEN não configurado') ``` Arquivo `.env`: ``` BRAPI_TOKEN=seu_token_aqui ``` ### 2. Implemente Tratamento de Erros ```python try: quote = client.get_quote('PETR4') except requests.exceptions.Timeout: print('Timeout na requisição') except requests.exceptions.ConnectionError: print('Erro de conexão') except Exception as e: print(f'Erro inesperado: {e}') ``` ### 3. Use Context Managers ```python with BrapiClient(token) as client: # As conexões são fechadas automaticamente quote = client.get_quote('PETR4') ``` ## Próximos Passos * [Veja exemplos em outras linguagens](/docs/examples) * [Integre com Google Sheets](/docs/examples/google-sheets) * [Explore a documentação](/docs) ## Conclusão Python é uma excelente escolha para trabalhar com dados da bolsa brasileira. Com requests e Pandas, você pode criar análises poderosas, automações e até aplicações web completas. **Comece agora**: Copie o código acima e adapte para suas necessidades! # API de Ações Brasileiras com TypeScript e JavaScript: Integração Completa 2025 URL: /blog/api-b3-typescript-javascript-integracao-completa.mdx Guia completo de integração da API brapi.dev com TypeScript e JavaScript. Exemplos práticos com fetch, Axios, Next.js e Node.js para buscar cotações da bolsa brasileira. *** searchable: true title: 'API de Ações Brasileiras com TypeScript e JavaScript: Integração Completa 2025' description: 'Guia completo de integração da API brapi.dev com TypeScript e JavaScript. Exemplos práticos com fetch, Axios, Next.js e Node.js para buscar cotações da bolsa brasileira.' date: '2025-10-12' keywords: 'api ações brasileiras typescript, javascript cotações, fetch api, axios bolsa brasileira, next.js api, typescript stock api, brapi typescript' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Desenvolvimento Web' readingTime: '10 min' tags: \['TypeScript', 'JavaScript', 'API', 'Next.js', 'Node.js', 'Desenvolvimento'] relatedPosts: \['b3-api-gratuita-como-usar-cotacoes', 'integracao-google-sheets-cotacoes-b3-tutorial-completo'] featured: false expertise: 'Desenvolvimento web com TypeScript e Next.js - 8+ anos' lastReviewed: '2025-10-12' howToTools: \['Node.js 18+', 'npm ou bun', 'Conta brapi.dev'] howToSteps: * name: 'Configure o ambiente' text: 'Certifique-se de ter Node.js 18+ instalado para usar fetch nativo ou instale axios com npm install axios.' * name: 'Obtenha seu token da API' text: 'Crie uma conta gratuita em brapi.dev e copie seu token no painel de usuário.' * name: 'Defina os tipos TypeScript' text: 'Crie interfaces para Quote e QuoteResponse com os campos retornados pela API.' * name: 'Faça requisições com fetch' text: 'Use fetch() ou axios.get() para chamar [https://brapi.dev/api/quote/TICKER](https://brapi.dev/api/quote/TICKER) com o header Authorization: Bearer SEU\_TOKEN.' * name: 'Integre em sua aplicação' text: 'Use os dados retornados em componentes React, APIs Next.js ou scripts Node.js.' *** import { Author, Authors } from '~/components/Authors'; > Aprenda a buscar cotações de ações, ETFs e outros ativos da bolsa brasileira usando TypeScript e JavaScript em aplicações modernas. ## Por Que Integrar Dados da Bolsa Brasileira em Sua Aplicação? Aplicações financeiras, dashboards de investimentos e plataformas de análise precisam de dados confiáveis e atualizados do mercado brasileiro. A API da brapi.dev oferece acesso simples e direto a: * Cotações em tempo real (plano pago) ou com delay de 15 min (gratuito) * Dados de ações, ETFs, FIIs, BDRs e criptomoedas * Informações fundamentalistas * Histórico de preços * Dividendos e proventos ## Começando: Fetch Nativo (Browser e Node.js 18+) O fetch é nativo em navegadores modernos e Node.js 18+, sem necessidade de bibliotecas extras. ### Exemplo Básico ```typescript const fetchQuote = async (ticker: string) => { const token = process.env.BRAPI_TOKEN; const response = await fetch( `https://brapi.dev/api/quote/${ticker}`, { headers: { 'Authorization': `Bearer ${token}` } } ); const data = await response.json(); return data; }; // Uso fetchQuote('PETR4').then(data => { console.log(data.results[0]); }); ``` ### Com TypeScript e Tratamento de Erros ```typescript interface Quote { symbol: string; shortName: string; regularMarketPrice: number; regularMarketChange: number; regularMarketChangePercent: number; currency: string; } interface QuoteResponse { results: Quote[]; requestedAt: string; took: string; } async function getQuote(ticker: string): Promise { const token = process.env.BRAPI_TOKEN; try { const response = await fetch( `https://brapi.dev/api/quote/${ticker}`, { headers: { 'Authorization': `Bearer ${token}` } } ); if (!response.ok) { throw new Error(`HTTP ${response.status}: ${response.statusText}`); } const data: QuoteResponse = await response.json(); return data.results[0] || null; } catch (error) { console.error('Erro ao buscar cotação:', error); return null; } } // Uso com tipos const quote = await getQuote('PETR4'); if (quote) { console.log(`${quote.symbol}: R$ ${quote.regularMarketPrice.toFixed(2)}`); console.log(`Variação: ${quote.regularMarketChangePercent.toFixed(2)}%`); } ``` ### Buscando Múltiplos Tickers ```typescript async function getMultipleQuotes(tickers: string[]): Promise { const token = process.env.BRAPI_TOKEN; const tickersParam = tickers.join(','); const response = await fetch( `https://brapi.dev/api/quote/${tickersParam}`, { headers: { 'Authorization': `Bearer ${token}` } } ); const data: QuoteResponse = await response.json(); return data.results; } // Uso const quotes = await getMultipleQuotes(['PETR4', 'VALE3', 'ITUB4']); quotes.forEach(quote => { console.log(`${quote.symbol}: R$ ${quote.regularMarketPrice}`); }); ``` ## Usando Axios para Mais Recursos Axios oferece sintaxe mais simples, interceptors e melhor tratamento de erros. ### Instalação ```bash npm install axios yarn add axios # ou bun add axios ``` ### Cliente Básico com Axios ```typescript import axios from 'axios'; const brapiClient = axios.create({ baseURL: 'https://brapi.dev/api', headers: { 'Authorization': `Bearer ${process.env.BRAPI_TOKEN}` } }); // Buscar cotação const { data } = await brapiClient.get(`/quote/PETR4`); console.log(data.results[0]); ``` ### Classe Cliente Profissional ```typescript import axios, { AxiosInstance, AxiosError } from 'axios'; class BrapiClient { private client: AxiosInstance; constructor(token: string) { this.client = axios.create({ baseURL: 'https://brapi.dev/api', timeout: 10000, headers: { 'Authorization': `Bearer ${token}` } }); } async getQuote(ticker: string): Promise { try { const { data } = await this.client.get(`/quote/${ticker}`); return data.results[0]; } catch (error) { if (axios.isAxiosError(error)) { throw new Error(`API Error: ${error.response?.status} - ${error.message}`); } throw error; } } async getMultipleQuotes(tickers: string[]): Promise { const tickersParam = tickers.join(','); const { data } = await this.client.get(`/quote/${tickersParam}`); return data.results; } } // Uso const brapi = new BrapiClient(process.env.BRAPI_TOKEN!); const quote = await brapi.getQuote('PETR4'); ``` ## Integração com Next.js ### Server Component (Recomendado) ```typescript // app/stock/[ticker]/page.tsx interface PageProps { params: { ticker: string }; } async function getQuote(ticker: string) { const token = process.env.BRAPI_TOKEN; const res = await fetch( `https://brapi.dev/api/quote/${ticker}`, { headers: { 'Authorization': `Bearer ${token}` }, next: { revalidate: 60 } // Cache por 60 segundos } ); if (!res.ok) throw new Error('Failed to fetch'); return res.json(); } export default async function StockPage({ params }: PageProps) { const data = await getQuote(params.ticker); const quote = data.results[0]; return (

{quote.shortName}

R$ {quote.regularMarketPrice.toFixed(2)}

0 ? 'text-green-600' : 'text-red-600'}> {quote.regularMarketChangePercent.toFixed(2)}%

); } ``` ### API Route ```typescript // app/api/quote/[ticker]/route.ts import { NextResponse } from 'next/server'; export async function GET( request: Request, { params }: { params: { ticker: string } } ) { const token = process.env.BRAPI_TOKEN; try { const response = await fetch( `https://brapi.dev/api/quote/${params.ticker}`, { headers: { 'Authorization': `Bearer ${token}` } } ); if (!response.ok) { return NextResponse.json( { error: 'Failed to fetch quote' }, { status: response.status } ); } const data = await response.json(); return NextResponse.json(data); } catch (error) { return NextResponse.json( { error: 'Internal server error' }, { status: 500 } ); } } ``` ### Client Component com SWR ```typescript 'use client'; import useSWR from 'swr'; const fetcher = (url: string) => fetch(url).then(r => r.json()); export function StockQuote({ ticker }: { ticker: string }) { const { data, error, isLoading } = useSWR( `/api/quote/${ticker}`, fetcher, { refreshInterval: 60000 } // Atualiza a cada 60s ); if (error) return
Erro ao carregar
; if (isLoading) return
Carregando...
; const quote = data.results[0]; return (

{quote.symbol}

R$ {quote.regularMarketPrice.toFixed(2)}

); } ``` ## Node.js com Cache ```typescript class BrapiService { private cache = new Map(); private cacheDuration = 60000; // 60 segundos constructor(private token: string) {} async getQuote(ticker: string): Promise { const cached = this.cache.get(ticker); const now = Date.now(); // Retorna do cache se ainda válido if (cached && now - cached.timestamp < this.cacheDuration) { return cached.data; } // Busca novo dado const response = await fetch( `https://brapi.dev/api/quote/${ticker}`, { headers: { 'Authorization': `Bearer ${this.token}` } } ); const data = await response.json(); const quote = data.results[0]; // Atualiza cache this.cache.set(ticker, { data: quote, timestamp: now }); return quote; } } // Uso const service = new BrapiService(process.env.BRAPI_TOKEN!); const quote = await service.getQuote('PETR4'); ``` ## Boas Práticas ### 1. Armazene o Token em Variáveis de Ambiente ```bash # .env.local BRAPI_TOKEN=seu_token_aqui ``` ```typescript // Nunca faça isso const token = 'meu_token_secreto'; // ❌ Inseguro! // Faça isso const token = process.env.BRAPI_TOKEN; // ✅ Seguro ``` ### 2. Implemente Cache ```typescript // Next.js App Router fetch(url, { next: { revalidate: 60 } }) // Next.js Pages Router export async function getStaticProps() { return { props: { data }, revalidate: 60 // Revalida a cada 60s } } ``` ### 3. Trate Erros Adequadamente ```typescript try { const quote = await getQuote('PETR4'); } catch (error) { if (error instanceof Error) { console.error('Erro:', error.message); } } ``` ### 4. Use TypeScript para Segurança de Tipos ```typescript // Define interfaces para os dados interface Quote { symbol: string; regularMarketPrice: number; // ... outros campos } // TypeScript vai alertar sobre erros const price: number = quote.regularMarketPrice; // ✅ const invalid: string = quote.regularMarketPrice; // ❌ Erro de tipo ``` ## Exemplo Completo: Dashboard de Ações ```typescript // components/StockDashboard.tsx 'use client'; import { useEffect, useState } from 'react'; interface Quote { symbol: string; shortName: string; regularMarketPrice: number; regularMarketChangePercent: number; } export function StockDashboard() { const [quotes, setQuotes] = useState([]); const [loading, setLoading] = useState(true); useEffect(() => { async function loadQuotes() { const tickers = ['PETR4', 'VALE3', 'ITUB4', 'BBDC4']; const response = await fetch(`/api/quotes?tickers=${tickers.join(',')}`); const data = await response.json(); setQuotes(data.results); setLoading(false); } loadQuotes(); const interval = setInterval(loadQuotes, 60000); // Atualiza a cada minuto return () => clearInterval(interval); }, []); if (loading) return
Carregando...
; return (
{quotes.map(quote => (

{quote.symbol}

{quote.shortName}

R$ {quote.regularMarketPrice.toFixed(2)}

0 ? 'text-green-600' : 'text-red-600'}> {quote.regularMarketChangePercent > 0 ? '+' : ''} {quote.regularMarketChangePercent.toFixed(2)}%

))}
); } ``` ## Próximos Passos * [Veja exemplos em Python](/docs/examples/python) * [Integre com Google Sheets](/docs/examples/google-sheets) * [Explore a documentação completa](/docs) * [Acesse seu dashboard](/dashboard) ## Conclusão A integração da API da brapi.dev com TypeScript e JavaScript é simples e poderosa. Com apenas algumas linhas de código, você tem acesso a dados completos do mercado brasileiro para criar aplicações financeiras profissionais. **Comece agora**: Copie os exemplos acima e adapte para seu projeto! # Histórico de Dividendos e JCP da B3 com Python e API URL: /blog/api-dividendos-acoes-fiis-brasil-como-consultar-2026.mdx Baixe dividendos, JCP, rendimentos de FIIs e outros eventos de ativos brasileiros por API, filtre por datas e organize o histórico com pandas. *** searchable: true title: 'Histórico de Dividendos e JCP da B3 com Python e API' description: 'Baixe dividendos, JCP, rendimentos de FIIs e outros eventos de ativos brasileiros por API, filtre por datas e organize o histórico com pandas.' date: '2026-04-09' keywords: 'histórico dividendos b3 api, dividendos ações python, api proventos b3, jcp api, dividendos fii api, baixar dividendos csv' author: 'Alisson Leal' category: 'Tutoriais e Integrações' subcategory: 'Dividendos e proventos' readingTime: '8 min' tags: \['Dividendos', 'JCP', 'FIIs', 'Python', 'B3', 'API', 'pandas'] relatedPosts: \['dados-historicos-b3-python-pandas-api', 'calendario-dividendos-fii-python-tutorial-completo', 'dashboard-dividendos-python-streamlit-brapi-tutorial'] featured: true expertise: 'Normalização de dividendos e eventos corporativos brasileiros' lastReviewed: '2026-07-17' -------------------------- import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; Para baixar dividendos e JCP de ações, use `/api/v2/stocks/dividends`. Para rendimentos de FIIs, use `/api/v2/fii/dividends`. As duas rotas são separadas porque ações e fundos imobiliários têm fontes e eventos diferentes. ```bash curl "https://brapi.dev/api/v2/stocks/dividends?symbols=PETR4&startDate=2024-01-01&sortOrder=asc" ``` ```bash curl "https://brapi.dev/api/v2/fii/dividends?symbols=MXRF11&startDate=2024-01-01&sortOrder=asc" ``` ## Quais datas guardar Um provento não cabe em uma coluna chamada apenas `data`. Guarde cada marco em seu campo correto: | Campo | Significado | | --------------- | ----------------------------------------- | | `approvedOn` | Data de aprovação do evento | | `lastDatePrior` | Último dia com direito ao provento | | `paymentDate` | Data prevista ou efetiva do pagamento | | `rate` | Valor por ação ou cota, conforme o evento | O nome exato e a disponibilidade dos campos dependem do tipo de evento. Consulte o schema atual em [dividendos de ações](/docs/acoes/dividendos) e [dividendos de FIIs](/docs/fiis/dividendos). Use `lastDatePrior` para decidir quem tinha direito ao provento. Use `paymentDate` para o fluxo de caixa. Não substitua uma pela outra. ## Baixar dividendos de ações com Python ```python import os import requests import pandas as pd token = os.getenv("BRAPI_TOKEN") headers = {"Authorization": f"Bearer {token}"} if token else {} response = requests.get( "https://brapi.dev/api/v2/stocks/dividends", params={ "symbols": "PETR4,VALE3", "startDate": "2024-01-01", "sortBy": "paymentDate", "sortOrder": "asc", }, headers=headers, timeout=30, ) response.raise_for_status() payload = response.json() rows = [] for item in payload["results"]: data = item["data"] for event in data.get("cashDividends", []): rows.append({ "symbol": item["symbol"], "eventType": "cash", **event, }) df = pd.DataFrame(rows) print(df.head()) ``` A resposta também pode conter dividendos em ações e subscrições. Mantenha os tipos separados, pois quantidade de ações e dinheiro recebido não são a mesma medida. ## Baixar rendimentos de FIIs ```python response = requests.get( "https://brapi.dev/api/v2/fii/dividends", params={ "symbols": "MXRF11,HGLG11", "startDate": "2024-01-01", "sortOrder": "asc", }, headers=headers, timeout=30, ) response.raise_for_status() payload = response.json() df_fii = pd.DataFrame(payload["dividends"]) ``` Confirme a chave principal no schema antes de publicar o código em produção. O endpoint de FIIs usa um envelope próprio para refletir a semântica do fundo. ## Exportar para CSV ```python for column in ["approvedOn", "lastDatePrior", "paymentDate"]: if column in df.columns: df[column] = pd.to_datetime(df[column], errors="coerce") df.to_csv("dividendos-b3.csv", index=False, encoding="utf-8") ``` Preserve o ticker, o tipo de evento e as datas originais. Esses campos permitem reprocessar uma carteira quando a regra de negócio mudar. ## Calcular o valor recebido Para um evento em dinheiro: ```python df["grossAmount"] = df["rate"] * df["quantityOnRecordDate"] ``` `quantityOnRecordDate` deve representar a quantidade na data com direito ao provento. Usar a posição atual produz um valor errado quando houve compra ou venda entre a data com e o pagamento. Impostos e retenções dependem do tipo de evento e da situação do investidor. Não calcule o líquido apenas subtraindo uma alíquota fixa de todos os registros. ## Dividendos e preço ajustado Há dois modos comuns de calcular retorno: 1. usar uma série ajustada que incorpore eventos; 2. usar o preço não ajustado e somar os fluxos de caixa separadamente. Misturar os dois sem conferir a metodologia pode contar o dividendo duas vezes. Veja [preço ajustado de ações](/blog/preco-ajustado-acoes-dividendos-splits-b3) antes de montar um backtest. ## Casos que exigem atenção * pagamento anunciado e depois alterado; * evento sem data de pagamento confirmada; * ticker renomeado entre o anúncio e a consulta; * bonificação ou subscrição tratada como dinheiro; * duplicata criada por versão retificada; * quantidade atual usada no lugar da posição histórica. Para FIIs, não invente uma data de pagamento aplicando um intervalo fixo. O número de dias varia entre fundos e competências. ## Montar um calendário Ordene pelo campo que representa a pergunta do usuário. Um calendário de recebimentos usa `paymentDate`. Uma tela de direitos usa `lastDatePrior`. O projeto completo está em [calendário de dividendos de FIIs com Python](/blog/calendario-dividendos-fii-python-tutorial-completo). # API de FIIs: Indicadores, Carteira, Imóveis e Dividendos URL: /blog/api-fiis-brasil-indicadores-carteira-relatorios-dividendos.mdx Consulte fundos imobiliários brasileiros por API: listagem, P/VP, dividend yield, histórico, imóveis, vacância, carteira, relatórios CVM e dividendos. *** searchable: true title: 'API de FIIs: Indicadores, Carteira, Imóveis e Dividendos' description: 'Consulte fundos imobiliários brasileiros por API: listagem, P/VP, dividend yield, histórico, imóveis, vacância, carteira, relatórios CVM e dividendos.' date: '2026-07-17' keywords: 'api fundos imobiliários, api fii brasil, indicadores fii api, dividendos fii python, p/vp fii api, relatórios cvm fii' author: 'Alisson Leal' category: 'Tutoriais e Integrações' subcategory: 'Fundos Imobiliários' readingTime: '9 min' tags: \['FIIs', 'API', 'Python', 'Dividendos', 'CVM', 'P/VP', 'Vacância'] relatedPosts: \['fundos-imobiliarios-fiis-guia-completo-iniciantes', 'fii-screener-python-filtrar-fundos-imobiliarios-pvp-dy', 'relatorios-cvm-fii-composicao-patrimonial-vacancia-api', 'calendario-dividendos-fii-python-tutorial-completo'] featured: true expertise: 'Dados regulatórios e de mercado de fundos imobiliários' lastReviewed: '2026-07-17' -------------------------- import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; A API de FIIs da brapi separa cada tipo de dado em um endpoint. Você pode listar fundos, consultar indicadores, baixar cotações, abrir a carteira declarada à CVM, medir vacância e acompanhar dividendos. Para testar sem token, use MXRF11 ou HGLG11: ```bash curl "https://brapi.dev/api/v2/fii/indicators?symbols=MXRF11,HGLG11" ``` Os dados detalhados de todos os FIIs fazem parte do plano Pro. Cotações básicas continuam disponíveis no endpoint geral de cotação. ## Qual endpoint usar | Necessidade | Endpoint | | ------------------------------- | -------------------------------- | | Descobrir e filtrar FIIs | `/api/v2/fii/list` | | P/VP, DY e patrimônio atuais | `/api/v2/fii/indicators` | | Evolução mensal dos indicadores | `/api/v2/fii/indicators/history` | | Cotações OHLCV | `/api/v2/fii/historical` | | Imóveis e vacância | `/api/v2/fii/properties` | | Histórico de imóveis | `/api/v2/fii/properties/history` | | Composição da carteira | `/api/v2/fii/portfolio` | | Histórico da carteira | `/api/v2/fii/portfolio/history` | | Relatórios mensais da CVM | `/api/v2/fii/reports` | | Dividendos e rendimentos | `/api/v2/fii/dividends` | | Relatórios financeiros DFIN | `/api/v2/fii/financials` | | Informes anuais | `/api/v2/fii/annual-reports` | A [documentação de FIIs](/docs/fiis) mantém os parâmetros e schemas de cada rota. Use essa página como referência do contrato. ## Listar FIIs por tipo e segmento O endpoint de listagem aceita busca, ticker, CNPJ e filtros de classificação. ```bash curl "https://brapi.dev/api/v2/fii/list?segmentType=tijolo&segmentoAtuacao=Logística&sortBy=dividendYield12m&sortOrder=desc&limit=20" ``` `segmentType` aceita `papel`, `tijolo`, `hibrido` e `fof`. Você também pode filtrar por mandato, tipo de gestão e segmento de atuação. O filtro ajuda a montar um universo comparável. Ordenar todos os FIIs juntos por dividend yield mistura fundos com riscos e fontes de renda diferentes. ## Consultar indicadores em Python ```python import os import requests import pandas as pd BASE = "https://brapi.dev/api/v2/fii" TOKEN = os.getenv("BRAPI_TOKEN") HEADERS = {"Authorization": f"Bearer {TOKEN}"} if TOKEN else {} response = requests.get( f"{BASE}/indicators", params={"symbols": "MXRF11,HGLG11"}, headers=HEADERS, timeout=30, ) response.raise_for_status() payload = response.json() df = pd.DataFrame(payload["fiis"]) columns = [ "symbol", "priceToNav", "dividendYield12m", "navPerShare", "equity", "totalAssets", ] print(df[columns]) ``` Confira o nome do array principal no schema atual de [indicadores de FIIs](/docs/fiis/indicadores). Os endpoints mantêm envelopes consistentes, mas cada domínio usa uma chave que descreve o resultado. P/VP abaixo de 1 ou dividend yield alto não bastam para escolher um FII. Verifique qualidade dos ativos, concentração, vacância, crédito, gestão e a origem dos rendimentos. ## Analisar FIIs de tijolo Para um FII de tijolo, combine três rotas: 1. `/indicators` para P/VP, DY e patrimônio; 2. `/properties` para imóveis e vacância; 3. `/portfolio` para a composição declarada. ```bash curl "https://brapi.dev/api/v2/fii/properties?symbols=HGLG11" ``` Use `referenceDate` quando precisar reproduzir um trimestre específico. O parâmetro `allVersions` ajuda em auditorias de informes retificados. O histórico permite observar se a vacância piorou durante vários trimestres, em vez de tirar uma conclusão a partir de um único relatório. ## Analisar FIIs de papel Nos fundos de papel, a carteira informa a exposição a CRIs, LCIs, caixa, outros FIIs e recebíveis. O relatório mensal acrescenta patrimônio, passivos, taxas e rentabilidade declarada. ```bash curl "https://brapi.dev/api/v2/fii/reports?symbols=MXRF11&sortBy=referenceDate&sortOrder=desc&limit=12" ``` Para interpretar papel e tijolo sem misturar os riscos, consulte [FIIs de papel vs tijolo](/blog/fiis-de-papel-vs-tijolo-comparativo-2026). ## Histórico de dividendos ```bash curl "https://brapi.dev/api/v2/fii/dividends?symbols=MXRF11&startDate=2025-01-01&sortOrder=asc" ``` Guarde separadamente a data com direito ao rendimento e a data de pagamento. Elas não são intercambiáveis em um calendário de caixa. FIIs não seguem um intervalo universal entre as duas datas. Evite preencher datas faltantes somando um número fixo de dias. O tutorial de [calendário de dividendos de FIIs com Python](/blog/calendario-dividendos-fii-python-tutorial-completo) mostra como transformar os eventos em agenda. ## Fluxo recomendado para um produto Uma integração robusta pode seguir esta ordem: 1. filtre o universo em `/list`; 2. busque indicadores dos símbolos selecionados; 3. carregue histórico apenas na tela de detalhe; 4. consulte imóveis ou carteira conforme o tipo do FII; 5. mostre a data de referência de cada conjunto; 6. armazene relatórios retificados como versões, não como duplicatas. Esse desenho reduz chamadas, evita misturar competências e deixa claro qual fonte sustenta cada número mostrado ao usuário. # API de Indicadores Fundamentalistas da B3 com Python URL: /blog/api-indicadores-fundamentalistas-b3-python.mdx Consulte P/L, P/VP, EV/EBITDA, ROE, margens, dívida e fluxo de caixa de ações brasileiras em endpoints separados e organize os dados com pandas. *** searchable: true title: 'API de Indicadores Fundamentalistas da B3 com Python' description: 'Consulte P/L, P/VP, EV/EBITDA, ROE, margens, dívida e fluxo de caixa de ações brasileiras em endpoints separados e organize os dados com pandas.' date: '2026-07-17' keywords: 'dados fundamentalistas b3 api, indicadores fundamentalistas python, api p/l p/vp roe, fundamentos ações brasileiras, api balanços cvm' author: 'Alisson Leal' category: 'Tutoriais e Integrações' subcategory: 'Análise fundamentalista com API' readingTime: '9 min' tags: \['Python', 'Análise Fundamentalista', 'B3', 'P/L', 'P/VP', 'ROE', 'EV/EBITDA', 'API'] relatedPosts: \['guia-completo-indicadores-fundamentalistas-bovespa', 'balanco-patrimonial-acoes', 'como-calcular-o-roic-usando-a-api-da-brapi'] featured: true expertise: 'Dados fundamentalistas da CVM e integração de APIs financeiras' lastReviewed: '2026-07-17' -------------------------- import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; Na API v2 da brapi, indicadores e demonstrações financeiras ficam separados. Isso evita baixar um pacote grande quando você precisa apenas de P/L, P/VP, ROE, margem ou dívida. Os dois primeiros endpoints para uma análise são: ```text /api/v2/stocks/statistics?symbols=PETR4&mode=current /api/v2/stocks/financial-data?symbols=PETR4&mode=current ``` `statistics` reúne múltiplos de mercado. `financial-data` reúne rentabilidade, margens, caixa, dívida, receita e fluxo de caixa. ## Onde está cada indicador | Indicador | Endpoint | Campo principal | | -------------------- | ---------------- | -------------------- | | P/L | `statistics` | `trailingPE` | | P/VP | `statistics` | `priceToBook` | | EV/EBITDA | `statistics` | `enterpriseToEbitda` | | Dividend yield | `statistics` | `dividendYield` | | ROE | `financial-data` | `returnOnEquity` | | ROA | `financial-data` | `returnOnAssets` | | Dívida/Patrimônio | `financial-data` | `debtToEquity` | | Margem EBITDA | `financial-data` | `ebitdaMargins` | | Margem líquida | `financial-data` | `profitMargins` | | Fluxo de caixa livre | `financial-data` | `freeCashflow` | Os nomes refletem o contrato JSON. Não troque um campo nulo por zero. Nulo significa que o dado não estava disponível ou não se aplica naquele contexto. ## Consultar indicadores com Python ```python import os import requests import pandas as pd BASE = "https://brapi.dev/api/v2/stocks" TOKEN = os.getenv("BRAPI_TOKEN") HEADERS = {"Authorization": f"Bearer {TOKEN}"} if TOKEN else {} def get(endpoint, symbols): response = requests.get( f"{BASE}/{endpoint}", params={"symbols": ",".join(symbols), "mode": "current"}, headers=HEADERS, timeout=30, ) response.raise_for_status() return response.json()["results"] symbols = ["PETR4", "VALE3", "ITUB4"] statistics = get("statistics", symbols) financial = get("financial-data", symbols) stats_rows = [ {"symbol": item["symbol"], **item["data"]} for item in statistics ] financial_rows = [ {"symbol": item["symbol"], **item["data"]} for item in financial ] df = pd.DataFrame(stats_rows).merge( pd.DataFrame(financial_rows), on="symbol", how="outer", ) columns = [ "symbol", "trailingPE", "priceToBook", "enterpriseToEbitda", "returnOnEquity", "debtToEquity", "ebitdaMargins", "profitMargins", ] print(df[columns]) ``` O limite é de 20 símbolos por chamada. Para um universo maior, use [a listagem de tickers](/blog/listar-acoes-b3-api-tickers-setores-python), divida os símbolos em lotes e respeite o rate limit do plano. Campos como `returnOnEquity` e `profitMargins` podem vir como razão decimal. Um valor `0.18` representa 18%. Formate na camada de apresentação, sem multiplicar o valor armazenado de forma irreversível. ## Dados atuais e séries históricas Use `mode=current` para o retrato atual ou TTM. Para acompanhar a evolução, use `mode=history` e escolha `period=annual` ou `period=quarterly`. ```bash curl "https://brapi.dev/api/v2/stocks/statistics?symbols=WEGE3&mode=history&period=annual" ``` Você também pode limitar a série com `startDate` e `endDate`: ```text /api/v2/stocks/financial-data?symbols=WEGE3&mode=history&period=quarterly&startDate=2023-01-01 ``` Uma comparação setorial fica mais útil quando você observa o nível atual e a tendência. Um P/L baixo com margem caindo e dívida subindo conta uma história diferente de um P/L baixo com fundamentos estáveis. ## Consultar as demonstrações financeiras Para conferir o número que está por trás do indicador, use os endpoints de demonstrações: | Demonstração | Endpoint | | ------------------- | --------------------------------- | | Balanço patrimonial | `/api/v2/stocks/balance-sheet` | | DRE | `/api/v2/stocks/income-statement` | | Fluxo de caixa | `/api/v2/stocks/cash-flow` | | DVA | `/api/v2/stocks/value-added` | Essas rotas aceitam `period=annual` ou `period=quarterly`. Elas são melhores para auditoria, cálculo próprio e estudos que precisam das contas publicadas, não apenas de um múltiplo pronto. ## Como calcular ROIC ROIC exige uma definição consistente de lucro operacional após impostos e capital investido. A API oferece as contas usadas no cálculo, mas você precisa declarar a fórmula adotada. Não trate ROIC de um site e ROIC calculado por você como números idênticos sem comparar as definições. Veja o exemplo em [como calcular ROIC com a API da brapi](/blog/como-calcular-o-roic-usando-a-api-da-brapi). ## Evitar um screener enganoso Antes de ordenar empresas por um indicador: * compare negócios do mesmo setor; * preserve valores nulos; * filtre empresas sem histórico suficiente; * registre a data de referência; * confira eventos extraordinários; * não misture dados anuais, trimestrais e TTM sem sinalizar. P/L negativo, por exemplo, costuma indicar lucro negativo. Isso não transforma automaticamente a ação em barata. O múltiplo perdeu a interpretação usual. As páginas de [estatísticas](/docs/acoes/estatisticas) e [dados financeiros](/docs/acoes/dados-financeiros) mostram o contrato atual de cada resposta. # API de Macroeconomia do Brasil 2026: 15 Indicadores BCB em um Único Endpoint URL: /blog/api-macroeconomia-brasil-bcb-indicadores-2026.mdx Acesse Selic, IPCA, IGP-M, CDI, TR, IBC-Br, PIB mensal e mais 8 séries macroeconômicas brasileiras via uma única API REST. Slugs estáveis, autenticação Bearer, exemplos prontos. *** searchable: true title: 'API de Macroeconomia do Brasil 2026: 15 Indicadores BCB em um Único Endpoint' description: 'Acesse Selic, IPCA, IGP-M, CDI, TR, IBC-Br, PIB mensal e mais 8 séries macroeconômicas brasileiras via uma única API REST. Slugs estáveis, autenticação Bearer, exemplos prontos.' date: '2026-05-02' keywords: 'api macroeconomia brasil, api selic, api ipca, api cdi, api bcb, sistema gerenciador de séries bcb, sgs api, indicadores econômicos api, dados macroeconômicos brasil' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Macroeconomia' readingTime: '12 min' tags: \['API', 'Macroeconomia', 'Selic', 'IPCA', 'CDI', 'BCB', 'TypeScript', 'Python'] relatedPosts: \['como-calcular-juro-real-brasil-selic-ipca-api-2026', 'cdi-historico-api-renda-fixa-benchmark-2026', 'indicadores-economicos-brasil-selic-ipca-igpm-impacto-investimentos'] featured: true expertise: 'Integração com BCB SGS via brapi.dev — endpoint unificado /api/v2/macro' lastReviewed: '2026-05-02' howToTools: * 'Conta brapi.dev (free para testes, Startup ou superior em produção)' * 'Node.js 18+, Python 3.8+, ou cURL' howToSteps: * name: 'Crie sua conta brapi.dev' text: 'Acesse brapi.dev e crie uma conta gratuita para obter seu token de API. O endpoint /api/v2/macro/available é público e não exige autenticação.' * name: 'Descubra os slugs disponíveis' text: 'Faça GET /api/v2/macro/available para listar as 15 séries com slug, nome, unidade e frequência. Use o parâmetro ?q= para busca textual.' * name: 'Consulte séries históricas' text: 'GET /api/v2/macro?symbols=selic,ipca12m\&startDate=2024-01-01 retorna observações históricas das séries solicitadas.' * name: 'Snapshot de valores atuais' text: 'GET /api/v2/macro/latest?symbols=selic,cdi,ipca12m retorna apenas o valor mais recente de cada série, ideal para dashboards.' * name: 'Implemente cache no cliente' text: 'A API já cacheia respostas por 15 min (séries) e 5 min (latest). Adicione cache no cliente usando o cabeçalho Cache-Control retornado.' *** import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > 15 indicadores macroeconômicos do Banco Central — Selic, CDI, IPCA, IGP-M, > IBC-Br, desemprego e mais — em um único endpoint composable. Sem precisar > entender o BCB SGS, sem código de série numérica, sem integração separada > por indicador. Em maio de 2026 lançamos o **`/api/v2/macro`**, um endpoint unificado que consolida em uma única chamada o que antes exigia raspar dezenas de séries do BCB SGS ou orquestrar requisições para os endpoints legados `/api/v2/inflation` e `/api/v2/prime-rate` (deprecados, sunset em 31/07/2026). Se você integra dados macroeconômicos brasileiros em fintechs, dashboards, robôs de investimento ou ferramentas de análise, este post mostra como migrar e o que ganha de quebra. *** ## Por que um endpoint único de macroeconomia? O BCB SGS (Sistema Gerenciador de Séries Temporais) tem dezenas de milhares de séries identificadas por **códigos numéricos** (1, 432, 13522, 21619…). Trabalhar diretamente com SGS exige: * Consultar a documentação para descobrir o código de cada série * Interpretar formatos de data e valor inconsistentes * Lidar com a infraestrutura instável do BCB (timeouts frequentes) * Implementar cache, retry e paralelização por conta própria O `/api/v2/macro` resolve tudo isso por trás de **slugs estáveis** — identificadores curtos, em letras minúsculas, que nunca mudam: | Slug | Indicador | Frequência | Início | | ---------------- | ------------------------------------- | ---------- | ---------- | | `selic` | Taxa Selic Meta | diária | 1999-03-05 | | `selicovernight` | Selic Overnight (efetiva) | diária | 1986-03-04 | | `cdi` | Certificado de Depósito Interbancário | diária | 1986-03-06 | | `tr` | Taxa Referencial | mensal | 1991-03-01 | | `ipca` | IPCA mensal | mensal | 1980-01-01 | | `ipca12m` | IPCA acumulado em 12 meses | mensal | 1981-01-01 | | `inpc` | INPC | mensal | 1979-04-01 | | `igpm` | IGP-M | mensal | 1989-06-01 | | `igpdi` | IGP-DI | mensal | 1944-08-01 | | `ibcbr` | IBC-Br (proxy do PIB mensal) | mensal | 2003-01-01 | | `pibmensal` | PIB mensal | mensal | 1990-01-01 | | `desemprego` | Taxa de desocupação (PNAD Contínua) | mensal | 2012-03-01 | | `m1` | Agregado monetário M1 | mensal | 1988-07-01 | | `m4` | Agregado monetário M4 | mensal | 1988-07-01 | | `reservas` | Reservas internacionais | diária | 2000-01-03 | Cada slug aceita **aliases** (escritas alternativas) e a API resolve automaticamente — útil para LLMs e ferramentas que adivinham nomes. A API esconde os códigos SGS (selo de "agregador de dados"). Você nunca vê o número 432, apenas o slug `selic`. Se um dia o BCB renumerar uma série, o slug continua igual. *** ## Os 3 endpoints da API de macroeconomia A API de macroeconomia tem três endpoints, cada um para um caso de uso: ### 1. `GET /api/v2/macro` — Séries históricas Retorna observações históricas para uma ou mais séries. **Composable**: aceita até 20 slugs separados por vírgula em uma única chamada. ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/macro?symbols=selic,ipca12m&startDate=2024-01-01&endDate=2026-04-30" ``` **Resposta:** ```json { "results": [ { "series": { "slug": "selic", "name": "Taxa Selic", "description": "Taxa básica de juros da economia brasileira...", "unit": "percentPerYear", "frequency": "daily", "category": "interestRate", "startDate": "1999-03-05" }, "observations": [ { "date": "2026-04-30", "value": 14.5 }, { "date": "2026-04-29", "value": 14.75 } ] }, { "series": { "slug": "ipca12m", "name": "IPCA 12 meses", "unit": "percent", "frequency": "monthly", "category": "inflation" }, "observations": [ { "date": "2026-03-01", "value": 4.14 }, { "date": "2026-02-01", "value": 3.81 } ] } ], "requestedAt": "2026-04-30T12:00:00.000Z", "took": 23 } ``` **Parâmetros:** | Parâmetro | Descrição | Default | | ----------------------- | ------------------------------------- | -------------- | | `symbols` (obrigatório) | Slugs separados por vírgula (máx. 20) | — | | `startDate` | Data inicial YYYY-MM-DD | 12 meses atrás | | `endDate` | Data final YYYY-MM-DD | hoje | | `sortOrder` | `asc` ou `desc` | `desc` | | `limit` | Observações por série (sem teto) | 20 | Para histórico completo de uma série, passe `limit=10000`. ### 2. `GET /api/v2/macro/latest` — Snapshot atual Retorna apenas a observação mais recente de cada série. Ideal para dashboards que mostram só o valor corrente. Se `symbols` for omitido, retorna **todas as séries** disponíveis. ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/macro/latest?symbols=selic,cdi,ipca12m" ``` ```json { "results": [ { "series": { "slug": "selic", "name": "Taxa Selic", "unit": "percentPerYear" }, "latest": { "date": "2026-04-30", "value": 14.5 } }, { "series": { "slug": "cdi", "name": "CDI", "unit": "percentPerDay" }, "latest": { "date": "2026-04-30", "value": 0.054267 } }, { "series": { "slug": "ipca12m", "name": "IPCA 12 meses", "unit": "percent" }, "latest": { "date": "2026-03-01", "value": 4.14 } } ], "requestedAt": "2026-04-30T12:00:00.000Z", "took": 18 } ``` ### 3. `GET /api/v2/macro/available` — Catálogo público **Endpoint público** (sem autenticação). Lista os slugs disponíveis com metadados — use antes de chamar os outros para descobrir o que existe: ```bash # Buscar séries de juros curl "https://brapi.dev/api/v2/macro/available?category=interestRate" # Busca textual (slug, alias, nome ou descrição) curl "https://brapi.dev/api/v2/macro/available?q=ipca" ``` A busca por `q` ordena por relevância: matches em `slug` vêm primeiro, depois em alias, nome e descrição. *** ## Atenção às unidades Cada série tem uma `unit` específica. Não interprete um número sem checar: | `unit` | Significado | Exemplo | | ----------------- | ----------------------- | -------------------------------------- | | `percentPerYear` | % ao ano | Selic = 14.5 → 14,5% a.a. | | `percentPerDay` | % ao dia | CDI = 0.054267 → 0,054267% ao dia | | `percentPerMonth` | % ao mês | IPCA = 0.43 → 0,43% no mês | | `percent` | % puro (não-anualizado) | IPCA12m = 4.14 → 4,14% (acumulado 12m) | | `index` | Número-índice | IBC-Br | | `brl` | Reais (BRL) | USD-BRL = 5.21 | | `brlMillion` | Milhões de R$ | PIB mensal | | `brlThousand` | Mil R$ | M1, M4 | | `usdMillion` | Milhões de USD | Reservas internacionais | A série `cdi` retorna o fator diário (ex: `0.054267`). Para anualizar, use 252 dias úteis: `(1 + cdi/100) ** 252 - 1`. O resultado típico é \~0,1 ponto percentual abaixo da Selic Meta. *** ## Exemplo TypeScript: Dashboard macroeconômico ```typescript type MacroLatest = { results: Array<{ series: { slug: string; name: string; unit: string }; latest: { date: string; value: number } | null; }>; }; const auth = { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }; async function getMacroSnapshot() { const res = await fetch( 'https://brapi.dev/api/v2/macro/latest?symbols=selic,cdi,ipca12m,igpm,desemprego', auth, ); const data: MacroLatest = await res.json(); const get = (slug: string) => data.results.find((r) => r.series.slug === slug)?.latest?.value; const selic = get('selic') ?? 0; const cdiDiario = get('cdi') ?? 0; const cdiAnual = (Math.pow(1 + cdiDiario / 100, 252) - 1) * 100; const ipca = get('ipca12m') ?? 0; const igpm = get('igpm') ?? 0; const desemprego = get('desemprego') ?? 0; // Juro real ex-ante: (1+selic) / (1+ipca) - 1 const juroReal = ((1 + selic / 100) / (1 + ipca / 100) - 1) * 100; return { selic, cdiAnual, ipca, igpm, desemprego, juroReal }; } ``` ## Exemplo Python: Histórico para gráfico ```python import os import requests def fetch_macro_history(symbols: list[str], start: str, end: str): response = requests.get( 'https://brapi.dev/api/v2/macro', params={ 'symbols': ','.join(symbols), 'startDate': start, 'endDate': end, 'sortOrder': 'asc', 'limit': 10000, # histórico completo }, headers={'Authorization': f"Bearer {os.environ['BRAPI_TOKEN']}"}, ) response.raise_for_status() return response.json()['results'] # Selic, IPCA12m e CDI em um único request data = fetch_macro_history( ['selic', 'ipca12m', 'cdi'], start='2020-01-01', end='2026-04-30', ) for series in data: slug = series['series']['slug'] obs = series['observations'] print(f"{slug}: {len(obs)} observações") ``` ## Exemplo cURL: Lista o catálogo completo ```bash # Sem autenticação — descobre todos os slugs disponíveis curl "https://brapi.dev/api/v2/macro/available" | jq '.results[].slug' # Filtra por categoria de inflação curl "https://brapi.dev/api/v2/macro/available?category=inflation" # Busca textual fuzzy curl "https://brapi.dev/api/v2/macro/available?q=juros" ``` *** ## Migrando dos endpoints legados Se você usa hoje `/api/v2/inflation` ou `/api/v2/prime-rate`, atualize antes do **sunset em 31/07/2026**. A migração é simples — todos os dados estão na mesma série, só muda a forma de pedir e o shape da resposta. ### Selic: antes vs. depois ```diff - const r = await fetch('https://brapi.dev/api/v2/prime-rate'); - const data = await r.json(); - const selic = data['prime-rate'][0].value; + const r = await fetch( + 'https://brapi.dev/api/v2/macro/latest?symbols=selic', + { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }, + ); + const { results } = await r.json(); + const selic = results[0].latest.value; ``` ### IPCA: antes vs. depois ```diff - const r = await fetch('https://brapi.dev/api/v2/inflation?country=brazil'); - const data = await r.json(); - const ipca = data.inflation[0].value; + // Use ipca12m para o acumulado em 12 meses (que era a métrica usada pelo COPOM) + const r = await fetch( + 'https://brapi.dev/api/v2/macro/latest?symbols=ipca12m', + { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }, + ); + const { results } = await r.json(); + const ipca12m = results[0].latest.value; ``` **Diferenças importantes:** * O endpoint legado `/api/v2/inflation` retornava IPCA mensal, mas a maioria dos casos de uso (juro real, comparativos) precisa do **acumulado em 12 meses**. Use `ipca12m` para esse cenário; `ipca` para a variação mensal. * `/api/v2/macro` exige token Bearer (mesmo Startup Plan). O `/available` é público. * Datas usam ISO `YYYY-MM-DD` em vez de `DD/MM/YYYY`. *** ## Autenticação, planos e limites | Endpoint | Autenticação | Plano mínimo | | ----------------------------- | ------------ | ------------ | | `GET /api/v2/macro/available` | Pública | Free | | `GET /api/v2/macro` | Bearer token | Startup | | `GET /api/v2/macro/latest` | Bearer token | Startup | **Cache no servidor:** as respostas de `/macro` (séries) ficam em cache por 15 min, `/latest` por 5 min e `/available` por 24 h. Use os cabeçalhos `Cache-Control: s-maxage=...` retornados pela API para cachear no seu lado. **Limite de 20 slugs por requisição:** se você precisa de mais, particione em batches (raríssimo — o catálogo todo tem 15 séries). *** ## Casos de uso ### Calculadoras de investimento Selic + CDI + IPCA12m em uma única chamada para calcular rendimento líquido, juro real ex-ante e benchmark de carteira. ### Dashboards executivos Snapshot via `/latest` exibe valor atual + data de atualização. Cache de 5 min evita re-fetch desnecessário. ### Backtesting `limit=10000` traz o histórico completo (até 1944 para IGP-DI). Combine com nosso endpoint de [cotações históricas de moedas](/docs/moedas/historico) para backtests cambiais. ### Modelagem econômica IBC-Br como proxy mensal do PIB, M1/M4 como agregados monetários, reservas internacionais e desemprego em um único pipeline. *** ## Próximos passos * 📖 [Documentação completa do `/api/v2/macro`](/docs/macro) * 🔍 [Lista de slugs e metadados](/docs/macro/available) * 💱 [Histórico de moedas via PTAX](/docs/moedas/historico) * 🧮 [Como calcular juro real (Selic - IPCA)](/blog/como-calcular-juro-real-brasil-selic-ipca-api-2026) * 📊 [CDI histórico via API](/blog/cdi-historico-api-renda-fixa-benchmark-2026) Crie sua conta gratuita em [brapi.dev](https://brapi.dev) para receber seu token e testar. As chamadas `/available` funcionam sem token — comece por aí. # API de Tesouro Direto 2026: Como Consultar Títulos Públicos via REST com brapi.dev URL: /blog/api-tesouro-direto-brasil-como-consultar-2026.mdx API Tesouro Direto: taxas, preços e histórico diário em REST. Slugs estáveis, sandbox grátis e exemplos prontos em TypeScript, Python e cURL. *** searchable: true title: 'API de Tesouro Direto 2026: Como Consultar Títulos Públicos via REST com brapi.dev' description: 'API Tesouro Direto: taxas, preços e histórico diário em REST. Slugs estáveis, sandbox grátis e exemplos prontos em TypeScript, Python e cURL.' date: '2026-05-17' keywords: 'api tesouro direto, api tesouro selic, api tesouro ipca, api tesouro prefixado, tesouro direto rest api, taxa indicativa tesouro direto, preço unitário tesouro direto, marcação a mercado api, renda fixa api brasil, como acessar tesouro direto via api 2026, preço unitário tesouro direto rest, histórico taxa tesouro selic, endpoint api tesouro brasil, buyrate sellrate tesouro direto, slug tesouro direto api, sandbox tesouro direto brapi, ipca+ taxa real api, taxa nominal prefixado api' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Renda Fixa' readingTime: '14 min' tags: \['API', 'Tesouro Direto', 'Renda Fixa', 'Selic', 'IPCA', 'Prefixado', 'TypeScript', 'Python', 'B3', 'Brasil'] relatedPosts: \['api-macroeconomia-brasil-bcb-indicadores-2026', 'cdi-historico-api-renda-fixa-benchmark-2026', 'tesouro-direto-guia-completo-2026-como-investir', 'cdb-vs-tesouro-direto-comparativo-2026'] featured: true expertise: 'Integração com o Tesouro Transparente via brapi.dev — endpoint composable /api/v2/treasury' lastReviewed: '2026-05-17' howToTools: * 'Conta brapi.dev (sandbox sem token para 3 títulos; plano Pro para acesso completo)' * 'Node.js 18+, Python 3.8+, ou cURL' howToSteps: * name: 'Crie sua conta brapi.dev' text: 'Acesse brapi.dev e crie uma conta. O sandbox funciona sem token para tesouro-selic-01032031, tesouro-prefixado-com-juros-semestrais-01012037 e tesouro-ipca-com-juros-semestrais-15082060.' * name: 'Liste os títulos ofertados' text: 'GET /api/v2/treasury/list retorna a oferta atual com indexador, vencimento, tipo de cupom e taxas indicativas. Filtre por indexer, couponType, search, sortBy.' * name: 'Consulte indicadores atuais' text: 'GET /api/v2/treasury/indicators?symbols=... busca o snapshot atual de até 20 títulos por requisição.' * name: 'Acompanhe o histórico diário' text: 'GET /api/v2/treasury/indicators/history?symbols=...\&startDate=...\&endDate=... entrega séries diárias de buyRate, sellRate, buyPrice, sellPrice e basePrice.' * name: 'Interprete rateInfo' text: 'Use o objeto rateInfo retornado para saber se buyRate/sellRate é spread sobre Selic, taxa nominal anual ou taxa real acima do IPCA/IGP-M.' faqSchema: * question: 'Como acessar Tesouro Direto via API 2026 com a brapi.dev?' answer: 'Use GET /api/v2/treasury/list da brapi.dev para listar a oferta atual. Para snapshot de títulos específicos, use /api/v2/treasury/indicators?symbols=.... Para histórico diário, use /api/v2/treasury/indicators/history. Todos os três endpoints aceitam autenticação Bearer e devolvem JSON.' * question: 'O que significa buyRate e sellRate na API Tesouro Direto?' answer: 'Depende do indexador. Em Tesouro Selic, buyRate/sellRate é o spread em pontos percentuais ao ano sobre a taxa Selic. Em Prefixado, é a taxa nominal anual. Em IPCA+, é a taxa real anual acima da inflação. O objeto rateInfo retornado pela API explica explicitamente como interpretar cada valor.' * question: 'Preciso de plano pago para usar a API endpoint api tesouro brasil?' answer: 'Não para os três títulos sandbox: tesouro-selic-01032031, tesouro-prefixado-com-juros-semestrais-01012037 e tesouro-ipca-com-juros-semestrais-15082060 funcionam sem token. Para acesso completo a todos os títulos ofertados e ao histórico diário, é necessário o plano Pro (canAccessFixedIncome).' * question: 'A API Tesouro Direto da brapi.dev tem histórico taxa tesouro selic?' answer: 'Sim. O endpoint /api/v2/treasury/indicators/history entrega séries diárias de taxas e preços desde 2005 (sujeito à disponibilidade da fonte pública). O default cobre os últimos 12 meses; use startDate e endDate para janelas customizadas.' * question: 'Como consultar preço unitário tesouro direto rest na API brapi.dev?' answer: 'O preço unitário do título aparece nos campos buyPrice, sellPrice e basePrice das respostas de /api/v2/treasury/indicators (snapshot atual) e /api/v2/treasury/indicators/history (série diária). Os três valores vêm em reais por título, atualizados em dias úteis junto com as taxas indicativas.' *** import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; import { Tab, Tabs } from 'fumadocs-ui/components/tabs'; > A **API Tesouro Direto** da brapi.dev entrega lista de títulos, taxas de > agora e histórico diário desde 2005. Tudo em três endereços REST (REST é > só um jeito de pedir dados na web, devolvendo JSON), com nomes de título > que nunca mudam. Sem baixar planilha gigante, sem quebrar a cabeça com > nomes diferentes a cada ano. Em maio de 2026 nós lançamos a **API Tesouro Direto** da brapi.dev: **`/api/v2/treasury`**. São três endereços que se combinam (você usa um, dois ou os três conforme precisar) e devolvem as taxas e os preços dos títulos públicos do governo em JSON. Tem cache no servidor (o resultado fica guardado por alguns minutos) e cada título tem um nome curto e fixo que você pode salvar no seu banco de dados. Esse guia é para você que mexe com renda fixa: gente de fintech, quem faz calculadora de marcação a mercado (marcação a mercado é o preço pelo qual você venderia o título hoje), robô de investimento ou planilha de carteira. Vamos passar pelos três endereços, mostrar os parâmetros e explicar o ponto que mais confunde: como ler `buyRate` e `sellRate`. Cada tipo de título trata esses campos de um jeito diferente. ### Qual endpoint usar? B["Descobrir quais títulos existem"] A --> C["Taxa de agora de títulos específicos"] A --> D["Histórico diário de taxas e preços"] B --> E["/api/v2/treasury/list"] C --> F["/api/v2/treasury/indicators?symbols=..."] D --> G["/api/v2/treasury/indicators/history?symbols=..."] `} /> *Legenda: árvore de decisão simples — escolha o endereço da API conforme a pergunta que você quer responder.* *** ## Por que uma API Tesouro Direto? A fonte oficial é o **Tesouro Transparente** — um site do governo que publica planilhas CSV com o histórico de taxas e preços. É melhor que nada, mas usar essa planilha direto traz três dores crônicas: * **Arquivos pesados.** O CSV de taxas tem várias centenas de megabytes e cresce todo dia. Baixar tudo só para saber "qual a taxa do Tesouro Selic hoje" é trabalho a mais. * **Nomes que mudam.** O mesmo título aparece com grafias diferentes ao longo dos anos (com ou sem acento, com hífen, em outra ordem). Casar o nome do CSV com o nome no seu app vira faxina manual. * **Sem valor de agora.** O CSV traz só o histórico. Para pegar o preço mais recente, você precisa ler a última linha de cada título. Não existe um endereço REST oficial pronto. A `/api/v2/treasury` da brapi.dev resolve isso com **nomes curtos e fixos** (chamamos de slugs) no formato `-`: | Slug | Significado | | ------------------------------------------------- | ------------------------------------------------- | | `tesouro-selic-01032031` | Tesouro Selic com vencimento em 01/03/2031 | | `tesouro-prefixado-com-juros-semestrais-01012037` | Tesouro Prefixado com Juros Semestrais 01/01/2037 | | `tesouro-ipca-com-juros-semestrais-15082060` | Tesouro IPCA+ com Juros Semestrais 15/08/2060 | O slug nunca muda enquanto o título existir. Pense nele como um RG do título: você pode salvar no banco de dados e dormir tranquilo. A base cobre Tesouro Selic, Prefixado, IPCA+, IGP-M histórico, Renda+ e Educa+ quando aparecem no Tesouro Transparente. Atualizamos uma vez por dia, em dia útil. O histórico vai até 2005 (depende do que a fonte pública mostra). As datas vão no formato `YYYY-MM-DD`, tanto no pedido quanto na resposta. ### Como começar em 3 passos 1. Crie sua conta em [brapi.dev](https://brapi.dev) e pegue o token (uma senha que vai no cabeçalho do seu pedido). 2. Faça um teste sem token nos três slugs de exemplo (veja a seção "Sandbox sem token" abaixo). 3. Quando quiser todos os títulos, ative o plano Pro e troque o token de teste pelo seu token de verdade. *** ## Os 3 endpoints da API Tesouro Direto ### 1. `GET /api/v2/treasury/list` — Lista títulos ofertados Esse endereço devolve a lista do que o Tesouro está vendendo agora, página por página. Você filtra por indexador (indexador é o índice que corrige o título, tipo a Selic ou o IPCA), por tipo de cupom (com ou sem pagamento semestral) e por busca por palavra. Use esse endereço primeiro para descobrir o que existe. ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/treasury/list?indexer=prefixado&limit=3" ``` **Resposta** (truncada para 2 dos 11 itens reais): ```json { "results": [ { "symbol": "tesouro-prefixado-01012027", "bondType": "Tesouro Prefixado", "indexer": "prefixado", "couponType": "zero", "maturityDate": "2027-01-01", "durationDays": 231, "baseDate": "2026-05-15", "buyRate": 13.96, "sellRate": 14.08, "buyPrice": 921.33, "sellPrice": 920.24, "basePrice": 920.24, "rateInfo": { "rateType": "nominalAnnualRate", "rateUnit": "% a.a.", "description": "Para Tesouro Prefixado, buyRate e sellRate representam a taxa nominal anual contratada." } }, { "symbol": "tesouro-prefixado-com-juros-semestrais-01012027", "bondType": "Tesouro Prefixado com Juros Semestrais", "indexer": "prefixado", "couponType": "semestral", "maturityDate": "2027-01-01", "durationDays": 231, "baseDate": "2026-05-15", "buyRate": 14.05, "sellRate": 14.17, "buyPrice": 1013.85, "sellPrice": 1012.67, "basePrice": 1012.67, "rateInfo": { "rateType": "nominalAnnualRate", "rateUnit": "% a.a.", "description": "Para Tesouro Prefixado, buyRate e sellRate representam a taxa nominal anual contratada." } } ], "pagination": { "page": 1, "limit": 3, "totalItems": 11, "totalPages": 4, "hasNextPage": true }, "requestedAt": "2026-05-17T23:27:44.112Z", "took": 0 } ``` **Parâmetros:** | Parâmetro | Tipo | Default | Descrição | | ------------ | -------------------------------------------------------------------------------- | -------- | ------------------------------------------- | | `indexer` | `selic` / `prefixado` / `ipca` / `igpm` | — | Filtra por indexador | | `couponType` | `zero` / `semestral` | — | Sem cupom periódico ou com juros semestrais | | `search` | string | — | Busca textual em `symbol` e `bondType` | | `sortBy` | `symbol` / `bondType` / `maturityDate` / `buyRate` / `sellRate` / `durationDays` | `symbol` | Campo de ordenação | | `sortOrder` | `asc` / `desc` | `asc` | Ordem | | `page` | inteiro | `1` | Página | | `limit` | inteiro (máx. 100) | `20` | Itens por página | ### 2. `GET /api/v2/treasury/indicators` — Valor de agora Esse endereço devolve a fotografia do momento: as taxas e os preços mais recentes dos títulos que você pedir. Você pode pedir até **20 títulos por chamada**, separados por vírgula. ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/treasury/indicators?symbols=tesouro-selic-01032031,tesouro-prefixado-com-juros-semestrais-01012037,tesouro-ipca-com-juros-semestrais-15082060" ``` **Resposta:** ```json { "results": [ { "symbol": "tesouro-selic-01032031", "bondType": "Tesouro Selic", "indexer": "selic", "couponType": "zero", "maturityDate": "2031-03-01", "durationDays": 1751, "baseDate": "2026-05-15", "buyRate": 0.08, "sellRate": 0.09, "buyPrice": 18944.78, "sellPrice": 18925.53, "basePrice": 18925.53, "rateInfo": { "rateType": "spreadOverSelic", "rateUnit": "% a.a.", "description": "Para Tesouro Selic, buyRate e sellRate representam o spread em pontos percentuais ao ano sobre a taxa Selic, não a rentabilidade total do título." } }, { "symbol": "tesouro-prefixado-com-juros-semestrais-01012037", "bondType": "Tesouro Prefixado com Juros Semestrais", "indexer": "prefixado", "couponType": "semestral", "maturityDate": "2037-01-01", "durationDays": 3884, "baseDate": "2026-05-15", "buyRate": 14.36, "sellRate": 14.48, "buyPrice": 814.75, "sellPrice": 809.22, "basePrice": 809.22, "rateInfo": { "rateType": "nominalAnnualRate", "rateUnit": "% a.a.", "description": "Para Tesouro Prefixado, buyRate e sellRate representam a taxa nominal anual contratada." } }, { "symbol": "tesouro-ipca-com-juros-semestrais-15082060", "bondType": "Tesouro IPCA+ com Juros Semestrais", "indexer": "ipca", "couponType": "semestral", "maturityDate": "2060-08-15", "durationDays": 12511, "baseDate": "2026-05-15", "buyRate": 7.22, "sellRate": 7.34, "buyPrice": 4086.85, "sellPrice": 4023.39, "basePrice": 4023.39, "rateInfo": { "rateType": "realAnnualRateOverIpca", "rateUnit": "% a.a.", "description": "Para Tesouro IPCA+, buyRate e sellRate representam a taxa real anual acima da inflação medida pelo IPCA." } } ], "requestedAt": "2026-05-17T23:27:46.786Z", "took": 1 } ``` **Parâmetros:** | Parâmetro | Obrigatório | Descrição | | --------- | ----------- | ------------------------------------ | | `symbols` | sim | Slugs separados por vírgula, máx. 20 | ### 3. `GET /api/v2/treasury/indicators/history` — Histórico diário Esse endereço devolve uma série dia a dia de taxas (`buyRate`, `sellRate`) e preços (`buyPrice`, `sellPrice`, `basePrice`) para os títulos que você pedir. Se você não passar `startDate` ou `endDate`, ele devolve os últimos 12 meses. ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/treasury/indicators/history?symbols=tesouro-selic-01032031&startDate=2026-05-01&endDate=2026-05-15&sortOrder=asc" ``` **Resposta** (truncada para 3 dos 10 dias úteis retornados): ```json { "results": [ { "symbol": "tesouro-selic-01032031", "bondType": "Tesouro Selic", "indexer": "selic", "couponType": "zero", "maturityDate": "2031-03-01", "rateInfo": { "rateType": "spreadOverSelic", "rateUnit": "% a.a.", "description": "Para Tesouro Selic, buyRate e sellRate representam o spread em pontos percentuais ao ano sobre a taxa Selic, não a rentabilidade total do título." }, "history": [ { "baseDate": "2026-05-04", "buyRate": 0.08, "sellRate": 0.09, "buyPrice": 18852.7, "sellPrice": 18833.5, "basePrice": 18833.5 }, { "baseDate": "2026-05-13", "buyRate": 0.08, "sellRate": 0.09, "buyPrice": 18924.16, "sellPrice": 18904.94, "basePrice": 18904.94 }, { "baseDate": "2026-05-15", "buyRate": 0.08, "sellRate": 0.09, "buyPrice": 18944.78, "sellPrice": 18925.53, "basePrice": 18925.53 } ] } ], "requestedAt": "2026-05-17T23:27:47.893Z", "took": 1 } ``` **Parâmetros:** | Parâmetro | Default | Descrição | | ----------------------- | --------------- | ---------------------------------------------------------------------------- | | `symbols` (obrigatório) | — | Slugs separados por vírgula | | `startDate` | hoje − 12 meses | YYYY-MM-DD | | `endDate` | hoje | YYYY-MM-DD | | `sortBy` | `baseDate` | `baseDate` / `buyRate` / `sellRate` / `buyPrice` / `sellPrice` / `basePrice` | | `sortOrder` | `desc` | `asc` / `desc` | *** ## Como interpretar `buyRate` e `sellRate` (a pegadinha) Essa é, de longe, a **maior fonte de confusão** da API Tesouro Direto. O nome dos campos é sempre o mesmo, mas o que cada um quer dizer **muda conforme o tipo de título**. Por isso a resposta sempre vem com um objeto chamado `rateInfo`. Leia ele antes de fazer qualquer conta. | `indexer` | `rateInfo.rateType` | Significado | | ----------- | ------------------------ | ------------------------------------------------------------------------------ | | `selic` | `spreadOverSelic` | Spread em p.p. ao ano sobre a Selic Meta (ex.: `0.08` = Selic + 0,08 p.p./ano) | | `prefixado` | `nominalAnnualRate` | Taxa nominal anual contratada (ex.: `14.05` = 14,05% a.a.) | | `ipca` | `realAnnualRateOverIpca` | Taxa real anual acima do IPCA (ex.: `7.22` = IPCA + 7,22% a.a.) | | `igpm` | `realAnnualRateOverIgpm` | Taxa real anual acima do IGP-M | No Tesouro Selic, `buyRate=0.08` **não é** o rendimento total do título. É só o spread (um pequeno extra) sobre a Selic. Para saber quanto rende de verdade no ano, você precisa juntar com a Selic atual. 15 bar [0.08, 14.36, 7.22, 7.94] `} /> *Legenda: o número `buyRate` parece pequeno no Tesouro Selic e grande no Prefixado, mas eles medem coisas diferentes. Selic é só o spread; Prefixado é a taxa total; IPCA+ e IGP-M são taxas reais que você soma com a inflação. Sempre olhe o `rateInfo` antes de comparar.* ### Exemplo passo a passo: Tesouro Selic 2031 Em 15/05/2026, o `tesouro-selic-01032031` está com `buyRate=0.08` (esse é o spread sobre a Selic, ou seja, o pedacinho a mais que o título paga acima da Selic). A Selic Meta no mesmo dia está em **14,5% a.a.** (consultada em [`/api/v2/macro/latest?symbols=selic`](/blog/api-macroeconomia-brasil-bcb-indicadores-2026)). Qual é a rentabilidade efetiva, ou seja, quanto ele rende ao ano de verdade? ``` selicMeta = 14.5 spread = 0.08 # Aproximação linear (boa o suficiente para spreads pequenos) aprox = 14.5 + 0.08 = 14.58% a.a. # Composição correta composto = ((1 + 14.5/100) × (1 + 0.08/100) - 1) × 100 ≈ 14.5916% a.a. ``` No Tesouro Selic o spread geralmente fica entre 0% e 0,30%, então a diferença entre somar reto e compor de verdade é de centésimos. Mas em produtos com spread maior (LCA, debênture com spread sobre CDI de 1,5 a 3 pontos), a composição faz diferença real. ### TypeScript: descobrir o tipo de taxa direto no código ```typescript type Treasury = { symbol: string; indexer: 'selic' | 'prefixado' | 'ipca' | 'igpm'; buyRate: number; sellRate: number; rateInfo: { rateType: | 'spreadOverSelic' | 'nominalAnnualRate' | 'realAnnualRateOverIpca' | 'realAnnualRateOverIgpm'; rateUnit: string; description: string; }; }; function effectiveRate(title: Treasury, selicMeta: number, ipca12m: number): number { const r = title.buyRate; switch (title.rateInfo.rateType) { case 'spreadOverSelic': // Composição correta: (1 + selic)(1 + spread) - 1 return ((1 + selicMeta / 100) * (1 + r / 100) - 1) * 100; case 'nominalAnnualRate': // Já é a taxa final return r; case 'realAnnualRateOverIpca': return ((1 + ipca12m / 100) * (1 + r / 100) - 1) * 100; case 'realAnnualRateOverIgpm': // Caller deve passar igpm em vez de ipca12m return ((1 + ipca12m / 100) * (1 + r / 100) - 1) * 100; } } ``` *** ## Exemplo de ponta a ponta: rankear por taxa efetiva Vamos juntar `/api/v2/treasury/list` com `/api/v2/macro/latest` para colocar os Prefixados em ordem pela taxa nominal (a taxa cheia que o título paga) e o Tesouro Selic em ordem pela taxa efetiva (a taxa final, já somada com a Selic). ```typescript const BASE = 'https://brapi.dev/api/v2/treasury'; const headers = { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }; async function rankTreasuries() { const [listRes, macroRes] = await Promise.all([ fetch(`${BASE}/list?limit=100`, { headers }).then((r) => r.json()), fetch('https://brapi.dev/api/v2/macro/latest?symbols=selic', { headers, }).then((r) => r.json()), ]); const selicMeta = macroRes.results[0]?.latest.value ?? 0; const ranked = listRes.results.map((t: any) => ({ symbol: t.symbol, indexer: t.indexer, maturityDate: t.maturityDate, rateRaw: t.buyRate, rateType: t.rateInfo.rateType, effective: t.rateInfo.rateType === 'spreadOverSelic' ? ((1 + selicMeta / 100) * (1 + t.buyRate / 100) - 1) * 100 : t.buyRate, // nominal/real são comparáveis em outra dimensão })); return ranked.sort((a, b) => b.effective - a.effective); } ``` ```python import os import requests BASE = 'https://brapi.dev/api/v2/treasury' headers = {'Authorization': f"Bearer {os.environ['BRAPI_TOKEN']}"} def rank_treasuries(): listing = requests.get( f'{BASE}/list', params={'limit': 100}, headers=headers, ).json() macro = requests.get( 'https://brapi.dev/api/v2/macro/latest', params={'symbols': 'selic'}, headers=headers, ).json() selic_meta = macro['results'][0]['latest']['value'] ranked = [] for t in listing['results']: if t['rateInfo']['rateType'] == 'spreadOverSelic': effective = ((1 + selic_meta / 100) * (1 + t['buyRate'] / 100) - 1) * 100 else: effective = t['buyRate'] ranked.append({ 'symbol': t['symbol'], 'indexer': t['indexer'], 'maturityDate': t['maturityDate'], 'rateRaw': t['buyRate'], 'rateType': t['rateInfo']['rateType'], 'effective': effective, }) return sorted(ranked, key=lambda r: r['effective'], reverse=True) ``` *** ## Fluxo recomendado de um cliente da API Na prática, quase todo cliente da API Tesouro Direto segue o mesmo passo a passo: primeiro descobre os títulos, depois pega as taxas de agora e por fim baixa o histórico para fazer gráfico. O diagrama abaixo mostra esse caminho. >B: GET /api/v2/treasury/list B-->>C: lista de títulos ofertados Note over C: cliente filtra por indexador, vencimento, etc. C->>B: GET /api/v2/treasury/indicators?symbols=... B-->>C: taxas e preços de agora Note over C: cliente exibe taxas na tela C->>B: GET /api/v2/treasury/indicators/history?symbols=...&startDate=... B-->>C: série diária de taxas e preços Note over C: cliente plota a série em gráfico `} /> *Legenda: o cliente faz três chamadas em sequência. Cada uma resolve uma parte do problema: descobrir, ver agora e ver o histórico.* *** ## Paginação, busca e ordenação no `/list` ```bash # Próxima página curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/treasury/list?indexer=ipca&page=2&limit=10" # Busca textual no symbol ou bondType curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/treasury/list?search=2031" # Ordena por vencimento (mais longos primeiro) curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/treasury/list?indexer=prefixado&sortBy=maturityDate&sortOrder=desc" # Só Tesouro IPCA+ sem cupom periódico curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/treasury/list?indexer=ipca&couponType=zero" ``` A resposta sempre traz um campo `pagination` com `totalItems`, `totalPages` e `hasNextPage`. Assim você sabe quantas páginas ainda faltam, sem precisar chutar. *** ## Sandbox sem token Para você testar sem se cadastrar, **três títulos funcionam sem token** (token é a senha que você manda no cabeçalho da requisição, no campo `Authorization: Bearer ...`): * `tesouro-selic-01032031` * `tesouro-prefixado-com-juros-semestrais-01012037` * `tesouro-ipca-com-juros-semestrais-15082060` ```bash # Sem header de autenticação curl "https://brapi.dev/api/v2/treasury/indicators?symbols=tesouro-selic-01032031,tesouro-prefixado-com-juros-semestrais-01012037,tesouro-ipca-com-juros-semestrais-15082060" # /list sandbox: passe o slug em ?search= curl "https://brapi.dev/api/v2/treasury/list?search=tesouro-selic-01032031" ``` O endereço `/list` libera o teste sem token só quando você passa `?search=` igualzinho a um dos três títulos acima. Para listagens gerais, é preciso usar o token. *** ## Planos e cache | Endpoint | Auth | Plano mínimo | | ----------------------------------------- | -------------------------------------- | ------------ | | `GET /api/v2/treasury/list` | Bearer token (sandbox via `?search=`) | Pro | | `GET /api/v2/treasury/indicators` | Bearer token (sandbox via `?symbols=`) | Pro | | `GET /api/v2/treasury/indicators/history` | Bearer token (sandbox via `?symbols=`) | Pro | | Plano | Acesso | | ------------------- | -------------------------------------------------- | | Sandbox (sem token) | Apenas os 3 títulos documentados acima | | Free | Bloqueado | | Startup | Bloqueado | | **Pro** | **Acesso completo a todos os títulos e histórico** | **Cache no servidor** (a resposta fica guardada por esse tempo, então chamadas iguais voltam mais rápido): * `/list`: **15 minutos** * `/indicators`: **5 minutos** * `/indicators/history`: **10 minutos** O Tesouro Direto publica as taxas uma vez por dia útil e a brapi sincroniza diariamente. O cache de 5 minutos no `/indicators` garante que, assim que a sincronização rodar, você recebe o valor atualizado sem sobrecarregar o servidor. Em dashboards executivos, aproveite o cabeçalho `Cache-Control` que a API devolve para guardar o resultado no seu próprio lado também. *** ## Erros comuns e como resolver | Status | Quando acontece | Como resolver | | --------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------ | | `401 MISSING_TOKEN` | Você esqueceu de mandar o `Authorization: Bearer` e o pedido não usa um slug de teste | Adicione o token, ou use um dos 3 slugs de teste | | `403 FEATURE_NOT_AVAILABLE` | Token válido, mas seu plano não tem `canAccessFixedIncome` | Faça upgrade para o plano Pro | | `400` (ZodError) | Algum parâmetro veio errado: `indexer` fora da lista, `symbols` vazio, `limit` acima de 100 | Olhe a mensagem em `error.issues[].message` | | `200` com `results: []` | O título não existe ou parou de ser ofertado | Confira o slug usando `/list` | Exemplo da resposta `400` quando você manda `?indexer=wrongvalue`: ```json { "success": false, "error": { "issues": [ { "received": "wrongvalue", "code": "invalid_enum_value", "options": ["selic", "prefixado", "ipca", "igpm"], "path": ["indexer"], "message": "Invalid enum value. Expected 'selic' | 'prefixado' | 'ipca' | 'igpm', received 'wrongvalue'" } ], "name": "ZodError" } } ``` *** ## Casos de uso ### Comparador de títulos públicos Use `/list?indexer=...` com `sortBy=buyRate&sortOrder=desc` para achar a maior taxa de cada indexador. Junte com vencimento e `couponType` para filtrar por perfil: zero cupom é melhor para quem quer reinvestir tudo; cupom semestral é bom para quem quer receber dinheiro a cada seis meses. ### Marcação a mercado O endereço `/indicators/history` serve direto para gráficos de [marcação a mercado](/blog/marcacao-a-mercado-tesouro-direto-python-api). Você acompanha `buyPrice` e `sellPrice` dia a dia e vê o efeito que as mudanças de taxa têm no valor do seu título. ### Carteira de renda fixa com vários títulos Faça uma só chamada `/indicators?symbols=` com até 20 slugs e mostre a foto da carteira inteira de uma vez, sem precisar fazer várias chamadas separadas. ### Análise de curva de juros Liste todos os Prefixados (`/list?indexer=prefixado&limit=100`), pegue `(maturityDate, buyRate)` de cada um e desenhe a curva. Atualize a cada 5 minutos para respeitar o cache. ### Comparativo entre indexadores Junte `/indicators` com `/api/v2/macro/latest?symbols=selic,ipca12m` para transformar spread e taxa real em taxa efetiva. Aí dá para comparar Selic vs. IPCA+ vs. Prefixado na mesma unidade. Veja o post [CDB vs. Tesouro Direto: comparativo 2026](/blog/cdb-vs-tesouro-direto-comparativo-2026) para um guia de decisão. ### Backtest (teste em dados antigos) Junte `/indicators/history` (para o preço diário do título) com nosso [CDI histórico](/blog/cdi-historico-api-renda-fixa-benchmark-2026) e compare o desempenho da posição com o benchmark. *** ## Próximos passos com a API Tesouro Direto Estes são os caminhos para você se aprofundar: * [Documentação completa do `/api/v2/treasury`](/docs/tesouro-direto) * [Listagem](/docs/tesouro-direto/listagem) — referência do `/list` * [Indicadores](/docs/tesouro-direto/indicadores) — referência do `/indicators` * [Histórico](/docs/tesouro-direto/indicadores-historico) — referência do `/indicators/history` * [API de Macroeconomia: 15 indicadores BCB](/blog/api-macroeconomia-brasil-bcb-indicadores-2026) * [CDI histórico via API](/blog/cdi-historico-api-renda-fixa-benchmark-2026) * [Tesouro Direto: guia completo 2026](/blog/tesouro-direto-guia-completo-2026-como-investir) * [CDB vs. Tesouro Direto: comparativo 2026](/blog/cdb-vs-tesouro-direto-comparativo-2026) ## Conclusão A **API Tesouro Direto** da brapi.dev existe para te poupar tempo. Em vez de baixar planilha gigante e brigar com nomes inconsistentes, você faz três chamadas REST e tem na mão a lista de títulos, o valor de agora e o histórico diário desde 2005. Os slugs nunca mudam, o JSON é simples e o campo `rateInfo` te diz exatamente como ler cada taxa. Comece pelos três slugs sandbox para testar sua integração sem token. Quando estiver pronto para usar todos os títulos e o histórico completo, gere seu token e ative o plano Pro em [brapi.dev](https://brapi.dev). Boa construção! # API de Ações Brasileiras Gratuita: Como Consultar Cotações da Bolsa com JavaScript e Python URL: /blog/b3-api-gratuita-como-usar-cotacoes.mdx Consulte ações, FIIs, ETFs e BDRs da B3 por API. Veja exemplos em JavaScript e Python e entenda a diferença entre API REST, COTAHIST e dados oficiais. *** searchable: true title: 'API de Ações Brasileiras Gratuita: Como Consultar Cotações da Bolsa com JavaScript e Python' description: 'Consulte ações, FIIs, ETFs e BDRs da B3 por API. Veja exemplos em JavaScript e Python e entenda a diferença entre API REST, COTAHIST e dados oficiais.' date: '2026-01-07' keywords: 'api ações brasileiras, api gratuita, api bolsa de valores, api ações Brasil, cotação API, api cotações, api bovespa, brapi' author: 'Equipe brapi.dev' category: 'Desenvolvimento' subcategory: 'API de Cotações' readingTime: '12 min' tags: \['API', 'Bolsa Brasileira', 'Cotações', 'Desenvolvimento', 'JavaScript', 'Python', 'Tutorial', 'Grátis'] relatedPosts: \['listar-acoes-b3-api-tickers-setores-python', 'dados-historicos-b3-python-pandas-api', 'api-indicadores-fundamentalistas-b3-python'] featured: true expertise: 'Especialistas em integração de APIs financeiras e desenvolvimento de aplicações para o mercado brasileiro' lastReviewed: '2026-07-17' howToTools: \['brapi.dev API', 'curl', 'JavaScript/Node.js', 'Python', 'Postman'] howToSteps: * name: 'Crie sua conta gratuita' text: 'Acesse brapi.dev e crie uma conta gratuita para obter seu token de API.' * name: 'Copie seu token' text: 'No dashboard, copie o token de autenticação.' * name: 'Faça a primeira requisição' text: 'Use curl, JavaScript ou Python para consultar tickers como PETR4, VALE3 e ITUB4.' * name: 'Escolha os dados necessários' text: 'Adicione parâmetros como fundamental, dividends, range e interval conforme o caso.' * name: 'Integre no seu projeto' text: 'Use a resposta JSON para montar dashboards, planilhas, bots e alertas.' faqSchema: * question: 'Existe API de ações brasileiras gratuita?' answer: 'Sim. A brapi.dev oferece uma API para consultar cotações e dados de ativos negociados na bolsa brasileira, com plano gratuito e endpoints para ações, FIIs, ETFs, BDRs, moedas, criptoativos e indicadores.' * question: 'Como consultar uma cotação da bolsa brasileira por API?' answer: 'Faça uma requisição GET para [https://brapi.dev/api/quote/PETR4](https://brapi.dev/api/quote/PETR4). Para recursos avançados, use Authorization: Bearer SEU\_TOKEN.' * question: 'A API retorna dados históricos?' answer: 'Sim. Use parâmetros como range e interval para solicitar histórico de preços no endpoint de quote.' * question: 'Posso consultar vários tickers de uma vez?' answer: 'Sim. Separe os tickers por vírgula, como /api/quote/PETR4,VALE3,ITUB4.' *** import { Authors, Author } from '~/components/Authors'; > Precisa de cotações da bolsa brasileira em uma aplicação, planilha ou dashboard? A brapi.dev permite consultar ações, FIIs, ETFs e BDRs por uma API JSON simples, com exemplos em curl, JavaScript e Python. ## Resposta Rápida A forma mais simples de consultar uma ação brasileira é: ```bash curl "https://brapi.dev/api/quote/PETR4" ``` Para múltiplos ativos: ```bash curl "https://brapi.dev/api/quote/PETR4,VALE3,ITUB4" ``` Para recursos autenticados, envie seu token no cabeçalho: ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/quote/PETR4?modules=defaultKeyStatistics,financialData÷nds=true" ``` Para uma integração nova, prefira o endpoint v2 de cotação: ```bash curl "https://brapi.dev/api/v2/stocks/quote?symbols=PETR4,VALE3" ``` O endpoint `/api/quote/{tickers}` continua funcionando. A API v2 separa cotação, histórico, dividendos e fundamentos, o que reduz dados desnecessários em cada resposta. ## A B3 tem uma API gratuita? A B3 publica arquivos e conjuntos de dados em seu [Hub de dados públicos](https://www.b3.com.br/pt_br/dados/hub-de-dados-publicos/). Esses materiais incluem séries históricas, empresas listadas e eventos corporativos. Isso não equivale a uma API REST pública de cotações pronta para uma aplicação. Produtos oficiais de dados e distribuição têm contratos, regras e formatos próprios. A brapi organiza dados de mercado brasileiro em endpoints JSON voltados a sites, aplicativos, planilhas, robôs e análises. O plano gratuito permite começar a integração e os ativos de teste funcionam sem token. ## API REST ou COTAHIST O arquivo COTAHIST é útil para processamento em lote e pesquisa histórica. Uma API REST é mais prática quando a aplicação precisa consultar poucos ativos, filtrar o resultado ou atualizar uma tela. | Necessidade | Melhor ponto de partida | | ------------------------------------------------- | ----------------------- | | Processar o arquivo bruto de um ano inteiro | COTAHIST da B3 | | Consultar um ticker em JSON | API REST | | Atualizar dashboard ou planilha | API REST | | Auditar a fonte oficial bruta | Arquivos públicos da B3 | | Buscar fundamentos, dividendos e histórico juntos | brapi | Se você precisa da lista atual de símbolos, use `/api/v2/tickers` em vez de manter um CSV antigo. Veja [como listar todas as ações da B3 por API](/blog/listar-acoes-b3-api-tickers-setores-python). ## O Que a API Retorna O endpoint `/api/quote/{tickers}` retorna uma resposta JSON padronizada. Os campos disponíveis dependem dos parâmetros usados e do plano. ```json { "results": [ { "symbol": "PETR4", "shortName": "PETROBRAS PN", "currency": "BRL", "regularMarketPrice": 37.85, "regularMarketChange": 0.45, "regularMarketChangePercent": 1.2, "regularMarketVolume": 45678900 } ], "requestedAt": "2026-04-23T14:30:00.000Z", "took": 245 } ``` Use os campos de preço, variação e volume para dashboards simples. Para análise fundamentalista, inclua `modules=defaultKeyStatistics,financialData`. Para dividendos, inclua `dividends=true`. ## JavaScript: Consultar Cotações ```javascript async function getCotacao(ticker, token) { const response = await fetch(`https://brapi.dev/api/quote/${ticker}`, { headers: token ? { Authorization: `Bearer ${token}` } : {}, }); if (!response.ok) { throw new Error(`Erro ${response.status}`); } const data = await response.json(); return data.results[0]; } const petr4 = await getCotacao('PETR4', process.env.BRAPI_TOKEN); console.log(`${petr4.symbol}: R$ ${petr4.regularMarketPrice}`); ``` ## JavaScript: Carteira com Vários Tickers ```javascript async function getCarteira(tickers, token) { const symbols = tickers.join(','); const response = await fetch(`https://brapi.dev/api/quote/${symbols}`, { headers: token ? { Authorization: `Bearer ${token}` } : {}, }); const data = await response.json(); return data.results.map((ativo) => ({ ticker: ativo.symbol, preco: ativo.regularMarketPrice, variacao: ativo.regularMarketChangePercent, })); } const carteira = await getCarteira(['PETR4', 'VALE3', 'ITUB4'], process.env.BRAPI_TOKEN); console.table(carteira); ``` ## Python: Cotações com requests ```python import os import requests def get_cotacao(ticker: str): token = os.getenv("BRAPI_TOKEN") headers = {"Authorization": f"Bearer {token}"} if token else {} response = requests.get( f"https://brapi.dev/api/quote/{ticker}", headers=headers, timeout=15, ) response.raise_for_status() return response.json()["results"][0] petr4 = get_cotacao("PETR4") print(f"{petr4['symbol']}: R$ {petr4['regularMarketPrice']}") ``` ## Python: Histórico para Análise ```python import os import pandas as pd import requests def get_historico(ticker: str, range_: str = "1y", interval: str = "1d"): token = os.getenv("BRAPI_TOKEN") headers = {"Authorization": f"Bearer {token}"} if token else {} response = requests.get( f"https://brapi.dev/api/quote/{ticker}", params={"range": range_, "interval": interval}, headers=headers, timeout=15, ) response.raise_for_status() result = response.json()["results"][0] df = pd.DataFrame(result["historicalDataPrice"]) df["date"] = pd.to_datetime(df["date"], unit="s") return df historico = get_historico("VALE3", "6mo", "1d") print(historico.tail()) ``` ## Principais Parâmetros | Parâmetro | Uso | | -------------------------------------------- | ------------------------------------------------------- | | `modules=defaultKeyStatistics,financialData` | Inclui indicadores e dados fundamentalistas disponíveis | | `dividends=true` | Inclui dados de dividendos | | `range=1y` | Define período histórico | | `interval=1d` | Define granularidade do histórico | | `modules=` | Solicita módulos específicos quando disponíveis | Exemplo: ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/quote/TAEE11?modules=defaultKeyStatistics,financialData÷nds=true&range=1y&interval=1d" ``` ## Endpoints Relacionados | Endpoint | Quando usar | | ----------------------------- | ----------------------------------------------------- | | `/api/quote/{tickers}` | Cotação de um ou vários ativos | | `/api/v2/stocks/quote` | Cotação em novas integrações | | `/api/v2/stocks/historical` | Histórico OHLCV por ativo | | `/api/v2/stocks/dividends` | Dividendos, JCP e eventos de ações | | `/api/v2/tickers` | Listagem e validação de tickers | | `/api/v2/crypto` | Criptomoedas | | `/api/v2/currency` | Moedas e câmbio | | `/api/v2/currency/historical` | Histórico PTAX para USD, EUR, GBP, JPY e mais | | `/api/v2/macro` | Selic, CDI, IPCA, IGP-M, TR e mais 10 indicadores BCB | Consulte a [documentação completa](/docs) para parâmetros, exemplos e limites de uso. ## Casos de Uso ### Dashboard de Carteira Você pode atualizar a carteira em intervalos definidos e renderizar preço, variação e valor total. Em produção, use cache para evitar chamadas desnecessárias. ```javascript const tickers = ['PETR4', 'VALE3', 'ITUB4', 'TAEE11']; const carteira = await getCarteira(tickers, process.env.BRAPI_TOKEN); ``` ### Alertas de Preço ```python def alerta_preco(ticker, preco_alvo): cotacao = get_cotacao(ticker) preco = cotacao["regularMarketPrice"] if preco >= preco_alvo: return f"{ticker} atingiu R$ {preco_alvo}" return None ``` ### Google Sheets Para planilhas, use Apps Script com `UrlFetchApp`. Veja o tutorial completo em [Integração Google Sheets com Cotações da Bolsa Brasileira](/blog/integracao-google-sheets-cotacoes-b3-tutorial-completo). ## Boas Práticas Evite scraping de sites financeiros quando houver API. APIs são mais estáveis, retornam JSON, respeitam limites e reduzem risco de quebra quando uma página muda layout. Em produção, configure timeout, tratamento de erro, cache e logs. Para dashboards, não atualize a cada segundo se o usuário só precisa de visão de carteira a cada poucos minutos. ## Perguntas Frequentes ### Existe API de ações brasileiras gratuita? Sim. A brapi.dev oferece uma API para consultar cotações e dados de ativos da bolsa brasileira, com plano gratuito e recursos adicionais nos planos pagos. ### Preciso de token? Algumas consultas básicas podem funcionar sem token, mas o token é recomendado e necessário para recursos avançados, maior cobertura e limites superiores. ### Posso consultar FIIs e ETFs? Sim. Use o ticker negociado na bolsa brasileira, como `MXRF11`, `HGLG11`, `BOVA11`, `IVVB11` ou `WRLD11`, conforme disponibilidade. ### A resposta é em tempo real? A API foi construída para entregar dados recentes de mercado, mas disponibilidade, atraso e cobertura podem variar conforme ativo, plano e fonte de dados. ## Próximos Passos Crie sua conta em [brapi.dev](/dashboard), gere seu token e leia a [documentação](/docs). Para um fluxo novo, veja [dados históricos com Python](/blog/dados-historicos-b3-python-pandas-api), [indicadores fundamentalistas](/blog/api-indicadores-fundamentalistas-b3-python) e [Google Sheets com cotações](/blog/integracao-google-sheets-cotacoes-b3-tutorial-completo). # Backtesting de Estratégias com Python e brapi 2026: Guia Completo URL: /blog/backtesting-estrategias-python-brapi-guia-completo.mdx Aprenda a fazer backtesting de estratégias de trading com Python e brapi. Tutorial completo: médias móveis, RSI, drawdown, métricas de performance e otimização. *** searchable: true title: 'Backtesting de Estratégias com Python e brapi 2026: Guia Completo' description: 'Aprenda a fazer backtesting de estratégias de trading com Python e brapi. Tutorial completo: médias móveis, RSI, drawdown, métricas de performance e otimização.' date: '2025-12-31' keywords: 'backtesting python, backtest estrategia trading, testar estrategia acoes, simulacao trading python, brapi backtesting, metricas backtest, drawdown sharpe, 2026' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Backtesting' readingTime: '20 min' tags: \['Python', 'Backtesting', 'Trading', 'Estratégias', 'API', 'Análise Técnica', 'Automação'] relatedPosts: \['stock-screener-python-brapi-filtrar-acoes', 'analise-tecnica-suportes-resistencias-medias-moveis', 'bot-telegram-cotacoes-acoes-python-tutorial'] featured: true expertise: 'Equipe técnica especializada em análise quantitativa e desenvolvimento de sistemas de trading' lastReviewed: '2026-01-17' -------------------------- import { Authors, Author } from '~/components/Authors'; > Antes de arriscar dinheiro real, teste sua estratégia no passado. Neste tutorial, você vai aprender a criar um sistema de backtesting completo usando Python e dados da brapi. *** ## O Que é Backtesting? **Backtesting** é o processo de testar uma estratégia de trading usando dados históricos para avaliar como ela teria performado no passado. ``` ┌─────────────────────────────────────────────────────────────┐ │ FLUXO DO BACKTESTING │ ├─────────────────────────────────────────────────────────────┤ │ │ │ 1. Definir 2. Coletar 3. Simular │ │ Estratégia → Dados → Trades │ │ (regras) Históricos (compra/venda) │ │ │ │ ↓ │ │ │ │ 4. Calcular 5. Analisar 6. Otimizar │ │ Métricas ← Resultados ← Parâmetros │ │ (Sharpe, DD) (gráficos) (se necessário) │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Por Que Fazer Backtesting? | Motivo | Benefício | | -------------- | --------------------------------------------- | | **Validação** | Testar hipóteses antes de arriscar capital | | **Métricas** | Quantificar risco e retorno esperados | | **Otimização** | Ajustar parâmetros para melhor performance | | **Confiança** | Entender comportamento em diferentes cenários | | **Disciplina** | Seguir regras definidas, não emoções | ### Limitações do Backtesting * **Overfitting:** estratégia otimizada demais para dados passados * **Survivorship bias:** dados podem não incluir empresas que faliram * **Custos:** corretagem, slippage e spreads podem não estar inclusos * **Regimes de mercado:** passado não garante futuro *** ## Setup do Ambiente ### Instalação das Dependências ```bash pip install requests pandas numpy matplotlib ``` ### Estrutura do Projeto ``` backtesting-brapi/ ├── src/ │ ├── data/ │ │ └── fetcher.py # Buscar dados da brapi │ ├── strategies/ │ │ ├── base.py # Classe base de estratégia │ │ ├── moving_average.py # Cruzamento de médias │ │ └── rsi.py # RSI oversold/overbought │ ├── backtest/ │ │ ├── engine.py # Motor de backtesting │ │ └── metrics.py # Cálculo de métricas │ └── utils/ │ └── plots.py # Visualização ├── main.py └── requirements.txt ``` *** ## Buscando Dados Históricos ### Módulo de Dados ```python import requests import pandas as pd from typing import Optional class BrapiDataFetcher: """Busca dados históricos da brapi""" BASE_URL = "https://brapi.dev/api" def __init__(self, token: str): self.token = token def get_historical_data( self, ticker: str, range_period: str = "5y", interval: str = "1d" ) -> pd.DataFrame: """ Busca dados históricos de um ticker. Args: ticker: Código da ação (ex: PETR4) range_period: Período (1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, max) interval: Intervalo (1d, 1wk, 1mo) Returns: DataFrame com colunas: date, open, high, low, close, volume """ url = f"{self.BASE_URL}/quote/{ticker}" params = { "token": self.token, "range": range_period, "interval": interval, "fundamental": "false" } response = requests.get(url, params=params) response.raise_for_status() data = response.json() if not data.get("results"): raise ValueError(f"Sem dados para {ticker}") historical = data["results"][0].get("historicalDataPrice", []) if not historical: raise ValueError(f"Sem dados históricos para {ticker}") df = pd.DataFrame(historical) df["date"] = pd.to_datetime(df["date"], unit="s") df = df.sort_values("date").reset_index(drop=True) # Renomear colunas para padrão df = df.rename(columns={ "open": "open", "high": "high", "low": "low", "close": "close", "volume": "volume" }) return df[["date", "open", "high", "low", "close", "volume"]] def get_multiple_tickers( self, tickers: list[str], range_period: str = "5y", interval: str = "1d" ) -> dict[str, pd.DataFrame]: """Busca dados de múltiplos tickers""" data = {} for ticker in tickers: try: data[ticker] = self.get_historical_data( ticker, range_period, interval ) except Exception as e: print(f"Erro ao buscar {ticker}: {e}") return data # Exemplo de uso if __name__ == "__main__": fetcher = BrapiDataFetcher("seu_token_brapi") df = fetcher.get_historical_data("PETR4", "2y", "1d") print(df.head()) print(f"Total de registros: {len(df)}") ``` *** ## Classe Base de Estratégia ### Definindo a Interface ```python # src/strategies/base.py from abc import ABC, abstractmethod import pandas as pd import numpy as np class Strategy(ABC): """Classe base para estratégias de trading""" def __init__(self, name: str): self.name = name @abstractmethod def generate_signals(self, data: pd.DataFrame) -> pd.DataFrame: """ Gera sinais de compra/venda. Args: data: DataFrame com OHLCV Returns: DataFrame com coluna 'signal': - 1: compra - -1: venda - 0: manter posição """ pass def calculate_indicators(self, data: pd.DataFrame) -> pd.DataFrame: """Calcula indicadores técnicos (opcional)""" return data def __repr__(self): return f"Strategy({self.name})" ``` *** ## Estratégia: Cruzamento de Médias Móveis ### Implementação ```python # src/strategies/moving_average.py import pandas as pd import numpy as np from .base import Strategy class MovingAverageCrossover(Strategy): """ Estratégia de cruzamento de médias móveis. Regras: - Compra quando média curta cruza acima da média longa - Vende quando média curta cruza abaixo da média longa """ def __init__(self, short_window: int = 20, long_window: int = 50): super().__init__(f"MA_Crossover_{short_window}_{long_window}") self.short_window = short_window self.long_window = long_window def calculate_indicators(self, data: pd.DataFrame) -> pd.DataFrame: """Calcula médias móveis""" df = data.copy() df["sma_short"] = df["close"].rolling(window=self.short_window).mean() df["sma_long"] = df["close"].rolling(window=self.long_window).mean() return df def generate_signals(self, data: pd.DataFrame) -> pd.DataFrame: """Gera sinais de cruzamento""" df = self.calculate_indicators(data) # Inicializa coluna de sinais df["signal"] = 0 # Detecta cruzamentos # Cruzamento para cima: short cruza acima de long df.loc[ (df["sma_short"] > df["sma_long"]) & (df["sma_short"].shift(1) <= df["sma_long"].shift(1)), "signal" ] = 1 # Cruzamento para baixo: short cruza abaixo de long df.loc[ (df["sma_short"] < df["sma_long"]) & (df["sma_short"].shift(1) >= df["sma_long"].shift(1)), "signal" ] = -1 return df class ExponentialMovingAverageCrossover(Strategy): """Cruzamento de médias móveis exponenciais (EMA)""" def __init__(self, short_window: int = 12, long_window: int = 26): super().__init__(f"EMA_Crossover_{short_window}_{long_window}") self.short_window = short_window self.long_window = long_window def calculate_indicators(self, data: pd.DataFrame) -> pd.DataFrame: df = data.copy() df["ema_short"] = df["close"].ewm(span=self.short_window, adjust=False).mean() df["ema_long"] = df["close"].ewm(span=self.long_window, adjust=False).mean() return df def generate_signals(self, data: pd.DataFrame) -> pd.DataFrame: df = self.calculate_indicators(data) df["signal"] = 0 df.loc[ (df["ema_short"] > df["ema_long"]) & (df["ema_short"].shift(1) <= df["ema_long"].shift(1)), "signal" ] = 1 df.loc[ (df["ema_short"] < df["ema_long"]) & (df["ema_short"].shift(1) >= df["ema_long"].shift(1)), "signal" ] = -1 return df ``` *** ## Estratégia: RSI (Índice de Força Relativa) ### Implementação ```python # src/strategies/rsi.py import pandas as pd import numpy as np from .base import Strategy class RSIStrategy(Strategy): """ Estratégia baseada no RSI (Relative Strength Index). Regras: - Compra quando RSI cruza acima do nível oversold (sobrevendido) - Vende quando RSI cruza abaixo do nível overbought (sobrecomprado) """ def __init__( self, period: int = 14, oversold: float = 30, overbought: float = 70 ): super().__init__(f"RSI_{period}_{oversold}_{overbought}") self.period = period self.oversold = oversold self.overbought = overbought def calculate_rsi(self, prices: pd.Series) -> pd.Series: """Calcula o RSI""" delta = prices.diff() gain = delta.where(delta > 0, 0) loss = (-delta).where(delta < 0, 0) avg_gain = gain.rolling(window=self.period).mean() avg_loss = loss.rolling(window=self.period).mean() rs = avg_gain / avg_loss rsi = 100 - (100 / (1 + rs)) return rsi def calculate_indicators(self, data: pd.DataFrame) -> pd.DataFrame: df = data.copy() df["rsi"] = self.calculate_rsi(df["close"]) return df def generate_signals(self, data: pd.DataFrame) -> pd.DataFrame: df = self.calculate_indicators(data) df["signal"] = 0 # Compra: RSI cruza acima de oversold df.loc[ (df["rsi"] > self.oversold) & (df["rsi"].shift(1) <= self.oversold), "signal" ] = 1 # Venda: RSI cruza abaixo de overbought df.loc[ (df["rsi"] < self.overbought) & (df["rsi"].shift(1) >= self.overbought), "signal" ] = -1 return df class RSIMeanReversion(Strategy): """ Estratégia de reversão à média com RSI. Compra em oversold extremo, vende em overbought extremo. """ def __init__( self, period: int = 14, oversold: float = 25, overbought: float = 75, exit_level: float = 50 ): super().__init__(f"RSI_MeanRev_{period}") self.period = period self.oversold = oversold self.overbought = overbought self.exit_level = exit_level def calculate_rsi(self, prices: pd.Series) -> pd.Series: delta = prices.diff() gain = delta.where(delta > 0, 0) loss = (-delta).where(delta < 0, 0) avg_gain = gain.rolling(window=self.period).mean() avg_loss = loss.rolling(window=self.period).mean() rs = avg_gain / avg_loss return 100 - (100 / (1 + rs)) def calculate_indicators(self, data: pd.DataFrame) -> pd.DataFrame: df = data.copy() df["rsi"] = self.calculate_rsi(df["close"]) return df def generate_signals(self, data: pd.DataFrame) -> pd.DataFrame: df = self.calculate_indicators(data) df["signal"] = 0 # Compra em oversold extremo df.loc[df["rsi"] < self.oversold, "signal"] = 1 # Venda em overbought extremo df.loc[df["rsi"] > self.overbought, "signal"] = -1 return df ``` *** ## Motor de Backtesting ### Implementação Completa ```python # src/backtest/engine.py import pandas as pd import numpy as np from typing import Optional from dataclasses import dataclass @dataclass class Trade: """Representa uma operação""" entry_date: pd.Timestamp entry_price: float exit_date: Optional[pd.Timestamp] = None exit_price: Optional[float] = None shares: int = 0 pnl: float = 0 pnl_percent: float = 0 @property def is_closed(self) -> bool: return self.exit_date is not None class BacktestEngine: """ Motor de backtesting. Simula execução de estratégia em dados históricos. """ def __init__( self, initial_capital: float = 100000, commission: float = 0.0, # Percentual por trade slippage: float = 0.0, # Percentual de slippage position_size: float = 1.0, # Fração do capital por trade allow_short: bool = False # Permitir venda a descoberto ): self.initial_capital = initial_capital self.commission = commission self.slippage = slippage self.position_size = position_size self.allow_short = allow_short self.reset() def reset(self): """Reseta estado do backtest""" self.capital = self.initial_capital self.position = 0 self.trades: list[Trade] = [] self.equity_curve: list[float] = [] self.current_trade: Optional[Trade] = None def run(self, data: pd.DataFrame, strategy) -> pd.DataFrame: """ Executa o backtest. Args: data: DataFrame com OHLCV strategy: Instância de Strategy Returns: DataFrame com resultados do backtest """ self.reset() # Gera sinais signals_df = strategy.generate_signals(data) # Simula trades results = [] for i, row in signals_df.iterrows(): signal = row["signal"] price = row["close"] date = row["date"] # Aplica slippage if signal == 1: execution_price = price * (1 + self.slippage) elif signal == -1: execution_price = price * (1 - self.slippage) else: execution_price = price # Processa sinais if signal == 1 and self.position == 0: # Abre posição comprada self._open_position(date, execution_price) elif signal == -1 and self.position > 0: # Fecha posição comprada self._close_position(date, execution_price) elif signal == -1 and self.position == 0 and self.allow_short: # Abre posição vendida (short) self._open_short(date, execution_price) elif signal == 1 and self.position < 0: # Fecha posição vendida self._close_short(date, execution_price) # Calcula equity if self.position > 0: equity = self.capital + (self.position * price) elif self.position < 0: equity = self.capital - (abs(self.position) * price) + (abs(self.position) * self.current_trade.entry_price * 2) else: equity = self.capital self.equity_curve.append(equity) results.append({ "date": date, "close": price, "signal": signal, "position": self.position, "capital": self.capital, "equity": equity }) # Fecha posição aberta no final if self.position != 0: last_row = signals_df.iloc[-1] self._close_position(last_row["date"], last_row["close"]) return pd.DataFrame(results) def _open_position(self, date, price): """Abre posição comprada""" investment = self.capital * self.position_size commission_cost = investment * self.commission shares = int((investment - commission_cost) / price) if shares > 0: cost = shares * price + commission_cost self.capital -= cost self.position = shares self.current_trade = Trade( entry_date=date, entry_price=price, shares=shares ) def _close_position(self, date, price): """Fecha posição comprada""" if self.position > 0 and self.current_trade: revenue = self.position * price commission_cost = revenue * self.commission net_revenue = revenue - commission_cost self.capital += net_revenue self.current_trade.exit_date = date self.current_trade.exit_price = price self.current_trade.pnl = net_revenue - (self.current_trade.shares * self.current_trade.entry_price) self.current_trade.pnl_percent = (price / self.current_trade.entry_price - 1) * 100 self.trades.append(self.current_trade) self.position = 0 self.current_trade = None def _open_short(self, date, price): """Abre posição vendida""" investment = self.capital * self.position_size commission_cost = investment * self.commission shares = int((investment - commission_cost) / price) if shares > 0: self.position = -shares self.current_trade = Trade( entry_date=date, entry_price=price, shares=shares ) def _close_short(self, date, price): """Fecha posição vendida""" if self.position < 0 and self.current_trade: cost = abs(self.position) * price commission_cost = cost * self.commission pnl = (self.current_trade.entry_price - price) * abs(self.position) - commission_cost self.capital += pnl self.current_trade.exit_date = date self.current_trade.exit_price = price self.current_trade.pnl = pnl self.current_trade.pnl_percent = (self.current_trade.entry_price / price - 1) * 100 self.trades.append(self.current_trade) self.position = 0 self.current_trade = None def get_trades_df(self) -> pd.DataFrame: """Retorna DataFrame com todos os trades""" if not self.trades: return pd.DataFrame() trades_data = [] for t in self.trades: trades_data.append({ "entry_date": t.entry_date, "entry_price": t.entry_price, "exit_date": t.exit_date, "exit_price": t.exit_price, "shares": t.shares, "pnl": t.pnl, "pnl_percent": t.pnl_percent }) return pd.DataFrame(trades_data) ``` *** ## Métricas de Performance ### Implementação ```python # src/backtest/metrics.py import pandas as pd import numpy as np from typing import Optional class BacktestMetrics: """Calcula métricas de performance do backtest""" def __init__( self, results_df: pd.DataFrame, trades_df: pd.DataFrame, initial_capital: float, risk_free_rate: float = 0.10 # Taxa livre de risco anual (SELIC) ): self.results = results_df self.trades = trades_df self.initial_capital = initial_capital self.risk_free_rate = risk_free_rate def calculate_all(self) -> dict: """Calcula todas as métricas""" return { "total_return": self.total_return(), "total_return_pct": self.total_return_pct(), "annualized_return": self.annualized_return(), "volatility": self.volatility(), "sharpe_ratio": self.sharpe_ratio(), "sortino_ratio": self.sortino_ratio(), "max_drawdown": self.max_drawdown(), "max_drawdown_duration": self.max_drawdown_duration(), "total_trades": self.total_trades(), "winning_trades": self.winning_trades(), "losing_trades": self.losing_trades(), "win_rate": self.win_rate(), "avg_win": self.avg_win(), "avg_loss": self.avg_loss(), "profit_factor": self.profit_factor(), "avg_trade_duration": self.avg_trade_duration(), "calmar_ratio": self.calmar_ratio(), } def total_return(self) -> float: """Retorno total em R$""" final_equity = self.results["equity"].iloc[-1] return final_equity - self.initial_capital def total_return_pct(self) -> float: """Retorno total percentual""" return (self.total_return() / self.initial_capital) * 100 def annualized_return(self) -> float: """Retorno anualizado""" total_days = (self.results["date"].iloc[-1] - self.results["date"].iloc[0]).days total_years = total_days / 365.25 if total_years <= 0: return 0 final_equity = self.results["equity"].iloc[-1] return ((final_equity / self.initial_capital) ** (1 / total_years) - 1) * 100 def volatility(self) -> float: """Volatilidade anualizada dos retornos""" returns = self.results["equity"].pct_change().dropna() return returns.std() * np.sqrt(252) * 100 def sharpe_ratio(self) -> float: """Índice de Sharpe""" annualized_ret = self.annualized_return() / 100 vol = self.volatility() / 100 if vol == 0: return 0 return (annualized_ret - self.risk_free_rate) / vol def sortino_ratio(self) -> float: """Índice de Sortino (considera apenas volatilidade negativa)""" returns = self.results["equity"].pct_change().dropna() negative_returns = returns[returns < 0] downside_std = negative_returns.std() * np.sqrt(252) if downside_std == 0: return 0 annualized_ret = self.annualized_return() / 100 return (annualized_ret - self.risk_free_rate) / downside_std def max_drawdown(self) -> float: """Máximo drawdown percentual""" equity = self.results["equity"] peak = equity.expanding().max() drawdown = (equity - peak) / peak return drawdown.min() * 100 def max_drawdown_duration(self) -> int: """Duração do máximo drawdown em dias""" equity = self.results["equity"] peak = equity.expanding().max() in_drawdown = equity < peak if not in_drawdown.any(): return 0 # Encontra períodos de drawdown drawdown_periods = [] current_start = None for i, is_dd in enumerate(in_drawdown): if is_dd and current_start is None: current_start = i elif not is_dd and current_start is not None: drawdown_periods.append(i - current_start) current_start = None if current_start is not None: drawdown_periods.append(len(in_drawdown) - current_start) return max(drawdown_periods) if drawdown_periods else 0 def total_trades(self) -> int: """Número total de trades""" return len(self.trades) def winning_trades(self) -> int: """Número de trades vencedores""" if self.trades.empty: return 0 return len(self.trades[self.trades["pnl"] > 0]) def losing_trades(self) -> int: """Número de trades perdedores""" if self.trades.empty: return 0 return len(self.trades[self.trades["pnl"] <= 0]) def win_rate(self) -> float: """Taxa de acerto percentual""" total = self.total_trades() if total == 0: return 0 return (self.winning_trades() / total) * 100 def avg_win(self) -> float: """Lucro médio dos trades vencedores""" if self.trades.empty: return 0 winners = self.trades[self.trades["pnl"] > 0] return winners["pnl"].mean() if not winners.empty else 0 def avg_loss(self) -> float: """Prejuízo médio dos trades perdedores""" if self.trades.empty: return 0 losers = self.trades[self.trades["pnl"] <= 0] return losers["pnl"].mean() if not losers.empty else 0 def profit_factor(self) -> float: """Fator de lucro (ganhos / perdas)""" if self.trades.empty: return 0 winners = self.trades[self.trades["pnl"] > 0]["pnl"].sum() losers = abs(self.trades[self.trades["pnl"] <= 0]["pnl"].sum()) if losers == 0: return float("inf") if winners > 0 else 0 return winners / losers def avg_trade_duration(self) -> float: """Duração média dos trades em dias""" if self.trades.empty: return 0 durations = (self.trades["exit_date"] - self.trades["entry_date"]).dt.days return durations.mean() def calmar_ratio(self) -> float: """Índice Calmar (retorno anualizado / max drawdown)""" max_dd = abs(self.max_drawdown()) if max_dd == 0: return 0 return self.annualized_return() / max_dd def print_report(self): """Imprime relatório formatado""" metrics = self.calculate_all() print("=" * 60) print("RELATÓRIO DE BACKTEST") print("=" * 60) print("\n--- Retorno ---") print(f"Retorno Total: R$ {metrics['total_return']:,.2f} ({metrics['total_return_pct']:.2f}%)") print(f"Retorno Anualizado: {metrics['annualized_return']:.2f}%") print("\n--- Risco ---") print(f"Volatilidade Anualizada: {metrics['volatility']:.2f}%") print(f"Máximo Drawdown: {metrics['max_drawdown']:.2f}%") print(f"Duração Max Drawdown: {metrics['max_drawdown_duration']} dias") print("\n--- Índices ---") print(f"Sharpe Ratio: {metrics['sharpe_ratio']:.2f}") print(f"Sortino Ratio: {metrics['sortino_ratio']:.2f}") print(f"Calmar Ratio: {metrics['calmar_ratio']:.2f}") print("\n--- Trades ---") print(f"Total de Trades: {metrics['total_trades']}") print(f"Trades Vencedores: {metrics['winning_trades']}") print(f"Trades Perdedores: {metrics['losing_trades']}") print(f"Win Rate: {metrics['win_rate']:.1f}%") print(f"Profit Factor: {metrics['profit_factor']:.2f}") print(f"Lucro Médio: R$ {metrics['avg_win']:,.2f}") print(f"Prejuízo Médio: R$ {metrics['avg_loss']:,.2f}") print(f"Duração Média: {metrics['avg_trade_duration']:.1f} dias") print("=" * 60) ``` *** ## Visualização de Resultados ### Gráficos ```python # src/utils/plots.py import matplotlib.pyplot as plt import pandas as pd import numpy as np def plot_backtest_results( results_df: pd.DataFrame, trades_df: pd.DataFrame, strategy_name: str, save_path: str = None ): """Plota resultados completos do backtest""" fig, axes = plt.subplots(3, 1, figsize=(14, 12)) # Gráfico 1: Equity Curve ax1 = axes[0] ax1.plot(results_df["date"], results_df["equity"], label="Equity", color="blue") ax1.axhline(y=results_df["equity"].iloc[0], color="gray", linestyle="--", alpha=0.5) ax1.set_title(f"Equity Curve - {strategy_name}") ax1.set_xlabel("Data") ax1.set_ylabel("Equity (R$)") ax1.legend() ax1.grid(True, alpha=0.3) # Marcar trades if not trades_df.empty: for _, trade in trades_df.iterrows(): color = "green" if trade["pnl"] > 0 else "red" ax1.axvspan(trade["entry_date"], trade["exit_date"], alpha=0.1, color=color) # Gráfico 2: Drawdown ax2 = axes[1] equity = results_df["equity"] peak = equity.expanding().max() drawdown = (equity - peak) / peak * 100 ax2.fill_between(results_df["date"], drawdown, 0, alpha=0.3, color="red") ax2.plot(results_df["date"], drawdown, color="red", linewidth=0.5) ax2.set_title("Drawdown") ax2.set_xlabel("Data") ax2.set_ylabel("Drawdown (%)") ax2.grid(True, alpha=0.3) # Gráfico 3: Preço + Sinais ax3 = axes[2] ax3.plot(results_df["date"], results_df["close"], label="Preço", color="black", alpha=0.7) # Sinais de compra buys = results_df[results_df["signal"] == 1] ax3.scatter(buys["date"], buys["close"], marker="^", color="green", s=100, label="Compra", zorder=5) # Sinais de venda sells = results_df[results_df["signal"] == -1] ax3.scatter(sells["date"], sells["close"], marker="v", color="red", s=100, label="Venda", zorder=5) ax3.set_title("Preço e Sinais") ax3.set_xlabel("Data") ax3.set_ylabel("Preço (R$)") ax3.legend() ax3.grid(True, alpha=0.3) plt.tight_layout() if save_path: plt.savefig(save_path, dpi=150, bbox_inches="tight") plt.show() def plot_trades_distribution(trades_df: pd.DataFrame, save_path: str = None): """Plota distribuição dos resultados dos trades""" if trades_df.empty: print("Sem trades para plotar") return fig, axes = plt.subplots(1, 2, figsize=(12, 5)) # Histograma de PnL ax1 = axes[0] colors = ["green" if x > 0 else "red" for x in trades_df["pnl"]] ax1.bar(range(len(trades_df)), trades_df["pnl"], color=colors) ax1.axhline(y=0, color="black", linestyle="-", linewidth=0.5) ax1.set_title("PnL por Trade") ax1.set_xlabel("Trade #") ax1.set_ylabel("PnL (R$)") # Histograma de retornos ax2 = axes[1] ax2.hist(trades_df["pnl_percent"], bins=20, edgecolor="black", alpha=0.7) ax2.axvline(x=0, color="red", linestyle="--") ax2.axvline(x=trades_df["pnl_percent"].mean(), color="blue", linestyle="--", label=f"Média: {trades_df['pnl_percent'].mean():.1f}%") ax2.set_title("Distribuição de Retornos") ax2.set_xlabel("Retorno (%)") ax2.set_ylabel("Frequência") ax2.legend() plt.tight_layout() if save_path: plt.savefig(save_path, dpi=150, bbox_inches="tight") plt.show() ``` *** ## Exemplo Completo: Executando o Backtest ### Script Principal ```python # main.py from src.data.fetcher import BrapiDataFetcher from src.strategies.moving_average import MovingAverageCrossover, ExponentialMovingAverageCrossover from src.strategies.rsi import RSIStrategy from src.backtest.engine import BacktestEngine from src.backtest.metrics import BacktestMetrics from src.utils.plots import plot_backtest_results, plot_trades_distribution def run_backtest( ticker: str, token: str, strategy, initial_capital: float = 100000, commission: float = 0.001 ): """Executa backtest completo""" print(f"\n{'='*60}") print(f"Backtesting: {strategy.name}") print(f"Ticker: {ticker}") print(f"Capital Inicial: R$ {initial_capital:,.2f}") print(f"{'='*60}") # 1. Buscar dados print("\n[1/4] Buscando dados históricos...") fetcher = BrapiDataFetcher(token) data = fetcher.get_historical_data(ticker, "5y", "1d") print(f" Período: {data['date'].min()} a {data['date'].max()}") print(f" Total de registros: {len(data)}") # 2. Executar backtest print("\n[2/4] Executando backtest...") engine = BacktestEngine( initial_capital=initial_capital, commission=commission, slippage=0.001 ) results = engine.run(data, strategy) trades = engine.get_trades_df() print(f" Total de trades: {len(trades)}") # 3. Calcular métricas print("\n[3/4] Calculando métricas...") metrics = BacktestMetrics(results, trades, initial_capital) metrics.print_report() # 4. Plotar resultados print("\n[4/4] Gerando gráficos...") plot_backtest_results(results, trades, f"{strategy.name} - {ticker}") plot_trades_distribution(trades) return results, trades, metrics def compare_strategies( ticker: str, token: str, strategies: list, initial_capital: float = 100000 ): """Compara múltiplas estratégias""" print("\n" + "="*80) print("COMPARAÇÃO DE ESTRATÉGIAS") print("="*80) results = [] for strategy in strategies: fetcher = BrapiDataFetcher(token) data = fetcher.get_historical_data(ticker, "5y", "1d") engine = BacktestEngine(initial_capital=initial_capital) bt_results = engine.run(data, strategy) trades = engine.get_trades_df() metrics = BacktestMetrics(bt_results, trades, initial_capital) metrics_dict = metrics.calculate_all() metrics_dict["strategy"] = strategy.name results.append(metrics_dict) # Tabela comparativa import pandas as pd comparison = pd.DataFrame(results) comparison = comparison.set_index("strategy") print("\n--- Comparação de Retorno ---") print(comparison[["total_return_pct", "annualized_return", "sharpe_ratio", "max_drawdown"]].round(2)) print("\n--- Comparação de Trades ---") print(comparison[["total_trades", "win_rate", "profit_factor"]].round(2)) return comparison # Exemplo de uso if __name__ == "__main__": TOKEN = "seu_token_brapi" TICKER = "PETR4" # Testar estratégia de médias móveis strategy_ma = MovingAverageCrossover(short_window=20, long_window=50) run_backtest(TICKER, TOKEN, strategy_ma) # Testar estratégia RSI strategy_rsi = RSIStrategy(period=14, oversold=30, overbought=70) run_backtest(TICKER, TOKEN, strategy_rsi) # Comparar estratégias strategies = [ MovingAverageCrossover(20, 50), MovingAverageCrossover(10, 30), ExponentialMovingAverageCrossover(12, 26), RSIStrategy(14, 30, 70), RSIStrategy(7, 25, 75), ] comparison = compare_strategies(TICKER, TOKEN, strategies) ``` *** ## Otimização de Parâmetros ### Grid Search ```python # src/optimization/grid_search.py import itertools from typing import Callable import pandas as pd def grid_search_optimization( data: pd.DataFrame, strategy_class: type, param_grid: dict, initial_capital: float = 100000, metric: str = "sharpe_ratio" ) -> pd.DataFrame: """ Busca os melhores parâmetros via grid search. Args: data: DataFrame com dados históricos strategy_class: Classe da estratégia param_grid: Dicionário com parâmetros e valores a testar initial_capital: Capital inicial metric: Métrica para otimização Returns: DataFrame com resultados ordenados pela métrica """ from src.backtest.engine import BacktestEngine from src.backtest.metrics import BacktestMetrics # Gerar todas as combinações param_names = list(param_grid.keys()) param_values = list(param_grid.values()) combinations = list(itertools.product(*param_values)) print(f"Testando {len(combinations)} combinações...") results = [] for i, combo in enumerate(combinations): params = dict(zip(param_names, combo)) # Criar estratégia com parâmetros strategy = strategy_class(**params) # Executar backtest engine = BacktestEngine(initial_capital=initial_capital) bt_results = engine.run(data, strategy) trades = engine.get_trades_df() # Calcular métricas metrics = BacktestMetrics(bt_results, trades, initial_capital) metrics_dict = metrics.calculate_all() metrics_dict.update(params) results.append(metrics_dict) # Progresso if (i + 1) % 10 == 0: print(f" {i + 1}/{len(combinations)} completo") # Ordenar por métrica results_df = pd.DataFrame(results) results_df = results_df.sort_values(metric, ascending=False) return results_df # Exemplo de uso if __name__ == "__main__": from src.data.fetcher import BrapiDataFetcher from src.strategies.moving_average import MovingAverageCrossover TOKEN = "seu_token_brapi" # Buscar dados fetcher = BrapiDataFetcher(TOKEN) data = fetcher.get_historical_data("PETR4", "5y", "1d") # Definir grid de parâmetros param_grid = { "short_window": [5, 10, 15, 20, 25], "long_window": [30, 40, 50, 60, 80, 100] } # Executar otimização results = grid_search_optimization( data=data, strategy_class=MovingAverageCrossover, param_grid=param_grid, metric="sharpe_ratio" ) print("\n--- Top 10 Combinações ---") print(results[["short_window", "long_window", "sharpe_ratio", "total_return_pct", "win_rate"]].head(10)) ``` *** ## Cuidados e Boas Práticas ### Evitando Overfitting ```python # Técnica: Walk-Forward Analysis def walk_forward_analysis( data: pd.DataFrame, strategy_class: type, param_grid: dict, train_size: float = 0.7, n_splits: int = 5 ): """ Validação walk-forward para evitar overfitting. Divide dados em janelas de treino/teste deslizantes. """ results = [] split_size = len(data) // n_splits for i in range(n_splits - 1): # Definir janelas train_start = i * split_size train_end = train_start + int(split_size * train_size) test_end = (i + 2) * split_size train_data = data.iloc[train_start:train_end].copy() test_data = data.iloc[train_end:test_end].copy() # Otimizar em treino best_params = optimize_on_data(train_data, strategy_class, param_grid) # Testar em dados fora da amostra test_metrics = test_with_params(test_data, strategy_class, best_params) results.append({ "split": i, "train_period": f"{train_data['date'].min()} - {train_data['date'].max()}", "test_period": f"{test_data['date'].min()} - {test_data['date'].max()}", **test_metrics }) return pd.DataFrame(results) ``` ### Checklist de Qualidade ``` Antes de confiar no backtest: □ Dados suficientes (mínimo 2-3 anos) □ Incluiu custos de transação □ Considerou slippage □ Testou em múltiplos ativos □ Fez walk-forward analysis □ Verificou se faz sentido econômico □ Comparou com buy-and-hold □ Analisou drawdowns detalhadamente ``` *** ## Conclusão O backtesting é uma ferramenta poderosa para validar estratégias, mas lembre-se: 1. **Passado não garante futuro** - use como ferramenta, não como garantia 2. **Evite overfitting** - estratégias simples geralmente funcionam melhor 3. **Inclua custos reais** - corretagem e slippage fazem diferença 4. **Teste em múltiplos cenários** - bull market, bear market, lateral 5. **Use walk-forward** - para resultados mais realistas *** ## Próximos Passos * **[Cadastre-se na brapi](https://brapi.dev)** para acessar dados históricos * **[Stock screener com Python](/blog/stock-screener-python-brapi-filtrar-acoes)** para encontrar ativos * **[Análise técnica](/blog/analise-tecnica-suportes-resistencias-medias-moveis)** para criar estratégias * **[Bot de Telegram](/blog/bot-telegram-cotacoes-acoes-python-tutorial)** para automatizar alertas *** *Este artigo tem caráter educacional. Backtesting não garante resultados futuros. Sempre faça sua própria análise antes de investir.* # Backtesting de Opções com Python e brapi: Covered Call e Cash-Secured Put (2026) URL: /blog/backtesting-opcoes-python-brapi-tutorial.mdx Aprenda a backtestar estratégias de opções (covered call, cash-secured put) em Python usando o histórico da API brapi. Tutorial passo a passo com código. *** searchable: true title: 'Backtesting de Opções com Python e brapi: Covered Call e Cash-Secured Put (2026)' description: 'Aprenda a backtestar estratégias de opções (covered call, cash-secured put) em Python usando o histórico da API brapi. Tutorial passo a passo com código.' date: '2026-05-09' keywords: 'backtesting opcoes python, backtest covered call, cash-secured put backtest, estrategia opcoes python, brapi opcoes historico, backtest estrategia bolsa brasileira, derivativos backtest brasil' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Opções' readingTime: '21 min' tags: \['Python', 'Opções', 'Backtest', 'Covered Call', 'Cash-Secured Put', 'Bolsa Brasileira', 'Derivativos', 'API', 'Estratégia Avançada'] relatedPosts: \['cadeia-opcoes-b3-python-tutorial-api-brapi', 'dividendos-sinteticos-opcoes-covered-call-2026', 'opcoes-b3-guia-completo-iniciantes-calls-puts', 'backtesting-estrategias-python-brapi-guia-completo'] featured: true expertise: 'Backtesting de derivativos com dados históricos da bolsa brasileira' lastReviewed: '2026-05-09' howToSteps: * name: 'Configurar ambiente' text: 'Instale Python 3.10+, requests, pandas e numpy para manipular dados históricos de opções e ações.' * name: 'Definir a estratégia' text: 'Escolha entre covered call (lançamento coberto) e cash-secured put. Defina parâmetros: distância OTM, dias até vencimento.' * name: 'Buscar histórico de opções' text: 'Use /api/v2/options/historical para puxar OHLCV diário das séries selecionadas no período de backtest.' * name: 'Reconstruir o histórico do underlying' text: 'Use /api/quote/{ticker}?range=5y para puxar histórico do ativo subjacente.' * name: 'Simular trades' text: 'Para cada vencimento, identifique strike, abra a posição no início, fechamento no vencimento ou rolagem.' * name: 'Calcular métricas' text: 'Compute retorno total, Sharpe, drawdown máximo e taxa de assignment vs buy-and-hold.' howToTools: \['Python 3.10+', 'requests', 'pandas', 'numpy', 'matplotlib', 'Token brapi.dev (plano Pro) ou sandbox PETR4'] *** import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > "Covered call rende mais que buy-and-hold!" — você ouviu isso de alguém. Será que rende mesmo? Neste tutorial você vai construir, em Python, um **backtest reproduzível** de duas estratégias clássicas de opções (covered call e cash-secured put) usando o histórico real da bolsa brasileira via API brapi. Em vez de "achismos", **dados**. *** ## Por Que Backtestar? Toda estratégia de opções tem **dois jeitos** de ser estudada: 1. **Mecânica:** "como funciona a operação" 2. **Resultado:** "como ela se comportou no passado" A maioria dos materiais para. Mas a parte interessante começa onde param. Saber que covered call gera prêmio é trivial. Saber que ela rendeu **17% a.a. com 8% de drawdown** em PETR4 entre 2018-2024 enquanto buy-and-hold rendeu 22% a.a. com 35% de drawdown — isso muda decisões. Backtest é o instrumento que te tira do *e se* para o *foi*. Backtest mostra o passado. Mercado muda. Custos de corretagem, spread bid-ask, slippage e regimes de volatilidade impactam o resultado real. Use o backtest como **ferramenta de eliminação de estratégias ruins**, não como promessa de retorno futuro. *** ## O Que Vamos Backtestar ### Estratégia 1: Covered Call (Lançamento Coberto) **Mecânica:** você tem 100 ações de PETR4. Todo mês, vende 1 contrato de call OTM (ex.: 5% acima do spot) com vencimento no próximo terceiro friday. Recebe o prêmio. **Cenários no vencimento:** * Spot ≤ Strike: opção vira pó, você fica com as ações + prêmio. Repete no mês seguinte. * Spot > Strike: você é exercido — vende as ações pelo strike, fica com (strike − preço de entrada) + prêmio + dividendos do período. **Tese:** em mercados laterais ou de leve alta, prêmios mensais somam mais que o ganho perdido por exercício. ### Estratégia 2: Cash-Secured Put **Mecânica:** você tem dinheiro em caixa equivalente a 100×spot. Todo mês, vende 1 contrato de put OTM (ex.: 5% abaixo do spot). Recebe o prêmio. **Cenários no vencimento:** * Spot ≥ Strike: opção vira pó, você fica só com o prêmio (e os juros do caixa). * Spot \< Strike: você é exercido — compra as ações pelo strike (mais caro que o spot, mas com desconto via prêmio). **Tese:** entrada **com desconto** + prêmio mensal enquanto espera. *** ## O Que Vamos Construir ``` options-backtest/ ├── data.py # Carrega dados de underlying e opções ├── strategies.py # Implementa as estratégias ├── metrics.py # Sharpe, drawdown, returns ├── plot.py # Visualizações └── run.py # Pipeline principal ``` Período sugerido: **2 anos**, mensal, com PETR4 como underlying (sandbox grátis na brapi). *** ## Pré-requisitos ```bash mkdir options-backtest && cd options-backtest python -m venv .venv && source .venv/bin/activate pip install requests pandas numpy matplotlib python-dateutil export BRAPI_TOKEN="seu_token_pro" # opcional para PETR4 ``` *** ## Passo 1: Carregando Dados Históricos Precisamos de duas coisas: 1. **OHLCV diário do PETR4** durante o período (`/api/quote/PETR4?range=2y`) 2. **OHLCV das séries de opção** que vamos negociar (`/api/v2/options/historical`) ```python title="data.py" import os import requests from datetime import date import pandas as pd BRAPI_QUOTE = "https://brapi.dev/api/quote" BRAPI_OPTIONS = "https://brapi.dev/api/v2/options" TOKEN = os.getenv("BRAPI_TOKEN", "") HEADERS = {"Authorization": f"Bearer {TOKEN}"} if TOKEN else {} def load_underlying_history(ticker: str, range_: str = "2y") -> pd.DataFrame: """Carrega OHLCV diário do underlying.""" resp = requests.get( f"{BRAPI_QUOTE}/{ticker}", params={"range": range_, "interval": "1d"}, headers=HEADERS, timeout=60, ) resp.raise_for_status() data = resp.json()["results"][0].get("historicalDataPrice", []) df = pd.DataFrame(data) df["date"] = pd.to_datetime(df["date"], unit="s") return df.set_index("date").sort_index() def list_expirations(underlying: str, include_expired: bool = True) -> list[str]: """Vencimentos disponíveis (incluindo passados, para backtest).""" resp = requests.get( f"{BRAPI_OPTIONS}/expirations", params={"underlying": underlying, "includeExpired": str(include_expired).lower()}, headers=HEADERS, timeout=30, ) resp.raise_for_status() return resp.json()["expirations"] def get_chain_at_date( underlying: str, expiration_date: str, date_: str, side: str | None = None, ) -> list[dict]: """Cadeia de opções em uma data específica do passado.""" params = { "underlying": underlying, "expirationDate": expiration_date, "date": date_, } if side: params["side"] = side resp = requests.get(f"{BRAPI_OPTIONS}/chain", params=params, headers=HEADERS, timeout=30) resp.raise_for_status() return resp.json().get("series", []) def get_option_history(symbol: str, expiration_date: str) -> pd.DataFrame: """OHLCV diário de uma série de opção.""" resp = requests.get( f"{BRAPI_OPTIONS}/historical", params={"symbol": symbol, "expirationDate": expiration_date}, headers=HEADERS, timeout=60, ) resp.raise_for_status() payload = resp.json().get("option", {}) history = payload.get("history", []) df = pd.DataFrame(history) if df.empty: return df df["date"] = pd.to_datetime(df["date"], unit="s") return df.set_index("date").sort_index() ``` A API permite consulta histórica via `date=YYYY-MM-DD` em `/chain`, o que é exatamente o que um backtest precisa: "quais séries existiam e a que preço fechavam **naquela data**?" *** ## Passo 2: Identificando o Vencimento Mensal Precisamos rodar a estratégia mês a mês. Para isso, identificamos a primeira data de cada mês útil e o vencimento de opções **mais próximo** (geralmente terceira sexta-feira do mês): ```python title="data.py" from dateutil.relativedelta import relativedelta def monthly_open_dates(start: date, end: date) -> list[date]: """Lista o primeiro dia útil de cada mês no intervalo.""" out: list[date] = [] cursor = date(start.year, start.month, 1) while cursor <= end: # Avança até o primeiro dia útil do mês d = cursor while d.weekday() >= 5: # 5=sat, 6=sun d += relativedelta(days=+1) out.append(d) cursor = (cursor + relativedelta(months=+1)).replace(day=1) return out def pick_expiration_for_month( expirations: list[str], open_date: date, ) -> str | None: """Pega o próximo vencimento após a open_date.""" for exp_str in sorted(expirations): exp = date.fromisoformat(exp_str) if exp > open_date: return exp_str return None ``` *** ## Passo 3: Estratégia Covered Call ```python title="strategies.py" from dataclasses import dataclass, field import pandas as pd from data import ( load_underlying_history, list_expirations, get_chain_at_date, monthly_open_dates, pick_expiration_for_month, ) from datetime import date @dataclass class Trade: open_date: date close_date: date underlying_open_price: float strike: float premium_received: float underlying_close_price: float exercised: bool pnl: float # PnL da posição em opção (prêmio − recompra ou exercício) underlying_pnl: float # Variação do underlying no período total_pnl: float # Soma @dataclass class CoveredCallConfig: otm_pct: float = 0.05 # 5% acima do spot contract_size: int = 100 # 1 contrato = 100 ações min_trades_filter: int = 50 # Filtro mínimo de liquidez def run_covered_call( underlying: str, start: date, end: date, config: CoveredCallConfig, ) -> list[Trade]: underlying_df = load_underlying_history(underlying, range_="5y") expirations = list_expirations(underlying) trades: list[Trade] = [] for open_date in monthly_open_dates(start, end): # Spot na abertura try: spot = float(underlying_df.loc[pd.Timestamp(open_date)]["close"]) except KeyError: # Pega o pregão mais próximo spot = float(underlying_df.loc[underlying_df.index >= pd.Timestamp(open_date)].iloc[0]["close"]) # Vencimento alvo exp = pick_expiration_for_month(expirations, open_date) if exp is None: continue # Cadeia naquela data chain = get_chain_at_date( underlying=underlying, expiration_date=exp, date_=open_date.isoformat(), side="call", ) # Filtra strikes ≥ spot×(1+otm_pct), pega o menor (mais próximo do dinheiro mas ainda OTM) target_strike = spot * (1 + config.otm_pct) candidates = [ s for s in chain if s["strike"] >= target_strike and s["trades"] >= config.min_trades_filter and s.get("close") is not None ] if not candidates: continue chosen = min(candidates, key=lambda s: s["strike"]) # Preço de venda do prêmio: usa close do open_date (proxy aceitável de execução EOD) premium = float(chosen["close"]) # Spot no vencimento exp_date = date.fromisoformat(exp) try: close_spot = float(underlying_df.loc[underlying_df.index >= pd.Timestamp(exp_date)].iloc[0]["close"]) except IndexError: continue strike = float(chosen["strike"]) exercised = close_spot > strike # PnL da call vendida (você lucra se ela vira pó; perde se a paga acima do prêmio recebido no exercício) # Simplificação: se exercido, paga max(close_spot − strike, 0) a quem comprou if exercised: option_pnl = (premium - (close_spot - strike)) * config.contract_size # Underlying pnl: vc vendeu no strike (não no close_spot), então capture só até strike underlying_pnl = (strike - spot) * config.contract_size else: option_pnl = premium * config.contract_size underlying_pnl = (close_spot - spot) * config.contract_size trades.append(Trade( open_date=open_date, close_date=exp_date, underlying_open_price=spot, strike=strike, premium_received=premium, underlying_close_price=close_spot, exercised=exercised, pnl=option_pnl, underlying_pnl=underlying_pnl, total_pnl=option_pnl + underlying_pnl, )) return trades ``` *** ## Passo 4: Estratégia Cash-Secured Put ```python title="strategies.py" @dataclass class CashSecuredPutConfig: otm_pct: float = 0.05 contract_size: int = 100 min_trades_filter: int = 50 # Yield do caixa colocado em CDB / SELIC equivalente cash_yield_annual: float = 0.10 # 10% a.a. def run_cash_secured_put( underlying: str, start: date, end: date, config: CashSecuredPutConfig, ) -> list[Trade]: underlying_df = load_underlying_history(underlying, range_="5y") expirations = list_expirations(underlying) trades: list[Trade] = [] for open_date in monthly_open_dates(start, end): try: spot = float(underlying_df.loc[pd.Timestamp(open_date)]["close"]) except KeyError: spot = float(underlying_df.loc[underlying_df.index >= pd.Timestamp(open_date)].iloc[0]["close"]) exp = pick_expiration_for_month(expirations, open_date) if exp is None: continue chain = get_chain_at_date( underlying=underlying, expiration_date=exp, date_=open_date.isoformat(), side="put", ) target_strike = spot * (1 - config.otm_pct) # Pega a put OTM mais próxima do spot (strike ≤ target_strike, maior strike primeiro) candidates = [ s for s in chain if s["strike"] <= target_strike and s["trades"] >= config.min_trades_filter and s.get("close") is not None ] if not candidates: continue chosen = max(candidates, key=lambda s: s["strike"]) premium = float(chosen["close"]) strike = float(chosen["strike"]) exp_date = date.fromisoformat(exp) try: close_spot = float(underlying_df.loc[underlying_df.index >= pd.Timestamp(exp_date)].iloc[0]["close"]) except IndexError: continue exercised = close_spot < strike # Caixa rende no período days = (exp_date - open_date).days cash_pnl = strike * config.contract_size * config.cash_yield_annual * days / 365 if exercised: # Comprou no strike, mark-to-market no close_spot option_pnl = (premium - (strike - close_spot)) * config.contract_size else: option_pnl = premium * config.contract_size trades.append(Trade( open_date=open_date, close_date=exp_date, underlying_open_price=spot, strike=strike, premium_received=premium, underlying_close_price=close_spot, exercised=exercised, pnl=option_pnl, underlying_pnl=cash_pnl, # neste caso "underlying" é o caixa rendendo total_pnl=option_pnl + cash_pnl, )) return trades ``` *** ## Passo 5: Métricas de Performance ```python title="metrics.py" import numpy as np import pandas as pd from strategies import Trade def trades_to_returns(trades: list[Trade], capital_per_trade: float) -> pd.Series: """Converte trades em série temporal de retornos mensais (% sobre capital alocado).""" df = pd.DataFrame([ {"date": t.close_date, "pnl": t.total_pnl} for t in trades ]).set_index("date").sort_index() df["return"] = df["pnl"] / capital_per_trade return df["return"] def sharpe_ratio(returns: pd.Series, risk_free_monthly: float = 0.008) -> float: """Sharpe anualizado (assumindo retornos mensais).""" excess = returns - risk_free_monthly if excess.std() == 0: return 0.0 return float(excess.mean() / excess.std() * np.sqrt(12)) def max_drawdown(returns: pd.Series) -> float: """Maximum drawdown da curva de capital.""" equity = (1 + returns).cumprod() peak = equity.cummax() drawdown = (equity - peak) / peak return float(drawdown.min()) def cagr(returns: pd.Series) -> float: """CAGR a partir da série de retornos mensais.""" if returns.empty: return 0.0 total_return = (1 + returns).prod() n_years = len(returns) / 12 return float(total_return ** (1 / n_years) - 1) if n_years > 0 else 0.0 def summary(trades: list[Trade], capital_per_trade: float, label: str) -> dict: returns = trades_to_returns(trades, capital_per_trade) n_assigned = sum(1 for t in trades if t.exercised) return { "label": label, "trades": len(trades), "assignment_rate": n_assigned / len(trades) if trades else 0, "cagr": cagr(returns), "sharpe": sharpe_ratio(returns), "max_dd": max_drawdown(returns), "total_pnl": sum(t.total_pnl for t in trades), } ``` *** ## Passo 6: Pipeline Final ```python title="run.py" from datetime import date import pandas as pd from strategies import ( CoveredCallConfig, CashSecuredPutConfig, run_covered_call, run_cash_secured_put, ) from metrics import summary, trades_to_returns from data import load_underlying_history def buy_and_hold_returns(ticker: str, start: date, end: date) -> pd.Series: """Retornos mensais de buy-and-hold para comparação.""" df = load_underlying_history(ticker, range_="5y") monthly = df["close"].resample("MS").first() monthly = monthly[(monthly.index.date >= start) & (monthly.index.date <= end)] return monthly.pct_change().dropna() def main() -> None: underlying = "PETR4" start = date(2023, 5, 1) end = date(2025, 4, 30) print(f"Backtestando {underlying} de {start} até {end}\n") # 1) Covered Call cc_config = CoveredCallConfig(otm_pct=0.05) cc_trades = run_covered_call(underlying, start, end, cc_config) cc_summary = summary(cc_trades, capital_per_trade=100 * cc_trades[0].underlying_open_price, label="Covered Call OTM 5%") # 2) Cash-Secured Put csp_config = CashSecuredPutConfig(otm_pct=0.05) csp_trades = run_cash_secured_put(underlying, start, end, csp_config) csp_summary = summary(csp_trades, capital_per_trade=100 * csp_trades[0].underlying_open_price, label="Cash-Secured Put OTM 5%") # 3) Buy and Hold bh_returns = buy_and_hold_returns(underlying, start, end) bh_summary = { "label": "Buy and Hold", "trades": len(bh_returns), "assignment_rate": None, "cagr": (1 + bh_returns).prod() ** (12 / len(bh_returns)) - 1, "sharpe": (bh_returns.mean() / bh_returns.std()) * (12 ** 0.5) if bh_returns.std() > 0 else 0, "max_dd": float((((1 + bh_returns).cumprod() / (1 + bh_returns).cumprod().cummax()) - 1).min()), "total_pnl": None, } # 4) Resumo comparativo print(pd.DataFrame([cc_summary, csp_summary, bh_summary]).to_string(index=False)) if __name__ == "__main__": main() ``` *** ## Resultados Hipotéticos (Exemplo Ilustrativo) Rodando sobre PETR4 entre 2023-2025, você esperaria algo como: ``` label trades assignment_rate cagr sharpe max_dd Covered Call 5% 24 0.42 0.184 1.21 -0.08 Cash-Secured Put 5% 24 0.30 0.146 1.05 -0.06 Buy and Hold 24 NaN 0.221 0.78 -0.31 ``` **Leitura típica desses números:** * Buy-and-hold tem o **maior CAGR** mas o **maior drawdown**. * Covered Call entrega CAGR menor mas com **drawdown 4× menor** — Sharpe maior. * Cash-Secured Put fica entre os dois, com a vantagem de ter sempre caixa rendendo Selic. A pergunta correta não é "qual rendeu mais?" e sim "**dado meu apetite a risco, qual rendeu melhor por unidade de risco?**" — e é aí que Sharpe e drawdown brilham. **Os números acima são ilustrativos.** Rode o código com seu período e underlying. PETR4 num ciclo de alta de commodities terá comportamento bem diferente de IBOV num ciclo lateral. Generalizar uma estratégia a partir de um único backtest é o erro mais comum de quem está começando. *** ## Visualização Comparando curvas de capital: ```python title="plot.py" import matplotlib.pyplot as plt from metrics import trades_to_returns def plot_equity_curves(strategies: dict, output_path: str) -> None: """strategies: dict de label -> pd.Series de retornos mensais""" fig, ax = plt.subplots(figsize=(10, 6)) for label, returns in strategies.items(): equity = (1 + returns).cumprod() ax.plot(equity.index, equity.values, label=label, linewidth=2) ax.set_xlabel("Data") ax.set_ylabel("Capital normalizado (1.0 = início)") ax.set_title("Curvas de Capital — Estratégias com Opções vs Buy-and-Hold") ax.legend() ax.grid(True, alpha=0.3) fig.tight_layout() fig.savefig(output_path, dpi=120) print(f"Gráfico salvo em {output_path}") ``` *** ## Variações da Estratégia ### A) Strikes Mais Distantes (10% OTM) Reduz frequência de exercício mas o prêmio é menor. Ideal para mercados com tendência de alta forte. ```python cc_config = CoveredCallConfig(otm_pct=0.10) ``` ### B) Filtro por Volatilidade Implícita Você só vende a call se a IV estiver acima da mediana histórica: ```python def should_sell(implied_vol: float, threshold: float) -> bool: return implied_vol >= threshold ``` A API atual da brapi não retorna IV diretamente — você calcula via Black-Scholes invertido sobre o `close` da série. Veja a próxima evolução do tutorial em [Cadeia de Opções com Python](/blog/cadeia-opcoes-b3-python-tutorial-api-brapi). ### C) Rolagem em vez de Exercício Em vez de deixar a call ser exercida, recompre a call quando spot cruza o strike e venda outra mais para fora: ```python def maybe_roll(trade: Trade, current_spot: float, current_premium: float) -> Trade | None: """Recompra a call atual e abre uma nova com strike mais alto.""" # Implementação fica como exercício ... ``` ### D) Position Sizing por Volatilidade Ajuste o número de contratos com base na volatilidade do underlying — em momentos turbulentos, opera menos. *** ## Cuidados e Limitações Este backtest assume execução no `close` do dia. No mundo real, você paga spread bid-ask, corretagem e impostos. Estimativa conservadora: subtraia 0.5% a 1% do retorno bruto para chegar no líquido aproximado. Para PETR4 isso é tolerável; para opções menos líquidas, pode ser maior. PETR4 sobreviveu, é líquida e tem opções. Cuidado em generalizar para ações menores. Em um portfólio diversificado, faça o mesmo backtest em vários underlyings e olhe a média. Atualmente a bolsa brasileira tem opções com vencimento mensal e semanal. Este backtest usa o vencimento mais próximo, mas você pode adaptar `pick_expiration_for_month` para sempre selecionar o terceiro friday do mês (vencimento mensal padrão). Operações com opções têm tratamento tributário específico (15% para day-trade, 15% para operações comuns acima do limite de isenção, com recolhimento mensal via DARF). Consulte um contador para o cenário real. *** ## Indo Além A partir desse esqueleto, você pode evoluir para: * **Iron Condor / Spreads** — combinar 4 opções * **Volatility Smile** — backtestar entrada apenas quando IV ATM > histórica * **Opções sobre IBOV** — com `underlying=IBOV` (plano Pro) * **Cobertura dinâmica** (delta hedging) — recompra parcial quando delta excede limite *** ## Conclusão O backtest é o **filtro mais barato** que existe para separar boas estratégias de hipóteses caras. Em \~300 linhas de Python e o histórico aberto da brapi, você passa de "será que covered call funciona?" para uma resposta quantitativa **com seus parâmetros, no seu underlying, no seu período**. Comece com o código deste post, rode em PETR4 (sandbox grátis), depois evolua para outros tickers do plano Pro. Em poucas semanas você terá uma biblioteca pessoal de estratégias **medidas** — não chutadas. > **Próximos passos:** se você ainda não tem familiaridade com a cadeia de opções, leia primeiro o [tutorial de Cadeia de Opções de Ações Brasileiras com Python](/blog/cadeia-opcoes-b3-python-tutorial-api-brapi). Para entender a mecânica das estratégias, veja o [guia de Covered Call](/blog/dividendos-sinteticos-opcoes-covered-call-2026) e o [guia de Opções para Iniciantes](/blog/opcoes-b3-guia-completo-iniciantes-calls-puts). *Disclaimer: backtest não é promessa de retorno futuro. Opções têm risco de perda total ou superior ao capital. Estude e simule antes de operar com dinheiro real.* # Balanço Patrimonial 2025: Como Extrair e Analisar Dados via API URL: /blog/balanco-patrimonial-acoes.mdx Domine análise de balanço patrimonial! Tutorial completo: extrair dados via API brapi, analisar ativos/passivos e implementar em Python/JavaScript ✓ *** searchable: true title: 'Balanço Patrimonial 2025: Como Extrair e Analisar Dados via API' description: 'Domine análise de balanço patrimonial! Tutorial completo: extrair dados via API brapi, analisar ativos/passivos e implementar em Python/JavaScript ✓' date: '2025-08-22' keywords: 'balanço patrimonial, API brapi, Python JavaScript, ativos passivos, patrimônio líquido, análise financeira, IBovespa, bolsa brasileira, dados financeiros, brapi' author: 'Equipe brapi.dev' category: 'Análise Financeira e APIs' subcategory: 'Tutoriais Técnicos' readingTime: '19 min' tags: \['Balanço Patrimonial', 'API', 'Python', 'JavaScript', 'Bolsa Brasileira', 'Análise Financeira', 'Tutorial'] relatedPosts: \['demonstrativos-financeiros-um-olhar-detalhado-na-saude-financeira-da-empresa', 'b3-api-gratuita-como-usar-cotacoes', 'analise-financeira-com-modulo-balance-sheet-history'] featured: true expertise: 'Análise de balanços e desenvolvimento de APIs financeiras com 8+ anos de experiência' lastReviewed: 2026-01-03 howToSteps: * name: 'Compreender a estrutura do balanço patrimonial' text: 'Estude os componentes principais: ativos (circulantes e não-circulantes), passivos (circulantes e não-circulantes) e patrimônio líquido.' * name: 'Configurar ambiente de desenvolvimento' text: 'Configure Python ou JavaScript com as bibliotecas necessárias (requests, axios) e obtenha seu token da API brapi.dev.' * name: 'Fazer requisição ao módulo balanceSheetHistory' text: 'Execute a chamada à API usando GET [https://brapi.dev/api/quote/TICKER?modules=balanceSheetHistory](https://brapi.dev/api/quote/TICKER?modules=balanceSheetHistory) com o header Authorization: Bearer SEU\_TOKEN' * name: 'Extrair dados de ativos' text: 'Parse os campos: cash, shortTermInvestments, netReceivables, inventory, totalCurrentAssets, propertyPlantEquipment, totalAssets.' * name: 'Extrair dados de passivos' text: 'Parse os campos: accountsPayable, shortLongTermDebt, totalCurrentLiabilities, longTermDebt, totalLiabilities.' * name: 'Calcular indicadores de liquidez' text: 'Use os dados extraídos para calcular liquidez corrente (ativos circulantes / passivos circulantes) e outros indicadores de solvência.' * name: 'Analisar evolução histórica' text: 'Compare dados de diferentes períodos para identificar tendências de crescimento, endividamento ou melhoria na estrutura de capital.' howToTools: * 'API brapi.dev' * 'Python com requests' * 'JavaScript com axios/fetch' * 'IDE ou editor de código' howToSupplies: * 'Token de acesso brapi.dev' * 'Ticker da empresa (ex: BBDC3, PETR4)' * 'Documentação da API brapi' * 'Conhecimento básico de contabilidade' *** import { Author, Authors } from '~/components/Authors'; > Desvende o mundo da análise financeira das empresas listadas na IBovespa com a > API brapi. Este guia detalhado é o seu aliado para desvendar ativos, passivos > e patrimônio líquido, um recurso indispensável para investidores decidirem com > sabedoria. *** ## Comece Aqui Quer ir direto ao que interessa? [Clique aqui](#implementando-o-balancesheethistory) e confira o código. O entendimento da saúde financeira das empresas é vital para investidores. Neste guia, não só explicaremos a importância dessa análise, mas também como usar o módulo `balanceSheetHistory` da API brapi, que fornece dados financeiros do mercado brasileiro. ### A Importância da Análise Financeira Fazer escolhas de investimento inteligentes passa por entender a condição financeira das empresas. Este guia sublinha a importância desta prática no ambiente econômico de hoje. ### Módulo em Foco O `balanceSheetHistory` é uma ferramenta poderosa dentro da API brapi para análise financeira. Aqui, você vai encontrar tudo sobre sua Documentação da API brapi e como usá-la para acessar dados históricos de ativos, passivos e patrimônio líquido, essenciais para quem investe. Esses são os dados que a API da brapi fornece para o módulo `balanceSheetHistory`: | Campo | Tradução | Descrição | | ---------------------------- | ------------------------------- | ------------------------------------------------------------------------------- | | endDate | Data de encerramento | A data em que o balanço patrimonial foi encerrado. | | cash | Caixa e equivalentes | Quantidade de dinheiro e equivalentes de caixa. | | shortTermInvestments | Investimentos a curto prazo | Investimentos que podem ser facilmente convertidos em dinheiro em curto prazo. | | netReceivables | Contas a receber | Valor total das vendas ou serviços que a empresa tem direito a receber. | | inventory | Estoques | Valor total dos bens mantidos para venda. | | otherCurrentAssets | Outros ativos circulantes | Outros ativos que podem ser convertidos em dinheiro dentro de um ano. | | totalCurrentAssets | Total de ativos circulantes | Soma de todos os ativos de curto prazo. | | longTermInvestments | Investimentos a longo prazo | Investimentos que não serão convertidos em dinheiro no curto prazo. | | propertyPlantEquipment | Imobilizado | Valor total dos ativos físicos a longo prazo, como edifícios e maquinários. | | goodWill | Goodwill | Valor contábil de uma empresa acima do valor de seus ativos tangíveis. | | intangibleAssets | Ativos intangíveis | Valor dos ativos que não têm presença física, como patentes. | | otherAssets | Outros ativos fixos | Ativos não circulantes que não se encaixam nas categorias anteriores. | | deferredLongTermAssetCharges | Ativos diferidos a longo prazo | Despesas pré-pagas que beneficiarão a empresa a longo prazo. | | totalAssets | Total de ativos | Soma total de todos os ativos da empresa. | | accountsPayable | Fornecedores | Dinheiro que a empresa deve a seus fornecedores por bens ou serviços recebidos. | | shortLongTermDebt | Dívidas a curto e longo prazo | Total de todas as dívidas, tanto de curto quanto de longo prazo. | | otherCurrentLiab | Outros passivos a curto prazo | Outros passivos que devem ser liquidados em um ano. | | longTermDebt | Dívidas a longo prazo | Dívidas que a empresa tem que não precisam ser pagas no próximo ano. | | otherLiab | Outros passivos a longo prazo | Outros passivos que não serão liquidados em um ano. | | minorityInterest | Participações minoritárias | Interesses de acionistas minoritários nos ativos líquidos da empresa. | | totalCurrentLiabilities | Total de passivos a curto prazo | Total dos passivos que a empresa precisa liquidar no próximo ano. | | totalLiab | Total de passivos | Total de todos os passivos da empresa. | | commonStock | Capital social | Valor do capital recebido pela empresa pela emissão de ações. | | retainedEarnings | Lucros acumulados | Lucros que a empresa reteve e não distribuiu como dividendos. | | treasuryStock | Ações em tesouraria | Ações que foram recompradas pela empresa e estão em seu poder. | | otherStockholderEquity | Outros patrimônios líquidos | Outros itens que contribuem para o patrimônio líquido total dos acionistas. | | totalStockholderEquity | Total do patrimônio líquido | Total do patrimônio dos acionistas, que é a diferença entre ativos e passivos. | | netTangibleAssets | Ativos tangíveis líquidos | Ativos tangíveis menos passivos e intangíveis como goodwill. | ### Propósito do Guia Este guia visa esclarecer o uso do `balanceSheetHistory` e da API brapi para análise financeira, incluindo dados de mercado, APIs B, WebServices da IBovespa e métodos como Web Scraping e Python. Ao terminar, você estará pronto para aplicar esses dados em decisões estratégicas de investimento. Vamos explorar o uso do módulo com exemplos práticos, fornecendo um guia completo para acessar e interpretar dados financeiros do mercado. ## Dominando o balanceSheetHistory Aqui, detalharemos o módulo `balanceSheetHistory`, mostrando sua funcionalidade e os dados que oferece. Além disso, daremos dicas de como navegar pelo módulo e usar essas informações a seu favor. ### O que o Módulo Faz O `balanceSheetHistory` é essencial para acessar dados financeiros das empresas na bolsa. Ele fornece detalhes sobre ativos, passivos e patrimônio líquido ao longo do tempo, ajudando investidores a fazer escolhas bem-informadas. A brapi entrega dados anuais em JSON, acessíveis através do endpoint `https://brapi.dev/api/quote/TICKER_DA_EMPRESA?modules=balanceSheetHistory` com o header `Authorization: Bearer SEU_TOKEN`, substituindo TICKER\_DA\_EMPRESA e SEU\_TOKEN pelas informações corretas. ### Informações Disponibilizadas O módulo oferece uma série de dados financeiros, incluindo: * Data de encerramento * Caixa e equivalentes * Investimentos a curto prazo * Contas a receber * Estoques * Outros ativos circulantes * Total de ativos circulantes * Investimentos a longo prazo * Imobilizado * Goodwill * Ativos intangíveis * Outros ativos fixos * Ativos diferidos a longo prazo * Total de ativos * Fornecedores * Dívidas a curto e longo prazo * Outros passivos a curto prazo * Dívidas a longo prazo * Outros passivos a longo prazo * Participações minoritárias * Total de passivos a curto prazo * Total de passivos * Capital social * Lucros acumulados * Ações em tesouraria * Outros patrimônios líquidos * Total do patrimônio líquido * Ativos tangíveis líquidos ### Compreendendo os Dados Entender os termos como Ativos Circulantes, Ativos a Longo Prazo, Passivos a Curto Prazo, Passivos a Longo Prazo e Patrimônio Líquido é crucial. Cada um oferece uma visão da condição financeira da empresa, indo além de simples números. ### Navegando pelo Módulo Exploraremos como fazer solicitações usando JavaScript, Python e cURL, e também como interpretar as respostas do endpoint. No final deste segmento, você terá um entendimento claro do `balanceSheetHistory` e como usá-lo em análises financeiras. ## Implementando o balanceSheetHistory Vamos pôr a teoria em prática, mostrando como usar o `balanceSheetHistory` em diferentes linguagens de programação. Esta seção é dedicada a explicar como obter dados financeiros vitais através do módulo. ### Criando Sua Conta na brapi Criar uma conta é simples. Basta [clicar aqui](https://brapi.dev/dashboard) e seguir os passos. ### Gerando um Token de Acesso Com sua conta pronta, crie um token e copie-o. É simples e rápido. ### Requisições com JavaScript Aqui, mostramos como fazer uma requisição em JavaScript para o endpoint mencionado: ```javascript // Exemplo em JavaScript const url = 'https://brapi.dev/api/quote/PETR?modules=balanceSheetHistory'; fetch(url, { headers: { 'Authorization': 'Bearer SEU_TOKEN' } }) .then((response) => response.json()) .then((data) => { // Trate os dados aqui console.log(data); }) .catch((error) => { console.error('Erro na requisição:', error); }); ``` ### Requisições com Python Para Python, o processo é igualmente direto: ```typescript const response = await fetch( 'https://brapi.dev/api/quote/PETR4?modules=balanceSheetHistory', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const { results } = await response.json() // results[0].balanceSheetHistory contém os dados do balanço ``` ### Usando cURL Para quem prefere a linha de comando, segue um exemplo com cURL: ```bash # Exemplo com cURL curl -H "Authorization: Bearer SEU_TOKEN" 'https://brapi.dev/api/quote/PETR?modules=balanceSheetHistory' ``` ### Análise da Resposta Ao solicitar dados do endpoint, você receberá um JSON com as informações. A seguir, um exemplo de resposta com dados da Petrobras (PETR4): *Resposta do endpoint:* ```json { // ... outros dados "balanceSheetHistory": { "balanceSheetStatements": [ { "endDate": "2022-12-31T00:00:00.000Z", // Data de encerramento "cash": 41723000000, // Caixa "shortTermInvestments": 14470000000, // Investimentos de curto prazo "netReceivables": 32961000000, // Contas a receber "inventory": 45804000000, // Inventário "otherCurrentAssets": 28094000000, // Outros ativos circulantes "totalCurrentAssets": 163052000000, // Total de ativos circulantes "longTermInvestments": 16331000000, // Investimentos de longo prazo "propertyPlantEquipment": 679182000000, // Propriedade, planta e equipamentos "goodWill": 123000000, // Goodwill "intangibleAssets": 15458000000, // Ativos intangíveis "otherAssets": 102563000000, // Outros ativos "deferredLongTermAssetCharges": 4342000000, // Ativos diferidos de longo prazo "totalAssets": 976709000000, // Total de ativos "accountsPayable": 28507000000, // Contas a pagar "shortLongTermDebt": 18656000000, // Dívida de curto e longo prazo "otherCurrentLiab": 60989000000, // Outros passivos circulantes "longTermDebt": 137630000000, // Dívida de longo prazo "otherLiab": 215540000000, // Outros passivos "minorityInterest": 1791000000, // Participação minoritária "totalCurrentLiabilities": 163731000000, // Total de passivos circulantes "totalLiab": 612324000000, // Total de passivos "commonStock": 205432000000, // Ações ordinárias "retainedEarnings": 128562000000, // Lucros retidos "treasuryStock": 28600000000, // Ações em tesouraria "otherStockholderEquity": 28600000000, // Outros patrimônios dos acionistas "totalStockholderEquity": 362594000000, // Total do patrimônio dos acionistas "netTangibleAssets": 347013000000 // Ativos tangíveis } // + outros anos ou trimestres ] } } ``` ## Análise dos Dados de Balanço Compreender os dados do balanço é vital para analisar a saúde financeira de uma empresa. Discutiremos cada elemento chave do balanço, oferecendo insights para decisões de investimento. ### Ativos Circulantes Os ativos circulantes são a liquidez de curto prazo da empresa. A composição desses ativos, como dinheiro em caixa e estoques, revela a capacidade de cumprir obrigações imediatas. ### Ativos a Longo Prazo Os ativos a longo prazo são os investimentos que gerarão retorno futuro. Itens como imobilizado e investimentos de longo prazo são cruciais para o crescimento sustentável. ### Passivos Circulantes Os passivos circulantes são as dívidas e obrigações de curto prazo. Analisar estes dados ajuda a avaliar se a empresa pode enfrentar suas responsabilidades iminentes. ### Passivos a Longo Prazo Estudar os passivos a longo prazo, como empréstimos e outras dívidas, é essencial para entender a estratégia de financiamento da empresa e sua saúde financeira a longo prazo. ### Patrimônio Líquido O patrimônio líquido é o valor da empresa que pertence aos acionistas após quitar as dívidas. Analisar o capital social e os lucros acumulados mostra a solidez financeira e a gestão dos recursos. Entendendo esses conceitos, investidores podem fazer escolhas informadas, alinhando suas estratégias de investimento aos seus objetivos e tolerância ao risco. ## Perguntas Comuns ### Como Avaliar o Total de Ativos? Avaliar o total de ativos envolve entender a distribuição entre ativos correntes e fixos, e como esses valores evoluem ao longo do tempo. Compare também com empresas similares para uma análise contextual. ### O Que São Ativos Tangíveis Líquidos? Ativos Tangíveis Líquidos são ativos físicos menos as dívidas. Essa métrica ajuda a entender o valor real dos ativos que a empresa pode utilizar. ### Como Usar Estes Dados na Tomada de Decisões? Use os dados para apoiar decisões de investimento, observando não só os números, mas também tendências e comparações setoriais. Combine análises financeiras com avaliações qualitativas do mercado e da economia. Com estas informações, investidores e analistas podem extrair insights valiosos para decisões bem fundamentadas e alinhadas com metas de longo prazo. ### Avaliando a Liquidez e a Solvência A liquidez e a solvência são aspectos cruciais na análise financeira. A liquidez refere-se à capacidade da empresa de cumprir suas obrigações de curto prazo, enquanto a solvência é a capacidade de atender a compromissos de longo prazo. Ambas as métricas podem ser avaliadas através do balanço patrimonial, observando-se as razões entre ativos e passivos circulantes, bem como entre o patrimônio líquido e as dívidas de longo prazo. ### Rentabilidade e Eficiência Operacional Além dos elementos do balanço, é importante considerar a rentabilidade e a eficiência operacional da empresa. Isso inclui analisar a margem de lucro, o retorno sobre ativos (ROA) e o retorno sobre o patrimônio líquido (ROE). Esses indicadores dão uma ideia de quão bem a empresa está usando seus recursos para gerar lucro. ### Integração de Dados e Tendências Ao interpretar dados financeiros, é crucial não só olhar para os números absolutos, mas também para as tendências ao longo do tempo. Isso inclui mudanças nos níveis de dívida, crescimento dos ativos e evolução do patrimônio líquido. Também é importante integrar esses dados com informações de mercado, notícias e análises setoriais para obter uma visão mais completa. ## Conclusão O módulo `balanceSheetHistory` e a API brapi oferecem ferramentas valiosas para investidores e analistas financeiros buscarem dados relevantes de empresas listadas na Bovespa. Ao entender como acessar e interpretar esses dados, você pode fazer avaliações mais precisas da saúde financeira de uma empresa e tomar decisões de investimento com maior confiança. ### Continuando a Aprendizagem Este guia é apenas o começo. Investidores que buscam aprofundar seus conhecimentos devem continuar a explorar outras áreas da análise financeira, como a análise de fluxo de caixa, avaliação de riscos e estratégias de diversificação de portfólio. ### Mantendo-se Atualizado O mercado financeiro está em constante evolução, e a tecnologia continua a abrir novas portas para a análise de dados. Mantenha-se atualizado com as últimas tendências em ferramentas de análise financeira, regulamentações do mercado e mudanças econômicas que podem impactar suas estratégias de investimento. ### Construindo uma Rede de Recursos Por fim, construir uma rede de recursos confiáveis, incluindo plataformas de dados financeiros, consultorias especializadas e comunidades de investidores, pode ser um grande ativo. Compartilhar insights e estratégias com outros profissionais pode enriquecer sua compreensão do mercado e aprimorar suas habilidades de análise. Ao seguir estas orientações e utilizar as ferramentas disponíveis, você estará bem equipado para explorar o vasto universo dos dados financeiros e navegar no mercado de ações com maior segurança e eficácia. ### Aprofundando a Análise Setorial Para uma análise ainda mais precisa, é fundamental mergulhar nos detalhes setoriais. Cada indústria tem suas próprias métricas e fatores-chave de sucesso. Por exemplo, o setor de varejo pode ser intensamente analisado através do giro de estoque e da margem de lucro líquido, enquanto o setor financeiro pode ser mais bem compreendido por meio de indicadores como o índice de Basileia e a margem financeira. ### Explorando Dados Históricos e Projeções Futuras Os dados históricos fornecem um panorama do desempenho passado de uma empresa, mas é igualmente importante considerar as projeções futuras. Isso envolve analisar relatórios de analistas, projeções de mercado e estratégias empresariais anunciadas. Combinar dados retrospectivos com expectativas futuras pode ajudar a identificar empresas com potencial de crescimento a longo prazo. ### Técnicas Avançadas de Análise Investidores mais experientes podem se beneficiar da aplicação de técnicas avançadas como análise de regressão, modelagem preditiva e machine learning para antever tendências de mercado e comportamento de preços. Essas técnicas podem ser usadas para complementar a análise tradicional do balanço patrimonial, proporcionando uma vantagem competitiva no mercado. ### Diversificação e Gerenciamento de Risco A análise de balanço é um componente chave para construir um portfólio diversificado e gerenciar o risco. Investidores devem considerar como as informações obtidas se encaixam em uma estratégia de investimento mais ampla, levando em conta a correlação entre diferentes ativos e classes de ativos para mitigar a exposição a riscos específicos do mercado. ### A Importância da Educação Financeira Contínua A educação financeira é um processo contínuo. Participar de seminários, cursos e workshops pode ajudar a manter as habilidades afiadas e a compreensão atualizada. Além disso, seguir publicações financeiras respeitadas e manter-se informado sobre as últimas notícias pode ajudar a interpretar melhor os dados e fazer escolhas de investimento mais informadas. ### Utilizando Ferramentas e Recursos Ferramentas e plataformas online, como a brapi, são recursos valiosos que oferecem acesso a uma ampla gama de dados financeiros. Ferramentas de visualização de dados e plataformas de análise técnica também podem oferecer insights adicionais e facilitar a interpretação de dados complexos. ### Envolvimento na Comunidade Conectar-se com outros investidores e profissionais do mercado pode ser extremamente benéfico. Fóruns online, grupos de investimento e redes sociais oferecem oportunidades para discutir estratégias, trocar ideias e obter novos pontos de vista sobre o mercado. ### Conclusão Ao adotar uma abordagem holística para a análise financeira, que combina os dados do balanço patrimonial com um entendimento mais profundo do ambiente de mercado e técnicas analíticas avançadas, você pode tomar decisões de investimento com um grau de confiança e conhecimento que vai muito além dos números básicos. Lembre-se de que no mundo das finanças, o aprendizado nunca termina e estar bem informado é a chave para o sucesso a longo prazo. # Base, Arbitrum e Optimism: A Guerra das Layer 2 em 2026 URL: /blog/base-arbitrum-optimism-layer2-comparativo-2026.mdx Comparativo completo das maiores Layer 2 do Ethereum: Base (Coinbase), Arbitrum (ARB) e Optimism (OP). Qual é a melhor para DeFi, Gaming e Investimento em 2026? *** searchable: true title: 'Base, Arbitrum e Optimism: A Guerra das Layer 2 em 2026' description: 'Comparativo completo das maiores Layer 2 do Ethereum: Base (Coinbase), Arbitrum (ARB) e Optimism (OP). Qual é a melhor para DeFi, Gaming e Investimento em 2026?' date: '2025-12-31' keywords: 'base coinbase token, arbitrum ou optimism, melhores layer 2 2026, op stack, arbitrum orbit, base chain brasil, investir em l2' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Criptomoedas' readingTime: '20 min' tags: \['Layer 2', 'Ethereum', 'Base', 'Arbitrum', 'Optimism', 'DeFi'] relatedPosts: \['ethereum-eth-guia-completo-brasil-2026', 'polygon-pol-matic-guia-completo-2026', 'carteiras-criptomoedas-guia-seguranca-2026'] featured: true expertise: 'Comparativo técnico e de ecossistema das principais soluções de escalabilidade do Ethereum' lastReviewed: '2026-01-12' -------------------------- import { Authors, Author } from '~/components/Authors'; Em 2026, ninguém mais discute se o Ethereum é lento ou caro. A resposta é: "use uma Layer 2". As redes de segunda camada (L2) dominaram o ecossistema, processando 10x mais transações que a rede principal do Ethereum. Mas para o usuário e investidor, surgiu um novo problema: **qual L2 escolher?** As três gigantes — **Arbitrum, Optimism e Base** — lutam pela supremacia da liquidez e dos usuários. Neste artigo, comparamos as tecnologias, ecossistemas e potenciais de investimento de cada uma. *** ## O Que Elas Têm em Comum? (Optimistic Rollups) Todas as três (atualmente) usam a tecnologia de **Optimistic Rollups**. * **Como funciona:** Elas processam milhares de transações fora do Ethereum (rápido e barato), compactam os dados e enviam um "resumo" para o Ethereum. * **"Otimista":** Elas assumem que as transações são válidas. Se alguém discordar, há um período de desafio (geralmente 7 dias) para provar a fraude. É isso que garante a segurança herdada do Ethereum. *** ## 1. Arbitrum (ARB): A Rainha do DeFi A Arbitrum (desenvolvida pela Offchain Labs) manteve sua liderança como a rede com maior TVL (Total Value Locked) em DeFi. ### Destaques em 2026 * **Arbitrum One:** A rede principal, lar de gigantes do DeFi como GMX, Pendle e Uniswap. É onde está o "dinheiro grande". * **Arbitrum Nova:** Uma rede focada em ultra-baixo custo para gaming e redes sociais (Reddit usa esta). * **Arbitrum Orbit:** Tecnologia que permite lançar L3s (Layer 3) personalizadas em cima da Arbitrum. * **Stylus:** Permite escrever contratos inteligentes em linguagens como Rust e C++, não apenas Solidity, atraindo devs da Solana. ### O Token ARB * **Utilidade:** Governança da Arbitrum DAO. * **Análise:** O token sofreu em 2024/25 com grandes desbloqueios (unlocks), mas a rede gera receita real massiva. A DAO é uma das mais ricas do ecossistema. *** ## 2. Optimism (OP): A Visão da Superchain A Optimism não quer ser apenas uma blockchain; quer ser o padrão para todas as blockchains. Eles criaram a **OP Stack**, um kit de desenvolvimento open-source. ### A Tese da Superchain A ideia é que centenas de cadeias usem o código da OP Stack. Elas formariam uma "Superchain" interoperável. * **Quem usa OP Stack?** Base (Coinbase), Worldcoin, Zora, Debank. * **Modelo de Negócio:** Parte das receitas dessas cadeias parceiras volta para o Tesouro da Optimism. É um modelo de "franquia". ### O Token OP * **Utilidade:** Governança e financiamento retroativo (RetroPGF). * **Análise:** O valor do OP depende do sucesso da tese da Superchain. Se a Base cresce, a Optimism ganha (indiretamente). *** ## 3. Base: A Gigante Corporativa (Coinbase) Lançada pela **Coinbase** (maior exchange dos EUA) usando a tecnologia da Optimism (OP Stack), a **Base** foi o fenômeno de 2024/2026. ### O Diferencial "Coinbase" * **Onboarding:** A Coinbase tem 100 milhões de usuários verificados (KYC). Com a Smart Wallet, eles podem entrar na Base sem anotar seed phrases, usando apenas FaceID. * **SocialFi e Memecoins:** A Base se tornou o lar de aplicativos sociais (como Farcaster) e da nova onda de memecoins, competindo com a Solana. * **Sem Token?** Até 2026, a Coinbase manteve a postura de **NÃO ter um token nativo**. As taxas são pagas em ETH. * *Nota:* Isso elimina o risco regulatório, mas tira a especulação de investimento direto. A forma de "apostar" na Base é comprando ações da Coinbase (COIN) ou ETH. *** ## Comparativo Rápido 2026 | Característica | Arbitrum (One) | Optimism (OP Mainnet) | Base | | ------------------ | ----------------------------------- | ------------------------- | ----------------------------- | | **Token Nativo** | ARB | OP | Nenhum (Usa ETH) | | **Foco Principal** | DeFi Hardcore, Derivativos | Governança, Bens Públicos | Varejo, Social, Consumer Apps | | **Tecnologia** | Nitro (L3s Orbit, Stylus) | OP Stack (Superchain) | OP Stack (Superchain) | | **TVL (Liquidez)** | ⭐⭐⭐⭐⭐ (Líder) | ⭐⭐⭐ | ⭐⭐⭐⭐ (Crescimento rápido) | | **Taxas** | Baixas (Centavos) | Baixas (Centavos) | Baixas (Centavos) | | **Segurança** | Stage 2 (Descentralização avançada) | Stage 1 | Stage 0/1 (Mais centralizada) | *** ## Qual Escolher para Investir? ### Para Usar (Usuário) * **Gosta de DeFi complexo e alavancagem?** Vá de **Arbitrum**. * **Quer brincar com Apps Sociais e NFTs novos?** Vá de **Base**. * **Quer participar de governança experimental?** Vá de **Optimism**. ### Para Investir (Token) * **ARB:** É uma aposta no ecossistema DeFi mais robusto. Se o DeFi cresce, a Arbitrum captura valor via taxas de sequenciador (embora o token seja só governança, a DAO acumula valor). * **OP:** É uma aposta na tese de "SaaS Blockchain". Se a Superchain virar o padrão da indústria, o OP se torna um ativo de governança de um império. * **ETH:** A aposta mais segura. Todas essas redes pagam aluguel (segurança) para o Ethereum em ETH. Se as L2s crescem, o ETH queima e valoriza. *** ## O Risco das ZK-Rollups (A Ameaça Fantasma) Arbitrum, Optimism e Base são **Optimistic Rollups**. O futuro, porém, pode ser dos **ZK-Rollups** (como zkSync, Starknet, Polygon zkEVM), que são matematicamente mais seguros e têm finalidade instantânea (sem esperar 7 dias para saque). Em 2026, tanto Arbitrum quanto Optimism estão pesquisando formas de migrar ou integrar provas ZK em seus sistemas híbridos. A guerra tecnológica não acabou. *** ## Conclusão Em 2026, o Ethereum escalou com sucesso através dessas redes. * **Base** trouxe o varejo. * **Arbitrum** segurou o DeFi. * **Optimism** criou o padrão de arquitetura. Para o investidor brasileiro, usar essas redes é essencial para fugir das taxas altas da Mainnet. E para investir, a diversificação entre ARB, OP e principalmente ETH (o "pai" de todos) continua sendo a estratégia mais sensata. *** ## Recursos Adicionais * **[Polygon (ZK) vs Optimistic Rollups](/blog/polygon-pol-matic-guia-completo-2026)** * **[Como usar a Carteira MetaMask](/blog/carteiras-criptomoedas-guia-seguranca-2026)** * **[O que é DeFi?](/blog/defi-financas-descentralizadas-guia-iniciantes-2026)** *Disclaimer: Criptoativos são voláteis. Analise os fundamentos antes de investir.* # BDRs em 2026: Guia Completo para Investir em Empresas Americanas do Brasil URL: /blog/bdrs-guia-completo-investir-empresas-americanas-2026.mdx Aprenda tudo sobre BDRs! Como investir em Apple, Google, Amazon pela bolsa brasileira. Tributação, custos e melhores BDRs 2026 ✓ *** searchable: true title: 'BDRs em 2026: Guia Completo para Investir em Empresas Americanas do Brasil' description: 'Aprenda tudo sobre BDRs! Como investir em Apple, Google, Amazon pela bolsa brasileira. Tributação, custos e melhores BDRs 2026 ✓' date: '2026-01-01' keywords: 'BDR, brazilian depositary receipt, investir empresas americanas, como comprar BDR, BDR Apple, BDR Google, BDR Amazon, investir exterior Brasil, AAPL34, GOGL34, AMZO34, 2026' author: 'Equipe brapi.dev' category: 'Investimentos Internacionais' subcategory: 'BDRs' readingTime: '25 min' tags: \['BDR', 'Investimento Internacional', 'Ações Americanas', 'Diversificação', 'Bolsa Brasileira', 'Apple', 'Google', 'Amazon'] relatedPosts: \['etfs-irlandeses-brasileiros-vwra-swrd-eimi', 'guia-bogleheads-brasil-investimento-passivo-etfs', 'como-declarar-investimentos-imposto-renda-2026', 'bdrs-guia-completo-investir-empresas-americanas-2026', 'etfs-brasil-guia-completo-bova11-ivvb11'] featured: true expertise: 'Investimento internacional através de BDRs na bolsa brasileira' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > Quer investir em Apple, Google, Amazon e outras gigantes globais sem abrir conta no exterior? Os BDRs permitem isso diretamente pela bolsa brasileira. Este guia completo explica tudo: como funcionam, tributação, custos e os melhores BDRs para 2026. *** ## O Que São BDRs? **BDR (Brazilian Depositary Receipt)** é um certificado que representa ações de empresas estrangeiras, negociado na bolsa brasileira em reais. ### O Que é um BDR | Aspecto | Descrição | | ---------------- | ------------------------------------------- | | **Definição** | Certificado lastreado em ações estrangeiras | | **Onde negocia** | Bolsa brasileira | | **Moeda** | Reais (R$) | | **Horário** | 10h às 17h (horário de Brasília) | | **Custodiante** | Banco depositário no Brasil | | **Lastro** | Ações custodiadas no exterior | **Exemplo:** AAPL34 representa ações da Apple (AAPL), onde 1 BDR = fração de 1 ação Apple ### Como Funciona na Prática | Etapa | O Que Acontece | | ------------- | ------------------------------------------------ | | 1. Compra | Você compra AAPL34 na bolsa brasileira em reais | | 2. Custódia | Banco depositário mantém ações Apple no exterior | | 3. Lastro | Seu BDR representa fração dessas ações | | 4. Dividendos | Recebe em reais (já convertido) | | 5. Venda | Vende na bolsa brasileira em reais | *** ## Tipos de BDRs ### BDRs Patrocinados A própria empresa estrangeira participa da emissão. | Nível | Características | Exemplos | | ------------- | ------------------------------------ | ---------------- | | **Nível I** | Mercado de balcão, menos regulação | Maioria dos BDRs | | **Nível II** | Listado em bolsa, mais transparência | Poucos casos | | **Nível III** | Oferta pública, máxima regulação | Raros | ### BDRs Não Patrocinados Emitidos por instituição depositária sem participação da empresa. **Diferenças entre tipos:** | Tipo | Emissor | Regulação | Informações | Exemplos | | ------------------- | ------------------------------- | ------------------- | ---------------------------- | -------------------------------- | | **Patrocinado** | Empresa estrangeira participa | Maior transparência | Empresa divulga no Brasil | Poucos casos | | **Não Patrocinado** | Banco depositário emite sozinho | Menor exigência | Investidor busca no exterior | AAPL34, GOGL34, AMZO34 (maioria) | *** ## Vantagens e Desvantagens dos BDRs ### Vantagens | Vantagem | Descrição | | ---------------------- | -------------------------------------------------------- | | **Simplicidade** | Compra direto na bolsa brasileira, sem conta no exterior | | **Moeda local** | Opera em reais | | **Tributação simples** | IR retido na fonte para dividendos | | **Diversificação** | Acesso a empresas globais | | **Sem IOF** | Não paga IOF de remessa | | **Declaração fácil** | Informa como ativo brasileiro | ### Desvantagens | Desvantagem | Descrição | | ------------------------- | ------------------------------------------ | | **Spread cambial** | Conversão pode ter custo embutido | | **Taxa de custódia** | Alguns BDRs têm taxa (3-5% dos dividendos) | | **Liquidez menor** | Volume menor que ação original | | **Horário limitado** | Só negocia no horário da bolsa brasileira | | **Proporção fracionária** | 1 BDR ≠ 1 ação (pode ser fração) | *** ## Como Investir em BDRs ### Passo a Passo | Passo | Ação | Detalhe | | ----- | ------------------------ | ----------------------------------------------------- | | 1 | Abrir conta em corretora | Qualquer corretora brasileira (XP, Clear, Rico, etc.) | | 2 | Transferir recursos | TED ou PIX para a conta da corretora | | 3 | Pesquisar o BDR | Buscar pelo código (ex: AAPL34, GOGL34) | | 4 | Analisar | Verificar cotação, proporção e histórico | | 5 | Enviar ordem | Ordem de compra no home broker | | 6 | Aguardar liquidação | D+2 (dois dias úteis) | ### Códigos dos BDRs Os BDRs seguem o padrão: **\[CÓDIGO]34** ou **\[CÓDIGO]35** | Sufixo | Significado | | ------ | --------------------------- | | **34** | BDR Não Patrocinado Nível I | | **35** | BDR Patrocinado Nível II | | **33** | BDR Patrocinado Nível III | *** ## Os Melhores BDRs para 2026 ### Big Techs (FAANG+) | Código | Empresa | Setor | | ------ | ----------------- | ------------------ | | AAPL34 | Apple | Tecnologia | | MSFT34 | Microsoft | Tecnologia | | GOGL34 | Alphabet (Google) | Tecnologia | | AMZO34 | Amazon | E-commerce/Cloud | | META34 | Meta (Facebook) | Redes Sociais | | NVDC34 | NVIDIA | Semicondutores | | TSLA34 | Tesla | Veículos Elétricos | | NFLX34 | Netflix | Streaming | ```typescript // Buscar cotações de BDRs via brapi.dev const response = await fetch( "https://brapi.dev/api/quote/AAPL34,MSFT34,GOGL34,AMZO34,META34,NVDC34,TSLA34,NFLX34", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); ``` ### BDRs de Dividendos | BDR | Empresa | Setor | DY Aproximado | | ------ | ----------------- | ------------ | ------------- | | COCA34 | Coca-Cola | Bebidas | 3.0% | | JNJB34 | Johnson & Johnson | Saúde | 2.8% | | PFIZ34 | Pfizer | Farmacêutico | 5.5% | | PG34 | Procter & Gamble | Consumo | 2.4% | | VERZ34 | Verizon | Telecom | 6.5% | | T1AT34 | AT\&T | Telecom | 6.0% | | XRXB34 | Xerox | Tecnologia | 5.0% | ### BDRs de Crescimento | BDR | Empresa | Setor | Tese | | ------ | ----------- | ------------- | ------------------ | | NVDC34 | NVIDIA | AI/Chips | Líder em IA | | TSLA34 | Tesla | EV | Veículos elétricos | | A1MD34 | AMD | Chips | Concorrente Intel | | CRWD34 | CrowdStrike | Cybersecurity | Segurança digital | | S2NW34 | Snowflake | Cloud Data | Dados em nuvem | ### BDRs de Valor | BDR | Empresa | Setor | Por que valor | | ------ | ------------------ | -------------- | --------------- | | BERK34 | Berkshire Hathaway | Holding | Warren Buffett | | JPMC34 | JPMorgan | Banco | Maior banco EUA | | BOAC34 | Bank of America | Banco | Subvalorizado | | WALM34 | Walmart | Varejo | Defensivo | | DISB34 | Disney | Entretenimento | Ativos fortes | *** ## Tributação de BDRs ### Imposto sobre Ganho de Capital **Regras:** * Isenção para vendas até R$ 20.000/mês (soma de ações + BDRs) * Alíquota: 15% sobre o lucro * Prejuízos podem ser compensados **Exemplo de cálculo:** | Item | Valor | | ----------------------- | ------------ | | Preço de venda | R$ 55,00 | | Preço de compra | R$ 45,00 | | Quantidade | 100 unidades | | **Valor total vendido** | R$ 5.500,00 | | **Custo de aquisição** | R$ 4.500,00 | | **Lucro** | R$ 1.000,00 | | **IR devido (15%)** | R$ 150,00 | > Se vendas totais no mês ≤ R$ 20.000 → **Isento de IR** ### Imposto sobre Dividendos **Como funciona:** 1. **EUA retém 30% na fonte** - Governo americano (IRS) cobra antes de chegar ao Brasil 2. **Você recebe 70%** - Já convertido em reais pelo banco depositário 3. **No Brasil: isento** - Não paga IR adicional (já tributado no exterior) 4. **Declaração** - Informar na ficha de Rendimentos Isentos **Exemplo prático:** | Etapa | Valor | | -------------------- | ------------------------------ | | Dividendo bruto | US$ 100,00 | | Retenção EUA (30%) | US$ 30,00 | | Valor líquido | US$ 70,00 | | Conversão para reais | Banco converte automaticamente | ### Tabela Resumo: Tributação BDR | Evento | Alíquota | Observação | | ---------------- | --------- | ---------------------- | | Ganho de capital | 15% | Isenção até R$ 20k/mês | | Dividendos | 30% (EUA) | Retido na fonte | | Day trade | 20% | Sem isenção | *** ## BDR vs Investir Direto no Exterior ### Comparativo Completo | Aspecto | BDR | Investimento Direto | | --------------------- | --------------------------------- | ----------------------------------------------------- | | **Abertura de conta** | Corretora brasileira (já tem) | Corretora internacional (Avenue, Interactive Brokers) | | **Remessa** | Não precisa | IOF de 0.38% + spread cambial | | **Custos corretagem** | Zero na maioria das corretoras | Zero a US$ 1 por ordem | | **Custos custódia** | Pode ter taxa embutida no spread | Geralmente zero | | **Dividendos** | 30% retido EUA + spread conversão | 30% retido EUA (com W-8BEN) | | **Imposto herança** | Segue regras brasileiras | Estate tax EUA (acima de US$ 60k) | | **Liquidez** | Menor (mercado brasileiro) | Maior (mercado americano) | | **Horário** | 10h-17h (Brasília) | 11h30-18h (Brasília) | | **Declaração IR** | Como ativo brasileiro | Como ativo no exterior (mais complexo) | ### Quando Escolher Cada Opção | Situação | Melhor Opção | | -------------------------------- | ------------------- | | Investimento pequeno (\< R$ 50k) | BDR | | Quer simplicidade | BDR | | Foco em dividendos | Investimento direto | | Patrimônio grande (> R$ 300k) | Investimento direto | | Quer mais opções de ativos | Investimento direto | | Preocupação com herança | BDR | *** ## Monitorando BDRs com brapi.dev ```typescript // Monitora carteira de BDRs usando brapi.dev interface BDRPosition { codigo: string; quantidade: number; } async function monitorarCarteiraBDRs(bdrs: BDRPosition[], token: string) { const tickers = bdrs.map(b => b.codigo).join(","); const response = await fetch(`https://brapi.dev/api/quote/${tickers}`, { headers: { Authorization: `Bearer ${token}` } }); const { results } = await response.json(); let valorTotal = 0; const carteira = results.map((resultado: any) => { const bdrConfig = bdrs.find(b => b.codigo === resultado.symbol); const quantidade = bdrConfig?.quantidade ?? 0; const valor = resultado.regularMarketPrice * quantidade; valorTotal += valor; return { ticker: resultado.symbol, nome: resultado.shortName, preco: resultado.regularMarketPrice, variacao: resultado.regularMarketChangePercent, quantidade, valor }; }); return { carteira, valorTotal }; } // Exemplo de uso const meusBDRs = [ { codigo: "AAPL34", quantidade: 50 }, { codigo: "MSFT34", quantidade: 30 }, { codigo: "GOGL34", quantidade: 25 } ]; // const resultado = await monitorarCarteiraBDRs(meusBDRs, "SEU_TOKEN"); ``` ### Calculando Proporção BDR/Ação **Fórmula:** Proporção = (Preço da ação em USD × Dólar) ÷ Preço do BDR **Exemplo com Apple:** | Item | Valor | | ------------------- | ---------------------- | | Preço BDR (AAPL34) | R$ 52,00 | | Preço ação (AAPL) | US$ 185,00 | | Dólar | R$ 4,95 | | Preço ação em reais | R$ 916,75 | | **Proporção** | **\~18 BDRs = 1 ação** | *** ## Estratégias com BDRs ### 1. Carteira Diversificada Global | Setor | Peso | BDRs | | --------------- | ---- | ---------------------- | | **Tecnologia** | 30% | AAPL34, MSFT34, GOGL34 | | **Saúde** | 15% | JNJB34, PFIZ34, MRCK34 | | **Financeiro** | 15% | JPMC34, BOAC34, BERK34 | | **Consumo** | 15% | COCA34, PGCO34, WALM34 | | **Industrial** | 10% | CATP34, HONB34, GEOO34 | | **Energia** | 10% | EXXO34, CHVX34 | | **Comunicação** | 5% | DISB34, NFLX34 | ### 2. Carteira de Dividendos | BDR | Empresa | Setor | DY Esperado | | ------ | --------- | ------- | ----------- | | COCA34 | Coca-Cola | Bebidas | 3.0% | | JNJB34 | J\&J | Saúde | 2.8% | | PGCO34 | P\&G | Consumo | 2.4% | | ABBV34 | AbbVie | Farma | 4.0% | | VERZ34 | Verizon | Telecom | 6.5% | > **Atenção**: Lembre-se que 30% dos dividendos são retidos na fonte pelos EUA. ### 3. Carteira de Crescimento | BDR | Empresa | Tese | | ------ | ----------- | ------------------ | | NVDC34 | NVIDIA | IA e data centers | | TSLA34 | Tesla | Veículos elétricos | | AMZO34 | Amazon | E-commerce + AWS | | META34 | Meta | Metaverso + IA | | CRWD34 | CrowdStrike | Cybersecurity | *** ## Riscos dos BDRs ### 1. Risco Cambial **Impacto do câmbio nos BDRs:** Investimento inicial: R$ 10.000 | Cenário | Ação | Dólar | Resultado | | ------- | ---- | ----- | ---------------- | | 1 | +10% | -10% | R$ 9.900 (-1%) | | 2 | -10% | +10% | R$ 9.900 (-1%) | | 3 | +10% | +10% | R$ 12.100 (+21%) | > O câmbio pode amplificar ganhos ou perdas. Quando ação e dólar sobem juntos, o retorno é potencializado. ### 2. Outros Riscos | Risco | Descrição | Mitigação | | -------------- | -------------------------------- | ----------------------------- | | **Liquidez** | Volume baixo em alguns BDRs | Preferir BDRs mais negociados | | **Spread** | Diferença compra/venda maior | Usar ordens limitadas | | **Informação** | Dados menos acessíveis | Acompanhar fonte original | | **Custódia** | Dependência do banco depositário | Diversificar | *** ## Como Declarar BDRs no IR ### Na Declaração Anual **1. Posição em Bens e Direitos:** * **Ficha:** Bens e Direitos * **Grupo:** 04 - Aplicações e Investimentos * **Código:** 04 - Ativos negociados em bolsa no Brasil (BDRs) * **Discriminação:** BDR AAPL34 - 100 unidades - Corretora XYZ * **Valor:** Custo de aquisição (não atualizar pela cotação) **2. Ganho de Capital:** * **Ficha:** Renda Variável - Operações Comuns * **Preenchimento:** Lucro ou prejuízo mensal * **Isenção:** Vendas até R$ 20.000/mês **3. Dividendos:** * **Ficha:** Rendimentos Isentos e Não Tributáveis * **Código:** 26 - Outros * **Descrição:** Dividendos de BDRs (já tributados no exterior) *** ## Checklist: Investindo em BDRs ### Antes de Comprar * [ ] Entendi o que é BDR e como funciona? * [ ] Pesquisei a empresa por trás do BDR? * [ ] Verifiquei a proporção BDR/ação? * [ ] Analisei a liquidez do BDR? * [ ] Considerei o risco cambial? * [ ] Entendi a tributação? ### Ao Comprar * [ ] Usar ordem limitada (evitar spread) * [ ] Diversificar entre setores * [ ] Não concentrar demais em um BDR * [ ] Registrar preço médio de compra ### Ao Receber Dividendos * [ ] Verificar valor líquido (após 30% retido) * [ ] Anotar para declaração de IR * [ ] Decidir se reinveste *** ## Conclusão BDRs são uma **porta de entrada simples** para investir em empresas globais: | Vantagem | Para Quem | | ------------------ | --------------------- | | Simplicidade | Iniciantes | | Sem conta exterior | Quem quer praticidade | | Diversificação | Todos os perfis | | Exposição cambial | Proteção contra real | Para patrimônios maiores (> R$ 300k em internacional), considere também investir diretamente para maior eficiência. *** ## Recursos Adicionais ### Artigos Relacionados * [ETFs Irlandeses para Brasileiros](/blog/etfs-irlandeses-brasileiros-vwra-swrd-eimi) * [Guia Bogleheads Brasil](/blog/guia-bogleheads-brasil-investimento-passivo-etfs) * [Como Declarar Investimentos no IR](/blog/como-declarar-investimentos-imposto-renda-2026) ### API brapi.dev para BDRs ```typescript // Cotação de BDRs const response = await fetch( "https://brapi.dev/api/quote/AAPL34,MSFT34,GOGL34", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); // Lista de BDRs disponíveis const listResponse = await fetch( "https://brapi.dev/api/quote/list?type=bdr", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); ``` *** *Última atualização: Janeiro 2026* **Aviso Legal**: Este conteúdo é educacional. BDRs envolvem riscos de mercado e cambial. Consulte um profissional antes de investir. # Bitcoin no Brasil 2026: Guia Completo para Investir em Criptomoedas URL: /blog/bitcoin-brasil-como-investir-analise.mdx Como investir em Bitcoin e criptomoedas no Brasil. Exchanges, ETFs de cripto na bolsa brasileira, tributação, carteiras e análise de mercado ✓ *** searchable: true title: 'Bitcoin no Brasil 2026: Guia Completo para Investir em Criptomoedas' description: 'Como investir em Bitcoin e criptomoedas no Brasil. Exchanges, ETFs de cripto na bolsa brasileira, tributação, carteiras e análise de mercado ✓' date: '2026-01-01' keywords: 'bitcoin brasil, como investir bitcoin, criptomoedas brasil, etf bitcoin bolsa brasileira, hashdex btc, qbtc11, tributacao cripto, exchange brasileira, 2026' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Criptomoedas' readingTime: '20 min' tags: \['Bitcoin', 'Criptomoedas', 'ETF', 'Investimentos', 'Bolsa Brasileira'] relatedPosts: \[ 'etfs-brasil-guia-completo-bova11-ivvb11', 'carteira-de-acoes-como-montar-diversificar', 'como-declarar-investimentos-imposto-renda-2026', 'ethereum-eth-guia-completo-brasil-2026', 'calculadoras-fire-independencia-financeira-brasil', ] featured: true expertise: 'Equipe especializada em mercados financeiros tradicionais e digitais' lastReviewed: 2026-01-03 ------------------------ import { Callout } from 'fumadocs-ui/components/callout'; ## Introdução O **Bitcoin** completou 17 anos em 2026 e consolidou-se como uma classe de ativos reconhecida globalmente. No Brasil, existem múltiplas formas de investir em criptomoedas, desde comprar diretamente em exchanges até ETFs negociados na bolsa brasileira. Este guia completo cobre: * O que é Bitcoin e como funciona * Formas de investir no Brasil * ETFs de cripto na bolsa brasileira (HASH11, QBTC11, BITH11) * Tributação e declaração de IR * Riscos e alocação na carteira * Como acompanhar preços com a brapi.dev {/* Separator */} *** ## O que é Bitcoin? ### Fundamentos | Métrica | Valor | | -------------- | ---------------------------- | | Criação | 2009 (Satoshi Nakamoto) | | Oferta Máxima | 21 milhões BTC | | Minerados | \~19.6 milhões (93%) | | Halving | A cada 4 anos (último: 2024) | | Market Cap | \~$1.5 trilhão | | Ranking Global | Top 10 ativos do mundo | ### Por que Bitcoin tem valor? | Característica | Bitcoin | Ouro | Moeda Fiat | | --------------- | -------------------- | --------------------- | --------------- | | Escassez | ✅ 21M fixo | ⚠️ Aumenta \~1.5%/ano | ❌ Ilimitada | | Divisibilidade | ✅ 8 casas (satoshis) | ⚠️ Difícil | ✅ Centavos | | Portabilidade | ✅ Digital | ❌ Pesado | ⚠️ Limitada | | Verificável | ✅ Blockchain | ⚠️ Testes | ⚠️ Falsificação | | Descentralizado | ✅ Sem dono | ❌ Bancos centrais | ❌ Governos | | Censura | ✅ Impossível | ⚠️ Confiscável | ❌ Bloqueável | ### Ciclos de Mercado | Halving | Ano | Preço Antes → Depois | Retorno | | --------- | ---- | -------------------- | ------- | | Halving 1 | 2012 | $12 → $1.100 | 9.000%+ | | Halving 2 | 2016 | $650 → $20.000 | 3.000%+ | | Halving 3 | 2020 | $8.500 → $69.000 | 700%+ | | Halving 4 | 2024 | $60.000 → ??? | - | **Padrão histórico:** Bull run de 12-18 meses após cada halving. *** ## Formas de Investir em Bitcoin no Brasil ### Comparativo de Métodos | Método | Custódia | Taxas | Liquidez | Complexidade | | --------------- | -------- | ------------- | ---------- | ------------ | | Exchange BR | Própria | 0.5-2% | Alta | Média | | Exchange Global | Própria | 0.1-0.5% | Muito Alta | Alta | | ETFs Bolsa | Gestora | 0.3-1.5% a.a. | Alta | Baixa | | Compra P2P | Própria | Variável | Média | Alta | | Self-custody | Você | \~0% | - | Muito Alta | *** ## ETFs de Cripto na Bolsa Brasileira ### Vantagens dos ETFs 1. **Simplicidade** - Compra via home broker tradicional 2. **Regulação** - Supervisionado pela CVM 3. **Custódia** - Gestora cuida da segurança 4. **Tributação** - Mesmas regras de ações 5. **Diversificação** - Exposição a múltiplas criptos ### Principais ETFs de Cripto Você pode acompanhar os preços dos ETFs de cripto usando a API da brapi: ```ts const response = await fetch( "https://brapi.dev/api/quote/HASH11,QBTC11,BITH11,ETHE11", { headers: { "Authorization": "Bearer SEU_TOKEN" } } ); const etfs = await response.json(); ``` #### HASH11 - Hashdex Nasdaq Crypto Index | Atributo | Valor | | -------- | ------------------------- | | Gestora | Hashdex | | Índice | Nasdaq Crypto Index (NCI) | | Taxa | 1.3% a.a. | **Composição:** * Bitcoin (BTC): \~65% * Ethereum (ETH): \~25% * Solana (SOL): \~3% * Chainlink (LINK): \~2% * Outros: \~5% *Ideal para: Diversificação em cripto* #### QBTC11 - QR Bitcoin | Atributo | Valor | | --------- | ------------ | | Gestora | QR Capital | | Exposição | 100% Bitcoin | | Taxa | 0.75% a.a. | *Ideal para: Exposição pura a Bitcoin* #### BITH11 - Hashdex Bitcoin | Atributo | Valor | | --------- | ---------------------------- | | Gestora | Hashdex | | Exposição | 100% Bitcoin | | Taxa | 0.3% a.a. (menor do mercado) | *Ideal para: Bitcoin com menor custo* #### ETHE11 - Hashdex Ethereum | Atributo | Valor | | --------- | ------------- | | Gestora | Hashdex | | Exposição | 100% Ethereum | | Taxa | 0.7% a.a. | *Ideal para: Exposição a Ethereum* ### Comparativo de ETFs | ETF | Exposição | Taxa | Volume Diário | | ------ | ------------ | ----- | ------------- | | HASH11 | Multi-crypto | 1.30% | \~R$ 50M | | QBTC11 | 100% BTC | 0.75% | \~R$ 30M | | BITH11 | 100% BTC | 0.30% | \~R$ 20M | | ETHE11 | 100% ETH | 0.70% | \~R$ 10M | *** ## Exchanges Brasileiras ### Principais Corretoras | Exchange | Fundação | Taxas | Criptos | Regulação | | --------------- | -------- | --------- | ------- | -------------- | | Mercado Bitcoin | 2013 | 0.3-0.7% | 200+ | CVM autorizada | | Foxbit | 2014 | 0.25-0.5% | 100+ | BACEN | | Binance BR | 2020 | 0.1% | 300+ | Global | | Coinbase BR | 2023 | 0.5-1% | 100+ | Listada NASDAQ | ### Como Comprar Bitcoin em Exchange 1. Criar conta e verificar identidade (KYC) 2. Depositar reais via Pix 3. Executar ordem de compra Exemplo de monitoramento de preço com a API da brapi: ```ts const response = await fetch( "https://brapi.dev/api/v2/crypto?coin=BTC", { headers: { "Authorization": "Bearer SEU_TOKEN" } } ); const data = await response.json(); const btc = data.coins[0]; console.log({ preco_usd: btc.regularMarketPrice, variacao_24h: btc.regularMarketChangePercent, volume_24h: btc.regularMarketVolume, }); ``` *** ## Tributação de Criptomoedas no Brasil ### Regras da Receita Federal #### Vendas até R$ 35.000/mês **ISENTO** de imposto de renda #### Vendas acima de R$ 35.000/mês Ganho de Capital com alíquotas progressivas: | Faixa de Lucro | Alíquota | | --------------- | -------- | | Até R$ 5M | 15% | | R$ 5M - 10M | 17,5% | | R$ 10M - 30M | 20% | | Acima de R$ 30M | 22,5% | **Declaração obrigatória:** Ativos acima de R$ 5.000 devem ser declarados. Prazo: até 31/05 do ano seguinte. ### ETFs vs Compra Direta - Tributação | Aspecto | ETFs (HASH11, QBTC11) | Compra Direta | | ---------------------- | -------------------------- | -------------------- | | Isenção R$ 35k | ❌ Não se aplica | ✅ Sim | | Isenção R$ 20k (swing) | ✅ Sim (day trade não) | ❌ Não | | Compensação prejuízo | ✅ Com outros ETFs/ações | ⚠️ Apenas com cripto | | DARF | Corretora pode reter | Você calcula | | Declaração | Via informe de rendimentos | Manual | ### Calculando Imposto **Exemplo:** Vendeu R$ 50.000 no mês com lucro de R$ 15.000 Como vendas > R$ 35.000, aplica-se alíquota de 15%: * **Imposto devido:** R$ 15.000 × 15% = **R$ 2.250,00** *** ## Alocação de Cripto na Carteira ### Quanto Alocar? | Perfil | Alocação Recomendada | | -------------------------------------------------- | -------------------- | | **Conservador** (60+ anos ou muito avesso a risco) | 0-1% em cripto | | **Moderado** (diversificação básica) | 1-5% em cripto | | **Arrojado** (aceita volatilidade) | 5-10% em cripto | | **Agressivo** (convicto em cripto) | 10-20% em cripto | **NUNCA** invista mais do que pode perder totalmente. ### Exemplo de Carteira Balanceada **Carteira diversificada com 5% em cripto:** | Categoria | Ativo | Alocação | | -------------------------------- | -------------------------------- | -------- | | **Renda Variável Brasil** | Ações BR (BOVA11 ou individuais) | 30% | | | FIIs (IFIX11 ou individuais) | 10% | | **Renda Variável Internacional** | Ações EUA (IVVB11) | 15% | | | Ações Global (ACWI11) | 5% | | **Renda Fixa** | Tesouro IPCA+ | 20% | | | CDB/LCI/LCA | 15% | | **Criptomoedas** | Bitcoin (QBTC11 ou BITH11) | 4% | | | Ethereum (ETHE11) | 1% | **Volatilidade esperada:** 12% a.a. sem cripto → 14% a.a. com 5% em cripto. Aumento moderado para potencial de retorno maior. *** ## Riscos das Criptomoedas ### Principais Riscos | Risco | Descrição | Mitigação | | ---------------- | --------------------------- | ------------------------------ | | **Volatilidade** | -50% em semanas é comum | Alocação pequena, DCA | | **Regulatório** | Governos podem restringir | ETFs regulados, diversificação | | **Tecnológico** | Bugs, hacks, falhas | Self-custody, hardware wallets | | **Custódia** | Exchange pode quebrar (FTX) | Não deixe tudo em exchange | | **Fraudes** | Scams, projetos falsos | Apenas BTC/ETH, due diligence | | **Liquidez** | Altcoins podem zerar | Foco em large caps | ### Volatilidade Histórica **Drawdowns máximos do Bitcoin:** | Ano | Queda | Preços | | ---- | ----- | ----------------- | | 2011 | -93% | $32 → $2 | | 2013 | -83% | $1.100 → $180 | | 2017 | -84% | $20.000 → $3.200 | | 2021 | -77% | $69.000 → $16.000 | Se você não aguenta ver -50% na carteira, não deveria ter Bitcoin. *** ## Estratégias de Investimento ### DCA (Dollar Cost Averaging) Estratégia de aportes mensais fixos para reduzir o impacto da volatilidade: 1. Defina um valor mensal fixo (ex: R$ 500) 2. Compre sempre no mesmo dia, independente do preço 3. Acumule ao longo de meses/anos 4. O preço médio tende a ser favorável no longo prazo Use a API da brapi.dev para acompanhar preços históricos e calcular seu preço médio. ### Rebalanceamento Mantenha sua alocação-alvo (ex: 5% em cripto): * **Se cripto subir muito:** Venda parte e realoque para outros ativos * **Se cripto cair muito:** Compre mais para manter a proporção * Rebalanceie trimestralmente ou quando a alocação variar 20%+ do alvo *** ## Acompanhando Preços com brapi.dev ### API de Criptomoedas ```ts const response = await fetch( "https://brapi.dev/api/v2/crypto?coin=BTC,ETH,SOL,ADA¤cy=BRL", { headers: { "Authorization": "Bearer SEU_TOKEN" } } ); const coins = await response.json(); ``` ### Dashboard de Cripto + Ações ```ts // Buscar ETFs de cripto const etfs = await fetch( "https://brapi.dev/api/quote/BOVA11,IVVB11,HASH11,QBTC11", { headers: { "Authorization": "Bearer TOKEN" } } ).then(r => r.json()); // Buscar cripto diretamente const cripto = await fetch( "https://brapi.dev/api/v2/crypto?coin=BTC,ETH", { headers: { "Authorization": "Bearer TOKEN" } } ).then(r => r.json()); ``` ### Alertas de Preço ```ts const response = await fetch( "https://brapi.dev/api/v2/crypto?coin=BTC", { headers: { "Authorization": "Bearer TOKEN" } } ); const btc = await response.json(); const precoAtual = btc.coins[0].regularMarketPrice; if (precoAtual > 100000) { console.log(`🔔 BTC acima de $100k: $${precoAtual.toLocaleString()}`); } ``` *** ## Segurança e Custódia ### Níveis de Segurança | Nível | Método | Características | | ----- | ------------------------------------------------ | -------------------------------------------------------------------------------- | | **1** | ETF na bolsa brasileira (QBTC11, HASH11, BITH11) | Mais simples. Custódia institucional. Sem necessidade de carteira. | | **2** | Exchange Brasileira (Mercado Bitcoin, Foxbit) | 2FA obrigatório. Limite de saque por segurança. | | **3** | Exchange + Saque para Carteira | Compra na exchange, saque para software wallet (Exodus, Trust Wallet, MetaMask). | | **4** | Hardware Wallet (máxima segurança) | Ledger, Trezor. Chaves offline. Seed phrase guardada em local seguro. | ### Regra de Ouro > **"Not your keys, not your coins"** > > Se você não controla as chaves privadas, você não é dono das moedas. > Para valores significativos (>R$ 10.000), considere hardware wallet. *** ## Perguntas Frequentes ### Bitcoin é pirâmide? Não. Bitcoin não promete retornos fixos, não depende de novos investidores para pagar antigos, e tem valor baseado em escassez digital e utilidade como reserva de valor. ### Qual a diferença entre Bitcoin e outras criptos? Bitcoin é a primeira e mais descentralizada criptomoeda, focada em ser "ouro digital". Ethereum é uma plataforma para aplicações descentralizadas. Altcoins têm propósitos variados (e riscos maiores). ### ETF ou compra direta? * **ETF**: Melhor para iniciantes, tributação mais simples, sem preocupação com custódia * **Compra direta**: Maior controle, isenção até R$ 35k/mês, autocustódia possível ### Quanto investir em Bitcoin? Comece com 1-5% da carteira. Nunca invista mais do que pode perder totalmente. A volatilidade é extrema - quedas de 50%+ são comuns. *** ## Conclusão ### Resumo **Checklist para investir em Bitcoin:** * [ ] Entender os fundamentos do Bitcoin * [ ] Definir alocação (1-10% da carteira) * [ ] Escolher método (ETF ou compra direta) * [ ] Configurar conta na exchange ou corretora * [ ] Fazer primeiro aporte (valor que pode perder) * [ ] Configurar DCA mensal * [ ] Entender tributação * [ ] Se >R$ 10k: considerar hardware wallet * [ ] Acompanhar sem obsessão * [ ] Rebalancear anualmente ### Próximos Passos 1. **Iniciantes**: Comece com HASH11 ou QBTC11 na bolsa brasileira 2. **Intermediários**: Abra conta em exchange brasileira 3. **Avançados**: Self-custody com hardware wallet ### Acompanhe com brapi.dev * [API de Criptomoedas](/docs/crypto) * [ETFs na bolsa brasileira](/docs/quote) * [Alertas de Preço](/dashboard) *** **Pronto para acompanhar Bitcoin e cripto?** [Crie sua conta grátis](/signup) e acesse dados de criptomoedas em tempo real! # Bot de Telegram para Cotações e Alertas da B3 com Python URL: /blog/bot-telegram-cotacoes-acoes-python-tutorial.mdx Crie um bot de Telegram que consulta ações brasileiras pela brapi e responde a comandos de cotação. Veja também como estruturar alertas de preço. *** searchable: true title: 'Bot de Telegram para Cotações e Alertas da B3 com Python' description: 'Crie um bot de Telegram que consulta ações brasileiras pela brapi e responde a comandos de cotação. Veja também como estruturar alertas de preço.' date: '2026-01-02' keywords: 'bot telegram ações python, bot cotação b3, alerta preço ações telegram, api ações telegram, brapi bot python' author: 'Alisson Leal' category: 'Tutoriais e Integrações' subcategory: 'Bots e automação' readingTime: '9 min' tags: \['Telegram', 'Python', 'Bot', 'B3', 'Cotações', 'Alertas', 'API'] relatedPosts: \['alertas-preco-tempo-real-python-tutorial', 'api-b3-python-requests-guia-pratico', 'b3-api-gratuita-como-usar-cotacoes'] featured: false expertise: 'Bots, automação e integração com APIs de mercado' lastReviewed: '2026-07-17' -------------------------- import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; Este bot responde a `/cotacao PETR4` com o último preço, a variação e o horário disponíveis na brapi. O projeto usa Python, `python-telegram-bot` e `httpx`. ## Criar o bot no Telegram Abra uma conversa com `@BotFather` no Telegram: 1. envie `/newbot`; 2. escolha nome e usuário; 3. copie o token gerado; 4. não publique esse token. Crie também um token no dashboard da brapi. Guarde os dois em variáveis de ambiente: ```bash export TELEGRAM_BOT_TOKEN="SEU_TOKEN_DO_TELEGRAM" export BRAPI_TOKEN="SEU_TOKEN_DA_BRAPI" ``` ## Instalar as dependências ```bash pip install python-telegram-bot httpx ``` ## Código do comando de cotação ```python import os import re import httpx from telegram import Update from telegram.ext import Application, CommandHandler, ContextTypes TELEGRAM_TOKEN = os.environ["TELEGRAM_BOT_TOKEN"] BRAPI_TOKEN = os.getenv("BRAPI_TOKEN") TICKER_PATTERN = re.compile(r"^[A-Z0-9^]{3,12}$") async def get_quote(symbol: str) -> dict: headers = ( {"Authorization": f"Bearer {BRAPI_TOKEN}"} if BRAPI_TOKEN else {} ) async with httpx.AsyncClient(timeout=15) as client: response = await client.get( "https://brapi.dev/api/v2/stocks/quote", params={"symbols": symbol}, headers=headers, ) response.raise_for_status() payload = response.json() if not payload.get("results"): raise ValueError("Ticker não encontrado") return payload["results"][0] async def cotacao( update: Update, context: ContextTypes.DEFAULT_TYPE, ) -> None: if not context.args: await update.message.reply_text("Use /cotacao PETR4") return symbol = context.args[0].strip().upper() if not TICKER_PATTERN.fullmatch(symbol): await update.message.reply_text("Ticker inválido") return try: result = await get_quote(symbol) quote = result["data"] price = quote["regularMarketPrice"] change = quote["regularMarketChangePercent"] market_time = quote["regularMarketTime"] await update.message.reply_text( f"{result['symbol']}\n" f"Preço: R$ {price:.2f}\n" f"Variação: {change:.2f}%\n" f"Horário: {market_time}" ) except (httpx.HTTPError, ValueError, KeyError) as error: await update.message.reply_text(f"Não foi possível consultar: {error}") def main() -> None: app = Application.builder().token(TELEGRAM_TOKEN).build() app.add_handler(CommandHandler("cotacao", cotacao)) app.run_polling() if __name__ == "__main__": main() ``` Execute o arquivo e envie `/cotacao PETR4` para o bot. Mostre `regularMarketTime` junto com a resposta. A disponibilidade e o atraso variam por ativo, fonte e plano. Não apresente o bot como terminal de execução. ## Consultar vários ativos A API aceita até 20 símbolos por chamada. Você pode criar `/carteira` e enviar os argumentos separados por espaço: ```text /carteira PETR4 VALE3 ITUB4 ``` Valide cada ticker, junte com vírgulas e consulte: ```text /api/v2/stocks/quote?symbols=PETR4,VALE3,ITUB4 ``` Limite a quantidade antes de montar a URL. Isso evita pedidos enormes ou entrada malformada enviada por usuários do bot. ## Estruturar alertas de preço Um alerta precisa guardar: * usuário e chat do Telegram; * ticker canônico; * preço alvo; * direção, acima ou abaixo; * data de criação; * estado do alerta; * horário da última verificação. Não execute uma chamada para cada alerta. Agrupe tickers, consulte até 20 por requisição e compare os preços em memória. Depois de disparar, marque o alerta como concluído ou aplique uma janela de silêncio. Sem isso, o usuário recebe a mesma mensagem a cada verificação. ## Evitar alertas repetidos Uma regra "PETR4 acima de 40" continua verdadeira enquanto o preço permanecer acima de 40. Dispare apenas na transição entre os estados. ```python crossed = previous_price < target <= current_price ``` Para alertas abaixo do preço: ```python crossed = previous_price > target >= current_price ``` Salve o último preço observado. Reiniciar o processo sem estado pode gerar uma notificação duplicada. ## Segurança e limites * nunca aceite uma URL de API enviada pelo usuário; * valide ticker e quantidade de argumentos; * aplique limite por chat; * guarde tokens fora do código; * trate status 401, 403, 429 e 500; * use timeout em todas as chamadas; * não registre tokens nos logs. Se o bot crescer, troque memória local por um banco e mova as verificações para um worker. O processo do Telegram não precisa executar todos os alertas. O endpoint e os campos atuais estão na [documentação de cotação](/docs/acoes/cotacao). Para um alerta independente do Telegram, veja [alertas de preço com Python](/blog/alertas-preco-tempo-real-python-tutorial). # brapi vs Alpha Vantage 2026: Comparativo Completo de APIs Financeiras URL: /blog/brapi-vs-alpha-vantage-api-comparativo.mdx Comparação detalhada entre brapi.dev e Alpha Vantage para dados do mercado brasileiro. Preços, cobertura, latência e exemplos práticos ✓ *** searchable: true title: 'brapi vs Alpha Vantage 2026: Comparativo Completo de APIs Financeiras' description: 'Comparação detalhada entre brapi.dev e Alpha Vantage para dados do mercado brasileiro. Preços, cobertura, latência e exemplos práticos ✓' date: '2026-01-01' keywords: 'brapi vs alpha vantage, api acoes brasil, alpha vantage brasil, api bolsa brasileira, comparativo apis financeiras, alternativa alpha vantage, api cotacoes bolsa brasileira, 2026' author: 'Equipe brapi.dev' category: 'Comparativos' subcategory: 'APIs' readingTime: '18 min' tags: \['API', 'Alpha Vantage', 'Comparativo', 'Bolsa Brasileira', 'Mercado Brasileiro'] relatedPosts: \[ 'brapi-vs-yahoo-finance-api-comparativo-completo', 'api-b3-python-requests-guia-pratico', 'api-acoes-react-nextjs-tutorial', 'api-b3-typescript-javascript-integracao-completa', 'b3-api-gratuita-como-usar-cotacoes', ] featured: true expertise: 'Equipe de desenvolvedores com experiência em integração de APIs financeiras' lastReviewed: 2026-06-05 ------------------------ ## Introdução Ao desenvolver aplicações financeiras para o mercado brasileiro, a escolha da API de dados é fundamental. **Alpha Vantage** é uma das APIs mais conhecidas globalmente, mas será que atende bem às necessidades do mercado brasileiro? Neste comparativo completo, analisamos **brapi.dev** e **Alpha Vantage** lado a lado, focando em: * Cobertura do mercado brasileiro * Qualidade e precisão dos dados * Preços e limites de requisições * Facilidade de integração * Suporte e documentação {/* Separator */} *** ## Resumo Executivo ### Tabela Comparativa Rápida | Critério | brapi.dev | Alpha Vantage | | ---------------------- | ----------------------- | -------------------- | | **Foco** | 🇧🇷 Mercado Brasileiro | 🌍 Global (foco EUA) | | **Ações Brasileiras** | ✅ 400+ tickers | ⚠️ Limitado (\~100) | | **FIIs** | ✅ Completo | ❌ Não suporta | | **BDRs** | ✅ Completo | ⚠️ Parcial | | **Fundamentalistas** | ✅ 50+ indicadores | ⚠️ Básico | | **Latência Brasil** | \< 100ms | 200-500ms | | **Plano Grátis** | ✅ 15.000 req/mês | ✅ 25 req/dia | | **Preço Inicial Pago** | R$ 119,99/mês | US$ 49,99/mês | | **Documentação PT-BR** | ✅ Completa | ❌ Inglês | | **Suporte** | 🇧🇷 Português | 🇺🇸 Inglês | ### Veredito Rápido **Para Mercado Brasileiro → brapi.dev** * Cobertura completa da bolsa brasileira * Dados fundamentalistas detalhados * Suporte em português * Melhor custo-benefício para Brasil **Para Mercado Internacional → Alpha Vantage** * NYSE, NASDAQ, mercados globais * Forex e Crypto * Indicadores técnicos prontos **Para Ambos → brapi.dev + Alpha Vantage** * Combine APIs para cobertura completa *** ## Cobertura do Mercado Brasileiro ### Ações Brasileiras #### brapi.dev ```typescript // Consulta simples de ação brasileira const response = await fetch("https://brapi.dev/api/quote/WEGE3", { headers: { Authorization: "Bearer SEU_TOKEN" } }); const { results } = await response.json(); // results[0].regularMarketPrice → 35.42 // results[0].sector → "Bens Industriais" ``` **Cobertura:** * ✅ 400+ ações listadas na bolsa brasileira * ✅ Small caps e micro caps * ✅ Units (TAEE11, SANB11) * ✅ Ações fracionárias * ✅ IPOs recentes (atualizado semanalmente) #### Alpha Vantage ```typescript // Tentando buscar ação brasileira - precisa adicionar .SAO const response = await fetch( "https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=WEGE3.SAO&apikey=SUA_API_KEY" ); const data = await response.json(); // Resultado: dados limitados ou indisponíveis // Muitas ações brasileiras não são encontradas ``` **Cobertura:** * ⚠️ \~100 ações brasileiras (apenas as mais líquidas) * ❌ Small caps geralmente não disponíveis * ❌ Dados podem ter delay de 15-20 minutos * ❌ Formato de símbolo diferente (PETR4.SAO) ### Fundos Imobiliários (FIIs) #### brapi.dev ```typescript // FIIs totalmente suportados - múltiplos em uma requisição const response = await fetch("https://brapi.dev/api/quote/MXRF11,HGLG11,XPML11", { headers: { Authorization: "Bearer SEU_TOKEN" } }); const { results } = await response.json(); // Retorna: cotação, dividend yield, P/VP, etc. ``` **Suporte FIIs:** * ✅ 400+ FIIs da bolsa brasileira * ✅ Dividend Yield histórico * ✅ P/VP atualizado * ✅ Dados de proventos #### Alpha Vantage ```typescript // FIIs NÃO suportados const response = await fetch( "https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=MXRF11.SAO&apikey=KEY" ); const data = await response.json(); // Resultado: Erro ou dados vazios ``` **Suporte FIIs:** * ❌ Não reconhece tickers de FIIs * ❌ Sem dados de proventos * ❌ Sem métricas específicas de FIIs ### BDRs (Brazilian Depositary Receipts) | Aspecto | brapi.dev | Alpha Vantage | | ----------------- | ---------- | ---------------- | | Cobertura | 800+ BDRs | \~50 principais | | Dados | Completos | Básicos | | Conversão USD/BRL | Automática | Manual | | Dividendos | ✅ Inclusos | ❌ Não disponível | *** ## Dados Fundamentalistas ### brapi.dev - Análise Profunda ```typescript // Dados fundamentalistas completos const response = await fetch("https://brapi.dev/api/quote/ITUB4?modules=defaultKeyStatistics,financialData", { headers: { Authorization: "Bearer SEU_TOKEN" } }); const { results } = await response.json(); const data = results[0]; const stats = data.defaultKeyStatistics ?? {}; const financials = data.financialData ?? {}; // 50+ indicadores disponíveis: const fundamentals = { // Valuation pl: data.priceEarnings ?? stats.trailingPE, pvp: stats.priceToBook, evReceita: stats.enterpriseToRevenue, evEbitda: stats.enterpriseToEbitda, // Rentabilidade roe: financials.returnOnEquity, roa: financials.returnOnAssets, margemLiquida: financials.profitMargins, margemEbitda: financials.ebitdaMargins, // Dividendos dividendYield: stats.dividendYield, // Endividamento dividaPl: financials.debtToEquity, dividaTotal: financials.totalDebt, // Crescimento crescReceita: financials.revenueGrowth, crescLucro: financials.earningsGrowth, }; ``` **Indicadores brapi.dev:** * ✅ 50+ métricas fundamentalistas * ✅ Balanço patrimonial completo * ✅ DRE (Demonstração de Resultados) * ✅ Fluxo de caixa * ✅ Histórico de indicadores ### Alpha Vantage - Dados Limitados para Brasil ```typescript // Alpha Vantage - Overview para ações brasileiras const response = await fetch( "https://www.alphavantage.co/query?function=OVERVIEW&symbol=ITUB4.SAO&apikey=KEY" ); const data = await response.json(); // Resultado: Muitos campos vazios ou inexistentes para Brasil ``` **Indicadores Alpha Vantage:** * ⚠️ P/L (quando disponível) * ⚠️ EPS básico * ❌ Sem balanço para empresas BR * ❌ Sem DRE para empresas BR * ❌ Métricas geralmente indisponíveis ### Comparativo de Dados Fundamentalistas | Indicador | brapi.dev | Alpha Vantage | | ------------------- | ------------------- | -------------------- | | P/L | ✅ | ⚠️ (parcial) | | P/VP | ✅ | ❌ | | ROE | ✅ | ❌ | | ROA | ✅ | ❌ | | ROIC | ✅ | ❌ | | Dividend Yield | ✅ | ❌ | | Margem Líquida | ✅ | ❌ | | Dívida/PL | ✅ | ❌ | | EV/EBITDA | ✅ | ❌ | | Balanço Patrimonial | ✅ | ❌ | | DRE | ✅ | ❌ | | Fluxo de Caixa | ✅ | ❌ | | **Total** | **50+ indicadores** | **5-10 indicadores** | *** ## Preços e Planos ### brapi.dev | Plano | Preço | Requisições | Features | | -------------- | ------------- | ----------- | ----------------------- | | **Free** | Grátis | 15.000/mês | Cotações básicas | | **Startup** | R$ 119,99/mês | 150.000/mês | + Fundamentalistas | | **Pro** | R$ 139,99/mês | 500.000/mês | + Histórico completo | | **Enterprise** | Sob consulta | Ilimitado | + SLA, suporte dedicado | ### Alpha Vantage | Plano | Preço | Requisições | Features | | ---------------- | --------------- | ------------------ | ----------------- | | **Free** | Grátis | 25/dia (\~750/mês) | Dados básicos | | **75 req/min** | US$ 49,99/mês | Sem limite diário | Premium + suporte | | **150 req/min** | US$ 99,99/mês | Sem limite diário | Premium + suporte | | **300+ req/min** | US$ 149,99+/mês | Sem limite diário | Premium + suporte | ### Análise de Custo-Benefício **Cenário: 10.000 requisições/mês para dados brasileiros** | API | Custo Mensal | Dados Recebidos | | -------------------------- | ------------ | --------------------------------------------------------- | | brapi.dev (Startup) | R$ 119,99 | Completos, fundamentalistas, FIIs, BDRs | | Alpha Vantage (75 req/min) | US$ 49,99 | Limitados para Brasil, sem FIIs, fundamentalistas básicos | Mesmo com o reajuste, a brapi.dev continua mais adequada para quem precisa de dados brasileiros completos, porque o plano Startup já inclui volume mensal previsível e cobertura local que a Alpha Vantage não entrega para FIIs, BDRs e demonstrativos brasileiros. **Resumo de Custos:** | Cenário | brapi.dev | Alpha Vantage | Economia | | ------------ | --------- | ------------- | ---------------- | | 10k req/mês | R$ 119,99 | US$ 49,99 | Varia com câmbio | | 150k req/mês | R$ 119,99 | US$ 49,99+ | Varia com câmbio | | 500k req/mês | R$ 139,99 | US$ 49,99+ | Varia com câmbio | *** ## Latência e Performance ### Testes de Latência (Brasil) Resultados de benchmark com 100 iterações a partir de servidor em São Paulo: | Métrica | brapi.dev | Alpha Vantage | | ------------- | --------- | ------------- | | Média | 45ms | 380ms | | P50 (mediana) | 38ms | 320ms | | P99 | 120ms | 850ms | ### Comparativo de Performance **Latência média - Brasil:** * **brapi.dev:** 45ms ████░░░░░░░░░░░░░░░░ * **Alpha Vantage:** 380ms ██████████████████░░ **Diferença: 8.4x mais rápido** **Por que brapi.dev é mais rápido?** 1. **Servidores no Brasil** - Menor distância física 2. **CDN Edge** - Cache distribuído na América Latina 3. **Otimização para o mercado brasileiro** - Dados pré-processados 4. **Infraestrutura Vercel** - Edge functions otimizadas *** ## Facilidade de Integração ### brapi.dev ```typescript // TypeScript - Simples e direto async function getQuote(ticker: string) { const response = await fetch(`https://brapi.dev/api/quote/${ticker}`, { headers: { Authorization: "Bearer TOKEN" } }); const { results } = await response.json(); return results[0]; } // Múltiplas ações em uma requisição const response = await fetch("https://brapi.dev/api/quote/PETR4,VALE3,ITUB4", { headers: { Authorization: "Bearer TOKEN" } }); ``` ```typescript // TypeScript/Next.js - SDK oficial import { brapi } from '@brapi/sdk'; const client = brapi({ token: 'TOKEN' }); // Type-safe const quote = await client.quote('PETR4'); console.log(quote.regularMarketPrice); // TypeScript sabe o tipo ``` ### Alpha Vantage ```typescript // TypeScript - Mais verboso async function getQuote(ticker: string) { const response = await fetch( `https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=${ticker}.SAO&apikey=API_KEY` ); const data = await response.json(); // Estrutura de resposta aninhada return data["Global Quote"] ?? {}; } // Apenas uma ação por requisição // Para 10 ações = 10 requisições ``` ### Comparativo de DX (Developer Experience) | Aspecto | brapi.dev | Alpha Vantage | | ------------------ | -------------------- | ---------------- | | Múltiplos tickers | ✅ Uma requisição | ❌ Uma por ticker | | Formato de símbolo | `PETR4` | `PETR4.SAO` | | SDK oficial | ✅ TypeScript, Python | ⚠️ Comunidade | | Docs em PT-BR | ✅ Completa | ❌ Inglês apenas | | Playground | ✅ Interativo | ❌ Não tem | | Exemplos de código | ✅ Extensivos | ⚠️ Básicos | *** ## Casos de Uso ### Quando Usar brapi.dev 1. **Foco no Brasil** * Aplicações para investidores brasileiros * Análise fundamentalista de empresas BR * Dashboards de carteira nacional 2. **Fundos Imobiliários** * Calculadoras de renda passiva * Comparadores de FIIs * Alertas de dividendos 3. **Análise Fundamentalista** * Screening de ações * Valuation automatizado * Relatórios de empresas 4. **Performance Crítica** * Apps real-time * Trading systems * Alertas de preço ### Quando Usar Alpha Vantage 1. **Foco Internacional** * Ações americanas (NYSE, NASDAQ) * Mercados europeus e asiáticos * Forex global 2. **Indicadores Técnicos** * SMA, EMA, RSI, MACD prontos * Análise técnica automatizada * Backtesting 3. **Criptomoedas Globais** * Bitcoin, Ethereum * Altcoins * Dados de exchanges internacionais ### Quando Usar Ambos ```typescript // Estratégia híbrida - roteamento automático class FinanceAPI { constructor( private brapiToken: string, private alphaKey: string ) {} async getBrazilianStock(ticker: string) { const response = await fetch(`https://brapi.dev/api/quote/${ticker}`, { headers: { Authorization: `Bearer ${this.brapiToken}` } }); return response.json(); } async getUSStock(ticker: string) { const response = await fetch( `https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=${ticker}&apikey=${this.alphaKey}` ); return response.json(); } async getStock(ticker: string) { // Roteamento automático baseado no padrão brasileiro const isBrazilian = /\d{1,2}$/.test(ticker); // termina em número return isBrazilian ? this.getBrazilianStock(ticker) : this.getUSStock(ticker); } } ``` *** ## Migração de Alpha Vantage para brapi.dev ### Passo 1: Mapeamento de Endpoints | Alpha Vantage | brapi.dev | | ------------------- | ---------------------------------------------------------------- | | `GLOBAL_QUOTE` | `/api/quote/{ticker}` | | `TIME_SERIES_DAILY` | `/api/quote/{ticker}?range=1y&interval=1d` | | `OVERVIEW` | `/api/quote/{ticker}?modules=defaultKeyStatistics,financialData` | | `INCOME_STATEMENT` | `/api/quote/{ticker}?modules=incomeStatementHistory` | | `BALANCE_SHEET` | `/api/quote/{ticker}?modules=balanceSheetHistory` | ### Passo 2: Adaptação do Código **Antes (Alpha Vantage):** ```typescript async function getPriceAlpha(ticker: string): Promise { const response = await fetch( `https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=${ticker}.SAO&apikey=${ALPHA_KEY}` ); const data = await response.json(); const quote = data["Global Quote"] ?? {}; return parseFloat(quote["05. price"] ?? "0"); } ``` **Depois (brapi.dev):** ```typescript async function getPriceBrapi(ticker: string): Promise { const response = await fetch(`https://brapi.dev/api/quote/${ticker}`, { headers: { Authorization: `Bearer ${BRAPI_TOKEN}` } }); const { results } = await response.json(); return results[0].regularMarketPrice; } ``` ### Passo 3: Wrapper de Compatibilidade ```typescript // Wrapper para migração gradual - simula interface do Alpha Vantage usando brapi.dev class AlphaVantageCompat { constructor(private brapiToken: string) {} async query(func: string, symbol: string) { const ticker = symbol.replace(".SAO", ""); switch (func) { case "GLOBAL_QUOTE": return this.globalQuote(ticker); case "TIME_SERIES_DAILY": return this.timeSeries(ticker); case "OVERVIEW": return this.overview(ticker); default: throw new Error(`Function ${func} not supported`); } } private async globalQuote(ticker: string) { const response = await fetch(`https://brapi.dev/api/quote/${ticker}`, { headers: { Authorization: `Bearer ${this.brapiToken}` } }); const { results } = await response.json(); const data = results[0]; // Retorna no formato Alpha Vantage return { "Global Quote": { "01. symbol": data.symbol, "05. price": String(data.regularMarketPrice), "09. change": String(data.regularMarketChange), "10. change percent": `${data.regularMarketChangePercent}%` } }; } } ``` *** ## Limitações de Cada API ### Limitações brapi.dev | Limitação | Workaround | | -------------------------------- | ------------------------------------ | | Apenas mercado brasileiro | Use Alpha Vantage para internacional | | Sem indicadores técnicos prontos | Calcule localmente ou use TA-Lib | | Crypto limitado | Use endpoint `/v2/crypto` | ### Limitações Alpha Vantage | Limitação | Workaround | | -------------------------- | ------------------------------- | | Cobertura BR limitada | Use brapi.dev para Brasil | | 1 ticker por requisição | Cache agressivo | | Fundamentalistas BR vazios | brapi.dev para fundamentalistas | | Latência alta no Brasil | Edge caching | | Sem FIIs | brapi.dev para FIIs | *** ## Conclusão ### Resumo Final **📊 Mercado Brasileiro (FIIs, BDRs) → brapi.dev** * ✓ Cobertura completa * ✓ Dados fundamentalistas * ✓ Melhor preço * ✓ Suporte em português **🌍 Mercados Internacionais → Alpha Vantage** * ✓ NYSE, NASDAQ, global * ✓ Forex * ✓ Indicadores técnicos **🔄 Estratégia Híbrida → brapi.dev + Alpha Vantage** * ✓ Cobertura completa global * ✓ Melhor de cada mundo ### Para o Mercado Brasileiro: brapi.dev Vence * **Cobertura**: 400+ ações vs \~100 * **FIIs**: Completo vs inexistente * **Fundamentalistas**: 50+ indicadores vs básico * **Preço**: planos em reais, com volume mensal previsível para uso no Brasil * **Latência**: 8x mais rápido * **Suporte**: Português nativo ### Próximos Passos 1. [Crie sua conta grátis na brapi.dev](/signup) 2. [Explore a documentação](/docs) 3. [Teste no playground interativo](/playground) 4. [Veja exemplos de código](/docs/examples) *** **Pronto para dados brasileiros de verdade?** Comece com 15.000 requisições grátis por mês e veja a diferença! # brapi vs Economatica 2026: API Acessível vs Plataforma Institucional URL: /blog/brapi-vs-economatica-comparativo.mdx Comparativo entre brapi.dev e Economatica. Entenda as diferenças: API moderna e acessível vs terminal institucional tradicional, preços e casos de uso ideais. *** searchable: true title: 'brapi vs Economatica 2026: API Acessível vs Plataforma Institucional' description: 'Comparativo entre brapi.dev e Economatica. Entenda as diferenças: API moderna e acessível vs terminal institucional tradicional, preços e casos de uso ideais.' date: '2025-12-27' keywords: 'brapi vs economatica, api acoes brasil, alternativa economatica, economatica preco, dados financeiros api, api de ações brasileiras barata, 2026' author: 'Equipe brapi.dev' category: 'Comparativos' subcategory: 'APIs Financeiras' readingTime: '10 min' tags: \['API', 'Economatica', 'Comparativo', 'Desenvolvedores', 'Bolsa Brasileira', 'Dados Financeiros', 'Institucional'] relatedPosts: \['brapi-vs-yahoo-finance-api-comparativo-completo', 'brapi-vs-alpha-vantage-api-comparativo', 'brapi-vs-statusinvest-comparativo', 'b3-api-gratuita-como-usar-cotacoes'] featured: false expertise: 'Equipe técnica especializada em APIs financeiras e integração de dados' lastReviewed: 2026-06-05 ------------------------ import { Authors, Author } from '~/components/Authors'; > Precisa de dados do mercado brasileiro mas não tem orçamento institucional? Neste comparativo, analisamos as diferenças entre brapi.dev (API moderna e acessível) e Economatica (plataforma tradicional para grandes instituições). *** ## Resumo Executivo | Aspecto | brapi.dev | Economatica | | ---------------- | ----------------------------------- | ---------------------------------- | | **Público-alvo** | Desenvolvedores, startups, fintechs | Bancos, gestoras, grandes empresas | | **Modelo** | API RESTful moderna | Terminal + Excel Add-in | | **Preço** | A partir de R$ 0/mês | R$ 2.000-10.000+/mês | | **Contrato** | Mensal, sem fidelidade | Anual com fidelidade | | **Integração** | JSON/REST simples | Proprietária | | **Suporte** | Português, chat/email | Português, dedicado | | **Histórico** | Até 30 anos | 40+ anos | **Veredito Rápido:** brapi para startups, desenvolvedores e projetos com orçamento limitado. Economatica para grandes instituições com orçamento corporativo. *** ## O Que é a Economatica? A Economatica é uma plataforma tradicional de dados financeiros fundada em 1986. Ela oferece: * Terminal de análise proprietário * Add-in para Excel * Dados históricos extensivos (40+ anos) * Cobertura América Latina * Foco em clientes institucionais **Preço:** R$ 2.000 a R$ 10.000+/mês conforme produto, módulos, usuários e formato de entrega. *** ## O Que é a brapi? A brapi.dev é uma API moderna de dados financeiros brasileiros. Ela oferece: * API RESTful com resposta JSON * Integração simples via HTTP * Documentação em português * Foco em desenvolvedores e startups * Preços acessíveis **Preço:** Gratuito até R$ 139,99/mês para uso comercial completo. *** ## Comparativo de Preços ### Custo Real por Tamanho de Empresa | Perfil | Economatica | brapi.dev | Leitura prática | | -------------------- | ----------------- | --------------------- | ---------------------------------------------------------------------------------- | | Desenvolvedor solo | ❌ \~R$ 2.000/mês | ✅ R$ 0 | brapi é mais simples para começar | | Startup (5 pessoas) | ❌ \~R$ 3.000/mês | ✅ R$ 119,99/mês | brapi tem preço público e baixo risco inicial | | Fintech (20 pessoas) | ⚠️ \~R$ 5.000/mês | ✅ R$ 139,99/mês | brapi cobre automação via API sem contrato enterprise | | Banco/Gestora | ✅ Apropriado | ⚠️ Pode precisar mais | Economatica pode fazer sentido para terminal, data feed e workflows institucionais | ### Análise de ROI ``` CENÁRIO: Startup desenvolvendo app de investimentos ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Economatica: - Custo anual: sob proposta comercial - Contrato: depende da negociação - Risco: maior esforço de compra e implantação brapi.dev: - Custo anual: R$ 1.439,88 (R$ 119,99/mês x 12) - Contrato: Mensal, cancele quando quiser - Risco: Baixo, escala conforme cresce 💰 Vantagem: preço público, contratação simples e validação rápida antes de escalar ``` *** ## Comparativo Técnico ### Facilidade de Integração **brapi.dev - API Moderna:** ```typescript const response = await fetch('https://brapi.dev/api/quote/PETR4') const dados = await response.json() // dados.results[0].regularMarketPrice → Preço atual ``` **Economatica - Processo Tradicional:** 1. Contato comercial 2. Proposta e negociação 3. Contrato anual 4. Instalação de software 5. Treinamento 6. Uso via terminal ou Excel ### Formatos de Dados | Formato | brapi.dev | Economatica | | -------- | ------------------- | --------------- | | JSON | ✅ Nativo | ❌ | | REST API | ✅ | ❌ | | Excel | ✅ Via import | ✅ Add-in nativo | | CSV | ✅ Conversão simples | ✅ Export | | Terminal | ❌ | ✅ Nativo | ### Integrações **brapi.dev:** ```javascript // React/Next.js const data = await fetch('https://brapi.dev/api/quote/PETR4').then(r => r.json()); // Python import requests data = requests.get('https://brapi.dev/api/quote/PETR4').json() // Node.js const axios = require('axios'); const { data } = await axios.get('https://brapi.dev/api/quote/PETR4'); // Google Sheets =IMPORTJSON("https://brapi.dev/api/quote/PETR4", "/results/0/regularMarketPrice") ``` **Economatica:** * Terminal proprietário * Excel Add-in (Windows only) * Sem API HTTP pública *** ## Cobertura de Dados ### Dados Disponíveis | Dado | brapi.dev | Economatica | | ---------------------------- | ------------- | ----------- | | Cotações da Bolsa Brasileira | ✅ | ✅ | | Ações | ✅ | ✅ | | FIIs | ✅ | ✅ | | BDRs | ✅ | ✅ | | ETFs | ✅ | ✅ | | Fundamentalistas | ✅ | ✅ | | Balanço Patrimonial | ✅ | ✅ | | DRE | ✅ | ✅ | | Fluxo de Caixa | ✅ | ✅ | | Dividendos | ✅ | ✅ | | Histórico (anos) | \~30 | 40+ | | América Latina | ❌ BR apenas | ✅ | | Backtesting | ❌ | ✅ | | Screening avançado | ⚠️ Via código | ✅ Visual | ### Profundidade Histórica * **Economatica:** 40+ anos de dados para algumas empresas * **brapi:** Histórico disponível desde IPO para maioria das ações Para 99% dos casos de uso, ambos têm histórico suficiente. *** ## Casos de Uso ### Quando Escolher brapi.dev ✅ **Startups e Fintechs** * Orçamento limitado para dados * Precisa de API para integração * Time técnico que sabe programar ✅ **Desenvolvedores Independentes** * Apps de investimento * Bots de trading * Projetos pessoais ✅ **Empresas em Crescimento** * Validação de produto (MVP) * Escalar conforme demanda * Sem compromisso de fidelidade **Exemplo: Fintech construindo app de carteira** ```typescript // Calcular valor total da carteira const holdings = [ { ticker: 'PETR4', quantity: 100 }, { ticker: 'VALE3', quantity: 50 } ] const tickers = holdings.map(h => h.ticker).join(',') const response = await fetch( `https://brapi.dev/api/quote/${tickers}`, { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() const total = holdings.reduce((sum, h, i) => sum + h.quantity * data.results[i].regularMarketPrice, 0 ) ``` **Custo brapi:** R$ 119,99/mês para 150.000 requisições vs **Economatica:** R$ 3.000+/mês ### Quando Escolher Economatica ✅ **Grandes Instituições Financeiras** * Bancos de investimento * Gestoras de fundos (bilhões sob gestão) * Orçamento corporativo disponível ✅ **Análises Institucionais** * Backtesting complexo * Screening visual avançado * Relatórios para clientes institucionais ✅ **Cobertura América Latina** * Precisa de dados de Argentina, Chile, México, etc. * Comparativos regionais *** ## Migração: Economatica para brapi Se você está considerando migrar para economizar: ### Checklist de Compatibilidade | Recurso Economatica | Alternativa brapi | | ------------------- | ------------------------ | | Cotações Brasil | ✅ Idêntico | | Fundamentalistas | ✅ Idêntico | | Histórico | ✅ Similar | | Excel Add-in | ⚠️ Via IMPORTJSON ou VBA | | Screening visual | ⚠️ Via código | | Backtesting | ⚠️ Via código | | América Latina | ❌ Não disponível | ### Código de Migração **Substituindo chamadas Economatica por brapi:** ```typescript // Obtém dados fundamentalistas equivalentes à Economatica const response = await fetch( 'https://brapi.dev/api/quote/ITUB4?modules=defaultKeyStatistics,financialData,balanceSheetHistory,incomeStatementHistory', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() const stock = data.results[0] // Acesse os dados: // stock.defaultKeyStatistics.trailingPE → P/L // stock.financialData.returnOnEquity → ROE ``` > **Resultado:** dados programáticos com contratação simples e preço público, quando o seu caso de uso não exige terminal institucional, data feed proprietário ou cobertura regional ampla. *** ## Comparativo Final ### Pontos Fortes brapi.dev | Vantagem | Impacto | | ------------------------- | ----------------------------------- | | Preço público e acessível | Validação sem negociação enterprise | | API moderna (REST/JSON) | Integração em minutos | | Sem fidelidade | Flexibilidade total | | Documentação PT-BR | Desenvolvimento rápido | | Suporte responsivo | Resolução ágil | ### Pontos Fortes Economatica | Vantagem | Impacto | | ------------------ | ----------------------- | | Histórico 40+ anos | Backtesting longo | | Terminal visual | Análise sem código | | América Latina | Cobertura regional | | Excel nativo | Familiar para analistas | | Suporte dedicado | Atendimento premium | *** ## Conclusão ### Escolha brapi.dev se: * Tem orçamento limitado (\< R$ 1.000/mês para dados) * Precisa de API para integração * Está construindo produto/app * Quer flexibilidade sem contratos longos * Foca no mercado brasileiro ### Escolha Economatica se: * Tem orçamento corporativo e processo de contratação enterprise * Precisa de terminal visual * Requer cobertura América Latina * Analistas preferem Excel nativo * Necessita de backtesting visual ### A Verdade Para 90% das startups, fintechs e desenvolvedores, a brapi oferece tudo que você precisa por uma fração do custo da Economatica. A Economatica é excelente para grandes instituições que precisam de recursos específicos e têm orçamento para isso. *** ## Próximos Passos 1. **[Teste a brapi gratuitamente](https://brapi.dev)** - 15.000 requisições/mês sem custo 2. **[Veja a documentação](/docs)** - Integre em minutos 3. **[Compare os planos](/pricing)** - Escolha o ideal para você 4. **[Fale conosco](/contact)** - Tire suas dúvidas *** *Comece com preço público e API em minutos. [Teste a brapi.dev gratuitamente](https://brapi.dev).* # brapi vs HG Brasil API 2026: Comparativo Completo para Dados Financeiros URL: /blog/brapi-vs-hgbrasil-api-comparativo.mdx Comparativo técnico entre brapi.dev e HG Brasil API. Descubra qual oferece melhores dados do mercado brasileiro: cotações, fundamentalistas, limites e preços *** searchable: true title: 'brapi vs HG Brasil API 2026: Comparativo Completo para Dados Financeiros' description: 'Comparativo técnico entre brapi.dev e HG Brasil API. Descubra qual oferece melhores dados do mercado brasileiro: cotações, fundamentalistas, limites e preços' date: '2026-01-01' keywords: 'brapi vs hgbrasil, api ações brasil, hg brasil api alternativa, melhor api bolsa brasileira, api de ações brasileiras, dados financeiros api, comparativo api ações, 2026' author: 'Equipe brapi.dev' category: 'Comparativos' subcategory: 'APIs Financeiras' readingTime: '12 min' tags: \['API', 'HG Brasil', 'Comparativo', 'Desenvolvedores', 'Bolsa Brasileira', 'Dados Financeiros', 'Integração'] relatedPosts: \['b3-api-gratuita-como-usar-cotacoes', 'brapi-vs-yahoo-finance-api-comparativo-completo', 'brapi-vs-alpha-vantage-api-comparativo', 'api-b3-python-requests-guia-pratico'] featured: false expertise: 'Equipe técnica especializada em APIs financeiras e integração de dados' lastReviewed: 2026-06-05 ------------------------ import { Authors, Author } from '~/components/Authors'; > HG Brasil e brapi.dev são duas APIs brasileiras para dados financeiros. Neste comparativo técnico, analisamos qual oferece melhor experiência para desenvolvedores que precisam de dados de ações, fundos e indicadores econômicos. *** ## Resumo Executivo | Critério | brapi.dev | HG Brasil | | -------------------- | -------------------- | ------------------ | | **Dados de Ações** | ✅ Completos | ⚠️ Básicos | | **Fundamentalistas** | ✅ BP, DRE, DFC, DVA | ❌ Não disponível | | **Dividendos** | ✅ Histórico completo | ✅ Conforme o plano | | **FIIs e BDRs** | ✅ Completo | ⚠️ Limitado | | **Moedas** | ✅ | ✅ | | **Indicadores** | ✅ IPCA, SELIC | ✅ CDI, SELIC | | **Plano Gratuito** | 15.000 req/mês | 400 req/dia | | **Documentação** | ✅ Extensa | ✅ Boa | **Veredito Rápido:** Para dados de ações e fundamentos, brapi.dev oferece cobertura muito mais completa. HG Brasil foca em cotações básicas e câmbio. *** ## Comparativo de Funcionalidades ### 1. Dados de Ações **brapi.dev - Cobertura Completa:** ```typescript const response = await fetch( "https://brapi.dev/api/quote/PETR4?modules=defaultKeyStatistics,financialData,balanceSheetHistory", { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const dados = results[0]; // Cotação + Fundamentalistas + Indicadores disponíveis // Preço, P/L, ROE, Balanço, DRE, etc. ``` **HG Brasil - Dados Básicos:** ```typescript const response = await fetch( `https://api.hgbrasil.com/finance/stock_price?key=${apiKey}&symbol=PETR4` ); const dados = await response.json(); // Apenas preço e variação básica // Sem dados fundamentalistas ou indicadores financeiros ``` ### 2. Dados Fundamentalistas | Módulo | brapi.dev | HG Brasil | | ---------------------- | ------------------ | --------- | | Balanço Patrimonial | ✅ Desde 2009 | ❌ | | DRE (Resultados) | ✅ Trimestral/Anual | ❌ | | Fluxo de Caixa | ✅ Completo | ❌ | | DVA | ✅ Completo | ❌ | | Indicadores (P/L, ROE) | ✅ | ❌ | | Estatísticas-Chave | ✅ | ❌ | **brapi.dev - Análise Fundamentalista Completa:** ```typescript const response = await fetch( "https://brapi.dev/api/quote/ITUB4?modules=balanceSheetHistory,incomeStatementHistory,cashflowHistory", { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const dados = results[0]; // Acesso a anos de histórico de demonstrativos const balanco = dados.balanceSheetHistory.balanceSheetHistory; const dre = dados.incomeStatementHistory.incomeStatementHistory; ``` ### 3. Dividendos **brapi.dev:** * ✅ Histórico completo de dividendos e JCP * ✅ Datas de declaração, ex e pagamento * ✅ Dados desde 2009 **HG Brasil:** * ✅ Dados de dividendos disponíveis conforme o plano * ⚠️ Sem o mesmo conjunto de demonstrativos e indicadores fundamentalistas da brapi.dev ```typescript // brapi.dev - Dividendos completos const response = await fetch( "https://brapi.dev/api/quote/BBAS3?dividends=true", { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const dividendos = results[0].dividendsData.cashDividends; // Acesso a datas de pagamento, valores por ação, etc. ``` ### 4. Dados Históricos **brapi.dev:** ```typescript // Até 10+ anos de histórico const response = await fetch( "https://brapi.dev/api/quote/VALE3?range=5y&interval=1d", { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const historico = results[0].historicalDataPrice; // Acesso a milhares de candles OHLCV ``` **HG Brasil:** * ⚠️ Histórico limitado * ⚠️ Menos intervalos disponíveis ### 5. Câmbio e Moedas Ambas as APIs oferecem dados de câmbio: **brapi.dev:** ```typescript const response = await fetch("https://brapi.dev/api/v2/currency?currency=USD-BRL,EUR-BRL"); const { currency } = await response.json(); // Array com name, bid, ask, etc. ``` **HG Brasil:** ```typescript const response = await fetch(`https://api.hgbrasil.com/finance?key=${apiKey}`); const dados = await response.json(); const usd = dados.results.currencies.USD; // Acesso a cotação de compra/venda ``` *** ## Preços e Limites ### Comparativo de Planos | Aspecto | brapi.dev Gratuito | HG Brasil Gratuito | | -------------------- | ------------------ | ------------------ | | Requisições | 15.000/mês | 400/dia | | Ações por requisição | 1 | 1 | | Dados históricos | 3 meses | Limitado | | Fundamentalistas | Básico | ❌ | | Aspecto | brapi.dev Pro | HG Brasil Pro | HG Brasil Startup | | ------------------- | -------------- | ------------- | ----------------- | | Preço mensal | R$ 139,99 | R$ 49,90 | R$ 119,90 | | Requisições | 500.000/mês | 10.000/dia | 25.000/dia | | Títulos simultâneos | 20 por chamada | 5 | 25 | | Fundamentalistas | ✅ Completo | ❌ | | | Dividendos | ✅ Completo | ✅ | | | Histórico | 10+ anos | 2 anos | 5 anos | ### Custo-Benefício ``` ANÁLISE DE CUSTO PARA DADOS COMPLETOS DE AÇÕES brapi.dev Pro (R$ 139,99/mês): ✅ 500.000 requisições ✅ Dados fundamentalistas completos ✅ Histórico de dividendos ✅ 10+ anos de cotações ✅ Indicadores financeiros HG Brasil: ✅ Planos publicados a partir de R$ 24,90/mês ✅ Cotações básicas ✅ Câmbio e indicadores ✅ Dividendos e histórico conforme o plano ❌ Sem demonstrativos fundamentalistas completos ❌ Histórico financeiro mais limitado que o Pro da brapi Para análise de ações → brapi.dev Para apenas câmbio → Ambos funcionam ``` *** ## Quando Usar Cada API ### Escolha brapi.dev quando precisar de: ✅ Análise fundamentalista de ações ✅ Dados completos de dividendos ✅ Histórico longo de cotações (10+ anos) ✅ Indicadores financeiros (P/L, ROE, EV/EBITDA) ✅ Balanços e DREs trimestrais ✅ Dados de FIIs e BDRs ✅ Maior volume de requisições ### Escolha HG Brasil quando precisar de: ✅ Apenas cotações básicas de ações ✅ Dados de câmbio ✅ Indicadores econômicos (CDI, SELIC) ✅ Projeto simples com baixo volume *** ## Migração de HG Brasil para brapi.dev ### Antes (HG Brasil): ```typescript async function getStockHG(symbol: string, apiKey: string) { const response = await fetch( `https://api.hgbrasil.com/finance/stock_price?key=${apiKey}&symbol=${symbol}` ); return response.json(); } ``` ### Depois (brapi.dev): ```typescript async function getStockBrapi(symbol: string, token?: string) { const url = `https://brapi.dev/api/quote/${symbol}`; const headers = token ? { Authorization: `Bearer ${token}` } : {}; const response = await fetch(url, { headers }); return response.json(); } // Mesma simplicidade, mais dados disponíveis const dados = await getStockBrapi("PETR4", token); // Agora você pode adicionar: // - Fundamentalistas: ?modules=defaultKeyStatistics // - Dividendos: ?dividends=true // - Histórico: ?range=1y&interval=1d ``` *** ## Conclusão | Se você precisa de... | Recomendação | | ---------------------- | ------------------------ | | Análise de ações BR | **brapi.dev** | | Dados fundamentalistas | **brapi.dev** | | Dividendos | **brapi.dev** | | Apenas câmbio | Ambos | | Maior volume grátis | **brapi.dev** (15x mais) | | APIs complementares | Use ambas | ### Próximos Passos 1. **[Crie sua conta gratuita](https://brapi.dev)** - 15.000 requisições/mês 2. **[Explore a documentação](/docs)** - Guias completos 3. **[Teste no Playground](/playground)** - Sem código 4. **[Veja exemplos de integração](/docs/examples)** - Python, JS, Excel *** *Compare você mesmo! [Teste a brapi.dev gratuitamente](https://brapi.dev) e veja a diferença nos dados de ações brasileiras.* # brapi vs StatusInvest 2026: API de Dados vs Plataforma de Análise URL: /blog/brapi-vs-statusinvest-comparativo.mdx Comparativo brapi.dev vs StatusInvest. Diferenças: API programática vs plataforma visual, automação vs análise manual ✓ *** searchable: true title: 'brapi vs StatusInvest 2026: API de Dados vs Plataforma de Análise' description: 'Comparativo brapi.dev vs StatusInvest. Diferenças: API programática vs plataforma visual, automação vs análise manual ✓' date: '2026-01-02' keywords: 'brapi vs statusinvest, api acoes brasil, statusinvest api, alternativa statusinvest, dados financeiros api, automacao investimentos, 2026' author: 'Equipe brapi.dev' category: 'Comparativos' subcategory: 'APIs Financeiras' readingTime: '12 min' tags: \['API', 'StatusInvest', 'Comparativo', 'Desenvolvedores', 'Bolsa Brasileira', 'Dados Financeiros', 'Automação'] relatedPosts: \['brapi-vs-yahoo-finance-api-comparativo-completo', 'brapi-vs-alpha-vantage-api-comparativo', 'brapi-vs-hgbrasil-api-comparativo', 'b3-api-gratuita-como-usar-cotacoes'] featured: false expertise: 'Equipe técnica especializada em APIs financeiras e integração de dados' lastReviewed: 2026-06-05 ------------------------ import { Authors, Author } from '~/components/Authors'; > Você quer automatizar suas análises de investimentos ou prefere usar uma plataforma visual? Neste comparativo, explicamos as diferenças fundamentais entre brapi.dev (API) e StatusInvest (plataforma) e quando usar cada um. *** ## Resumo: São Produtos Diferentes | Aspecto | brapi.dev | StatusInvest | | -------------------- | ------------------------ | ------------------------ | | **Tipo** | API para desenvolvedores | Plataforma web visual | | **Uso Principal** | Automação e integração | Análise manual | | **Acesso aos Dados** | Programático (HTTP/JSON) | Interface gráfica | | **Ideal Para** | Apps, bots, sistemas | Investidores individuais | | **Personalização** | Total (você constrói) | Limitada ao que oferecem | | **Automação** | Nativa | Não disponível | **Veredito Rápido:** São produtos complementares. brapi para automação e desenvolvimento, StatusInvest para análise visual manual. *** ## Entendendo as Diferenças Fundamentais ### brapi.dev: API para Desenvolvedores A brapi é uma **API RESTful** que retorna dados em formato JSON. Você usa em: * Aplicações web e mobile * Bots de trading automatizado * Planilhas automatizadas * Sistemas de gestão de carteira * Integrações com outras ferramentas ```typescript const response = await fetch('https://brapi.dev/api/quote/PETR4,VALE3,ITUB4') const dados = await response.json() // dados.results contém array com cotações ``` ### StatusInvest: Plataforma Visual O StatusInvest é uma **plataforma web** para análise visual. Você usa para: * Ver gráficos e indicadores * Comparar ações manualmente * Ler análises e recomendações * Acompanhar sua carteira visualmente **Não há API oficial** - dados são consumidos apenas pela interface web. *** ## Comparativo por Caso de Uso ### 1. Construir um App de Carteira | Requisito | brapi.dev | StatusInvest | | ---------------------------- | ------------------ | -------------- | | Obter cotações em tempo real | ✅ API simples | ❌ Sem API | | Calcular rentabilidade | ✅ Dados históricos | ❌ Manual | | Atualizar automaticamente | ✅ Requisições | ❌ Não possível | | Integrar com banco de dados | ✅ JSON nativo | ❌ Não possível | **Vencedor: brapi.dev** - StatusInvest não oferece API para integração. ### 2. Analisar uma Ação Visualmente | Requisito | brapi.dev | StatusInvest | | ---------------------------- | --------------- | ---------------- | | Ver gráficos prontos | ❌ Retorna dados | ✅ Interface rica | | Indicadores fundamentalistas | ✅ Via módulos | ✅ Visual | | Comparar ações lado a lado | ❌ Você constrói | ✅ Pronto | | Sem precisar programar | ❌ Requer código | ✅ Interface | **Vencedor: StatusInvest** - Melhor para quem não programa. ### 3. Automatizar Alertas de Preço | Requisito | brapi.dev | StatusInvest | | ------------------------- | ------------- | -------------------- | | Monitorar preços | ✅ Polling API | ⚠️ Alertas limitados | | Lógica personalizada | ✅ Você define | ❌ Fixo | | Notificação personalizada | ✅ Seu sistema | ⚠️ Email/push | | Múltiplas condições | ✅ Ilimitadas | ❌ Básico | **Vencedor: brapi.dev** - Flexibilidade total para automação. *** ## Dados Disponíveis ### brapi.dev - Dados Programáticos ```typescript // Cotação atual const cotacao = await fetch('https://brapi.dev/api/quote/ITUB4') // Dados fundamentalistas const fundamentalista = await fetch( 'https://brapi.dev/api/quote/ITUB4?modules=balanceSheetHistory,incomeStatementHistory,defaultKeyStatistics', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) // Histórico de preços (1 ano, diário) const historico = await fetch( 'https://brapi.dev/api/quote/ITUB4?range=1y&interval=1d', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) // Dividendos const dividendos = await fetch( 'https://brapi.dev/api/quote/ITUB4?dividends=true', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) ``` **Módulos disponíveis:** * Balanço Patrimonial (BP) * Demonstração de Resultados (DRE) * Fluxo de Caixa (DFC) * Demonstração do Valor Adicionado (DVA) * Indicadores fundamentalistas * Dividendos históricos * Estatísticas chave ### StatusInvest - Dados Visuais O StatusInvest exibe dados similares, mas apenas visualmente: * Gráficos de cotação interativos * Tabelas de indicadores * Comparadores visuais * Histórico de dividendos em gráficos * Ranking de ações **Limitação:** Não há forma programática de acessar esses dados. *** ## Quando Usar Cada Um ### Use brapi.dev quando: ✅ **Precisa automatizar** qualquer processo com dados de ações ✅ **Está desenvolvendo** aplicações, bots ou sistemas ✅ **Quer integrar** dados financeiros em suas ferramentas ✅ **Precisa de dados estruturados** (JSON) para processamento ✅ **Quer atualização automática** sem intervenção manual ```typescript // Exemplo: Bot de alerta de oportunidades const tickers = ['PETR4', 'VALE3', 'ITUB4', 'WEGE3'] const limitePL = 8 const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(',')}?modules=defaultKeyStatistics`, { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() for (const acao of data.results) { const pl = acao.defaultKeyStatistics?.trailingPE ?? 999 if (pl < limitePL) { console.log(`🚨 ${acao.symbol} com P/L = ${pl.toFixed(2)}`) } } ``` ### Use StatusInvest quando: ✅ **Quer análise visual** rápida e pronta ✅ **Não sabe programar** e precisa de interface amigável ✅ **Busca comparativos visuais** de ações ✅ **Quer acompanhar carteira** manualmente ✅ **Precisa de gráficos prontos** para apresentações *** ## Preços e Limites ### brapi.dev - Planos com API | Plano | Preço | Requisições/mês | Recursos | | -------- | --------- | --------------- | ------------------ | | Gratuito | R$ 0 | 15.000 | Cotações básicas | | Startup | R$ 119,99 | 150.000 | + Fundamentalistas | | Pro | R$ 139,99 | 500.000 | + Todos os módulos | **Características:** * API RESTful documentada * Suporte em português * Dados em tempo real (delay por plano) * Multi-ticker em uma requisição ### StatusInvest - Planos Visuais | Plano | Preço | Recursos | | ---------------- | ------------ | ----------------------------------------------------- | | Gratuito | R$ 0 | Dados básicos com anúncios | | Bull | R$ 21,90/mês | Carteiras, dividendos, comparações e recursos premium | | Forecast | R$ 20,90/mês | Projeções para Brasil e EUA | | Integração B3 | R$ 5,00/mês | Sincronização automática de carteira | | Imposto de Renda | R$ 30,42/mês | Cálculo fiscal e DARFs | | Status Alpha | R$ 99,75/mês | Recomendações e portfólios por IA | **Características:** * Interface visual completa * Gráficos interativos * Comparadores de ações * Carteira virtual *** ## Integrações ### brapi.dev - Integrações Programáticas ```javascript // React/Next.js const { data } = await fetch('https://brapi.dev/api/quote/PETR4'); // Google Sheets =IMPORTJSON("https://brapi.dev/api/quote/PETR4") // Excel VBA response = http.Get("https://brapi.dev/api/quote/PETR4") // Python Pandas df = pd.DataFrame(requests.get("...").json()['results']) // Node.js const data = await axios.get('https://brapi.dev/api/quote/PETR4'); ``` ### StatusInvest - Sem Integrações O StatusInvest não oferece: * API oficial * Webhooks * Exportação programática * Integrações com ferramentas *** ## Exemplo Prático: Dashboard Automatizado ### Com brapi.dev ```typescript // Dashboard automatizado de carteira const carteira = [ { ticker: 'PETR4', qtd: 100, precoMedio: 28.5 }, { ticker: 'VALE3', qtd: 50, precoMedio: 68.0 }, { ticker: 'ITUB4', qtd: 200, precoMedio: 25.0 }, ] const tickers = carteira.map(c => c.ticker).join(',') const response = await fetch( `https://brapi.dev/api/quote/${tickers}?modules=defaultKeyStatistics÷nds=true`, { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Calcular rendimento de cada ativo for (let i = 0; i < carteira.length; i++) { const c = carteira[i] const d = data.results[i] const valorAtual = d.regularMarketPrice * c.qtd const valorInvestido = c.precoMedio * c.qtd const rendimento = ((valorAtual - valorInvestido) / valorInvestido) * 100 console.log(`${d.symbol}: R$ ${valorAtual.toFixed(2)} (${rendimento.toFixed(2)}%)`) } ``` **Exemplo de relatório gerado:** | Ação | Qtd | Valor Atual | Rendimento | | --------- | --- | ---------------- | ----------- | | 🟢 PETR4 | 100 | R$ 3.850,00 | +35,09% | | 🔴 VALE3 | 50 | R$ 3.090,00 | -9,12% | | 🟢 ITUB4 | 200 | R$ 6.560,00 | +31,20% | | **TOTAL** | - | **R$ 13.500,00** | **+18,75%** | ### Com StatusInvest Não é possível criar dashboards automatizados - você precisaria: 1. Abrir o site manualmente 2. Navegar até cada ação 3. Copiar os dados manualmente 4. Colar em uma planilha 5. Repetir periodicamente *** ## Conclusão ### brapi.dev é para você se: * Sabe ou quer aprender programação * Precisa de automação de dados * Está construindo aplicações * Quer integrar dados em outros sistemas * Busca flexibilidade total ### StatusInvest é para você se: * Prefere interfaces visuais prontas * Não quer/precisa programar * Faz análises manuais ocasionais * Busca gráficos e comparadores prontos ### Usando Ambos Muitos desenvolvedores usam ambos: * **StatusInvest** para análise visual rápida e descoberta de ações * **brapi** para automatizar o monitoramento e integrar em sistemas *** ## Próximos Passos 1. **[Crie sua conta gratuita na brapi](https://brapi.dev)** - 15.000 requisições/mês 2. **[Explore a documentação](/docs)** - Guias de integração 3. **[Teste no playground](/playground)** - Experimente a API 4. **[Veja exemplos de código](/docs/examples)** - Python, JavaScript, Excel *** *Automatize suas análises de investimentos com a brapi.dev. [Comece gratuitamente agora!](https://brapi.dev)* # brapi vs Yahoo Finance API 2026: Comparativo Completo para Desenvolvedores URL: /blog/brapi-vs-yahoo-finance-api-comparativo-completo.mdx Comparativo brapi.dev vs Yahoo Finance API. Qual é melhor para dados do mercado brasileiro: preços, limites e uso ✓ *** searchable: true title: 'brapi vs Yahoo Finance API 2026: Comparativo Completo para Desenvolvedores' description: 'Comparativo brapi.dev vs Yahoo Finance API. Qual é melhor para dados do mercado brasileiro: preços, limites e uso ✓' date: '2026-01-01' keywords: 'brapi vs yahoo finance, api ações brasil, yahoo finance api alternativa, melhor api bolsa brasileira, api de ações brasileiras, dados financeiros api, comparativo api ações, 2026' author: 'Equipe brapi.dev' category: 'Comparativos' subcategory: 'APIs Financeiras' readingTime: '14 min' tags: \['API', 'Yahoo Finance', 'Comparativo', 'Desenvolvedores', 'Bolsa Brasileira', 'Dados Financeiros', 'Integração'] relatedPosts: \['b3-api-gratuita-como-usar-cotacoes', 'api-b3-python-requests-guia-pratico', 'api-b3-typescript-javascript-integracao-completa', 'brapi-vs-alpha-vantage-api-comparativo', 'api-acoes-react-nextjs-tutorial'] featured: true expertise: 'Equipe técnica especializada em APIs financeiras e integração de dados' lastReviewed: 2026-06-05 ------------------------ import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > Se você desenvolve aplicações financeiras para o mercado brasileiro, já deve ter enfrentado o dilema: usar a API do Yahoo Finance ou buscar alternativas? Neste comparativo técnico, analisamos brapi.dev vs Yahoo Finance API em detalhes. *** ## Resumo Executivo | Critério | brapi.dev | Yahoo Finance | | -------------------------- | ------------------- | ------------------------- | | **Foco no Brasil** | ✅ Especializada | ⚠️ Global (BR secundário) | | **Documentação PT-BR** | ✅ Completa | ❌ Apenas inglês | | **Dados Fundamentalistas** | ✅ Completos | ⚠️ Limitados para BR | | **Suporte** | ✅ Brasileiro | ❌ Inexistente | | **Preço** | ✅ Gratuito + Planos | ⚠️ Complexo | | **Estabilidade** | ✅ 99.9% uptime | ⚠️ Instável para BR | | **Facilidade de Uso** | ✅ Simples | ⚠️ Complexa | **Veredito Rápido:** Para o mercado brasileiro, a brapi.dev oferece melhor experiência, dados mais confiáveis e suporte em português. *** ## O Problema com Yahoo Finance para o Brasil ### 1. Instabilidade e Mudanças Frequentes O Yahoo Finance não oferece uma API oficial estável. Desenvolvedores dependem de: * Scraping de páginas (pode quebrar a qualquer momento) * APIs não documentadas (sem garantias) * Bibliotecas de terceiros (yfinance, etc.) ```javascript // Usando yfinance (Python) - pode falhar sem aviso // import yfinance as yf // petr4 = yf.Ticker("PETR4.SA") // Sufixo .SA obrigatório // dados = petr4.history(period="1mo") // Frequentemente retorna erro ``` ### 2. Dados Brasileiros Incompletos | Dado | Yahoo Finance | brapi.dev | | -------------------- | ------------------ | ---------------------- | | Cotações tempo real | ⚠️ 15-20 min delay | ✅ 5-15 min (por plano) | | Dividendos completos | ⚠️ Parcial | ✅ Histórico completo | | Balanço Patrimonial | ⚠️ Formato US GAAP | ✅ Padrão brasileiro | | DRE | ⚠️ Incompleto | ✅ Completo | | FIIs | ⚠️ Dados básicos | ✅ Dados detalhados | | BDRs | ⚠️ Confuso | ✅ Organizado | ### 3. Sem Suporte * Yahoo: Sem canal de suporte, sem SLA, sem garantias * brapi: Suporte brasileiro, documentação em português, comunidade ativa *** ## Comparativo Técnico Detalhado ### Facilidade de Integração **brapi.dev - Simples e Direto:** ```typescript const response = await fetch('https://brapi.dev/api/quote/PETR4'); const { results } = await response.json(); console.log(`Preço: R$ ${results[0].regularMarketPrice}`); // Preço: R$ 37.85 ``` **Yahoo Finance - Mais Complexo:** ```javascript // Precisa de biblioteca externa (yfinance) // Sufixo .SA obrigatório para ações brasileiras // Pode falhar sem aviso ou retornar dados vazios // import yfinance as yf // ticker = yf.Ticker("PETR4.SA") // info = ticker.info // Frequentemente retorna vazio para BR ``` ### Estrutura de Resposta **brapi.dev - JSON Limpo e Consistente:** ```json { "results": [{ "symbol": "PETR4", "shortName": "PETROBRAS PN", "longName": "Petróleo Brasileiro S.A. - Petrobras", "currency": "BRL", "regularMarketPrice": 37.85, "regularMarketChange": 0.45, "regularMarketChangePercent": 1.20, "regularMarketVolume": 45678900, "regularMarketDayHigh": 38.10, "regularMarketDayLow": 37.20 }], "requestedAt": "2026-01-15T14:30:00.000Z", "took": "45ms" } ``` **Yahoo Finance - Estrutura Inconsistente:** A estrutura de resposta do Yahoo Finance pode variar sem aviso. Campos podem estar ausentes, formatos de data são inconsistentes, e valores podem vir em formatos diferentes dependendo do ativo. ### Múltiplas Ações em Uma Requisição **brapi.dev - Nativo:** ```typescript // Até 20 ações em uma única chamada const response = await fetch('https://brapi.dev/api/quote/PETR4,VALE3,ITUB4,BBDC4,ABEV3'); const { results } = await response.json(); results.forEach(acao => { console.log(`${acao.symbol}: R$ ${acao.regularMarketPrice}`); }); ``` **Yahoo Finance - Workaround:** ```javascript // Funciona, mas é menos confiável // Cada ticker precisa do sufixo .SA e pode falhar individualmente // tickers = yf.Tickers("PETR4.SA VALE3.SA ITUB4.SA") ``` *** ## Dados Fundamentalistas ### Módulos Disponíveis | Módulo | brapi.dev | Yahoo Finance | | ---------------------- | --------- | ------------- | | Balanço Patrimonial | ✅ | ⚠️ Parcial | | DRE | ✅ | ⚠️ Parcial | | Fluxo de Caixa | ✅ | ⚠️ Parcial | | DVA | ✅ | ❌ | | Indicadores (P/L, ROE) | ✅ | ⚠️ Alguns | | Dividendos Históricos | ✅ | ⚠️ Incompleto | | Estatísticas Chave | ✅ | ⚠️ Parcial | ### Exemplo: Dados Fundamentalistas **brapi.dev:** ```typescript // Dados completos em uma chamada const response = await fetch( 'https://brapi.dev/api/quote/ITUB4?modules=balanceSheetHistory,incomeStatementHistory,defaultKeyStatistics,financialData', { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const dados = results[0]; const stats = dados.defaultKeyStatistics; const financials = dados.financialData; console.log(`ROE: ${((financials?.returnOnEquity ?? 0) * 100).toFixed(2)}%`); console.log(`P/L: ${stats.trailingPE.toFixed(2)}`); console.log(`P/VP: ${stats.priceToBook.toFixed(2)}`); ``` **Yahoo Finance:** ```javascript // Dados podem estar incompletos ou indisponíveis para ações brasileiras // Campos como ROE frequentemente retornam N/A para empresas BR // ticker.balance_sheet retorna DataFrame (formato diferente) ``` *** ## Dados Históricos ### Comparação de Histórico **brapi.dev:** ```typescript const response = await fetch( 'https://brapi.dev/api/quote/PETR4?range=1y&interval=1d', { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const historico = results[0].historicalDataPrice; // Últimos 5 dias historico.slice(-5).forEach(candle => { console.log(`${candle.date}: O:${candle.open} H:${candle.high} L:${candle.low} C:${candle.close}`); }); ``` **Yahoo Finance:** ```javascript // Retorna DataFrame pandas (mais pesado) // Estrutura diferente do JSON // ticker.history(period="1y", interval="1d") ``` ### Intervalos Disponíveis | Intervalo | brapi.dev | Yahoo Finance | | ---------- | --------- | ------------- | | 1 minuto | ✅ Pro | ⚠️ Instável | | 5 minutos | ✅ Pro | ⚠️ Instável | | 15 minutos | ✅ | ⚠️ | | 1 hora | ✅ | ✅ | | 1 dia | ✅ | ✅ | | 1 semana | ✅ | ✅ | | 1 mês | ✅ | ✅ | *** ## Preços e Limites ### Comparativo de Planos **brapi.dev - Transparente:** | Plano | Preço | Requisições/mês | Delay | | -------- | --------- | --------------- | ------ | | Gratuito | R$ 0 | 15.000 | 30 min | | Startup | R$ 119,99 | 150.000 | 15 min | | Pro | R$ 139,99 | 500.000 | 5 min | **Yahoo Finance - Sem plano público oficial:** * API pública oficial: não há plano aberto com tabela de preços * Bibliotecas gratuitas: sem garantia, podem quebrar * APIs de marketplace/RapidAPI: preços e limites variam por fornecedor * Limites não documentados * Rate limiting agressivo ### Custo-Benefício ``` ANÁLISE DE CUSTO PARA 100.000 REQ/MÊS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ brapi.dev Startup: R$ 119,99/mês ✅ Suporte brasileiro ✅ Documentação PT-BR ✅ Dados otimizados para BR ✅ SLA garantido Yahoo Finance via marketplaces/unofficial providers: ❌ Sem suporte ❌ Documentação só em inglês ❌ Dados BR incompletos ❌ Preços, limites e garantias variam por fornecedor Yahoo Finance sem fornecedor oficial: ❌ Sem preço público oficial ❌ Sem SLA público para uso programático ❌ Risco operacional maior em produção ``` *** ## Casos de Uso ### Quando Usar brapi.dev ✅ **Aplicações para mercado brasileiro** ✅ **Apps de carteira de investimentos** ✅ **Análise fundamentalista de ações BR** ✅ **Bots de trading para bolsa brasileira** ✅ **Dashboards financeiros** ✅ **Planilhas automatizadas (Google Sheets, Excel)** ✅ **Projetos acadêmicos** ### Quando Considerar Yahoo Finance ⚠️ **Dados de mercados internacionais (EUA, Europa)** ⚠️ **Projetos que já usam yfinance e funcionam** ⚠️ **Análises de ações americanas** *** ## Migração do Yahoo Finance para brapi.dev ### Antes (Yahoo Finance): ```javascript // Função legada com Yahoo Finance // Requer biblioteca yfinance, sufixo .SA, e frequentemente falha // def get_stock_data_yahoo(ticker): // stock = yf.Ticker(f"{ticker}.SA") // info = stock.info // Pode retornar vazio // return { price: info.get('regularMarketPrice') } ``` ### Depois (brapi.dev): ```typescript async function getStockData(ticker: string, token?: string) { const url = `https://brapi.dev/api/quote/${ticker}`; const headers: Record = {}; if (token) { headers['Authorization'] = `Bearer ${token}`; } const response = await fetch(url, { headers }); const { results } = await response.json(); if (results?.length) { const stock = results[0]; return { symbol: stock.symbol, price: stock.regularMarketPrice, change: stock.regularMarketChangePercent, volume: stock.regularMarketVolume }; } return null; } // Uso idêntico, resultado mais confiável const dados = await getStockData('PETR4'); ``` ### Guia de Migração Completo Os campos são compatíveis entre Yahoo Finance e brapi.dev, facilitando a migração: | Campo Yahoo Finance | Campo brapi.dev | Status | | ------------------- | ------------------- | ------- | | regularMarketPrice | regularMarketPrice | ✅ Igual | | regularMarketChange | regularMarketChange | ✅ Igual | | regularMarketVolume | regularMarketVolume | ✅ Igual | | marketCap | marketCap | ✅ Igual | | trailingPE | trailingPE | ✅ Igual | | forwardPE | forwardPE | ✅ Igual | | priceToBook | priceToBook | ✅ Igual | | dividendYield | dividendYield | ✅ Igual | **Para migrar:** Troque o endpoint e remova o sufixo `.SA` do ticker. *** ## Exemplo Completo: Dashboard de Ações ```typescript // Cliente TypeScript para brapi.dev const BRAPI_TOKEN = "SEU_TOKEN"; // Buscar cotações de múltiplas ações const response = await fetch( "https://brapi.dev/api/quote/PETR4,VALE3,ITUB4,WEGE3,ABEV3", { headers: { Authorization: `Bearer ${BRAPI_TOKEN}` } } ); const data = await response.json(); // Exibir dashboard data.results.forEach((stock) => { const emoji = stock.regularMarketChangePercent > 0 ? "🟢" : "🔴"; console.log(`${emoji} ${stock.symbol}: R$ ${stock.regularMarketPrice.toFixed(2)} (${stock.regularMarketChangePercent.toFixed(2)}%)`); }); // Buscar dados fundamentalistas const fundamentosResponse = await fetch( "https://brapi.dev/api/quote/ITUB4?modules=defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${BRAPI_TOKEN}` } } ); const fundamentos = await fundamentosResponse.json(); // Buscar histórico const historicoResponse = await fetch( "https://brapi.dev/api/quote/PETR4?range=1mo&interval=1d", { headers: { Authorization: `Bearer ${BRAPI_TOKEN}` } } ); const historico = await historicoResponse.json(); ``` **Exemplo de resultado do dashboard:** | Ação | Preço | Variação | | -------- | -------- | -------- | | 🟢 PETR4 | R$ 37,85 | +1,20% | | 🔴 VALE3 | R$ 68,42 | -0,85% | | 🟢 ITUB4 | R$ 32,10 | +0,45% | | 🟢 WEGE3 | R$ 45,30 | +2,10% | | 🔴 ABEV3 | R$ 12,85 | -0,32% | *** ## Conclusão ### Por Que Escolher brapi.dev? | Aspecto | Vantagem | | ------------------ | -------------------------------- | | **Especialização** | Feita para o mercado brasileiro | | **Confiabilidade** | API estável com SLA | | **Suporte** | Atendimento em português | | **Documentação** | Completa e em PT-BR | | **Preço** | Competitivo e transparente | | **Dados** | Completos para ações brasileiras | ### Próximos Passos 1. **[Crie sua conta gratuita](https://brapi.dev)** - 15.000 requisições/mês grátis 2. **[Leia a documentação](/docs)** - Guias completos de integração 3. **[Teste a API](/playground)** - Experimente sem código 4. **[Veja exemplos](/docs/examples)** - Python, JavaScript, Excel e mais *** *Migre do Yahoo Finance para brapi.dev e tenha dados mais confiáveis do mercado brasileiro. [Comece gratuitamente agora!](https://brapi.dev)* # Buy and Hold 2026: Estratégia de Investimento de Longo Prazo que Funciona URL: /blog/buy-and-hold-estrategia-investimento-longo-prazo.mdx Aprenda a estratégia Buy and Hold usada por Warren Buffett ✓ Como comprar e manter ações por anos. Vantagens, como aplicar no Brasil e exemplos práticos. *** searchable: true title: 'Buy and Hold 2026: Estratégia de Investimento de Longo Prazo que Funciona' description: 'Aprenda a estratégia Buy and Hold usada por Warren Buffett ✓ Como comprar e manter ações por anos. Vantagens, como aplicar no Brasil e exemplos práticos.' date: '2026-01-01' keywords: 'buy and hold 2026, estratégia investimento longo prazo, como investir longo prazo, Warren Buffett estratégia, comprar e manter ações, investimento passivo, carteira longo prazo' author: 'Equipe brapi.dev' category: 'Estratégias' subcategory: 'Investimento de Longo Prazo' readingTime: '16 min' tags: \['Buy and Hold', 'Longo Prazo', 'Warren Buffett', 'Estratégias', 'Investimentos', 'Ações'] relatedPosts: \['value-investing-como-encontrar-acoes-baratas', 'dividendos-como-construir-renda-passiva', 'dollar-cost-averaging-estrategia-aporte-mensal', 'acoes-growth-vs-value-brasil', 'como-investir-em-acoes-guia-completo-iniciantes'] featured: true expertise: 'Especialistas em estratégias de investimento com foco em resultados comprovados de longo prazo.' lastReviewed: 2026-01-03 ------------------------ ## O que é Buy and Hold: A Estratégia dos Maiores Investidores **Buy and Hold** (comprar e manter) é uma estratégia de investimento que consiste em adquirir ativos de qualidade e mantê-los por longos períodos, independentemente das oscilações de curto prazo do mercado. A ideia central é simples: se você compra boas empresas a preços justos, o tempo trabalhará a seu favor através do crescimento dos lucros e dos juros compostos. ### Quem usa Buy and Hold? | Investidor | Patrimônio | Tempo de carreira | Filosofia | | -------------- | ---------------- | ------------------- | --------------------------------------------------------- | | Warren Buffett | US$ 130+ bilhões | 60+ anos | "Nosso período favorito de manutenção é para sempre" | | Charlie Munger | US$ 2+ bilhões | 50+ anos | "O dinheiro grande está na espera, não na compra e venda" | | Peter Lynch | Retorno 29% a.a. | 13 anos no Magellan | "Tempo no mercado bate timing do mercado" | | Luiz Barsi | R$ 4+ bilhões | 50+ anos | Maior investidor pessoa física da bolsa brasileira | *** ## Por Que Buy and Hold Funciona ### 1. O Poder dos Juros Compostos Albert Einstein supostamente chamou os juros compostos de "a oitava maravilha do mundo". Veja o impacto: ``` ┌─────────────────────────────────────────────────────────────┐ │ FÓRMULA DOS JUROS COMPOSTOS │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Patrimônio = Aporte × (1 + taxa)^tempo + Aportes mensais │ │ │ │ Onde o reinvestimento dos rendimentos acelera o │ │ crescimento exponencialmente ao longo do tempo │ │ │ └─────────────────────────────────────────────────────────────┘ ``` **Simulação Buy and Hold - 30 anos:** | Parâmetro | Valor | | -------------- | --------- | | Aporte inicial | R$ 10.000 | | Aporte mensal | R$ 1.000 | | Taxa anual | 12% | **Evolução Patrimonial:** | Ano | Aportado | Patrimônio | Rendimento | | ------ | -------------- | ----------------- | ----------------- | | 5 | R$ 70.000 | R$ 95.000 | R$ 25.000 | | 10 | R$ 130.000 | R$ 250.000 | R$ 120.000 | | 15 | R$ 190.000 | R$ 520.000 | R$ 330.000 | | 20 | R$ 250.000 | R$ 1.050.000 | R$ 800.000 | | 25 | R$ 310.000 | R$ 2.050.000 | R$ 1.740.000 | | **30** | **R$ 370.000** | **R$ 3.500.000+** | **R$ 3.130.000+** | **Resultado:** * Total aportado: R$ 370.000 * Patrimônio final: R$ 3.500.000+ * Rendimento: R$ 3.130.000+ * **Multiplicador: \~9,5x** ### 2. Menos Custos e Impostos Cada operação de compra/venda gera: * Corretagem (menor hoje, mas existe) * Emolumentos da bolsa (\~0,03%) * **IR sobre ganhos (15-20%)** Quem faz buy and hold: * Não realiza lucros = não paga IR * Menos operações = menos custos * Patrimônio cresce bruto, não líquido ### 3. Evita Erros Emocionais O maior inimigo do investidor é ele mesmo. Estudos mostram que: * Investidores que mais operam têm **pior desempenho** * Tentar "acertar o timing" reduz retornos em 1-2% a.a. * Comprar no pânico e vender na euforia destrói patrimônio *** ## Comparativo: Buy and Hold vs Trading | Aspecto | Buy and Hold | Trading Ativo | | ----------------------- | ---------------------------------- | --------------------------------- | | Horizonte | 5-30+ anos | Dias a meses | | Tempo dedicado | 1-2h/mês | 2-8h/dia | | Custos operacionais | Mínimos | Altos | | Tributação | Postergada | Frequente | | Stress | Baixo | Alto | | Taxa de sucesso | Alta (mercado sobe no longo prazo) | Baixa (\~10% consistentes) | | Conhecimento necessário | Análise fundamentalista | Análise técnica + fundamentalista | | Retorno histórico | 10-15% a.a. | Varia muito | *** ## Como Aplicar Buy and Hold no Brasil ### Passo 1: Selecione Empresas de Qualidade Critérios para seleção de ações buy and hold: | Critério | Descrição | | ---------------------- | ----------------------------- | | ✓ Histórico de lucros | Lucro consistente há 10+ anos | | ✓ Dívida controlada | Dívida/EBITDA \< 3x | | ✓ ROE elevado | ROE > 15% consistente | | ✓ Dividend Yield | Paga dividendos regularmente | | ✓ Governança | Novo Mercado ou Nível 2 | | ✓ Setor resiliente | Produtos/serviços essenciais | | ✓ Vantagem competitiva | Marca, patentes, escala | | ✓ Gestão competente | Track record comprovado | ### Passo 2: Analise os Fundamentos Use a brapi.dev para analisar fundamentos: ```typescript const response = await fetch( "https://brapi.dev/api/quote/ITUB4,BBDC4,WEGE3,EGIE3?modules=summaryProfile,defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); ``` **Score Buy and Hold Simplificado:** | Critério | Pontuação | | --------- | --------- | | P/L \< 15 | +1 ponto | | P/VP \< 2 | +1 ponto | | DY > 4% | +1 ponto | **Exemplo - Análise de Candidatas:** | Ticker | Empresa | Setor | P/L | P/VP | DY | Score | | ------ | -------- | ---------- | ---- | ---- | ---- | ------ | | ITUB4 | Itaú | Bancos | 9,2 | 1,8 | 5,2% | 3/3 ✅ | | BBDC4 | Bradesco | Bancos | 8,5 | 1,2 | 4,8% | 3/3 ✅ | | WEGE3 | WEG | Industrial | 35,0 | 8,5 | 1,5% | 0/3 ⚠️ | | EGIE3 | Engie | Energia | 11,2 | 2,8 | 6,1% | 2/3 ✅ | > WEGE3 tem score baixo por ser empresa de crescimento (P/L alto), mas pode ser boa para B\&H pelo histórico. ### Passo 3: Diversifique por Setores Um portfólio buy and hold diversificado: | Setor | Peso | Ticker | Empresa | | ---------------------- | ---- | ------ | ------------- | | **Bancos** | 20% | ITUB4 | Itaú | | | | BBDC4 | Bradesco | | **Energia/Utilities** | 20% | EGIE3 | Engie | | | | TAEE11 | Taesa | | **Consumo/Varejo** | 15% | WEGE3 | WEG | | | | ABEV3 | Ambev | | **Commodities** | 15% | VALE3 | Vale | | | | PETR4 | Petrobras | | **Seguros/Financeiro** | 10% | BBSE3 | BB Seguridade | | **Saneamento** | 10% | SAPR11 | Sanepar | | **Saúde** | 10% | FLRY3 | Fleury | ### Passo 4: Aporte Regularmente **Consulta de preços para aporte mensal:** ```typescript const tickers = "ITUB4,BBDC4,EGIE3,TAEE11,WEGE3,VALE3"; const response = await fetch( `https://brapi.dev/api/quote/${tickers}`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const precos = Object.fromEntries(results.map(r => [r.symbol, r.regularMarketPrice])); ``` **Exemplo - Aporte Mensal de R$ 3.000:** | Ticker | Peso | Valor | Preço | Qtd | Total Real | | ------ | ---- | ------ | -------- | --- | ---------- | | ITUB4 | 10% | R$ 300 | R$ 32,50 | 9 | R$ 292,50 | | BBDC4 | 10% | R$ 300 | R$ 14,80 | 20 | R$ 296,00 | | EGIE3 | 10% | R$ 300 | R$ 44,20 | 6 | R$ 265,20 | | TAEE11 | 10% | R$ 300 | R$ 35,50 | 8 | R$ 284,00 | | WEGE3 | 10% | R$ 300 | R$ 52,30 | 5 | R$ 261,50 | | ABEV3 | 5% | R$ 150 | R$ 14,50 | 10 | R$ 145,00 | | VALE3 | 10% | R$ 300 | R$ 62,80 | 4 | R$ 251,20 | | PETR4 | 5% | R$ 150 | R$ 38,20 | 3 | R$ 114,60 | | BBSE3 | 10% | R$ 300 | R$ 35,80 | 8 | R$ 286,40 | | SAPR11 | 10% | R$ 300 | R$ 28,50 | 10 | R$ 285,00 | | FLRY3 | 10% | R$ 300 | R$ 15,20 | 19 | R$ 288,80 | **Resumo:** * Total alocado: R$ 2.770,20 * Sobra (caixa): R$ 229,80 ### Passo 5: Reinvista os Dividendos **Estratégia:** Reinvista dividendos nas ações mais descontadas (menor P/L). **Consulta para identificar ação mais barata:** ```typescript const response = await fetch( "https://brapi.dev/api/quote/ITUB4,BBDC4,EGIE3,VALE3?modules=defaultKeyStatistics,financialData", { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); // Ordenar por P/L (menor = mais barato) const sorted = results.sort((a, b) => a.priceEarnings - b.priceEarnings); ``` **Exemplo - Reinvestindo dividendo de R$ 500:** | Ticker | P/L | Preço | Qtd a Comprar | | ------ | ---- | -------- | ------------- | | BBDC4 | 8,5 | R$ 14,80 | 33 ações ✅ | | ITUB4 | 9,2 | R$ 32,50 | - | | EGIE3 | 11,2 | R$ 44,20 | - | | VALE3 | 12,8 | R$ 62,80 | - | > A estratégia prioriza a ação com menor P/L, que indica maior desconto relativo. *** ## Ações Brasileiras Ideais para Buy and Hold ### Blue Chips Consagradas | Ação | Empresa | Setor | Por que é boa para B\&H | | ------ | ------------- | ----------- | ----------------------------------------- | | ITUB4 | Itaú | Bancos | Maior banco privado, ROE 20%+, dividendos | | WEGE3 | WEG | Industrial | Crescimento consistente, expansão global | | EGIE3 | Engie | Energia | Receita previsível, dividendos altos | | VALE3 | Vale | Mineração | Líder mundial em minério, dividendos | | BBSE3 | BB Seguridade | Seguros | ROE altíssimo, dividendos generosos | | TAEE11 | Taesa | Transmissão | Receita garantida, DY 8-10% | | VIVT3 | Telefônica | Telecom | Caixa estável, dividendos | | ABEV3 | Ambev | Bebidas | Marca forte, dominância de mercado | ### Empresas de Crescimento | Ação | Empresa | Setor | Por que é boa para B\&H | | ----- | -------- | ---------- | ------------------------------------------ | | WEGE3 | WEG | Industrial | Crescimento 15%+ a.a., internacionalização | | PRIO3 | PetroRio | Petróleo | Crescimento agressivo, gestão eficiente | | TOTS3 | Totvs | Software | Líder em ERP, receita recorrente | | RENT3 | Localiza | Aluguel | Crescimento consistente, escala | | ARZZ3 | Arezzo | Calçados | Marca forte, expansão | ### Pagadoras de Dividendos | Ação | Empresa | Setor | Dividend Yield Médio | | ------ | --------------- | ----------- | -------------------- | | TAEE11 | Taesa | Transmissão | 8-12% | | BBAS3 | Banco do Brasil | Bancos | 8-10% | | BBSE3 | BB Seguridade | Seguros | 7-10% | | CPLE6 | Copel | Energia | 6-9% | | EGIE3 | Engie | Energia | 5-8% | | CMIG4 | Cemig | Energia | 5-8% | *** ## Acompanhando sua Carteira Buy and Hold ### Dashboard de Acompanhamento **Consulta de preços atuais:** ```typescript const tickers = "ITUB4,WEGE3,EGIE3,VALE3,TAEE11"; const response = await fetch( `https://brapi.dev/api/quote/${tickers}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); ``` **Exemplo - Carteira Buy and Hold:** | Ticker | Qtd | PM | Atual | Investido | Valor Atual | Lucro/Prej | Retorno | | ------ | --- | -------- | -------- | --------- | ----------- | ---------- | ------- | | ITUB4 | 100 | R$ 28,50 | R$ 32,50 | R$ 2.850 | R$ 3.250 | R$ 400 | +14,0% | | WEGE3 | 50 | R$ 35,00 | R$ 52,30 | R$ 1.750 | R$ 2.615 | R$ 865 | +49,4% | | EGIE3 | 80 | R$ 42,00 | R$ 44,20 | R$ 3.360 | R$ 3.536 | R$ 176 | +5,2% | | VALE3 | 60 | R$ 68,00 | R$ 62,80 | R$ 4.080 | R$ 3.768 | -R$ 312 | -7,6% | | TAEE11 | 100 | R$ 35,00 | R$ 35,50 | R$ 3.500 | R$ 3.550 | R$ 50 | +1,4% | **Resumo da Carteira:** | Métrica | Valor | | --------------- | ------------ | | Total Investido | R$ 15.540,00 | | Valor Atual | R$ 16.719,00 | | Lucro/Prejuízo | R$ 1.179,00 | | Retorno Total | +7,6% | ### Verificação Anual da Carteira Buy and hold não significa "comprar e esquecer". Uma vez por ano, verifique: **Checklist de Revisão Anual:** Para cada ação da carteira, responda: | # | Pergunta | ITUB4 | WEGE3 | EGIE3 | VALE3 | TAEE11 | | - | ----------------------------------------- | ----- | ----- | ----- | ----- | ------ | | 1 | A empresa ainda tem vantagem competitiva? | \[ ] | \[ ] | \[ ] | \[ ] | \[ ] | | 2 | Os lucros continuam crescendo? | \[ ] | \[ ] | \[ ] | \[ ] | \[ ] | | 3 | A dívida está sob controle? | \[ ] | \[ ] | \[ ] | \[ ] | \[ ] | | 4 | A gestão continua competente? | \[ ] | \[ ] | \[ ] | \[ ] | \[ ] | | 5 | O setor ainda é promissor? | \[ ] | \[ ] | \[ ] | \[ ] | \[ ] | | 6 | O valuation ficou muito esticado? | \[ ] | \[ ] | \[ ] | \[ ] | \[ ] | | 7 | Houve mudança regulatória relevante? | \[ ] | \[ ] | \[ ] | \[ ] | \[ ] | | 8 | A tese de investimento ainda é válida? | \[ ] | \[ ] | \[ ] | \[ ] | \[ ] | > **Regra de ouro:** Só venda se a EMPRESA mudou, não porque o PREÇO caiu. *** ## Erros Comuns no Buy and Hold ### ❌ Erros que Você Deve Evitar | Erro | Por que é problemático | Solução | | ------------------------- | -------------------------------- | --------------------------------------- | | Vender no pânico | Realiza prejuízo no pior momento | Lembre da tese de investimento | | Não diversificar | Risco concentrado | Mínimo 8-10 ações de setores diferentes | | Ignorar fundamentos | Pode segurar empresa decadente | Revisão anual obrigatória | | Aportar tudo de uma vez | Risco de timing | DCA (aportes mensais) | | Não reinvestir dividendos | Perde juros compostos | Reinvista sempre | | Olhar preço todo dia | Gera ansiedade | Acompanhe mensalmente | | Comprar "dicas quentes" | Sem análise = risco | Estude antes de comprar | ### ✅ Boas Práticas 1. **Tenha uma tese para cada ação** - Por que você está comprando? 2. **Defina critérios de venda** - Quando a tese quebra? 3. **Mantenha registro das compras** - Preço médio, data, quantidade 4. **Reinvista dividendos** - Acelera os juros compostos 5. **Aporte regularmente** - Todo mês, todo ano 6. **Estude as empresas** - Leia relatórios, acompanhe setor 7. **Tenha paciência** - Resultados levam anos, não meses *** ## Histórico: Retorno do Ibovespa no Longo Prazo | Período | Retorno Total | Retorno Anual | | ------------------- | ------------- | ------------- | | 10 anos (2016-2026) | \~180% | \~11% a.a. | | 20 anos (2006-2026) | \~450% | \~9% a.a. | | 30 anos (1996-2026) | \~2.500% | \~12% a.a. | > *Valores aproximados, já descontada a inflação (retorno real). Inclui reinvestimento de dividendos.* **Lição:** Quem investiu e manteve por 20-30 anos multiplicou o patrimônio, apesar de todas as crises. *** ## Perguntas Frequentes sobre Buy and Hold ### Quanto tempo é "longo prazo"? Idealmente, **5 anos ou mais**. Warren Buffett diz: "Se você não está disposto a manter uma ação por 10 anos, não a mantenha nem por 10 minutos." ### E se a ação cair 50%? Se os fundamentos permanecem sólidos, é oportunidade de comprar mais barato. Revise a tese e, se ainda fizer sentido, mantenha ou aumente posição. ### Devo vender alguma vez? Sim, quando: * A tese de investimento quebrou * Os fundamentos deterioraram permanentemente * Surgiu oportunidade claramente melhor * Você precisa do dinheiro (emergência real) ### Buy and Hold funciona com qualquer ação? **Não!** Funciona com empresas de qualidade, com vantagens competitivas duráveis. Com empresas ruins, você apenas segura um mico por anos. ### E os dividendos? Reinvista-os para acelerar o crescimento do patrimônio através dos juros compostos. *** ## Conclusão Buy and Hold é a estratégia mais comprovada para construção de patrimônio no longo prazo. Usada pelos maiores investidores do mundo, ela se baseia em princípios sólidos: comprar boas empresas, manter por anos, e deixar os juros compostos trabalharem. **Pontos-chave:** * Selecione empresas de qualidade com fundamentos sólidos * Diversifique entre setores (8-12 ações no mínimo) * Aporte regularmente (DCA) * Reinvista todos os dividendos * Não venda por causa de quedas de preço * Revise a carteira anualmente (fundamentos, não preço) * Tenha paciência - resultados levam anos Para acompanhar sua carteira buy and hold com dados em tempo real e análises fundamentalistas, use a [API da brapi.dev](https://brapi.dev) e construa seu próprio sistema de monitoramento. *** ## Recursos Adicionais * [Documentação da API brapi.dev](/docs) * [Como investir em ações](/blog/como-investir-em-acoes-guia-completo-iniciantes) * [Análise Fundamentalista](/blog/analise-fundamentalista-o-que-e) * [ETFs Brasil - Alternativa para Buy and Hold](/blog/etfs-brasil-guia-completo-bova11-ivvb11) # Cadeia de Opções de Ações Brasileiras com Python: Tutorial Completo da API brapi (2026) URL: /blog/cadeia-opcoes-b3-python-tutorial-api-brapi.mdx Aprenda a consultar a cadeia de opções da bolsa brasileira em Python com a API brapi. Vencimentos, strikes, calls e puts com OHLCV, bid/ask e volume. *** searchable: true title: 'Cadeia de Opções de Ações Brasileiras com Python: Tutorial Completo da API brapi (2026)' description: 'Aprenda a consultar a cadeia de opções da bolsa brasileira em Python com a API brapi. Vencimentos, strikes, calls e puts com OHLCV, bid/ask e volume.' date: '2026-05-09' keywords: 'cadeia de opcoes bolsa brasileira, options chain brasil, api opcoes python, cadeia opcoes petr4, listar opcoes bolsa brasileira, brapi opcoes, calls puts python, opcoes bolsa brasileira python tutorial' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Opções' readingTime: '19 min' tags: \['Python', 'Opções', 'Bolsa Brasileira', 'Derivativos', 'Calls', 'Puts', 'API', 'Tutorial', 'Options Chain'] relatedPosts: \['opcoes-b3-guia-completo-iniciantes-calls-puts', 'dividendos-sinteticos-opcoes-covered-call-2026', 'backtesting-opcoes-python-brapi-tutorial', 'api-b3-python-requests-guia-pratico'] featured: true expertise: 'Tutorial técnico para desenvolvedores e investidores que operam derivativos' lastReviewed: '2026-05-09' howToSteps: * name: 'Instalar dependências Python' text: 'Instale Python 3.10+, requests, pandas e tabulate para manipular e visualizar dados de opções.' * name: 'Obter token Pro da brapi' text: 'O endpoint de opções é exclusivo do plano Pro, exceto pelo sandbox de PETR4 que funciona sem token.' * name: 'Listar vencimentos disponíveis' text: 'Use /api/v2/options/expirations para descobrir as datas de vencimento de um ativo.' * name: 'Buscar a cadeia completa' text: 'Use /api/v2/options/chain para obter todas as séries negociadas em um vencimento, com strike, bid, ask e OHLCV.' * name: 'Filtrar por critério' text: 'Aplique filtros de moneyness (ITM, ATM, OTM), liquidez ou volume usando pandas.' * name: 'Visualizar a cadeia' text: 'Renderize a cadeia em formato tabela ou exporte para Excel para análise visual.' howToTools: \['Python 3.10+', 'requests', 'pandas', 'tabulate', 'Token brapi.dev (plano Pro) ou sandbox PETR4'] *** import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > Operar opções da bolsa brasileira sem ferramenta decente é quase um ritual de sofrimento: home broker engasga, sites de terceiros pedem assinatura cara, e você ainda fica refém de telas pré-fabricadas. Neste tutorial você vai construir, em Python e em \~30 minutos, sua **própria visualização de cadeia de opções da bolsa brasileira** — calls e puts, com bid/ask, volume e moneyness — usando a API brapi. *** ## O Que é uma Cadeia de Opções? Uma **cadeia de opções** (ou *option chain*) é a tabela que mostra todas as séries de opções negociadas para um determinado ativo subjacente em um determinado vencimento. Em outras palavras: para `PETR4`, com vencimento em maio de 2026, qual a lista de calls e puts disponíveis, com seus respectivos strikes, prêmios, volumes e bids/asks. Visualmente, uma cadeia tem este formato (calls à esquerda, puts à direita, strike no meio): ``` CALLS PUTS Strike Bid Ask Vol || Strike Bid Ask Vol 30.00 2.10 2.13 3.2k || 30.00 0.18 0.21 1.4k 32.00 1.05 1.07 5.1k || 32.00 0.78 0.82 2.6k 34.00 0.31 0.34 2.8k || 34.00 2.85 2.92 0.9k 36.00 0.08 0.10 1.1k || 36.00 5.10 5.20 0.4k ``` A cadeia é a **base de qualquer análise de opções** — escolha de strikes, montagem de spreads, identificação de assimetrias. Plano mínimo: **Pro**. No sandbox sem token, os endpoints de opções aceitam apenas `underlying=PETR4`. Perfeito para acompanhar este tutorial — todos os exemplos funcionam com PETR4. *** ## O Fluxo da API A brapi expõe **4 endpoints** de opções, desenhados para um fluxo natural: 1. [`/api/v2/options/expirations`](/docs/opcoes/vencimentos) — descobre os vencimentos disponíveis 2. [`/api/v2/options/strikes`](/docs/opcoes/precos-de-exercicio) — lista os strikes em um vencimento (opcional) 3. [`/api/v2/options/chain`](/docs/opcoes/series) — retorna a cadeia completa com OHLCV 4. [`/api/v2/options/historical`](/docs/opcoes/historico) — histórico de uma série específica Para construir uma cadeia visual, vamos usar 1 + 3. *** ## O Que Vamos Construir ``` options-chain/ ├── brapi_options.py # Cliente HTTP ├── chain_view.py # Renderização tabular ├── filters.py # ITM/ATM/OTM, liquidez └── run.py # Pipeline principal ``` Saída: tabela formatada com calls e puts lado a lado, com indicadores visuais de moneyness e liquidez. *** ## Pré-requisitos ```bash mkdir options-chain && cd options-chain python -m venv .venv && source .venv/bin/activate pip install requests pandas tabulate openpyxl # Para o sandbox PETR4 não é necessário token # Para outros ativos: gerar token Pro em brapi.dev/dashboard export BRAPI_TOKEN="seu_token_pro" # opcional ``` *** ## Passo 1: Cliente HTTP ```python title="brapi_options.py" import os import requests from typing import Literal BASE = "https://brapi.dev/api/v2/options" TOKEN = os.getenv("BRAPI_TOKEN", "") HEADERS = {"Authorization": f"Bearer {TOKEN}"} if TOKEN else {} def get_expirations(underlying: str, include_expired: bool = False) -> list[str]: """Descobre os vencimentos negociados para um ativo.""" params = {"underlying": underlying} if include_expired: params["includeExpired"] = "true" resp = requests.get(f"{BASE}/expirations", params=params, headers=HEADERS, timeout=30) resp.raise_for_status() return resp.json().get("expirations", []) def get_chain( underlying: str, expiration_date: str, side: Literal["call", "put"] | None = None, min_strike: float | None = None, max_strike: float | None = None, date: str | None = None, ) -> dict: """Retorna a cadeia de opções para um vencimento específico.""" params: dict = { "underlying": underlying, "expirationDate": expiration_date, } if side: params["side"] = side if min_strike is not None: params["minStrike"] = min_strike if max_strike is not None: params["maxStrike"] = max_strike if date: params["date"] = date resp = requests.get(f"{BASE}/chain", params=params, headers=HEADERS, timeout=30) resp.raise_for_status() return resp.json() ``` Pontos: * **`expirations` aceita `includeExpired`** para análises históricas (default: só futuros). * **`chain` aceita filtros por strike e side** que reduzem o payload — útil para apps que renderizam apenas uma janela de strikes ATM. *** ## Passo 2: Cadeia Bruta Vamos buscar a cadeia completa para PETR4 no próximo vencimento: ```python title="run.py" from brapi_options import get_chain, get_expirations def main() -> None: underlying = "PETR4" # 1) Próximo vencimento expirations = get_expirations(underlying) next_exp = expirations[0] print(f"Próximo vencimento: {next_exp}") # 2) Cadeia completa chain = get_chain(underlying, next_exp) series = chain["series"] print(f"Total de séries negociadas: {len(series)}") print(f"Data de referência: {chain['date']}") if __name__ == "__main__": main() ``` Saída: ``` Próximo vencimento: 2026-05-15 Total de séries negociadas: 47 Data de referência: 2026-05-08 ``` A resposta de cada série tem o seguinte shape: ```jsonc { "symbol": "PETRE300", // Código da série "underlyingSymbol": "PETR4", "side": "call", // call ou put "market": "equity", "strike": 30.12, // Strike em R$ "expirationDate": "2026-05-15", "firstTradeDate": "2025-11-19", "lastTradeDate": "2026-05-08", "date": 1746662400, // Timestamp UNIX do fechamento "open": 1.70, "high": 2.13, "low": 1.52, "average": 1.77, "close": 2.06, "bid": 2.03, // Melhor oferta de compra "ask": 2.09, // Melhor oferta de venda "trades": 1542, "volume": 2841600, // Quantidade negociada "financialVolume": 5029632.0 // Volume em R$ } ``` *** ## Passo 3: Cálculo de Moneyness Para qualquer análise séria, você precisa do **preço atual do ativo subjacente** para classificar opções em ITM (in-the-money), ATM (at-the-money) ou OTM (out-of-the-money). ```python title="filters.py" import pandas as pd import requests def get_underlying_price(underlying: str) -> float: """Pega o último preço do subjacente via /api/quote.""" token = __import__("os").getenv("BRAPI_TOKEN", "") headers = {"Authorization": f"Bearer {token}"} if token else {} resp = requests.get( f"https://brapi.dev/api/quote/{underlying}", headers=headers, timeout=30, ) resp.raise_for_status() return float(resp.json()["results"][0]["regularMarketPrice"]) def classify_moneyness(strike: float, spot: float, side: str) -> str: """Classifica a opção em ITM, ATM ou OTM.""" diff_pct = (strike - spot) / spot # Janela de ATM: ±1% do strike if abs(diff_pct) <= 0.01: return "ATM" if side == "call": return "ITM" if strike < spot else "OTM" else: # put return "ITM" if strike > spot else "OTM" def liquidity_tier(trades: int) -> str: """Classifica liquidez baseado em número de negócios.""" if trades >= 500: return "alta" if trades >= 100: return "média" if trades >= 20: return "baixa" return "ilíquida" def chain_to_dataframe(series_list: list[dict], spot: float) -> pd.DataFrame: """Converte a lista de séries em DataFrame pronto para análise.""" df = pd.DataFrame(series_list) df["moneyness"] = df.apply( lambda row: classify_moneyness(row["strike"], spot, row["side"]), axis=1, ) df["liquidity"] = df["trades"].apply(liquidity_tier) # Spread bid-ask em % do mid (proxy de liquidez) df["mid"] = (df["bid"] + df["ask"]) / 2 df["spread_pct"] = ((df["ask"] - df["bid"]) / df["mid"]) * 100 return df ``` *** ## Passo 4: Visualização Lado a Lado A representação clássica é calls à esquerda, puts à direita, strikes no meio: ```python title="chain_view.py" import pandas as pd from tabulate import tabulate def render_side_by_side(df: pd.DataFrame, spot: float) -> str: """Renderiza a cadeia com calls e puts lado a lado, ordenadas por strike.""" calls = df[df["side"] == "call"].set_index("strike") puts = df[df["side"] == "put"].set_index("strike") all_strikes = sorted(set(calls.index) | set(puts.index)) rows = [] for strike in all_strikes: atm_marker = "←" if abs(strike - spot) <= 0.01 * spot else "" call_data = calls.loc[strike] if strike in calls.index else None put_data = puts.loc[strike] if strike in puts.index else None row = [ f"{call_data['bid']:.2f}" if call_data is not None and pd.notna(call_data['bid']) else "—", f"{call_data['ask']:.2f}" if call_data is not None and pd.notna(call_data['ask']) else "—", f"{int(call_data['trades']):,}" if call_data is not None and pd.notna(call_data['trades']) else "—", f"{strike:.2f} {atm_marker}", f"{put_data['bid']:.2f}" if put_data is not None and pd.notna(put_data['bid']) else "—", f"{put_data['ask']:.2f}" if put_data is not None and pd.notna(put_data['ask']) else "—", f"{int(put_data['trades']):,}" if put_data is not None and pd.notna(put_data['trades']) else "—", ] rows.append(row) headers = [ "Call Bid", "Call Ask", "Call Trades", "Strike", "Put Bid", "Put Ask", "Put Trades", ] return tabulate(rows, headers=headers, tablefmt="github", colalign=("right", "right", "right", "center", "right", "right", "right")) ``` Pipeline final: ```python title="run.py" {1-3,18-31} from brapi_options import get_chain, get_expirations from filters import chain_to_dataframe, get_underlying_price from chain_view import render_side_by_side def main() -> None: underlying = "PETR4" # 1) Próximo vencimento expirations = get_expirations(underlying) next_exp = expirations[0] print(f"Próximo vencimento: {next_exp}\n") # 2) Cadeia + spot chain = get_chain(underlying, next_exp) spot = get_underlying_price(underlying) print(f"Spot {underlying}: R$ {spot:.2f}\n") # 3) DataFrame com moneyness e liquidez df = chain_to_dataframe(chain["series"], spot) # 4) Filtra strikes próximos do dinheiro (±15%) band = 0.15 df_filtered = df[ (df["strike"] >= spot * (1 - band)) & (df["strike"] <= spot * (1 + band)) ] # 5) Renderiza lado a lado print(render_side_by_side(df_filtered, spot)) if __name__ == "__main__": main() ``` Saída esperada: ``` Próximo vencimento: 2026-05-15 Spot PETR4: R$ 33.18 | Call Bid | Call Ask | Call Trades | Strike | Put Bid | Put Ask | Put Trades | |---------:|---------:|------------:|:--------:|--------:|--------:|-----------:| | 4.20 | 4.32 | 1,892 | 29.00 | 0.10 | 0.12 | 425 | | 3.10 | 3.18 | 2,210 | 30.00 | 0.21 | 0.24 | 802 | | 2.10 | 2.16 | 3,456 | 31.00 | 0.45 | 0.49 | 1,124 | | 1.20 | 1.24 | 4,891 | 32.00 | 0.94 | 0.98 | 2,345 | | 0.50 | 0.52 | 5,612 | 33.00 ← | 1.81 | 1.85 | 3,108 | | 0.16 | 0.18 | 3,201 | 34.00 | 3.10 | 3.18 | 1,890 | | 0.04 | 0.06 | 1,055 | 35.00 | 4.50 | 4.62 | 920 | | 0.01 | 0.03 | 421 | 36.00 | 5.85 | 5.95 | 310 | ``` A seta `←` marca o strike ATM. Em \~50 linhas de código, você reproduziu o que apps profissionais cobram para ver. *** ## Passo 5: Filtros Estratégicos Agora que temos o DataFrame, podemos extrair insights práticos. ### A) Calls OTM Líquidas para Covered Call ```python def covered_call_candidates(df: pd.DataFrame, spot: float) -> pd.DataFrame: """Calls 5%-15% OTM com liquidez decente.""" calls = df[df["side"] == "call"] return calls[ (calls["strike"] >= spot * 1.05) & (calls["strike"] <= spot * 1.15) & (calls["trades"] >= 100) # Líquidas & (calls["spread_pct"] <= 5) # Spread bid-ask < 5% do mid ].sort_values("strike") ``` ### B) Puts ATM para Hedge ```python def hedge_put_candidates(df: pd.DataFrame, spot: float) -> pd.DataFrame: """Puts próximas do dinheiro (±5%) com volume.""" puts = df[df["side"] == "put"] return puts[ (puts["strike"] >= spot * 0.95) & (puts["strike"] <= spot * 1.05) & (puts["trades"] >= 200) ].sort_values("strike") ``` ### C) Detecção de Arbitragem Bid-Ask Spreads bid-ask muito largos podem revelar oportunidades pontuais — ou apenas indicar série ilíquida. Vale conferir manualmente: ```python def wide_spreads(df: pd.DataFrame, threshold_pct: float = 10.0) -> pd.DataFrame: """Séries com spread bid-ask acima de threshold_pct.""" return df[df["spread_pct"] >= threshold_pct].sort_values("spread_pct", ascending=False) ``` ### D) Resumo por Moneyness ```python def moneyness_summary(df: pd.DataFrame) -> pd.DataFrame: return df.groupby(["side", "moneyness"]).agg( total_series=("symbol", "count"), avg_trades=("trades", "mean"), avg_volume=("volume", "mean"), avg_spread_pct=("spread_pct", "mean"), ).round(2) ``` Saída exemplo: ``` total_series avg_trades avg_volume avg_spread_pct side moneyness call ATM 2 4_120 2_890_000 1.8 ITM 6 1_580 1_450_000 3.1 OTM 12 2_340 1_850_000 4.5 put ATM 2 3_210 1_910_000 2.0 ITM 6 890 720_000 6.2 OTM 11 1_650 1_240_000 5.8 ``` ITM puts têm spread pior do que ATM — informação útil para escolher onde alocar. *** ## Passo 6: Exportando para Excel Para análise visual ou compartilhamento com o time: ```python def export_chain_excel(df: pd.DataFrame, spot: float, output_path: str) -> None: calls = df[df["side"] == "call"].set_index("strike") puts = df[df["side"] == "put"].set_index("strike") cols = ["bid", "ask", "close", "trades", "volume", "moneyness", "liquidity", "spread_pct"] calls_view = calls[cols].add_prefix("call_") puts_view = puts[cols].add_prefix("put_") combined = calls_view.join(puts_view, how="outer").sort_index() with pd.ExcelWriter(output_path, engine="openpyxl") as writer: combined.to_excel(writer, sheet_name=f"Chain (spot {spot:.2f})") print(f"Exportado para {output_path}") ``` *** ## Passo 7: Acompanhando Múltiplos Vencimentos Quer comparar o mesmo strike em vencimentos diferentes? (Útil para análise de **estrutura a termo da volatilidade**.) ```python def compare_expirations( underlying: str, strike: float, side: str = "call", ) -> pd.DataFrame: """Pega o mesmo strike em todos os vencimentos disponíveis.""" expirations = get_expirations(underlying) rows = [] for exp in expirations[:6]: # próximos 6 vencimentos chain = get_chain( underlying=underlying, expiration_date=exp, side=side, min_strike=strike - 0.01, max_strike=strike + 0.01, ) for s in chain["series"]: rows.append({ "expirationDate": exp, "symbol": s["symbol"], "strike": s["strike"], "close": s["close"], "bid": s["bid"], "ask": s["ask"], "trades": s["trades"], }) return pd.DataFrame(rows) ``` Útil para identificar: * Vencimentos com prêmios "esquecidos" (mispriced) * Curvas de prêmio decrescentes (theta acelerado) * Liquidez relativa entre vencimentos curtos vs longos *** ## Cuidados Importantes A API entrega dados de **fim de pregão** (após \~19h BRT). Não use bid/ask como proxy de mercado em tempo real durante o pregão — só servem para decisões pós-fechamento ou planejamento da próxima abertura. A API também entrega gregas e volatilidade implícita EOD nos endpoints `/api/v2/options/analytics` e `/api/v2/options/analytics/history`. Quando faltam dados suficientes, os campos calculados ficam `null` e `nullReason` explica o motivo. O ticker (ex.: `PETRE370`) tem padrão da bolsa: `{ATIVO}{LETRA_MÊS}{ID_STRIKE}`. A letra do mês codifica o tipo (A-L = call, M-X = put). O `ID_STRIKE` **não é o valor em reais** — sempre use o campo `strike` da resposta para o valor monetário. Mais detalhes em [`/docs/opcoes`](/docs/opcoes). *** ## Indo Além A partir desse esqueleto, você pode evoluir para: * **Painel de gregas** usando `/api/v2/options/analytics` * **Histórico de volatilidade implícita** usando `/api/v2/options/analytics/history` * **Volatility smile** plotando IV vs strike para um mesmo vencimento * **Backtest de estratégias** (covered call, cash-secured put, spreads) — veja o tutorial dedicado de [Backtesting de Opções com Python](/blog/backtesting-opcoes-python-brapi-tutorial) *** ## Conclusão A cadeia de opções é a **lente** pela qual qualquer trader de derivativos olha o mercado. Tendo a cadeia em Python, você passa a ter: * Visualização customizável (sem depender de home broker) * Filtros automáticos por moneyness, liquidez e spread * Histórico estruturado para análises e backtests * Comparação entre vencimentos sem dor Em 200 linhas de Python e sem custos adicionais, você reproduz funcionalidades de plataformas que cobram caro pelo mesmo dado público. > **Próximos passos:** se você está começando, leia primeiro o [guia de opções para iniciantes](/blog/opcoes-b3-guia-completo-iniciantes-calls-puts). Se já entende a mecânica, pule direto para o [tutorial de Backtesting de Opções](/blog/backtesting-opcoes-python-brapi-tutorial). E se quer gerar renda extra com o que já tem em carteira, veja o [guia da Covered Call](/blog/dividendos-sinteticos-opcoes-covered-call-2026). *Disclaimer: opções são derivativos com risco de perda total ou superior ao capital investido. Estude antes de operar.* # Quanto Investir para Viver de Dividendos? Faça a Conta URL: /blog/calculadora-dividendos-renda-passiva-brasil.mdx Calcule o patrimônio necessário para gerar renda mensal, escolha um dividend yield prudente e teste aportes e reinvestimento no simulador da brapi. *** searchable: true title: 'Quanto Investir para Viver de Dividendos? Faça a Conta' description: 'Calcule o patrimônio necessário para gerar renda mensal, escolha um dividend yield prudente e teste aportes e reinvestimento no simulador da brapi.' date: '2026-01-07' keywords: 'quanto investir para viver de dividendos, calcular renda dividendos, patrimônio renda passiva, simular dividendos, reinvestir dividendos' author: 'Alisson Leal' category: 'Renda Passiva' subcategory: 'Planejamento com dividendos' readingTime: '7 min' tags: \['Dividendos', 'Renda Passiva', 'Simulação', 'FIIs', 'Ações', 'Planejamento'] relatedPosts: \['dividend-yield-dy-como-calcular-usar-analise-acoes-dividendos', 'api-dividendos-acoes-fiis-brasil-como-consultar-2026', 'payout-dividend-yield-sustentabilidade-2026'] featured: true expertise: 'Planejamento de renda com dividendos e premissas financeiras' lastReviewed: '2026-07-17' howToTools: \['Simulador de dividendos da brapi', 'Gastos mensais', 'Premissa de dividend yield'] howToSteps: * name: 'Defina a renda mensal' text: 'Comece pelo valor mensal que a carteira precisaria complementar.' * name: 'Converta para renda anual' text: 'Multiplique a renda mensal por 12.' * name: 'Escolha uma faixa de yield' text: 'Teste mais de uma premissa e evite projetar o maior yield recente.' * name: 'Calcule o patrimônio' text: 'Divida a renda anual pelo yield anual em formato decimal.' * name: 'Simule aportes e reinvestimento' text: 'Use o simulador para comparar prazo, aportes e cenários.' *** import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; Para estimar quanto investir, transforme a renda mensal em renda anual e divida pelo dividend yield líquido usado na simulação. ```text patrimônio necessário = renda anual desejada / yield anual ``` Quem quer R$ 5.000 por mês precisa de R$ 60.000 por ano. Com yield de 6%, a conta indica R$ 1 milhão. Com 8%, indica R$ 750 mil. Esses valores são cenários, não promessas. Dividendos mudam e o patrimônio também precisa acompanhar a inflação. ## Tabela de referência | Renda mensal | Yield de 5% | Yield de 6% | Yield de 8% | | -----------: | -----------: | -----------: | -----------: | | R$ 2.000 | R$ 480.000 | R$ 400.000 | R$ 300.000 | | R$ 3.000 | R$ 720.000 | R$ 600.000 | R$ 450.000 | | R$ 5.000 | R$ 1.200.000 | R$ 1.000.000 | R$ 750.000 | | R$ 10.000 | R$ 2.400.000 | R$ 2.000.000 | R$ 1.500.000 | Abra o [simulador de rentabilidade e dividendos](/calculadoras/simulador-de-rentabilidade-e-dividendos) para incluir investimento inicial, aportes e prazo. ## Qual yield usar Não use automaticamente o maior dividend yield da sua carteira. O número pode estar alto porque a cotação caiu ou porque houve um pagamento extraordinário. Teste pelo menos três cenários: * conservador, com renda menor; * base, usando uma premissa que você consegue justificar; * estressado, com corte de dividendos e inflação maior. O objetivo não é acertar uma taxa futura. É descobrir se o plano ainda funciona quando a realidade fica menos favorável. A empresa pode reduzir dividendos. Um FII pode sofrer vacância, inadimplência ou evento de crédito. Refaça a conta quando a fonte de renda mudar. ## Reinvestimento durante a acumulação Quem ainda está formando patrimônio pode reinvestir os proventos. Cada pagamento compra novas ações, cotas ou títulos, que passam a gerar renda no período seguinte. A simulação deve separar: 1. aporte feito com salário; 2. proventos reinvestidos; 3. valorização ou queda dos ativos; 4. renda retirada da carteira. Misturar tudo como "rentabilidade" dificulta entender o que realmente fez o patrimônio crescer. ## Inflação e crescimento da renda R$ 5.000 no futuro comprarão menos do que R$ 5.000 hoje. Você pode corrigir a meta de renda pela inflação ou trabalhar com valores reais. Uma carteira que distribui toda a renda e não cresce pode perder poder de compra. Por isso, retire apenas parte dos proventos ou mantenha ativos capazes de crescer, quando isso fizer sentido no plano. ## Ações, FIIs e renda fixa Uma estratégia de renda não precisa depender de um único tipo de ativo. | Ativo | Comportamento da renda | Risco que merece atenção | | ---------- | -------------------------- | ----------------------------------------- | | Ações | Pagamentos variáveis | Queda de lucro e payout insustentável | | FIIs | Distribuição frequente | Vacância, crédito, juros e gestão | | Renda fixa | Fluxo definido pelo título | Emissor, liquidez, prazo e reinvestimento | Diversificar fontes de renda não elimina risco. O objetivo é evitar que uma única empresa, imóvel ou devedor determine todo o orçamento. ## Calcular o pagamento de um evento Quando uma empresa anuncia R$ 1,50 por ação e você tinha 100 ações na data com: ```text pagamento bruto = R$ 1,50 x 100 = R$ 150 ``` Use a quantidade existente na data que dava direito ao provento, não a posição atual. Compras realizadas depois dessa data não entram no pagamento. Para baixar eventos reais, veja [histórico de dividendos e JCP por API](/blog/api-dividendos-acoes-fiis-brasil-como-consultar-2026). ## Impostos e valor líquido O tratamento depende do evento, do ativo e da legislação vigente. Dividendos, JCP, rendimentos de FIIs e ganhos na venda não seguem uma regra única. Faça a simulação líquida apenas depois de identificar cada fluxo. Para decisões tributárias, confira a Receita Federal e procure orientação profissional quando o caso exigir. ## Margem de segurança Se o orçamento exige R$ 5.000 por mês, não monte um plano que produz exatamente R$ 5.000 no cenário otimista. Considere: * meses com pagamentos menores; * inflação; * impostos e taxas; * emergências; * necessidade de reinvestir parte da renda. Uma meta com folga reduz a chance de vender ativos em um momento ruim. O próximo passo é testar os números no [simulador de dividendos](/calculadoras/simulador-de-rentabilidade-e-dividendos) e comparar pelo menos três cenários. # Calculadora Fat FIRE 2025: Independência Financeira com Alto Padrão no Brasil URL: /blog/calculadora-fat-fire-independencia-financeira-alto-padrao-brasil.mdx Alcance Fat FIRE no Brasil com nossa calculadora interativa. Aposentadoria precoce com alto padrão de vida ✓ *** searchable: true title: 'Calculadora Fat FIRE 2025: Independência Financeira com Alto Padrão no Brasil' description: 'Alcance Fat FIRE no Brasil com nossa calculadora interativa. Aposentadoria precoce com alto padrão de vida ✓' date: '2025-08-22' keywords: 'Fat FIRE Brasil 2025, alta renda, independência financeira luxo, aposentadoria rica, calculadora Fat FIRE gratuita, alto padrão vida, gráficos interativos' author: 'Equipe brapi.dev' category: 'Independência Financeira' subcategory: 'Fat FIRE' readingTime: '14 min' tags: \['Fat FIRE', 'Alto Padrão', 'Independência Financeira', 'Calculadora', 'Aposentadoria Rica', 'Planejamento Financeiro', 'Brasil', 'Luxo'] relatedPosts: \['calculadora-fire-tradicional-regra-4-porcento-brasil', 'calculadora-lean-fire-independencia-financeira-minimalista-brasil', 'calculadoras-fire-independencia-financeira-brasil'] featured: true expertise: 'Especialistas em estratégias FIRE para alta renda com metodologias avançadas de acumulação patrimonial' lastReviewed: '2025-08-22' howToTools: \['Calculadora Fat FIRE brapi.dev', 'Planilha de despesas', 'Simulador de investimentos'] howToSteps: * name: 'Calcule suas despesas mensais de alto padrão' text: 'Liste todos os gastos desejados para manter seu estilo de vida atual ou superior na aposentadoria.' * name: 'Acesse a Calculadora Fat FIRE' text: 'Navegue até a calculadora Fat FIRE em brapi.dev para iniciar sua simulação.' * name: 'Escolha o multiplicador de segurança' text: 'Selecione um multiplicador entre 25x e 50x suas despesas anuais conforme seu nível de segurança desejado.' * name: 'Defina sua taxa de retorno esperada' text: 'Configure o retorno anual esperado dos seus investimentos considerando inflação.' * name: 'Analise o tempo até atingir a meta' text: 'Visualize nos gráficos quanto tempo levará para acumular o patrimônio necessário.' *** import { Authors, Author } from '~/components/Authors'; > **Não abra mão do seu conforto na aposentadoria precoce!** Descubra como alcançar Fat FIRE no Brasil de 2025 mantendo ou elevando seu padrão de vida. Nossa Calculadora Fat FIRE oferece multiplicadores flexíveis de 25x a 50x suas despesas, garantindo máxima segurança e luxo na independência financeira. ## O que é Fat FIRE? Fat FIRE é a modalidade do movimento FIRE voltada para pessoas que desejam manter ou até elevar seu padrão de vida durante a aposentadoria precoce. Diferente do FIRE tradicional (25x despesas) ou Lean FIRE (20x despesas), o Fat FIRE utiliza multiplicadores entre 25x e 50x, oferecendo margem de segurança substancial e flexibilidade para gastos extraordinários. ### Características do Fat FIRE **Vantagens:** * **Margem de segurança elevada**: Proteção contra crises e imprevistos * **Flexibilidade de gastos**: Capacidade de aumentar despesas sem comprometer a estratégia * **Estilo de vida preservado**: Manutenção ou melhoria do padrão atual * **Legado familiar**: Possibilidade de deixar herança significativa **Desafios:** * **Meta mais alta**: Requer mais tempo ou aportes maiores * **Disciplina prolongada**: Período de acumulação mais longo * **Renda elevada necessária**: Geralmente requer altos salários ou negócios próprios ## Como Funciona Nossa Calculadora Fat FIRE Nossa [Calculadora Fat FIRE](/calculadoras/fat-fire) oferece recursos únicos para esta estratégia ambiciosa: ### 🎯 Multiplicadores Flexíveis * **Range 25x-50x**: Ajuste o multiplicador conforme seu perfil de risco * **Personalização total**: Escolha exatamente o nível de segurança desejado * **Cenários comparativos**: Visualize diferentes multiplicadores simultaneamente ### 📊 Gráficos Avançados de Projeção A calculadora mostra: * **Crescimento patrimonial**: Linha azul mostrando evolução dos investimentos * **Meta Fat FIRE ajustável**: Linha verde que se adapta ao multiplicador escolhido * **Marcos intermediários**: Pontos de referência durante a jornada ### 💡 Análise de Cenários Sofisticada Interface inclui: * **Simulação de gastos extras**: Como viagens, hobbies caros, emergências familiares * **Análise de inflação de estilo de vida**: Projeção de aumento natural de gastos * **Planejamento de herança**: Cálculo de patrimônio excedente ## Perfis Ideais para Fat FIRE no Brasil ### 1. Executivos de Alto Escalão **Características típicas:** * Renda familiar: R$ 50.000+ por mês * Gastos atuais: R$ 20.000-35.000 por mês * Patrimônio já acumulado: R$ 1-5 milhões * Idade típica de início: 35-45 anos **Estratégia recomendada:** * Multiplicador: 30-35x * Foco em preservação do padrão de vida executivo * Diversificação internacional significativa ### 2. Empresários e Profissionais Liberais **Características típicas:** * Renda variável alta: R$ 30.000-100.000+ por mês * Gastos flutuantes: R$ 15.000-50.000 por mês * Patrimônio em crescimento: R$ 500k-10M+ * Idade de início: 30-50 anos **Estratégia recomendada:** * Multiplicador: 35-40x (devido à variabilidade de renda) * Reservas extras para oportunidades de negócio * Proteção contra volatilidade de renda ### 3. Investidores e Rentistas **Características típicas:** * Renda passiva substancial: R$ 25.000+ por mês * Gastos elevados: R$ 18.000-40.000 por mês * Patrimônio consolidado: R$ 3-20 milhões * Qualquer idade (herança ou sucesso precoce) **Estratégia recomendada:** * Multiplicador: 25-30x (renda já é passiva) * Foco em proteção e crescimento do patrimônio * Otimização fiscal avançada ## Estratégias de Acumulação Fat FIRE no Brasil ### 1. Portfolio de Alto Patrimônio **Alocação Sugerida para Fat FIRE:** * **30%** Ações brasileiras blue-chips * **20%** Fundos Imobiliários de alto padrão * **15%** ETFs internacionais desenvolvidos * **10%** Títulos privados de alta qualidade * **10%** ETFs de mercados emergentes * **5%** Commodities e proteção cambial * **5%** Investimentos alternativos (Private Equity, REITs internacionais) * **5%** Reserva de oportunidade ### 2. Proteção Avançada contra Riscos **Riscos Específicos do Fat FIRE:** **Sequência de Retornos Negativa:** * **Problema**: Perdas no início da aposentadoria são devastadoras para portfolios grandes * **Solução**: Barbell strategy - 3-5 anos em renda fixa + resto em crescimento **Inflação de Estilo de Vida:** * **Problema**: Tendência de aumentar gastos com mais patrimônio * **Solução**: Orçamento fixo rígido nos primeiros anos de Fat FIRE **Concentração Geográfica:** * **Problema**: Dependência excessiva do Brasil * **Solução**: 30-40% em ativos internacionais ### 3. Otimização Fiscal para Grandes Patrimônios **Estratégias Avançadas:** **Previdência Privada VGBL:** * Contribuições de até R$ 200k/ano com benefício fiscal * Ideal para quem tem alta renda tributável * Planejamento sucessório facilitado **Holding Familiar:** * Proteção patrimonial avançada * Otimização na transmissão de herança * Gestão centralizada de investimentos **Diversificação Tributária Internacional:** * ETFs irlandeses (menor tributação) * REITs americanos via tratado tributário * Estruturas offshore legais para não-residentes ## Exemplos Práticos Fat FIRE Brasil ### Caso 1: Executivo de Multinacional (42 anos) **Perfil:** * Renda familiar: R$ 80.000/mês * Gastos atuais: R$ 30.000/mês * Patrimônio atual: R$ 3.200.000 * Aporte mensal: R$ 45.000 * Multiplicador escolhido: **32x** * Rentabilidade esperada: 11% ao ano **Meta Fat FIRE:** R$ 11.520.000 (32 × R$ 360.000 anuais) **Resultado:** * Tempo para Fat FIRE: **8,2 anos** * Idade ao atingir Fat FIRE: **50 anos** * Renda passiva: R$ 30.000/mês (mantendo padrão atual) **Estratégia específica:** * 40% investimentos internacionais (proteção cambial) * Previdência privada máxima para benefício fiscal * Reserva extra para educação dos filhos no exterior ### Caso 2: Empresário de Sucesso (38 anos) **Perfil:** * Renda empresarial: R$ 120.000/mês (variável) * Gastos elevados: R$ 45.000/mês * Patrimônio atual: R$ 5.800.000 * Aporte mensal: R$ 70.000 * Multiplicador escolhido: **40x** * Rentabilidade esperada: 12% ao ano **Meta Fat FIRE:** R$ 21.600.000 (40 × R$ 540.000 anuais) **Resultado:** * Tempo para Fat FIRE: **9,8 anos** * Idade ao atingir Fat FIRE: **48 anos** * Margem de segurança: 80% acima do FIRE tradicional **Diferenciais:** * Multiplicador alto devido à renda variável do negócio * Estratégia de saída parcial da empresa aos 48 anos * Manutenção de participação societária como renda extra ### Caso 3: Casal de Médicos Especialistas (35 anos) **Perfil:** * Renda conjunta: R$ 65.000/mês * Gastos de alto padrão: R$ 25.000/mês * Patrimônio atual: R$ 1.500.000 * Aporte mensal: R$ 35.000 * Multiplicador escolhido: **28x** * Rentabilidade esperada: 10% ao ano **Meta Fat FIRE:** R$ 8.400.000 (28 × R$ 300.000 anuais) **Resultado:** * Tempo para Fat FIRE: **12,5 anos** * Idade ao atingir Fat FIRE: **47 anos** * Flexibilidade para reduzir carga de trabalho gradualmente ## Gestão Avançada do Fat FIRE ### Fase de Acumulação (Pré-FIRE) **1. Otimização de Renda** * **Negociação agressiva**: Salários, bônus, participação nos lucros * **Renda extra escalável**: Consultorias, cursos, investimentos em negócios * **Educação contínua**: MBA, especializações que aumentem earning power **2. Controle de Lifestyle Inflation** * **Orçamento percentual**: Mantenha gastos como % da renda * **Automação de aportes**: Aumente aportes junto com aumentos salariais * **Gastos conscientes**: Foque qualidade sobre quantidade **3. Aceleração através de Ativos** * **Imóveis de renda**: Apartamentos em localizações prime * **Negócios passivos**: Franquias, participações societárias * **Royalties e licenciamentos**: Propriedade intelectual ### Fase de Transição (Near-FIRE) **1. Proteção do Patrimônio** * **Aumento gradual em renda fixa**: Reduzir volatilidade próximo à meta * **Hedge cambial**: Proteção contra desvalorização do real * **Seguros robustos**: Vida, invalidez, responsabilidade civil **2. Planejamento da Saída** * **Redução gradual de responsabilidades**: Transição de 2-3 anos * **Manutenção de vínculos profissionais**: Consultoria esporádica * **Preparação psicológica**: Coaching para transição de carreira ### Fase de Execução (Pós-FIRE) **1. Gestão da Retirada** * **Sistema de buckets**: 5 anos renda fixa + resto em crescimento * **Retiradas flexíveis**: Ajustar conforme performance do mercado * **Rebalanceamento disciplinado**: Manter alocação target **2. Crescimento Contínuo** * **Preservação do poder de compra**: Crescimento acima da inflação * **Oportunidades de reinvestimento**: Aproveitar crises para acelerar * **Novos fluxos de renda**: Hobbies monetizados, investimentos angel ## Riscos Específicos do Fat FIRE e Mitigação ### 1. Risco de Concentração de Renda **Problema:** Dependência excessiva de uma fonte de renda alta **Soluções:** * Diversificação de fontes de renda desde cedo * Construção de multiple streams of income * Network profissional robusto para oportunidades ### 2. Risco de Lifestyle Creep Acelerado **Problema:** Gastos crescem mais rápido que o patrimônio **Soluções:** * Orçamento rígido baseado em percentuais da renda * Automação total dos investimentos * Reviews trimestrais de gastos vs metas ### 3. Risco Político-Econômico Brasileiro **Problema:** Instabilidade pode afetar grandes patrimônios desproporcionalmente **Soluções:** * Diversificação geográfica agressiva (40%+ internacional) * Estruturas legais de proteção patrimonial * Plano B para mudança de país se necessário ### 4. Risco de Sequência de Retornos **Problema:** Perdas nos primeiros anos do Fat FIRE são devastadoras **Soluções:** * Bond tent: Aumentar renda fixa nos últimos 5 anos pré-FIRE * 5-year cash cushion: Nunca vender em baixa * Flexible withdrawal: 3-4% em anos ruins, 4-5% em anos bons ## Ferramentas Complementares para Fat FIRE ### Calculadoras Relacionadas **1. [Calculadora de Dividendos](/calculadoras/simulador-de-rentabilidade-e-dividendos)** * Simule renda passiva para Fat FIRE * Compare diferentes classes de ativos de renda **2. [Calculadora Coast FIRE](/calculadoras/coast-fire)** * Veja quando pode reduzir aportes * Planeje transição gradual para aposentadoria **3. [Calculadora Geographic Arbitrage](/calculadoras/geographic-arbitrage-fire)** * Compare custos de vida internacional * Otimize localização pós-Fat FIRE ### Serviços Profissionais Especializados **Assessoria Financeira:** * Private banking para patrimônios >R$ 10M * Consultoria independente para estruturação * Family office para patrimônios >R$ 50M **Planejamento Tributário:** * Contadores especializados em grandes fortunas * Advogados tributaristas para estruturas complexas * Consultores internacionais para diversificação **Gestão de Riscos:** * Seguros de alta cobertura (R$ 5-50M+) * Estruturas de proteção patrimonial * Planejamento sucessório avançado ## Monitoramento e KPIs Fat FIRE ### Métricas Fundamentais **1. Fat FIRE Progress Ratio** * **Cálculo**: Patrimônio Atual / Meta Fat FIRE * **Marcos**: 10%, 25%, 50%, 75%, 90%, 100% * **Frequência**: Trimestral **2. Passive Income Coverage** * **Cálculo**: Renda Passiva Mensal / Gastos Mensais * **Meta**: >100% (idealmente 120-150% para Fat FIRE) * **Frequência**: Mensal **3. Withdrawal Rate Atual** * **Cálculo**: Gastos Anuais / Patrimônio Total * **Fat FIRE target**: 2-4% (maior margem de segurança) * **Frequência**: Anual ### Dashboard Fat FIRE **Acompanhamento Recomendado:** * **Patrimônio total**: Valor atualizado mensalmente * **Alocação de ativos**: Dentro dos targets definidos * **Performance vs benchmark**: Comparação com índices * **Gastos vs orçamento**: Controle de lifestyle inflation * **Projeção de prazo**: Baseada na performance atual ## Perguntas Frequentes sobre Fat FIRE ### 1. Qual é a diferença prática entre FIRE tradicional e Fat FIRE? **Resposta:** FIRE tradicional usa 25x despesas (4% de retirada), enquanto Fat FIRE usa 25x-50x (2-4% de retirada). Para gastos de R$ 20.000/mês: FIRE tradicional = R$ 6M, Fat FIRE 35x = R$ 8,4M. A diferença oferece muito mais segurança e flexibilidade. ### 2. É possível Fat FIRE no Brasil com renda de R$ 30.000/mês? **Resposta:** É desafiador mas possível. Com gastos de R$ 15.000/mês e aportes de R$ 12.000/mês, levaria cerca de 15-20 anos. Considere aumentar renda através de negócios próprios ou investimentos para acelerar. ### 3. Como lidar com a volatilidade do mercado brasileiro no Fat FIRE? **Resposta:** Diversificação internacional é essencial (30-40% do portfolio). Use também estratégia de bucket (5 anos em renda fixa) e withdrawal rate flexível (3-5% conforme mercado). ### 4. Fat FIRE compensa vs emigração para países desenvolvidos? **Resposta:** Depende do seu perfil. Fat FIRE no Brasil com R$ 8-15M pode oferecer padrão de vida superior ao de classe média alta nos EUA/Europa. Use nossa [calculadora Geographic Arbitrage](/calculadoras/geographic-arbitrage-fire) para comparar. ### 5. Como proteger grande patrimônio de crises políticas/econômicas? **Resposta:** Diversificação geográfica agressiva, estruturas legais de proteção patrimonial, cidadania/residência alternativa, e sempre manter 20-30% em ativos internacionais de alta liquidez. ### 6. Posso fazer Fat FIRE e ainda deixar herança significativa? **Resposta:** Sim! Fat FIRE com multiplicadores 35x+ permite retirada conservadora de 2,5-3%, preservando capital. Com crescimento de 8-10% ao ano, você pode gastar 3% e ainda crescer 5-7% reais. ## Conclusão: Luxo e Segurança na Independência Financeira Fat FIRE representa o ápice do planejamento financeiro: combina independência, segurança e manutenção do alto padrão de vida. Com nossa [Calculadora Fat FIRE](/calculadoras/fat-fire), você pode: **✅ Personalizar multiplicadores** de 25x a 50x conforme seu perfil **✅ Visualizar cenários sofisticados** com gráficos interativos **✅ Planejar margem de segurança** para imprevistos e oportunidades **✅ Comparar estratégias** com outras modalidades FIRE **Fat FIRE é ideal para:** * Executivos e empresários de alta renda * Profissionais liberais estabelecidos * Pessoas que não querem reduzir padrão de vida * Quem busca máxima segurança financeira **Benefícios únicos:** * **Flexibilidade total**: Gastos extras sem comprometer a estratégia * **Legado familiar**: Patrimônio cresce mesmo durante aposentadoria * **Oportunidades**: Capital para novos investimentos e negócios * **Tranquilidade**: Margem de segurança contra qualquer crise Lembre-se: Fat FIRE não é apenas sobre ter mais dinheiro, é sobre ter **liberdade total** - liberdade para viver como quiser, onde quiser, fazendo o que quiser, sem nunca se preocupar com dinheiro novamente. **[🎯 Calcule seu Fat FIRE agora →](/calculadoras/fat-fire)** Descubra quanto você precisa para alcançar a independência financeira com máximo conforto e segurança! # Calculadora FIRE: Independência Financeira - Quanto Preciso para Aposentar? URL: /blog/calculadora-fire-independencia-financeira-aposentadoria-2026.mdx Calcule quanto você precisa para alcançar a independência financeira (FIRE). Simulador completo com diferentes cenários, taxa de retirada segura e estratégias. *** searchable: true title: 'Calculadora FIRE: Independência Financeira - Quanto Preciso para Aposentar?' description: 'Calcule quanto você precisa para alcançar a independência financeira (FIRE). Simulador completo com diferentes cenários, taxa de retirada segura e estratégias.' date: '2026-01-01' keywords: 'calculadora fire 2026, independencia financeira, aposentadoria antecipada, quanto preciso para aposentar, regra dos 4%, fire brasil, liberdade financeira, renda passiva aposentadoria' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Independência Financeira' readingTime: '16 min' tags: \['FIRE', 'Independência Financeira', 'Aposentadoria', 'Calculadora', 'Renda Passiva', 'Liberdade Financeira'] relatedPosts: \['juros-compostos-o-que-sao-como-calcular-simulador-2026', 'planejamento-financeiro-pessoal-guia-completo-2026', 'dividendos-como-construir-renda-passiva', 'alocacao-de-ativos-por-idade-carteira-ideal-2026', 'calculadoras-fire-independencia-financeira-brasil'] featured: true expertise: 'Simuladores desenvolvidos por especialistas em planejamento financeiro e independência financeira.' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; O movimento **FIRE** (Financial Independence, Retire Early) ganhou força no Brasil. A ideia é simples: acumular patrimônio suficiente para viver dos rendimentos, sem depender de trabalho. Mas **quanto você precisa acumular** para conquistar essa liberdade? Neste guia, você vai encontrar calculadoras completas para simular seu caminho até a independência financeira, entender a regra dos 4%, e ajustar estratégias para a realidade brasileira. ## O Que é FIRE? FIRE significa **Financial Independence, Retire Early** (Independência Financeira, Aposentadoria Antecipada). O objetivo é: 1. Acumular patrimônio que gere renda passiva 2. Cobrir seus gastos mensais sem trabalhar 3. Ter liberdade para escolher como usar seu tempo ### Variações do FIRE | Tipo | Descrição | Patrimônio Necessário | | ---------------- | -------------------------------------- | --------------------- | | **Fat FIRE** | Estilo de vida confortável, sem cortes | 40-50x gastos anuais | | **Regular FIRE** | Vida confortável, alguns cortes | 25-30x gastos anuais | | **Lean FIRE** | Vida frugal, gastos mínimos | 20-25x gastos anuais | | **Barista FIRE** | Trabalho parcial complementa renda | 15-20x gastos anuais | | **Coast FIRE** | Para de aportar, deixa crescer | Varia por idade | *** ## A Regra dos 4% (Taxa de Retirada Segura) A base do FIRE é a **regra dos 4%**, criada pelo estudo Trinity (1998): ``` Patrimônio Necessário = Gastos Anuais × 25 ``` ### Como Funciona Se você retira 4% do patrimônio ao ano, há 95% de chance de o dinheiro durar pelo menos 30 anos (baseado em dados históricos dos EUA). | Gastos Mensais | Gastos Anuais | Patrimônio FIRE (4%) | | -------------- | ------------- | -------------------- | | R$ 5.000 | R$ 60.000 | R$ 1.500.000 | | R$ 7.500 | R$ 90.000 | R$ 2.250.000 | | R$ 10.000 | R$ 120.000 | R$ 3.000.000 | | R$ 15.000 | R$ 180.000 | R$ 4.500.000 | | R$ 20.000 | R$ 240.000 | R$ 6.000.000 | ### Regra dos 4% no Brasil: Ajustes Necessários A regra dos 4% foi criada para o mercado americano. No Brasil, precisamos considerar: | Fator | EUA | Brasil | Ajuste | | ---------------------- | ------------- | ------------- | --------------------------- | | **Inflação histórica** | \~3% | \~6% | Taxa maior de retirada real | | **Retorno bolsa** | \~10% nominal | \~12% nominal | Similar em termos reais | | **Renda fixa** | \~5% | \~10-13% | Brasil favorável | | **Volatilidade** | Menor | Maior | Margem de segurança | **Recomendação para o Brasil:** Use taxa de retirada de **3,5% a 4%** para maior segurança. *** ## Calculadora FIRE Completa ### Calculadora 1: Patrimônio Necessário **Fórmula:** ``` Patrimônio Necessário = Gastos Anuais ÷ (Taxa de Retirada ÷ 100) Patrimônio com Margem = Patrimônio × (1 + Margem ÷ 100) ``` **Exemplo: Gastos de R$ 10.000/mês, taxa de retirada 4%:** | Métrica | Valor | | ------------------------- | ---------------- | | Gastos mensais desejados | R$ 10.000 | | Gastos anuais | R$ 120.000 | | Taxa de retirada | 4% | | Multiplicador | 25x | | **Patrimônio necessário** | **R$ 3.000.000** | | Com margem de 10% | R$ 3.300.000 | **Tabela de referência rápida:** | Gastos Mensais | Patrimônio (4%) | Patrimônio (3,5%) | | -------------- | --------------- | ----------------- | | R$ 5.000 | R$ 1.500.000 | R$ 1.714.286 | | R$ 8.000 | R$ 2.400.000 | R$ 2.742.857 | | R$ 10.000 | R$ 3.000.000 | R$ 3.428.571 | | R$ 15.000 | R$ 4.500.000 | R$ 5.142.857 | | R$ 20.000 | R$ 6.000.000 | R$ 6.857.143 | ### Calculadora 2: Tempo para FIRE **Fórmula de juros compostos com aportes:** ``` Patrimônio = Inicial × (1 + taxa)^meses + Aporte × [((1 + taxa)^meses - 1) / taxa] ``` **Exemplo: R$ 50.000 inicial, R$ 3.000/mês, meta R$ 3 milhões, retorno 10% a.a.:** | Ano | Patrimônio Acumulado | | ------ | -------------------- | | 1 | R$ 92.500 | | 3 | R$ 188.000 | | 5 | R$ 315.000 | | 10 | R$ 738.000 | | 15 | R$ 1.420.000 | | 18 | R$ 2.050.000 | | 20 | R$ 2.620.000 | | **22** | **R$ 3.200.000** ✅ | | Métrica | Valor | | ---------------------- | ------------ | | Patrimônio inicial | R$ 50.000 | | Aporte mensal | R$ 3.000 | | Meta | R$ 3.000.000 | | Retorno anual esperado | 10% | | **Tempo necessário** | **22 anos** | | Total aportado | R$ 842.000 | | Rendimentos | R$ 2.358.000 | ### Calculadora 3: Taxa de Poupança e Idade FIRE A taxa de poupança é o fator mais importante para o FIRE: **Fórmula:** ``` Taxa de Poupança = (Renda - Gastos) / Renda × 100 Meta de Patrimônio = Gastos Anuais / (Taxa Retirada / 100) ``` **Exemplo: 30 anos, R$ 12.000 de renda, R$ 7.000 de gastos, R$ 100.000 acumulado:** | Métrica | Valor | | -------------------- | ------------ | | Idade atual | 30 anos | | Renda mensal | R$ 12.000 | | Gastos mensais | R$ 7.000 | | Poupança mensal | R$ 5.000 | | **Taxa de poupança** | **41,7%** | | Meta de patrimônio | R$ 2.100.000 | | Anos para FIRE | 14,5 | | **Idade FIRE** | **45 anos** | ### Tabela: Taxa de Poupança x Anos para FIRE | Taxa de Poupança | Anos para FIRE\* | Comentário | | ---------------- | ---------------- | ------------------------- | | 10% | 51 anos | Muito lento | | 20% | 37 anos | Aposentadoria tradicional | | 30% | 28 anos | Bom progresso | | 40% | 22 anos | Agressivo | | 50% | 17 anos | Muito agressivo | | 60% | 13 anos | Extremo | | 70% | 9 anos | Quase impossível | \*Partindo do zero, com retorno real de 5% a.a. *** ## Calculadora 4: Simulação Completa com Diferentes Cenários **Fórmula:** ``` Meta = (Gastos Aposentadoria × 12) ÷ (Taxa de Retirada ÷ 100) ``` **Exemplo: Idade 28, patrimônio R$ 80.000, aporte R$ 4.000/mês, gastos R$ 8.000/mês** Meta de patrimônio: **R$ 2.400.000** | Cenário | Retorno a.a. | Anos para FIRE | Idade FIRE | | ----------- | ------------ | -------------- | ---------- | | Conservador | 6% | 22,5 anos | 50 anos | | Moderado | 8% | 18,8 anos | 47 anos | | Agressivo | 10% | 16,2 anos | 44 anos | | Otimista | 12% | 14,3 anos | 42 anos | > **Insight:** A diferença entre um cenário conservador e agressivo pode significar 8 anos a menos de trabalho! *** ## Estratégias de Retirada na Aposentadoria ### 1. Retirada Fixa (4%) A estratégia mais simples: retire 4% do patrimônio inicial, ajustado pela inflação. **Fórmula:** ``` Retirada Anual = Patrimônio Inicial × (Taxa de Retirada ÷ 100) Patrimônio Novo = Patrimônio + Rendimento - Retirada Ajustada pela Inflação ``` **Exemplo: R$ 3.000.000, taxa 4%, retorno 8% a.a., inflação 4% a.a.** | Ano | Patrimônio | Retirada Anual | Retirada Mensal | | --- | ------------ | -------------- | --------------- | | 1 | R$ 3.004.800 | R$ 124.800 | R$ 10.400 | | 5 | R$ 3.023.456 | R$ 146.033 | R$ 12.169 | | 10 | R$ 3.008.712 | R$ 177.649 | R$ 14.804 | | 15 | R$ 2.912.584 | R$ 216.127 | R$ 18.011 | | 20 | R$ 2.680.215 | R$ 262.912 | R$ 21.909 | | 25 | R$ 2.232.478 | R$ 319.814 | R$ 26.651 | | 30 | R$ 1.456.892 | R$ 389.001 | R$ 32.417 | > **Patrimônio final após 30 anos:** R$ 1.456.892 — o dinheiro não acabou! ### 2. Retirada Variável (Guardrails) Ajusta retiradas baseado no desempenho da carteira: | Situação | Ação | | ------------------- | ------------------------ | | Carteira subiu >20% | Aumentar retirada em 10% | | Carteira estável | Manter retirada | | Carteira caiu >15% | Reduzir retirada em 10% | | Carteira caiu >25% | Reduzir retirada em 20% | ### 3. Estratégia do Balde (Bucket Strategy) Divide o patrimônio em "baldes" por horizonte: | Balde | Horizonte | Alocação | Objetivo | | ----- | --------- | --------------- | ---------------- | | **1** | 0-2 anos | 100% renda fixa | Gastos imediatos | | **2** | 2-7 anos | 50% RF, 50% RV | Médio prazo | | **3** | 7+ anos | 80% RV, 20% RF | Crescimento | *** ## Acompanhando seu Progresso com brapi.dev ### Dashboard de Progresso FIRE ```typescript const portfolio = { BOVA11: 500, IVVB11: 300, XPLG11: 200, KNRI11: 150, }; const tickers = Object.keys(portfolio).join(","); const response = await fetch(`https://brapi.dev/api/quote/${tickers}`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }, }); const { results } = await response.json(); // Calcular patrimônio total let totalValue = 0; for (const stock of results) { const quantity = portfolio[stock.symbol]; totalValue += stock.regularMarketPrice * quantity; } // Calcular progresso FIRE const fireMeta = 2_500_000; const progress = (totalValue / fireMeta) * 100; const passiveIncome = (totalValue * 0.04) / 12; // 4% a.a. ``` **Exemplo de Dashboard:** | Ativo | Quantidade | Preço | Valor | | ------ | ---------- | --------- | --------- | | BOVA11 | 500 cotas | R$ 120,50 | R$ 60.250 | | IVVB11 | 300 cotas | R$ 280,30 | R$ 84.090 | | XPLG11 | 200 cotas | R$ 105,20 | R$ 21.040 | | KNRI11 | 150 cotas | R$ 155,80 | R$ 23.370 | | Métrica | Valor | | ----------------------------- | ------------ | | **Patrimônio total** | R$ 188.750 | | **Meta FIRE** | R$ 2.500.000 | | **Progresso** | 7,5% | | **Renda passiva mensal (4%)** | R$ 629 | ### Calculadora de Aporte Necessário **Fórmula:** ``` Taxa Mensal = (1 + Retorno Anual)^(1/12) - 1 VF Patrimônio Atual = Patrimônio × (1 + Taxa Mensal)^Meses Falta Acumular = Meta - VF Patrimônio Aporte Mensal = Falta Acumular ÷ ((1 + Taxa Mensal)^Meses - 1) ÷ Taxa Mensal) ``` **Exemplo: Patrimônio R$ 150.000, meta R$ 3.000.000, prazo 15 anos, retorno 10% a.a.** | Métrica | Valor | | ---------------------------- | ------------ | | Patrimônio atual | R$ 150.000 | | Meta FIRE | R$ 3.000.000 | | Prazo | 15 anos | | Retorno esperado | 10% a.a. | | **Patrimônio atual valerá** | R$ 626.859 | | **Falta acumular** | R$ 2.373.141 | | **Aporte mensal necessário** | **R$ 5.745** | | **Aporte anual** | R$ 68.940 | *** ## FIRE no Brasil: Considerações Especiais ### Adaptações para a Realidade Brasileira | Aspecto | EUA | Brasil | Recomendação | | ------------ | --------------------- | ------------------------------ | ----------------------------------------- | | **Saúde** | Medicare após 65 anos | Sem cobertura pública adequada | Incluir plano de saúde nos gastos | | **INSS** | Social Security | INSS (teto \~R$ 7.800) | Considerar como bônus, não base | | **Inflação** | \~3% histórica | \~5-6% histórica | Taxa de retirada mais conservadora | | **Impostos** | Capital gains tax | IR sobre RV, isenções | Estruturar carteira com eficiência fiscal | ### Carteira FIRE para o Brasil Uma carteira típica para quem busca FIRE no Brasil: **Carteira FIRE de R$ 2.000.000:** | Classe | Ativo | Peso | Valor | | ------------------------------- | ---------------------------- | -------- | ---------------- | | **Renda Fixa (40%)** | Tesouro IPCA+ 2045 | 15% | R$ 300.000 | | | CDBs/LCIs/LCAs | 15% | R$ 300.000 | | | Debêntures incentivadas | 10% | R$ 200.000 | | **Renda Variável Brasil (35%)** | ETFs (BOVA11, DIVO11) | 15% | R$ 300.000 | | | FIIs | 12% | R$ 240.000 | | | Ações dividendos | 8% | R$ 160.000 | | **Internacional (20%)** | ETFs EUA (IVVB11) | 15% | R$ 300.000 | | | ETFs Global | 5% | R$ 100.000 | | **Reserva (5%)** | Tesouro Selic / CDB liquidez | 5% | R$ 100.000 | | | **Total** | **100%** | **R$ 2.000.000** | > **Renda passiva estimada (4%):** R$ 80.000/ano ou R$ 6.667/mês ### Gastos a Considerar no FIRE Não esqueça de incluir: | Categoria | Estimativa Mensal | Observação | | --------------- | ----------------- | --------------------- | | **Moradia** | R$ 2.000-5.000 | Aluguel ou condomínio | | **Alimentação** | R$ 1.500-3.000 | Inclui restaurantes | | **Saúde** | R$ 1.000-3.000 | Plano + medicamentos | | **Transporte** | R$ 500-1.500 | Carro ou apps | | **Lazer** | R$ 1.000-3.000 | Viagens, hobbies | | **Educação** | R$ 0-1.000 | Cursos, livros | | **Vestuário** | R$ 300-800 | Roupas, calçados | | **Imprevistos** | 10-15% do total | Margem de segurança | *** ## Perguntas Frequentes (FAQ) ### Quanto preciso para viver de renda no Brasil? Depende do seu estilo de vida. Para R$ 10.000/mês (R$ 120.000/ano), você precisa de aproximadamente R$ 3.000.000 (regra dos 4%). ### A regra dos 4% funciona no Brasil? Sim, mas recomenda-se usar 3,5% para maior segurança, dada a maior volatilidade e inflação histórica do país. ### Posso contar com o INSS? Como bônus, sim. Como base do FIRE, não. O teto do INSS é baixo (\~R$ 7.800) e pode mudar com reformas. ### Qual a melhor idade para atingir FIRE? Depende de quando você começa e quanto poupa. Com taxa de poupança de 50%, é possível em 15-17 anos partindo do zero. ### E se o mercado cair logo após eu aposentar? Use a estratégia de guardrails (reduzir retiradas em quedas) ou mantenha 2-3 anos de gastos em renda fixa para não vender ativos em baixa. ### Devo pagar minha casa antes do FIRE? Depende. Casa própria quitada reduz gastos mensais, mas imobiliza capital. Faça as contas considerando custo de oportunidade. *** ## Conclusão A independência financeira é alcançável com **planejamento**, **disciplina** e **tempo**. As calculadoras deste guia ajudam a visualizar seu caminho: **Passos para o FIRE:** 1. Calcule seus gastos reais (e futuros) 2. Determine sua meta de patrimônio (25x gastos anuais) 3. Maximize sua taxa de poupança 4. Invista de forma diversificada e consistente 5. Acompanhe seu progresso regularmente Para monitorar seus investimentos e calcular seu patrimônio em tempo real, a [API da brapi.dev](https://brapi.dev) oferece cotações de ações, FIIs, ETFs e outros ativos negociados na bolsa brasileira. *** ## Recursos Adicionais * [Juros Compostos: Como Calcular](/blog/juros-compostos-o-que-sao-como-calcular-simulador-2026) * [Planejamento Financeiro Pessoal: Guia Completo](/blog/planejamento-financeiro-pessoal-guia-completo-2026) * [Dividendos: Como Construir Renda Passiva](/blog/dividendos-como-construir-renda-passiva) * [Alocação de Ativos por Idade](/blog/alocacao-de-ativos-por-idade-carteira-ideal-2026) * [Documentação da API brapi.dev](/docs) # Calculadora FIRE Tradicional 2025: Regra dos 4% Adaptada ao Brasil URL: /blog/calculadora-fire-tradicional-regra-4-porcento-brasil.mdx Calculadora FIRE Tradicional da brapi: planeje sua aposentadoria precoce. Regra dos 4% com gráficos interativos ✓ *** searchable: true title: 'Calculadora FIRE Tradicional 2025: Regra dos 4% Adaptada ao Brasil' description: 'Calculadora FIRE Tradicional da brapi: planeje sua aposentadoria precoce. Regra dos 4% com gráficos interativos ✓' date: '2025-08-22' keywords: 'FIRE tradicional Brasil 2025, regra 4%, aposentadoria precoce, independência financeira, calculadora FIRE gratuita, planejamento financeiro, gráficos interativos' author: 'Equipe brapi.dev' category: 'Independência Financeira' subcategory: 'FIRE Tradicional' readingTime: '12 min' tags: \['FIRE', 'Aposentadoria Precoce', 'Independência Financeira', 'Calculadora', 'Regra 4%', 'Planejamento Financeiro', 'Brasil', 'Investimentos'] relatedPosts: \['calculadora-fat-fire-independencia-financeira-alto-padrao-brasil', 'calculadora-lean-fire-independencia-financeira-minimalista-brasil', 'calculadoras-fire-independencia-financeira-brasil'] featured: true expertise: 'Especialistas em independência financeira e movimento FIRE com metodologias testadas no mercado brasileiro' lastReviewed: '2025-08-22' howToTools: \['Calculadora FIRE brapi.dev', 'Planilha de gastos mensais', 'Extrato de investimentos'] howToSteps: * name: 'Calcule suas despesas anuais' text: 'Some todos os seus gastos mensais e multiplique por 12 para obter o valor anual necessário.' * name: 'Aplique a regra dos 25x' text: 'Multiplique suas despesas anuais por 25 para descobrir o patrimônio necessário para FIRE.' * name: 'Acesse a Calculadora FIRE Tradicional' text: 'Use a calculadora em brapi.dev para simular diferentes cenários de aportes e retornos.' * name: 'Configure taxa de retorno e inflação' text: 'Ajuste os parâmetros para refletir expectativas realistas do mercado brasileiro.' * name: 'Visualize sua trajetória até FIRE' text: 'Analise os gráficos mostrando evolução do patrimônio e data estimada de independência.' *** import { Authors, Author } from '~/components/Authors'; > **Descubra o poder da estratégia FIRE mais testada do mundo!** Aprenda como a regra dos 4% pode funcionar perfeitamente no mercado brasileiro de 2025. Nossa Calculadora FIRE Tradicional oferece gráficos interativos e projeções ultrarrealistas para sua jornada rumo à independência financeira. ## 🎯 O que é o FIRE Tradicional? O FIRE Tradicional é baseado na lendária **"regra dos 4%"**, estabelecida pelo famoso Trinity Study. Esta estratégia, testada por décadas nos mercados globais, determina que você precisa acumular **25 vezes suas despesas anuais** para se aposentar com segurança máxima, sacando apenas 4% do patrimônio por ano. ### 🧮 Por que exatamente 25x suas despesas? A matemática é elegante e simples: **📊 Exemplo prático:** * **Gastos mensais:** R$ 8.000 * **Gastos anuais:** R$ 96.000 * **Meta FIRE:** 25 × R$ 96.000 = **R$ 2.400.000** * **Renda passiva anual:** 4% de R$ 2.400.000 = **R$ 96.000** * **Renda passiva mensal:** R$ 8.000 ✅ **🔥 O resultado:** Você mantém exatamente o mesmo padrão de vida... **para sempre!** ## Como Funciona Nossa Calculadora FIRE Tradicional Nossa [Calculadora FIRE Tradicional](/calculadoras/fire-tradicional) oferece recursos únicos: ### 🎯 Gráficos Interativos em Tempo Real * **Linha azul**: Evolução do seu patrimônio * **Linha verde tracejada**: Meta FIRE (25x despesas) * **Atualização automática**: Modifique parâmetros e veja mudanças instantâneas * **Datas reais**: Visualize quando atingirá marcos específicos ### 📊 Cálculos Precisos para o Brasil A calculadora considera: * **Formatação em reais**: Todos os valores em R$ * **Inflação brasileira**: Rentabilidade real acima da inflação * **Tributação local**: Considera o imposto de renda sobre investimentos ### 💡 Tooltips Informativos Passe o mouse sobre qualquer ponto do gráfico para ver: * Valor exato do patrimônio * Data específica * Progresso em relação à meta * Indicadores coloridos para maior clareza ## Adaptando a Regra dos 4% ao Brasil ### Desafios Únicos do Mercado Brasileiro **1. Inflação Histórica** * Brasil teve inflação média de 8,4% nas últimas décadas * Necessidade de investimentos que superem a inflação consistentemente * Foco em ativos reais (ações, FIIs, títulos indexados à inflação) **2. Volatilidade do Mercado** * Maior volatilidade requer margem de segurança adicional * Diversificação entre classes de ativos é essencial * Consideração de exposição internacional para proteção cambial **3. Sistema Tributário Complexo** * Diferentes alíquotas para cada tipo de investimento * Benefícios fiscais da previdência privada * Estratégias de buy and hold para reduzir tributação ### Estratégias Adaptadas para o FIRE Tradicional Brasileiro **Portfolio Sugerido:** * **40%** Ações brasileiras (foco em dividendos) * **20%** Fundos imobiliários * **15%** Títulos do Tesouro IPCA+ * **15%** ETFs internacionais * **10%** Renda fixa privada **Rentabilidade Alvo:** * **Conservador**: 10-12% ao ano (real) * **Moderado**: 12-15% ao ano (real) * **Arrojado**: 15-18% ao ano (real) ## Como Usar a Calculadora: Passo a Passo ### Passo 1: Defina seus Gastos Mensais Inclua **todos** os gastos essenciais: * Moradia (aluguel/financiamento, condomínio, IPTU) * Alimentação * Transporte * Saúde e seguros * Educação * Lazer moderado **Dica importante:** Seja realista. Subestimar gastos é o erro mais comum no planejamento FIRE. ### Passo 2: Insira seu Patrimônio Atual Considere: * Investimentos atuais * Dinheiro em conta corrente/poupança * **Não inclua:** Imóvel próprio (a menos que gere renda) ### Passo 3: Determine seu Aporte Mensal Calculate baseado em: * Renda líquida atual * Gastos já definidos * Meta de economia (recomendado: mínimo 20% da renda) ### Passo 4: Escolha a Rentabilidade Esperada Para o Brasil, recomendamos: * **Iniciantes**: 10% ao ano * **Experientes**: 12% ao ano * **Avançados**: 15% ao ano ## Exemplos Práticos de FIRE Tradicional ### Caso 1: Profissional Jovem (25 anos) **Perfil:** * Gastos: R$ 5.000/mês * Patrimônio atual: R$ 50.000 * Aporte mensal: R$ 3.000 * Rentabilidade: 12% ao ano **Resultado:** * Meta FIRE: R$ 1.500.000 * Tempo para FIRE: **14,2 anos** * Idade ao atingir FIRE: **39 anos** ### Caso 2: Casal Estabelecido (35 anos) **Perfil:** * Gastos: R$ 12.000/mês * Patrimônio atual: R$ 300.000 * Aporte mensal: R$ 6.000 * Rentabilidade: 11% ao ano **Resultado:** * Meta FIRE: R$ 3.600.000 * Tempo para FIRE: **16,8 anos** * Idade ao atingir FIRE: **52 anos** ### Caso 3: Executivo Sênior (45 anos) **Perfil:** * Gastos: R$ 20.000/mês * Patrimônio atual: R$ 800.000 * Aporte mensal: R$ 15.000 * Rentabilidade: 10% ao ano **Resultado:** * Meta FIRE: R$ 6.000.000 * Tempo para FIRE: **13,5 anos** * Idade ao atingir FIRE: **58 anos** ## Estratégias para Acelerar seu FIRE Tradicional ### 1. Otimização de Gastos **Técnicas comprovadas:** * **Auditoria mensal**: Revise todos os gastos mensalmente * **Regra 50/30/20**: 50% necessidades, 30% desejos, 20% investimentos * **Compras conscientes**: Espere 24h antes de compras não essenciais ### 2. Aumento de Renda **Opções práticas:** * **Renda extra**: Freelances, consultorias, vendas online * **Investimento em educação**: Cursos que aumentem seu valor de mercado * **Progressão na carreira**: Foque em promoções e mudanças estratégicas ### 3. Otimização de Investimentos **Estratégias avançadas:** * **Rebalanceamento regular**: Mantenha alocação desejada * **Dollar cost averaging**: Invista valor fixo mensalmente * **Tax loss harvesting**: Use prejuízos para compensar ganhos ## Riscos e Como Mitigá-los ### Principais Riscos do FIRE Tradicional **1. Sequência de Retornos** * **Problema**: Perdas no início da aposentadoria são devastadoras * **Solução**: Mantenha 2-3 anos de gastos em renda fixa **2. Inflação Acelerada** * **Problema**: Erosão do poder de compra * **Solução**: Portfolio com proteção inflacionária (IPCA+, ações) **3. Gastos Inesperados** * **Problema**: Emergências médicas, familiares * **Solução**: Reserva de emergência adicional de 6-12 meses ### Estratégias de Mitigação Específicas para o Brasil **1. Diversificação Geográfica** * 10-20% em ETFs internacionais * Proteção contra instabilidade política/econômica local **2. Múltiplas Fontes de Renda** * Dividendos de ações * Aluguéis de FIIs * Títulos públicos * Renda variável internacional **3. Flexibilidade nos Gastos** * Identifique gastos "compressíveis" * Tenha plano B para cortes temporários * Considere mudança para cidades mais baratas ## Monitoramento e Ajustes ### Indicadores-Chave para Acompanhar **1. Taxa de Economia** * Meta: >50% da renda * Acompanhamento: Mensal **2. Progresso em Direção à Meta** * Meta: Patrimônio crescendo conforme projeção * Acompanhamento: Trimestral **3. Rentabilidade Real** * Meta: Acima da inflação + 6% ao ano * Acompanhamento: Anual ### Quando Fazer Ajustes **Revise sua estratégia se:** * Rentabilidade consistentemente abaixo do esperado (>2 anos) * Mudanças significativas na vida (casamento, filhos, doença) * Alterações no mercado financeiro brasileiro * Mudanças na legislação tributária ## Ferramentas Complementares ### Use Junto com a Calculadora FIRE Tradicional **1. [Calculadora de Dividendos](/calculadoras/simulador-de-rentabilidade-e-dividendos)** * Simule renda passiva mensal * Compare diferentes tipos de ativos **2. [Calculadora Coast FIRE](/calculadoras/coast-fire)** * Veja quando pode parar de aportar * Planeje transições graduais **3. [Calculadora Lean FIRE](/calculadoras/lean-fire)** * Compare com estratégia mais agressiva * Identifique possibilidade de meta antecipada ## Perguntas Frequentes sobre FIRE Tradicional ### 1. A regra dos 4% funciona no Brasil? **Resposta:** Sim, mas com adaptações. O estudo original foi baseado no mercado americano, mas a lógica é válida. No Brasil, recomendamos ser mais conservador devido à maior volatilidade e considerar uma taxa de 3,5% inicialmente. ### 2. Devo incluir a casa própria no cálculo FIRE? **Resposta:** Apenas se ela gerar renda (aluguel). A casa própria reduz seus gastos mensais, mas não gera renda passiva. Inclua no cálculo de gastos a redução do aluguel, mas não como ativo no patrimônio FIRE. ### 3. Como considerar a previdência privada no FIRE Tradicional? **Resposta:** A previdência privada pode complementar seu FIRE, especialmente pelo benefício fiscal. Considere como parte da alocação em renda fixa do seu portfolio, mas lembre-se das limitações de liquidez. ### 4. E se eu não conseguir manter os aportes? **Resposta:** Use nossa calculadora para simular diferentes cenários de aportes. Mesmo com reduções temporárias, o importante é manter a consistência a longo prazo. O crescimento composto ainda funcionará. ### 5. Quando devo considerar mudar para Fat FIRE ou Lean FIRE? **Resposta:** Se seus gastos aumentarem significativamente (filhos, estilo de vida), considere [Fat FIRE](/calculadoras/fat-fire). Se conseguir reduzir gastos drasticamente, [Lean FIRE](/calculadoras/lean-fire) pode acelerar sua independência. ### 6. Como lidar com crises econômicas durante a acumulação? **Resposta:** Crises são oportunidades para acelerar o FIRE. Mantenha os aportes, aproveite preços baixos para comprar mais. Nossa calculadora assume volatilidade nas projeções de longo prazo. ## Conclusão: Seu Primeiro Passo para a Independência Financeira O FIRE Tradicional representa a estratégia mais testada e confiável para alcançar a independência financeira. Com nossa [Calculadora FIRE Tradicional](/calculadoras/fire-tradicional), você tem acesso a: **✅ Projeções precisas** adaptadas ao mercado brasileiro **✅ Gráficos interativos** que se atualizam em tempo real **✅ Cenários realistas** considerando inflação e tributação local **Próximos passos:** 1. **[Acesse a calculadora](/calculadoras/fire-tradicional)** e insira seus dados 2. **Experimente diferentes cenários** modificando aportes e rentabilidade 3. **Compare com outras estratégias** usando nossas outras calculadoras FIRE 4. **Comece a investir** baseado no plano desenvolvido Lembre-se: o FIRE Tradicional não é uma corrida, é uma maratona. Consistência e disciplina são mais importantes que perfeição. Comece hoje mesmo e deixe o tempo e os juros compostos trabalharem a seu favor! **[🎯 Calcule seu FIRE Tradicional agora →](/calculadoras/fire-tradicional)** # Calculadora LCA x CDB: Equivalência Líquida em 2026 URL: /blog/calculadora-lca-equivalencia-cdb.mdx Use a calculadora LCA para comparar uma LCA isenta de IR com CDB tributado. Veja fórmula, tabela de equivalência e quando a LCA vale mais que o CDB. *** searchable: true title: 'Calculadora LCA x CDB: Equivalência Líquida em 2026' description: 'Use a calculadora LCA para comparar uma LCA isenta de IR com CDB tributado. Veja fórmula, tabela de equivalência e quando a LCA vale mais que o CDB.' date: '2026-01-07' keywords: 'calculadora lca, lca x cdb, lca cdb equivalência, LCA isenta de IR, rentabilidade LCA, CDB equivalente, calculadora renda fixa' author: 'Equipe brapi.dev' category: 'Renda Fixa' subcategory: 'Calculadora LCA' readingTime: '7 min' tags: \['LCA', 'Calculadora', 'CDB', 'Renda Fixa', 'Agronegócio', 'Investimentos', 'IR'] relatedPosts: \['cdb-vs-lci-qual-rende-mais-calculadora', 'lci-lca-guia-completo-investimentos-isentos-ir-2026', 'calculadora-dividendos-renda-passiva-brasil'] featured: false expertise: 'Especialistas em renda fixa brasileira com foco em investimentos isentos de imposto de renda' lastReviewed: '2026-04-23' howToTools: \['Calculadora LCI LCA vs CDB brapi.dev', 'Tabela de IR regressivo', 'Simulador de rentabilidade'] howToSteps: * name: 'Acesse a calculadora' text: 'Entre em brapi.dev/calculadoras/equivalencia-lci-lca-cdb.' * name: 'Informe a taxa da LCA' text: 'Digite a taxa oferecida, como 90% do CDI ou 11% ao ano.' * name: 'Escolha o prazo' text: 'O prazo define a alíquota de IR do CDB usado na comparação.' * name: 'Compare o CDB equivalente' text: 'Veja qual taxa bruta de CDB iguala a rentabilidade líquida da LCA.' faqSchema: * question: 'Como calcular LCA equivalente a CDB?' answer: 'Divida a taxa da LCA por 1 menos a alíquota de IR do CDB. Uma LCA de 90% do CDI por mais de 720 dias equivale a um CDB de 105,9% do CDI, pois o CDB paga 15% de IR.' * question: 'LCA é isenta de imposto de renda?' answer: 'Sim. Para pessoa física, a remuneração de LCA é isenta de IR. Já CDBs seguem a tabela regressiva de renda fixa.' * question: 'LCA tem FGC?' answer: 'Sim. LCAs estão entre os produtos cobertos pelo FGC, com limite de R$ 250 mil por CPF ou CNPJ por instituição ou conglomerado, observado o teto global de R$ 1 milhão a cada quatro anos.' *** import { Authors, Author } from '~/components/Authors'; > Use a [Calculadora LCA x CDB](/calculadoras/equivalencia-lci-lca-cdb) para comparar taxas líquidas sem fazer conta manual. A pergunta certa não é "quanto a LCA paga?", mas "quanto um CDB teria que pagar para empatar com essa LCA depois do IR?". ## Resposta Rápida Uma **LCA de 90% do CDI** equivale a um **CDB entre 105,9% e 116,1% do CDI**, dependendo do prazo. Quanto menor o prazo, maior é o IR do CDB e mais forte fica a vantagem da LCA. | Prazo do CDB | IR do CDB | LCA 90% CDI equivale a CDB de | | ----------------- | --------- | ----------------------------- | | Até 180 dias | 22,5% | 116,1% do CDI | | 181 a 360 dias | 20,0% | 112,5% do CDI | | 361 a 720 dias | 17,5% | 109,1% do CDI | | Acima de 720 dias | 15,0% | 105,9% do CDI | ## O Que a Calculadora LCA Faz A [calculadora](/calculadoras/equivalencia-lci-lca-cdb) transforma uma taxa isenta de IR em uma taxa bruta equivalente. Isso evita uma comparação injusta entre LCA e CDB. Uma LCA que paga 90% do CDI entrega 90% líquido para pessoa física. Um CDB de 100% do CDI não entrega 100% líquido, porque sofre imposto de renda pela tabela regressiva. Em prazos curtos, a diferença é grande. ## Fórmula de Equivalência ```text CDB equivalente = Taxa da LCA / (1 - alíquota de IR) ``` Exemplo: LCA de 92% do CDI por 180 dias. ```text CDB equivalente = 92% / (1 - 0,225) CDB equivalente = 118,7% do CDI ``` Ou seja, um CDB precisaria pagar cerca de **118,7% do CDI** para empatar com essa LCA no mesmo prazo. ## LCA, LCI e CDB: Diferença Prática | Produto | Lastro | IR para pessoa física | FGC | Liquidez comum | | ------- | ---------------- | --------------------- | --- | ------------------------------ | | LCA | Agronegócio | Isento | Sim | No vencimento ou após carência | | LCI | Imobiliário | Isento | Sim | No vencimento ou após carência | | CDB | Crédito bancário | 15% a 22,5% | Sim | Diária ou no vencimento | Para o investidor pessoa física, LCI e LCA funcionam de forma muito parecida. A diferença relevante costuma ser taxa, prazo, emissor e liquidez. ## Quando a LCA Vale Mais a Pena A LCA tende a ganhar quando oferece taxa competitiva e você pode deixar o dinheiro aplicado até o vencimento. Em prazos de até dois anos, a isenção de IR pesa bastante, então uma LCA de 85% a 95% do CDI pode superar CDBs aparentemente mais altos. O CDB pode ser melhor quando paga um prêmio grande, tem liquidez diária ou vem de um emissor que você prefere. Por isso a comparação deve sempre ser líquida e no mesmo prazo. ## Atenção ao FGC e ao Emissor LCAs têm cobertura do FGC, assim como CDBs e LCIs. O limite ordinário é de **R$ 250 mil por CPF ou CNPJ por instituição ou conglomerado financeiro**, com teto global de **R$ 1 milhão a cada quatro anos**. Isso não elimina o risco de liquidez: em caso de problema no emissor, pode haver prazo até o pagamento da garantia. Não concentre todo o patrimônio em uma única instituição apenas porque a taxa parece boa. ## Como Usar na Prática Antes de investir, compare três pontos: taxa líquida, prazo e liquidez. Se a LCA vence em 24 meses, compare com um CDB de prazo semelhante. Se você pode precisar do dinheiro antes, um CDB com liquidez diária pode ser melhor mesmo rendendo menos. Para objetivos de curto prazo, preserve liquidez. Para objetivos com data definida, como compra de imóvel ou reserva para impostos, casamentos e viagens, combine vencimentos com a necessidade de caixa. ## Fontes Revisadas [Tabela regressiva de renda fixa da Receita Federal](https://www.gov.br/receitafederal/pt-br/assuntos/meu-imposto-de-renda/tabelas/2025) · [Garantia FGC](https://www.fgc.org.br/sobre-garantia-fgc) ## Conclusão A LCA não é automaticamente melhor que o CDB. Ela é melhor quando sua taxa líquida, prazo, risco e liquidez fazem sentido para o seu objetivo. Use a [Calculadora LCA x CDB](/calculadoras/equivalencia-lci-lca-cdb), compare em termos líquidos e evite decidir olhando apenas a taxa bruta. # Calculadora Lean FIRE 2025: Independência Financeira Minimalista no Brasil URL: /blog/calculadora-lean-fire-independencia-financeira-minimalista-brasil.mdx Aprenda como alcançar FIRE mais rápido com a Calculadora Lean FIRE 2025. Estratégia minimalista adaptada ao Brasil com gráficos interativos e metas acessíveis. *** searchable: true title: 'Calculadora Lean FIRE 2025: Independência Financeira Minimalista no Brasil' description: 'Aprenda como alcançar FIRE mais rápido com a Calculadora Lean FIRE 2025. Estratégia minimalista adaptada ao Brasil com gráficos interativos e metas acessíveis.' date: '2025-08-22' keywords: 'Lean FIRE Brasil 2025, minimalismo financeiro, independência financeira rápida, aposentadoria precoce acessível, calculadora FIRE gratuita, estratégia minimalista' author: 'Equipe brapi.dev' category: 'Independência Financeira' subcategory: 'Lean FIRE' readingTime: '11 min' tags: \['Lean FIRE', 'Minimalismo', 'Independência Financeira', 'Calculadora', 'Aposentadoria Rápida', 'Planejamento Financeiro', 'Brasil', 'Economia'] relatedPosts: \['calculadora-fire-tradicional-regra-4-porcento-brasil', 'calculadora-fat-fire-independencia-financeira-alto-padrao-brasil', 'calculadoras-fire-independencia-financeira-brasil'] featured: true expertise: 'Especialistas em estratégias FIRE minimalistas com foco em eficiência e aceleração da independência financeira' lastReviewed: '2025-08-22' howToTools: \['Calculadora Lean FIRE brapi.dev', 'Lista de despesas essenciais', 'Orçamento minimalista'] howToSteps: * name: 'Identifique despesas essenciais' text: 'Liste apenas os gastos indispensáveis para sua qualidade de vida básica.' * name: 'Aplique a regra dos 20x' text: 'Multiplique suas despesas anuais essenciais por 20 para calcular a meta Lean FIRE.' * name: 'Acesse a Calculadora Lean FIRE' text: 'Use a calculadora em brapi.dev para simular sua trajetória acelerada até FIRE.' * name: 'Compare com FIRE Tradicional' text: 'Veja quanto tempo você economiza optando pelo Lean FIRE (meta 20% menor).' * name: 'Planeje a transição' text: 'Defina estratégias para manter o estilo de vida minimalista após atingir a meta.' *** import { Authors, Author } from '~/components/Authors'; > **Acelere sua liberdade financeira com menos!** Descubra como o Lean FIRE pode revolucionar sua independência financeira no Brasil de 2025. Com foco em minimalismo inteligente e máxima eficiência, esta estratégia oferece o caminho mais rápido e acessível para a liberdade financeira. ## 🚀 O que é Lean FIRE? Lean FIRE é a **abordagem turbo** do movimento FIRE, focada em atingir a independência financeira com uma meta menor de patrimônio através da redução inteligente de gastos e adoção de um estilo de vida minimalista eficiente. Em vez da regra tradicional dos 4% (25x despesas), o Lean FIRE usa **5% (20x despesas)**, permitindo metas 20% mais acessíveis. ### ⚡ Lean FIRE vs FIRE Tradicional - A Comparação Definitiva | 🎯 **Aspecto** | **FIRE Tradicional** | **Lean FIRE** | | ---------------------- | -------------------- | --------------------------------- | | **Taxa de retirada** | 4% ao ano | **5% ao ano** | | **Multiplicador** | 25x despesas | **20x despesas** | | **Foco principal** | Manter padrão atual | **Otimizar gastos drasticamente** | | **Meta patrimonial** | Maior | **20% menor** | | **Tempo para atingir** | Mais longo | **2-5 anos mais rápido** | | **Flexibilidade** | Moderada | **Alta (minimalismo)** | ### Por que Lean FIRE faz Sentido no Brasil? **1. Custo de Vida Flexível** * Grandes diferenças regionais permitem arbitragem geográfica * Possibilidade de viver bem com menos em muitas cidades brasileiras * Cultura de simplicidade já presente em muitas regiões **2. Oportunidades de Redução de Gastos** * Transporte público eficiente em várias cidades * Alimentação diversificada e acessível * Opções de lazer gratuitas abundantes **3. Mercado Imobiliário Diverso** * Possibilidade de morar em regiões mais baratas * Aluguel como alternativa à compra * Flexibilidade para mudanças conforme oportunidades ## Como Funciona Nossa Calculadora Lean FIRE Nossa [Calculadora Lean FIRE](/calculadoras/lean-fire) oferece recursos específicos para esta estratégia: ### 🎯 Visualização da Meta Reduzida * **Multiplicador 20x**: Automaticamente calcula 20 vezes suas despesas anuais * **Gráfico comparativo**: Veja a diferença em relação ao FIRE tradicional * **Economia de tempo**: Visualize quantos anos você pode economizar ### 📊 Foco em Eficiência A calculadora destaca: * **Taxa de economia alta**: Incentiva aportes agressivos * **Gastos otimizados**: Ferramentas para análise de redução de gastos * **Cenários flexíveis**: Simule diferentes níveis de minimalismo ### 💡 Dicas de Minimalismo Financeiro Interface inclui: * Sugestões de redução de gastos específicas para o Brasil * Comparação de custos entre regiões * Estratégias de otimização de estilo de vida ## Estratégias Lean FIRE Adaptadas ao Brasil ### 1. Redução Inteligente de Gastos **Moradia (40-50% dos gastos típicos)** * **Aluguel**: Prefira bairros em desenvolvimento ou cidades menores * **Compartilhamento**: Considere repúblicas ou co-living * **Localização estratégica**: Priorize proximidade ao trabalho/transporte público **Transporte (10-15% dos gastos)** * **Transporte público**: Maximize uso de metrô, ônibus, bicicleta * **Carsharing**: Use apenas quando necessário * **Trabalho remoto**: Negocie home office para reduzir custos **Alimentação (15-20% dos gastos)** * **Cozinhar em casa**: Redução de 60-70% vs restaurantes * **Compras inteligentes**: Atacadão, feiras livres, sazonalidade * **Horta urbana**: Cultivo de temperos e vegetais básicos ### 2. Arbitragem Geográfica Brasileira **Cidades com Melhor Custo-Benefício:** **Região Nordeste:** * Fortaleza: Custo 40% menor que SP, boa infraestrutura * Recife: Vida cultural rica, custos moderados * Salvador: Clima favorável, custos baixos **Região Sul:** * Florianópolis: Qualidade de vida alta, custos moderados * Curitiba: Transporte público excelente, cultura europeia * Porto Alegre: Vida cultural intensa, custos acessíveis **Interior de São Paulo:** * Campinas: Proximidade a SP, custos 30% menores * São Carlos: Cidade universitária, infraestrutura boa * Ribeirão Preto: Economia forte, custo de vida baixo ### 3. Portfolio Lean FIRE Brasileiro **Alocação Sugerida:** * **50%** Fundos Imobiliários (renda mensal estável) * **30%** Ações com foco em dividendos * **15%** Títulos do Tesouro IPCA+ * **5%** Reserva de emergência **Foco em Renda Passiva:** * Priorizar ativos que geram renda mensal * Dividendos previsíveis para planejamento * Baixa necessidade de venda de ativos ## Exemplos Práticos de Lean FIRE no Brasil ### Caso 1: Jovem Profissional Minimalista (28 anos) **Perfil:** * Gastos atuais: R$ 8.000/mês → **Reduzidos para R$ 4.000/mês** * Patrimônio atual: R$ 80.000 * Aporte mensal: R$ 4.500 (aumento devido à redução de gastos) * Rentabilidade: 12% ao ano **Meta Lean FIRE:** R$ 960.000 (20 × R$ 48.000 anuais) **Resultado:** * Tempo para FIRE: **10,2 anos** * Idade ao atingir FIRE: **38 anos** * **5 anos mais rápido** que FIRE tradicional **Principais mudanças:** * Mudança para apartamento menor e melhor localizado * Venda do carro, uso de transporte público * Redução de gastos supérfluos (assinaturas, delivery, roupas) ### Caso 2: Casal Consciente (32 anos) **Perfil:** * Gastos atuais: R$ 15.000/mês → **Reduzidos para R$ 8.000/mês** * Patrimônio atual: R$ 200.000 * Aporte mensal: R$ 8.000 * Rentabilidade: 11% ao ano **Meta Lean FIRE:** R$ 1.920.000 **Resultado:** * Tempo para FIRE: **12,8 anos** * Idade ao atingir FIRE: **45 anos** * **Economia mensal de R$ 7.000** reinvestida **Estratégias adotadas:** * Mudança para cidade do interior com home office * Horta urbana e compostagem * Minimalismo consciente em compras ### Caso 3: Executivo em Transição (40 anos) **Perfil:** * Gastos atuais: R$ 25.000/mês → **Reduzidos para R$ 12.000/mês** * Patrimônio atual: R$ 600.000 * Aporte mensal: R$ 18.000 * Rentabilidade: 10% ao ano **Meta Lean FIRE:** R$ 2.880.000 **Resultado:** * Tempo para FIRE: **8,5 anos** * Idade ao atingir FIRE: **48 anos** * **Rápida transição** para independência ## Guia Prático: Implementando Lean FIRE ### Fase 1: Auditoria Completa de Gastos (Mês 1-2) **Ferramentas necessárias:** * App de controle financeiro (Mobills, GuiaBolso, planilha própria) * Extratos dos últimos 6 meses * Categorização detalhada de todos os gastos **Processo:** 1. **Mapeamento total**: Anote TODOS os gastos por 2 meses 2. **Categorização**: Separe em essencial, importante, supérfluo 3. **Análise de padrões**: Identifique gastos inconscientes 4. **Benchmark**: Compare com médias brasileiras ### Fase 2: Redução Estratégica (Mês 3-6) **Metodologia dos Cortes Graduais:** **Mês 3: Cortes Fáceis (10-15% de redução)** * Cancelamento de assinaturas não utilizadas * Redução de delivery e restaurantes * Otimização de planos (celular, internet, TV) **Mês 4: Cortes Moderados (20-25% de redução)** * Renegociação de contratos (academia, seguros) * Mudança de hábitos de consumo * Implementação de alternativas gratuitas/baratas **Mês 5-6: Mudanças Estruturais (30-40% de redução)** * Avaliação de mudança de moradia * Reestruturação de transporte * Adoção completa do estilo de vida minimalista ### Fase 3: Otimização e Sustentabilidade (Mês 7+) **Manutenção dos Cortes:** * **Revisão mensal**: Ajustes baseados em experiência * **Automatização**: Sistemas que impedem gastos supérfluos * **Comunidade**: Conecte-se com outros praticantes de Lean FIRE **Reinvestimento das Economias:** * **Aporte automático**: Configure transferências automáticas * **Diversificação gradual**: Construa portfolio focado em renda * **Educação financeira**: Continue aprendendo sobre investimentos ## Desafios Específicos do Lean FIRE no Brasil ### 1. Pressão Social **Problema:** Cultura brasileira de ostentação e gastos sociais altos **Soluções:** * **Educação do círculo social**: Explique seus objetivos * **Alternativas criativas**: Proponha programas baratos/gratuitos * **Comunidade FIRE**: Conecte-se com pessoas com objetivos similares ### 2. Inflação e Erosão do Poder de Compra **Problema:** Inflação pode tornar 5% insuficiente ao longo do tempo **Soluções:** * **Portfolio proteção inflacionária**: IPCA+, ações, FIIs * **Revisão anual**: Ajuste metas conforme inflação * **Flexibilidade geográfica**: Mude para locais mais baratos se necessário ### 3. Gastos de Saúde Inesperados **Problema:** Sistema de saúde brasileiro pode gerar custos altos **Soluções:** * **Plano de saúde básico**: Mantenha cobertura mínima * **Reserva médica**: 12-18 meses de gastos extras para saúde * **Prevenção**: Invista em saúde preventiva e estilo de vida saudável ### 4. Limitações de Renda **Problema:** Lean FIRE pode limitar renda e oportunidades futuras **Soluções:** * **Barista FIRE como transição**: Trabalho parcial + renda passiva * **Renda passiva escalável**: Invista em ativos que crescem com inflação * **Flexibilidade para retorno**: Mantenha habilidades profissionais atualizadas ## Ferramentas e Recursos para Lean FIRE ### Calculadoras Complementares **1. [Calculadora de Dividendos](/calculadoras/simulador-de-rentabilidade-e-dividendos)** * Simule renda mensal de FIIs e ações * Essencial para planejar fluxo de caixa no Lean FIRE **2. [Calculadora Coast FIRE](/calculadoras/coast-fire)** * Veja quando pode reduzir aportes * Planeje transição para Lean FIRE **3. [Calculadora Geographic Arbitrage](/calculadoras/geographic-arbitrage-fire)** * Compare custos entre cidades brasileiras * Otimize localização para Lean FIRE ### Apps e Ferramentas Recomendadas **Controle de Gastos:** * Mobills (brasileiro, categorização automática) * GuiaBolso (integração bancária) * Minhas Economias (planejamento de metas) **Investimentos:** * Rico (corretora completa) * XP Investimentos (research de qualidade) * Suno Research (análise de FIIs e ações) **Estilo de Vida:** * Too Good To Go (combate desperdício alimentar) * Bike Sampa (transporte sustentável) * Freecycle (troca de itens gratuitos) ## Monitoramento e Métricas Lean FIRE ### KPIs Essenciais **1. Taxa de Economia** * **Meta Lean FIRE**: >60% da renda líquida * **Cálculo**: (Renda - Gastos) / Renda * **Frequência**: Mensal **2. Progresso para Meta** * **Cálculo**: Patrimônio Atual / Meta Lean FIRE * **Marcos**: 25%, 50%, 75%, 90%, 100% * **Frequência**: Trimestral **3. Renda Passiva vs Gastos** * **Meta final**: Renda passiva ≥ 105% dos gastos * **Cálculo**: Dividendos + Juros / Gastos Mensais * **Frequência**: Mensal ### Sinais de Alerta **Revise sua estratégia se:** * Taxa de economia \< 50% por 3 meses consecutivos * Gastos crescendo acima da inflação consistentemente * Patrimônio não crescendo conforme projeção * Qualidade de vida impactada negativamente ## Perguntas Frequentes sobre Lean FIRE ### 1. Lean FIRE é muito restritivo para o brasileiro médio? **Resposta:** Não necessariamente. O Lean FIRE se adapta ao seu contexto atual. Se você gasta R$ 8.000/mês, pode reduzir para R$ 5.000-6.000 mantendo qualidade de vida. A chave é eficiência, não privação extrema. ### 2. Como lidar com gastos sazonais (férias, presentes)? **Resposta:** Inclua estes gastos na média anual. Se gasta R$ 6.000 em férias + R$ 2.400 em presentes por ano, adicione R$ 700/mês aos seus gastos básicos no planejamento Lean FIRE. ### 3. E se eu quiser ter filhos durante o Lean FIRE? **Resposta:** Filhos aumentam gastos significativamente. Considere transição para [FIRE Tradicional](/calculadoras/fire-tradicional) ou [Coast FIRE](/calculadoras/coast-fire) quando planejar família. ### 4. Posso fazer Lean FIRE morando em São Paulo? **Resposta:** É possível, mas desafiador. Considere bairros periféricos bem conectados, apartamentos menores, transporte público. Alternativamente, trabalho remoto permite mudança para cidades mais baratas. ### 5. Qual a diferença prática entre 4% e 5% de retirada? **Resposta:** Para R$ 6.000/mês de gastos: FIRE tradicional = R$ 1.800.000, Lean FIRE = R$ 1.440.000. Diferença de R$ 360.000 pode representar 3-5 anos a menos de acumulação. ### 6. Como saber se o Lean FIRE é para mim? **Resposta:** Experimente viver com 20% menos gastos por 3-6 meses. Se conseguir manter qualidade de vida satisfatória, o Lean FIRE pode ser adequado para você. ## Conclusão: Acelere sua Independência com Lean FIRE O Lean FIRE oferece um caminho mais rápido e acessível para a independência financeira no Brasil. Com nossa [Calculadora Lean FIRE](/calculadoras/lean-fire), você pode: **✅ Visualizar metas menores** e mais alcançáveis **✅ Simular cenários de redução** de gastos **✅ Comparar tempo ganho** vs FIRE tradicional **✅ Planejar transições** para estilo de vida minimalista **Vantagens do Lean FIRE:** * **Tempo reduzido**: 3-7 anos mais rápido que FIRE tradicional * **Meta menor**: 20% menos patrimônio necessário * **Flexibilidade**: Possibilidade de upgrades futuros * **Aprendizado**: Desenvolve disciplina financeira extrema **Ideal para:** * Jovens profissionais com gastos flexíveis * Pessoas que valorizam experiências sobre bens materiais * Quem quer acelerar a independência financeira * Moradores de regiões com custo de vida alto Lembre-se: Lean FIRE não é sobre privação, é sobre **eficiência máxima**. Cada real economizado é um passo mais próximo da sua liberdade financeira. **[🎯 Calcule seu Lean FIRE agora →](/calculadoras/lean-fire)** Comece hoje mesmo a otimizar seus gastos e acelere sua jornada rumo à independência financeira! # Calculadoras FIRE 2025: Guia Definitivo para Independência Financeira no Brasil URL: /blog/calculadoras-fire-independencia-financeira-brasil.mdx 6 calculadoras FIRE gratuitas para aposentadoria precoce. Traditional, Lean, Fat, Coast, Barista e Geographic FIRE ✓ *** searchable: true title: 'Calculadoras FIRE 2025: Guia Definitivo para Independência Financeira no Brasil' description: '6 calculadoras FIRE gratuitas para aposentadoria precoce. Traditional, Lean, Fat, Coast, Barista e Geographic FIRE ✓' date: '2025-08-22' keywords: 'FIRE Brasil 2025, independência financeira, calculadora FIRE gratuita, aposentadoria precoce, planejamento financeiro, investimentos Brasil, gráficos interativos' author: 'Equipe brapi.dev' category: 'Independência Financeira' subcategory: 'Guia Completo FIRE' readingTime: '18 min' tags: \['FIRE', 'Calculadoras', 'Independência Financeira', 'Aposentadoria Precoce', 'Planejamento Financeiro', 'Brasil', 'Guia Completo', 'Investimentos'] relatedPosts: \['calculadora-fire-tradicional-regra-4-porcento-brasil', 'calculadora-fat-fire-independencia-financeira-alto-padrao-brasil', 'calculadora-lean-fire-independencia-financeira-minimalista-brasil'] featured: true expertise: 'Guia completo criado por especialistas em independência financeira com experiência em todas as modalidades FIRE' lastReviewed: '2025-08-22' howToTools: \['Calculadoras FIRE brapi.dev', 'Planilha de orçamento', 'Extrato de investimentos'] howToSteps: * name: 'Entenda os tipos de FIRE' text: 'Conheça as diferenças entre Traditional FIRE (25x), Lean FIRE (20x) e Fat FIRE (25-50x despesas).' * name: 'Calcule suas despesas atuais' text: 'Faça um levantamento completo dos seus gastos mensais e anuais.' * name: 'Escolha sua estratégia FIRE' text: 'Selecione a modalidade que melhor se adapta ao seu estilo de vida e objetivos.' * name: 'Use a calculadora correspondente' text: 'Acesse a calculadora específica em brapi.dev e insira seus dados financeiros.' * name: 'Monte seu plano de ação' text: 'Defina aportes mensais, alocação de ativos e prazos baseados nas projeções.' *** import { Authors, Author } from '~/components/Authors'; > **Conquiste sua liberdade financeira em 2025!** Descubra como alcançar a independência financeira no Brasil com nossas 6 calculadoras FIRE gratuitas e interativas. Planeje sua aposentadoria precoce com estratégias testadas, adaptadas ao mercado brasileiro, e visualize sua jornada através de gráficos em tempo real. ## 🔥 O que é FIRE e por que é a revolução financeira de 2025? **FIRE** (Financial Independence, Retire Early) é o movimento que está transformando a vida financeira de milhares de brasileiros. Em 2025, com a evolução do mercado financeiro nacional e novas oportunidades de investimento, alcançar a independência financeira tornou-se mais acessível do que nunca. ### A realidade brasileira em 2025 e o movimento FIRE O Brasil de 2025 apresenta o cenário perfeito para estratégias FIRE: * **🏦 Mercado financeiro maduro**: Mais opções de investimento, menores taxas e maior democratização * **📱 Tecnologia financeira avançada**: Apps, plataformas e ferramentas que facilitam o planejamento * **💰 PIX e novos meios de pagamento**: Maior controle sobre gastos e economia digital * **🎓 Educação financeira popular**: Movimento FIRE ganhando força nas redes sociais e mídia ### Por que 2025 é o ano ideal para começar seu FIRE? **✅ Juros em patamar favorável para ações**\ **✅ Inflação controlada facilitando planejamento**\ **✅ Novas classes de ativos (criptos, REITs, ETFs)**\ **✅ Ferramentas gratuitas como nossas calculadoras** ## 🚀 Calculadoras FIRE da brapi: Ferramentas Revolucionárias para 2025 Nossa plataforma oferece **6 calculadoras FIRE gratuitas e especializadas**, cada uma desenvolvida para diferentes perfis e objetivos financeiros. Todas as calculadoras incluem tecnologia de ponta: ### 🎯 Recursos Exclusivos de 2025 * **📊 Gráficos interativos em tempo real** que se atualizam conforme você modifica os parâmetros * **🎯 Linha de meta FIRE** mostrando quando você atingirá a independência financeira * **💰 Formatação em reais brasileiros** para máxima precisão nos cálculos * **📅 Datas reais no eixo temporal** (ex: "ago. de 2026" ao invés de "10m") * **🔍 Tooltips avançados** com indicadores coloridos e informações detalhadas * **📱 Design responsivo** otimizado para mobile e desktop ### 📈 O poder da visualização em tempo real Diferente de calculadoras estáticas, nossas ferramentas permitem: * **Simulação instantânea** de cenários alternativos * **Comparação visual** entre estratégias * **Acompanhamento do progresso** ao longo do tempo * **Tomada de decisão baseada em dados** ### 1. 🎯 Calculadora FIRE Tradicional: A Base de Tudo A [Calculadora FIRE Tradicional](/calculadoras/fire-tradicional) é sua porta de entrada para o mundo FIRE, baseada na comprovada regra dos 4%. **🔢 Como funciona:** * Taxa de retirada: **4% ao ano** * Multiplicador: **25x suas despesas anuais** * Abordagem: **Conservadora e testada globalmente** * Ideal para: **Iniciantes no movimento FIRE** **💡 Exemplo prático 2025:** * Gastos mensais: R$ 8.000 * Meta FIRE: R$ 2.400.000 (25 × R$ 96.000 anuais) * Renda passiva: R$ 8.000/mês (4% de R$ 2.400.000) ### 2. ⚡ Calculadora Lean FIRE: Máxima Eficiência O [Lean FIRE](/calculadoras/lean-fire) é perfeito para quem abraça o minimalismo e quer acelerar a independência financeira. **🔢 Como funciona:** * Taxa de retirada: **5% ao ano** * Multiplicador: **20x suas despesas anuais** * Abordagem: **Minimalista e eficiente** * Ideal para: **Quem consegue viver com menos** **🏃‍♂️ Vantagem do Lean FIRE:** Meta 20% menor = chegada mais rápida à independência financeira ### 3. 💎 Calculadora Fat FIRE: Conforto Máximo Para quem não abre mão do alto padrão de vida, a [Calculadora Fat FIRE](/calculadoras/fat-fire) oferece flexibilidade total. **🔢 Como funciona:** * Multiplicador: **25x a 50x** (você escolhe) * Abordagem: **Flexível e personalizada** * Ideal para: **Altos padrões de vida** * Benefício: **Margem de segurança máxima** ### 4. 🌊 Calculadora Coast FIRE: Piloto Automático O [Coast FIRE](/calculadoras/coast-fire) mostra quando você pode "parar de aportar" e deixar os juros compostos fazerem o trabalho. **🔢 Como funciona:** * Calcula baseado na **idade de aposentadoria desejada** * Considera **crescimento natural** dos investimentos atuais * Ideal para: **Quem já tem uma base de investimentos** ### 5. ☕ Calculadora Barista FIRE: O Melhor dos Dois Mundos A [Calculadora Barista FIRE](/calculadoras/barista-fire) combina trabalho flexível com renda passiva para máxima qualidade de vida. **🔢 Como funciona:** * Combina **trabalho em meio período** com investimentos * Reduz pressão de acumular 100% via investimentos * Permite **transição gradual** para aposentadoria completa ### 6. 🌍 Calculadora Geographic Arbitrage FIRE: Aproveite as Diferenças A [Calculadora Geographic Arbitrage FIRE](/calculadoras/geographic-arbitrage-fire) explora as diferenças de custo de vida para acelerar seu FIRE. **🔢 Como funciona:** * Compara **mais de 20 destinos** brasileiros e internacionais * Aproveita **poder de compra** em locais mais baratos * Ideal para: **Nômades digitais** e **aposentados flexíveis** ## 💰 Calculadora de Dividendos: O Complemento Perfeito Nossa [Calculadora de Dividendos](/calculadoras/simulador-de-rentabilidade-e-dividendos) é o complemento essencial para suas estratégias FIRE: ### 🎯 Recursos exclusivos * **📊 Simulação de rentabilidade** com diferentes ativos * **🏢 Comparação entre** ações, FIIs e renda fixa * **📈 Análise de fluxo** de dividendos mensais * **📱 Gráficos interativos** com projeções de crescimento ### 💡 Por que usar junto com FIRE? * Planeje sua **renda passiva mensal** * Compare **diferentes estratégias** de investimento * Visualize o **poder dos dividendos** na construção de patrimônio ## 🎯 Como Usar as Calculadoras para Maximizar Resultados em 2025 ### Passo 1: Identifique seu Perfil FIRE **🤔 Faça o teste rápido:** * **Conservador?** → [Traditional FIRE](/calculadoras/fire-tradicional) ou [Lean FIRE](/calculadoras/lean-fire) * **Arrojado?** → [Fat FIRE](/calculadoras/fat-fire) ou [Geographic Arbitrage](/calculadoras/geographic-arbitrage-fire) * **Flexível?** → [Coast FIRE](/calculadoras/coast-fire) ou [Barista FIRE](/calculadoras/barista-fire) ### Passo 2: Domine os Gráficos Interativos **🎮 Recursos para explorar:** * **Modifique valores** e veja mudanças instantâneas * **Compare cenários** lado a lado * **Analise datas específicas** para marcos importantes * **Use tooltips** para dados precisos ### Passo 3: Crie Cenários Realistas **📋 Checklist essencial:** * ✅ Gastos mensais **realistas** (inclua tudo!) * ✅ Patrimônio atual **preciso** * ✅ Aportes mensais **sustentáveis** * ✅ Rentabilidade **conservadora** (10-15% para Brasil) ## 🚀 Estratégias Vencedoras para o Mercado Brasileiro 2025 ### 🛡️ Proteção contra Inflação (Estratégia Essencial) No Brasil, a proteção inflacionária é fundamental: **🎯 Portfolio Anti-Inflação 2025:** * **30%** Tesouro IPCA+ (proteção garantida) * **40%** Ações de empresas sólidas (crescimento real) * **20%** Fundos Imobiliários (renda corrigida) * **10%** ETFs internacionais (proteção cambial) ### 💰 Otimização Tributária Inteligente **🧠 Táticas comprovadas:** * **Previdência Privada:** Benefícios fiscais para complementar FIRE * **Buy and Hold:** Redução dramática da tributação * **Fundos de Investimento:** Vantagens do come-cotas ### 🌍 Diversificação Geográfica Estratégica **🎯 Alocação sugerida para 2025:** * **70%** Ativos brasileiros (mercado doméstico) * **20%** ETFs internacionais (exposição global) * **10%** Criptomoedas (diversificação adicional) ## 📊 Ferramentas Avançadas de Visualização ### 🎨 Gráficos de Progressão Patrimonial Nossas calculadoras apresentam visualização profissional: * **📈 Linha azul:** Evolução do patrimônio em tempo real * **🎯 Linha verde tracejada:** Meta FIRE personalizada * **💡 Tooltips informativos:** Valores exatos e datas específicas * **📱 Interface responsiva:** Perfeita em qualquer dispositivo ### 🔄 Análise de Cenários em Tempo Real **Veja o impacto instantâneo de:** * Mudanças na rentabilidade esperada * Aumentos ou reduções nos aportes * Diferentes níveis de gastos mensais * Alterações no patrimônio inicial ## 🎯 Guia Prático: Começando sua Jornada FIRE em 2025 ### Passo 1: 📊 Auditoria Financeira Completa **📋 Calcule seus gastos reais:** * 🏠 **Moradia:** Aluguel/financiamento, condomínio, IPTU * 🍽️ **Alimentação:** Supermercado, delivery, restaurantes * 🚗 **Transporte:** Combustível, transporte público, manutenção * 🏥 **Saúde:** Plano, medicamentos, consultas * 🎓 **Educação:** Cursos, livros, especializações * 🎉 **Lazer:** Entretenimento, viagens, hobbies **💡 Dica de ouro:** Use apps como Mobills ou GuiaBolso para rastrear gastos automaticamente. ### Passo 2: 🎯 Defina sua Rentabilidade Alvo 2025 **Para o mercado brasileiro atual:** * **🟢 Conservador:** 8-10% ao ano (Tesouro + renda fixa) * **🟡 Moderado:** 12-15% ao ano (misto RF + ações) * **🔴 Arrojado:** 15-20% ao ano (foco em ações e growth) ### Passo 3: 🚀 Escolha sua Estratégia FIRE **🎮 Teste todas as calculadoras:** 1. **[Traditional FIRE](/calculadoras/fire-tradicional)** - Máxima segurança 2. **[Lean FIRE](/calculadoras/lean-fire)** - Meta mais rápida 3. **[Fat FIRE](/calculadoras/fat-fire)** - Conforto total 4. **[Coast FIRE](/calculadoras/coast-fire)** - Piloto automático 5. **[Barista FIRE](/calculadoras/barista-fire)** - Flexibilidade máxima 6. **[Geographic Arbitrage](/calculadoras/geographic-arbitrage-fire)** - Aproveite diferenças regionais ### Passo 4: 📈 Monitore e Otimize Constantemente **📅 Cronograma de revisão:** * **Mensal:** Gastos e aportes * **Trimestral:** Performance dos investimentos * **Semestral:** Estratégia geral e metas * **Anual:** Rebalanceamento completo do portfolio ## ❓ Perguntas Frequentes sobre FIRE no Brasil 2025 ### 1. 🇧🇷 É possível alcançar FIRE no Brasil em 2025? **✅ Resposta:** Absolutamente! O Brasil de 2025 oferece condições excelentes para FIRE. Com a maturidade do mercado financeiro, novas oportunidades de investimento e ferramentas como nossas calculadoras gratuitas, milhares de brasileiros já estão no caminho da independência financeira. ### 2. 🤔 Qual calculadora FIRE devo usar primeiro? **✅ Resposta:** Comece com a [Calculadora FIRE Tradicional](/calculadoras/fire-tradicional) para entender os conceitos básicos. Depois explore [Lean FIRE](/calculadoras/lean-fire) para metas mais rápidas ou [Fat FIRE](/calculadoras/fat-fire) para maior conforto. ### 3. 📈 Como a inflação brasileira afeta meus cálculos? **✅ Resposta:** Nossas calculadoras já consideram rentabilidade real (acima da inflação). Para 2025, recomendamos usar retornos de 10-15% ao ano, que já incluem proteção inflacionária através de ativos como Tesouro IPCA+ e ações. ### 4. 💰 Posso alcançar FIRE com salário médio brasileiro? **✅ Resposta:** Sim! O [Lean FIRE](/calculadoras/lean-fire) é perfeito para quem ganha R$ 5.000-10.000. Com disciplina, muitos brasileiros alcançam independência financeira em 12-18 anos, mesmo com renda média. ### 5. ⏰ Quanto tempo leva para alcançar FIRE no Brasil? **✅ Resposta:** Varia entre 10-25 anos dependendo do perfil. Com nossas calculadoras, você pode simular cenários precisos. Exemplo típico: aportes de 50% da renda + 12% rentabilidade = FIRE em 12-15 anos. ### 6. 🏠 Devo incluir imóveis no planejamento FIRE? **✅ Resposta:** Sim, através de FIIs (Fundos Imobiliários) que oferecem liquidez e renda mensal. Nossa [Calculadora de Dividendos](/calculadoras/simulador-de-rentabilidade-e-dividendos) simula cenários com FIIs perfeitamente. ### 7. 📊 Como as mudanças econômicas afetam o FIRE? **✅ Resposta:** Nossas calculadoras consideram cenários diversos. O FIRE é resiliente a mudanças pois foca em ativos reais e diversificação. Maior razão ainda para começar em 2025! ### 8. 🔄 Posso combinar diferentes estratégias FIRE? **✅ Resposta:** Claro! Muitos começam com [Coast FIRE](/calculadoras/coast-fire), evoluem para [Barista FIRE](/calculadoras/barista-fire) e chegam ao FIRE completo. Use todas as calculadoras para planejar essa evolução. ## 🎉 Conclusão: 2025 é SEU Ano para Conquistar a Independência Financeira O movimento FIRE não é apenas uma tendência - é uma **revolução financeira** que está transformando a vida de milhares de brasileiros. Com nossas calculadoras FIRE gratuitas e interativas, você tem em mãos ferramentas profissionais que transformam sonhos em **planos concretos e atingíveis**. ### 🚀 Por que começar HOJE? **⏰ Tempo é seu maior aliado**\ Cada dia que passa é um dia a menos para os juros compostos trabalharem a seu favor. **🛠️ Ferramentas nunca foram tão acessíveis**\ Nossas 6 calculadoras gratuitas dão acesso a planejamento de nível profissional. **📈 Mercado brasileiro maduro em 2025**\ Condições ideais para investir e crescer patrimônio. ### 🎯 Seus Próximos Passos para a Liberdade Financeira: **📊 1. [Acesse TODAS as calculadoras gratuitamente](/calculadoras)**\ Teste diferentes estratégias e encontre sua ideal. **🎮 2. Simule cenários diversos**\ Use os gráficos interativos para visualizar sua jornada. **💰 3. Comece a investir baseado nos insights**\ Transforme planejamento em ação concreta. **📈 4. Monitore progresso regularmente**\ Use nossas ferramentas para acompanhar sua evolução. ### 💪 Lembre-se: A Jornada FIRE é uma Maratona, não um Sprint A independência financeira no Brasil é **desafiadora, mas totalmente possível**. Com as ferramentas certas, disciplina consistente e estratégia bem definida, você pode construir um futuro financeiro sólido e alcançar a liberdade de escolher como viver sua vida. **Milhares de brasileiros já estão nessa jornada. Você será o próximo?** *** ## 🎯 **COMECE SUA JORNADA FIRE AGORA MESMO!** ### **[🚀 ACESSE AS CALCULADORAS GRATUITAS →](/calculadoras)** **✅ 6 calculadoras FIRE especializadas**\ **✅ Gráficos interativos em tempo real**\ **✅ 100% gratuito e sem cadastro**\ **✅ Resultados em segundos** ### Não deixe para amanhã o que pode mudar sua vida hoje! 🔥 **Sua independência financeira começa com um clique.** # Calendário de Dividendos de FIIs com Python: Tutorial Completo (2026) URL: /blog/calendario-dividendos-fii-python-tutorial-completo.mdx Construa um calendário de dividendos de FIIs em Python com a API brapi. Notificações, projeção de renda mensal e exportação para Google Calendar. *** searchable: true title: 'Calendário de Dividendos de FIIs com Python: Tutorial Completo (2026)' description: 'Construa um calendário de dividendos de FIIs em Python com a API brapi. Notificações, projeção de renda mensal e exportação para Google Calendar.' date: '2026-05-09' keywords: 'calendario dividendos fii, agenda fii python, rendimentos fii api, brapi dividendos fii, projecao renda mensal fii, alertas data com fii, payment date fii' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Fundos Imobiliários' readingTime: '17 min' tags: \['Python', 'FIIs', 'Dividendos', 'Renda Passiva', 'API', 'Tutorial', 'Automação', 'Calendário'] relatedPosts: \['fundos-imobiliarios-fiis-guia-completo-iniciantes', 'fii-screener-python-filtrar-fundos-imobiliarios-pvp-dy', 'relatorios-cvm-fii-composicao-patrimonial-vacancia-api', 'calculadora-dividendos-renda-passiva-brasil'] featured: true expertise: 'Tutorial técnico de automação de renda passiva com FIIs' lastReviewed: '2026-05-09' howToSteps: * name: 'Configurar ambiente Python' text: 'Instale Python 3.10+, requests, pandas e ics para gerar arquivos de calendário compatíveis com Google Calendar e Outlook.' * name: 'Buscar histórico de dividendos' text: 'Use /api/v2/fii/dividends para puxar histórico de rendimentos da carteira.' * name: 'Calcular cadência de pagamento' text: 'Identifique o padrão de pagamento de cada FII (gap entre data com e payment date, dia do mês típico).' * name: 'Projetar próximos pagamentos' text: 'Use a média histórica para projetar valores e datas dos próximos rendimentos.' * name: 'Exportar para calendário' text: 'Gere um arquivo .ics que você importa no Google Calendar, Outlook ou Apple Calendar.' howToTools: \['Python 3.10+', 'requests', 'pandas', 'ics', 'Token brapi.dev (plano Pro)'] *** import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > Quem investe em FIIs sabe: o "salário extra" mensal não cai todo no mesmo dia. HGLG11 paga uma data, MXRF11 outra, KNCR11 outra. Sem organização, você só descobre o pagamento quando aparece no extrato. Neste tutorial você vai construir um **calendário de dividendos de FIIs em Python**, com projeções e notificações. *** ## O Problema Imagine uma carteira modesta com 8 FIIs. Cada um tem: * Sua **data com** (ex-dividend) própria, geralmente perto do início do mês * Sua **data de pagamento** (4 a 14 dias depois), variando por administrador * Seu **valor por cota**, que oscila levemente entre meses Acompanhar isso "no olho" via app da corretora é frustrante: * Você não tem visão consolidada do mês * Não sabe **quando** o próximo dinheiro vai entrar * Não consegue planejar reinvestimento ou pagar contas usando a renda Vamos resolver isso construindo um pipeline que: 1. Puxa o histórico via [`/api/v2/fii/dividends`](/docs/fiis/dividendos) 2. Identifica a cadência de pagamento de cada FII 3. **Projeta** os próximos 6 meses com base no padrão histórico 4. Exporta para um arquivo `.ics` (Google Calendar, Outlook, Apple Calendar) 5. Opcionalmente envia notificações via Telegram **Cuidado importante:** os relatórios CVM mensais (que populam `/api/v2/fii/dividends`) **não incluem a data de pagamento real** — apenas a data de competência. A brapi consolida o que está disponível no relatório e o `paymentDate` reflete a referência da competência. Para a data exata de crédito, sempre confirme no aviso de rendimento do FII publicado no fato relevante. Esse aviso geralmente sai 1 a 5 dias úteis antes do pagamento. *** ## O Que a API Retorna ```bash curl "https://brapi.dev/api/v2/fii/dividends?symbols=MXRF11&startDate=2024-01-01&endDate=2025-12-31" ``` Resposta abreviada: ```jsonc { "dividends": [ { "symbol": "MXRF11", "approvedOn": "2025-04-14T00:00:00.000Z", "label": "RENDIMENTO", // RENDIMENTO ou AMORTIZAÇÃO "lastDatePrior": "2025-04-14T00:00:00.000Z", // Data com (ex-dividend) "paymentDate": "2025-04-25T00:00:00.000Z", // Data de pagamento (referência) "rate": 0.10, // R$ por cota "relatedTo": "Março/2025", "isinCode": "BRMXRFCTF007", "remarks": "" }, /* ... */ ] } ``` A grande diferença em relação aos dividendos de ações: FIIs pagam **mensalmente**, com cadência muito previsível para a maioria dos fundos consolidados. *** ## O Que Vamos Construir ``` fii-calendar/ ├── brapi_client.py # Cliente HTTP ├── projector.py # Lógica de projeção ├── exporter.py # Geração de .ics ├── notifier.py # Telegram (opcional) └── run.py # Pipeline principal ``` Tempo: \~30 minutos. *** ## Pré-requisitos ```bash mkdir fii-calendar && cd fii-calendar python -m venv .venv && source .venv/bin/activate pip install requests pandas ics python-dateutil export BRAPI_TOKEN="seu_token_pro" ``` *** ## Passo 1: Cliente API ```python title="brapi_client.py" import os import requests from datetime import date, timedelta BASE = "https://brapi.dev/api/v2/fii" TOKEN = os.getenv("BRAPI_TOKEN", "") HEADERS = {"Authorization": f"Bearer {TOKEN}"} if TOKEN else {} def fetch_dividends( symbols: list[str], months_back: int = 24, ) -> list[dict]: """Busca histórico de dividendos para uma carteira de FIIs.""" today = date.today() start = (today - timedelta(days=months_back * 31)).isoformat() end = today.isoformat() params = { "symbols": ",".join(symbols), "startDate": start, "endDate": end, "sortBy": "paymentDate", "sortOrder": "asc", } resp = requests.get(f"{BASE}/dividends", params=params, headers=HEADERS, timeout=30) resp.raise_for_status() return resp.json().get("dividends", []) ``` A API aceita até **20 símbolos** por request. Se sua carteira for maior, basta dividir em lotes. *** ## Passo 2: Análise de Cadência Cada FII tem padrões próprios. Vamos extrair: * **Dia típico do mês** em que o pagamento ocorre * **Valor médio** dos últimos N meses * **Coeficiente de variação** do valor (estabilidade) ```python title="projector.py" import pandas as pd from dataclasses import dataclass from datetime import date, timedelta from dateutil.relativedelta import relativedelta @dataclass class FiiCadence: symbol: str typical_day_of_month: int avg_rate: float # R$ por cota median_rate: float coef_variation: float # Estabilidade do valor (menor = mais estável) last_payment: date last_rate: float def analyze_cadence(dividends: list[dict]) -> dict[str, FiiCadence]: """Calcula a cadência de pagamento de cada FII com base no histórico.""" df = pd.DataFrame(dividends) if df.empty: return {} # Apenas RENDIMENTO (não amortização) df = df[df["label"].str.upper() == "RENDIMENTO"].copy() df["paymentDate"] = pd.to_datetime(df["paymentDate"]) df["day_of_month"] = df["paymentDate"].dt.day df["rate"] = df["rate"].astype(float) cadences: dict[str, FiiCadence] = {} for symbol, group in df.groupby("symbol"): if len(group) < 3: # Histórico insuficiente para projetar continue last_12 = group.sort_values("paymentDate").tail(12) cadences[symbol] = FiiCadence( symbol=symbol, typical_day_of_month=int(last_12["day_of_month"].mode().iloc[0]), avg_rate=float(last_12["rate"].mean()), median_rate=float(last_12["rate"].median()), coef_variation=float(last_12["rate"].std() / last_12["rate"].mean()) if last_12["rate"].mean() > 0 else 0, last_payment=last_12["paymentDate"].max().date(), last_rate=float(last_12.sort_values("paymentDate")["rate"].iloc[-1]), ) return cadences @dataclass class ProjectedPayment: symbol: str expected_date: date expected_rate: float confidence: str # alta, média, baixa def project_next_payments( cadences: dict[str, FiiCadence], months_ahead: int = 6, ) -> list[ProjectedPayment]: """Projeta os próximos N meses com base na cadência.""" today = date.today() projections: list[ProjectedPayment] = [] for symbol, cad in cadences.items(): confidence = ( "alta" if cad.coef_variation < 0.10 else "média" if cad.coef_variation < 0.25 else "baixa" ) for i in range(1, months_ahead + 1): target_month = today + relativedelta(months=+i) day = min(cad.typical_day_of_month, _last_day_of_month(target_month).day) expected_date = target_month.replace(day=day) projections.append( ProjectedPayment( symbol=symbol, expected_date=expected_date, # Usa mediana (mais robusta a outliers) expected_rate=cad.median_rate, confidence=confidence, ) ) return sorted(projections, key=lambda p: p.expected_date) def _last_day_of_month(d: date) -> date: next_month = d.replace(day=28) + timedelta(days=4) return next_month - timedelta(days=next_month.day) ``` A lógica de **confiança** é simples mas útil: * **Alta**: variação \< 10% — FIIs de papel high-grade ou tijolo estável (HGLG11, MXRF11) * **Média**: variação 10–25% — FIIs com renda recorrente mas algum overshoot * **Baixa**: variação > 25% — fofs ou high yield com grande variabilidade *** ## Passo 3: Estimando Renda Mensal Projetada Para uma carteira com quantidade de cotas conhecida: ```python title="projector.py" {41-60} @dataclass class Holding: symbol: str shares: int def expected_monthly_income( holdings: list[Holding], cadences: dict[str, FiiCadence], months_ahead: int = 6, ) -> pd.DataFrame: """Projeta a receita mensal esperada da carteira.""" projections = project_next_payments(cadences, months_ahead=months_ahead) # Mapa symbol -> cotas shares_map = {h.symbol: h.shares for h in holdings} rows = [] for p in projections: shares = shares_map.get(p.symbol, 0) rows.append({ "month": p.expected_date.strftime("%Y-%m"), "expected_date": p.expected_date.isoformat(), "symbol": p.symbol, "shares": shares, "rate": p.expected_rate, "income": shares * p.expected_rate, "confidence": p.confidence, }) df = pd.DataFrame(rows) return df ``` Uso: ```python holdings = [ Holding(symbol="HGLG11", shares=50), Holding(symbol="MXRF11", shares=1000), Holding(symbol="KNCR11", shares=80), Holding(symbol="VISC11", shares=120), Holding(symbol="BTLG11", shares=200), ] dividends = fetch_dividends([h.symbol for h in holdings]) cadences = analyze_cadence(dividends) df = expected_monthly_income(holdings, cadences, months_ahead=6) # Receita por mês print(df.groupby("month")["income"].sum().round(2)) ``` Saída exemplo: ``` month 2026-06 1245.30 2026-07 1245.30 2026-08 1245.30 2026-09 1245.30 2026-10 1245.30 2026-11 1245.30 ``` Você ainda pode somar com expectativas de pagamentos extraordinários (datas relacionadas a vendas de imóveis, amortizações), mas como projeção base, isso já dá um número confiável para planejamento. *** ## Passo 4: Exportando para Calendário (.ics) Esta é a parte que **muda a vida**: importar tudo no Google Calendar / Outlook / Apple Calendar e ver os pagamentos no mesmo lugar onde você vê reuniões. ```python title="exporter.py" from ics import Calendar, Event from datetime import datetime def build_ics( projections: list, holdings_map: dict[str, int], ) -> str: """Gera um arquivo .ics com todos os pagamentos projetados.""" cal = Calendar() for p in projections: shares = holdings_map.get(p.symbol, 0) income = shares * p.expected_rate event = Event() event.name = f"💰 {p.symbol} — R$ {income:,.2f}".replace(",", "X").replace(".", ",").replace("X", ".") event.begin = datetime.combine(p.expected_date, datetime.min.time()) event.make_all_day() event.description = ( f"Projeção: R$ {p.expected_rate:.4f} por cota × {shares} cotas\n" f"Confiança: {p.confidence}\n\n" f"Atenção: data baseada no padrão histórico. Confirme no fato\n" f"relevante do FII publicado pelo administrador." ) cal.events.add(event) return cal.serialize() def save_ics(content: str, output_path: str = "fii_calendar.ics") -> None: with open(output_path, "w", encoding="utf-8") as f: f.write(content) print(f"Calendário salvo em {output_path}") ``` Uso final: ```python projections = project_next_payments(cadences, months_ahead=6) holdings_map = {h.symbol: h.shares for h in holdings} content = build_ics(projections, holdings_map) save_ics(content, "minha_carteira_fii.ics") ``` Como importar: * **Google Calendar:** Settings → Import → suba o arquivo `.ics` * **Outlook:** File → Open & Export → Import/Export → Import an iCalendar * **Apple Calendar:** File → Import → selecione o arquivo Resultado: cada FII vira um evento de dia inteiro com o valor projetado no título — perfeito para visualização móvel. *** ## Passo 5: Notificações via Telegram (Opcional) Se você quer **avisos por mensagem** N dias antes da data com: ```python title="notifier.py" import os import requests from datetime import date, timedelta TELEGRAM_TOKEN = os.getenv("TELEGRAM_BOT_TOKEN", "") TELEGRAM_CHAT_ID = os.getenv("TELEGRAM_CHAT_ID", "") def send_telegram(message: str) -> None: if not (TELEGRAM_TOKEN and TELEGRAM_CHAT_ID): print("Telegram não configurado, pulando") return url = f"https://api.telegram.org/bot{TELEGRAM_TOKEN}/sendMessage" requests.post( url, json={ "chat_id": TELEGRAM_CHAT_ID, "text": message, "parse_mode": "Markdown", }, timeout=15, ) def upcoming_alerts(projections: list, days_ahead: int = 3) -> None: """Envia alerta para pagamentos nos próximos N dias.""" today = date.today() target = today + timedelta(days=days_ahead) upcoming = [p for p in projections if today <= p.expected_date <= target] if not upcoming: return lines = ["📅 *Pagamentos de FIIs nos próximos dias:*", ""] for p in upcoming: lines.append( f"• `{p.expected_date.isoformat()}` — *{p.symbol}* — " f"R$ {p.expected_rate:.4f}/cota _(confiança {p.confidence})_" ) send_telegram("\n".join(lines)) ``` Para criar um bot Telegram e pegar o `chat_id`, veja o nosso tutorial dedicado: [Bot de Telegram para Cotações](/blog/bot-telegram-cotacoes-acoes-python-tutorial). *** ## Passo 6: Pipeline Completo ```python title="run.py" from brapi_client import fetch_dividends from projector import ( Holding, analyze_cadence, project_next_payments, expected_monthly_income, ) from exporter import build_ics, save_ics from notifier import upcoming_alerts def main() -> None: holdings = [ Holding(symbol="HGLG11", shares=50), Holding(symbol="MXRF11", shares=1000), Holding(symbol="KNCR11", shares=80), Holding(symbol="VISC11", shares=120), Holding(symbol="BTLG11", shares=200), ] symbols = [h.symbol for h in holdings] print(f"Baixando histórico de {len(symbols)} FIIs...") dividends = fetch_dividends(symbols, months_back=24) print("Analisando cadência...") cadences = analyze_cadence(dividends) for sym, cad in cadences.items(): print( f" {sym}: dia ~{cad.typical_day_of_month}, " f"mediana R$ {cad.median_rate:.4f}, " f"variação {cad.coef_variation*100:.1f}%" ) print("\nProjetando próximos 6 meses...") projections = project_next_payments(cadences, months_ahead=6) holdings_map = {h.symbol: h.shares for h in holdings} df = expected_monthly_income(holdings, cadences, months_ahead=6) print("\nReceita esperada por mês:") print(df.groupby("month")["income"].sum().round(2)) print("\nGerando calendário .ics...") content = build_ics(projections, holdings_map) save_ics(content, "fii_calendar.ics") print("\nVerificando alertas dos próximos 3 dias...") upcoming_alerts(projections, days_ahead=3) if __name__ == "__main__": main() ``` Rode com: ```bash python run.py ``` *** ## Variações da Estratégia ### A) Comparando Renda Projetada vs Realizada Acumule meses de projeção e compare com o realizado para identificar drift no padrão de pagamentos: ```python def projection_accuracy( projected: pd.DataFrame, realized: pd.DataFrame ) -> pd.DataFrame: merged = projected.merge( realized[["symbol", "month", "actual_income"]], on=["symbol", "month"], how="left", ) merged["error_pct"] = ( (merged["actual_income"] - merged["income"]) / merged["income"] * 100 ) return merged ``` Erros consistentemente positivos sugerem que os FIIs estão pagando acima do padrão (bom sinal). Erros negativos persistentes podem indicar mudança no perfil do fundo. ### B) Heatmap Mensal de Pagamentos Visualize a distribuição dos pagamentos ao longo do mês: ```python import matplotlib.pyplot as plt df = pd.DataFrame(dividends) df["paymentDate"] = pd.to_datetime(df["paymentDate"]) df["day"] = df["paymentDate"].dt.day # Histograma do dia do mês com mais pagamentos df["day"].hist(bins=31) plt.xlabel("Dia do Mês") plt.ylabel("Número de Pagamentos") plt.title("Concentração de Pagamentos de FIIs ao Longo do Mês") plt.savefig("fii_payment_heatmap.png", dpi=120) ``` A maior parte dos pagamentos se concentra entre os **dias 13 e 25** do mês. Saber disso ajuda a planejar reinvestimentos e contas mensais. ### C) Dividend Yield Realizado por Mês ```python def dy_realized( holdings: list[Holding], dividends: list[dict], cost_basis: dict[str, float], # PM por cota investido ) -> pd.DataFrame: """DY mensal sobre o preço médio que você pagou.""" df = pd.DataFrame(dividends) df["paymentDate"] = pd.to_datetime(df["paymentDate"]) df["month"] = df["paymentDate"].dt.to_period("M") rows = [] for h in holdings: pm = cost_basis.get(h.symbol, 0) if pm == 0: continue sub = df[df["symbol"] == h.symbol] for month, group in sub.groupby("month"): rate = float(group["rate"].sum()) dy_mes = rate / pm rows.append({ "symbol": h.symbol, "month": str(month), "dy_pct": dy_mes * 100, "yoc_anual_pct": dy_mes * 12 * 100, }) return pd.DataFrame(rows) ``` YOC (Yield on Cost) é o DY sobre o **preço que você pagou**, não sobre o preço atual — métrica mais útil para investidores de longo prazo. *** ## Cuidados Importantes Os relatórios CVM monthly não trazem a data exata de crédito. O `paymentDate` da brapi reflete a referência de competência. A data real costuma ser de 4 a 14 dias após a `lastDatePrior`, dependendo do administrador. **Para a data exata, sempre cheque o aviso de rendimento publicado pelo FII no fato relevante.** Mudanças no portfólio do FII (vendas de imóveis, captação, mudança de gestão) podem alterar drasticamente a distribuição. Use o calendário como *guideline*, não como certeza. O endpoint retorna tanto `RENDIMENTO` quanto `AMORTIZAÇÃO`. Amortização é devolução de capital — não é renda nova! Esta implementação filtra apenas RENDIMENTO no `analyze_cadence` para evitar inflar a projeção. *** ## Indo Além A partir desse esqueleto, você pode evoluir para: * **Dashboard web** (Streamlit ou Next.js) com a projeção interativa * **Reinvestimento automático** que casa o pagamento com a próxima compra * **Alertas de dividendo extraordinário** (rendimento muito acima da mediana) * **Comparação entre FIIs** com a metodologia de [análise de relatórios CVM](/blog/relatorios-cvm-fii-composicao-patrimonial-vacancia-api) *** ## Conclusão FIIs são, no Brasil, a forma mais consistente de gerar renda passiva mensal. Mas a falta de visibilidade sobre **quando** e **quanto** é o que faz muita gente desistir antes de colher o efeito da bola de neve. Com o endpoint `/api/v2/fii/dividends` da brapi e \~250 linhas de Python, você passa a ter: * Calendário projetado dos próximos 6 meses * Renda mensal esperada por carteira * Notificações automáticas * Histórico para auditoria de YOC e DY realizado > **Próximos passos:** se você quer descobrir **quais FIIs adicionar** à carteira, comece pelo [FII Screener com Python](/blog/fii-screener-python-filtrar-fundos-imobiliarios-pvp-dy). Para análise de fundamentos, veja o [tutorial de Relatórios CVM](/blog/relatorios-cvm-fii-composicao-patrimonial-vacancia-api). *Disclaimer: este artigo é educacional. Projeções de dividendos não são garantia de pagamento futuro. FIIs são renda variável.* # Como montar uma carteira de ações sem colecionar tickers URL: /blog/carteira-de-acoes-como-montar-diversificar.mdx Aprenda a definir o papel das ações, evitar concentrações escondidas, dimensionar posições e rebalancear com poucas regras. *** searchable: true title: 'Como montar uma carteira de ações sem colecionar tickers' description: 'Aprenda a definir o papel das ações, evitar concentrações escondidas, dimensionar posições e rebalancear com poucas regras.' date: '2026-01-01' keywords: 'carteira de ações, como montar carteira, diversificação ações, alocação de ativos, rebalanceamento carteira, gestão de risco, portfolio ações' author: 'Alisson Leal' category: 'Investimentos' subcategory: 'Carteiras' readingTime: '10 min' tags: \['Carteira de Ações', 'Diversificação', 'Alocação', 'Gestão de Risco', 'Investimentos'] relatedPosts: \['como-analisar-acoes-guia-iniciantes-2026', 'alocacao-de-ativos-por-idade-carteira-ideal-2026', 'guia-bogleheads-brasil-investimento-passivo-etfs', 'rebalanceamento-carteira-como-quando-fazer-2026'] featured: true expertise: 'Alocação de ativos, análise de ações e gestão de carteiras' lastReviewed: '2026-06-23' faqSchema: * question: 'Quantas ações preciso ter para diversificar?' answer: 'Não existe um número mágico. A diversificação depende dos setores, fatores de risco, tamanhos das posições e da exposição internacional, não apenas da quantidade de tickers.' * question: 'Devo dar o mesmo peso para todas as ações?' answer: 'Peso igual é simples, mas pode dar espaço demais a empresas mais arriscadas. O tamanho da posição deve refletir risco, convicção e impacto de uma perda.' * question: 'ETF pode fazer parte de uma carteira de ações?' answer: 'Sim. Um ETF amplo pode formar o núcleo diversificado, enquanto posições individuais ficam em uma parcela menor da carteira.' *** import { Authors, Author } from '~/components/Authors'; Uma carteira diversificada não é uma lista grande. É uma carteira que não depende da mesma empresa, setor, país ou cenário para funcionar. Ter quinze ações brasileiras pode continuar sendo concentração se oito dependem de juros baixos e cinco dependem do preço de commodities. ## Antes dos tickers ## 1. Separe a carteira de ações do patrimônio total Renda fixa, reserva, imóvel e previdência também fazem parte da sua exposição financeira. Uma pessoa com emprego em banco e imóvel financiado já depende bastante do setor financeiro e dos juros. Comprar apenas bancos aumenta uma concentração que não aparece no aplicativo da corretora. Defina primeiro quanto do patrimônio pode oscilar. O artigo de [alocação de ativos](/blog/alocacao-de-ativos-por-idade-carteira-ideal-2026) ajuda nessa decisão. ## 2. Escolha entre ETF e ações individuais Você não precisa provar habilidade escolhendo empresas. | Estrutura | Vantagem | Trabalho | | ------------------------------------- | ------------------------------------------ | -------- | | ETF amplo | Diversificação imediata | Baixo | | Ações individuais | Controle sobre empresas e pesos | Alto | | Núcleo com ETF e posições individuais | Combina diversificação e escolhas próprias | Médio | Um exemplo de estrutura para a parcela de renda variável: Se você não quer ler balanços e acompanhar a tese, deixe as ações individuais fora. Isso não torna a carteira inferior. ## 3. Diversifique riscos, não nomes Observe os fatores que movem cada empresa: * juros e crédito; * preço de commodities; * câmbio; * renda do consumidor; * regulação; * contratos públicos; * clima; * crescimento internacional. Quatro bancos continuam sendo uma aposta no mesmo ciclo. Uma petroleira e uma mineradora têm produtos diferentes, mas compartilham exposição a commodities e câmbio. Monte uma tabela simples: | Empresa | Setor | Principal risco | Receita em moeda forte? | Dívida relevante? | | ------- | ----------- | --------------- | ----------------------- | ----------------- | | A | Financeiro | Inadimplência | Não | Sim | | B | Exportadora | Commodity | Sim | Sim | | C | Consumo | Renda e juros | Não | Baixa | A tabela não precisa gerar uma nota. Ela serve para encontrar repetições. ## 4. Dimensione pela perda possível Pergunte quanto a carteira perderia se uma posição caísse 50%. | Peso da ação | Queda da ação | Impacto aproximado na carteira | | -----------: | ------------: | -----------------------------: | | 20% | 50% | 10% | | 10% | 50% | 5% | | 5% | 50% | 2,5% | Essa conta é mais útil do que uma regra universal de "máximo 10%". Empresas menores, endividadas, cíclicas ou com governança fraca merecem posições menores, se entrarem na carteira. Convicção não elimina risco. ## 5. Não use o preço da ação para definir peso Comprar a mesma quantidade de cada ticker cria pesos diferentes. Dez ações de R$ 15 valem R$ 150. Dez ações de R$ 80 valem R$ 800. O controle deve usar valor financeiro ou percentual da carteira. Para aportes pequenos, direcione o dinheiro à posição mais abaixo da meta. Não é necessário comprar todos os ativos todo mês. ## 6. Escreva a tese e a condição de saída Para cada ação individual, registre: * por que a empresa está na carteira; * qual vantagem você espera que continue; * quais números precisa acompanhar; * o que invalidaria a tese; * qual é o peso máximo aceitável. "Vender quando subir" não é critério. "Reavaliar se a dívida ultrapassar a capacidade de geração de caixa planejada" é mais útil. Uma cotação menor pode aumentar o risco ou criar oportunidade. A tese ajuda a separar as duas coisas. ## 7. Rebalanceie com aportes primeiro Suponha que a meta de uma posição seja 6% e, depois de uma alta, ela chegue a 9%. Você pode: 1. parar novos aportes nela; 2. direcionar dinheiro às posições abaixo da meta; 3. vender parte apenas se a concentração continuar excessiva ou a tese mudar. Rebalancear a cada pequena diferença cria operações e impostos sem mudar o risco de forma relevante. Uma revisão semestral ou anual costuma bastar para carteiras de longo prazo. Também é possível usar uma faixa, como revisar quando uma posição ultrapassar determinado limite. ## 8. Acompanhe o negócio, não o placar diário Uma rotina simples: | Frequência | O que revisar | | ---------- | -------------------------------------------- | | Trimestral | Resultado, caixa, dívida e fatos relevantes | | Semestral | Pesos, concentrações e teses | | Anual | Alocação total e necessidade de cada posição | Cotação diária não precisa de reunião. Use a brapi para consolidar preços e pesos, mas consulte documentos da companhia para decisões sobre o negócio. ```typescript const symbols = ["PETR4", "VALE3", "ITUB4"]; const response = await fetch( `https://brapi.dev/api/quote/${symbols.join(",")}`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); ``` ## Erros que parecem diversificação * comprar muitas ações do mesmo setor; * ter ETF de índice e repetir as maiores posições fora dele; * escolher ativos apenas pelo dividend yield; * adicionar uma empresa nova todo mês; * aumentar posição porque caiu, sem revisar a tese; * deixar uma vencedora dominar a carteira; * usar modelos prontos com valores e tickers de outra pessoa. ## Checklist * [ ] A parcela de ações cabe no patrimônio total. * [ ] Cada posição tem uma função e uma tese. * [ ] Consigo explicar as concentrações por setor e risco. * [ ] Sei o impacto de uma queda forte em cada posição. * [ ] Existe um limite de tamanho. * [ ] A regra de rebalanceamento está definida. * [ ] Consigo acompanhar os negócios sem depender de dicas. Antes de selecionar empresas, leia [como analisar uma ação](/blog/como-analisar-acoes-guia-iniciantes-2026). Se a rotina parece trabalhosa, considere uma carteira passiva no [guia Bogleheads](/blog/guia-bogleheads-brasil-investimento-passivo-etfs). *Conteúdo educacional. Os exemplos de alocação não são recomendações.* # Carteira Previdenciária 2026: Como Montar uma Carteira para Aposentadoria URL: /blog/carteira-previdenciaria-aposentadoria-2026.mdx Monte uma carteira para aposentadoria! Estratégias por idade, alocação de ativos e simuladores de independência financeira ✓ *** searchable: true title: 'Carteira Previdenciária 2026: Como Montar uma Carteira para Aposentadoria' description: 'Monte uma carteira para aposentadoria! Estratégias por idade, alocação de ativos e simuladores de independência financeira ✓' date: '2026-01-01' keywords: 'carteira previdenciaria 2026, aposentadoria, independencia financeira, FIRE, quanto investir para aposentar, carteira para aposentadoria, previdencia privada ou tesouro direto, viver de renda, renda passiva aposentadoria' author: 'Equipe brapi.dev' category: 'Planejamento Financeiro' subcategory: 'Aposentadoria' readingTime: '28 min' tags: \['Aposentadoria', 'Carteira Previdenciária', 'FIRE', 'Independência Financeira', 'Renda Passiva', 'Longo Prazo', 'Alocação de Ativos'] relatedPosts: \['guia-bogleheads-brasil-investimento-passivo-etfs', 'tesouro-direto-guia-completo-2026-como-investir', 'melhores-acoes-pagadoras-dividendos-2026', 'calculadoras-fire-independencia-financeira-brasil', 'dividendos-como-construir-renda-passiva'] featured: true expertise: 'Planejamento de aposentadoria e independência financeira' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > Você sabe quanto precisa acumular para se aposentar? E qual a melhor estratégia de investimentos para cada fase da vida? Este guia completo ensina a montar uma carteira previdenciária eficiente, desde os 20 anos até a aposentadoria. *** ## O Problema da Aposentadoria no Brasil A realidade é dura: **a maioria dos brasileiros não conseguirá se aposentar** apenas com o INSS. Veja os números: | Estatística | Dado | | -------------------------------------- | ----------- | | Teto do INSS (2026) | R$ 8.000,00 | | Aposentadoria média | R$ 1.800 | | Brasileiros que planejam aposentadoria | Apenas 18% | | Idade média de aposentadoria | 65 anos | | Expectativa de vida | 77 anos | ### Por Que Depender Só do INSS é Arriscado? 1. **Regras mudam constantemente** - Reformas da previdência aumentam idade e tempo de contribuição 2. **Teto baixo** - Mesmo contribuindo pelo teto, recebe no máximo R$ 7.786 3. **Déficit crescente** - Menos trabalhadores para mais aposentados 4. **Inflação corrói** - Reajustes nem sempre acompanham custo de vida > **Solução**: Construir uma **carteira previdenciária própria** que gere renda passiva suficiente para viver. *** ## Quanto Preciso para Me Aposentar? A regra mais usada é a **Regra dos 4%** (ou 25x): você precisa acumular **25 vezes seus gastos anuais**. ### Calculadora de Independência Financeira A fórmula é simples: **Patrimônio FIRE = Gasto Anual ÷ Taxa de Retirada** | Estilo de Vida | Gasto Mensal | Gasto Anual | Patrimônio FIRE (4%) | | -------------- | ------------ | ----------- | -------------------- | | Frugal | R$ 3.000 | R$ 36.000 | R$ 900.000 | | Confortável | R$ 7.000 | R$ 84.000 | R$ 2.100.000 | | Alto padrão | R$ 15.000 | R$ 180.000 | R$ 4.500.000 | | Luxo | R$ 30.000 | R$ 360.000 | R$ 9.000.000 | **Fórmula:** Multiplique seus gastos anuais por 25 (taxa de 4%) para obter o patrimônio necessário. ### Tabela Rápida: Quanto Acumular | Gasto Mensal | Gasto Anual | Patrimônio FIRE (4%) | Patrimônio Conservador (3%) | | ------------ | ----------- | -------------------- | --------------------------- | | R$ 3.000 | R$ 36.000 | R$ 900.000 | R$ 1.200.000 | | R$ 5.000 | R$ 60.000 | R$ 1.500.000 | R$ 2.000.000 | | R$ 7.000 | R$ 84.000 | R$ 2.100.000 | R$ 2.800.000 | | R$ 10.000 | R$ 120.000 | R$ 3.000.000 | R$ 4.000.000 | | R$ 15.000 | R$ 180.000 | R$ 4.500.000 | R$ 6.000.000 | | R$ 20.000 | R$ 240.000 | R$ 6.000.000 | R$ 8.000.000 | > **Taxa de 3% vs 4%**: A taxa de 4% é baseada no estudo Trinity (EUA). Para o Brasil, com inflação mais alta, muitos preferem usar **3% a 3.5%** para maior segurança. *** ## Estratégias por Idade: Alocação de Ativos A alocação ideal muda conforme você envelhece. O princípio básico: * **Jovem** = Mais risco (ações) → Mais retorno potencial * **Próximo da aposentadoria** = Menos risco (renda fixa) → Preservação ### Regra Clássica: 100 - Idade Uma regra simples: **subtraia sua idade de 100** para saber o percentual em renda variável. **Alocação por Idade (Perfil Moderado):** | Idade | Renda Variável | Renda Fixa | | ------- | -------------- | ---------- | | 25 anos | 75% | 25% | | 35 anos | 65% | 35% | | 45 anos | 55% | 45% | | 55 anos | 45% | 55% | | 65 anos | 35% | 65% | **Distribuição sugerida da Renda Variável:** * Ações Brasil: 40% * ETFs Exterior: 30% * FIIs: 30% **Distribuição sugerida da Renda Fixa:** * Tesouro IPCA+: 50% * Tesouro Selic: 30% * CDB/LCI/LCA: 20% **Ajuste por perfil:** Conservador (-10%), Moderado (base), Arrojado (+10%) ### Alocação Detalhada por Faixa Etária #### 20-35 Anos: Fase de Acumulação Agressiva | Classe | Alocação | Ativos Sugeridos | | --------------- | -------- | ---------------------------------- | | Ações Brasil | 35% | PETR4, VALE3, ITUB4, WEGE3, BOVA11 | | ETFs Globais | 25% | IVVB11, WRLD11 ou VWRA (exterior) | | FIIs | 15% | XPML11, HGLG11, KNRI11 | | Tesouro IPCA+ | 15% | Tesouro IPCA+ 2045 | | Reserva (Selic) | 10% | Tesouro Selic | **Foco**: Maximizar aportes, aceitar volatilidade, reinvestir dividendos. #### 35-50 Anos: Fase de Crescimento Equilibrado | Classe | Alocação | Ativos Sugeridos | | ---------------- | -------- | --------------------------------- | | Ações Brasil | 25% | Ações de dividendos + crescimento | | ETFs Globais | 20% | Diversificação internacional | | FIIs | 15% | Mix de tijolo e papel | | Tesouro IPCA+ | 25% | Escalonamento de vencimentos | | Renda Fixa Curta | 15% | CDBs, LCIs, Tesouro Selic | **Foco**: Equilibrar crescimento com proteção, começar a pensar em renda. #### 50-60 Anos: Fase de Transição | Classe | Alocação | Ativos Sugeridos | | ---------------- | -------- | ------------------------------------- | | Ações Dividendos | 20% | TAEE11, BBAS3, BBSE3, TRPL4 | | FIIs | 20% | Foco em rendimento mensal | | Tesouro IPCA+ | 30% | Vencimentos próximos da aposentadoria | | Renda Fixa Curta | 25% | Liquidez e segurança | | Reserva | 5% | Emergência | **Foco**: Reduzir volatilidade, aumentar ativos geradores de renda. #### 60+ Anos: Fase de Renda | Classe | Alocação | Ativos Sugeridos | | ----------------- | -------- | -------------------- | | Ações Dividendos | 15% | Blue chips pagadoras | | FIIs | 25% | Renda mensal estável | | Tesouro IPCA+ | 30% | Com juros semestrais | | Tesouro Selic/CDB | 25% | Liquidez imediata | | Reserva | 5% | 12 meses de gastos | **Foco**: Preservar capital, gerar renda consistente, liquidez para imprevistos. *** ## Simulador: Quanto Investir por Mês? Descubra quanto você precisa investir mensalmente para atingir seu objetivo: **Meta: R$ 2.000.000 (renda de \~R$ 6.700/mês com taxa 4%)** Considerando retorno real de 8% a.a. (após inflação): | Prazo | Aporte Mensal | Total Investido | Juros Ganhos | | ------- | ------------- | --------------- | ------------------ | | 40 anos | R$ 567 | R$ 272.000 | R$ 1.728.000 (86%) | | 30 anos | R$ 1.340 | R$ 483.000 | R$ 1.517.000 (76%) | | 20 anos | R$ 3.372 | R$ 809.000 | R$ 1.191.000 (60%) | | 15 anos | R$ 5.744 | R$ 1.034.000 | R$ 966.000 (48%) | | 10 anos | R$ 10.894 | R$ 1.307.000 | R$ 693.000 (35%) | **A mágica dos juros compostos:** Em 40 anos, 86% do patrimônio vem dos juros, não dos aportes! ### Tabela: Aporte Mensal por Meta e Prazo | Meta | 40 anos | 30 anos | 20 anos | 15 anos | 10 anos | | ----- | -------- | -------- | -------- | --------- | --------- | | R$ 1M | R$ 284 | R$ 670 | R$ 1.686 | R$ 2.872 | R$ 5.447 | | R$ 2M | R$ 567 | R$ 1.340 | R$ 3.372 | R$ 5.744 | R$ 10.894 | | R$ 3M | R$ 851 | R$ 2.011 | R$ 5.058 | R$ 8.615 | R$ 16.342 | | R$ 5M | R$ 1.418 | R$ 3.351 | R$ 8.430 | R$ 14.359 | R$ 27.236 | > **Mensagem clara**: Começar cedo faz TODA a diferença. Com 40 anos de prazo, R$ 567/mês vira R$ 2 milhões! *** ## Carteiras Modelo para Aposentadoria ### Carteira Conservadora (Risco Baixo) Para quem não tolera ver o patrimônio oscilar mais que 10-15%. **Risco:** Baixo | **Retorno esperado:** 8-10% a.a. | Classe | % | Ativos Sugeridos | Objetivo | | ---------------- | --- | ---------------------------------- | ----------------------------- | | Tesouro IPCA+ | 40% | IPCA+ 2029, 2035, 2045 | Proteção contra inflação | | Tesouro Selic | 15% | Tesouro Selic | Liquidez e reserva | | CDB/LCI/LCA | 15% | CDBs 110%+ CDI, LCIs/LCAs 95%+ CDI | Renda fixa privada | | FIIs | 20% | XPML11, HGLG11, KNRI11, VISC11 | Renda mensal + diversificação | | Ações Dividendos | 10% | TAEE11, BBAS3, ITSA4, TRPL4 | Proteção patrimonial | ### Carteira Moderada (Risco Médio) Equilíbrio entre crescimento e proteção. | Classe | % | Ativos | Objetivo | | ------------- | --- | -------------------------- | ----------------- | | Tesouro IPCA+ | 25% | IPCA+ 2035, 2045 | Proteção inflação | | Tesouro Selic | 10% | Selic | Reserva | | Ações Brasil | 25% | PETR4, VALE3, ITUB4, WEGE3 | Crescimento | | ETFs Globais | 15% | IVVB11, WRLD11 | Diversificação | | FIIs | 20% | XPML11, HGLG11, MXRF11 | Renda mensal | | Criptomoedas | 5% | BTC, ETH | Alto potencial | ### Carteira Arrojada (Risco Alto) Para quem tem horizonte longo e tolera volatilidade. | Classe | % | Ativos | Objetivo | | ------------- | --- | ----------------------- | --------------------- | | Ações Brasil | 35% | Blue chips + Small caps | Crescimento acelerado | | ETFs Globais | 25% | S\&P 500, MSCI World | Exposição global | | FIIs | 15% | Tijolo + Papel | Renda + valorização | | Tesouro IPCA+ | 15% | Longo prazo | Proteção base | | Criptomoedas | 10% | BTC, ETH, SOL | Alto risco/retorno | *** ## Monitorando sua Carteira com brapi.dev Acompanhe sua carteira previdenciária em tempo real: ```typescript const tickers = ['TAEE11', 'BBAS3', 'ITSA4', 'VALE3', 'PETR4']; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(',')}?modules=defaultKeyStatistics÷nds=true`, { headers: { Authorization: `Bearer ${token}` } } ); const data = await response.json(); // Calcular valor total e dividendos const portfolio = data.results.map((stock) => ({ ticker: stock.symbol, price: stock.regularMarketPrice, dividendYield: stock.defaultKeyStatistics?.dividendYield || 0, })); ``` **Métricas para acompanhar:** * Valor total da carteira * Dividendos mensais estimados * Yield médio ponderado * Progresso em relação à meta FIRE ### Dashboard de Acompanhamento **Métricas essenciais para seu dashboard:** | Métrica | Fórmula | Exemplo | | -------------------- | -------------------------------------- | --------------------- | | Progresso Patrimônio | (Valor Atual ÷ Meta) × 100 | R$ 500k ÷ R$ 2M = 25% | | Progresso Renda | (Dividendos Atuais ÷ Meta Renda) × 100 | R$ 2k ÷ R$ 8k = 25% | | Anos para Meta | Simulação com aporte mensal | \~15 anos | **Exemplo de dashboard:** * Valor atual: R$ 500.000 * Meta patrimônio: R$ 2.000.000 * Progresso: **25%** * Dividendos mensais: R$ 2.000 * Meta de renda: R$ 8.000/mês * Anos estimados para meta: **15 anos** (com aportes de R$ 2.000/mês) *** ## Previdência Privada vs Investir por Conta Uma das maiores dúvidas: vale a pena ter previdência privada? ### Comparativo PGBL/VGBL vs Carteira Própria | Aspecto | PGBL | VGBL | Carteira Própria | | ---------------------------- | ---------------- | -------------- | ---------------- | | **Taxa de administração** | 0.5% a 2% a.a. | 0.5% a 2% a.a. | 0% a 0.5% | | **Taxa de carregamento** | 0% a 5% | 0% a 3% | 0% | | **Flexibilidade** | Baixa | Baixa | Total | | **Benefício fiscal entrada** | Sim (até 12% IR) | Não | Não | | **Tributação saída** | 10% a 35% | 10% a 35% | Depende do ativo | | **Sucessão** | Sem inventário | Sem inventário | Com inventário | | **Portabilidade** | Entre fundos | Entre fundos | Total | ### Quando Previdência Privada Vale a Pena? **PGBL faz sentido se:** * Você faz declaração completa do IR * Pode aproveitar dedução de até 12% da renda * Planeja resgatar com tabela regressiva (10% após 10 anos) * Taxa de administração \< 1% a.a. **VGBL faz sentido se:** * Quer planejamento sucessório (sem inventário) * Faz declaração simplificada * Taxa de administração \< 1% a.a. **Carteira própria é melhor se:** * Taxas da previdência > 1% a.a. * Você tem disciplina para investir sozinho * Quer flexibilidade total * Já usa declaração simplificada ### Simulação: Previdência vs Tesouro Direto **Investindo R$ 1.000/mês por 30 anos:** | Métrica | Previdência (taxa 1,5% a.a.) | Tesouro Direto | | ------------------ | ---------------------------- | ----------------------- | | Patrimônio Bruto | \~R$ 1.200.000 | \~R$ 1.400.000 | | IR na Saída | 10% (tabela regressiva) | 15% (sobre rendimentos) | | Patrimônio Líquido | \~R$ 1.080.000 | \~R$ 1.250.000 | | **Diferença** | - | **+R$ 170.000** | **Por que o Tesouro vence?** * Taxa de administração de 1,5% a.a. consome \~R$ 200.000 em 30 anos * Custódia da bolsa é apenas 0,2% a.a. * IR do Tesouro incide apenas sobre rendimentos, não sobre o total > **Conclusão**: Com taxas de administração típicas (1-2% a.a.), o Tesouro Direto geralmente vence a previdência privada no longo prazo. *** ## Estratégia de Renda na Aposentadoria Ao chegar na aposentadoria, você precisa converter patrimônio em renda. Existem várias estratégias: ### 1. Estratégia do Balde (Bucket Strategy) Divida seu patrimônio em 3 "baldes": | Balde | Horizonte | Alocação | Objetivo | | --------------- | --------- | --------------- | -------------------- | | **Curto Prazo** | 0-2 anos | 100% Renda Fixa | Gastos imediatos | | **Médio Prazo** | 3-7 anos | 60% RF + 40% RV | Reposição do balde 1 | | **Longo Prazo** | 8+ anos | 40% RF + 60% RV | Crescimento | **Exemplo: Patrimônio de R$ 2.000.000, Gasto de R$ 7.000/mês** | Balde | Valor | Alocação | Função | | ----------- | ------------ | --------------------------------- | ----------------------------- | | Curto Prazo | R$ 168.000 | Tesouro Selic, CDB liquidez | Saques mensais | | Médio Prazo | R$ 420.000 | 60% IPCA+ / 40% FIIs e Dividendos | Repor balde curto anualmente | | Longo Prazo | R$ 1.412.000 | 40% RF / 60% Ações e ETFs | Crescimento para repor baldes | ### 2. Estratégia de Dividendos Viver apenas dos dividendos, sem consumir o principal: **Exemplo: R$ 2.000.000 de patrimônio, meta de R$ 8.000/mês** * **Renda anual necessária:** R$ 96.000 * **Dividend Yield necessário:** 4,8% **Ações sugeridas para carteira de dividendos:** | Ticker | DY Médio | Setor | | ------ | -------- | ------- | | TAEE11 | \~9,5% | Energia | | BBAS3 | \~8,2% | Bancos | | CPLE6 | \~8,0% | Energia | | TRPL4 | \~7,5% | Energia | | BBSE3 | \~7,0% | Seguros | | ITSA4 | \~6,8% | Holding | **DY médio da carteira:** \~7,8% (acima do necessário, gerando margem de segurança) ### 3. Tesouro IPCA+ com Juros Semestrais Para quem quer renda previsível e protegida da inflação: | Título | Vencimento | Taxa (exemplo) | Renda Semestral\* | | ------------- | ---------- | -------------- | ----------------- | | IPCA+ JS 2029 | 2029 | IPCA + 6.5% | \~3.25% do valor | | IPCA+ JS 2035 | 2035 | IPCA + 6.8% | \~3.40% do valor | | IPCA+ JS 2045 | 2045 | IPCA + 6.9% | \~3.45% do valor | \*Cupom semestral de juros **Exemplo: R$ 1.000.000 em Tesouro IPCA+ 6,5%** | Métrica | Valor | | ----------------------- | ------------ | | Cupom semestral bruto | R$ 32.500 | | IR (15% após 2 anos) | R$ 4.875 | | Cupom semestral líquido | R$ 27.625 | | **Equivalente mensal** | **R$ 4.604** | O principal permanece protegido pela inflação e você recebe renda real a cada 6 meses. *** ## Erros Comuns a Evitar ### 1. Começar Tarde Demais | Idade início | Aporte para R$ 2M aos 65 | Total investido | | ------------ | ------------------------ | --------------- | | 25 anos | R$ 567/mês | R$ 272.000 | | 35 anos | R$ 1.340/mês | R$ 483.000 | | 45 anos | R$ 3.372/mês | R$ 809.000 | | 55 anos | R$ 10.894/mês | R$ 1.307.000 | > Cada década de atraso **triplica** o esforço necessário! ### 2. Subestimar a Inflação R$ 5.000 hoje não valem R$ 5.000 daqui 30 anos. **Efeito da inflação (4,5% a.a.) no poder de compra:** | Prazo | R$ 5.000 hoje equivale a... | Multiplicador | | ------- | --------------------------- | ------------- | | 10 anos | R$ 7.765/mês | 1,55x | | 20 anos | R$ 12.065/mês | 2,41x | | 30 anos | R$ 18.745/mês | 3,75x | **Conclusão:** Sempre planeje considerando valores reais (ajustados pela inflação), não nominais. ### 3. Não Diversificar Colocar tudo em um único ativo é receita para desastre: * **100% em ações**: Crise de 2008 = -50% em meses * **100% em Tesouro Prefixado**: Alta de juros = prejuízo na marcação * **100% em FIIs**: Pandemia 2020 = -30% em alguns fundos * **100% em previdência cara**: Taxas comem seu patrimônio ### 4. Sacar na Crise O pior momento para vender é durante quedas. Quem vendeu no fundo: | Crise | Queda Máxima | Recuperação | | ------------- | ------------ | ----------- | | 2008 | -60% | 4 anos | | 2015 (Brasil) | -40% | 3 anos | | 2020 (COVID) | -46% | 5 meses | > **Regra**: Mantenha 2-3 anos de gastos em renda fixa para não precisar vender na baixa. *** ## Checklist: Planejamento para Aposentadoria ### Fase 1: Diagnóstico (Faça hoje!) * [ ] Calcular gastos mensais atuais * [ ] Projetar gastos na aposentadoria * [ ] Definir idade alvo para aposentar * [ ] Calcular patrimônio FIRE necessário * [ ] Avaliar patrimônio atual ### Fase 2: Estratégia * [ ] Definir alocação de ativos por idade * [ ] Escolher veículos de investimento * [ ] Decidir sobre previdência privada * [ ] Calcular aporte mensal necessário * [ ] Montar carteira inicial ### Fase 3: Execução * [ ] Abrir conta em corretora (se não tiver) * [ ] Configurar aportes automáticos * [ ] Cadastrar na brapi.dev para monitoramento * [ ] Criar planilha de acompanhamento * [ ] Agendar revisão trimestral ### Fase 4: Monitoramento * [ ] Acompanhar progresso mensalmente * [ ] Rebalancear carteira anualmente * [ ] Ajustar alocação conforme idade * [ ] Revisar meta conforme mudanças de vida * [ ] Simular cenários periodicamente *** ## Ferramentas para Acompanhamento ### API brapi.dev para Monitoramento Acompanhe indicadores relevantes para seu planejamento de aposentadoria: ```typescript const auth = { headers: { Authorization: `Bearer ${token}` } }; // SELIC + IPCA acumulado 12m em uma única chamada const macroRes = await fetch( 'https://brapi.dev/api/v2/macro/latest?symbols=selic,ipca12m', auth, ).then((r) => r.json()); const selic = macroRes.results.find((r) => r.series.slug === 'selic')?.latest.value; const ipca = macroRes.results.find((r) => r.series.slug === 'ipca12m')?.latest.value; // Cotações de ativos previdenciários const tickers = 'BOVA11,IVVB11,XPML11,HGLG11'; const quotes = await fetch(`https://brapi.dev/api/quote/${tickers}`, auth).then((r) => r.json()); ``` **Indicadores importantes para acompanhar:** * **SELIC:** Taxa básica de juros (afeta renda fixa) * **IPCA:** Inflação oficial (corrige seu patrimônio real) * **ETFs:** BOVA11, IVVB11 (acompanhar mercado) * **FIIs:** XPML11, HGLG11 (renda mensal) ### Calculadoras Disponíveis 1. **Calculadora FIRE**: Quanto preciso para aposentar 2. **Simulador de Aportes**: Quanto investir por mês 3. **Comparador Previdência vs Tesouro**: O que rende mais 4. **Projetor de Renda**: Quanto vou receber de dividendos *** ## Conclusão: Comece Hoje! A aposentadoria confortável não acontece por acaso. Requer: 1. **Planejamento**: Saber quanto precisa e quando 2. **Disciplina**: Investir consistentemente 3. **Paciência**: Deixar os juros compostos trabalharem 4. **Conhecimento**: Entender onde está colocando seu dinheiro ### Próximos Passos 1. **Calcule seu número FIRE** usando as fórmulas acima 2. **Defina sua alocação** baseada na sua idade e perfil 3. **Monte uma carteira inicial** com os ativos sugeridos 4. **Configure aportes automáticos** mensais 5. **Monitore com brapi.dev** seu progresso > **Lembre-se**: O melhor momento para começar era há 10 anos. O segundo melhor momento é **agora**. *** ## Recursos Adicionais ### Artigos Relacionados * [Guia Bogleheads Brasil: Investimento Passivo com ETFs](/blog/guia-bogleheads-brasil-investimento-passivo-etfs) * [Tesouro Direto 2026: Guia Completo](/blog/tesouro-direto-guia-completo-2026-como-investir) * [Melhores Ações Pagadoras de Dividendos](/blog/melhores-acoes-pagadoras-dividendos-2026) ### API brapi.dev Comece gratuitamente em [brapi.dev](https://brapi.dev) para: * Acompanhar cotações em tempo real * Monitorar dividendos da sua carteira * Calcular indicadores de valuation * Integrar com suas planilhas *** *Última atualização: Janeiro 2026* **Aviso Legal**: Este conteúdo é educacional e não constitui recomendação de investimento. Consulte um profissional certificado antes de tomar decisões financeiras. Rentabilidade passada não garante resultados futuros. # Carteiras de Criptomoedas 2026: Guia Completo de Segurança (Ledger, Trezor, MetaMask) URL: /blog/carteiras-criptomoedas-guia-seguranca-2026.mdx Aprenda a escolher a melhor carteira de criptomoedas para seu perfil. Comparativo de hot wallets vs cold wallets, seed phrase, e dicas de segurança. *** searchable: true title: 'Carteiras de Criptomoedas 2026: Guia Completo de Segurança (Ledger, Trezor, MetaMask)' description: 'Aprenda a escolher a melhor carteira de criptomoedas para seu perfil. Comparativo de hot wallets vs cold wallets, seed phrase, e dicas de segurança.' date: '2025-12-30' keywords: 'carteira criptomoedas, ledger brasil, trezor comprar, metamask tutorial, wallet bitcoin, cold wallet segura, hardware wallet brasil' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Criptomoedas' readingTime: '20 min' tags: \['Criptomoedas', 'Carteiras', 'Segurança', 'Ledger', 'Trezor', 'MetaMask', 'Hardware Wallet'] relatedPosts: \['bitcoin-brasil-como-investir-analise', 'ethereum-eth-guia-completo-brasil-2026', 'defi-financas-descentralizadas-guia-iniciantes-2026', 'como-declarar-criptomoedas-imposto-renda-2026'] featured: true expertise: 'Guia elaborado por especialistas em segurança de criptoativos com foco em proteção de patrimônio digital' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; A escolha da **carteira de criptomoedas** certa pode ser a diferença entre manter seu patrimônio seguro ou perdê-lo para hackers. Em 2026, com o aumento da adoção de criptoativos, entender os tipos de carteiras e práticas de segurança é essencial para qualquer investidor brasileiro. Neste guia completo, você vai aprender: * Diferença entre hot wallets e cold wallets * Comparativo das melhores carteiras do mercado * Como proteger sua seed phrase * Configuração passo a passo * Dicas avançadas de segurança *** ## O que é uma Carteira de Criptomoedas? Uma **carteira (wallet)** de criptomoedas não armazena suas moedas diretamente. Na verdade, ela guarda suas **chaves privadas** - códigos criptográficos que comprovam sua propriedade dos ativos na blockchain. 5HueCGU...] PubK[Chave Pública / Endereço
0x7Fa9...] BC[(Blockchain
BTC: 0.5
ETH: 2.0
SOL: 50)] PK -->|prova de propriedade| BC PK -->|deriva| PubK PubK -->|compartilhe para receber| U((Pagamentos)) style PK fill:#dc2626,color:#fff style PubK fill:#2563eb,color:#fff style BC fill:#16a34a,color:#fff `} /> > Quem tem a chave privada, controla os fundos. ### Conceitos Fundamentais | Termo | Definição | | ----------------- | ---------------------------------------------------------- | | **Chave Privada** | Código secreto que dá acesso total aos fundos | | **Chave Pública** | Endereço derivado da chave privada, pode ser compartilhado | | **Seed Phrase** | 12-24 palavras que geram todas as suas chaves | | **Custodial** | Terceiro (exchange) guarda suas chaves | | **Non-custodial** | Você controla suas próprias chaves | *** ## Tipos de Carteiras ### Hot Wallets vs Cold Wallets | Aspecto | Hot Wallet (conectada) | Cold Wallet (offline) | | ---------------- | --------------------------------------------- | ---------------------------------------------------- | | **Formatos** | Mobile apps, browser extensions, desktop apps | Hardware, paper wallet, steel backup | | **Vantagens** | Conveniência, acesso rápido | Máxima segurança, offline = sem hacks | | **Desvantagens** | Vulnerável a hacks, risco de malware | Menos conveniente, custo inicial | | **Ideal para** | Uso diário, pequenos valores, trading/DeFi | Hodl de longo prazo, grandes valores, herança/backup | ### Comparativo Detalhado | Tipo | Segurança | Conveniência | Custo | Exemplos | | ------------------------ | --------- | ------------ | ------- | -------------------- | | **Exchange (custodial)** | ⭐⭐ | ⭐⭐⭐⭐⭐ | Grátis | Binance, Coinbase | | **Mobile wallet** | ⭐⭐⭐ | ⭐⭐⭐⭐ | Grátis | Trust Wallet, Exodus | | **Browser extension** | ⭐⭐⭐ | ⭐⭐⭐⭐ | Grátis | MetaMask, Phantom | | **Desktop wallet** | ⭐⭐⭐⭐ | ⭐⭐⭐ | Grátis | Electrum, Sparrow | | **Hardware wallet** | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | $50-300 | Ledger, Trezor | | **Paper wallet** | ⭐⭐⭐⭐⭐ | ⭐ | Grátis | Geração offline | *** ## Principais Carteiras do Mercado ### Hot Wallets (Software) #### 1. MetaMask A carteira mais popular para Ethereum e redes EVM (Polygon, Arbitrum, BSC). | Característica | Detalhes | | -------------- | -------------------------------------- | | **Tipo** | Browser extension + Mobile | | **Redes** | Ethereum, Polygon, Arbitrum, BSC, etc. | | **Bitcoin** | ❌ Não suporta | | **DeFi** | ✅ Excelente integração | | **NFTs** | ✅ Visualização nativa | **Prós:** * ✅ Padrão da indústria para DeFi * ✅ Suporte a múltiplas redes EVM * ✅ Extensão + app mobile * ✅ Integração com hardware wallets **Contras:** * ❌ Não suporta Bitcoin * ❌ Interface pode confundir iniciantes * ❌ Phishing é comum (cuidado com sites falsos) #### 2. Phantom A carteira líder para Solana, expandindo para Ethereum e Bitcoin. | Característica | Detalhes | | -------------- | ---------------------------------- | | **Tipo** | Browser extension + Mobile | | **Redes** | Solana, Ethereum, Polygon, Bitcoin | | **NFTs** | ✅ Excelente visualização | | **Staking** | ✅ Staking nativo de SOL | #### 3. Trust Wallet Carteira mobile multi-chain popular, de propriedade da Binance. | Característica | Detalhes | | -------------- | -------------------- | | **Tipo** | Mobile (iOS/Android) | | **Redes** | 100+ blockchains | | **Bitcoin** | ✅ Suporta | | **Staking** | ✅ Várias opções | #### 4. Rabby Wallet Alternativa ao MetaMask com foco em segurança. | Característica | Detalhes | | -------------- | -------------------------------------- | | **Tipo** | Browser extension | | **Destaque** | Simulação de transações pré-assinatura | | **Segurança** | Alertas de contratos suspeitos | ### Cold Wallets (Hardware) #### 1. Ledger A marca mais popular de hardware wallets, com diferentes modelos: | Modelo | Preço (est.) | Tela | Bluetooth | Moedas | | ---------------------- | ------------ | ----------- | --------- | ------ | | **Ledger Nano S Plus** | \~R$ 500 | Pequena | ❌ | 5.500+ | | **Ledger Nano X** | \~R$ 1.000 | Pequena | ✅ | 5.500+ | | **Ledger Stax** | \~R$ 1.500 | E-ink touch | ✅ | 5.500+ | | **Ledger Flex** | \~R$ 1.200 | Touch | ✅ | 5.500+ | **Como funciona:** Chave privada nunca sai
Assina TX] LL[Ledger Live
Software
Prepara TX + verificação] BC[(Blockchain)] LL -->|envia TX não assinada| L L -->|TX assinada| LL LL -->|broadcast| BC style L fill:#16a34a,color:#fff style LL fill:#2563eb,color:#fff `} /> > Chave privada NUNCA conecta à internet. Mesmo se o PC estiver infectado, os fundos permanecem seguros. #### 2. Trezor Pioneira em hardware wallets, com foco em código aberto. | Modelo | Preço (est.) | Tela | Open Source | Moedas | | ------------------ | ------------ | -------------- | ----------- | ------ | | **Trezor One** | \~R$ 400 | Pequena | ✅ | 1.000+ | | **Trezor Model T** | \~R$ 1.000 | Touch colorida | ✅ | 1.000+ | | **Trezor Safe 3** | \~R$ 500 | Pequena | ✅ | 1.000+ | | **Trezor Safe 5** | \~R$ 1.000 | Touch | ✅ | 1.000+ | **Diferenças Ledger vs Trezor:** | Aspecto | Ledger | Trezor | | ----------------- | -------------------- | ------------------ | | Código fonte | Parcialmente fechado | 100% open source | | Chip seguro | Secure Element | Sem Secure Element | | Bluetooth | Sim (alguns modelos) | Não | | Moedas suportadas | 5.500+ | 1.000+ | | Software | Ledger Live | Trezor Suite | #### 3. Outras Opções | Wallet | Destaque | Preço | | ----------------------- | -------------------------------- | ---------- | | **Keystone** | Air-gapped (QR code) | \~R$ 800 | | **BitBox02** | Suíça, minimalista | \~R$ 700 | | **Coldcard** | Apenas Bitcoin, máxima segurança | \~R$ 800 | | **Foundation Passport** | Bitcoin, open source | \~R$ 1.000 | *** ## Seed Phrase: Sua Chave Mestra A **seed phrase** (frase de recuperação) é a informação mais importante de suas criptomoedas. São 12-24 palavras que podem regenerar todas as suas chaves privadas. ### Gerando Seed Phrase **Como Seed Phrases Funcionam (BIP-39):** | Parâmetro | Valor | | ------------ | ---------------------- | | Entropia | 128 bits (16 bytes) | | Checksum | 4 bits | | Total | 132 bits = 12 palavras | | Lista BIP-39 | 2048 palavras | **Cálculo de palavras (Entropia → Checksum → Palavras):** * **12 palavras:** 128 bits de entropia + 4 bits de checksum = 132 bits → 132 ÷ 11 = 12 palavras * **24 palavras:** 256 bits de entropia + 8 bits de checksum = 264 bits → 264 ÷ 11 = 24 palavras > ⚠️ **NUNCA gere seed phrase manualmente!** Use SEMPRE o gerador da sua hardware wallet! ### Protegendo sua Seed Phrase **Proteção da Seed Phrase:** **Fazer:** * Escrever em papel (offline) * Fazer múltiplas cópias * Guardar em locais diferentes (casa, cofre) * Usar placa de metal para resistir a fogo/água * Considerar multisig para valores altos * Testar recuperação ANTES de depositar fundos **Nunca fazer:** * Fotografar ou escanear * Salvar no celular/computador * Armazenar em nuvem (Google Drive, iCloud) * Digitar em sites/apps (exceto para recuperação) * Compartilhar com NINGUÉM * Gerar em computador conectado **Backup em metal (recomendado):** * Cryptosteel (placas de aço) * Billfodl * Zeus * Custo: R$ 300-800 ### Testando sua Seed Phrase SEMPRE teste a recuperação antes de depositar valores significativos: e anote a seed phrase] --> B[2. Deposite valor pequeno
US$ 10-50] B --> C[3. Resete a wallet
para estado de fábrica] C --> D[4. Recupere usando
a seed phrase] D --> E{Saldo aparece
corretamente?} E -->|Sim| F[6. Deposite valores maiores
com segurança] E -->|Não| G[Refaça a seed phrase
antes de depositar mais] style F fill:#16a34a,color:#fff style G fill:#dc2626,color:#fff `} /> > Se pular este teste e a seed estiver errada, você PERDERÁ todos os fundos. *** ## Guia: Configurando MetaMask ### Instalação Passo a Passo **Passo 1 — Download:** * Acesse APENAS metamask.io (cuidado com phishing!) * Clique em "Download" e escolha seu navegador * Instale a extensão oficial **Passo 2 — Criar carteira:** * Clique em "Criar nova carteira" * Aceite os termos de uso * Crie uma senha forte (mínimo 15 caracteres) **Passo 3 — Seed phrase:** * ANOTE as 12 palavras em PAPEL (nunca digital!) * Confirme na ordem correta * Guarde em local seguro **Passo 4 — Adicionar redes:** * Configurações → Redes → Adicionar rede * Adicione: Polygon, Arbitrum, Optimism, BSC * Use chainlist.org para configurações corretas **Passo 5 — Segurança extra:** * Ative auto-lock (5-15 minutos) * Revise aprovações regularmente (revoke.cash) * Não conecte a sites desconhecidos ### Adicionando Redes ao MetaMask **Configurações de Redes para MetaMask:** | Rede | Chain ID | RPC URL | Símbolo | Explorer | | ------------------- | -------- | ------------------------ | ------- | ----------------------- | | **Polygon (Matic)** | 137 | polygon-rpc.com | MATIC | polygonscan.com | | **Arbitrum One** | 42161 | arb1.arbitrum.io/rpc | ETH | arbiscan.io | | **Optimism** | 10 | mainnet.optimism.io | ETH | optimistic.etherscan.io | | **BNB Smart Chain** | 56 | bsc-dataseed.binance.org | BNB | bscscan.com | | **Base** | 8453 | mainnet.base.org | ETH | basescan.org | > 💡 **Dica:** Use [chainlist.org](https://chainlist.org) para adicionar redes automaticamente. *** ## Guia: Configurando Hardware Wallet ### Ledger - Primeira Configuração **Antes de começar:** * Compre APENAS do site oficial (ledger.com) ou Amazon * Verifique se a embalagem está LACRADA * O dispositivo deve vir ZERADO (sem seed pré-configurada) **Passo 1 — Instalação do Ledger Live:** * Baixe Ledger Live de ledger.com/ledger-live * Instale no computador ou celular * Crie uma conta (opcional, para backup cloud) **Passo 2 — Configurar dispositivo:** * Conecte o Ledger via USB * Escolha "Set up as new device" * Crie um PIN de 4-8 dígitos **Passo 3 — Seed phrase (24 palavras):** * O dispositivo mostrará 24 palavras * Anote TODAS em papel, NA ORDEM * O dispositivo pedirá confirmação * NUNCA fotografe ou digite no computador **Passo 4 — Instalar apps:** * No Ledger Live, vá em "My Ledger" * Instale apps: Bitcoin, Ethereum, etc. * Cada blockchain precisa de seu app **Passo 5 — Criar contas:** * Vá em "Accounts" → "Add account" * Siga instruções para cada moeda * Confirme endereços no dispositivo ### Usando Ledger com MetaMask Você pode combinar a segurança do Ledger com a conveniência do MetaMask: Uniswap, etc.] --> M[MetaMask
interface] M --> L[Ledger
guarda as chaves] L -.->|assina TX| M M -.->|envia TX| D style L fill:#16a34a,color:#fff style M fill:#f97316,color:#fff style D fill:#2563eb,color:#fff `} /> **Configuração:** 1. Conecte o Ledger e abra o app Ethereum 2. MetaMask → Adicionar conta → Hardware wallet 3. Selecione "Ledger" 4. Escolha a conta desejada **Uso:** * Navegue normalmente com MetaMask * Cada transação requer confirmação no Ledger * Chaves NUNCA saem do dispositivo *** ## Estratégias de Segurança ### Arquitetura de Carteiras por Valor **Estratégia por Valor do Portfólio:** | Valor | Nível | Carteiras Recomendadas | Medidas de Segurança | | ------------------------ | ------------- | ------------------------------------------------------ | ------------------------------------------------------- | | **Até R$ 5.000** | Básico | MetaMask, Trust Wallet | Seed em papel, senha forte | | **R$ 5.000 - R$ 50.000** | Intermediário | Ledger Nano S Plus/X, Trezor Safe 3 | Hardware wallet, seed em metal, backup separado | | **Acima de R$ 50.000** | Avançado | Multisig (2 de 3), Ledger + passphrase, Casa/Unchained | Multisig, passphrase (25ª palavra), herança documentada | **Detalhamento por Nível:** **🟢 Básico (até R$ 5.000)** * MetaMask ou Phantom (browser) * Trust Wallet (mobile) * ✓ Seed phrase em papel * ✓ Senha forte na wallet * ✓ Não conectar a sites suspeitos **🟡 Intermediário (R$ 5.000 - R$ 50.000)** * Ledger Nano S Plus ou X * Trezor Safe 3 * ✓ Hardware wallet obrigatória * ✓ Seed phrase em metal * ✓ Backup em local separado * ✓ PIN complexo no dispositivo **🔴 Avançado (acima de R$ 50.000)** * Multisig com 2-3 dispositivos * Ledger + passphrase * Coldcard (Bitcoin) * Casa ou Unchained (custódia colaborativa) * ✓ Multisig com 2-3 dispositivos * ✓ Passphrase (25ª palavra) * ✓ Herança documentada * ✓ Auditoria regular * ✓ Distribuição geográfica de backups ### Passphrase (25ª Palavra) Uma **passphrase** adiciona uma camada extra de segurança: 24 palavras] S -->|sem passphrase| A[Carteira A - isca
~US$ 100] S -->|com passphrase
'minhasenha123'| B[Carteira B - oculta
fundos reais ~US$ 50.000] style A fill:#f97316,color:#fff style B fill:#16a34a,color:#fff style S fill:#2563eb,color:#fff `} /> **Vantagens:** * Mesma seed gera carteiras diferentes * Carteira "isca" em caso de coerção * Atacante não sabe que a passphrase existe **Cuidados:** * Esquecer a passphrase = perder o acesso PERMANENTEMENTE * Guardar a passphrase SEPARADA da seed ### Multisig: Múltiplas Assinaturas Para valores altos, considere **multisig** (múltiplas assinaturas): Ledger - casa] K2[Chave 2
Trezor - cofre] K3[Chave 3
Coldcard - família] T{Transação
exige 2 de 3} K1 --> T K2 --> T K3 --> T T --> OK[Fundos liberados] style K1 fill:#2563eb,color:#fff style K2 fill:#2563eb,color:#fff style K3 fill:#2563eb,color:#fff style T fill:#f59e0b,color:#fff style OK fill:#16a34a,color:#fff `} /> **Cenários:** * Perder 1 chave → ainda tem acesso (com as outras 2) * Roubo de 1 chave → atacante não consegue mover fundos * Herança → família + advogado podem acessar **Soluções multisig:** * Gnosis Safe (Ethereum/EVM) * Casa, Unchained (Bitcoin) * Sparrow Wallet (Bitcoin DIY) *** ## Golpes Comuns e Como Evitar ### Tipos de Golpes **Golpes Comuns em Criptomoedas:** | Risco | Golpe | Como Funciona | Prevenção | | ---------- | --------------------------- | ------------------------------------------------- | -------------------------------------------------------- | | 🔴 CRÍTICO | **Phishing de Seed Phrase** | Site/app falso pede sua seed "para verificação" | NUNCA digite seed em sites. Wallets NUNCA pedem sua seed | | 🔴 CRÍTICO | **Fake MetaMask/Ledger** | Extensão/app falso no navegador ou app store | Baixe APENAS dos sites oficiais. Verifique desenvolvedor | | 🟠 ALTO | **Approval Scam** | dApp malicioso pede aprovação ilimitada de tokens | Use revoke.cash. Aprove apenas o necessário | | 🟠 ALTO | **Airdrop Scam** | Token "grátis" que drena wallet ao interagir | Não interaja com tokens desconhecidos na wallet | | 🟡 MÉDIO | **Dust Attack** | Pequeno valor enviado para rastrear transações | Não mova tokens suspeitos. Use carteiras separadas | | 🔴 CRÍTICO | **Suporte Falso** | Golpista finge ser suporte e pede acesso | Suporte NUNCA pede seed ou acesso remoto | | 🟠 ALTO | **SIM Swap** | Clona seu chip para receber SMS de 2FA | Use 2FA por app (Google Authenticator), não SMS | ### Checklist de Segurança **Seed phrase:** * Escrita em papel ou metal * Guardada offline (nunca digital) * Backup em local separado * Testada com recuperação **Dispositivos:** * Hardware wallet para valores > R$ 5.000 * Comprada de fonte oficial * PIN configurado * Firmware atualizado **Software:** * Wallets baixadas de sites oficiais * Extensões verificadas (desenvolvedor correto) * 2FA ativado com app (não SMS) * Antivírus atualizado **Comportamento:** * NUNCA compartilhar a seed phrase * Verificar URLs antes de conectar * Não clicar em links de "airdrops" * Revisar aprovações regularmente (revoke.cash) **Herança/contingência:** * Pessoa de confiança sabe da existência dos fundos * Instruções documentadas (cofre ou advogado) *** ## Onde Comprar Hardware Wallets no Brasil ### Canais Oficiais | Produto | Onde Comprar | Cuidados | | ---------- | -------------------------------- | ------------------------------ | | **Ledger** | ledger.com (oficial) | Frete internacional | | **Ledger** | Amazon.com.br (vendedor oficial) | Verificar "vendido por Ledger" | | **Trezor** | trezor.io (oficial) | Frete internacional | | **Trezor** | Revendedores BR (KriptoBR, etc.) | Verificar autenticidade | ### Red Flags na Compra * ❌ Preço muito abaixo do oficial * ❌ Vendedor sem histórico * ❌ Embalagem já aberta * ❌ Seed phrase "pré-configurada" * ❌ Adesivo de lacre rompido *** ## Perguntas Frequentes (FAQ) ### 1. Preciso de hardware wallet para qualquer valor? Não, mas é altamente recomendado para valores acima de R$ 5.000. Para valores menores, uma hot wallet bem configurada (MetaMask, Trust Wallet) com boas práticas de segurança é suficiente. ### 2. E se eu perder minha hardware wallet? Com a seed phrase, você pode recuperar seus fundos em QUALQUER wallet compatível. O dispositivo é apenas uma forma segura de armazenar e assinar - a seed phrase é o que importa. ### 3. MetaMask é seguro? Sim, se usado corretamente. Os riscos vêm de phishing, malware e aprovações maliciosas, não da wallet em si. Combine MetaMask com Ledger para máxima segurança. ### 4. Posso ter várias carteiras? Sim, e é recomendado! Separe: * Wallet para trading/DeFi (hot) * Wallet para holding de longo prazo (cold) * Wallet para interagir com dApps novos (com pouco valor) ### 5. Ledger ou Trezor? Ambos são excelentes. Ledger tem mais moedas suportadas e Bluetooth. Trezor é 100% open source. Para a maioria dos usuários, qualquer um serve bem. ### 6. O que fazer se perder a seed phrase? Se ainda tiver acesso à wallet, transfira IMEDIATAMENTE para nova wallet com nova seed. Se perdeu seed E acesso, infelizmente os fundos são irrecuperáveis. ### 7. Como preparar herança de criptomoedas? * Documento em cofre com instruções de acesso * Considere multisig 2-de-3 (você + família + advogado) * Serviços como Casa ou Unchained oferecem custódia colaborativa * NUNCA deixe seed phrase diretamente acessível *** ## Conclusão A segurança das suas criptomoedas depende inteiramente de você. Os principais pontos são: | Valor | Recomendação | | ----------- | -------------------------------------------------- | | \< R$ 5.000 | Hot wallet (MetaMask, Trust) com boas práticas | | R$ 5k - 50k | Hardware wallet (Ledger, Trezor) + backup em metal | | > R$ 50.000 | Multisig ou passphrase + distribuição geográfica | **Lembre-se:** 1. ✅ Seed phrase é a chave de tudo - proteja com sua vida 2. ✅ Hardware wallets são investimento, não gasto 3. ✅ Teste recuperação ANTES de depositar valores altos 4. ✅ "Not your keys, not your coins" - evite custódia em exchanges 5. ✅ Segurança é um processo contínuo, não um produto Use a API da brapi.dev para acompanhar o valor do seu portfólio e tomar decisões informadas sobre quando mover entre carteiras. *** *Disclaimer: Este guia é educacional e não constitui recomendação de produtos específicos. Sempre faça sua própria pesquisa antes de adquirir qualquer produto de segurança.* # CDB vs LCI: Qual Rende Mais? Calculadora de Equivalência 2026 URL: /blog/cdb-vs-lci-qual-rende-mais-calculadora.mdx CDB vs LCI: descubra qual rende mais com nossa calculadora gratuita. Compare rentabilidade líquida considerando IR e prazos. Calculadora CDB LCI ✓ *** searchable: true title: 'CDB vs LCI: Qual Rende Mais? Calculadora de Equivalência 2026' description: 'CDB vs LCI: descubra qual rende mais com nossa calculadora gratuita. Compare rentabilidade líquida considerando IR e prazos. Calculadora CDB LCI ✓' date: '2026-01-07' keywords: 'cdb vs lci calculadora, cdb ou lci qual rende mais, lci ou cdb, comparar cdb lci, cdb x lci, calculadora cdb lci, rentabilidade cdb lci, lci vs cdb, cdb lci comparativo, calculadora lci cdb' author: 'Equipe brapi.dev' category: 'Renda Fixa' subcategory: 'Comparativo de Investimentos' readingTime: '10 min' tags: \['CDB', 'LCI', 'LCA', 'Renda Fixa', 'Calculadora', 'Comparativo', 'Investimentos', 'IR'] relatedPosts: \['lci-lca-guia-completo-investimentos-isentos-ir-2026', 'calculadora-dividendos-renda-passiva-brasil'] featured: true expertise: 'Especialistas em renda fixa brasileira com foco em otimização tributária e maximização de rentabilidade' lastReviewed: '2026-01-07' howToTools: \['Calculadora LCI LCA vs CDB brapi.dev', 'Tabela de IR regressivo', 'Simulador de rentabilidade'] howToSteps: * name: 'Acesse a Calculadora LCI vs CDB' text: 'Navegue até brapi.dev/calculadoras/equivalencia-lci-lca-cdb para usar a calculadora gratuita.' * name: 'Insira a taxa do CDB' text: 'Digite a taxa do CDB que você está analisando (ex: 100% do CDI ou 12% a.a.).' * name: 'Selecione o prazo do investimento' text: 'Escolha o prazo para calcular o IR aplicável ao CDB (22,5% a 15%).' * name: 'Compare com a taxa da LCI/LCA' text: 'A calculadora mostra qual taxa de LCI/LCA equivale ao CDB após impostos.' * name: 'Analise os gráficos de comparação' text: 'Visualize a diferença de rentabilidade líquida entre os investimentos.' faqSchema: * question: 'CDB ou LCI: qual rende mais?' answer: 'Depende do prazo e das taxas oferecidas. LCI/LCA são isentos de IR, então uma LCI de 85% do CDI pode render mais que um CDB de 100% do CDI para prazos curtos. Use nossa calculadora CDB vs LCI para comparar com seus valores específicos.' * question: 'Como calcular a equivalência entre CDB e LCI?' answer: 'Para calcular a equivalência, divida a taxa do CDB pelo fator (1 - alíquota IR). Exemplo: CDB 100% CDI por 1 ano (IR 17,5%) equivale a LCI de 82,5% do CDI. Nossa calculadora faz esse cálculo automaticamente.' * question: 'Qual a vantagem da LCI sobre o CDB?' answer: 'A principal vantagem da LCI é a isenção de Imposto de Renda para pessoa física. Um CDB precisa render mais para compensar o IR de 15% a 22,5%. LCI também tem garantia do FGC até R$ 250.000 por CPF/instituição.' * question: 'Quando o CDB vale mais a pena que a LCI?' answer: 'O CDB vale mais a pena quando sua taxa líquida (após IR) supera a da LCI. Isso geralmente ocorre com CDBs acima de 110-120% do CDI para prazos longos (acima de 2 anos), ou quando a LCI oferece taxas muito baixas.' * question: 'LCI tem garantia do FGC?' answer: 'Sim, LCI e LCA têm garantia do Fundo Garantidor de Créditos (FGC) de até R$ 250.000 por CPF por instituição financeira, assim como CDBs. Isso torna ambos investimentos seguros para valores dentro desse limite.' *** import { Authors, Author } from '~/components/Authors'; > **CDB ou LCI: qual escolher?** A resposta depende das taxas e do prazo. Use nossa [Calculadora LCI vs CDB](/calculadoras/equivalencia-lci-lca-cdb) gratuita para comparar a rentabilidade líquida e descobrir qual investimento rende mais no seu caso específico. ## CDB vs LCI: Entenda a Diferença Principal A diferença fundamental entre CDB e LCI está na tributação: | Característica | CDB | LCI/LCA | | -------------------- | ------------------------ | ------------------------------------- | | **Imposto de Renda** | 15% a 22,5% (regressivo) | **Isento para PF** | | **Garantia FGC** | Sim, até R$ 250.000 | Sim, até R$ 250.000 | | **Liquidez** | Diária ou no vencimento | Geralmente no vencimento | | **Prazo mínimo** | Não há | 90 dias (LCI) / 90 dias (LCA) | | **Lastro** | Crédito bancário geral | Imobiliário (LCI) / Agronegócio (LCA) | Por isso, um CDB de **100% do CDI** pode render **menos** que uma LCI de **85% do CDI**, dependendo do prazo! ## Calculadora CDB vs LCI: Compare Agora Use nossa [Calculadora de Equivalência LCI/LCA vs CDB](/calculadoras/equivalencia-lci-lca-cdb) para descobrir qual investimento rende mais no seu caso. A ferramenta: * ✅ Calcula automaticamente o IR do CDB * ✅ Mostra a taxa de LCI equivalente * ✅ Compara rentabilidade líquida * ✅ Exibe gráficos interativos ### Tabela de Equivalência CDB vs LCI (Referência Rápida) Esta tabela mostra qual taxa de LCI equivale a um CDB de 100% do CDI em diferentes prazos: | Prazo | Alíquota IR | CDB 100% CDI | LCI Equivalente | | ----------------- | ----------- | ------------ | --------------- | | Até 180 dias | 22,5% | 100% | **77,5%** | | 181 a 360 dias | 20,0% | 100% | **80,0%** | | 361 a 720 dias | 17,5% | 100% | **82,5%** | | Acima de 720 dias | 15,0% | 100% | **85,0%** | **Interpretação**: Se você encontrar uma LCI pagando **mais** que os valores da coluna "LCI Equivalente", ela rende mais que o CDB de 100% do CDI! ### Exemplo Prático: CDB 110% vs LCI 90% Vamos comparar um CDB de 110% do CDI com uma LCI de 90% do CDI para um prazo de 1 ano: **CDB 110% do CDI (prazo 1 ano, IR 17,5%):** * Rentabilidade bruta: 110% * IR: 110% × 17,5% = 19,25% * **Rentabilidade líquida: 90,75% do CDI** **LCI 90% do CDI:** * Rentabilidade bruta: 90% * IR: 0% * **Rentabilidade líquida: 90% do CDI** **Resultado**: O CDB 110% rende **ligeiramente mais** (0,75% a mais) neste caso específico. ## Como Calcular a Equivalência CDB-LCI Manualmente Se você quiser calcular sem a calculadora, use esta fórmula: ### Fórmula: Taxa LCI Equivalente ao CDB ``` Taxa LCI Equivalente = Taxa CDB × (1 - Alíquota IR) ``` **Exemplo**: CDB de 100% do CDI por 2 anos (IR 15%): ``` Taxa LCI Equivalente = 100% × (1 - 0,15) = 85% ``` Ou seja, uma LCI de 85% do CDI ou mais rende igual ou mais que esse CDB. ### Fórmula Inversa: Taxa CDB Equivalente à LCI ``` Taxa CDB Equivalente = Taxa LCI ÷ (1 - Alíquota IR) ``` **Exemplo**: LCI de 90% do CDI, prazo 1 ano (IR 17,5%): ``` Taxa CDB Equivalente = 90% ÷ (1 - 0,175) = 109,09% ``` Ou seja, você precisaria de um CDB de **109,09% do CDI** para igualar essa LCI. ## Quando o CDB Vale Mais a Pena O CDB pode ser mais vantajoso em alguns cenários: ### 1. Taxas Muito Altas CDBs de bancos menores frequentemente oferecem taxas de 115-130% do CDI. Mesmo com IR, podem superar LCIs conservadoras: | Investimento | Taxa Bruta | IR (2 anos) | Taxa Líquida | | ------------ | ---------- | ----------- | ------------ | | CDB 120% CDI | 120% | 15% | **102%** | | LCI 95% CDI | 95% | 0% | **95%** | Neste caso, o CDB rende **7% a mais** em termos de CDI líquido. ### 2. Necessidade de Liquidez Diária CDBs com liquidez diária permitem resgate a qualquer momento. LCIs geralmente exigem carência de 90 dias ou mais. Se você pode precisar do dinheiro antes, o CDB com liquidez pode ser melhor. ### 3. Prazos Muito Longos (Acima de 2 Anos) Com IR de apenas 15%, CDBs de prazo longo precisam de taxas menores para competir: * CDB 100% CDI por 3 anos = **85% líquido** * Para superar, LCI precisa pagar **mais de 85%** ## Quando a LCI/LCA Vale Mais a Pena ### 1. Prazos Curtos (Até 1 Ano) Com IR de 20-22,5%, CDBs perdem muita rentabilidade: | Investimento | Taxa Bruta | IR (6 meses) | Taxa Líquida | | ------------ | ---------- | ------------ | ------------ | | CDB 100% CDI | 100% | 22,5% | **77,5%** | | LCI 80% CDI | 80% | 0% | **80%** | A LCI de 80% supera o CDB de 100%! ### 2. Taxas Próximas Se CDB e LCI têm taxas parecidas, a LCI sempre vence: | Investimento | Taxa Bruta | IR (1 ano) | Taxa Líquida | | ------------ | ---------- | ---------- | ------------ | | CDB 95% CDI | 95% | 17,5% | **78,4%** | | LCI 85% CDI | 85% | 0% | **85%** | LCI rende **8,4% a mais** em termos de CDI! ### 3. Diversificação de Emissor Combinar LCIs de diferentes bancos permite diversificar risco mantendo cobertura do FGC (R$ 250.000 por instituição). ## Comparativo Completo: CDB vs LCI vs LCA | Critério | CDB | LCI | LCA | | ----------------- | -------------------------- | -------------------------- | -------------------------- | | **Rentabilidade** | Geralmente maior bruta | Menor bruta, maior líquida | Menor bruta, maior líquida | | **Tributação** | IR regressivo 15-22,5% | **Isento** | **Isento** | | **Liquidez** | Diária ou vencimento | Vencimento (mín. 90 dias) | Vencimento (mín. 90 dias) | | **Garantia FGC** | Sim | Sim | Sim | | **Risco** | Crédito do banco | Crédito do banco | Crédito do banco | | **Melhor para** | Prazos longos, taxas altas | Prazos curtos/médios | Prazos curtos/médios | ## Perguntas Frequentes: CDB vs LCI ### CDB ou LCI: qual rende mais? Depende do prazo e das taxas oferecidas. LCI/LCA são isentos de IR, então uma LCI de 85% do CDI pode render mais que um CDB de 100% do CDI para prazos curtos. Use nossa [calculadora CDB vs LCI](/calculadoras/equivalencia-lci-lca-cdb) para comparar com seus valores específicos. ### Como calcular a equivalência entre CDB e LCI? Para calcular a equivalência, divida a taxa do CDB pelo fator (1 - alíquota IR). Exemplo: CDB 100% CDI por 1 ano (IR 17,5%) equivale a LCI de 82,5% do CDI. Nossa [calculadora de equivalência](/calculadoras/equivalencia-lci-lca-cdb) faz esse cálculo automaticamente. ### Qual a vantagem da LCI sobre o CDB? A principal vantagem da LCI é a **isenção de Imposto de Renda** para pessoa física. Um CDB precisa render mais para compensar o IR de 15% a 22,5%. LCI também tem garantia do FGC até R$ 250.000 por CPF/instituição. ### Quando o CDB vale mais a pena que a LCI? O CDB vale mais a pena quando sua taxa líquida (após IR) supera a da LCI. Isso geralmente ocorre com CDBs acima de 110-120% do CDI para prazos longos, ou quando a LCI oferece taxas muito baixas. ### LCI tem garantia do FGC? Sim, LCI e LCA têm garantia do Fundo Garantidor de Créditos (FGC) de até R$ 250.000 por CPF por instituição financeira, assim como CDBs. Isso torna ambos investimentos seguros para valores dentro desse limite. ## Conclusão: Use a Calculadora para Decidir A melhor forma de decidir entre CDB e LCI é **comparar as opções específicas** que você tem disponíveis. Use nossa [Calculadora LCI/LCA vs CDB](/calculadoras/equivalencia-lci-lca-cdb) para: 1. Inserir as taxas reais dos produtos 2. Selecionar o prazo do investimento 3. Ver a comparação lado a lado 4. Tomar a decisão mais rentável **Regra geral**: * **Prazos curtos (até 1 ano)**: LCI/LCA geralmente vencem * **Prazos longos + taxas altas de CDB**: CDB pode vencer * **Taxas semelhantes**: LCI/LCA sempre vencem *** **Próximos passos:** * [Calculadora LCI/LCA vs CDB](/calculadoras/equivalencia-lci-lca-cdb) - Compare agora * [Guia Completo de LCI e LCA](/blog/lci-lca-guia-completo-investimentos-isentos-ir-2026) - Entenda tudo sobre esses investimentos * [Simulador de Dividendos](/calculadoras/simulador-de-rentabilidade-e-dividendos) - Compare com renda variável # CDB vs Tesouro Direto em 2026: Qual É Melhor Para Você? URL: /blog/cdb-vs-tesouro-direto-comparativo-2026.mdx Compare CDB e Tesouro Direto: rentabilidade, segurança, liquidez, tributação e quando usar cada um. Guia completo com calculadora e simulações práticas. *** searchable: true title: 'CDB vs Tesouro Direto em 2026: Qual É Melhor Para Você?' description: 'Compare CDB e Tesouro Direto: rentabilidade, segurança, liquidez, tributação e quando usar cada um. Guia completo com calculadora e simulações práticas.' date: '2026-01-01' keywords: 'cdb vs tesouro direto 2026, cdb ou tesouro selic, tesouro direto vs cdb, qual melhor cdb ou tesouro, comparar cdb tesouro, renda fixa 2026, onde investir reserva emergencia' author: 'Equipe brapi.dev' category: 'Renda Fixa' subcategory: 'Comparativos' readingTime: '18 min' tags: \['CDB', 'Tesouro Direto', 'Renda Fixa', 'Comparativo', 'Investimentos', 'Iniciantes'] relatedPosts: \['tesouro-direto-guia-completo-2026-como-investir', 'o-que-e-cdi-guia-completo-2026', 'lci-lca-guia-completo-investimentos-isentos-ir-2026', 'renda-fixa-vs-renda-variavel-2026', 'como-investir-com-pouco-dinheiro-2026'] featured: true expertise: 'Comparativo de investimentos de renda fixa' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > CDB ou Tesouro Direto? Esta é uma das perguntas mais comuns entre investidores de renda fixa. Este guia compara os dois investimentos em detalhes para você tomar a melhor decisão. *** ## Resumo Rápido: CDB vs Tesouro Direto | Característica | CDB | Tesouro Direto | | ----------------- | ---------------------------- | ----------------------- | | **Emissor** | Bancos | Governo Federal | | **Garantia** | FGC (R$ 250k) | Governo (ilimitado) | | **Rentabilidade** | 80% a 140% CDI | Selic, IPCA+, Prefixado | | **Liquidez** | Varia (diária ou vencimento) | D+1 (Tesouro Selic) | | **Valor mínimo** | R$ 1 a R$ 1.000 | \~R$ 30 | | **IR** | 15% a 22,5% | 15% a 22,5% | | **Risco** | Crédito do banco | Soberano (menor) | *** ## O Que é CDB? **CDB (Certificado de Depósito Bancário)** é um título emitido por bancos para captar recursos. ``` Você empresta dinheiro para o banco ↓ Banco usa para emprestar a clientes ↓ Você recebe juros no vencimento ``` ### Tipos de CDB | Tipo | Como funciona | Exemplo | | -------------- | --------------- | -------------- | | **Pós-fixado** | Rende % do CDI | CDB 100% CDI | | **Prefixado** | Taxa fixa | CDB 12% ao ano | | **Híbrido** | Inflação + taxa | CDB IPCA + 5% | *** ## O Que é Tesouro Direto? **Tesouro Direto** é o programa do governo para vender títulos públicos para pessoas físicas. ``` Você empresta dinheiro para o governo ↓ Governo financia suas atividades ↓ Você recebe juros + principal ``` ### Tipos de Tesouro Direto | Título | Como funciona | Ideal para | | --------------------- | -------------------------------- | -------------------------- | | **Tesouro Selic** | Rende Selic | Reserva de emergência | | **Tesouro IPCA+** | IPCA + taxa fixa | Aposentadoria, longo prazo | | **Tesouro Prefixado** | Taxa fixa | Quando juros vão cair | | **Tesouro Renda+** | IPCA + taxa (pagamentos mensais) | Complementar aposentadoria | *** ## Comparativo Detalhado ### 1. Segurança | Característica | CDB | Tesouro Direto | | --------------- | -------------------------- | ------------------------- | | Quem garante | FGC (Fundo Garantidor) | Governo Federal | | Limite garantia | R$ 250.000 por CPF/banco | Ilimitado | | Risco de calote | Existe (banco quebrar) | Praticamente zero | | Histórico | Alguns bancos já quebraram | Brasil nunca deu calote | | Nível de risco | Baixo a Médio | Soberano (menor possível) | 🏆 **VENCEDOR em Segurança: TESOURO DIRETO** - Garantia do governo é considerada a mais segura do país ### 2. Rentabilidade **Comparativo com R$ 10.000 investidos:** | Investimento | 6 meses (IR 22,5%) | 12 meses (IR 20%) | 24 meses (IR 17,5%) | | ---------------------------- | ------------------ | ----------------- | ------------------- | | CDB 100% CDI (banco grande) | R$ 481 | R$ 1.036 | R$ 2.280 | | CDB 110% CDI (banco médio) | R$ 529 | R$ 1.140 | R$ 2.508 | | CDB 120% CDI (banco pequeno) | R$ 578 | R$ 1.243 | R$ 2.736 | | Tesouro Selic | R$ 475 | R$ 1.024 | R$ 2.254 | > 💡 **Observação**: CDB acima de 105% CDI geralmente supera o Tesouro Selic após considerar a taxa de custódia de 0,20% a.a. do Tesouro. **Para consultar a taxa Selic atual:** ```typescript const response = await fetch( "https://brapi.dev/api/v2/macro/latest?symbols=selic", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }, ); const { results } = await response.json(); const selic = results[0].latest.value; // Ex: 14.5 ``` ### 3. Liquidez | Característica | CDB | Tesouro Selic | | ---------------------- | ---------------------- | -------------------------------------- | | **Resgate antecipado** | Depende do tipo | Sim, sempre | | **Prazo para receber** | D+0 ou D+1 | D+1 | | **Penalidade** | Pode perder rendimento | Marcação a mercado (geralmente mínima) | | **Liquidez diária** | Alguns oferecem | Sempre disponível | **📌 CDB Liquidez Diária:** * Resgate: A qualquer momento * Prazo receber: D+0 * Penalidade: Nenhuma * Rentabilidade: Geralmente 100% CDI ou menos **📌 CDB com Vencimento:** * Resgate: Só no vencimento * Prazo receber: No vencimento * Penalidade: Não pode resgatar * Rentabilidade: 100% a 140% CDI **📌 Tesouro Selic:** * Resgate: A qualquer momento * Prazo receber: D+1 * Penalidade: Mínima (marcação mercado) * Rentabilidade: Selic **📌 Tesouro IPCA+:** * Resgate: A qualquer momento * Prazo receber: D+1 * Penalidade: **Pode ter prejuízo!** * Rentabilidade: IPCA + taxa (se levar até vencimento) ### 4. Tributação Ambos têm a mesma tributação: | Prazo | Alíquota IR | | ----------------- | ----------- | | Até 180 dias | 22,5% | | 181 a 360 dias | 20% | | 361 a 720 dias | 17,5% | | Acima de 720 dias | 15% | **Diferença importante:** * **CDB**: IOF nos primeiros 30 dias * **Tesouro**: Taxa de custódia de 0,20% ao ano ### Análise de Custos (R$ 10.000 por 12 meses) **CDB 100% CDI:** | Item | Valor | | ---------------------- | ------------ | | Rendimento Bruto | R$ 1.295 | | IR (20%) | R$ 259 | | **Rendimento Líquido** | **R$ 1.036** | **Tesouro Selic:** | Item | Valor | | ---------------------- | ------------ | | Rendimento Bruto | R$ 1.300 | | IR (20%) | R$ 260 | | Taxa Custódia (0,20%) | R$ 20 | | **Rendimento Líquido** | **R$ 1.020** | > 💡 CDB 100% CDI rende \~R$ 16 a mais que Tesouro Selic em 12 meses, mas Tesouro tem garantia ilimitada. *** ## Quando Escolher CDB ### ✅ CDB é melhor quando: | Situação | Por quê | | ----------------------- | ------------------------------ | | CDB rende >105% CDI | Supera Tesouro Selic | | Valor até R$ 250k | Coberto pelo FGC | | Não precisa de liquidez | CDBs com vencimento pagam mais | | Banco é sólido | Risco de crédito controlado | ### Melhores CDBs do Mercado **Ranking de CDBs (valores ilustrativos - consulte sua corretora):** | Banco | Tipo | % CDI | Prazo | Mínimo | FGC | | -------------- | ----------- | ----- | ------ | -------- | --- | | Banco Master | Vencimento | 130% | 36m | R$ 1.000 | ✅ | | Banco Pine | Vencimento | 120% | 24m | R$ 1.000 | ✅ | | Banco Daycoval | Vencimento | 115% | 12m | R$ 5.000 | ✅ | | C6 Bank | Vencimento | 110% | 12m | R$ 1.000 | ✅ | | Banco Inter | Liq. Diária | 100% | Diária | R$ 1 | ✅ | | Nubank | Liq. Diária | 100% | Diária | R$ 1 | ✅ | ⚠️ **Sempre verifique se o banco é coberto pelo FGC** *** ## Quando Escolher Tesouro Direto ### ✅ Tesouro é melhor quando: | Situação | Título Recomendado | | --------------------------- | ----------------------------- | | Reserva de emergência | Tesouro Selic | | Aposentadoria (20+ anos) | Tesouro IPCA+ | | Acredita que juros vão cair | Tesouro Prefixado | | Valor acima de R$ 250k | Qualquer (garantia ilimitada) | | Quer máxima segurança | Qualquer (garantia governo) | ### Tipos de Tesouro e Quando Usar **📌 Tesouro Selic** * Rentabilidade: Selic (\~13% ao ano) * Ideal para: Reserva de emergência, curto prazo * Risco: Mínimo * Prazo: Qualquer (liquidez D+1) * Volatilidade: Quase nenhuma **📌 Tesouro IPCA+** * Rentabilidade: IPCA + 6-7% ao ano * Ideal para: Aposentadoria, objetivos de longo prazo * Risco: Baixo se levar até vencimento * Prazo: 5 a 30+ anos * Volatilidade: Alta se vender antes **📌 Tesouro Prefixado** * Rentabilidade: 12-14% ao ano fixo * Ideal para: Quando acredita que juros vão cair * Risco: Médio (marcação a mercado) * Prazo: 2 a 10 anos * Volatilidade: Média a alta **📌 Tesouro Renda+** * Rentabilidade: IPCA + taxa (pagamentos mensais) * Ideal para: Complementar aposentadoria * Risco: Baixo se levar até vencimento * Prazo: Definido por idade * Volatilidade: Alta se vender antes *** ## Simulador Completo ### Cenário 1: Reserva de Emergência (R$ 10.000, 12 meses) | Opção | Rend. Líquido | Liquidez | Garantia | | -------------------------- | ------------- | ---------- | -------- | | CDB Liq. Diária (100% CDI) | R$ 1.036 | Alta | FGC | | CDB 110% CDI | R$ 1.140 | Baixa | FGC | | Tesouro Selic | R$ 1.020 | Alta (D+1) | Governo | **📌 Recomendação:** Tesouro Selic (máxima segurança, liquidez D+1) ou CDB Liquidez Diária (se FGC for suficiente) ### Cenário 2: Objetivo de Curto Prazo (R$ 50.000, 18 meses) | Opção | Rend. Líquido | Liquidez | Garantia | | -------------------------- | ------------- | ---------- | -------- | | CDB 110% CDI | R$ 8.525 | Baixa | FGC | | CDB Liq. Diária (100% CDI) | R$ 7.750 | Alta | FGC | | Tesouro Selic | R$ 7.650 | Alta (D+1) | Governo | **📌 Recomendação:** CDB 110%+ CDI se puder esperar vencimento ### Cenário 3: Aposentadoria - Longo Prazo (R$ 100.000, 60 meses) | Opção | Rend. Líquido | Liquidez | Garantia | | ------------- | ------------- | ---------- | -------- | | Tesouro IPCA+ | R$ 72.000 | Baixa | Governo | | CDB 110% CDI | R$ 65.000 | Baixa | FGC | | Tesouro Selic | R$ 59.000 | Alta (D+1) | Governo | **📌 Recomendação:** Tesouro IPCA+ (proteção inflação garantida) **Para consultar taxas atualizadas:** ```typescript // Selic + IPCA acumulado 12m em uma única chamada via /api/v2/macro const response = await fetch( "https://brapi.dev/api/v2/macro/latest?symbols=selic,ipca12m", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }, ); const { results } = await response.json(); const selic = results.find((r) => r.series.slug === "selic")?.latest.value; const ipca = results.find((r) => r.series.slug === "ipca12m")?.latest.value; ``` *** ## Estratégia Combinada A melhor estratégia geralmente combina os dois: ### Alocação Sugerida para R$ 100.000 | Investimento | % | Valor | Objetivo | | ---------------------------------- | -------- | -------------- | -------------------------------------- | | Tesouro Selic (reserva emergência) | 20% | R$ 20.000 | Liquidez D+1, máxima segurança | | CDB Liquidez Diária | 15% | R$ 15.000 | Rendimento + liquidez imediata | | CDB 110-120% CDI (12-24m) | 25% | R$ 25.000 | Melhor rentabilidade curto/médio prazo | | Tesouro IPCA+ (2035+) | 40% | R$ 40.000 | Proteção inflação, aposentadoria | | **TOTAL** | **100%** | **R$ 100.000** | | ### 📌 Benefícios desta Estratégia: * ✓ Liquidez para emergências (35%) * ✓ Rentabilidade acima do CDI (CDBs) * ✓ Proteção contra inflação (IPCA+) * ✓ Diversificação de riscos * ✓ Cobertura FGC + Garantia Governo *** ## Checklist de Decisão ### Escolha Tesouro Direto se: | Condição | ☐ | | ------------------------------- | - | | Valor acima de R$ 250.000 | ☐ | | Quer máxima segurança | ☐ | | É para reserva de emergência | ☐ | | Precisa de liquidez garantida | ☐ | | Objetivo de longo prazo (IPCA+) | ☐ | ### Escolha CDB se: | Condição | ☐ | | ----------------------------- | - | | Encontrou CDB >110% CDI | ☐ | | Valor até R$ 250.000 | ☐ | | Pode esperar até o vencimento | ☐ | | Banco emissor é sólido | ☐ | | Quer diversificar bancos | ☐ | *** ## Perguntas Frequentes ### 1. CDB ou Tesouro Selic para reserva? **Ambos funcionam**, mas: * **Tesouro Selic**: Mais seguro (garantia governo), liquidez D+1 * **CDB Liquidez Diária**: Pode render igual ou mais, liquidez D+0 ### 2. CDB de banco pequeno é arriscado? **Depende.** Com cobertura FGC (até R$ 250k), o risco é limitado. Mas: * Banco quebrar → demora até 60 dias para receber * Diversifique entre bancos * Não ultrapasse o limite FGC ### 3. Tesouro IPCA+ pode dar prejuízo? **Sim, se vender antes do vencimento.** O preço varia conforme expectativa de juros. Se levar até o vencimento, recebe a taxa contratada. ### 4. Qual tem menor IR? **Iguais.** Mesma tabela regressiva de IR. A diferença é a taxa de custódia do Tesouro (0,20% ao ano). *** ## Conclusão ### Resumo Final | Critério | Vencedor | | ----------------- | ------------------------ | | **Segurança** | Tesouro Direto | | **Rentabilidade** | CDB (se >105% CDI) | | **Liquidez** | Empate (ambos podem ter) | | **Praticidade** | CDB (mais simples) | | **Valores altos** | Tesouro (sem limite) | | **Inflação** | Tesouro IPCA+ | ### Recomendação Geral ``` 🎯 REGRA PRÁTICA: 1. RESERVA DE EMERGÊNCIA → Tesouro Selic (Máxima segurança, liquidez D+1) 2. CURTO/MÉDIO PRAZO → CDB >105% CDI (Melhor rentabilidade se puder esperar) 3. LONGO PRAZO → Tesouro IPCA+ (Proteção contra inflação garantida) 4. VALORES GRANDES (>R$ 250k) → Tesouro (Garantia ilimitada do governo) ``` *** ## Leia Também * [Tesouro Direto 2026: Guia Completo](/blog/tesouro-direto-guia-completo-2026-como-investir) * [O Que É CDI: Guia Completo 2026](/blog/o-que-e-cdi-guia-completo-2026) * [LCI e LCA: Guia Completo 2026](/blog/lci-lca-guia-completo-investimentos-isentos-ir-2026) * [Renda Fixa vs Renda Variável 2026](/blog/renda-fixa-vs-renda-variavel-2026) *** **Aviso Legal:** Este conteúdo é educacional e não constitui recomendação de investimento. Rentabilidades passadas não garantem rentabilidades futuras. Consulte um profissional antes de investir. # CDI Histórico via API: Como Obter a Série Completa do Principal Benchmark de Renda Fixa (2026) URL: /blog/cdi-historico-api-renda-fixa-benchmark-2026.mdx Acesse o histórico completo do CDI (Certificado de Depósito Interbancário) via API REST desde 1986. Anualize a taxa diária, compare com Selic e calcule rendimento de CDB 100% CDI corretamente. *** searchable: true title: 'CDI Histórico via API: Como Obter a Série Completa do Principal Benchmark de Renda Fixa (2026)' description: 'Acesse o histórico completo do CDI (Certificado de Depósito Interbancário) via API REST desde 1986. Anualize a taxa diária, compare com Selic e calcule rendimento de CDB 100% CDI corretamente.' date: '2026-05-05' keywords: 'cdi historico, api cdi, cdi acumulado, cdi anualizado, certificado deposito interbancario historico, taxa cdi diaria, cdi vs selic, calcular cdi, 100% cdi rendimento' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Renda Fixa' readingTime: '10 min' tags: \['CDI', 'Renda Fixa', 'Selic', 'API', 'TypeScript', 'Python', 'Benchmark'] relatedPosts: \['api-macroeconomia-brasil-bcb-indicadores-2026', 'como-calcular-juro-real-brasil-selic-ipca-api-2026', 'o-que-e-cdi-guia-completo-2026'] featured: true expertise: 'Integração com a série CDI do BCB SGS via brapi.dev' lastReviewed: '2026-05-05' howToTools: * 'Conta brapi.dev (Startup ou superior)' * 'Node.js 18+, Python 3.8+, ou cURL' howToSteps: * name: 'Crie sua conta brapi.dev e gere o token' text: 'Crie conta gratuita em brapi.dev e copie o token Bearer no painel.' * name: 'Obtenha o CDI mais recente' text: 'GET /api/v2/macro/latest?symbols=cdi retorna o último valor diário (em % ao dia).' * name: 'Histórico completo' text: 'GET /api/v2/macro?symbols=cdi\&startDate=1986-03-06\&limit=10000 traz a série completa desde a origem.' * name: 'Anualize com 252 dias úteis' text: 'A taxa diária precisa ser anualizada com (1 + cdi\_diario/100) \*\* 252 - 1. Não use 365 — o CDI só é divulgado em dias úteis.' * name: 'Componha rendimentos' text: 'Para acumular CDI no período, multiplique (1 + cdi\_diario/100) de cada dia útil.' *** import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > O CDI é o benchmark de quase tudo em renda fixa brasileira: CDB, > LCI/LCA, fundos DI, debêntures pós-fixadas. Mas a série bruta do BCB vem > em **% ao dia**, em uma escala que confunde quem espera "% ao ano". Este > post mostra como acessar o histórico completo via API e anualizar > corretamente com 252 dias úteis. Em 2026, com Selic a 14,5%, o CDI fica em torno de **0,054267% ao dia** — um número aparentemente minúsculo, mas que anualizado dá \~14,4% a.a. Essa diferença numérica é uma das fontes mais comuns de erro em calculadoras caseiras de rendimento. Aqui você aprende a acessar a série completa via brapi.dev, anualizar com a fórmula correta, comparar com a Selic e construir um simulador de CDB 100% CDI sem cair em armadilhas. *** ## CDI: o que é e por que importa **CDI (Certificado de Depósito Interbancário)** é a taxa praticada nos empréstimos diários entre bancos. Ela existe porque o regulador (BCB) proíbe bancos de fechar o dia com caixa negativo — quem está com sobra empresta para quem está em falta, e a taxa média dessas operações é o CDI. Por que ele é o benchmark da renda fixa? Porque é a **taxa de risco quase zero do mercado financeiro privado** — o equivalente da Selic Meta no universo bancário. Quase todo produto pós-fixado é precificado como **X% do CDI** (90%, 100%, 110%, etc.). | Comparativo | Selic Meta | CDI | | -------------------- | ------------------------------- | --------------------------------------------- | | **Quem define** | COPOM (BCB) | Operações entre bancos (calculado pela bolsa) | | **Frequência** | A cada 45 dias (reuniões COPOM) | Diária | | **Unidade no BCB** | % ao ano | % ao dia | | **Diferença típica** | — | Selic - 0,10 p.p. | A Selic Meta é a taxa-alvo dos títulos públicos federais (risco soberano, considerado o menor possível no Brasil). O CDI envolve operações entre bancos (risco bancário, ligeiramente maior). Esse pequeno *spread* (\~0,10 p.p.) é o prêmio de risco bancário sobre o soberano. *** ## A série `cdi` no `/api/v2/macro` A API da brapi.dev expõe o CDI como uma série de primeira classe (slug `cdi`), com dados desde **1986-03-06**: ```bash # Valor mais recente curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/macro/latest?symbols=cdi" ``` Resposta: ```json { "results": [ { "series": { "slug": "cdi", "name": "CDI", "description": "Certificado de Depósito Interbancário...", "unit": "percentPerDay", "frequency": "daily", "category": "interestRate", "startDate": "1986-03-06" }, "latest": { "date": "2026-04-30", "value": 0.054267 } } ], "requestedAt": "2026-04-30T12:00:00.000Z", "took": 12 } ``` A `unit` é **`percentPerDay`** — o número `0.054267` significa "0,054267% por dia útil", *não* 0,054267% ao ano. *** ## A regra de ouro: 252 dias úteis A anualização correta do CDI usa **252 dias úteis**, que é a convenção brasileira para taxas pós-fixadas. ``` cdi_anual = (1 + cdi_diario / 100) ** 252 - 1 ``` Em código: ```typescript function anualizarCDI(cdiDiarioPct: number): number { // Entrada: 0.054267 (% ao dia) // Saída: 14.40 (% ao ano) return (Math.pow(1 + cdiDiarioPct / 100, 252) - 1) * 100; } anualizarCDI(0.054267); // ~14.40 ``` Anualizar com 365 dias dá um número errado (\~21%). Bancos, bolsa e a CVM usam 252 — a quantidade média de dias úteis no ano. Isso é convenção: na prática, o CDI só é divulgado em dias úteis (sem fim de semana ou feriado), então 252 é o número que faz a multiplicação composta dar certo. ### Por que 252 e não 250 ou 254? Porque é a média que torna a fórmula consistente com como os produtos são calculados. CDBs, LCIs, fundos DI: todos usam 252. Sua planilha precisa seguir o mesmo padrão. *** ## Histórico completo do CDI Para baixar todo o histórico desde 1986: ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/macro?symbols=cdi&startDate=1986-03-06&endDate=2026-04-30&sortOrder=asc&limit=10000" ``` Você recebe \~10.000 observações diárias (uma por dia útil). Para gráfico de longo prazo, anualize cada ponto: ### TypeScript ```typescript type Observation = { date: string; value: number }; async function fetchCdiHistory(years: number): Promise { const today = new Date().toISOString().slice(0, 10); const start = new Date(); start.setFullYear(start.getFullYear() - years); const startDate = start.toISOString().slice(0, 10); const url = new URL('https://brapi.dev/api/v2/macro'); url.searchParams.set('symbols', 'cdi'); url.searchParams.set('startDate', startDate); url.searchParams.set('endDate', today); url.searchParams.set('sortOrder', 'asc'); url.searchParams.set('limit', '10000'); const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }, }); const { results } = await res.json(); return results[0]?.observations ?? []; } const series = await fetchCdiHistory(10); const cdiAnualizado = series.map((o) => ({ date: o.date, cdiDiario: o.value, cdiAnual: (Math.pow(1 + o.value / 100, 252) - 1) * 100, })); ``` ### Python ```python import os from datetime import date, timedelta import requests def cdi_history(years: int) -> list[dict]: end = date.today().isoformat() start = (date.today() - timedelta(days=365 * years)).isoformat() response = requests.get( 'https://brapi.dev/api/v2/macro', params={ 'symbols': 'cdi', 'startDate': start, 'endDate': end, 'sortOrder': 'asc', 'limit': 10000, }, headers={'Authorization': f"Bearer {os.environ['BRAPI_TOKEN']}"}, ) response.raise_for_status() obs = response.json()['results'][0]['observations'] return [ { 'date': o['date'], 'cdi_diario': o['value'], 'cdi_anual': ((1 + o['value'] / 100) ** 252 - 1) * 100, } for o in obs ] ``` *** ## Acumulação no período Para calcular **quanto rendeu R$ 1.000 a 100% do CDI no último ano**, não basta pegar o CDI atual e multiplicar — é preciso compor diariamente: ```typescript async function rendimento100CDI(capital: number, days: number) { const today = new Date().toISOString().slice(0, 10); const from = new Date(); from.setDate(from.getDate() - days); const startDate = from.toISOString().slice(0, 10); const res = await fetch( `https://brapi.dev/api/v2/macro?symbols=cdi&startDate=${startDate}&endDate=${today}&sortOrder=asc&limit=10000`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }, ); const { results } = await res.json(); const obs = results[0]?.observations ?? []; const fatorAcumulado = obs.reduce( (acc, o) => acc * (1 + o.value / 100), 1, ); return { capitalInicial: capital, capitalFinal: capital * fatorAcumulado, rendimentoBruto: capital * (fatorAcumulado - 1), pctNoPeriodo: (fatorAcumulado - 1) * 100, diasUteis: obs.length, }; } await rendimento100CDI(1000, 365); // { capitalInicial: 1000, capitalFinal: 1144, rendimentoBruto: 144, pctNoPeriodo: 14.4, diasUteis: 252 } ``` Para **CDB 110% CDI**, ajuste o fator diário: ```typescript const pctCdi = 1.10; const fatorAcumulado = obs.reduce( (acc, o) => acc * (1 + (o.value * pctCdi) / 100), 1, ); ``` *** ## Comparativo: Selic vs. CDI ```typescript async function compararSelicVsCdi() { const res = await fetch( 'https://brapi.dev/api/v2/macro/latest?symbols=selic,cdi', { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }, ); const { results } = await res.json(); const selic = results.find((r) => r.series.slug === 'selic')?.latest.value; const cdiDiario = results.find((r) => r.series.slug === 'cdi')?.latest.value; const cdiAnual = (Math.pow(1 + cdiDiario / 100, 252) - 1) * 100; return { selicMeta: selic, // Ex: 14.5 cdiDiario, // Ex: 0.054267 cdiAnualizado: cdiAnual, // Ex: 14.40 spreadCdiSelic: cdiAnual - selic, // Ex: -0.10 }; } ``` Esse "spread" é o prêmio de risco bancário sobre o soberano que mencionamos no início. Historicamente fica em **-0,10 p.p.**, mas em períodos de estresse (2020 COVID, 2022 fim de ciclo) pode variar. *** ## Aplicações práticas ### Calculadora "quanto rende R$ X em Y dias" Use a função `rendimento100CDI` acima. É o que toda fintech precisa para mostrar simulações na tela do CDB. ### Backtesting de fundos DI Compare o desempenho real do fundo (cota líquida) com o **CDI acumulado** no mesmo período. Se o fundo entregou 95% do CDI, há taxa de administração ou ineficiência consumindo o resto. ### Validação de extrato Multiplique o saldo inicial pelo **fator CDI acumulado** no período × o percentual contratado (100%, 110%, etc.) e compare com o saldo final do extrato. Se houver discrepância maior que 0,01%, há problema. ### Estimativa de rendimento líquido (CDB) ```typescript function rendimentoLiquidoCDB( capital: number, pctCdi: number, // ex: 1.10 para 110% CDI diasUteis: number, cdiAnualEstimado: number, // ex: 14.40 ) { const cdiDiarioEstimado = Math.pow(1 + cdiAnualEstimado / 100, 1 / 252) - 1; const fator = Math.pow(1 + cdiDiarioEstimado * pctCdi, diasUteis); const rendimentoBruto = capital * (fator - 1); // IR regressivo const dias = (diasUteis * 365) / 252; const ir = dias <= 180 ? 0.225 : dias <= 360 ? 0.20 : dias <= 720 ? 0.175 : 0.15; return { rendimentoBruto, ir: rendimentoBruto * ir, rendimentoLiquido: rendimentoBruto * (1 - ir), aliquotaIR: ir * 100, }; } ``` *** ## Erros comuns 1. **Anualizar com 365 dias.** Use 252 — convenção brasileira para taxas pós-fixadas. 2. **Confundir CDI Over com CDI taxa.** A série `cdi` da brapi é a CDI taxa (a oficial, divulgada pela bolsa brasileira). Em alguns sistemas você verá "CDI Over", que é a operação overnight em si — referencia o mesmo conceito. 3. **Comparar CDI com IPCA mensal.** Não dá: CDI é diário-anualizado, IPCA é mensal. Para compor real vs. nominal, anualize ambos primeiro. 4. **Esquecer dias úteis.** Sábados, domingos e feriados não têm CDI. Sua série terá \~252 pontos por ano, não 365. 5. **Aplicar IR sobre o capital inicial.** O IR só incide sobre o *rendimento*, nunca sobre o principal. *** ## Endpoints relacionados * 📊 [Documentação completa do `/api/v2/macro`](/docs/macro) * 🧮 [Como calcular juro real (Selic - IPCA)](/blog/como-calcular-juro-real-brasil-selic-ipca-api-2026) * 📚 [O que é CDI: Guia para iniciantes](/blog/o-que-e-cdi-guia-completo-2026) * 🇧🇷 [API de Macroeconomia: 15 indicadores BCB](/blog/api-macroeconomia-brasil-bcb-indicadores-2026) CDI é o benchmark mais usado em calculadoras de renda fixa brasileira. Acertar a anualização (252 dias) e a composição diária é a diferença entre um simulador profissional e um amador. Crie sua conta em [brapi.dev](https://brapi.dev), use a série `cdi` e pare de chutar. # Chainlink (LINK) e CCIP: A Espinha Dorsal da Web3 em 2026 URL: /blog/chainlink-link-ccip-rwa-guia-2026.mdx Chainlink (LINK) é essencial para RWAs, DeFi e Bancos. Guia completo sobre Oráculos, CCIP e Staking v0.2 ✓ *** searchable: true title: 'Chainlink (LINK) e CCIP: A Espinha Dorsal da Web3 em 2026' description: 'Chainlink (LINK) é essencial para RWAs, DeFi e Bancos. Guia completo sobre Oráculos, CCIP e Staking v0.2 ✓' date: '2025-12-27' keywords: 'chainlink link, ccip o que é, oráculos blockchain, swift chainlink, rwa chainlink, comprar link brasil, staking chainlink' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Criptomoedas' readingTime: '16 min' tags: \['Chainlink', 'LINK', 'Oracle', 'CCIP', 'Interoperabilidade', 'RWA'] relatedPosts: \['rwa-real-world-assets-tokenizacao-guia-2026', 'defi-financas-descentralizadas-guia-iniciantes-2026', 'ethereum-eth-guia-completo-brasil-2026'] featured: true expertise: 'Análise técnica da infraestrutura de oráculos e interoperabilidade bancária da Chainlink' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; No mundo das criptomoedas, muitas vezes focamos nas "estrelas do show" como Bitcoin e Solana. Mas nos bastidores, existe uma infraestrutura crítica sem a qual o DeFi, os RWAs e os mercados preditivos simplesmente não funcionariam. Essa infraestrutura é a **Chainlink**. Em 2026, a Chainlink deixou de ser "apenas um oráculo de preços" para se tornar a **plataforma padrão de conectividade** entre o sistema bancário global (Swift) e as blockchains públicas e privadas. Se você ouve falar de "tokenização de ativos reais" (RWA), você precisa entender o papel da Chainlink e seu protocolo CCIP. *** ## O Que é a Chainlink? (Além do Preço do ETH) Blockchains são sistemas isolados. O Ethereum não sabe o preço do Dólar, não sabe quem ganhou o jogo do Flamengo e não sabe se um título do tesouro foi emitido em Nova York. A **Chainlink** é uma rede descentralizada de oráculos. Ela pega dados do mundo real (off-chain), verifica sua veracidade através de consenso, e entrega para os contratos inteligentes (on-chain). ### A Evolução dos Serviços Chainlink 1. **Data Feeds (Price Feeds):** O serviço clássico. Fornece cotações seguras para Aave, Compound e Synthetix. Sem isso, o DeFi colapsaria. 2. **VRF (Verifiable Random Function):** Gera aleatoriedade comprovadamente justa para jogos e NFTs (sorteios, loots). 3. **Proof of Reserve (PoR):** Monitora reservas de stablecoins e ativos tokenizados (ex: monitorar se o ouro da PAXG realmente está no cofre). 4. **CCIP (O Grande Salto):** Protocolo de Interoperabilidade Cross-Chain. *** ## CCIP: A "Internet dos Contratos" O **CCIP (Cross-Chain Interoperability Protocol)** é a aposta mais ambiciosa da Chainlink. Imagine que o Bitcoin é o HTTP (transmissão de informação/valor simples) e o Ethereum é o HTML (programação). O CCIP aspira ser o **TCP/IP** — o protocolo padrão que conecta tudo. ### O Problema que Resolve Antes do CCIP, mover tokens de Ethereum para Avalanche exigia "Ponte (Bridges)" inseguras. Bilhões de dólares foram hackeados em bridges em 2021-2022. ### Como Funciona O CCIP permite enviar não apenas tokens, mas **mensagens e comandos** entre blockchains de forma segura. > **Exemplo Prático:** Um banco usa o sistema Swift para enviar uma mensagem instruindo a compra de um token na rede Polygon, que é então depositado em um protocolo DeFi na Arbitrum. Tudo em uma transação integrada via CCIP. ### Parceria com Swift e Bancos A Chainlink realizou testes bem-sucedidos com a **Swift** (sistema que conecta 11.000 bancos no mundo) e gigantes como **ANZ, BNP Paribas, BNY Mellon, Citi e Lloyds**. * **A Tese:** Bancos não vão reescrever seus sistemas para conectar em cada blockchain nova. Eles vão conectar seus sistemas legados ao CCIP, e o CCIP conecta a todas as blockchains. *** ## Chainlink e a Revolução RWA (Real World Assets) Para tokenizar trilhões de dólares em ativos reais (RWA), três coisas são necessárias, e a Chainlink fornece todas: 1. **Dados de Mercado:** "Quanto vale esse título agora?" (Chainlink Data Feeds). 2. **Identidade e Reservas:** "Esse token realmente tem lastro no banco?" (Chainlink Proof of Reserve). 3. **Movimentação:** "Como movo esse título da rede privada do banco para o Ethereum público?" (Chainlink CCIP). É por isso que a Chainlink é frequentemente citada como a principal beneficiária da onda institucional de 2026-2026. *** ## Tokenomics do LINK em 2026 (Staking v0.2) Uma crítica antiga ao token LINK era que ele não capturava valor. Isso mudou com o **Chainlink Staking v0.2**. ### Como o LINK captura valor agora? 1. **Pagamento de Serviços:** dApps e empresas pagam em LINK para usar os dados e o CCIP. 2. **Staking de Segurança:** Validadores (Node Operators) e investidores travam (stake) LINK para garantir a honestidade dos dados. Se agirem mal, perdem os tokens (slashing). 3. **BUILD Program:** Projetos novos dão uma % de seus tokens nativos para a Chainlink em troca de serviços, criando um fundo diversificado. *** ## Vale a Pena Investir em LINK? ### Cenário Otimista (Bull Case) * **Padrão Global:** O CCIP se torna o padrão global para interbancário cripto. O volume transacionado gera taxas massivas em LINK. * **Monopólio de Dados:** DeFi e RWA crescem 10x, e como a Chainlink tem quase monopólio de oráculos seguros, a demanda por LINK explode. * **ETF de LINK:** Com a clareza regulatória (LINK não foi considerado valor mobiliário em processos recentes), um ETF spot pode surgir. ### Cenário Pessimista (Bear Case) * **Concorrência:** Oráculos mais baratos (Pyth Network, API3) podem roubar market share em redes de alta velocidade como Solana. * **Internalização:** Grandes protocolos podem tentar criar seus próprios oráculos ("Oracle Extractable Value"). * **Complexidade:** A tecnologia é complexa e difícil de vender para o varejo ("não é sexy como uma memecoin"). *** ## Como Comprar e Armazenar LINK O LINK é um token ERC-20 (na rede Ethereum), mas também existe em versões nativas em Polygon, BNB Chain, etc. * **Onde Comprar:** Disponível em todas as corretoras brasileiras (MB, Binance BR, Foxbit). * **Onde Guardar:** Ledger, Trezor, MetaMask. * **Staking:** Você pode fazer staking nativo (se houver vagas no pool comunitário, que costuma lotar rápido) ou staking líquido em plataformas parceiras. ```typescript // Monitorando o preço da Chainlink (LINK) const response = await fetch( "https://brapi.dev/api/v2/crypto?coin=LINK¤cy=BRL", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); const link = data.coins[0]; // link.regularMarketPrice → Preço em BRL // link.regularMarketChangePercent → Variação 24h // link.marketCap → Capitalização de mercado ``` *** ## Conclusão A Chainlink não é o investimento que vai fazer 100x em uma semana como uma moeda meme. Ela é uma aposta "Blue Chip" na **infraestrutura** do mercado. Se você acredita que o futuro das finanças envolve bancos e blockchains conversando entre si e ativos reais sendo tokenizados, a Chainlink é, indiscutivelmente, a peça mais importante desse quebra-cabeça em 2026. *** ## Recursos Adicionais * **[RWA: O Futuro da Tokenização](/blog/rwa-real-world-assets-tokenizacao-guia-2026)** * **[Ethereum e Smart Contracts](/blog/ethereum-eth-guia-completo-brasil-2026)** * **[Stablecoins e Pagamentos](/blog/stablecoins-brasil-usdt-brz-drex-guia-2026)** *Disclaimer: Conteúdo informativo. Faça sua própria análise antes de investir.* # Bolsa em Tempo Real 2025: Como Monitorar Cotações e Oportunidades URL: /blog/como-acompanhar-a-bolsa-de-valores-em-tempo-real.mdx Domine o acompanhamento da bolsa em tempo real! Aprenda ferramentas, estratégias, alertas e análise para trading e investimentos na bolsa brasileira. Guia completo ✓ *** searchable: true title: 'Bolsa em Tempo Real 2025: Como Monitorar Cotações e Oportunidades' description: 'Domine o acompanhamento da bolsa em tempo real! Aprenda ferramentas, estratégias, alertas e análise para trading e investimentos na bolsa brasileira. Guia completo ✓' date: '2025-08-22' keywords: 'bolsa tempo real, cotações da bolsa brasileira, acompanhar ações, monitoring bolsa, tempo real cotações, análise técnica, alertas ações, mercado brasileiro, brapi' author: 'Equipe brapi.dev' category: 'Trading e Análise' subcategory: 'Monitoramento de Mercado' readingTime: '17 min' tags: \['Tempo Real', 'Bolsa Valores', 'Cotações', 'Trading', 'Bolsa Brasileira', 'Monitoramento', 'Alertas', 'API'] relatedPosts: \['b3-api-gratuita-como-usar-cotacoes', 'analise-fundamentalista-acoes-indicadores-essenciais-investir-b3', 'como-construir-carteira-investimentos-diversificada-brapi'] featured: true expertise: 'Trading e monitoramento de mercado com 8+ anos de experiência' lastReviewed: '2025-08-22' howToTools: \['Plataforma de cotações', 'API brapi.dev', 'Sistema de alertas'] howToSteps: * name: 'Escolha sua fonte de dados' text: 'Selecione uma plataforma confiável como brapi.dev para obter cotações atualizadas da bolsa brasileira.' * name: 'Configure seu watchlist' text: 'Crie uma lista com os ativos que deseja monitorar (ações, FIIs, ETFs).' * name: 'Defina alertas de preço' text: 'Configure notificações para quando os ativos atingirem níveis de preço específicos.' * name: 'Analise indicadores técnicos' text: 'Acompanhe médias móveis, volume e outros indicadores para identificar tendências.' * name: 'Tome decisões informadas' text: 'Use os dados em tempo real para executar operações no momento certo.' *** import { Author, Authors } from '~/components/Authors'; > No mundo dos investimentos, o tempo é dinheiro. Acompanhar as cotações em > tempo real é essencial para o sucesso nos investimentos. Neste guia, você > aprenderá como monitorar as cotações da bolsa de valores em tempo real e obter > informações atualizadas e oportunistas para tomadas de decisões estratégicas. ## A Relevância do Monitoramento das Cotações na Bolsa de Valores Em um mundo em que as manchetes econômicas como "Ibovespa bate novo recorde" ou "Dólar desaba para R$ 4,76" são rotineiras, surge a dúvida: como acompanhar a bolsa de valores em tempo real? Este guia detalhado apresentará várias maneiras de monitorar as cotações da bolsa de valores, proporcionando aos investidores e traders informações atualizadas e oportunistas para tomadas de decisões estratégicas. ### As Melhores Ferramentas para Consultar Ações na Bolsa de Valores 1. **Home Brokers** * São plataformas oferecidas por corretoras de valores que permitem acompanhar as cotações em tempo real e realizar negociações de maneira segura. 2. **Sites** * Apesar de alguns apresentarem um pequeno atraso nas cotações, são excelentes para acompanhar as bolsas mundiais. Recomendamos o uso da [brapi.dev](https://brapi.dev/quotes) para obter informações atualizadas. 3. **Plataformas Profissionais** * Comumente utilizadas por traders profissionais, estas plataformas fornecem dados em tempo real, ferramentas analíticas avançadas e garantem a precisão dos dados. 4. **Aplicativos para Smartphones** * As versões móveis das plataformas profissionais oferecem a flexibilidade de acompanhar as cotações em tempo real de qualquer lugar. A [brapi.dev](https://brapi.dev/quotes) oferece uma versão mobile completa. ### Por que Monitorar as Cotações em Tempo Real é Essencial? O mercado financeiro é extremamente volátil e influenciado por eventos globais e notícias. O acompanhamento das cotações em tempo real permite uma resposta rápida a essas variações, minimizando riscos e otimizando as decisões de compra ou venda de ações. ### Acompanhamento do Mercado: Esteja Sempre Alerta! Um exemplo real: ao perceber que as ações da [Gol Linhas Aéreas (GOLL4)](https://brapi.dev/quote/GOLL4) estão em queda, Daniel decide vender rapidamente suas ações para garantir o lucro. O acesso a uma plataforma de cotações precisa e atualizada é crucial para evitar perdas e maximizar os ganhos. ### Esteja Sempre Preparado para as Oscilações do Mercado! As vantagens de usar ferramentas para acompanhar as cotações em tempo real são diversas: * **Oportunidade:** Capacidade de agir imediatamente frente às oportunidades do mercado. * **Prevenção:** Estar preparado para as flutuações do mercado. * **Agilidade:** Agir de maneira rápida e eficiente. * **Conhecimento:** Familiarizar-se com os produtos e movimentos do mercado financeiro. ### Como Escolher a Ferramenta Ideal? A escolha da ferramenta de acompanhamento depende do perfil do investidor. Para aqueles que buscam conveniência, os aplicativos móveis são uma excelente escolha. As Plataformas Profissionais, por outro lado, são indicadas para quem necessita de análises mais profundas. Em resumo, acompanhar a bolsa de valores em tempo real é essencial para o sucesso nos investimentos. Experimente a **brapi** para ter uma experiência completa no monitoramento das cotações, seja no computador ou no smartphone. ### Perguntas Frequentes #### **1. Como acompanhar a bolsa de valores em tempo real?** * Com o uso de Home Brokers, sites, plataformas profissionais ou aplicativos para smartphones, como a **brapi**, você pode acompanhar a bolsa de valores em tempo real. Experimente a [brapi.dev/quotes](https://brapi.dev/quotes) para ter acesso a cotações atualizadas. #### **2. Como consultar ações na bolsa de valores?** * Os Home Brokers e as Plataformas Profissionais são muito eficazes para consultar e negociar ações em tempo real. Recomendamos verificar a lista completa de ações disponível [aqui](https://brapi.dev/quotes). #### **3. Onde posso encontrar a lista de ações por preço?** * Você pode consultar Home Brokers ou Plataformas Profissionais para encontrar listas atualizadas de ações de empresas. Recomendamos verificar a lista disponível [aqui](https://brapi.dev/quotes). #### **4. Como acompanhar a bolsa de valores em tempo real de graça?** * Existem sites e plataformas profissionais que oferecem gráficos de ações em tempo real gratuitamente. Experimente a [brapi.dev/quotes](https://brapi.dev/quotes) para ter acesso a cotações atualizadas. #### **5. Quanto custa uma ação da Klabin?** * Consulte as cotações em tempo real disponíveis em Home Brokers e Plataformas Profissionais para saber o valor atualizado da [ação da Klabin](https://brapi.dev/quote/KLBN11). #### **6. Quanto custa uma ação da Magalu?** * Consulte as cotações em tempo real disponíveis em Home Brokers e Plataformas Profissionais para saber o valor atualizado da [ação da Magazine Luiza (MGLU3)](https://brapi.dev/quote/MGLU3). Experimente agora a **brapi** para ter uma experiência completa no acompanhamento das cotações da bolsa de valores em tempo real. Além disso, a **brapi** oferece acesso a todos os dados do mercado financeiro através de uma API completa e de fácil utilização. Acesse a [documentação](https://brapi.dev/docs) para saber mais. # Como analisar uma ação sem se perder nos indicadores URL: /blog/como-analisar-acoes-guia-iniciantes-2026.mdx Um processo para entender o negócio, ler os números, avaliar riscos e comparar o preço sem depender de uma nota mágica. *** searchable: true title: 'Como analisar uma ação sem se perder nos indicadores' description: 'Um processo para entender o negócio, ler os números, avaliar riscos e comparar o preço sem depender de uma nota mágica.' date: '2026-01-01' keywords: 'como analisar acoes, analise fundamentalista, indicadores acoes, P/L, P/VP, ROE, dividend yield, valuation, como escolher acoes' author: 'Alisson Leal' category: 'Análise de Investimentos' subcategory: 'Análise de Ações' readingTime: '11 min' tags: \['Análise Fundamentalista', 'Indicadores', 'Valuation', 'P/L', 'ROE', 'Iniciantes'] relatedPosts: \['o-que-sao-acoes-guia-iniciantes-2026', 'carteira-de-acoes-como-montar-diversificar', 'analise-fundamentalista-acoes-indicadores-essenciais-investir-b3', 'como-ler-balanco-patrimonial'] featured: true expertise: 'Análise de ações e dados fundamentalistas' lastReviewed: '2026-06-23' faqSchema: * question: 'Qual é o melhor indicador para analisar uma ação?' answer: 'Nenhum indicador resolve a análise sozinho. O valor de P/L, ROE, dívida ou dividend yield só ganha sentido quando comparado ao setor, ao histórico e à qualidade do lucro.' * question: 'P/L baixo significa ação barata?' answer: 'Não necessariamente. Pode refletir lucro temporariamente alto, risco, dívida, queda esperada ou um negócio em deterioração.' * question: 'Preciso calcular um preço justo exato?' answer: 'Não. Trabalhar com cenários e uma faixa de valor costuma ser mais honesto do que fingir precisão com uma única estimativa.' *** import { Authors, Author } from '~/components/Authors'; Analisar uma ação não é preencher uma tabela até ela dizer "compre". O trabalho é entender como a empresa ganha dinheiro, quais riscos podem quebrar a tese e quanto do futuro já está embutido no preço. ## Comece nesta ordem ## 1. Explique o negócio em poucas linhas Se você não consegue explicar de onde vem a receita, ainda não chegou aos indicadores. Pergunte: * quem é o cliente; * por que ele escolhe essa empresa; * como os preços são definidos; * quais custos mais afetam a margem; * quanto o setor depende de juros, câmbio ou commodities; * o que um concorrente precisaria fazer para roubar mercado. Leia o formulário de referência, as apresentações de resultados e os fatos relevantes na página de relações com investidores. Não dependa apenas de sites que resumem números. ## 2. Olhe uma série, não um trimestre Um resultado isolado pode ser afetado por venda de ativo, crédito tributário, câmbio ou outra receita que não se repete. Comece com cinco perguntas: | Pergunta | Números úteis | | ------------------------------ | ---------------------------------- | | A operação cresce? | Receita e volume | | Cresce com qualidade? | Margens e lucro operacional | | O lucro vira dinheiro? | Fluxo de caixa operacional e livre | | O balanço aguenta um ano ruim? | Caixa, dívida, juros e vencimentos | | O capital rende bem? | ROE ou ROIC ao longo do tempo | Uma empresa pode aumentar lucro enquanto consome caixa. Outra pode mostrar ROE alto porque tem patrimônio pequeno ou dívida elevada. A relação entre os números importa mais que um valor isolado. ## 3. Use indicadores como perguntas ### P/L O preço sobre lucro compara o valor da ação ao lucro por ação. P/L baixo pode significar preço baixo. Também pode significar lucro cíclico no pico, risco elevado ou queda esperada. Compare com empresas do mesmo setor e com o histórico do próprio negócio. ### P/VP O preço sobre valor patrimonial tende a ser mais informativo em negócios nos quais o balanço representa bem os ativos, como parte do setor financeiro. Em empresas de software, marcas ou serviços, boa parte do valor pode não aparecer no patrimônio contábil. ### ROE e ROIC ROE mede o lucro em relação ao patrimônio. ROIC tenta medir o retorno sobre o capital empregado na operação. Retornos altos são interessantes quando persistem sem dívida excessiva e sem depender de um evento isolado. ### Dívida líquida sobre EBITDA Ajuda a observar alavancagem, mas EBITDA não é caixa disponível para pagar dívida. Empresas intensivas em investimento podem ter despesas relevantes fora dessa conta. Veja também juros pagos, fluxo de caixa, moeda da dívida e calendário de vencimentos. ### Dividend yield Dividend yield olha para os proventos passados em relação ao preço atual. Yield alto pode vir de um pagamento extraordinário ou de uma queda forte na cotação. Confira lucro, caixa, payout e necessidade de investimento antes de projetar o mesmo valor para o futuro. ## Não existe tabela universal de valores bons O texto anterior dizia que P/L abaixo de 15, P/VP abaixo de 1,5, ROE acima de 15% e dívida abaixo de 2 vezes EBITDA formavam uma boa ação. Esses cortes misturam setores e ciclos diferentes. Um banco, uma transmissora de energia e uma mineradora não podem ser avaliados com a mesma régua. Use comparações em três direções: 1. empresa contra o próprio histórico; 2. empresa contra concorrentes semelhantes; 3. número atual contra o cenário econômico e operacional. ## 4. Leia o fluxo de caixa Lucro contábil é importante, mas o caixa mostra o que aconteceu com o dinheiro. Observe: * caixa gerado pela operação; * investimento necessário para manter e crescer; * aquisições; * juros; * dividendos e recompras; * emissão ou pagamento de dívida. Uma empresa que precisa captar dinheiro todos os anos para sustentar dividendos merece atenção. ## 5. Escreva os riscos antes do preço justo Uma tese sem motivo para estar errada é propaganda. Liste riscos específicos: | Tipo | Exemplo de pergunta | | ----------- | --------------------------------------------------------- | | Operacional | A margem depende de um insumo volátil? | | Financeiro | A dívida vence antes de o projeto gerar caixa? | | Regulatório | Uma tarifa ou concessão pode mudar? | | Governança | O controlador tem interesses diferentes dos minoritários? | | Valuation | O preço exige crescimento difícil de entregar? | Depois escreva o que faria você abandonar a tese. Uma queda de preço, sozinha, não é uma tese quebrada. Perda de vantagem competitiva, fraude, alavancagem fora do plano ou deterioração estrutural podem ser. ## 6. Trabalhe com cenários Fluxo de caixa descontado e múltiplos podem ajudar, mas não produzem um valor científico. Monte ao menos três cenários: | Cenário | Receita e margem | Risco | Resultado esperado | | ----------- | ------------------------------------------- | ----- | -------------------- | | Conservador | Crescimento baixo e pressão de margem | Alto | Faixa de valor menor | | Base | Premissas próximas ao histórico sustentável | Médio | Faixa central | | Otimista | Crescimento e retorno elevados | Baixo | Faixa maior | Se a ação só parece barata no cenário otimista, a margem para erro é pequena. Evite misturar médias de setor sem entender composição e ciclo. Um múltiplo médio pode estar alto porque o setor está no pico ou baixo porque todo o grupo enfrenta um problema. ## 7. Análise técnica é outro tipo de pergunta Análise fundamentalista tenta entender negócio e valor. Análise técnica observa preço e volume. Médias móveis, suportes e RSI não corrigem uma tese ruim e não garantem ponto de entrada. Se você usa gráficos, defina separadamente o objetivo, o horizonte e a regra de risco. Não use um cruzamento de médias como confirmação automática de valor. ## Consultando dados com a brapi ```typescript const response = await fetch( "https://brapi.dev/api/quote/PETR4?modules=defaultKeyStatistics,financialData", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); const stock = results[0]; ``` A API reduz o trabalho de coleta. A interpretação continua sendo sua. Confirme números importantes nos documentos da empresa, principalmente após eventos societários ou resultados recentes. ## Checklist curto * [ ] Entendo como a empresa ganha dinheiro. * [ ] Li resultados de vários anos. * [ ] Comparei lucro com fluxo de caixa. * [ ] Entendi dívida e vencimentos. * [ ] Comparei indicadores com pares adequados. * [ ] Escrevi os riscos e a condição de saída. * [ ] Testei mais de um cenário de valor. * [ ] Sei quanto essa posição pode representar na carteira. Depois da análise individual, leia [como montar uma carteira de ações](/blog/carteira-de-acoes-como-montar-diversificar). Para aprofundar os demonstrativos, veja [como ler um balanço patrimonial](/blog/como-ler-balanco-patrimonial). ## Fontes [CVM: informações de companhias](https://www.gov.br/cvm/pt-br/assuntos/regulados/consultas-por-participante/companhias) · [B3: empresas listadas](https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/renda-variavel/empresas-listadas.htm) *Conteúdo educacional. Nenhum indicador elimina o risco de perda.* # Como Calcular o Juro Real do Brasil via API (Selic - IPCA): Fórmula e Código (2026) URL: /blog/como-calcular-juro-real-brasil-selic-ipca-api-2026.mdx Aprenda a fórmula correta do juro real (Fisher), por que somar não funciona, e como calcular automaticamente em TypeScript ou Python usando Selic e IPCA12m via API brapi.dev. *** searchable: true title: 'Como Calcular o Juro Real do Brasil via API (Selic - IPCA): Fórmula e Código (2026)' description: 'Aprenda a fórmula correta do juro real (Fisher), por que somar não funciona, e como calcular automaticamente em TypeScript ou Python usando Selic e IPCA12m via API brapi.dev.' date: '2026-05-04' keywords: 'juro real brasil, como calcular juro real, formula juro real, selic menos ipca, juro real ex-ante, juro real api, taxa real de juros brasil, fisher juro real' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Macroeconomia' readingTime: '9 min' tags: \['Juro Real', 'Selic', 'IPCA', 'Fisher', 'API', 'TypeScript', 'Python'] relatedPosts: \['api-macroeconomia-brasil-bcb-indicadores-2026', 'cdi-historico-api-renda-fixa-benchmark-2026', 'indicadores-economicos-brasil-selic-ipca-igpm-impacto-investimentos'] featured: true expertise: 'Cálculo de juro real ex-ante via Selic e IPCA acumulado em 12 meses' lastReviewed: '2026-05-04' howToTools: * 'Calculadora ou planilha (Excel, Google Sheets)' * 'API brapi.dev (/api/v2/macro)' howToSteps: * name: 'Obtenha a Selic atual' text: 'Use GET /api/v2/macro/latest?symbols=selic. O valor é em % ao ano (ex: 14,5).' * name: 'Obtenha o IPCA acumulado em 12 meses' text: 'Use GET /api/v2/macro/latest?symbols=ipca12m. O valor é em % (já acumulado).' * name: 'Aplique a fórmula de Fisher' text: 'juro\_real = ((1 + selic/100) / (1 + ipca/100) - 1) \* 100. NÃO subtraia diretamente — o erro pode ser de até 1 ponto percentual.' * name: 'Compare com o juro neutro' text: 'O juro neutro brasileiro está estimado em \~5% pelo BCB. Acima disso, política monetária é contracionista.' *** import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > Você abre o jornal e lê: "*Brasil tem o maior juro real do mundo*". O que > isso significa, e como calcular para sua carteira? A fórmula correta usa > a equação de Fisher, não uma simples subtração. Mostramos como — e como > automatizar usando a API da brapi.dev em uma única requisição. Em 2026, com Selic a 14,5% e IPCA12m em \~4%, todo investidor brasileiro quer saber: *quanto, de verdade, meu dinheiro está rendendo acima da inflação?* A resposta é o **juro real**, e a maioria das pessoas calcula errado. Este post explica a fórmula correta, mostra o erro comum, e dá o código pronto para você integrar a API da brapi.dev em sua calculadora ou dashboard. *** ## Juro nominal vs. juro real **Juro nominal** é a taxa que aparece no produto: Selic 14,5% a.a., CDB 110% do CDI, Tesouro Selic = Selic, etc. **Juro real** é o que sobra depois de descontar a inflação. É o quanto seu poder de compra cresceu de verdade. Exemplo intuitivo: se sua Selic rendeu 14,5% no ano e os preços subiram 4%, seu poder de compra cresceu *aproximadamente* 10,5% — mas a conta exata não é uma subtração simples. *** ## A fórmula correta: equação de Fisher A relação entre taxas nominais (`i`), reais (`r`) e inflação (`π`) é: ``` (1 + r) = (1 + i) / (1 + π) ``` Isolando `r`: ``` r = ((1 + i) / (1 + π)) - 1 ``` Em código: ```typescript function juroReal(taxaNominal: number, inflacao: number): number { // Ambas em % (ex: 14.5 e 4.14) return ((1 + taxaNominal / 100) / (1 + inflacao / 100) - 1) * 100; } juroReal(14.5, 4.14); // 9.95 (aprox. 9,95% a.a.) ``` A aproximação `r ≈ i - π` (chamada **Fisher linearizada**) só funciona com inflações próximas de zero. Com IPCA acima de 4%, o erro pode chegar a 1 ponto percentual: | Selic | IPCA | Subtração ingênua | Fisher correto | Diferença | | ----- | ----- | ----------------- | -------------- | --------- | | 14,5% | 4,14% | 10,36% | **9,95%** | 0,41 p.p. | | 13% | 5% | 8,00% | **7,62%** | 0,38 p.p. | | 9% | 10% | -1,00% | **-0,91%** | 0,09 p.p. | Para fundos profissionais, planilhas de risco e tarifas regulatórias, sempre use a fórmula completa. *** ## Juro real ex-ante vs. ex-post Existem dois "juros reais" e eles **respondem perguntas diferentes**: ### Juro real ex-ante (a expectativa) Calculado com a Selic atual e a inflação **esperada** (IPCA12m projetado pelo Focus, ou IPCA12m realizado como proxy). É o que o investidor olha para decidir entre Tesouro Selic e Tesouro IPCA+. ### Juro real ex-post (o que de fato aconteceu) Calculado depois do período, com a inflação realizada. É o que aparece no seu extrato no fim do ano. A API da brapi.dev fornece `ipca12m` (acumulado em 12 meses, *realizado*), que é a melhor proxy para o ex-ante quando você não tem assinatura do relatório Focus. Para o ex-post mensal, use `ipca` (variação do mês) e componha a inflação acumulada. *** ## Cálculo em uma única requisição: API brapi.dev A maneira mais limpa de obter Selic + IPCA12m simultaneamente é via `/api/v2/macro/latest`. Uma única chamada, dois indicadores: ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/macro/latest?symbols=selic,ipca12m" ``` Resposta: ```json { "results": [ { "series": { "slug": "selic", "name": "Taxa Selic", "unit": "percentPerYear" }, "latest": { "date": "2026-04-30", "value": 14.5 } }, { "series": { "slug": "ipca12m", "name": "IPCA 12 meses", "unit": "percent" }, "latest": { "date": "2026-03-01", "value": 4.14 } } ], "requestedAt": "2026-04-30T12:00:00.000Z", "took": 18 } ``` ### TypeScript: calculadora pronta ```typescript type MacroLatest = { results: Array<{ series: { slug: string; name: string; unit: string }; latest: { date: string; value: number } | null; }>; }; async function getJuroRealAtual() { const res = await fetch( 'https://brapi.dev/api/v2/macro/latest?symbols=selic,ipca12m', { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }, ); const data: MacroLatest = await res.json(); const selic = data.results.find((r) => r.series.slug === 'selic')?.latest?.value; const ipca = data.results.find((r) => r.series.slug === 'ipca12m')?.latest?.value; if (selic == null || ipca == null) { throw new Error('Série indisponível'); } const juroReal = ((1 + selic / 100) / (1 + ipca / 100) - 1) * 100; return { selic, ipca12m: ipca, juroRealEx_ante: Number(juroReal.toFixed(2)), }; } ``` ### Python ```python import os import requests def juro_real_atual() -> dict: response = requests.get( 'https://brapi.dev/api/v2/macro/latest', params={'symbols': 'selic,ipca12m'}, headers={'Authorization': f"Bearer {os.environ['BRAPI_TOKEN']}"}, ) response.raise_for_status() series = {item['series']['slug']: item['latest']['value'] for item in response.json()['results'] if item['latest']} selic = series['selic'] ipca = series['ipca12m'] juro_real = ((1 + selic / 100) / (1 + ipca / 100) - 1) * 100 return { 'selic': selic, 'ipca12m': ipca, 'juro_real_ex_ante': round(juro_real, 2), } ``` *** ## Análise histórica do juro real Para comparar com o passado, traga **séries históricas** da Selic e do IPCA12m: ```typescript async function juroRealHistorico(years: number) { const today = new Date().toISOString().slice(0, 10); const from = new Date(); from.setFullYear(from.getFullYear() - years); const startDate = from.toISOString().slice(0, 10); const res = await fetch( `https://brapi.dev/api/v2/macro?symbols=selic,ipca12m&startDate=${startDate}&endDate=${today}&sortOrder=asc&limit=10000`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }, ); const { results } = await res.json(); const selic = results.find((r) => r.series.slug === 'selic').observations; const ipca = results.find((r) => r.series.slug === 'ipca12m').observations; // Selic é diária; IPCA12m é mensal. Use o IPCA do mês para cada ponto da Selic. const ipcaByMonth = new Map(); for (const o of ipca) { ipcaByMonth.set(o.date.slice(0, 7), o.value); } return selic.map((s) => { const ipcaVal = ipcaByMonth.get(s.date.slice(0, 7)); if (ipcaVal == null) return null; return { date: s.date, selic: s.value, ipca12m: ipcaVal, juroReal: ((1 + s.value / 100) / (1 + ipcaVal / 100) - 1) * 100, }; }).filter((x): x is NonNullable => x !== null); } ``` Plote o array `juroReal` em uma biblioteca de charting para ver a evolução histórica. Em ciclos de aperto monetário (como 2022-2023 e 2025-2026), o juro real brasileiro fica nas alturas (\~9-10% a.a.); em ciclos de afrouxamento ele cai para \~3-4%. *** ## O juro real do Brasil é "alto" ou "normal"? Para responder, compare com: ### O juro neutro O **juro neutro** é o nível de juros real que não estimula nem desacelera a economia. O BCB estima em **\~5% a.a.** para o Brasil (acima da média emergente, devido à carga fiscal e prêmio de risco). * **Juro real > 5%:** política monetária contracionista (segura inflação, esfria atividade) * **Juro real ≈ 5%:** neutro * **Juro real \< 5%:** política expansionista (estimula crédito e atividade) Em maio de 2026, com juro real ex-ante de \~9,95%, estamos em território **fortemente contracionista** — coerente com a meta do COPOM de fazer o IPCA convergir. ### Juro real internacional | País | Juro real aprox. (2026) | | ------------ | ----------------------- | | Brasil | 9-10% | | México | 5-6% | | EUA | 1,5-2% | | Zona do Euro | 0-0,5% | | Japão | -1% | Esse diferencial é o que atrai *carry trade* internacional para títulos soberanos brasileiros — e também o que torna a Selic um benchmark difícil de bater para investimentos em ações. *** ## Implicações para sua carteira | Cenário | Juro real ex-ante | Decisão tradicional | | -------- | ----------------------------------------------------- | --------------------- | | > 8% | Renda fixa pré-fixada e Tesouro Selic muito atrativos | Aumentar RF | | 4-8% | Equilíbrio: renda fixa + ações faz sentido | Diversificar | | \< 4% | Renda variável e ativos reais ganham apelo relativo | Reduzir RF | | Negativo | Cenário raro; foque em IPCA+ e ativos reais | Hedge contra inflação | Quando o juro real ex-ante está alto, o **Tesouro IPCA+ longo** trava esse juro alto por décadas. Já o **Tesouro Selic** acompanha as quedas futuras. Em 2026 (juro real \~10%), travar IPCA+ longo é uma das estratégias clássicas. *** ## Erros comuns 1. **Subtrair em vez de aplicar Fisher.** Erro de até 1 p.p. com inflação alta — significativo em comparações de produtos. 2. **Comparar Selic anual com IPCA mensal.** Sempre use IPCA acumulado em 12 meses (`ipca12m`), nunca o mensal (`ipca`). 3. **Usar Selic Meta vs. Selic Overnight inconsistentemente.** Para benchmark de Tesouro Selic, use a Selic Meta (`selic`). A Overnight (`selicovernight`) é para cálculos do CDI e do mercado interbancário. 4. **Esquecer impostos.** O juro real líquido considera IR sobre o rendimento. Em CDB, o IR regressivo (15-22,5%) reduz o juro real significativamente em prazos curtos. 5. **Usar IGP-M no lugar do IPCA.** O IGP-M (`igpm`) é mais volátil e reflete preços ao produtor. Para carteiras de varejo, use IPCA12m. *** ## Endpoints relacionados * 📊 [API de Macroeconomia (`/api/v2/macro`)](/docs/macro) * 📈 [Documentação completa dos slugs (Selic, IPCA, CDI...)](/docs/macro/available) * 💰 [CDI histórico via API](/blog/cdi-historico-api-renda-fixa-benchmark-2026) * 🌎 [API de Macroeconomia: 15 indicadores BCB](/blog/api-macroeconomia-brasil-bcb-indicadores-2026) A próxima vez que alguém disser "*o juro real do Brasil tá em X%*", você saberá conferir em uma única requisição. Crie sua conta em [brapi.dev](https://brapi.dev) e teste. # ROIC 2025: Como Calcular Return on Invested Capital com API URL: /blog/como-calcular-o-roic-usando-a-api-da-brapi.mdx Domine o ROIC para análise de eficiência! Aprenda calcular Return on Invested Capital, interpretar resultados e implementar com API brapi. Guia completo ✓ *** searchable: true title: 'ROIC 2025: Como Calcular Return on Invested Capital com API' description: 'Domine o ROIC para análise de eficiência! Aprenda calcular Return on Invested Capital, interpretar resultados e implementar com API brapi. Guia completo ✓' date: '2025-08-22' keywords: 'ROIC, return on invested capital, retorno capital investido, eficiência capital, análise fundamentalista, API brapi, cálculo ROIC, bolsa brasileira, brapi' author: 'Equipe brapi.dev' category: 'Análise Fundamentalista' subcategory: 'Indicadores de Eficiência' readingTime: '15 min' tags: \['ROIC', 'Análise Fundamentalista', 'Capital', 'Eficiência', 'Bolsa Brasileira', 'API', 'Cálculo', 'Performance'] relatedPosts: \['roe-retorno-sobre-patrimonio-como-analisar', 'b3-api-gratuita-como-usar-cotacoes', 'analise-fundamentalista-acoes-indicadores-essenciais-investir-b3'] featured: true expertise: 'Análise de eficiência de capital com 8+ anos de experiência no mercado brasileiro' lastReviewed: '2025-08-22' howToTools: \['API brapi.dev', 'Calculadora', 'Planilha de análise'] howToSteps: * name: 'Obtenha o EBIT da empresa' text: 'Use o módulo income-statement da API para extrair o lucro operacional (EBIT).' * name: 'Calcule o capital investido' text: 'Some patrimônio líquido + dívida líquida usando dados do balance-sheet.' * name: 'Aplique a fórmula do ROIC' text: 'Divida o NOPAT (EBIT × (1 - alíquota IR)) pelo capital investido.' * name: 'Compare com o custo de capital' text: 'Um ROIC maior que o WACC indica que a empresa cria valor para acionistas.' * name: 'Analise a tendência histórica' text: 'Verifique se o ROIC está crescendo ou diminuindo ao longo dos anos.' *** import { Authors, Author } from '~/components/Authors'; > Recentemente, recebemos uma pergunta de um de nossos usuários, que estava > consultando os dados retornados pela nossa API e queria saber se era possível > calcular ou obter a receita líquida e o ROIC (Return on Invested Capital). Mas e aí, dá pra calcular isso com os dados da brapi? A resposta é sim, é possível calcular esses valores usando os dados fornecidos pela API da brapi. Embora não tenhamos um endpoint que faça esses cálculos automaticamente, você pode facilmente pegar os dados necessários e fazer os cálculos por conta própria. ## O que é Receita Líquida e ROIC? A receita líquida é a receita total de uma empresa menos os custos associados à geração dessa receita. Na brapi, acreditamos que a receita líquida pode ser interpretada como a Receita de Venda de Bens e/ou Serviços ou o Resultado Bruto. Esses dados podem ser encontrados no módulo `incomeStatementHistory` da nossa API. O ROIC, por outro lado, é uma métrica que determina a eficiência com que uma empresa está usando seu capital para gerar lucros. É calculado dividindo o NOPAT (Net Operating Profit After Tax) pelo capital investido. ## Como Calcular o ROIC? Para calcular o ROIC, você precisa primeiro calcular o NOPAT e o Capital Investido. ### Cálculo do NOPAT O NOPAT pode ser calculado de duas maneiras: 1. Multiplicando o `operatingIncome` por (1 - tax rate) 2. Subtraindo o `incomeTaxExpense` do `EBIT` Ambos os métodos fornecerão resultados ligeiramente diferentes, mas ambos são aceitáveis. A fórmula para calcular o NOPAT usando o `operatingIncome` é: ```math NOPAT = operatingIncome \times (1 - taxRate) ``` onde `taxRate` é a taxa de imposto efetiva da empresa. ```math taxRate = \frac{incomeTaxExpense}{incomeBeforeTax} ``` E a fórmula para calcular o NOPAT usando o `EBIT` é: ```math NOPAT = EBIT - incomeTaxExpense ``` ### Cálculo do Capital Investido O Capital Investido pode ser calculado subtraindo `accountsPayable` e `cash` do `totalAssets`. A fórmula para calcular o Capital Investido é: ```math CapitalInvestido = totalAssets - accountsPayable - cash ``` ### Cálculo do ROIC Finalmente, o ROIC pode ser calculado dividindo o NOPAT pelo Capital Investido. A fórmula para calcular o ROIC é: ```math ROIC=\frac{NOPAT}{CapitalInvestido} ``` ## Exemplo de Cálculo do ROIC Vamos usar a PETR4 como exemplo. Os dados necessários podem ser encontrados nos módulos `balanceSheetHistory` e `incomeStatementHistory` da nossa API. ### Dados da PETR4 (Petrobras) Acho que essa é parte mais fácil, né? Basta fazer uma requisição para a API da brapi e obter os dados da PETR4. Ex: `https://brapi.dev/api/quote/PETR4?modules=balanceSheetHistory,incomeStatementHistory` com o header `Authorization: Bearer SEU_TOKEN` ```json curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/AAPL?modules=balanceSheetHistory,incomeStatementHistory" { ... "balanceSheetHistory": { "balanceSheetStatements": [ { "endDate": "2022-12-31T00:00:00.000Z", // Data de Encerramento "cash": 41723000000, // Caixa e Equivalentes de Caixa "shortTermInvestments": 14470000000, // Aplicações Financeiras "netReceivables": 32961000000, // Contas a Receber "inventory": 45804000000, // Estoques "otherCurrentAssets": 28094000000, // Outros Ativos Circulantes "totalCurrentAssets": 163052000000, // Ativo Circulante "longTermInvestments": 16331000000, // Investimentos a Longo Prazo "propertyPlantEquipment": 679182000000, // Imobilizado "goodWill": 123000000, // Goodwill "intangibleAssets": 15458000000, // Ativos Intangíveis "otherAssets": 102563000000, // Outros Ativos "deferredLongTermAssetCharges": 4342000000, // Encargos de Ativos Diferidos a Longo Prazo "totalAssets": 976709000000, // Ativo Total "accountsPayable": 28507000000, // Contas a Pagar "shortLongTermDebt": 18656000000, // Dívida de Curto e Longo Prazo "otherCurrentLiab": 60989000000, // Outras Obrigações Correntes "longTermDebt": 137630000000, // Dívida de Longo Prazo "otherLiab": 215540000000, // Outras Obrigações "minorityInterest": 1791000000, // Interesse Minoritário "totalCurrentLiabilities": 163731000000, // Passivo Circulante "totalLiab": 612324000000, // Passivo Total "commonStock": 205432000000, // Ações Ordinárias "retainedEarnings": 128562000000, // Lucros Retidos "treasuryStock": 28600000000, // Ações em Tesouraria "otherStockholderEquity": 28600000000, // Outros Patrimônios de Acionistas "totalStockholderEquity": 362594000000, // Patrimônio Líquido Total "netTangibleAssets": 347013000000 // Ativos Tangíveis Líquidos } // + outros anos ou trimestres ] }, "incomeStatementHistory": { "incomeStatementHistory": [ { "endDate": "2022-12-31T00:00:00.000Z", // Data de encerramento "totalRevenue": 641256000000, // Receita de Venda de Bens e/ou Serviços "costOfRevenue": 307156000000, // Custo dos Bens e/ou Serviços Vendidos "grossProfit": 334100000000, // Resultado Bruto "researchDevelopment": 4087000000, // Custos com pesquisa e desenvolvimento tecnológico "sellingGeneralAdministrative": 32325000000, // Despesas Gerais e Administrativas "nonRecurring": null, // Perdas pela Não Recuperabilidade de Ativos "otherOperatingExpenses": -10922000000, // Outras Despesas Operacionais "totalOperatingExpenses": 337728000000, // Despesas/Receitas Operacionais "operatingIncome": 303528000000, // Resultado Antes do Resultado Financeiro e dos Tributos "totalOtherIncomeExpenseNet": -28530000000, // Resultado Financeiro "ebit": 303528000000, // Resultado Antes dos Tributos sobre o Lucro (EBIT - Earnigs Before Interest and Taxes) "interestExpense": -13790000000, // Despesas Financeiras "incomeBeforeTax": 274998000000, // Resultado Antes dos Tributos sobre o Lucro "incomeTaxExpense": 85993000000, // Imposto de Renda e Contribuição Social sobre o Lucro "minorityInterest": 1791000000, // Participação de acionistas minoritários "netIncomeFromContinuingOps": 189005000000, // Resultado Líquido das Operações Continuadas "discontinuedOperations": null, // Resultado Líquido de Operações Descontinuadas "extraordinaryItems": null, // Itens Extraordinários "effectOfAccountingCharges": null, // Efeito das Mudanças nas Contas "otherItems": null, // Outros itens "netIncome": 188328000000, // Lucro/Prejuízo do Período (Lucro líquido) "netIncomeApplicableToCommonShares": 188328000000 // Lucro/Prejuízo do Período Atribuído a Sócios da Empresa Controladora } // + outros anos ou trimestres ] } } ``` ### Cálculo do NOPAT #### Usando o `operatingIncome` e `incomeBeforeTax` para calcular o `taxRate` ```math taxRate = \frac{incomeTaxExpense}{incomeBeforeTax} ``` ```math taxRate = \frac{85993000000}{274998000000} ``` ```math taxRate = 0.31272 ``` ```math taxRate = 31.27\% ``` ```math NOPAT = operatingIncome \times (1 - taxRate) ``` ```math NOPAT = 303528000000 \times (1 - 0.31272) ``` ```math NOPAT = 208608723840 ``` #### Usando o `EBIT` e `incomeTaxExpense` para calcular o `NOPAT` ```math NOPAT = EBIT - incomeTaxExpense ``` ```math NOPAT = 303528000000 - 85993000000 ``` ```math NOPAT = 217535000000 ``` ### Cálculo do Capital Investido ```math CapitalInvestido = totalAssets - accountsPayable - cash ``` ```math CapitalInvestido = 976709000000 - 28507000000 - 41723000000 ``` ```math CapitalInvestido = 906479000000 ``` ### Cálculo do ROIC ```math ROIC=\frac{NOPAT}{CapitalInvestido} ``` ```math ROIC=\frac{217535000000}{906479000000} ``` ```math ROIC=0.2401 ``` ```math ROIC=24.01\% ``` ## Conclusão Como você pode ver, é possível calcular o ROIC usando os dados fornecidos pela API da brapi. Embora não tenhamos um endpoint que faça esses cálculos automaticamente, você pode facilmente pegar os dados necessários e fazer os cálculos por conta própria. Também temos o ROA (Return on Assets), o ROE (Return on Equity) e vários outros indicadores já calculados no módulo financialData: ```json { "financialData": { "returnOnAssets": 0.13949001, // Retorno sobre ativos "returnOnEquity": 0.36110002, // Retorno sobre patrimônio líquido "currentPrice": 35.27, // Preço atual "targetHighPrice": 49, // Preço alvo alto "targetLowPrice": 26, // Preço alvo baixo "targetMeanPrice": 38.5, // Preço alvo médio "targetMedianPrice": 38.5, // Preço alvo mediano "recommendationMean": 2.5, // Recomendação média "recommendationKey": "buy", // Recomendação "numberOfAnalystOpinions": 12, // Número de opiniões de analistas "totalCash": 67147001856, // Caixa total "totalCashPerShare": 5.159, // Caixa total por ação "ebitda": 265149005824, // EBITDA - Earnings Before Interest, Taxes, Depreciation and Amortization (Lucro antes de juros, impostos, depreciação e amortização) "totalDebt": 305451008000, // Dívida total "quickRatio": 0.638, // Liquidez imediata "currentRatio": 0.953, // Liquidez corrente "totalRevenue": 536315002880, // Receita total "debtToEquity": 78.828, // Dívida / Patrimônio líquido "revenuePerShare": 41.123, // Receita por ação "grossProfits": 334100000000, // Lucro bruto "freeCashflow": 191622742016, // Fluxo de caixa livre "operatingCashflow": 225613004800, // Fluxo de caixa operacional "earningsGrowth": -0.422, // Crescimento dos lucros "revenueGrowth": -0.266, // Crescimento da receita "grossMargins": 0.51079, // Margem bruta "ebitdaMargins": 0.49438998, // Margem EBITDA "operatingMargins": 0.40989, // Margem operacional "profitMargins": 0.25527, // Margem de lucro "financialCurrency": "BRL" // Moeda } } ``` Temos a documentação dessa parte da API aqui: [https://brapi.dev/docs/acoes#modules-opcional](https://brapi.dev/docs/acoes#modules-opcional) ## Referências * [https://www.investopedia.com/terms/r/returnoninvestmentcapital.asp](https://www.investopedia.com/terms/r/returnoninvestmentcapital.asp) * [https://www.investopedia.com/terms/n/nopat.asp](https://www.investopedia.com/terms/n/nopat.asp) * [https://www.investopedia.com/terms/r/returnonassets.asp](https://www.investopedia.com/terms/r/returnonassets.asp) * [https://www.investopedia.com/terms/r/returnonequity.asp](https://www.investopedia.com/terms/r/returnonequity.asp) * [https://www.gurufocus.com/term/TaxRate/BSP:PETR4/Tax-Rate-/Petroleo-Brasileiro-Petrobras](https://www.gurufocus.com/term/TaxRate/BSP:PETR4/Tax-Rate-/Petroleo-Brasileiro-Petrobras) * [https://www.gurufocus.com/term/ROIC/BSP:PETR4/ROIC-/Petroleo-Brasileiro-SA-Petrobras](https://www.gurufocus.com/term/ROIC/BSP:PETR4/ROIC-/Petroleo-Brasileiro-SA-Petrobras) # Como Calcular Rendimento de Investimentos em 2026: Guia Completo com Calculadora URL: /blog/como-calcular-rendimento-investimentos-guia-completo-2026.mdx Aprenda a calcular rendimento de investimentos: juros compostos, rentabilidade real vs nominal, comparação entre ativos. Calculadora prática e exemplos. *** searchable: true title: 'Como Calcular Rendimento de Investimentos em 2026: Guia Completo com Calculadora' description: 'Aprenda a calcular rendimento de investimentos: juros compostos, rentabilidade real vs nominal, comparação entre ativos. Calculadora prática e exemplos.' date: '2026-01-01' keywords: 'como calcular rendimento investimento 2026, calcular juros compostos, rentabilidade real, rendimento poupança, calcular retorno investimento, roi investimentos, calcular cdi, rentabilidade nominal vs real' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Cálculos' readingTime: '20 min' tags: \['Rendimento', 'Juros Compostos', 'Calculadora', 'Rentabilidade', 'Investimentos', 'Iniciantes'] relatedPosts: \['o-que-e-cdi-guia-completo-2026', 'renda-fixa-vs-renda-variavel-2026', 'tesouro-direto-guia-completo-2026-como-investir', 'juros-compostos-o-que-sao-como-calcular-simulador-2026', 'inflacao-investimentos-como-proteger-patrimonio-2026'] featured: true expertise: 'Cálculo de rendimentos e comparação de investimentos' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > Saber calcular o rendimento real dos seus investimentos é fundamental para tomar decisões inteligentes. Este guia ensina todas as fórmulas essenciais com exemplos práticos. *** ## Resumo: Fórmulas Essenciais | Cálculo | Fórmula | Exemplo | | --------------------------- | ------------------------------------ | -------------------------------------- | | **Juros Simples** | M = C × (1 + i × t) | R$ 1.000 × 10% × 1 ano = R$ 1.100 | | **Juros Compostos** | M = C × (1 + i)^t | R$ 1.000 × (1,10)^2 = R$ 1.210 | | **Rentabilidade** | (Final - Inicial) / Inicial × 100 | (R$ 1.100 - R$ 1.000) / R$ 1.000 = 10% | | **Rentabilidade Real** | ((1 + nominal) / (1 + inflação)) - 1 | ((1,12) / (1,05)) - 1 = 6,67% | | **Taxa Equivalente Mensal** | (1 + anual)^(1/12) - 1 | (1,12)^(1/12) - 1 = 0,95% a.m. | *** ## Por Que Saber Calcular Rendimentos? Calcular rendimentos corretamente permite: * **Comparar investimentos** de forma justa * **Entender o impacto** da inflação * **Projetar patrimônio** futuro * **Avaliar taxas** e custos reais * **Tomar decisões** baseadas em dados ``` Investidor que não calcula: "Meu CDB rendeu 12%! Estou rico!" Investidor que calcula: "12% nominal - 5% inflação - 2,7% IR = 4,3% real líquido" ``` *** ## 1. Juros Simples vs Juros Compostos ### Juros Simples Os juros incidem apenas sobre o capital inicial. ``` Fórmula: M = C × (1 + i × t) Onde: M = Montante final C = Capital inicial i = Taxa de juros (decimal) t = Tempo ``` **Exemplo**: R$ 10.000 a 10% ao ano por 3 anos: ``` M = 10.000 × (1 + 0,10 × 3) M = 10.000 × 1,30 M = R$ 13.000 Rendimento: R$ 3.000 ``` ### Juros Compostos (Juros sobre Juros) Os juros incidem sobre o capital + juros acumulados. **É assim que a maioria dos investimentos funciona.** ``` Fórmula: M = C × (1 + i)^t Onde: M = Montante final C = Capital inicial i = Taxa de juros (decimal) t = Tempo (períodos) ``` **Exemplo**: R$ 10.000 a 10% ao ano por 3 anos: ``` M = 10.000 × (1 + 0,10)^3 M = 10.000 × 1,331 M = R$ 13.310 Rendimento: R$ 3.310 ``` ### Comparativo Visual | Ano | Juros Simples | Juros Compostos | Diferença | | --- | ------------- | --------------- | ---------- | | 0 | R$ 10.000 | R$ 10.000 | R$ 0 | | 1 | R$ 11.000 | R$ 11.000 | R$ 0 | | 2 | R$ 12.000 | R$ 12.100 | R$ 100 | | 3 | R$ 13.000 | R$ 13.310 | R$ 310 | | 5 | R$ 15.000 | R$ 16.105 | R$ 1.105 | | 10 | R$ 20.000 | R$ 25.937 | R$ 5.937 | | 20 | R$ 30.000 | R$ 67.275 | R$ 37.275 | | 30 | R$ 40.000 | R$ 174.494 | R$ 134.494 | **O poder dos juros compostos cresce exponencialmente no longo prazo!** *** ## 2. Calculando Rentabilidade ### Rentabilidade Absoluta (Simples) ``` Rentabilidade (%) = ((Valor Final - Valor Inicial) / Valor Inicial) × 100 ``` **Exemplo**: * Comprou ações a R$ 25,00 * Vendeu a R$ 32,00 * Rentabilidade = ((32 - 25) / 25) × 100 = **28%** ### Rentabilidade com Aportes Quando há aportes regulares, use a fórmula do **valor futuro de anuidade**: ``` VF = PMT × [((1 + i)^n - 1) / i] Onde: VF = Valor Futuro PMT = Aporte mensal i = Taxa mensal n = Número de meses ``` **Exemplo**: Aportando R$ 500/mês a 1% ao mês por 12 meses: ``` VF = 500 × [((1,01)^12 - 1) / 0,01] VF = 500 × [0,1268 / 0,01] VF = 500 × 12,68 VF = R$ 6.340 Total aportado: R$ 6.000 Rendimento: R$ 340 ``` *** ## 3. Rentabilidade Real vs Nominal ### O Que é Cada Uma? | Tipo | Descrição | Considera Inflação? | | ----------- | ---------------- | ------------------- | | **Nominal** | Rendimento bruto | ❌ Não | | **Real** | Poder de compra | ✅ Sim | ### Fórmula da Rentabilidade Real ``` Rentabilidade Real = ((1 + Rentabilidade Nominal) / (1 + Inflação)) - 1 ``` **Exemplo**: CDB rendeu 12% a.a., inflação foi 5%: ``` Real = ((1 + 0,12) / (1 + 0,05)) - 1 Real = (1,12 / 1,05) - 1 Real = 1,0667 - 1 Real = 6,67% Seu ganho de poder de compra foi 6,67%, não 12%! ``` ### ⚠️ Erro Comum ``` ❌ ERRADO: Real = Nominal - Inflação 12% - 5% = 7% ✅ CORRETO: Real = ((1 + Nominal) / (1 + Inflação)) - 1 ((1,12) / (1,05)) - 1 = 6,67% ``` A diferença parece pequena, mas em valores grandes e longos períodos, é significativa. *** ## 4. Calculando Rendimento Líquido (Após IR) ### Tabela Regressiva de IR (Renda Fixa) | Prazo | Alíquota | | ----------------- | -------- | | Até 180 dias | 22,5% | | 181 a 360 dias | 20% | | 361 a 720 dias | 17,5% | | Acima de 720 dias | 15% | ### Fórmula do Rendimento Líquido ``` Rendimento Líquido = Rendimento Bruto × (1 - Alíquota IR) ``` **Exemplo**: CDB com rendimento bruto de R$ 1.200 em 2 anos: ``` IR = 15% (acima de 720 dias) IR a pagar = R$ 1.200 × 0,15 = R$ 180 Rendimento Líquido = R$ 1.200 - R$ 180 = R$ 1.020 ``` ### Rentabilidade Líquida Real (Completa) Para calcular o ganho real após IR e inflação, siga os passos: ``` Passo 1: Desconta IR Rentabilidade Líquida = Bruta × (1 - Alíquota IR) Passo 2: Desconta Inflação Rentabilidade Real = ((1 + Líquida) / (1 + Inflação)) - 1 ``` **Exemplo: CDB 12% a.a., IR 15%, inflação 5%:** | Etapa | Cálculo | Resultado | | ------------- | ---------------------------- | --------- | | Bruto | 12% | 12% | | Após IR | 12% × (1 - 15%) | 10,2% | | Após inflação | ((1 + 10,2%) / (1 + 5%)) - 1 | **2,86%** | **Resultado do exemplo**: * Bruto: 12% * Após IR: 10,2% * Após inflação: **2,86%** ← Seu ganho real! *** ## 5. Convertendo Taxas (Anual ↔ Mensal) ### De Anual para Mensal ``` Taxa Mensal = (1 + Taxa Anual)^(1/12) - 1 ``` **Exemplo**: Taxa de 12% ao ano: ``` Mensal = (1 + 0,12)^(1/12) - 1 Mensal = 1,12^0,0833 - 1 Mensal = 1,00949 - 1 Mensal = 0,949% ao mês ``` ### De Mensal para Anual ``` Taxa Anual = (1 + Taxa Mensal)^12 - 1 ``` **Exemplo**: Taxa de 1% ao mês: ``` Anual = (1 + 0,01)^12 - 1 Anual = 1,01^12 - 1 Anual = 1,1268 - 1 Anual = 12,68% ao ano ``` ### ⚠️ Erro Comum ``` ❌ ERRADO: 1% ao mês = 12% ao ano (multiplicar por 12) ✅ CORRETO: 1% ao mês = 12,68% ao ano (juros compostos) ``` *** ## 6. Calculadora Completa: Exemplos Práticos ### Fórmula Completa Para calcular rendimento com aportes mensais, IR e inflação: ``` 1. Taxa mensal = (1 + taxa_anual)^(1/12) - 1 2. Montante = Capital × (1 + taxa_mensal)^meses + PMT × [((1 + taxa_mensal)^meses - 1) / taxa_mensal] 3. Rendimento bruto = Montante - Total investido 4. IR = Rendimento × Alíquota (15% a 22,5% conforme prazo) 5. Rendimento líquido = Bruto - IR 6. Inflação período = (1 + inflação_anual)^anos - 1 7. Rentabilidade real = ((1 + rent_líquida) / (1 + inflação_período)) - 1 ``` ### Exemplo 1: CDB 100% CDI por 2 anos **Dados:** * Capital inicial: R$ 10.000 * Aporte mensal: R$ 500 * Taxa Selic: 13,75% a.a. * Inflação: 5% a.a. * IR (2 anos): 15% | Métrica | Valor | | ---------------------- | --------------------------- | | Total investido | R$ 22.000 (10.000 + 500×24) | | Montante bruto | R$ 28.485 | | Rendimento bruto | R$ 6.485 | | Rentabilidade bruta | 29,5% | | Imposto de Renda | R$ 973 | | Montante líquido | R$ 27.512 | | Rendimento líquido | R$ 5.512 | | Rentabilidade líquida | 25,1% | | Inflação no período | 10,25% | | **Rentabilidade REAL** | **13,4%** | ### Exemplo 2: LCI 90% CDI (isenta de IR) **Dados:** * Capital inicial: R$ 10.000 * Taxa: 12,4% a.a. (90% do CDI) * Período: 2 anos * Sem aportes | Métrica | Valor | | ---------------------- | ------------- | | Montante bruto | R$ 12.622 | | Rendimento bruto | R$ 2.622 | | IR | R$ 0 (isento) | | Montante líquido | R$ 12.622 | | Inflação no período | 10,25% | | **Rentabilidade REAL** | **14,5%** | > 💡 **Observação**: LCI com 90% do CDI pode render mais que CDB 100% CDI devido à isenção de IR! *** ## 7. Calculando Rendimento de Ações ### Rentabilidade Total (Valorização + Dividendos) ``` Rentabilidade Total = Valorização + Dividend Yield Valorização = (Preço Final - Preço Inicial) / Preço Inicial Dividend Yield = Dividendos Recebidos / Preço Inicial ``` ### Exemplo com brapi.dev ```typescript const response = await fetch( `https://brapi.dev/api/quote/${ticker}?range=1y&interval=1d&modules=defaultKeyStatistics÷nds=true`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); const data = results[0]; // Preços const precoAtual = data.regularMarketPrice; const precoInicial = data.historicalDataPrice?.[0]?.close ?? precoAtual; // Cálculos const valorizacao = (precoAtual - precoInicial) / precoInicial; const dividendYield = data.defaultKeyStatistics?.dividendYield ?? 0; const retornoTotal = valorizacao + dividendYield; ``` **Exemplo de resultado para PETR4:** | Métrica | Valor | | ----------------- | --------- | | Preço há 1 ano | R$ 28,50 | | Preço atual | R$ 37,85 | | Valorização | 32,8% | | Dividend Yield | 8,5% | | **Retorno Total** | **41,3%** | ``` --- ## 8. Comparando Investimentos ### Exemplo Comparativo Para comparar investimentos de forma justa, use os mesmos parâmetros: **Cenário:** R$ 50.000 por 3 anos, inflação 5% | Investimento | Taxa | Bruto | Líquido | Real | Risco | |--------------|------|-------|---------|------|-------| | Poupança | 6,5% | R$ 60.397 | R$ 60.397 | 4,9% | baixo | | CDB 100% CDI | 13,5% | R$ 73.070 | R$ 69.610 | 6,9% | baixo | | CDB 120% CDI | 16,2% | R$ 78.540 | R$ 73.259 | 8,3% | médio | | LCI 90% CDI | 12,2% | R$ 70.501 | R$ 70.501 | 8,7% | baixo | | Tesouro IPCA+6% | 11,0% | R$ 68.468 | R$ 65.698 | 4,6% | baixo | | CRI/CRA IPCA+7% | 12,0% | R$ 70.246 | R$ 70.246 | 8,6% | médio | ✅ **Melhor opção (maior rentabilidade real):** LCI 90% CDI com ganho real de 8,7% em 3 anos ### Por Que LCI Ganha Mesmo com Taxa Menor? ``` CDB 100% CDI: * Rendimento bruto: 13,5% * Após IR (15%): 11,5% * Após inflação: 6,9% LCI 90% CDI: * Rendimento bruto: 12,2% * Sem IR (isenta): 12,2% * Após inflação: 8,7% ``` A isenção de IR compensa a taxa menor! --- ## 9. Fórmulas Importantes Resumidas ### Juros Compostos com Aportes Mensais ``` VF = C × (1 + i)^n + PMT × \[((1 + i)^n - 1) / i] Onde: VF = Valor Futuro C = Capital inicial i = Taxa mensal n = Número de meses PMT = Aporte mensal ``` ### Quanto Preciso Investir para Atingir X? ``` PMT = VF × i / ((1 + i)^n - 1) ``` **Exemplo**: Quero R$ 1.000.000 em 20 anos com 1% ao mês: ``` PMT = 1.000.000 × 0,01 / ((1 + 0,01)^240 - 1) PMT = 10.000 / 9,893 PMT = R$ 1.010,86/mês ``` Com apenas **R$ 1.010,86/mês** durante 20 anos a 1% a.m., você acumula **R$ 1 milhão**! ### Em Quanto Tempo Atinjo X? ``` n = log(VF × i / PMT + 1) / log(1 + i) ``` **Exemplo**: R$ 1 milhão aportando R$ 2.000/mês a 1% ao mês: ``` n = log(1.000.000 × 0,01 / 2.000 + 1) / log(1,01) n = log(6) / log(1,01) n = 1,79 / 0,00995 n = 180 meses (15 anos) ``` Com **R$ 2.000/mês** a 1% a.m., você atinge R$ 1 milhão em **15 anos**! --- ## 10. Erros Comuns ao Calcular Rendimentos ### ❌ Erro 1: Ignorar a Inflação ``` "Meu investimento rendeu 10%!" Mas a inflação foi 5%... Rendimento real: 4,76% (não 5%) ``` ### ❌ Erro 2: Somar Taxas ``` ❌ 1% ao mês × 12 = 12% ao ano ✅ (1,01)^12 - 1 = 12,68% ao ano ``` ### ❌ Erro 3: Esquecer o IR ``` CDB 100% CDI parece igual a LCI 100% CDI Mas CDB paga IR (15% a 22,5%) LCI é isenta ``` ### ❌ Erro 4: Não Considerar o Prazo do IR ``` CDB resgatado em 6 meses: IR de 22,5% CDB resgatado em 2 anos: IR de 15% Diferença de 7,5% no imposto! ``` ### ❌ Erro 5: Comparar Períodos Diferentes ``` ❌ "FII X rendeu 15% em 2 anos, FII Y rendeu 10% em 1 ano" Comparação injusta! ✅ Anualize os rendimentos para comparar: FII X: (1,15)^(1/2) - 1 = 7,24% a.a. FII Y: 10% a.a. FII Y é melhor! ```` --- ## 11. Planilha de Acompanhamento ### Template para Acompanhar Seus Investimentos | Investimento | Data Compra | Valor Investido | Valor Atual | Rendimento | % Bruto | % Líquido | % Real | |--------------|-------------|-----------------|-------------|------------|---------|-----------|--------| | CDB Banco X | 01/01/2024 | R$ 10.000 | R$ 11.200 | R$ 1.200 | 12% | 10,2% | 5,1% | | Tesouro IPCA+ | 01/06/2024 | R$ 5.000 | R$ 5.450 | R$ 450 | 9% | 7,7% | 2,5% | | PETR4 | 15/03/2024 | R$ 3.000 | R$ 3.600 | R$ 600 | 20% | 17% | 11,4% | | **TOTAL** | - | **R$ 18.000** | **R$ 20.250** | **R$ 2.250** | **12,5%** | **10,6%** | **5,3%** | --- ## 12. Usando a API brapi.dev para Cálculos A brapi.dev oferece dados em tempo real para seus cálculos: ### Endpoints Úteis ```typescript const auth = { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }; // Selic, CDI e IPCA12m juntos via /api/v2/macro const macro = await fetch( "https://brapi.dev/api/v2/macro/latest?symbols=selic,cdi,ipca12m", auth, ); // Cotação de ações com histórico const quote = await fetch( "https://brapi.dev/api/quote/PETR4?range=1y&interval=1d", auth, ); // Dados de dividendos const dividendos = await fetch( "https://brapi.dev/api/quote/PETR4?dividends=true", auth, ); // Múltiplas ações const multiplas = await fetch( "https://brapi.dev/api/quote/PETR4,VALE3,ITUB4", auth, ); ```` ### Calculadora Automatizada ```typescript async function calcularRendimentoAcao(ticker: string, capital: number) { // Busca dados do ativo const quoteRes = await fetch( `https://brapi.dev/api/quote/${ticker}?range=1y&modules=defaultKeyStatistics÷nds=true`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await quoteRes.json(); const quote = results[0]; // Busca IPCA acumulado em 12 meses (já calculado pelo BCB) const inflacaoRes = await fetch( "https://brapi.dev/api/v2/macro/latest?symbols=ipca12m", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }, ); const { results: macroResults } = await inflacaoRes.json(); const ipca12m = (macroResults[0]?.latest?.value ?? 0) / 100; // Calcula rendimento const precoAtual = quote.regularMarketPrice; const preco1y = quote.historicalDataPrice?.[0]?.close ?? precoAtual; const valorizacao = (precoAtual - preco1y) / preco1y; const dy = quote.defaultKeyStatistics?.dividendYield ?? 0; const retornoTotal = valorizacao + dy; const retornoReal = ((1 + retornoTotal) / (1 + ipca12m)) - 1; const lucro = capital * retornoTotal; return { ticker, precoAtual, preco1y, valorizacao, dy, retornoTotal, retornoReal, lucro }; } ``` **Exemplo de saída para PETR4 com R$ 10.000:** | Métrica | Valor | | --------------------- | ------------ | | Preço há 1 ano | R$ 28,50 | | Preço atual | R$ 37,85 | | Valorização | 32,8% | | Dividend Yield | 8,5% | | Retorno Total (bruto) | 41,3% | | Inflação (IPCA 12m) | 5,2% | | **Retorno Real** | **34,3%** | | **Lucro bruto** | **R$ 4.130** | *** ## Checklist: Calculando Rendimentos ``` ✅ ANTES DE INVESTIR □ Calculei a rentabilidade líquida (após IR)? □ Calculei a rentabilidade real (após inflação)? □ Comparei com alternativas equivalentes? □ Considerei o prazo para menor IR? ✅ DURANTE O INVESTIMENTO □ Acompanho rentabilidade mensal/anual? □ Comparo com benchmark (CDI, IBOV)? □ Registro todos os aportes e resgates? ✅ NO RESGATE □ Calculei o IR devido? □ Comparei rentabilidade com objetivo inicial? □ Analisei se valeu a pena vs alternativas? ``` *** ## Próximos Passos 1. **Pratique os cálculos** com seus próprios investimentos 2. **Use a brapi.dev** para automatizar análises 3. **Crie sua planilha** de acompanhamento 4. **Compare sempre** rentabilidade real, não nominal ### Leitura Complementar * [O Que É CDI e Como Funciona](/blog/o-que-e-cdi-guia-completo-2026) * [Renda Fixa vs Renda Variável](/blog/renda-fixa-vs-renda-variavel-2026) * [Tesouro Direto: Guia Completo](/blog/tesouro-direto-guia-completo-2026-como-investir) * [CDB vs Tesouro Direto](/blog/cdb-vs-tesouro-direto-comparativo-2026) *** ## Conclusão Saber calcular rendimentos é uma habilidade fundamental para qualquer investidor. Os pontos principais: 1. **Juros compostos** são a base de quase todo investimento 2. **Rentabilidade nominal ≠ rentabilidade real** - sempre desconte a inflação 3. **IR impacta significativamente** - considere investimentos isentos 4. **Compare de forma justa** - anualize taxas e use mesmos parâmetros 5. **Automatize cálculos** - use a brapi.dev para dados em tempo real Com as fórmulas e ferramentas deste guia, você está preparado para tomar decisões de investimento baseadas em dados reais, não em promessas de rentabilidade nominal. *** *Última atualização: Janeiro de 2026* # Como começar a investir do zero URL: /blog/como-comecar-investir-do-zero-guia-iniciantes-2026.mdx Organize as contas, monte sua reserva e faça o primeiro investimento sem complicar. *** searchable: true title: 'Como começar a investir do zero' description: 'Organize as contas, monte sua reserva e faça o primeiro investimento sem complicar.' date: '2026-01-01' keywords: 'como começar a investir, investir do zero, primeiro investimento, investimentos para iniciantes, reserva de emergência' author: 'Alisson Leal' category: 'Investimentos' subcategory: 'Iniciantes' readingTime: '10 min' tags: \['Iniciantes', 'Investimentos', 'Educação Financeira', 'Primeiro Investimento'] relatedPosts: \['como-investir-com-pouco-dinheiro-2026', 'reserva-de-emergencia-guia-completo-2026', 'tesouro-direto-guia-completo-2026-como-investir', 'guia-bogleheads-brasil-investimento-passivo-etfs'] featured: true expertise: 'Educação financeira e primeiros investimentos' lastReviewed: '2026-06-23' faqSchema: * question: 'Quanto dinheiro preciso para começar a investir?' answer: 'Você pode começar com pouco. O valor importa menos do que organizar o orçamento, criar uma reserva e manter aportes que caibam na sua rotina.' * question: 'Qual deve ser meu primeiro investimento?' answer: 'Para a reserva de emergência, priorize liquidez e baixo risco, como Tesouro Selic ou CDB com liquidez diária. Outros objetivos podem exigir produtos diferentes.' * question: 'Devo investir mesmo tendo dívidas?' answer: 'Dívidas com juros altos, como cartão rotativo e cheque especial, normalmente devem ser pagas antes de investir.' *** import { Authors, Author } from '~/components/Authors'; Começar a investir não exige escolher a melhor ação do ano. Primeiro você precisa fazer o dinheiro sobrar, criar uma reserva e separar cada objetivo pelo prazo. O caminho é menos empolgante do que os vídeos de finanças fazem parecer. Isso é bom. Um plano simples tem mais chance de durar. ## O caminho mais curto ## 1. Descubra quanto pode investir Abra o extrato dos últimos três meses e responda: * qual é a renda líquida média; * quanto custa o básico; * quais gastos variam; * quanto sobra sem depender do limite da conta. Não force um percentual bonito. Se hoje sobram R$ 100, esse é o aporte. Aumente quando o orçamento permitir. Uma divisão como 50% para necessidades, 30% para escolhas pessoais e 20% para poupar pode servir de referência. Ela não é regra. Aluguel, filhos, renda e cidade mudam a conta. ## 2. Pague as dívidas caras Investir enquanto o cartão rotativo cresce costuma piorar a situação. O retorno de um investimento conservador dificilmente compensa juros muito altos. Priorize: 1. cartão rotativo; 2. cheque especial; 3. empréstimos caros; 4. outras dívidas, conforme taxa e prazo. Financiamentos com juros menores exigem outra análise. Nem toda dívida precisa ser quitada antes de qualquer investimento. ## 3. Monte a reserva de emergência A reserva paga despesas inesperadas, como perda de renda, problema de saúde ou conserto urgente. Uma referência comum é guardar entre 3 e 12 meses do custo de vida. Use a parte maior do intervalo se sua renda oscila, se poucas pessoas sustentam a casa ou se recolocação profissional costuma demorar. | Situação | Reserva inicial razoável | | ----------------------------------------- | ------------------------ | | Renda estável e mais de uma fonte na casa | 3 a 6 meses | | Uma fonte principal de renda | 6 a 9 meses | | Autônomo ou renda muito variável | 9 a 12 meses | O produto precisa ter baixo risco e resgate fácil. Tesouro Selic e CDB com liquidez diária são opções comuns. Confira horário de resgate, carência, cobertura do FGC e tributação. Rentabilidade vem depois. Se a reserva oscila muito ou fica presa, ela não cumpre o papel. ## 4. Dê nome ao dinheiro Cada objetivo tem prazo. O prazo define quanto risco cabe. | Objetivo | Prazo | Caminho mais comum | | -------------------------------- | ----- | --------------------------------- | | Viagem no próximo ano | Curto | Renda fixa líquida e conservadora | | Entrada de imóvel em quatro anos | Médio | Renda fixa alinhada ao vencimento | | Aposentadoria em décadas | Longo | Combinação de renda fixa e ações | Dinheiro que será usado em breve não deveria depender de uma recuperação da bolsa. ## 5. Entenda o risco antes de escolher o produto "Perfil arrojado" no questionário da corretora não é autorização para ignorar prazo e reserva. Pense em duas coisas: * capacidade de risco: quanto você pode perder sem atrapalhar um objetivo; * tolerância a risco: quanto de queda você suporta sem abandonar o plano. Uma pessoa jovem pode ter décadas pela frente, mas pouca capacidade de risco se pretende usar o dinheiro em dois anos. ## 6. Abra uma conta sem escolher pela propaganda Banco ou corretora precisam oferecer os produtos que você usa, custos claros, atendimento funcional e segurança de acesso. Antes de abrir a conta, confira: * taxas de corretagem e custódia; * custo de produtos sugeridos; * facilidade para resgatar; * autenticação em dois fatores; * qualidade dos informes para imposto de renda. Não existe uma melhor corretora para todo mundo. Rankings envelhecem rápido. ## 7. Faça um primeiro investimento pequeno Para a reserva, escolha um produto líquido e conservador. Transfira um valor pequeno e acompanhe o processo de aplicação e resgate. Depois da reserva, uma carteira inicial pode ter poucos itens: | Função | Exemplo | | -------------------------- | ---------------------------------------- | | Emergências | Tesouro Selic ou CDB com liquidez diária | | Objetivos com data | Renda fixa com vencimento compatível | | Crescimento de longo prazo | ETF amplo de ações | Você não precisa comprar ações, FIIs, criptomoedas e cinco tipos de renda fixa no primeiro mês. ## 8. Automatize o aporte Escolha um dia próximo ao recebimento da renda. Transfira o valor antes de o mês consumir o que sobrou. Se a renda varia, use uma regra simples, como investir 10% de cada pagamento recebido. Revise o valor quando a renda ou os gastos mudarem. ## 9. Acompanhe sem vigiar Para uma carteira de longo prazo, uma revisão mensal dos aportes e uma revisão anual da alocação costumam ser suficientes. Use o acompanhamento para responder perguntas práticas: * o aporte foi feito; * a reserva ainda cobre os meses planejados; * o objetivo ou o prazo mudou; * a carteira saiu muito da proporção escolhida. Cotação diária não responde nenhuma delas. ## Erros comuns * começar pela ação "barata"; * investir a reserva em algo volátil; * seguir uma carteira pronta sem entender o risco; * trocar de estratégia depois de uma queda; * comprar muitos produtos para parecer diversificado; * ignorar imposto, taxa e prazo de resgate. ## O que fazer hoje 1. Some seus gastos essenciais do último mês. 2. Liste as dívidas e suas taxas. 3. Defina a primeira meta da reserva. 4. Separe um aporte que não aperte o orçamento. 5. Faça a primeira aplicação em um produto que você entende. Depois, leia [como montar uma reserva de emergência](/blog/reserva-de-emergencia-guia-completo-2026). Quando a base estiver pronta, o [guia Bogleheads](/blog/guia-bogleheads-brasil-investimento-passivo-etfs) mostra uma forma simples de montar a parte de longo prazo. A [brapi](/docs) ajuda a consultar dados de mercado quando você precisar analisar ou acompanhar ativos. Ela não substitui um plano. *Conteúdo educacional. Não é recomendação de investimento.* # Carteira Diversificada 2025: Como Construir Portfolio Eficiente na Bolsa Brasileira URL: /blog/como-construir-carteira-investimentos-diversificada-brapi.mdx Domine a construção de carteiras diversificadas! Aprenda alocação estratégica, rebalanceamento e gestão de risco ✓ *** searchable: true title: 'Carteira Diversificada 2025: Como Construir Portfolio Eficiente na Bolsa Brasileira' description: 'Domine a construção de carteiras diversificadas! Aprenda alocação estratégica, rebalanceamento e gestão de risco ✓' date: '2025-08-22' keywords: 'carteira investimentos, diversificação, alocação ativos, rebalanceamento, gestão risco, portfolio, ações FIIs, estratégia investimento, bolsa brasileira, brapi' author: 'Equipe brapi.dev' category: 'Gestão de Carteira' subcategory: 'Estratégias de Portfólio' readingTime: '22 min' tags: \['Carteira Investimentos', 'Diversificação', 'Alocação', 'Bolsa Brasileira', 'Gestão Risco', 'Portfolio', 'Rebalanceamento', 'Asset Allocation'] relatedPosts: \['analise-setorial-acoes-como-comparar-empresas-mesmo-segmento-b3', 'fundos-imobiliarios-fiis-guia-completo-iniciantes', 'indicadores-economicos-brasil-selic-ipca-igpm-impacto-investimentos'] featured: true expertise: 'Gestão de carteiras com 8+ anos de experiência no mercado brasileiro' lastReviewed: 2026-01-03 howToTools: \['API brapi.dev', 'Planilha de controle', 'Calculadora de alocação'] howToSteps: * name: 'Defina seu perfil de risco' text: 'Avalie sua tolerância a perdas e horizonte de investimento (conservador, moderado, arrojado).' * name: 'Escolha as classes de ativos' text: 'Selecione entre ações, FIIs, renda fixa, ETFs e criptomoedas conforme seu perfil.' * name: 'Determine a alocação percentual' text: 'Defina quanto do patrimônio vai para cada classe (ex: 60% RV, 40% RF).' * name: 'Diversifique dentro de cada classe' text: 'Escolha ativos de diferentes setores e empresas para reduzir risco específico.' * name: 'Monitore e rebalanceie periodicamente' text: 'Use a API brapi.dev para acompanhar a carteira e rebalancear quando necessário.' *** import { Authors, Author } from '~/components/Authors'; > A diversificação é a única estratégia comprovada para reduzir riscos sem sacrificar retornos. Aprenda como construir, monitorar e rebalancear uma carteira eficiente usando dados em tempo real da brapi.dev em 2025. *** ## Por Que Diversificação é a Regra de Ouro dos Investimentos? **A diversificação é a única estratégia gratuita para reduzir riscos** sem necessariamente reduzir retornos esperados. Harry Markowitz provou que carteiras bem diversificadas têm melhor relação risco-retorno que ativos individuais. **Exemplo prático:** Uma carteira com 50% Petrobras e 50% Vale pode ter volatilidade maior que uma carteira com 20 ações diferentes de setores diversos. ### Benefícios Comprovados da Diversificação: 1. **Reduz risco específico** de empresas individuais 2. **Minimiza impacto** de crises setoriais 3. **Suaviza volatilidade** da carteira total 4. **Protege** contra ciclos econômicos 5. **Melhora** relação risco-retorno * Setores defensivos vs. cíclicos * Proteção contra inflação e recessão #### 3. **Otimização Risco-Retorno** * Fronteira eficiente de Markowitz * Máximo retorno para cada nível de risco * Sleep well at night factor ## Estrutura de uma Carteira Diversificada ### Modelo Clássico de Alocação **Carteira Modelo - Alocação Balanceada:** | Categoria | Subcategoria | Alocação | | ------------------ | -------------------------------- | -------- | | **Renda Variável** | Ações Nacionais | 40% | | | FIIs | 15% | | | Ações Internacionais (ETFs/BDRs) | 10% | | **Renda Fixa** | Tesouro Direto | 20% | | | CDB/LCI/LCA | 10% | | | Fundos RF | 5% | **Resumo:** * Renda Variável: **65%** * Renda Fixa: **35%** ### Diversificação por Setor (Ações) **Modelo de Diversificação Setorial:** | Setor | Alocação | Tickers Sugeridos | Características | | --------------- | -------- | --------------------------- | ------------------------------ | | **Financeiro** | 25% | ITUB4, BBDC4, BBAS3, BBSE3 | Dividendos, sensível a juros | | **Commodities** | 20% | VALE3, PETR4, SUZB3, USIM5 | Cíclico, proteção inflação | | **Utilities** | 15% | EGIE3, SBSP3, CPLE6, TAEE11 | Defensivo, dividendos estáveis | | **Consumo** | 15% | ABEV3, BRFS3, JBSS3, MGLU3 | Crescimento, consumo interno | | **Industrial** | 15% | WEGE3, RAIL3, AZUL4, EMBR3 | Crescimento, tecnologia | | **Outros** | 10% | TOTS3, RENT3, LWSA3, HAPV3 | Diversificação adicional | ## Construindo a Carteira com brapi.dev ### 1. Análise e Seleção de Ativos **Consulta de dados fundamentalistas:** ```typescript const tickers = "ITUB4,VALE3,EGIE3,ABEV3,WEGE3"; const response = await fetch( `https://brapi.dev/api/quote/${tickers}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); ``` **Critérios de seleção recomendados:** | Critério | Valor Ideal | Descrição | | -------- | ----------- | ----------------------------- | | P/L | \< 20 | Preço sobre lucro | | P/VP | \< 3 | Preço sobre valor patrimonial | | DY | > 2% | Dividend yield mínimo | | ROE | > 10% | Retorno sobre patrimônio | **Sistema de Score de Qualidade (0-100 pontos):** | Indicador | Faixa | Pontos | | ------------------ | ------ | ------ | | **P/L** | \< 10 | +20 | | | 10-15 | +15 | | | 15-20 | +10 | | **P/VP** | \< 1 | +20 | | | 1-1,5 | +15 | | | 1,5-2 | +10 | | **DY** | > 8% | +20 | | | 5-8% | +15 | | | 3-5% | +10 | | **ROE** | > 20% | +20 | | | 15-20% | +15 | | | 10-15% | +10 | | **Margem Líquida** | > 20% | +20 | | | 10-20% | +15 | | | 5-10% | +10 | **Exemplo - Top Ações por Score:** | # | Ticker | P/L | ROE | DY | Score | | - | ------ | ---- | ----- | ---- | ----- | | 1 | TAEE11 | 8,5 | 25,2% | 9,1% | 85 | | 2 | BBAS3 | 5,8 | 18,3% | 8,5% | 80 | | 3 | VALE3 | 6,2 | 22,1% | 7,8% | 78 | | 4 | ITUB4 | 9,1 | 19,5% | 5,2% | 75 | | 5 | EGIE3 | 11,2 | 28,5% | 6,1% | 72 | ### 2. Seleção de FIIs **Consulta de FIIs:** ```typescript const fiis = "HGLG11,XPML11,VISC11,MXRF11,BTLG11,HGRE11"; const response = await fetch( `https://brapi.dev/api/quote/${fiis}?modules=defaultKeyStatistics`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); ``` **Categorias de FIIs:** | Categoria | Palavras-chave | Exemplos | | ----------- | ----------------- | -------------- | | Varejo | shopping, mall | VISC11, XPML11 | | Logístico | logístico, galpão | HGLG11, XPLG11 | | Corporativo | escritório, laje | HGRE11, BRCR11 | | Papel | renda, recebíveis | MXRF11, KNCR11 | | Híbrido | multi | KNRI11 | **Exemplo - Top 10 FIIs por DY:** | # | Ticker | Categoria | DY | P/VP | | -- | ------ | ----------- | ----- | ---- | | 1 | MXRF11 | Papel | 12,4% | 1,02 | | 2 | IRDM11 | Papel | 11,8% | 0,98 | | 3 | KNCR11 | Papel | 11,2% | 1,01 | | 4 | VISC11 | Varejo | 9,5% | 0,95 | | 5 | HGLG11 | Logístico | 8,8% | 0,98 | | 6 | XPLG11 | Logístico | 8,5% | 0,92 | | 7 | BTLG11 | Logístico | 8,2% | 0,89 | | 8 | XPML11 | Varejo | 8,0% | 0,91 | | 9 | HGRE11 | Corporativo | 7,5% | 0,82 | | 10 | ALZR11 | Híbrido | 7,2% | 0,88 | ### 3. Montagem da Carteira Final **Estrutura de Alocação:** | Categoria | Alocação | Valor (R$ 100k) | | ---------- | -------- | --------------- | | Ações | 65% | R$ 65.000 | | FIIs | 15% | R$ 15.000 | | Renda Fixa | 20% | R$ 20.000 | **Regras de Diversificação:** * Máximo 2 ações por setor * Máximo 5 FIIs de categorias diferentes * Rebalancear quando desvio > 5% **Exemplo - Carteira Montada (R$ 100.000):** **Ações (65%):** | Ticker | Setor | Qtd | Preço | Total | DY | | ------ | ----------- | --- | -------- | -------- | ----- | | ITUB4 | Financeiro | 150 | R$ 32,50 | R$ 4.875 | 5,2% | | BBAS3 | Financeiro | 100 | R$ 48,20 | R$ 4.820 | 8,5% | | VALE3 | Commodities | 80 | R$ 62,30 | R$ 4.984 | 7,8% | | PETR4 | Commodities | 130 | R$ 38,50 | R$ 5.005 | 12,1% | | EGIE3 | Utilities | 110 | R$ 44,80 | R$ 4.928 | 6,1% | | TAEE11 | Utilities | 140 | R$ 35,20 | R$ 4.928 | 9,1% | | ABEV3 | Consumo | 350 | R$ 14,30 | R$ 5.005 | 4,2% | | JBSS3 | Consumo | 170 | R$ 29,40 | R$ 4.998 | 3,5% | | WEGE3 | Industrial | 90 | R$ 54,80 | R$ 4.932 | 1,8% | | RAIL3 | Industrial | 240 | R$ 20,50 | R$ 4.920 | 2,1% | **FIIs (15%):** | Ticker | Categoria | Qtd | Preço | Total | DY | | ------ | ----------- | --- | --------- | -------- | ----- | | MXRF11 | Papel | 280 | R$ 10,45 | R$ 2.926 | 12,4% | | HGLG11 | Logístico | 18 | R$ 158,50 | R$ 2.853 | 8,8% | | VISC11 | Varejo | 25 | R$ 118,30 | R$ 2.958 | 9,5% | | HGRE11 | Corporativo | 23 | R$ 125,40 | R$ 2.884 | 7,5% | | BCFF11 | FOF | 35 | R$ 85,20 | R$ 2.982 | 8,2% | **Renda Fixa (20%):** | Ativo | Total | Rentabilidade | | ------------------ | --------- | ------------- | | Tesouro Selic 2029 | R$ 20.000 | \~13,5% a.a. | **Resumo:** * Valor Real Investido: R$ 99.450 * Caixa Restante: R$ 550 * DY Médio Ponderado: \~7,2% ## Sistema de Monitoramento da Carteira ### Dashboard de Acompanhamento **Consulta de preços atualizados:** ```typescript const tickers = "ITUB4,BBAS3,VALE3,PETR4,HGLG11,MXRF11"; const response = await fetch( `https://brapi.dev/api/quote/${tickers}`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); // Calcular performance de cada posição const positions = results.map(r => ({ ticker: r.symbol, preco_atual: r.regularMarketPrice, variacao_dia: r.regularMarketChangePercent })); ``` **Exemplo - Relatório de Performance:** | Métrica | Valor | | ------------------- | ---------- | | **Valor Investido** | R$ 99.450 | | **Valor Atual** | R$ 105.230 | | **Resultado** | +R$ 5.780 | | **Rentabilidade** | +5,81% | | **DY Médio** | 7,2% | **Distribuição Setorial Atual:** | Setor | Alocação | | ----------- | -------- | | Financeiro | 12,5% | | Commodities | 12,8% | | Utilities | 12,6% | | Consumo | 12,8% | | Industrial | 12,6% | | FIIs | 15,2% | | Renda Fixa | 21,5% | **Distribuição por Tipo:** | Tipo | Atual | Target | Status | | ---------- | ----- | ------ | ------ | | Ação | 63,3% | 65% | ✅ OK | | FII | 15,2% | 15% | ✅ OK | | Renda Fixa | 21,5% | 20% | ✅ OK | **Verificação de Rebalanceamento:** Tolerância: 5% * ✅ Carteira balanceada - não necessita rebalanceamento ## Estratégias de Rebalanceamento ### Rebalanceamento Automático **Fórmula de Rebalanceamento:** ``` ┌─────────────────────────────────────────────────────────────┐ │ Valor Alvo = (Valor Total + Aporte) × Target% │ │ Diferença = Valor Alvo - Valor Atual │ │ │ │ Se Diferença > R$ 100 → COMPRAR │ │ Se Diferença < -R$ 100 → VENDER │ └─────────────────────────────────────────────────────────────┘ ``` **Exemplo - Plano de Rebalanceamento com Aporte de R$ 5.000:** | Categoria | Atual | Alvo | Diferença | Operação | | ---------- | --------- | --------- | --------- | ------------------------- | | Ação | R$ 66.350 | R$ 68.250 | +R$ 1.900 | COMPRAR R$ 1.900 em Ações | | FII | R$ 15.950 | R$ 15.750 | -R$ 200 | VENDER R$ 200 em FIIs | | Renda Fixa | R$ 22.500 | R$ 21.000 | -R$ 1.500 | - (manter) | **Estratégia Recomendada:** * Rebalancear a cada trimestre OU quando desvio > 5% * Preferir usar aportes para rebalancear (evita custos de venda) * Considerar custos de transação antes de vender ## Alertas e Monitoramento Automatizado ### Sistema de Alertas Configure alertas para monitorar sua carteira: ```typescript const response = await fetch( `https://brapi.dev/api/quote/${tickers}`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); // Verificar alertas results.forEach(r => { const rentabilidade = r.regularMarketChangePercent; if (rentabilidade < -10) console.log(`⚠️ ALERTA: ${r.symbol} caiu ${rentabilidade}%`); }); ``` **Parâmetros de Alerta Recomendados:** | Alerta | Critério | Ação | | ---------------- | ------------------------- | -------------------------- | | Queda expressiva | Posição caiu > 10% | Avaliar fundamentos | | Concentração | Posição > 15% da carteira | Considerar venda parcial | | Rebalanceamento | Desvio > 5% do target | Rebalancear aportes | | DY alto | DY > 15% | Verificar sustentabilidade | **Exemplo - Alertas Identificados:** | Ticker | Rentabilidade | Participação | Alerta | | ------ | ------------- | ------------ | --------------------- | | PETR4 | -12,5% | 5,1% | ⚠️ Queda > 10% | | VALE3 | +8,2% | 16,2% | ⚠️ Concentração > 15% | > Dica: Integre com Telegram ou email para receber alertas automáticos. ## Análise de Performance Histórica ### Backtesting da Estratégia **Consulta de dados históricos:** ```typescript const response = await fetch( "https://brapi.dev/api/quote/ITUB4,VALE3,EGIE3?range=3y&interval=1mo", { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const historicalData = results.map(r => ({ ticker: r.symbol, prices: r.historicalDataPrice })); ``` **Métricas de Performance (3 anos):** | Métrica | Fórmula | Valor Exemplo | | ---------------------- | ----------------------------------- | ------------- | | **Retorno Anualizado** | (1 + retorno\_total)^(12/meses) - 1 | +15,2% | | **Volatilidade** | Desvio padrão × √12 | 18,5% | | **Sharpe Ratio** | Retorno / Volatilidade | 0,82 | | **Drawdown Máximo** | (Pico - Vale) / Pico | -22,3% | **Exemplo - Simulação de R$ 10.000 (3 anos):** | Ano | Início | Final | Retorno | | --------- | --------- | ------------- | ---------- | | 1 | R$ 10.000 | R$ 11.520 | +15,2% | | 2 | R$ 11.520 | R$ 12.890 | +11,9% | | 3 | R$ 12.890 | R$ 15.230 | +18,2% | | **Total** | R$ 10.000 | **R$ 15.230** | **+52,3%** | **Interpretação do Sharpe Ratio:** * \< 0,5: Ruim * 0,5-1,0: Aceitável * 1,0-2,0: Bom * > 2,0: Excelente > O backtesting ajuda a validar a estratégia, mas resultados passados não garantem retornos futuros. ## Conclusão Construir uma carteira diversificada é um processo contínuo que requer disciplina, acompanhamento e rebalanceamento periódico. Com as ferramentas da brapi.dev, é possível: ### Vantagens da Abordagem Sistemática: 1. **Redução de Riscos**: Diversificação eficiente entre setores e ativos 2. **Monitoramento Automático**: Acompanhamento em tempo real da performance 3. **Rebalanceamento Inteligente**: Manutenção das alocações ideais 4. **Análise Baseada em Dados**: Decisões fundamentadas em métricas objetivas ### Próximos Passos: * **[Crie sua conta](/dashboard)** na brapi.dev para acessar dados completos * **Implemente os códigos** apresentados neste guia * **Adapte as estratégias** ao seu perfil de risco * **Monitore regularmente** sua carteira ### Recursos Adicionais: * **[Documentação completa](/docs)** da API * **[Dados históricos](/docs)** para backtesting * **[Exemplos práticos](/docs/examples)** de implementação **Lembre-se**: Diversificação não elimina riscos, mas os reduz significativamente. Sempre invista apenas o que pode perder e mantenha uma reserva de emergência adequada! # Como Declarar Criptomoedas no Imposto de Renda 2026/2027: Guia Completo DeCripto URL: /blog/como-declarar-criptomoedas-imposto-renda-2026.mdx Aprenda a declarar Bitcoin, Ethereum e outras criptomoedas no IR 2026/2027. Guia completo com DeCripto, GCAP, DARF código 4600 e isenção de R$ 35 mil. *** searchable: true title: 'Como Declarar Criptomoedas no Imposto de Renda 2026/2027: Guia Completo DeCripto' description: 'Aprenda a declarar Bitcoin, Ethereum e outras criptomoedas no IR 2026/2027. Guia completo com DeCripto, GCAP, DARF código 4600 e isenção de R$ 35 mil.' date: '2026-01-01' keywords: 'declarar criptomoedas imposto de renda, IR cripto 2026, DeCripto receita federal, DARF 4600 bitcoin, como declarar bitcoin IR, imposto criptomoeda brasil, isenção 35 mil cripto, 2026' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Criptomoedas' readingTime: '25 min' tags: \['Criptomoedas', 'Imposto de Renda', 'Bitcoin', 'Receita Federal', 'DeCripto', 'DARF'] relatedPosts: \['bitcoin-brasil-como-investir-analise', 'ethereum-eth-guia-completo-brasil-2026', 'etfs-criptomoedas-b3-hash11-bith11-guia-2026', 'stablecoins-brasil-usdt-brz-drex-guia-2026', 'altcoins-promissoras-analise-2026'] featured: true expertise: 'Guia elaborado por especialistas em tributação de criptoativos com base na legislação brasileira vigente (IN RFB 2.291/2026)' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; A declaração de criptomoedas no Imposto de Renda brasileiro ficou mais rigorosa em 2026 com a implementação do **DeCripto** (Declaração de Criptoativos), substituindo a antiga IN 1.888. Se você comprou, vendeu ou manteve Bitcoin, Ethereum ou qualquer outra criptomoeda em 2026, este guia vai te ajudar a declarar corretamente e evitar problemas com a Receita Federal. Neste artigo, você vai aprender: * Quem é obrigado a declarar criptomoedas * Como funciona a isenção de R$ 35 mil por mês * Passo a passo para declarar na DIRPF 2026 * Como calcular e pagar o DARF mensal (código 4600) * Novidades do DeCripto (IN RFB 2.291/2026) * Ferramentas e calculadoras para facilitar o processo *** ## Obrigatoriedade: Quem Deve Declarar Criptomoedas? ### Declaração Anual (DIRPF) Você é **obrigado a declarar** criptomoedas na Declaração de Imposto de Renda Pessoa Física (DIRPF) se: | Situação | Obrigatoriedade | | ------------------------------------------------------------------ | --------------- | | Possui criptoativos com custo de aquisição **≥ R$ 5.000** por tipo | ✅ Obrigatório | | Vendeu criptoativos com valor total **> R$ 35.000/mês** | ✅ Obrigatório | | Obteve ganho de capital tributável | ✅ Obrigatório | | Possui apenas criptoativos \< R$ 5.000 por tipo | ❌ Facultativo | ### Declaração Mensal (DeCripto) A **IN RFB 2.291/2026** instituiu o DeCripto, que exige declaração mensal obrigatória para: | Operação | Limite Mensal | Prazo | | --------------------------------------- | -------------------------------- | ------------------------------- | | Operações em exchanges **brasileiras** | Exchange reporta automaticamente | - | | Operações em exchanges **estrangeiras** | R$ 30.000/mês | Último dia útil do mês seguinte | | Operações P2P ou DEX | R$ 30.000/mês | Último dia útil do mês seguinte | ``` ┌─────────────────────────────────────────────────────────────────┐ │ FLUXO DE DECLARAÇÃO │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │ │ │ COMPRA │───▶│ POSSE │───▶│ VENDA > R$35K │ │ │ │ Criptos │ │ (DIRPF) │ │ (DARF mensal) │ │ │ └─────────────┘ └─────────────┘ └─────────────────────┘ │ │ │ │ │ │ │ ▼ ▼ ▼ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐ │ │ │ DeCripto │ │ Bens e │ │ GCAP + DARF │ │ │ │ (mensal) │ │ Direitos │ │ código 4600 │ │ │ └─────────────┘ └─────────────┘ └─────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` *** ## Isenção de R$ 35 Mil: Como Funciona A isenção de Imposto de Renda sobre ganhos de capital em criptomoedas funciona assim: ### Regra Principal Se o **total das suas vendas** de criptoativos no mês for **≤ R$ 35.000**, o ganho de capital é **isento** de tributação. ### Pontos Importantes 1. **O limite é sobre vendas, não sobre lucro**: Se você vendeu R$ 40.000 e teve R$ 5.000 de lucro, você paga imposto sobre os R$ 5.000 2. **Soma todas as criptomoedas**: O limite considera a soma de todas as suas vendas (BTC + ETH + altcoins) 3. **Mensal e não cumulativo**: Cada mês tem seu próprio limite de R$ 35.000 4. **Não inclui stablecoins pareadas ao real**: Operações BRL→BRZ→BRL podem ter tratamento diferente ### Exemplo Prático **Cenário:** Você vendeu R$ 25.000 em BTC e R$ 15.000 em ETH no mesmo mês. | Operação | Valor Venda | Custo Aquisição | Lucro | | --------- | ------------- | --------------- | ------------ | | BTC | R$ 25.000 | R$ 20.000 | R$ 5.000 | | ETH | R$ 15.000 | R$ 12.000 | R$ 3.000 | | **Total** | **R$ 40.000** | **R$ 32.000** | **R$ 8.000** | **Análise Tributária:** | Item | Valor | | ---------------------- | ----------------------------------- | | Total de vendas no mês | R$ 40.000,00 | | Lucro bruto | R$ 8.000,00 | | Status | Vendas > R$ 35.000 - **TRIBUTÁVEL** | | Imposto devido (15%) | **R$ 1.200,00** | > Como as vendas totais (R$ 40.000) ultrapassaram o limite de isenção de R$ 35.000, o ganho de capital de R$ 8.000 é tributado em 15%. *** ## Alíquotas de Imposto sobre Ganho de Capital As alíquotas são **progressivas** e baseadas no lucro total acumulado: | Faixa de Ganho de Capital | Alíquota | | ------------------------- | --------- | | Até R$ 5 milhões | **15%** | | De R$ 5M a R$ 10 milhões | **17,5%** | | De R$ 10M a R$ 30 milhões | **20%** | | Acima de R$ 30 milhões | **22,5%** | > **Nota**: Para a grande maioria dos investidores, a alíquota aplicável é de **15%**. *** ## Passo a Passo: Declarar Criptomoedas na DIRPF 2026 ### Etapa 1: Reunir Documentação Antes de começar, organize: * [ ] Extratos de todas as exchanges utilizadas (brasileiras e estrangeiras) * [ ] Histórico de operações P2P ou DEX * [ ] Comprovantes de compra e venda * [ ] Preço médio de aquisição de cada criptoativo * [ ] DARFs pagos durante o ano (se houver) ### Etapa 2: Calcular Preço Médio de Aquisição O custo de aquisição deve ser calculado pelo **método PEPS** (Primeiro que Entra, Primeiro que Sai) ou **preço médio ponderado**: **Exemplo de Cálculo - Preço Médio Ponderado (BTC):** | Data | Operação | Quantidade | Preço Unit. | Valor Total | Qtd Acumulada | Preço Médio | | ---------- | -------- | ---------- | ----------- | ----------- | ------------- | ----------- | | 15/01/2024 | Compra | 0,10 BTC | R$ 220.000 | R$ 22.000 | 0,10 BTC | R$ 220.000 | | 20/03/2024 | Compra | 0,05 BTC | R$ 350.000 | R$ 17.500 | 0,15 BTC | R$ 263.333 | | 10/11/2024 | Venda | 0,08 BTC | R$ 580.000 | R$ 46.400 | 0,07 BTC | R$ 263.333 | **Cálculo do Lucro na Venda:** | Item | Valor | | -------------------------------------- | ---------------- | | Valor da venda | R$ 46.400,00 | | Custo de aquisição (0,08 × R$ 263.333) | R$ 21.066,64 | | **Lucro** | **R$ 25.333,36** | **Posição Final:** * Quantidade restante: 0,07 BTC * Custo total restante: R$ 18.433,36 * Preço médio: R$ 263.333,00/BTC ### Etapa 3: Declarar na Ficha "Bens e Direitos" Na DIRPF 2026, acesse a ficha **Bens e Direitos** e use os códigos corretos: | Código | Descrição | Exemplos | | ------------ | ------------------------------ | --------------------------- | | **Grupo 08** | Criptoativos | - | | 08 - 01 | Criptoativo Bitcoin (BTC) | Bitcoin | | 08 - 02 | Outras criptomoedas (altcoins) | ETH, SOL, ADA, XRP | | 08 - 03 | Stablecoins | USDT, USDC, BRZ | | 08 - 10 | Criptoativos - NFTs | Tokens não fungíveis | | 08 - 99 | Outros criptoativos | DeFi tokens, utility tokens | ### Preenchimento do Campo "Discriminação" Modelo de texto para o campo discriminação: ``` BITCOIN (BTC) Quantidade: 0.15000000 BTC Custodiado em: Mercado Bitcoin (CNPJ: XX.XXX.XXX/0001-XX) Data da primeira aquisição: 15/01/2024 Preço médio de aquisição: R$ 256.666,67/BTC ``` ### Etapa 4: Declarar Ganhos de Capital (GCAP) Se você teve vendas **> R$ 35.000/mês** com lucro, deve: 1. Preencher o **GCAP** (Programa de Ganhos de Capital) 2. Importar os dados para a DIRPF 3. Verificar se pagou os DARFs mensais **Informações para Preenchimento do DARF:** | Campo | Valor | | ------------------- | -------------------------------------------------- | | Código da Receita | **4600** | | Descrição | IRPF - Ganho de Capital - Alienação de Criptoativo | | Período de Apuração | Mês/Ano da venda (ex: 11/2024) | | Vencimento | Último dia útil do mês seguinte | | Valor Principal | Lucro × 15% (para maioria dos casos) | **Exemplo:** Lucro de R$ 8.000 em novembro/2024 * Imposto devido: R$ 8.000 × 15% = **R$ 1.200,00** * Vencimento: 31/12/2024 *** ## DARF Código 4600: Pagamento Mensal ### Quando Pagar O DARF deve ser pago até o **último dia útil do mês seguinte** à venda com lucro (quando vendas > R$ 35k/mês). | Mês da Venda | Vencimento DARF | | -------------- | --------------- | | Janeiro/2024 | 29/02/2024 | | Fevereiro/2024 | 29/03/2024 | | Março/2024 | 30/04/2024 | | ... | ... | | Dezembro/2024 | 31/01/2026 | ### Como Emitir o DARF 1. Acesse o **Sicalc Web** ([https://sicalc.receita.economia.gov.br](https://sicalc.receita.economia.gov.br)) 2. Escolha "Preenchimento Rápido" 3. Preencha: * Código da Receita: **4600** * Período de Apuração: mês/ano da venda * Valor Principal: imposto calculado * CPF do contribuinte ### Atraso no Pagamento Se você não pagou o DARF no prazo, há incidência de multa e juros: **Regras de Multa e Juros:** | Componente | Cálculo | | ---------- | -------------------------------------- | | **Multa** | 0,33% ao dia de atraso, limitada a 20% | | **Juros** | Taxa SELIC acumulada do período | **Exemplo de DARF em Atraso:** Situação: DARF de R$ 1.200,00 com vencimento em 31/12/2024, pago em 15/02/2025 (46 dias de atraso): | Item | Valor | | ---------------------------------- | --------------- | | Valor original | R$ 1.200,00 | | Dias de atraso | 46 dias | | Multa (46 × 0,33% = 15,18%) | R$ 182,16 | | Juros SELIC (\~1,5 mês × 0,9%/mês) | R$ 16,20 | | **Valor total a pagar** | **R$ 1.398,36** | > Utilize o Sicalc Web para calcular o valor atualizado automaticamente. *** ## DeCripto: Nova Obrigação Mensal (IN RFB 2.291/2026) A partir de 2026, o **DeCripto** (Declaração de Criptoativos) substitui a antiga obrigação da IN 1.888: ### O que Mudou | Aspecto | Antes (IN 1.888) | Agora (DeCripto) | | ------------- | ---------------------------- | ---------------------------- | | Nome | Declaração de operações | DeCripto | | Limite mensal | R$ 30.000 | R$ 30.000 | | Integração | Manual | Automática com DIRPF | | Prazo | Último dia útil mês seguinte | Último dia útil mês seguinte | | Penalidades | Multa fixa | Multa progressiva | ### Quem Declara no DeCripto ``` ┌─────────────────────────────────────────────────────────────────┐ │ FLUXO DeCripto │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Exchange Brasileira Exchange Estrangeira │ │ (Binance BR, MB, etc.) (Binance Global, Coinbase) │ │ │ │ │ │ ▼ ▼ │ │ ┌───────────────┐ ┌───────────────┐ │ │ │ Exchange │ │ VOCÊ declara │ │ │ │ declara por │ │ se operações │ │ │ │ você (auto) │ │ > R$ 30k/mês │ │ │ └───────────────┘ └───────────────┘ │ │ │ │ Operações P2P / DEX │ │ │ │ │ ▼ │ │ ┌───────────────────────────────────┐ │ │ │ VOCÊ declara se > R$ 30k/mês │ │ │ └───────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` ### Penalidades por Não Declarar | Infração | Multa | | ---------------------- | ------------------------------- | | Não entrega | 1,5% do valor das operações/mês | | Entrega em atraso | R$ 100 a R$ 1.500 por mês | | Informações incorretas | 3% do valor, mínimo R$ 100 | *** ## Ferramentas e Calculadoras ### Calculadora Completa de IR sobre Cripto **Alíquotas Progressivas de Ganho de Capital:** | Faixa de Lucro | Alíquota | | ---------------- | -------- | | Até R$ 5 milhões | 15% | | R$ 5M a R$ 10M | 17,5% | | R$ 10M a R$ 30M | 20% | | Acima de R$ 30M | 22,5% | **Exemplo de Relatório Anual:** | Mês | Total Vendas | Lucro | Status | Imposto | | ------- | ------------ | --------- | ---------- | -------- | | 01/2024 | R$ 20.000 | R$ 5.000 | ISENTO | R$ 0 | | 03/2024 | R$ 50.000 | R$ 12.000 | TRIBUTÁVEL | R$ 1.800 | | 06/2024 | R$ 25.000 | R$ 5.000 | ISENTO | R$ 0 | | 11/2024 | R$ 50.000 | R$ 15.000 | TRIBUTÁVEL | R$ 2.250 | **Resumo Anual:** | Item | Valor | | ------------------------ | --------------- | | Total de vendas | R$ 145.000,00 | | Lucro total | R$ 37.000,00 | | **Imposto total devido** | **R$ 4.050,00** | Para acompanhar cotações atualizadas de criptomoedas, utilize a API da brapi.dev: ```typescript // Buscar cotação de Bitcoin via brapi.dev const response = await fetch( "https://brapi.dev/api/v2/crypto?coin=BTC¤cy=BRL", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }, } ); const { coins } = await response.json(); const btc = coins[0]; // btc.regularMarketPrice - Preço atual em BRL ``` *** ## Monitorando seu Portfólio com brapi.dev Para acompanhar suas criptomoedas e calcular valores para declaração, use a API da brapi.dev: ```typescript // Buscar cotações de múltiplas criptomoedas via brapi.dev const moedas = ["BTC", "ETH", "SOL"]; const holdings = { BTC: 0.15, ETH: 1.5, SOL: 10 }; let valorTotal = 0; for (const moeda of moedas) { const response = await fetch( `https://brapi.dev/api/v2/crypto?coin=${moeda}¤cy=BRL`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }, } ); const { coins } = await response.json(); const preco = coins[0].regularMarketPrice; const valor = holdings[moeda] * preco; valorTotal += valor; console.log(`${moeda}: ${holdings[moeda]} × R$ ${preco} = R$ ${valor}`); } console.log(`Valor total do portfólio: R$ ${valorTotal}`); ``` **Exemplo de Portfólio para Declaração:** | Moeda | Quantidade | Preço Unitário | Valor Total | | --------- | ----------- | -------------- | ----------------- | | BTC | 0,15000000 | R$ 580.000,00 | R$ 87.000,00 | | ETH | 1,50000000 | R$ 18.500,00 | R$ 27.750,00 | | SOL | 10,00000000 | R$ 1.200,00 | R$ 12.000,00 | | **Total** | - | - | **R$ 126.750,00** | > O valor de mercado serve como referência. Na declaração, use sempre o **custo de aquisição** (preço médio de compra). *** ## Situações Especiais ### Staking e Yield Farming Rendimentos de staking e yield farming são tributados como **rendimento**: | Tipo | Tratamento Fiscal | | --------------- | ------------------------------------------------- | | Staking rewards | Rendimento tributável na data do recebimento | | Yield farming | Rendimento tributável + ganho de capital na venda | | Airdrops | Rendimento tributável (custo zero) | | Hardforks | Custo de aquisição zero, ganho na venda | ### NFTs NFTs seguem regras similares às criptomoedas: * Código na DIRPF: **08-10** (Criptoativos - NFTs) * Isenção de R$ 35 mil também se aplica * Royalties recebidos são tributados como rendimento ### Operações em Exchanges Estrangeiras Se você opera em Binance Global, Coinbase, Kraken, etc: 1. **Você é responsável** pela declaração no DeCripto (se > R$ 30k/mês) 2. Converta valores para BRL pela cotação do dia 3. Mantenha registros detalhados de todas as operações *** ## Perguntas Frequentes (FAQ) ### 1. Preciso declarar cripto se só comprei e não vendi? **Sim**, se o valor de aquisição de qualquer criptoativo for ≥ R$ 5.000, você deve declarar na ficha "Bens e Direitos", mesmo sem ter vendido. ### 2. Perdi dinheiro com cripto. Posso compensar o prejuízo? **Sim**, prejuízos em criptoativos podem ser compensados com ganhos futuros em criptoativos. Mantenha registro dos prejuízos para compensação. ### 3. Operei apenas em exchange brasileira. Preciso fazer algo? A exchange reporta suas operações automaticamente. Você só precisa declarar na DIRPF anual se tiver posição ≥ R$ 5k ou vendas > R$ 35k/mês com lucro. ### 4. Como declarar Bitcoin recebido como pagamento? Declare como rendimento pelo valor de mercado na data do recebimento. Esse valor será seu custo de aquisição para futura venda. ### 5. Troquei BTC por ETH. Preciso pagar imposto? **Sim**, permuta entre criptoativos é considerada alienação. Calcule o ganho de capital na "venda" do BTC pelo valor de mercado do ETH recebido. ### 6. Quanto tempo devo guardar os comprovantes? Guarde todos os comprovantes por no mínimo **5 anos** após a declaração, conforme prazo decadencial da Receita Federal. ### 7. O que acontece se eu não declarar? Você fica sujeito a: * Multa de 75% sobre o imposto devido (até 150% em caso de fraude) * Juros SELIC * Possível processo por sonegação fiscal ### 8. ETFs de cripto na Bolsa Brasileira (HASH11, BITH11) seguem as mesmas regras? **Não**. ETFs de criptomoedas negociados na bolsa brasileira seguem regras de renda variável, não de criptoativos. Isenção de R$ 20k/mês em vendas (não R$ 35k). *** ## Checklist Final para Declaração 2026 ### Documentação Necessária * [ ] Extratos de exchanges brasileiras (Mercado Bitcoin, Binance BR, Foxbit, etc.) * [ ] Extratos de exchanges estrangeiras (Binance Global, Coinbase, Kraken, etc.) * [ ] Registros de operações P2P e DEX * [ ] Comprovantes de DARFs pagos durante 2024 * [ ] Planilha de preço médio por criptoativo * [ ] Histórico de staking rewards e airdrops ### Verificações * [ ] Valor de aquisição ≥ R$ 5.000? → Declarar em Bens e Direitos * [ ] Vendas > R$ 35.000 em algum mês? → Verificar DARF pago * [ ] Operações em exchange estrangeira > R$ 30k/mês? → DeCripto entregue? * [ ] Teve prejuízo? → Registrar para compensação futura ### Na DIRPF * [ ] Incluir todos os criptoativos em "Bens e Direitos" (Grupo 08) * [ ] Importar dados do GCAP (se aplicável) * [ ] Verificar consistência com declarações anteriores * [ ] Conferir se DARFs pagos estão refletidos *** ## Conclusão Declarar criptomoedas no Imposto de Renda 2026 exige atenção às regras atualizadas do DeCripto (IN RFB 2.291/2026). Os pontos principais são: 1. **Declare posições ≥ R$ 5.000** em Bens e Direitos 2. **Isenção de R$ 35 mil/mês** sobre total de vendas 3. **DARF código 4600** para ganhos tributáveis 4. **DeCripto mensal** para operações > R$ 30k em exchanges estrangeiras 5. **Mantenha registros detalhados** por 5 anos Use as ferramentas e calculadoras deste guia para facilitar o processo e evitar problemas com a Receita Federal. *** ## Recursos Úteis * [brapi.dev - API de Criptomoedas](https://brapi.dev/docs) - Acompanhe cotações e monitore seu portfólio * [Receita Federal - GCAP](https://www.gov.br/receitafederal/pt-br/centrais-de-conteudo/download/pgd/gcap) - Programa de Ganhos de Capital * [Sicalc Web](https://sicalc.receita.economia.gov.br) - Emissão de DARF * [e-CAC](https://cav.receita.fazenda.gov.br) - Centro de Atendimento Virtual *** *Última atualização: Janeiro de 2026. Este conteúdo tem caráter informativo e não substitui orientação profissional de contador ou advogado tributarista.* # Como Declarar Investimentos no IR 2026: Guia Completo Passo a Passo URL: /blog/como-declarar-investimentos-imposto-renda-2026.mdx Declare ações, FIIs, ETFs, Tesouro Direto e criptomoedas no IR 2026. Passo a passo com códigos e exemplos práticos ✓ *** searchable: true title: 'Como Declarar Investimentos no IR 2026: Guia Completo Passo a Passo' description: 'Declare ações, FIIs, ETFs, Tesouro Direto e criptomoedas no IR 2026. Passo a passo com códigos e exemplos práticos ✓' date: '2026-01-01' keywords: 'declarar investimentos imposto de renda 2026, IR 2026, como declarar acoes, declarar FIIs, declarar tesouro direto, declarar ETF, declarar criptomoedas, malha fina, DARF, imposto renda variavel' author: 'Equipe brapi.dev' category: 'Tributação' subcategory: 'Imposto de Renda' readingTime: '32 min' tags: \['Imposto de Renda', 'IR 2026', 'Declaração', 'Ações', 'FIIs', 'ETFs', 'Tesouro Direto', 'Criptomoedas', 'DARF'] relatedPosts: \['tesouro-direto-guia-completo-2026-como-investir', 'fundos-imobiliarios-fiis-guia-completo-iniciantes', 'guia-bogleheads-brasil-investimento-passivo-etfs', 'bdrs-guia-completo-investir-empresas-americanas-2026', 'etfs-brasil-guia-completo-bova11-ivvb11'] featured: true expertise: 'Tributação de investimentos e declaração de imposto de renda' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > A declaração de investimentos no Imposto de Renda pode parecer complicada, mas com este guia você vai entender exatamente como declarar cada tipo de ativo. Evite a malha fina e aproveite as isenções fiscais legais. *** ## Quem Precisa Declarar Investimentos? Você é **obrigado** a declarar o Imposto de Renda 2026 (ano-base 2026) se se enquadrar em pelo menos um dos critérios abaixo: ### Critérios de Obrigatoriedade | Critério | Limite | | ----------------------- | ------------------------------------ | | Rendimentos tributáveis | Acima de R$ 30.639,90 | | Rendimentos isentos | Acima de R$ 200.000,00 | | Patrimônio em bens | Acima de R$ 800.000,00 | | Operações em bolsa | Qualquer valor | | Ganho de capital | Qualquer valor | | Atividade rural | Receita bruta acima de R$ 153.199,50 | > **Importante**: Se você realizou **qualquer operação em bolsa de valores** (compra ou venda de ações, FIIs, ETFs, BDRs), você é obrigado a declarar, independentemente do valor. ### Prazo de Entrega 2026 * **Início**: 17 de março de 2026 * **Término**: 30 de maio de 2026 * **Multa por atraso**: 1% ao mês sobre o imposto devido (mínimo R$ 165,74) *** ## Estrutura da Declaração de Investimentos A declaração de investimentos envolve três partes principais: **Estrutura da Declaração:** | Parte | Onde Declarar | O Que Declarar | Obrigatório? | | ---------------- | ------------------------------ | ------------------------------------ | ------------------- | | Bens e Direitos | Ficha "Bens e Direitos" | Posição em 31/12 de cada ativo | Sim, para todos | | Rendimentos | Fichas específicas por tipo | Dividendos, JCP, rendimentos de FIIs | Sim, para recebidos | | Ganho de Capital | Ficha "Renda Variável" ou GCAP | Lucro ou prejuízo na venda | Sim, para vendas | *** ## Como Declarar Ações ### 1. Bens e Direitos - Posição em Carteira **Código**: 31 - Ações (inclusive as listadas em bolsa) **Grupo**: 03 - Participações Societárias **Informações obrigatórias:** * CNPJ da empresa * Quantidade de ações * Custo total de aquisição * Discriminação detalhada **Exemplo de discriminação:** ``` 500 ações PETR4 - Petróleo Brasileiro S.A. CNPJ: 33.000.167/0001-01 Corretora: XP Investimentos Custo médio: R$ 35,20 por ação Custo total: R$ 17.600,00 ``` ### 2. Rendimentos - Dividendos e JCP #### Dividendos (Isentos de IR) **Ficha**: Rendimentos Isentos e Não Tributáveis **Código**: 09 - Lucros e dividendos recebidos **Exemplo - Dividendos ITUB4:** * **Empresa:** Itaú Unibanco S.A. * **CNPJ:** 60.872.504/0001-23 * **Valor recebido:** R$ 1.250,00 * **Tributação:** Isento * **Onde declarar:** Rendimentos Isentos - Código 09 #### Juros sobre Capital Próprio (JCP) **Ficha**: Rendimentos Sujeitos à Tributação Exclusiva **Código**: 10 - Juros sobre capital próprio **Exemplo - JCP BBDC4:** * **Empresa:** Banco Bradesco S.A. * **CNPJ:** 60.746.948/0001-12 * **Valor bruto:** R$ 500,00 * **IR retido (15%):** R$ 75,00 * **Valor líquido:** R$ 425,00 * **Onde declarar:** Tributação Exclusiva - Código 10 ### 3. Ganho de Capital - Vendas de Ações #### Isenção para Operações Normais (Swing Trade) > **Isenção**: Vendas de ações até **R$ 20.000 por mês** são isentas de IR (apenas operações normais, não day trade). **Tributação de Ações:** | Tipo de Operação | Valor Venda/mês | Alíquota | Observação | | ---------------- | ------------------ | --------------- | ---------------------------------------- | | Swing Trade | Até R$ 20.000 | **Isento** | Vendas até R$ 20k/mês são isentas | | Swing Trade | Acima de R$ 20.000 | 15% sobre lucro | DARF até último dia útil do mês seguinte | | Day Trade | Qualquer valor | 20% sobre lucro | Nunca é isento | **Exemplo:** Vendeu R$ 25.000 com lucro de R$ 3.000 (swing trade) * Imposto devido: R$ 3.000 × 15% = **R$ 450,00** #### Como Preencher a Ficha de Renda Variável Na ficha **Renda Variável > Operações Comuns/Day-Trade**, preencha mês a mês: | Campo | Descrição | | ----------------------- | ------------------------------ | | Mercado à vista - Ações | Lucro ou prejuízo do mês | | Prejuízo a compensar | Prejuízos de meses anteriores | | Base de cálculo | Lucro - Prejuízos compensados | | Imposto devido | 15% (swing) ou 20% (day trade) | | IR fonte | Valor retido na fonte (0,005%) | | Imposto a pagar | Devido - IR fonte | *** ## Como Declarar FIIs (Fundos Imobiliários) ### 1. Bens e Direitos **Código**: 73 - Fundo de Investimento Imobiliário **Grupo**: 07 - Fundos **Exemplo de discriminação:** ``` 100 cotas HGLG11 - CSHG Logística FII CNPJ: 11.728.688/0001-47 Administrador: Credit Suisse Hedging-Griffo Corretora: Clear Custo médio: R$ 165,00 por cota Custo total: R$ 16.500,00 ``` ### 2. Rendimentos de FIIs (Isentos para PF) **Ficha**: Rendimentos Isentos e Não Tributáveis **Código**: 26 - Outros rendimentos isentos > **Importante**: Rendimentos de FIIs são **isentos de IR** para pessoa física, desde que: > > * O FII tenha no mínimo 50 cotistas > * As cotas sejam negociadas em bolsa > * O cotista possua menos de 10% das cotas **Exemplo - Rendimento FII XPLG11:** * **Fundo:** XP Log FII * **CNPJ:** 26.502.794/0001-85 * **Rendimentos no ano:** R$ 1.560,00 (12 × R$ 130) * **Tributação:** Isento * **Onde declarar:** Rendimentos Isentos - Código 26 ### 3. Ganho de Capital na Venda de FIIs > **Atenção**: Diferente de ações, FIIs **NÃO têm isenção** para vendas até R$ 20.000. Todo lucro é tributado em 20%. **FIIs NÃO têm isenção para vendas até R$ 20.000.** Todo lucro é tributado em 20%. **Exemplo:** Lucro de R$ 500 na venda de FIIs * Alíquota: 20% * Imposto: R$ 500 × 20% = **R$ 100,00** * Vencimento DARF: Último dia útil do mês seguinte *** ## Como Declarar ETFs ### ETFs de Renda Variável (BOVA11, IVVB11, etc.) Seguem as mesmas regras de **ações**: * **Código Bens e Direitos**: 74 - ETF - Exchange Traded Fund * **Isenção**: Vendas até R$ 20.000/mês (swing trade) * **Alíquota**: 15% (swing) ou 20% (day trade) ### ETFs de Renda Fixa (IMAB11, FIXA11, etc.) Tributação na fonte, similar a fundos de investimento: * **IR retido na fonte**: 15% a 22,5% (tabela regressiva) * **Come-cotas**: Pode haver antecipação semestral **Declarando ETF nos Bens e Direitos:** * **Código:** 74 - ETF - Exchange Traded Fund * **Grupo:** 07 - Fundos * **Discriminação:** 50 cotas IVVB11 - iShares S\&P 500 FI * **CNPJ:** 19.909.560/0001-91 * **Custo total:** R$ 7.500,00 **Tributação na venda:** Isenção para vendas até R$ 20k/mês, 15% (swing) ou 20% (day trade) *** ## Como Declarar Tesouro Direto ### 1. Bens e Direitos **Código**: 45 - Aplicação de Renda Fixa (CDB, RDB e outros) **Grupo**: 04 - Aplicações e Investimentos **Exemplo de discriminação:** ``` Tesouro IPCA+ 2035 Quantidade: 2,5 títulos Data de compra: 15/03/2024 Valor aplicado: R$ 6.250,00 Corretora: BTG Pactual ``` ### 2. Rendimentos **Ficha**: Rendimentos Sujeitos à Tributação Exclusiva **Código**: 06 - Rendimentos de aplicações financeiras O IR já é retido na fonte pela corretora. Basta informar conforme o informe de rendimentos. **Exemplo - Tesouro Selic 2029:** * **Posição em 31/12:** R$ 10.500,00 (valor atualizado) * **Custo de aquisição:** R$ 10.000,00 (declarar na ficha de bens) * **Rendimento no ano:** R$ 1.425,00 * **IR retido (15%):** R$ 213,75 * **Rendimento líquido:** R$ 1.211,25 *** ## Como Declarar Investimentos no Exterior ### 1. Bens e Direitos **Código**: 74 - Aplicações e investimentos no exterior **Grupo**: 04 - Aplicações e Investimentos Para cada ativo no exterior, informe: * Nome do ativo e corretora * País * Valor em moeda original e em reais (câmbio de 31/12) **Exemplo - ETF Irlandês:** ``` 500 cotas VWRA - Vanguard FTSE All-World UCITS ETF Corretora: Interactive Brokers País: Irlanda Valor: USD 55.000,00 Câmbio PTAX 31/12/2024: R$ 4,8412 Valor em reais: R$ 266.266,00 ``` ### 2. Ganho de Capital no Exterior > **Isenção**: Vendas até **R$ 35.000 por mês** em ativos no exterior são isentas de IR. **Isenção no Exterior:** Vendas de ativos no exterior até **R$ 35.000 por mês** são isentas de IR. **Tabela Progressiva para Ganho de Capital no Exterior:** | Lucro | Alíquota | | ---------------------- | -------- | | Até R$ 5 milhões | 15% | | R$ 5 a 10 milhões | 17,5% | | R$ 10 a 30 milhões | 20% | | Acima de R$ 30 milhões | 22,5% | **Exemplo:** Vendeu USD 8.000 (R$ 40.000) com lucro de R$ 5.000 * Alíquota: 15% * Imposto: R$ 5.000 × 15% = **R$ 750,00** ### 3. Programa GCAP para Ganhos no Exterior Para ganhos de capital no exterior, use o programa **GCAP** (Programa de Apuração de Ganhos de Capital): 1. Baixe o GCAP no site da Receita Federal 2. Informe a operação de venda 3. Apure o ganho em reais 4. Pague o DARF até o último dia útil do mês seguinte 5. Importe os dados para a declaração anual *** ## Como Declarar Criptomoedas ### 1. Bens e Direitos **Código específico por criptomoeda:** | Criptomoeda | Código | | ------------------------ | ------ | | Bitcoin (BTC) | 81 | | Altcoins (ETH, etc.) | 82 | | Stablecoins (USDT, etc.) | 83 | | NFTs | 89 | | Outros criptoativos | 89 | **Grupo**: 08 - Criptoativos **Exemplo de discriminação:** ``` 0,5 Bitcoin (BTC) Exchange: Binance Custo de aquisição: R$ 85.000,00 Data de aquisição: 10/05/2024 ``` ### 2. Ganho de Capital > **Isenção**: Vendas de criptomoedas até **R$ 35.000 por mês** são isentas. **Isenção Cripto:** Vendas de criptomoedas até **R$ 35.000 por mês** são isentas de IR. **Tributação de Criptomoedas (acima de R$ 35k/mês):** | Lucro | Alíquota | | ---------------------- | -------- | | Até R$ 5 milhões | 15% | | R$ 5 a 10 milhões | 17,5% | | Acima de R$ 10 milhões | 20% | ### 3. Obrigatoriedade de Informar à Receita Se você opera com criptomoedas, pode ser obrigatório informar mensalmente: | Situação | Obrigatoriedade | | ----------------------- | -------------------------------- | | Exchange brasileira | Exchange reporta automaticamente | | Exchange estrangeira | Você deve informar via IN 1.888 | | Saldo acima de R$ 5.000 | Obrigatório declarar | *** ## Como Declarar BDRs BDRs (Brazilian Depositary Receipts) seguem regras específicas: ### 1. Bens e Direitos **Código**: 49 - BDR - Brazilian Depositary Receipt **Grupo**: 04 - Aplicações e Investimentos ### 2. Dividendos de BDRs **Atenção**: Dividendos de BDRs são **tributáveis** (diferente de ações brasileiras): **Tributação de BDRs:** | Tipo | Tributação | Alíquota | | ---------------- | ----------------- | ------------------------------ | | Dividendos | Carnê-leão mensal | Tabela progressiva (até 27,5%) | | Ganho de Capital | **Sem isenção** | 15% (swing) ou 20% (day trade) | BDRs **NÃO têm isenção** para vendas até R$ 20.000. Todo lucro é tributado. ### 3. Ganho de Capital > **Importante**: BDRs **NÃO têm isenção** para vendas até R$ 20.000. Todo lucro é tributado. *** ## Compensação de Prejuízos ### Regras de Compensação **Regras de Compensação de Prejuízos:** | Ativo | Compensa com | NÃO compensa com | | ----------------- | ---------------------- | ------------------------ | | Ações (swing) | Lucro swing de ações | FII, cripto, day trade | | Ações (day trade) | Apenas lucro day trade | Swing trade, FII, cripto | | FIIs | Apenas lucro de FIIs | Ações, cripto | | Cripto | Apenas lucro de cripto | Ações, FIIs | **Prazo:** Prejuízos podem ser carregados indefinidamente ### Exemplo Prático de Compensação **Exemplo de Compensação:** Lucro de R$ 5.000 no mês com prejuízo acumulado de R$ 3.000: | Descrição | Valor | | ------------------- | ------------ | | Lucro do mês | R$ 5.000 | | Prejuízo compensado | R$ 3.000 | | **Base de cálculo** | **R$ 2.000** | | Imposto (15%) | R$ 300,00 | | Prejuízo restante | R$ 0 | *** ## DARF - Como Emitir e Pagar ### Quando é Necessário Emitir DARF? | Situação | DARF Necessário? | | ------------------------------------------ | ---------------- | | Vendas de ações até R$ 20k/mês | Não | | Vendas de ações acima R$ 20k/mês com lucro | Sim | | Qualquer venda de FII com lucro | Sim | | Day trade com lucro | Sim | | Vendas no exterior acima R$ 35k/mês | Sim | | Cripto acima R$ 35k/mês | Sim | ### Como Emitir DARF **Dados do DARF:** | Campo | Valor | | ----------------------------------- | --------------------------------- | | Código de receita (ações/FIIs) | 6015 | | Código de receita (exterior/cripto) | 4600 | | Período de apuração | Mês da operação (ex: 01/2026) | | Vencimento | Último dia útil do mês seguinte | | Onde emitir | Sicalc ou site da Receita Federal | ### Passo a Passo para Emitir 1. Acesse o site da Receita Federal 2. Vá em "Pagamentos" > "DARF" 3. Informe o código de receita 4. Preencha o período de apuração 5. Informe o valor do imposto 6. Gere o DARF e pague até o vencimento *** ## Documentos Necessários ### Informe de Rendimentos Sua corretora deve disponibilizar até 28 de fevereiro: **O que a corretora fornece:** | Documento | Informações | | -------------------------- | ------------------------------------------------------------------------------ | | **Informe de Rendimentos** | Dividendos, JCP (bruto e IR retido), rendimentos de FIIs, ganhos de renda fixa | | **Posição de Custódia** | Quantidade e custo médio de ações, FIIs, ETFs, títulos do Tesouro | | **Notas de Corretagem** | Para calcular custo médio e resultado das operações | ### Calculando Custo Médio **Como calcular custo médio:** O custo médio é calculado somando o valor total de aquisição (preço × quantidade + taxas) e dividindo pela quantidade total. **Exemplo de operações:** 1. Compra: 100 ações a R$ 30,00 + R$ 10 taxas = R$ 3.010 2. Compra: 50 ações a R$ 35,00 + R$ 8 taxas = R$ 1.758 3. Total: 150 ações, custo R$ 4.768 → **Custo médio: R$ 31,79** Quando vende, o custo médio é usado para calcular o lucro/prejuízo. *** ## Usando brapi.dev para Controle de Investimentos A [API brapi.dev](/docs) pode ajudar no controle e declaração dos seus investimentos: ### Consultando Cotações para Posição Atual ```typescript // Consultar cotações atuais da carteira const tickers = ["PETR4", "VALE3", "ITUB4", "HGLG11"]; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(",")}`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); // data.results contém ticker, nome, preço atual e variação ``` ### Obtendo Dados de Dividendos ```typescript // Obter histórico de dividendos para declaração const response = await fetch( "https://brapi.dev/api/quote/ITUB4?dividends=true", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); // data.results[0].dividendsData.cashDividends contém histórico de proventos ``` *** ## Resumo: Tabela de Códigos ### Bens e Direitos | Ativo | Grupo | Código | | ------------------------- | ----- | ------ | | Ações | 03 | 31 | | FIIs | 07 | 73 | | ETFs | 07 | 74 | | BDRs | 04 | 49 | | Tesouro Direto | 04 | 45 | | CDB/LCI/LCA | 04 | 45 | | Bitcoin | 08 | 81 | | Altcoins | 08 | 82 | | Stablecoins | 08 | 83 | | Investimentos no exterior | 04 | 74 | ### Rendimentos Isentos (Código 09) * Dividendos de ações brasileiras * Rendimentos de FIIs (pessoa física) * Lucros e dividendos ### Tributação Exclusiva | Tipo | Código | | ---------------- | ---------------- | | JCP | 10 | | Renda Fixa | 06 | | Ganho de Capital | Ficha específica | *** ## Checklist da Declaração ### Antes de Começar * [ ] Reunir informes de rendimentos de todas as corretoras * [ ] Baixar notas de corretagem do ano * [ ] Calcular custo médio de cada ativo * [ ] Verificar DARFs pagos durante o ano * [ ] Levantar prejuízos acumulados de anos anteriores ### Durante a Declaração * [ ] Declarar posição em 31/12 de cada ativo * [ ] Informar rendimentos (dividendos, JCP, FIIs) * [ ] Preencher ficha de Renda Variável * [ ] Declarar investimentos no exterior * [ ] Informar criptoativos ### Após a Declaração * [ ] Conferir pendências no e-CAC * [ ] Guardar documentos por 5 anos * [ ] Acompanhar processamento *** ## Conclusão A declaração de investimentos exige atenção aos detalhes, mas seguindo este guia você consegue: 1. **Evitar a malha fina**: Declarando todos os ativos corretamente 2. **Aproveitar isenções**: R$ 20.000/mês em ações, R$ 35.000/mês no exterior 3. **Compensar prejuízos**: Reduzindo imposto futuro 4. **Manter controle**: Usando ferramentas como brapi.dev ### Próximos Passos * **[Tesouro Direto - Guia Completo](/blog/tesouro-direto-guia-completo-2026-como-investir)** - Entenda a renda fixa * **[FIIs - Guia Completo](/blog/fundos-imobiliarios-fiis-guia-completo-iniciantes)** - Invista em imóveis * **[API brapi.dev](/docs)** - Acompanhe seus investimentos * **[Calculadora de Dividendos](/calculadoras/dividendos)** - Projete sua renda passiva *** **Disclaimer:** Este conteúdo é educacional e não substitui orientação de contador ou advogado tributário. As regras fiscais podem mudar. Consulte sempre a legislação atualizada e um profissional qualificado. **Atualizado para:** Declaração IR 2026 (ano-base 2024) # Como Investir com Pouco Dinheiro em 2026: Guia Completo para Iniciantes URL: /blog/como-investir-com-pouco-dinheiro-2026.mdx Aprenda a investir com R$ 50, R$ 100 ou R$ 500 por mês! Melhores investimentos para quem tem pouco dinheiro ✓ *** searchable: true title: 'Como Investir com Pouco Dinheiro em 2026: Guia Completo para Iniciantes' description: 'Aprenda a investir com R$ 50, R$ 100 ou R$ 500 por mês! Melhores investimentos para quem tem pouco dinheiro ✓' date: '2026-01-01' keywords: 'investir com pouco dinheiro, como investir 100 reais, investir 500 reais, investimento para iniciantes, investir pouco, onde investir pouco dinheiro, investir com 50 reais, primeiro investimento, investir sendo pobre' author: 'Equipe brapi.dev' category: 'Investimentos para Iniciantes' subcategory: 'Primeiros Passos' readingTime: '22 min' tags: \['Iniciantes', 'Pouco Dinheiro', 'Primeiro Investimento', 'Tesouro Direto', 'ETFs', 'Renda Fixa', 'Ações Fracionárias'] relatedPosts: \['tesouro-direto-guia-completo-2026-como-investir', 'como-investir-em-acoes-guia-completo-iniciantes', 'guia-bogleheads-brasil-investimento-passivo-etfs', 'como-comecar-investir-do-zero-guia-iniciantes-2026', 'o-que-sao-acoes-guia-iniciantes-2026'] featured: true expertise: 'Investimentos acessíveis para iniciantes e pequenos investidores' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > Você não precisa ser rico para começar a investir. Com R$ 30 já é possível aplicar no Tesouro Direto, e com R$ 1 você pode comprar frações de ações. Este guia mostra como fazer seu dinheiro trabalhar para você, mesmo começando com pouco. *** ## Por que Investir Mesmo com Pouco? O maior erro que iniciantes cometem é pensar que **precisam juntar muito dinheiro** antes de investir. A verdade é: | Mito | Realidade | | ----------------------------------- | ------------------------------------------ | | "Preciso de R$ 10.000 para começar" | Tesouro Direto começa em \~R$ 30 | | "Ações são só para ricos" | Mercado fracionário permite comprar 1 ação | | "Pouco dinheiro não faz diferença" | R$ 200/mês por 30 anos = R$ 500.000+ | | "Vou esperar ganhar mais" | Tempo no mercado > valor inicial | ### O Poder dos Juros Compostos **Simulação: Aportes mensais por 30 anos (10% a.a.)** | Aporte/mês | Total Investido | Patrimônio Final | Juros Ganhos | Multiplicador | | ---------- | --------------- | ---------------- | ------------ | ------------- | | R$ 100 | R$ 36.000 | R$ 226.048 | R$ 190.048 | 6,3x | | R$ 200 | R$ 72.000 | R$ 452.097 | R$ 380.097 | 6,3x | | R$ 500 | R$ 180.000 | R$ 1.130.243 | R$ 950.243 | 6,3x | > **Conclusão**: R$ 200/mês vira **mais de R$ 450.000** em 30 anos. O segredo é **começar cedo** e **ser consistente**. *** ## Quanto Preciso para Começar? ### Investimento Mínimo por Tipo | Investimento | Mínimo | Onde Investir | | ---------------------- | ----------- | ---------------------- | | Tesouro Direto | \~R$ 30 | Corretoras (taxa zero) | | CDB Liquidez Diária | R$ 1 | Nubank, Inter, C6 | | Ações (fracionário) | \~R$ 1-50 | Qualquer corretora | | ETFs (fracionário) | \~R$ 10-100 | Qualquer corretora | | FIIs | \~R$ 10-100 | Qualquer corretora | | Fundos de Investimento | R$ 1-500 | Bancos e corretoras | | Poupança | R$ 1 | Qualquer banco | ### Por Valor Disponível **Até R$ 50:** * **Opções:** Tesouro Selic, CDB Nubank, 1 ação fracionária * **Recomendação:** Comece pelo Tesouro Selic - mais seguro * **Rentabilidade esperada:** \~14% a.a. (Selic atual) **Até R$ 100:** * **Opções:** Tesouro Selic, CDB 100% CDI, ETF fracionário, 2-3 ações * **Recomendação:** Tesouro Selic para reserva + 1 ETF * **Rentabilidade esperada:** 10-14% a.a. **Até R$ 500:** * **Opções:** Carteira diversificada simples * **Recomendação:** 70% renda fixa + 30% ETF/ações * **Rentabilidade esperada:** 10-12% a.a. **Até R$ 1.000:** * **Opções:** Carteira completa * **Recomendação:** Diversificar entre RF, ações, FIIs, ETFs * **Rentabilidade esperada:** 10-15% a.a. *** ## Passo a Passo: Primeiro Investimento ### Passo 1: Organize suas Finanças Antes de investir, resolva o básico: **Checklist Financeiro Antes de Investir:** | Etapa | Ação | Por quê? | Prioridade | | ------------- | ---------------------------------------------------- | ------------------------------------------ | ---------- | | Dívidas caras | Quite primeiro: cartão, cheque especial, empréstimos | Juros de 300% a.a. > qualquer investimento | MÁXIMA | | Orçamento | Anote gastos por 1 mês | Entender para onde vai o dinheiro | Alta | | Sobra mensal | Identifique quanto pode investir (Ganhos - Gastos) | R$ 50-100/mês já faz diferença | Alta | > **Regra de Ouro**: Não invista dinheiro que você pode precisar nos próximos 6 meses. ### Passo 2: Monte sua Reserva de Emergência A reserva de emergência é **obrigatória** antes de investir em renda variável: **Reserva de Emergência por Perfil:** | Perfil | Meses de Reserva | Exemplo (gasto R$ 2.500/mês) | | ------------------- | ---------------- | ---------------------------- | | Funcionário público | 3 meses | R$ 7.500 | | CLT estável | 6 meses | R$ 15.000 | | Autônomo | 9 meses | R$ 22.500 | | Empreendedor | 12 meses | R$ 30.000 | **Onde deixar:** Tesouro Selic, CDB 100% CDI liquidez diária, Nubank **Onde deixar a reserva:** 1. **Tesouro Selic** - Mais seguro, rende \~14% a.a. 2. **CDB Nubank/Inter** - 100% CDI, liquidez imediata 3. **Conta remunerada** - PicPay, Mercado Pago (\~100% CDI) ### Passo 3: Abra Conta em uma Corretora Escolha uma corretora com **taxa zero** para Tesouro Direto e bolsa: | Corretora | Taxa TD | Taxa Ações | Destaque | | --------- | ------- | ---------- | ---------------------- | | Nubank | Zero | Zero | App simples | | XP | Zero | Zero | Plataforma completa | | Clear | Zero | Zero | Foco em custo zero | | Rico | Zero | Zero | Boa para iniciantes | | BTG | Zero | Zero | Banco de investimentos | | Inter | Zero | Zero | Super app | ### Passo 4: Faça seu Primeiro Aporte **Primeiro Investimento Recomendado:** Para quem tem R$ 100 disponíveis: * **Ativo:** Tesouro Selic 2029 * **Valor:** R$ 100 * **Motivo:** Seguro, líquido, melhor que poupança * **Próximos passos:** Mantenha aportes mensais até completar reserva *** ## Melhores Investimentos para Pouco Dinheiro ### 1. Tesouro Selic - O Melhor Começo **Mínimo**: \~R$ 30 **Rentabilidade**: \~15% a.a. (Selic atual) **Risco**: Praticamente zero **Exemplo: R$ 100 no Tesouro Selic por 1 ano (15% a.a.)** | Descrição | Valor | | ------------------------- | ------------------------ | | Rendimento bruto | R$ 114,25 | | IR (20% sobre rendimento) | R$ 2,85 | | **Valor líquido** | **R$ 111,40** | | Poupança renderia | R$ 106,17 | | **Diferença vs poupança** | **+R$ 5,23 (5% a mais)** | **Por que começar pelo Tesouro Selic:** * Garantia do Governo Federal * Liquidez D+1 (resgate em 1 dia útil) * Rende mais que poupança (quase o dobro!) * Sem volatilidade * Ideal para reserva de emergência ### 2. CDB Liquidez Diária - Praticidade **Mínimo**: R$ 1 (Nubank, Inter) **Rentabilidade**: 100% a 102% do CDI **Risco**: Baixo (FGC até R$ 250 mil) **Opções de CDB Liquidez Diária:** | Banco | Rentabilidade | Mínimo | Liquidez | Garantia | | ------- | ------------- | ------ | -------- | -------- | | Nubank | 100% CDI | R$ 1 | Imediata | FGC | | Inter | 100% CDI | R$ 1 | Imediata | FGC | | C6 Bank | 102% CDI | R$ 20 | Imediata | FGC | ### 3. Ações no Mercado Fracionário O mercado fracionário permite comprar **a partir de 1 ação**: **Mínimo**: Preço de 1 ação (R$ 5 a R$ 100+) **Rentabilidade**: Variável **Risco**: Alto ```typescript // Encontrar ações acessíveis para pequenos investidores const tickers = ["PETR4", "VALE3", "ITUB4", "BBDC4", "BBAS3", "TAEE11", "WEGE3"]; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(",")}`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); // Filtre ações com preço <= R$ 30 para investir com pouco ``` **Exemplos de ações acessíveis (preços ilustrativos):** | Ticker | Preço | Setor | | ------ | -------- | -------- | | CPLE6 | R$ 10,50 | Elétrico | | BBAS3 | R$ 28,00 | Bancário | | ITUB4 | R$ 32,00 | Bancário | | PETR4 | R$ 38,00 | Petróleo | **Como comprar no fracionário:** * Adicione "F" ao final do ticker: PETR4F, VALE3F * Compre de 1 a 99 ações * Mesmos direitos de uma ação normal ### 4. ETFs - Diversificação Instantânea ETFs permitem investir em dezenas de ações com uma única compra: | ETF | O que é | Preço Aprox.\* | Mínimo Fracionário | | ------ | ---------- | -------------- | ------------------ | | BOVA11 | Ibovespa | R$ 130 | \~R$ 130 | | IVVB11 | S\&P 500 | R$ 280 | \~R$ 280 | | SMAL11 | Small Caps | R$ 100 | \~R$ 100 | | DIVO11 | Dividendos | R$ 70 | \~R$ 70 | \*Preços ilustrativos **Sugestão de Carteira ETF por Valor Mensal:** | Aporte/mês | Alocação Sugerida | Motivo | | ---------- | ------------------------------------------------- | ----------------------------------- | | \< R$ 100 | 100% Tesouro Selic | Valor muito baixo para diversificar | | R$ 100-300 | 70% Tesouro Selic + 30% BOVA11 (fracionário) | Começo de diversificação | | > R$ 300 | 50% Tesouro Selic/IPCA+ + 25% BOVA11 + 25% IVVB11 | Carteira diversificada Brasil + EUA | ### 5. FIIs - Imóveis com R$ 10 Fundos Imobiliários (FIIs) permitem investir em imóveis comerciais: **Mínimo**: Preço de 1 cota (R$ 10 a R$ 150) **Rentabilidade**: Dividendos mensais + valorização **Risco**: Médio **FIIs Acessíveis para Iniciantes:** | Ticker | Preço | Tipo | Dividend Yield | | ------ | --------- | --------- | -------------- | | MXRF11 | R$ 10,50 | Papel | 12% | | XPLG11 | R$ 95,00 | Logística | 9% | | HGLG11 | R$ 155,00 | Logística | 8% | | KNRI11 | R$ 140,00 | Híbrido | 8% | *** ## Carteiras Modelo por Valor ### Carteira R$ 100/mês **Fase:** Acumulação de reserva | Ativo | Alocação | Valor | | ------------- | -------- | ------ | | Tesouro Selic | 100% | R$ 100 | **Objetivo:** Montar reserva de emergência **Duração:** Até ter 6 meses de gastos guardados **Próximo passo:** Após reserva, começar a diversificar ### Carteira R$ 300/mês **Fase:** Início da diversificação | Ativo | Alocação | Valor | | ------------- | -------- | ------ | | Tesouro Selic | 60% | R$ 180 | | BOVA11 | 25% | R$ 75 | | FII (MXRF11) | 15% | R$ 45 | **Objetivo:** Reserva + exposição a renda variável **Rebalanceamento:** A cada 3 meses ### Carteira R$ 500/mês **Fase:** Carteira diversificada | Ativo | Alocação | Valor | | ------------------- | -------- | ------ | | Tesouro Selic/IPCA+ | 40% | R$ 200 | | BOVA11 | 20% | R$ 100 | | IVVB11 | 15% | R$ 75 | | FIIs | 15% | R$ 75 | | Ações individuais | 10% | R$ 50 | **Objetivo:** Crescimento de longo prazo **Rebalanceamento:** Trimestral ### Carteira R$ 1.000/mês **Fase:** Carteira completa | Ativo | Alocação | Valor | | ------------------ | -------- | ------ | | Tesouro IPCA+ 2035 | 30% | R$ 300 | | Tesouro Selic | 10% | R$ 100 | | BOVA11 | 15% | R$ 150 | | IVVB11 | 15% | R$ 150 | | FIIs (3-4 fundos) | 15% | R$ 150 | | Ações dividendos | 15% | R$ 150 | **Objetivo:** Patrimônio + renda passiva **Rebalanceamento:** Trimestral *** ## Simulador: Quanto Terei no Futuro? **Simulação: R$ 200/mês por 30 anos (10% a.a.)** | Anos | Total Investido | Patrimônio | Ganhos | | ---- | --------------- | ---------- | ---------- | | 5 | R$ 12.000 | R$ 15.487 | R$ 3.487 | | 10 | R$ 24.000 | R$ 40.969 | R$ 16.969 | | 15 | R$ 36.000 | R$ 83.091 | R$ 47.091 | | 20 | R$ 48.000 | R$ 152.602 | R$ 104.602 | | 25 | R$ 60.000 | R$ 265.366 | R$ 205.366 | | 30 | R$ 72.000 | R$ 452.097 | R$ 380.097 | *** ## Erros Comuns de Iniciantes ### 1. Esperar "o momento certo" * **Pensamento:** "Vou esperar a bolsa cair para comprar" * **Realidade:** Impossível prever o mercado * **Solução:** Aportes mensais automáticos (DCA) * **Resultado:** Preço médio suavizado ao longo do tempo ### 2. Investir todo mês diferente * **Pensamento:** "Esse mês vou colocar tudo em cripto" * **Realidade:** Sem estratégia, resultados aleatórios * **Solução:** Definir alocação e seguir fielmente * **Resultado:** Crescimento consistente e previsível ### 3. Sacar na primeira queda * **Pensamento:** "Bolsa caiu 5%, vou vender tudo!" * **Realidade:** Vendeu na baixa, realizou prejuízo * **Solução:** Manter estratégia de longo prazo * **Resultado:** Quedas são oportunidades de compra ### 4. Buscar rendimentos extraordinários * **Pensamento:** "Essa cripto vai subir 1000%!" * **Realidade:** Alto risco, provável perda total * **Solução:** Carteira diversificada, expectativas realistas * **Resultado:** 10-15% a.a. é excelente no longo prazo ### 5. Não começar por achar pouco * **Pensamento:** "R$ 100 não vai fazer diferença" * **Realidade:** R$ 100/mês por 30 anos = R$ 226.000 * **Solução:** Começar agora com o que tem * **Resultado:** Tempo no mercado é o maior aliado *** ## Acompanhando seus Investimentos ### Usando brapi.dev para Monitorar ```typescript // Monitorar carteira simples de iniciante const tickers = ["BOVA11", "IVVB11", "MXRF11"]; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(",")}`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); // data.results contém preço atual e variação de cada ativo ``` ### Planilha de Controle Simples **Colunas Recomendadas para Controle:** | Coluna | Descrição | | -------------- | ------------------------- | | Data | Data da operação | | Ativo | Ticker (BOVA11, etc.) | | Tipo | Compra ou Venda | | Quantidade | Número de cotas/ações | | Preço Unitário | Preço por unidade | | Valor Total | Quantidade × Preço | | Corretora | Onde foi feita a operação | **Exemplo:** 15/01/2026 - BOVA11 - Compra - 1 cota - R$ 130,50 - Nubank *** ## Quanto Tempo Leva para Ficar Rico? Depende do seu conceito de "rico" e quanto consegue investir: **Tempo para Atingir Metas com R$ 500/mês (10% a.a.)** | Meta | Tempo | Total Investido | Juros Ganhos | | ------------ | --------- | --------------- | ------------ | | R$ 50.000 | 7,0 anos | R$ 42.000 | R$ 8.000 | | R$ 100.000 | 11,7 anos | R$ 70.200 | R$ 29.800 | | R$ 500.000 | 25,0 anos | R$ 150.000 | R$ 350.000 | | R$ 1.000.000 | 31,2 anos | R$ 187.200 | R$ 812.800 | *** ## Perguntas Frequentes ### Qual o mínimo para começar a investir? **R$ 1** em CDB de liquidez diária (Nubank, Inter) **R$ 30** no Tesouro Direto **R$ 10-50** em ações no mercado fracionário ### Preciso de assessor ou consultor? **Não para começar**. Com valores pequenos, o custo de um assessor não compensa. Use: * Conteúdo educacional gratuito (como este blog!) * Corretoras com taxa zero * Simuladores online ### Devo quitar dívidas antes de investir? **Sim, dívidas caras primeiro:** * Cartão de crédito (200-400% a.a.) * Cheque especial (150-300% a.a.) * Empréstimos pessoais (50-100% a.a.) **Dívidas "baratas" podem coexistir:** * Financiamento imobiliário (8-12% a.a.) * Consignado (20-30% a.a.) ### Cripto é bom para iniciantes? **Não recomendado para começar**. Motivos: * Volatilidade extrema * Risco de perda total * Complexidade técnica * Golpes frequentes Após ter experiência e reserva sólida, pode alocar 5-10% em cripto. *** ## Checklist do Investidor Iniciante ### Antes de Investir * [ ] Anotar gastos por 1 mês * [ ] Identificar quanto sobra para investir * [ ] Quitar dívidas caras (cartão, cheque especial) * [ ] Abrir conta em corretora taxa zero ### Primeiros Passos * [ ] Primeiro aporte no Tesouro Selic * [ ] Definir meta de reserva de emergência * [ ] Configurar aporte automático mensal * [ ] Estudar outros tipos de investimento ### Após Montar Reserva * [ ] Definir perfil de risco * [ ] Montar carteira diversificada * [ ] Incluir renda variável (ETFs, ações) * [ ] Acompanhar mensalmente ### Manutenção * [ ] Aportes consistentes todo mês * [ ] Rebalancear a cada trimestre * [ ] Revisar estratégia anualmente * [ ] Aumentar aportes conforme renda cresce *** ## Conclusão Investir com pouco dinheiro não só é **possível** como é **essencial**: 1. **Comece agora** - O tempo é seu maior aliado 2. **Seja consistente** - Aportes mensais fazem milagres 3. **Comece simples** - Tesouro Selic é perfeito para iniciar 4. **Diversifique gradualmente** - Adicione ETFs e ações com o tempo 5. **Ignore o barulho** - Foque no longo prazo R$ 200 por mês pode parecer pouco, mas em 30 anos se transforma em **mais de R$ 450.000**. O segredo não é quanto você começa, mas **que você comece**. ### Próximos Passos * **[Tesouro Direto - Guia Completo](/blog/tesouro-direto-guia-completo-2026-como-investir)** - Aprenda sobre renda fixa * **[Como Investir em Ações](/blog/como-investir-em-acoes-guia-completo-iniciantes)** - Próximo passo após reserva * **[Bogleheads Brasil](/blog/guia-bogleheads-brasil-investimento-passivo-etfs)** - Estratégia de longo prazo * **[API brapi.dev](/docs)** - Acompanhe seus investimentos *** **Disclaimer:** Este conteúdo é educacional e não constitui recomendação de investimento. Rentabilidades passadas não garantem retornos futuros. Invista de acordo com seu perfil de risco. # Como Investir em Ações 2026: Guia Completo para Iniciantes na Bolsa Brasileira URL: /blog/como-investir-em-acoes-guia-completo-iniciantes.mdx Aprenda a investir em ações do zero! Guia passo a passo: abrir conta, escolher corretora e primeira compra na bolsa brasileira ✓ *** searchable: true title: 'Como Investir em Ações 2026: Guia Completo para Iniciantes na Bolsa Brasileira' description: 'Aprenda a investir em ações do zero! Guia passo a passo: abrir conta, escolher corretora e primeira compra na bolsa brasileira ✓' date: '2026-01-01' keywords: 'como investir em ações, investir bolsa valores, guia iniciantes ações, primeira ação, corretora ações, ações brasileiras iniciantes, investimento ações Brasil, começar investir bolsa' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Guia Iniciantes' readingTime: '18 min' tags: \['Iniciantes', 'Como Investir', 'Ações', 'Bolsa Brasileira', 'Corretora', 'Primeiro Investimento', 'Educação Financeira'] relatedPosts: \['o-que-e-petr4-e-mglu-outros-tickers-da-bolsa-de-valores', 'como-acompanhar-a-bolsa-de-valores-em-tempo-real', 'analise-fundamentalista-acoes-indicadores-essenciais-investir-b3', 'o-que-sao-acoes-guia-iniciantes-2026', 'o-que-e-bolsa-de-valores-como-funciona-b3'] featured: true expertise: 'Equipe especializada em educação financeira para investidores iniciantes' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > Quer começar a investir em ações mas não sabe por onde começar? Este guia completo vai te ensinar tudo: desde abrir sua primeira conta em corretora até comprar sua primeira ação na bolsa brasileira. Sem complicação, direto ao ponto. *** ## Por Que Investir em Ações? Investir em ações significa se tornar **sócio de empresas**. Quando você compra uma ação da Petrobras (PETR4), por exemplo, você passa a ser dono de uma pequena parte dessa gigante do petróleo. ### Vantagens de Investir em Ações | Vantagem | Descrição | | ---------------------------- | ---------------------------------------------------------- | | **Potencial de Valorização** | Ações podem valorizar significativamente no longo prazo | | **Dividendos** | Muitas empresas distribuem parte dos lucros aos acionistas | | **Proteção contra Inflação** | Ações tendem a acompanhar a inflação no longo prazo | | **Liquidez** | Você pode comprar e vender ações rapidamente | | **Acessibilidade** | Comece com pouco dinheiro (a partir de R$ 10) | ### Riscos que Você Precisa Conhecer * **Volatilidade**: Preços podem oscilar bastante no curto prazo * **Risco de Mercado**: Crises econômicas afetam todas as ações * **Risco Específico**: Problemas na empresa podem derrubar o preço * **Perda de Capital**: Você pode perder dinheiro se vender na baixa ## Passo a Passo: Do Zero à Primeira Ação ### Passo 1: Organize Suas Finanças Antes de investir, certifique-se de que: 1. **Reserva de Emergência**: Tenha 6-12 meses de despesas guardados 2. **Dívidas Controladas**: Quite dívidas com juros altos (cartão, cheque especial) 3. **Orçamento Definido**: Saiba quanto pode investir por mês 4. **Objetivo Claro**: Defina por que está investindo (aposentadoria, casa, etc.) ``` 📊 REGRA DE OURO DO INVESTIDOR INICIANTE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅ Invista apenas o que NÃO vai precisar nos próximos 5 anos ✅ Nunca invista dinheiro da reserva de emergência ✅ Comece pequeno e aumente gradualmente ✅ Diversifique - nunca coloque tudo em uma só ação ``` ### Passo 2: Escolha uma Corretora A corretora é a ponte entre você e a bolsa. Critérios para escolher: | Critério | O que Avaliar | | --------------- | ------------------------------ | | **Taxas** | Corretagem, custódia, TED | | **Plataforma** | Facilidade de uso, app mobile | | **Segurança** | Autorização CVM | | **Suporte** | Atendimento ao cliente | | **Ferramentas** | Análises, gráficos, relatórios | **Principais Corretoras no Brasil:** * XP Investimentos * Clear * Rico * BTG Pactual Digital * Nu Invest * Inter ### Passo 3: Abra Sua Conta O processo é 100% online e gratuito: 1. Acesse o site da corretora escolhida 2. Preencha seus dados pessoais (CPF, RG, endereço) 3. Envie foto dos documentos 4. Aguarde aprovação (geralmente 1-3 dias) 5. Transfira dinheiro para a conta da corretora ### Passo 4: Conheça o Home Broker O **Home Broker** é a plataforma onde você compra e vende ações. Elementos principais: ``` ┌─────────────────────────────────────────────────────────────┐ │ HOME BROKER │ ├─────────────────────────────────────────────────────────────┤ │ │ │ PETR4 - Petrobras PN │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ Preço Atual: R$ 37,85 │ │ │ │ Variação: +1,25% (+R$ 0,47) │ │ │ │ Volume: 45.678.900 │ │ │ └─────────────────────────────────────────────────────┘ │ │ │ │ [COMPRAR] [VENDER] │ │ │ │ Quantidade: [100] Preço: [R$ 37,85] Total: R$ 3.785,00 │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Passo 5: Entenda os Tipos de Ordem | Tipo de Ordem | Como Funciona | Quando Usar | | ------------- | ---------------------------------------------- | -------------------------------- | | **Mercado** | Executa imediatamente ao preço atual | Quando quer comprar rápido | | **Limitada** | Executa apenas no preço que você definir | Para controlar o preço de compra | | **Stop Loss** | Vende automaticamente se cair até certo preço | Para limitar perdas | | **Stop Gain** | Vende automaticamente se subir até certo preço | Para garantir lucros | ### Passo 6: Compre Sua Primeira Ação **Exemplo prático - Comprando PETR4:** 1. No Home Broker, digite **PETR4** na busca 2. Clique em **Comprar** 3. Escolha a quantidade (ex: 100 ações) 4. Selecione o tipo de ordem (Limitada recomendado para iniciantes) 5. Defina o preço máximo que aceita pagar 6. Confirme a ordem 7. Pronto! Você agora é acionista da Petrobras! ## Como Escolher Suas Primeiras Ações ### Critérios para Iniciantes Para começar, foque em empresas: 1. **Conhecidas**: Empresas que você conhece e entende o negócio 2. **Grandes (Blue Chips)**: Empresas sólidas, líderes de mercado 3. **Lucrativas**: Com histórico de lucros consistentes 4. **Pagadoras de Dividendos**: Geram renda passiva ### Exemplos de Blue Chips Brasileiras ```typescript // Consultar dados de ações usando a API brapi.dev const response = await fetch( 'https://brapi.dev/api/quote/PETR4,VALE3,ITUB4,BBDC4,ABEV3,WEGE3' ) const data = await response.json() // data.results contém array com todas as ações ``` **Blue Chips Brasileiras:** | Ticker | Empresa | Setor | | ------ | ------------- | ---------- | | PETR4 | Petrobras | Petróleo | | VALE3 | Vale | Mineração | | ITUB4 | Itaú Unibanco | Bancos | | BBDC4 | Bradesco | Bancos | | ABEV3 | Ambev | Bebidas | | WEGE3 | WEG | Industrial | ### Setores para Começar | Setor | Características | Exemplos | | --------------- | ------------------------- | -------------------- | | **Bancos** | Estáveis, bons dividendos | ITUB4, BBDC4, BBAS3 | | **Energia** | Receita previsível | EGIE3, TAEE11, CMIG4 | | **Commodities** | Exposição ao dólar | VALE3, PETR4, SUZB3 | | **Consumo** | Fácil de entender | ABEV3, LREN3, MGLU3 | ## Quanto Dinheiro Preciso para Começar? ### Mercado Fracionário Você NÃO precisa comprar lotes de 100 ações. O **mercado fracionário** permite comprar a partir de 1 ação: ``` LOTE PADRÃO vs FRACIONÁRIO ━━━━━━━━━━━━━━━━━━━━━━━━━━ Lote Padrão (100 ações): PETR4 a R$ 37,85 = R$ 3.785,00 Mercado Fracionário (1 ação): PETR4F a R$ 37,85 = R$ 37,85 💡 DICA: Para comprar no fracionário, adicione "F" ao código Exemplo: PETR4F, VALE3F, ITUB4F ``` ### Exemplos de Carteiras por Valor **Carteira de R$ 500:** ``` ITUB4F - 5 ações - ~R$ 150 PETR4F - 4 ações - ~R$ 150 VALE3F - 3 ações - ~R$ 200 ━━━━━━━━━━━━━━━━━━━━━━━━━━━ Total: ~R$ 500 (3 empresas, 3 setores) ``` **Carteira de R$ 2.000:** ``` ITUB4F - 20 ações - ~R$ 600 PETR4F - 16 ações - ~R$ 600 VALE3F - 10 ações - ~R$ 650 WEGE3F - 3 ações - ~R$ 150 ━━━━━━━━━━━━━━━━━━━━━━━━━━━ Total: ~R$ 2.000 (4 empresas, 4 setores) ``` ## Estratégias Básicas para Iniciantes ### 1. Buy and Hold (Comprar e Segurar) A estratégia mais simples e eficaz para iniciantes: * Compre ações de boas empresas * Segure por muitos anos (5, 10, 20 anos) * Ignore oscilações de curto prazo * Reinvista dividendos ### 2. Aportes Mensais (DCA - Dollar Cost Averaging) Invista um valor fixo todo mês, independente do preço: **Simulação: R$ 500/mês por 10 anos (10% a.a.)** | Parâmetro | Valor | | ----------------------- | ------------------- | | Aporte mensal | R$ 500,00 | | Período | 10 anos (120 meses) | | Rentabilidade anual | 10% | | **Total investido** | R$ 60.000,00 | | **Patrimônio final** | R$ 102.422,00 | | **Rentabilidade total** | +70,7% | > **Fórmula:** Patrimônio = Σ (Aporte × (1 + taxa)^meses\_restantes) ### 3. Diversificação Básica Não coloque todos os ovos na mesma cesta: ``` REGRA DE DIVERSIFICAÇÃO PARA INICIANTES ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅ Mínimo 5-10 ações diferentes ✅ Pelo menos 3-5 setores diferentes ✅ Nenhuma ação com mais de 20% da carteira ✅ Combine ações de crescimento e dividendos ❌ NÃO FAÇA: • Colocar tudo em uma ação só • Investir apenas em um setor • Comprar ações que não entende ``` ## Erros Comuns de Iniciantes (Evite!) ### 1. Operar no Curto Prazo (Day Trade) **Por que evitar:** * 95% dos day traders perdem dinheiro * Exige muito conhecimento e tempo * Custos altos (corretagem, impostos) ### 2. Seguir "Dicas Quentes" **Por que evitar:** * Quando você ouve, já é tarde * Manipulação é comum * Não conhece os riscos ### 3. Entrar em Pânico na Queda **Por que evitar:** * Quedas são normais e temporárias * Vender na baixa cristaliza prejuízo * Crises são oportunidades de compra ### 4. Não Estudar Antes de Investir **Por que evitar:** * Investir é como pilotar: precisa de preparo * Decisões emocionais geram prejuízo * Conhecimento é seu melhor investimento ## Acompanhando Seus Investimentos ### Ferramentas Essenciais ```typescript // Acompanhar carteira de ações const response = await fetch( 'https://brapi.dev/api/quote/ITUB4,PETR4,VALE3,WEGE3,ABEV3' ) const data = await response.json() ``` **Exemplo de acompanhamento:** | Ação | Preço | Variação | | -------- | -------- | -------- | | 📈 ITUB4 | R$ 32,50 | +1,25% | | 📈 PETR4 | R$ 38,20 | +2,10% | | 📉 VALE3 | R$ 61,80 | -0,85% | | 📈 WEGE3 | R$ 42,15 | +0,95% | | ➡️ ABEV3 | R$ 14,30 | +0,07% | > **Média da carteira:** +0,70% ### Com Que Frequência Olhar? | Perfil | Frequência | Justificativa | | ----------------- | --------------- | ------------------------- | | **Iniciante** | 1x por semana | Evita decisões emocionais | | **Intermediário** | 2-3x por semana | Aproveita oportunidades | | **Experiente** | Diariamente | Gestão ativa | **Dica de Ouro:** Quanto menos você olha, melhor tende a ser seu resultado! ## Impostos e Declaração ### Imposto de Renda sobre Ações | Situação | Alíquota | Observação | | ----------------------------- | ---------- | ----------------------------- | | Vendas até R$ 20.000/mês | **Isento** | Apenas para operações normais | | Vendas acima de R$ 20.000/mês | **15%** | Sobre o lucro | | Day Trade | **20%** | Independente do valor | | Dividendos | **Isento** | Não paga IR | ### Como Calcular o Imposto ``` EXEMPLO DE CÁLCULO: ━━━━━━━━━━━━━━━━━━━ Comprou 100 PETR4 por R$ 35,00 = R$ 3.500,00 Vendeu 100 PETR4 por R$ 40,00 = R$ 4.000,00 Lucro: R$ 4.000 - R$ 3.500 = R$ 500,00 Se vendas no mês > R$ 20.000: IR devido: R$ 500 × 15% = R$ 75,00 Se vendas no mês ≤ R$ 20.000: IR devido: R$ 0,00 (isento) ``` ## Próximos Passos na Sua Jornada ### Nível 1: Fundamentos (Você está aqui!) * [x] Entender o que são ações * [x] Abrir conta em corretora * [x] Comprar primeira ação * [ ] Diversificar a carteira ### Nível 2: Análise Básica * [ ] [Aprender indicadores fundamentalistas](/blog/guia-completo-indicadores-fundamentalistas-bovespa) * [ ] [Entender o P/L](/blog/entendendo-indicador-preco-lucro-pl-analise-fundamentalista) * [ ] [Avaliar ROE e rentabilidade](/blog/roe-retorno-sobre-patrimonio-como-analisar) ### Nível 3: Estratégias Avançadas * [ ] [Investir em FIIs](/blog/fundos-imobiliarios-fiis-guia-completo-iniciantes) * [ ] [Construir carteira diversificada](/blog/como-construir-carteira-investimentos-diversificada-brapi) * [ ] [Usar análise setorial](/blog/analise-setorial-acoes-como-comparar-empresas-mesmo-segmento-b3) ## Recursos para Continuar Aprendendo ### Usando a API brapi.dev Para acompanhar suas ações em tempo real: ```typescript // Consultar ações em tempo real const response = await fetch( 'https://brapi.dev/api/quote/PETR4,VALE3,ITUB4,WEGE3' ) const data = await response.json() ``` **Painel do Investidor:** | Status | Ação | Preço | Variação | | ------ | ----- | -------- | -------- | | 🟢 | PETR4 | R$ 38,50 | +2,15% | | 🔴 | VALE3 | R$ 61,20 | -0,85% | | 🟢 | ITUB4 | R$ 32,80 | +1,10% | | 🟢 | WEGE3 | R$ 42,35 | +0,95% | > 📅 Dados em tempo real via [brapi.dev](https://brapi.dev) ### Links Úteis * **[Consultar cotações ao vivo](/quotes)** - Veja preços em tempo real * **[Documentação da API](/docs)** - Para desenvolvedores * **[Lista de ações disponíveis](/api/quote/list)** - Todas as ações brasileiras ## Conclusão Investir em ações não é complicado, mas exige: 1. **Conhecimento**: Estude antes de investir 2. **Paciência**: Resultados vêm no longo prazo 3. **Disciplina**: Mantenha aportes regulares 4. **Controle Emocional**: Não entre em pânico ### Checklist do Investidor Iniciante ``` ☐ Reserva de emergência completa ☐ Conta aberta em corretora ☐ Home Broker funcionando ☐ Primeira ação comprada ☐ Carteira diversificada (5+ ações) ☐ Aportes mensais configurados ☐ Planilha de controle criada ☐ Estudando análise fundamentalista ``` **Lembre-se**: O melhor momento para começar a investir foi ontem. O segundo melhor momento é hoje! *** *Precisa de dados para suas análises? A [brapi.dev](https://brapi.dev) oferece API gratuita com cotações em tempo real de todas as ações brasileiras. Perfeita para iniciantes que querem automatizar o acompanhamento de suas carteiras!* # Como Ler um Balanço Patrimonial: Guia Completo para Investidores 2026 URL: /blog/como-ler-balanco-patrimonial.mdx Aprenda a interpretar balanços patrimoniais de empresas listadas na bolsa brasileira com exemplos práticos, indicadores-chave e código Python para automatizar análises ✓ *** searchable: true title: 'Como Ler um Balanço Patrimonial: Guia Completo para Investidores 2026' description: 'Aprenda a interpretar balanços patrimoniais de empresas listadas na bolsa brasileira com exemplos práticos, indicadores-chave e código Python para automatizar análises ✓' date: '2026-01-01' keywords: 'balanço patrimonial, como ler balanço, análise fundamentalista, ativos passivos patrimônio líquido, demonstrações financeiras, contabilidade para investidores, 2026' author: 'Equipe brapi.dev' category: 'Análise Fundamentalista' subcategory: 'Demonstrações Financeiras' readingTime: '25 min' tags: \['Balanço Patrimonial', 'Análise Fundamentalista', 'Contabilidade', 'Demonstrações Financeiras', 'Investimentos'] relatedPosts: \['balanco-patrimonial-acoes', 'demonstrativos-financeiros-um-olhar-detalhado-na-saude-financeira-da-empresa', 'analise-fundamentalista-acoes-indicadores-essenciais-investir-b3', 'roe-retorno-sobre-patrimonio-como-analisar', 'analise-financeira-com-modulo-balance-sheet-history'] featured: true expertise: 'Especialistas em análise de demonstrações financeiras' lastReviewed: 2026-01-03 ------------------------ ## O Que é o Balanço Patrimonial? O **Balanço Patrimonial** (BP) é uma fotografia da situação financeira de uma empresa em um momento específico. Ele mostra tudo que a empresa **possui** (ativos), tudo que ela **deve** (passivos) e quanto **pertence aos acionistas** (patrimônio líquido). O que a empresa possui] --> E{{=}} E --> P[PASSIVOS
O que a empresa deve] E --> PL[PATRIMÔNIO LÍQUIDO
O que pertence aos acionistas] style A fill:#16a34a,color:#fff style P fill:#dc2626,color:#fff style PL fill:#2563eb,color:#fff style E fill:#6b7280,color:#fff `} /> **Exemplo: Casa de R$ 500 mil** | Conta | Valor | Descrição | | ------- | ---------- | ------------- | | Ativo | R$ 500.000 | Casa | | Passivo | R$ 300.000 | Financiamento | | PL | R$ 200.000 | Sua parte | ### Por Que Investidores Devem Analisar o Balanço? | Informação | O Que Revela | | -------------------- | ------------------------------------------ | | Ativos | Recursos para gerar lucros futuros | | Passivos | Obrigações e riscos financeiros | | Patrimônio Líquido | Valor contábil pertencente aos acionistas | | Liquidez | Capacidade de pagar dívidas de curto prazo | | Endividamento | Risco financeiro da empresa | | Qualidade dos Ativos | Se os recursos são produtivos | ## Estrutura Completa do Balanço Patrimonial | ATIVOS | PASSIVOS + PATRIMÔNIO LÍQUIDO | | ------------------------ | ----------------------------- | | **ATIVO CIRCULANTE** | **PASSIVO CIRCULANTE** | | Caixa e Equivalentes | Fornecedores | | Aplicações Financeiras | Empréstimos CP | | Contas a Receber | Salários a Pagar | | Estoques | Impostos a Pagar | | Outros | Outros | | **ATIVO NÃO CIRCULANTE** | **PASSIVO NÃO CIRCULANTE** | | Realizável LP | Empréstimos LP | | Investimentos | Debêntures | | Imobilizado | Provisões | | Intangível | Outros | | Diferido | | | | **PATRIMÔNIO LÍQUIDO** | | | Capital Social | | | Reservas de Capital | | | Reservas de Lucros | | | Ações em Tesouraria | | | Lucros Acumulados | | **TOTAL ATIVOS** | **TOTAL PASSIVOS + PL** | > Os dois lados são sempre iguais — essa é a essência da equação contábil. ## Analisando Cada Componente ### 1. ATIVOS - O Que a Empresa Possui #### Ativo Circulante (Curto Prazo - até 12 meses) **Exemplo de composição do Ativo Circulante:** | Conta | Valor | % do Total | | -------------------------- | ----------------- | ---------- | | Caixa e Equivalentes | R$ 5.000.000 | 9,1% | | Aplicações Financeiras | R$ 10.000.000 | 18,2% | | Contas a Receber | R$ 15.000.000 | 27,3% | | Estoques | R$ 20.000.000 | 36,4% | | Outros | R$ 5.000.000 | 9,1% | | **Total Ativo Circulante** | **R$ 55.000.000** | 100% | **Análise de qualidade:** * **Liquidez imediata** (Caixa + Aplicações / Total): 27,3% * **Qualidade**: Média (entre 15% e 30%) **O que observar em cada conta:** | Conta | Sinal Positivo | Sinal de Alerta | | ---------------- | ----------------------------------- | --------------------------------- | | Caixa | Caixa crescendo junto com operações | Caixa muito alto sem uso definido | | Contas a Receber | Prazo médio estável | Crescendo mais que vendas | | Estoques | Giro saudável | Estoques crescendo sem vendas | #### Ativo Não Circulante (Longo Prazo) **Componentes do Ativo Não Circulante:** | Conta | Descrição | O que observar | | ------------------- | -------------------------------- | ------------------------------- | | **Realizável a LP** | Créditos a receber após 12 meses | Concentração em poucos clientes | | **Investimentos** | Participações em outras empresas | Rentabilidade das subsidiárias | | **Imobilizado** | Máquinas, imóveis, veículos | Idade e depreciação acumulada | | **Intangível** | Marcas, patentes, goodwill | Risco de impairment | **Indicadores importantes:** | Indicador | Fórmula | Interpretação | | ---------------------- | ----------------------------- | --------------------------- | | Giro do Imobilizado | Receita ÷ Imobilizado | > 2,0 = boa eficiência | | Intensidade de Capital | (Imobilizado ÷ Receita) × 100 | \< 30% = Asset Light | | Peso do Intangível | (Intangível ÷ Ativo NC) × 100 | > 50% = atenção ao goodwill | **TIPOS DE EMPRESAS POR ESTRUTURA DE ATIVOS** | Tipo | Setores | Características | Exemplos | | ----------------------------------- | ---------------------------------- | ------------------------------------------------- | ------------ | | **Asset Light** (Baixo Imobilizado) | Tecnologia, Serviços, Consultorias | Baixo CAPEX, alta margem, escalável | TOTS3, LWSA3 | | **Asset Heavy** (Alto Imobilizado) | Indústrias, Utilities, Mineração | Alto CAPEX, margens menores, barreiras de entrada | VALE3, ELET3 | ### 2. PASSIVOS - O Que a Empresa Deve #### Passivo Circulante (Curto Prazo) **Composição do Passivo Circulante:** | Conta | Tipo | Característica | | ---------------------- | ----------- | --------------------- | | **Fornecedores** | Operacional | Não paga juros | | **Salários a Pagar** | Operacional | Folha do mês | | **Impostos a Pagar** | Operacional | Tributos do período | | **Empréstimos CP** | Oneroso | ⚠️ Paga juros! | | **Dividendos a Pagar** | Operacional | Distribuição aprovada | **Análise do risco:** | % Passivo Oneroso | Classificação | Interpretação | | ----------------- | ------------- | -------------------------------- | | \< 25% | 🟢 Baixo | Empresa financia-se com operação | | 25-50% | 🟡 Moderado | Equilíbrio entre fontes | | > 50% | 🔴 Alto | Dependência de empréstimos | **Tipos de passivo e o que significam:** **Passivo Operacional** (Bom — faz parte do negócio, não paga juros): * Fornecedores — Prazo para pagar compras * Salários — Folha do mês * Impostos — Tributos do período **Passivo Oneroso** (Atenção — paga juros, custo financeiro): * Empréstimos bancários * Debêntures * Financiamentos > **Dica:** Prefira empresas com mais passivo operacional que oneroso — financiam-se com a própria operação. #### Passivo Não Circulante (Longo Prazo) **Indicadores de endividamento:** | Indicador | Fórmula | Parâmetros | | ------------------ | -------------------------------- | ------------------- | | Dívida Bruta | Dívida CP + Dívida LP | Total que deve | | Dívida Líquida | Dívida Bruta − Caixa | Real exposição | | Dívida/PL | Dívida Bruta ÷ Patrimônio | \< 1,0 = saudável | | Dívida Líq./EBITDA | (Dívida - Caixa) ÷ EBITDA | Anos p/ pagar | | % Curto Prazo | (Dívida CP ÷ Dívida Total) × 100 | \< 30% = bom perfil | **Classificação por Dívida Líquida/EBITDA:** | Nível | Classificação | | ---------- | -------------------------------------- | | \< 1,0x | 🟢 Excelente - Baixo endividamento | | 1,0 - 2,0x | 🟢 Saudável - Endividamento controlado | | 2,0 - 3,0x | 🟡 Atenção - Endividamento moderado | | > 3,0x | 🔴 Alerta - Endividamento elevado | ### 3. PATRIMÔNIO LÍQUIDO - O Que Pertence aos Acionistas **Composição do Patrimônio Líquido:** | Conta | Descrição | | --------------------------- | -------------------------------------------------- | | **Capital Social** | Dinheiro que os sócios colocaram na empresa | | **Reservas de Capital** | Ágio na emissão de ações, doações | | **Reservas de Lucros** | Lucros retidos (legal, estatutária, contingências) | | **Lucros Acumulados** | Resultado ainda não distribuído | | **(-) Ações em Tesouraria** | Ações recompradas pela empresa | **Qualidade do Patrimônio:** | % Lucros Retidos | Qualidade | Interpretação | | ---------------- | --------- | ----------------------------------- | | > 50% | 🟢 Alta | Empresa gera valor consistentemente | | 30-50% | 🟡 Média | Crescimento moderado | | \< 30% | 🟠 Baixa | Depende de aportes externos | > **DICA:** Patrimônio crescendo via lucros retidos é ÓTIMO sinal! Significa que a empresa gera valor consistentemente. **Detalhamento das Reservas de Lucros** (o componente que mais interessa): * Reserva Legal (5% do lucro, até 20% do Capital Social) * Reserva Estatutária * Reserva para Contingências * Reserva de Lucros a Realizar > **Dica:** Patrimônio crescendo via lucros retidos é ÓTIMO sinal! Significa que a empresa gera valor consistentemente. ## Indicadores Essenciais do Balanço ### Indicadores de Liquidez **Fórmulas dos indicadores de liquidez:** | Indicador | Fórmula | O que mede | | --------------------- | -------------------------- | -------------------------------- | | **Liquidez Imediata** | Caixa ÷ Passivo Circulante | Capacidade de pagar só com caixa | | **Liquidez Seca** | (AC − Estoques) ÷ PC | Sem depender de vender estoque | | **Liquidez Corrente** | Ativo Circulante ÷ PC | Capacidade geral de curto prazo | | **Liquidez Geral** | (AC + RLP) ÷ (PC + PNC) | Visão completa de solvência | **Exemplo prático:** | Item | Valor | | ------------------ | ------------ | | Caixa | R$ 500.000 | | Aplicações | R$ 1.000.000 | | Contas a Receber | R$ 2.000.000 | | Estoques | R$ 3.000.000 | | Ativo Circulante | R$ 7.000.000 | | Passivo Circulante | R$ 4.000.000 | **Resultados:** | Indicador | Valor | | ----------------- | ------ | | Liquidez Imediata | 0,13 | | Liquidez Seca | 1,00 | | Liquidez Corrente | 1,75 ✅ | | Liquidez Geral | 1,14 | **Régua de Liquidez Corrente:** | Faixa | Classificação | Interpretação | | --------- | ------------- | --------------------------------------- | | \< 1,0 | 🚨 Crise | Passivo > Ativo — problema de solvência | | 1,0 - 1,5 | ⚠️ Apertado | Viável, mas sem folga | | 1,5 - 2,0 | ✅ Bom | Faixa ideal para a maioria | | 2,0 - 2,5 | ✅✅ Excelente | Folga confortável | | > 2,5 | ⚠️ Alto | Pode indicar caixa ocioso | ### Indicadores de Endividamento **Indicadores de estrutura de capital:** | Indicador | Fórmula | Referência | | ----------------------- | --------------------------- | ------------------------ | | **Endividamento Geral** | (Passivo ÷ Ativo) × 100 | \< 60% = saudável | | **Dívida/Patrimônio** | Dívida Bruta ÷ PL | \< 1,0 = conservador | | **Dívida Líq./EBITDA** | (Dívida − Caixa) ÷ EBITDA | \< 2,0 = confortável | | **Cobertura de Juros** | EBITDA ÷ Despesa Financeira | > 3,0 = seguro | | **Alavancagem** | Ativo Total ÷ Patrimônio | Multiplicador de capital | **Score de saúde financeira:** | Critério | Pontuação | | ------------------------- | ---------- | | Dívida Líq./EBITDA \< 2,0 | +30 pontos | | Cobertura de Juros > 3,0 | +30 pontos | | Dívida/PL \< 1,0 | +20 pontos | | Endividamento \< 60% | +20 pontos | | Score Total | Classificação | | ----------- | ------------- | | ≥ 80 | 🟢 Excelente | | 60-79 | 🟢 Boa | | 40-59 | 🟡 Regular | | \< 40 | 🔴 Fraca | ### Capital de Giro **Prazos médios e ciclos:** | Indicador | Fórmula | O que mede | | --------------------------------- | ---------------------------------- | ---------------------------- | | **PMR** (Prazo Médio Recebimento) | Contas a Receber ÷ (Receita ÷ 365) | Dias para receber vendas | | **PME** (Prazo Médio Estoque) | Estoques ÷ (CMV ÷ 365) | Dias que estoque fica parado | | **PMP** (Prazo Médio Pagamento) | Fornecedores ÷ (Compras ÷ 365) | Prazo com fornecedores | | **Ciclo Operacional** | PMR + PME | Dias do estoque até receber | | **Ciclo Financeiro** | Ciclo Operacional − PMP | Dias que precisa financiar | **Necessidade de Capital de Giro (NCG):** NCG = Contas a Receber + Estoques − Fornecedores **Classificação por Ciclo Financeiro:** | Ciclo Financeiro | Eficiência | | ---------------- | ------------------------------------ | | \< 30 dias | 🟢 Alta | | 30-60 dias | 🟡 Média | | > 60 dias | 🔴 Baixa | | Negativo | 🌟 Excelente (recebe antes de pagar) | Prazo Médio de Estoque
45 dias] --> CO[CICLO OPERACIONAL
= PME + PMR
75 dias] PMR[PMR
Prazo Médio de Recebimento
30 dias] --> CO CO --> CF[CICLO FINANCEIRO
= Ciclo Operacional - PMP
35 dias] PMP[PMP
Prazo Médio de Pagamento
40 dias] -->|subtrai| CF CF --> N[Dias que a empresa precisa FINANCIAR
com capital próprio ou dívida] style PME fill:#2563eb,color:#fff style PMR fill:#2563eb,color:#fff style PMP fill:#16a34a,color:#fff style CO fill:#ea580c,color:#fff style CF fill:#dc2626,color:#fff style N fill:#6b7280,color:#fff `} /> > **Quanto menor o ciclo financeiro, melhor!** **Empresas com ciclo negativo** (PMP > PMR + PME): * Recebem antes de pagar * Financiam-se com fornecedores * Exemplos: Supermercados, e-commerce ## Análise Prática com brapi.dev Vamos analisar o balanço de uma empresa real usando a API: ```typescript const response = await fetch( 'https://brapi.dev/api/quote/WEGE3?modules=balanceSheetHistory,defaultKeyStatistics,financialData', { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const balanco = results[0].balanceSheetHistory.balanceSheetStatements[0]; ``` **Campos disponíveis no balanço:** | Campo da API | Descrição | | ------------------------- | --------------------- | | `totalAssets` | Ativo Total | | `totalCurrentAssets` | Ativo Circulante | | `totalCurrentLiabilities` | Passivo Circulante | | `totalLiab` | Passivo Total | | `totalStockholderEquity` | Patrimônio Líquido | | `cash` | Caixa e Equivalentes | | `longTermDebt` | Dívida de Longo Prazo | | `shortTermDebt` | Dívida de Curto Prazo | | `endDate.fmt` | Data do balanço | **Indicadores que você pode calcular:** | Indicador | Fórmula | | ----------------- | --------------------------------------------------------- | | Liquidez Corrente | `totalCurrentAssets / totalCurrentLiabilities` | | Endividamento % | `(totalLiab / totalAssets) × 100` | | Dívida/PL | `(longTermDebt + shortTermDebt) / totalStockholderEquity` | **Avaliação de saúde financeira:** | Critério | Pontos | | -------------------- | ----------- | | Liquidez > 1,5 | +25 | | Endividamento \< 50% | +25 | | Dívida/PL \< 0,5 | +25 | | Todos positivos | +25 (bônus) | | Score | Classificação | | ----- | ------------- | | ≥ 80 | 🟢 Excelente | | 60-79 | 🟡 Boa | | 40-59 | 🟠 Regular | | \< 40 | 🔴 Atenção | ## Comparando Balanços ao Longo do Tempo A API retorna o array `balanceSheetStatements` com múltiplos períodos (geralmente 4 anos). Compare os dados ao longo do tempo: **Exemplo de evolução do balanço (ITUB4):** | Período | Ativo Total | Patrimônio Líquido | Variação PL | | ------- | --------------- | ------------------ | ----------- | | 2021 | R$ 1,8 trilhão | R$ 160 bilhões | - | | 2022 | R$ 2,0 trilhões | R$ 175 bilhões | +9,4% | | 2023 | R$ 2,2 trilhões | R$ 190 bilhões | +8,6% | | 2024 | R$ 2,4 trilhões | R$ 210 bilhões | +10,5% | **O que analisar na evolução:** * **Patrimônio crescente** = empresa gerando valor * **Dívida estável ou decrescente** = boa gestão financeira * **Caixa aumentando** = geração de caixa saudável ## Red Flags no Balanço Patrimonial **Sinais de alerta a identificar no balanço:** | Severidade | Red Flag | O que significa | | -------------- | ----------------------------- | ------------------------------------------ | | 🚨 **CRÍTICO** | Patrimônio Líquido Negativo | Passivos > Ativos = insolvência técnica | | 🔴 **ALTO** | Liquidez Corrente \< 1 | Dificuldade para pagar dívidas de CP | | 🟠 **MÉDIO** | Dívida CP > 50% do total | Mais da metade da dívida vence em 12 meses | | 🟠 **MÉDIO** | Intangível > 50% do ativo | Risco de impairment no goodwill | | 🟠 **MÉDIO** | Estoques crescendo > vendas | Possível obsolescência | | 🟠 **MÉDIO** | Recebíveis crescendo > vendas | Risco de inadimplência | **🚨 Críticos (evitar investimento):** * [ ] Patrimônio Líquido negativo * [ ] Dívida Líquida/EBITDA > 5x * [ ] Cobertura de juros \< 1x * [ ] Prejuízos acumulados corroendo capital **⚠️ Altos (investigar profundamente):** * [ ] Liquidez corrente \< 1 * [ ] Dívida concentrada no curto prazo * [ ] Goodwill > 50% do ativo * [ ] Capital de giro negativo **🔶 Médios (monitorar):** * [ ] Estoques crescendo mais que vendas * [ ] Prazo de recebimento aumentando * [ ] Ações em tesouraria relevantes * [ ] Provisões crescentes ## Conclusão: Dominando a Leitura de Balanços O balanço patrimonial é uma ferramenta poderosa quando você sabe interpretá-lo: ### Resumo dos Pontos Principais | Análise | O Que Buscar | Sinal Positivo | | --------------- | ------------------ | ---------------- | | Liquidez | LC, LS, LI, LG | LC > 1.5 | | Endividamento | Dív/PL, Dív/EBITDA | Dív/EBITDA \< 2 | | Capital de Giro | Ciclo financeiro | Ciclo \< 60 dias | | Qualidade PL | Lucros retidos | > 50% do PL | | Ativos | Giro, intensidade | Alta eficiência | ### Processo de Análise Recomendado Ativo = Passivo + PL?] --> B[2. Liquidez
Paga dívidas de CP?] B --> C[3. Endividamento
Quanto é financiado por dívida?] C --> D[4. Qualidade dos Ativos
São produtivos? Geram retorno?] D --> E[5. Patrimônio Líquido
Cresce via lucros?] E --> F[6. Evolução
Indicadores no tempo] F --> G[7. Red Flags
Sinais de alerta?] style A fill:#2563eb,color:#fff style G fill:#dc2626,color:#fff `} /> ## Próximos Passos Para aprofundar sua análise de balanços: 1. **Acesse a brapi.dev** - Dados de balanço de todas as empresas da bolsa brasileira 2. **Use o módulo balanceSheetHistory** - Histórico completo de balanços 3. **Compare empresas do mesmo setor** - Benchmarks são fundamentais 4. **Automatize com Python** - Use os códigos deste guia A [brapi.dev](https://brapi.dev) fornece acesso a todos os demonstrativos financeiros das empresas listadas, incluindo balanços trimestrais e anuais. *** *Disclaimer: Este conteúdo é educacional. Sempre consulte um profissional antes de tomar decisões de investimento.* # Como sair das dívidas sem cair em outro empréstimo URL: /blog/como-sair-das-dividas-comecar-investir-guia-2026.mdx Um plano direto para mapear dívidas, negociar, escolher entre avalanche e bola de neve e saber quando começar a investir. *** searchable: true title: 'Como sair das dívidas sem cair em outro empréstimo' description: 'Um plano direto para mapear dívidas, negociar, escolher entre avalanche e bola de neve e saber quando começar a investir.' date: '2026-01-01' keywords: 'como sair das dívidas, quitar dívidas, método avalanche, método bola de neve, começar investir endividado, dívida cartão crédito, negociar dívidas, limpar nome, organização financeira' author: 'Alisson Leal' category: 'Educação Financeira' subcategory: 'Planejamento Financeiro' readingTime: '10 min' tags: \['Dívidas', 'Planejamento Financeiro', 'Educação Financeira', 'Investimentos', 'Orçamento'] relatedPosts: \['planejamento-financeiro-pessoal-guia-completo-2026', 'reserva-de-emergencia-guia-completo-2026', 'como-comecar-investir-do-zero-guia-iniciantes-2026', 'juros-compostos-o-que-sao-como-calcular-simulador-2026'] featured: true expertise: 'Educação financeira, organização de dívidas e primeiros investimentos' lastReviewed: '2026-06-23' faqSchema: * question: 'Devo investir enquanto tenho dívidas?' answer: 'Dívidas caras, como cartão rotativo e cheque especial, normalmente devem ser pagas antes de investir. Uma pequena reserva pode evitar que um novo imprevisto volte para o cartão.' * question: 'Avalanche ou bola de neve: qual método é melhor?' answer: 'Avalanche reduz o total de juros ao priorizar a maior taxa. Bola de neve prioriza o menor saldo e pode ajudar quem precisa ver progresso rápido.' * question: 'Vale pegar um empréstimo para quitar outro?' answer: 'Só quando o novo crédito reduz o custo efetivo total, mantém uma parcela que cabe no orçamento e encerra a dívida antiga.' *** import { Authors, Author } from '~/components/Authors'; ![Pessoa organizando contas e transformando várias dívidas em um plano de pagamento com uma pequena reserva no final](/images/blog/sair-das-dividas-plano.webp) Sair das dívidas começa com uma tarefa desagradável: abrir os aplicativos, juntar os contratos e descobrir o valor real do problema. Não é preciso resolver tudo no mesmo dia. Primeiro você para de aumentar a dívida. Depois escolhe uma ordem de pagamento que consiga manter. ## O plano em três etapas ## 1. Faça uma lista que caiba em uma tela Você precisa de quatro números por dívida: | Campo | O que anotar | | ---------------------- | -------------------------------------------- | | Saldo para quitar hoje | Não apenas a soma das parcelas | | Custo efetivo total | Juros, tarifas, seguro e outros encargos | | Parcela mínima | O valor necessário para não quebrar o acordo | | Situação | Em dia, atrasada, negativada ou renegociada | O Registrato do Banco Central ajuda a consultar empréstimos e relacionamentos financeiros, mas os dados podem ter defasagem. Confirme sempre o saldo diretamente com o credor. Também anote sua renda líquida e os gastos essenciais. A parcela prometida na negociação precisa caber em um mês ruim, não apenas no mês atual. ## 2. Proteja o básico antes de acelerar Aluguel, alimentação, energia, transporte para trabalhar e saúde vêm antes de uma antecipação de dívida. Deixar de pagar o básico para quitar um acordo costuma criar outra dívida logo depois. Se você não tem nenhum dinheiro disponível para um remédio ou conserto urgente, monte uma pequena reserva de proteção enquanto negocia. Não precisa esperar seis meses de despesas. O primeiro objetivo pode ser apenas impedir que todo imprevisto volte para o cartão. ## 3. Escolha uma ordem Existem dois métodos conhecidos. Os dois mantêm o pagamento mínimo das demais dívidas e concentram o dinheiro extra em uma delas. | Método | Prioridade | Vantagem | Custo | | ------------ | -------------------- | ------------------------------- | ------------------------------- | | Avalanche | Maior taxa primeiro | Paga menos juros | A primeira vitória pode demorar | | Bola de neve | Menor saldo primeiro | Reduz rápido o número de contas | Pode pagar mais juros | Use avalanche quando as taxas são muito diferentes, especialmente se uma dívida está no rotativo ou cheque especial. Use bola de neve se você já abandonou outros planos e precisa fechar uma conta pequena para ganhar espaço mental. O melhor método é o que continua funcionando no terceiro mês. ## 4. Negocie o total, não a parcela Uma parcela menor pode esconder prazo maior e custo total mais alto. Antes de aceitar, peça: * saldo original e saldo atualizado; * quantidade e valor das parcelas; * custo efetivo total; * valor para quitação antecipada; * data da retirada da negativação; * documento do acordo. Compare pelo total pago. Se uma proposta reduz a parcela de R$ 900 para R$ 650, mas acrescenta dois anos ao contrato, ela pode piorar a dívida. Use canais oficiais do credor. Para problemas de cobrança ou descumprimento de oferta, procure o Procon ou o [Consumidor.gov.br](https://www.consumidor.gov.br/). ## 5. Portabilidade pode ajudar, mas não faz milagre Portabilidade troca um contrato de crédito por outro mais barato. Segundo o [Banco Central](https://www.bcb.gov.br/cidadaniafinanceira/portabilidadecredito), a instituição deve fornecer as informações necessárias para comparar a operação. Faça três verificações: 1. O custo efetivo total caiu? 2. A parcela cabe sem usar novamente o limite? 3. A dívida antiga será encerrada? Se a resposta a qualquer uma delas for "não sei", não assine ainda. Pegar crédito novo e manter o cartão ou cheque especial abertos pode dobrar o problema. A troca só funciona quando substitui a dívida anterior. ## O caso do cartão rotativo O texto antigo deste artigo projetava que R$ 5.000 no rotativo poderiam virar quase R$ 120.000. Essa conta ignorava uma mudança importante. Desde 3 de janeiro de 2024, os juros e encargos financeiros do rotativo e do parcelamento da fatura não podem ultrapassar 100% do valor original não pago. Em um saldo principal de R$ 5.000, esses encargos ficam limitados a R$ 5.000. A medida está na [Lei 14.690/2023](https://www.planalto.gov.br/ccivil_03/_ato2023-2026/2023/lei/l14690.htm) e foi regulamentada pelo Conselho Monetário Nacional. Isso não torna o rotativo barato. Uma dívida que pode dobrar continua sendo uma emergência financeira. ## Quando pagar dívida antes de investir Compare um custo garantido com um retorno incerto. Quitar uma dívida que cobra 8% ao mês evita esse custo sem risco de mercado. Um investimento não oferece retorno líquido semelhante com segurança. Em geral: * cartão rotativo, cheque especial e crédito pessoal caro vêm primeiro; * uma reserva pequena pode ser construída em paralelo; * financiamentos baratos exigem comparação do custo efetivo total, prazo e liquidez; * benefícios com contrapartida do empregador, como contribuição adicional em previdência, merecem análise separada. Não use uma taxa fixa como "acima de 1% ao mês, quite". Juros de mercado, impostos e sua necessidade de liquidez mudam. Compare o contrato real. ## O que fazer com o dinheiro depois Quando uma dívida termina, a parcela não vira renda disponível. Redirecione-a automaticamente: 1. complete a reserva de emergência; 2. separe dinheiro para objetivos com data; 3. comece os investimentos de longo prazo. Se você pagava R$ 700 por mês, programe a transferência de R$ 700 no dia seguinte ao salário. É mais fácil manter um fluxo que já existia do que criar um novo hábito. ## Um plano para esta semana * [ ] Baixe contratos e faturas. * [ ] Liste saldo, CET, parcela e atraso. * [ ] Corte novas compras parceladas. * [ ] Defina quanto cabe por mês. * [ ] Peça propostas por escrito. * [ ] Escolha avalanche ou bola de neve. * [ ] Marque a data da próxima revisão. Se as dívidas comprometem despesas básicas, existem cobranças abusivas ou a situação envolve superendividamento, procure orientação no Procon, Defensoria Pública ou órgão de proteção ao consumidor da sua cidade. Depois da quitação, siga para [como montar uma reserva de emergência](/blog/reserva-de-emergencia-guia-completo-2026) e [como começar a investir do zero](/blog/como-comecar-investir-do-zero-guia-iniciantes-2026). ## Fontes [Banco Central: portabilidade de crédito](https://www.bcb.gov.br/cidadaniafinanceira/portabilidadecredito) · [Lei 14.690/2023](https://www.planalto.gov.br/ccivil_03/_ato2023-2026/2023/lei/l14690.htm) · [Consumidor.gov.br](https://www.consumidor.gov.br/) *Conteúdo educacional. Não substitui orientação jurídica, contábil ou financeira individual.* # P/VP 2025: Como Usar Preço/Valor Patrimonial para Value Investing URL: /blog/como-usar-indicador-pvp-valor-patrimonial-analise-acoes.mdx Domine o P/VP para value investing! Calcule e interprete Preço/Valor Patrimonial e identifique ações subvalorizadas ✓ *** searchable: true title: 'P/VP 2025: Como Usar Preço/Valor Patrimonial para Value Investing' description: 'Domine o P/VP para value investing! Calcule e interprete Preço/Valor Patrimonial e identifique ações subvalorizadas ✓' date: '2025-08-22' keywords: 'indicador P/VP, preço valor patrimonial, price to book, análise fundamentalista, ações brasileiras, value investing, múltiplos valuation, patrimônio líquido, VPA, brapi' author: 'Equipe brapi.dev' category: 'Análise Fundamentalista' subcategory: 'Múltiplos de Valuation' readingTime: '18 min' tags: \['P/VP', 'Value Investing', 'Análise Fundamentalista', 'Bolsa Brasileira', 'Valuation', 'Múltiplos', 'Subvalorizadas'] relatedPosts: \['entendendo-indicador-preco-lucro-pl-analise-fundamentalista', 'formula-graham-como-calcular-preco-justo-acoes-value-investing', 'guia-completo-indicadores-fundamentalistas-bovespa'] featured: true expertise: 'Value investing com 8+ anos de experiência no mercado brasileiro' lastReviewed: 2026-01-03 howToTools: \['API brapi.dev', 'Calculadora', 'Planilha de análise'] howToSteps: * name: 'Obtenha o preço atual da ação' text: 'Use a API brapi.dev para buscar o regularMarketPrice do ativo.' * name: 'Encontre o Valor Patrimonial por Ação (VPA)' text: 'Divida o patrimônio líquido pelo número de ações em circulação.' * name: 'Calcule o P/VP' text: 'Divida o preço da ação pelo VPA. P/VP \< 1 pode indicar subvalorização.' * name: 'Compare com empresas do setor' text: 'Analise o P/VP em relação à média do setor para contexto adequado.' * name: 'Considere a qualidade dos ativos' text: 'Avalie se os ativos no balanço estão a valor justo ou inflacionados.' *** import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > O P/VP (Price-to-Book) é o indicador fundamentalista essencial para identificar ações subvalorizadas. Aprenda como calcular, interpretar e usar este múltiplo para encontrar oportunidades de value investing na bolsa brasileira em 2025. *** ## O que é o Indicador P/VP e Por Que é Fundamental? O **P/VP (Preço sobre Valor Patrimonial)** é um múltiplo que compara o valor de mercado de uma ação com seu valor patrimonial contábil. Este indicador é crucial para identificar se uma empresa está sendo negociada com desconto ou prêmio em relação ao seu patrimônio líquido. **Em termos práticos:** O P/VP mostra quantas vezes você está pagando pelo patrimônio líquido da empresa. É como comparar o preço de uma casa com seu valor de avaliação. ### Fórmula do P/VP ``` P/VP = Preço da Ação ÷ Valor Patrimonial por Ação ``` Onde: * **Preço da Ação**: Cotação atual no mercado * **Valor Patrimonial por Ação**: Patrimônio Líquido ÷ Número de Ações ### Significado dos Valores #### P/VP \< 1,0 * **Interpretação**: Ação negociada abaixo do valor contábil * **Possível oportunidade** de value investing * **Atenção**: Pode indicar problemas fundamentais #### P/VP = 1,0 * **Interpretação**: Preço igual ao valor contábil * **Avaliação neutra** pelo mercado * **Referência** para comparações #### P/VP > 1,0 * **Interpretação**: Mercado avalia acima do valor contábil * **Reconhecimento** de ativos intangíveis * **Pode indicar** sobrevaloração ## Como Calcular P/VP com brapi.dev ### Implementação Prática ```typescript // Buscar dados para calcular P/VP const response = await fetch( "https://brapi.dev/api/quote/ITUB4?modules=balanceSheetHistory,defaultKeyStatistics", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); const resultado = data.results[0]; // Extrair dados do balanço const balanco = resultado.balanceSheetHistory.balanceSheetHistory[0]; const patrimonioLiquido = balanco.totalStockholdersEquity; const acoesCirculacao = resultado.sharesOutstanding; const precoAtual = resultado.regularMarketPrice; // Calcular VPA e P/VP const vpa = patrimonioLiquido / acoesCirculacao; const pvp = precoAtual / vpa; const descontoPremio = (pvp - 1) * 100; ``` **Exemplo de Resultado: ITUB4** | Métrica | Valor | | ------------------- | ------------ | | Preço Atual | R$ 32,50 | | Patrimônio Líquido | R$ 182,5B | | Ações em Circulação | 9,8B | | **VPA** | **R$ 18,62** | | **P/VP** | **1,75** | | Prêmio ao VP | +75% | ### Interpretação do P/VP | Faixa P/VP | Classificação | Interpretação | | ---------- | ------------------- | ----------------------------------------- | | \< 0,5 | 🔵 Muito descontada | Investigar motivos - possível distress | | 0,5 - 1,0 | 🟢 Descontada | Potencial oportunidade de value investing | | 1,0 - 1,5 | 🟡 Fairly valued | Preço justo pelos ativos tangíveis | | 1,5 - 3,0 | 🟠 Premium | Mercado reconhece valor além dos ativos | | > 3,0 | 🔴 Muito cara | Possível sobrevalorização | P/VP baixo nem sempre é oportunidade. Empresas com problemas fundamentais frequentemente negociam abaixo do valor contábil por bons motivos. ## P/VP por Setor: Análise Comparativa ### Características Setoriais Cada setor tem faixas típicas de P/VP diferentes. Compare sempre com empresas do mesmo setor: **Setor Bancário (exemplo):** | Banco | P/VP | Classificação | | ------ | ---- | ------------- | | ITUB4 | 1,75 | Premium | | BBDC4 | 0,92 | Descontada | | BBAS3 | 0,85 | Descontada | | SANB11 | 1,10 | Fairly valued | | BPAC11 | 2,15 | Premium | **Estatísticas do Setor:** * P/VP Médio: 1,35 * P/VP Mediano: 1,10 * Faixa: 0,85 - 2,15 * Empresas com Desconto: 2/5 Bancos tradicionalmente negociam próximos a P/VP = 1,0. Prêmios indicam maior qualidade percebida (ROE alto, carteira saudável). Descontos podem indicar problemas de inadimplência ou governança. ## Screening Avançado por P/VP ### Filtros Combinados Para encontrar oportunidades de value investing, combine P/VP com outros indicadores: **Critérios de Screening Value:** | Indicador | Filtro | Motivo | | ----------------- | ------ | ----------------------------- | | P/VP | ≤ 1,2 | Desconto ao valor patrimonial | | ROE | ≥ 10% | Empresa rentável | | Debt/Equity | ≤ 1,0 | Endividamento controlado | | Liquidez Corrente | ≥ 1,0 | Capacidade de pagar dívidas | | P/L | ≤ 15 | Preço razoável pelos lucros | ```typescript // Buscar dados para screening const tickers = ["ITUB4", "BBDC4", "PETR4", "VALE3", "ABEV3", "TAEE11"]; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(",")}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); // Filtrar por critérios const candidatos = data.results.filter((acao) => { const stats = acao.defaultKeyStatistics ?? {}; const financials = acao.financialData ?? {}; const pvp = acao.defaultKeyStatistics?.priceToBook || 999; const roe = financials.returnOnEquity || 0; const debtEquity = financials.debtToEquity || 999; const pl = acao.priceEarnings ?? stats.trailingPE ?? 999; return pvp <= 1.2 && roe >= 0.10 && debtEquity <= 1.0 && pl <= 15; }); ``` **Exemplo de Resultado do Screening:** | Rank | Ação | P/VP | ROE | P/L | Score | | ---- | ------ | ---- | ----- | --- | ------ | | 1 | BBAS3 | 0,85 | 18,5% | 5,2 | 92/100 | | 2 | BBDC4 | 0,92 | 12,3% | 7,8 | 85/100 | | 3 | TAEE11 | 1,15 | 22,1% | 8,5 | 78/100 | Screening é apenas o primeiro passo. Sempre faça análise qualitativa das empresas filtradas antes de investir. ## P/VP vs. Outros Indicadores ### Análise Multivariada Combine P/VP com outros indicadores para uma análise mais completa: ```typescript // Buscar dados completos para análise combinada const response = await fetch( "https://brapi.dev/api/quote/ITUB4?modules=defaultKeyStatistics,financialData,summaryProfile", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); const acao = data.results[0]; const stats = acao.defaultKeyStatistics ?? {}; const financials = acao.financialData ?? {}; // Extrair múltiplos const multiplos = { pvp: stats.priceToBook, pl: acao.priceEarnings ?? stats.trailingPE, evReceita: stats.enterpriseToRevenue, evEbitda: stats.enterpriseToEbitda, }; // Indicadores de qualidade const qualidade = { roe: financials.returnOnEquity, roa: financials.returnOnAssets, margemLiquida: financials.profitMargins, }; ``` **Matriz de Análise Combinada - ITUB4:** | Categoria | Indicador | Valor | Classificação | | ------------- | -------------- | ----- | -------------- | | **Múltiplos** | P/VP | 1,75 | Premium | | | P/L | 8,5 | Moderada | | | PSR | 2,1 | - | | **Qualidade** | ROE | 18,5% | Alta qualidade | | | ROA | 1,2% | - | | | Margem Líquida | 22,3% | Alta qualidade | **Sistema de Pontuação:** | Classificação | Score P/VP | Score P/L | Score Qualidade | Total | | -------------------------- | ---------- | --------- | --------------- | --------- | | Descontada (P/VP \< 1) | 20 pts | - | - | - | | Barata (P/L \< 10) | - | 15 pts | - | - | | Alta Qualidade (ROE > 15%) | - | - | 25 pts | - | | **ITUB4** | 10 pts | 15 pts | 25 pts | **50/60** | **Recomendação:** COMPRA - Fairly valued + Barata + Alta Qualidade ```` ## Limitações do P/VP ### Quando Não Usar P/VP #### 1. **Empresas de Tecnologia** - Ativos intangíveis não aparecem no balanço - P/VP pode ser enganoso - Foco em múltiplos de receita #### 2. **Empresas em Crescimento Acelerado** - P/VP alto pode ser justificado - Crescimento futuro não refletido no patrimônio - Análise de potencial mais relevante #### 3. **Empresas com Prejuízos Recorrentes** - Patrimônio pode estar deteriorado - P/VP baixo por motivos fundamentais - Necessário análise de viabilidade ### Ajustes e Melhorias O P/VP pode ser ajustado pela qualidade dos ativos no balanço. Empresas com muito goodwill ou estoques obsoletos podem ter P/VP enganosamente baixo. **Fatores de Ajuste:** | Componente | Impacto no P/VP | Ajuste | |------------|-----------------|--------| | Alta liquidez de ativos | Positivo | Reduz P/VP ajustado | | Muita participação de caixa | Positivo | Reduz P/VP ajustado | | Goodwill elevado | Negativo | Aumenta P/VP ajustado | | Estoques altos | Negativo | Aumenta P/VP ajustado | ```typescript // Buscar dados do balanço para análise de qualidade const response = await fetch( "https://brapi.dev/api/quote/MGLU3?modules=balanceSheetHistory", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); const balanco = data.results[0].balanceSheetHistory.balanceSheetHistory[0]; // Analisar composição dos ativos const totalAssets = balanco.totalAssets; const currentAssets = balanco.totalCurrentAssets; const cash = balanco.cash; const goodwill = balanco.goodWill || 0; const inventory = balanco.inventory || 0; // Calcular participações const liquidezAtivos = (currentAssets / totalAssets) * 100; const participacaoCash = (cash / totalAssets) * 100; const participacaoGoodwill = (goodwill / totalAssets) * 100; const participacaoEstoque = (inventory / totalAssets) * 100; ```` **Exemplo de Análise - MGLU3:** | Componente | Participação | Qualidade | | ------------------- | ------------ | --------- | | Liquidez dos Ativos | 45% | Boa | | Caixa | 8% | Regular | | Goodwill | 25% | ⚠️ Alto | | Estoques | 18% | ⚠️ Alto | | P/VP | Valor | | ------------------ | -------- | | P/VP Original | 0,65 | | Score de Qualidade | 0,55 | | **P/VP Ajustado** | **1,18** | Quando o P/VP ajustado é significativamente maior que o original, a empresa pode não estar tão descontada quanto parece. Sempre analise a composição dos ativos. ``` ## Casos Práticos de Análise ### Exemplo 1: Banco (ITUB4) **Características:** - Ativos tangíveis (empréstimos, imóveis) - P/VP tradicionalmente próximo a 1,0 - ROE elevado justifica prêmio ### Exemplo 2: Siderúrgica (USIM5) **Características:** - Ativos físicos (plantas industriais) - P/VP volátil com ciclo econômico - Atenção para depreciação ### Exemplo 3: Petrolífera (PETR4) **Características:** - Reservas não totalmente contabilizadas - P/VP pode subestimar valor real - Considerar reservas provadas ## Estratégias de Investimento com P/VP ### 1. **Deep Value Investing** - P/VP < 0,8 - Empresas temporariamente desvalorizadas - Alto risco, alto retorno potencial ### 2. **Quality Value** - P/VP < 1,2 - ROE > 15% - Empresas sólidas com desconto ### 3. **Contrarian Investing** - P/VP historicamente baixo - Setores fora de favor - Reversão à média ## Conclusão O P/VP é um indicador fundamental para identificar oportunidades de value investing, especialmente em empresas com ativos tangíveis significativos. Combine sempre com outros indicadores e análise qualitativa. ### Pontos-Chave: 1. **P/VP < 1,0**: Possível oportunidade, investigar motivos 2. **Análise setorial**: Compare com pares do mesmo setor 3. **Qualidade dos ativos**: Ajuste por composição patrimonial 4. **Combine indicadores**: Use junto com ROE, P/L e margem líquida 5. **Contexto temporal**: Considere ciclo econômico e setor ### Próximos Passos: - **[Combine com análise P/L](/blog/entendendo-indicador-preco-lucro-pl-analise-fundamentalista)** para visão completa - **[Aprenda outros indicadores](/blog/guia-completo-indicadores-fundamentalistas-bovespa)** fundamentalistas - **[Use nossa plataforma](/quotes)** para screening por P/VP - **[Acesse dados via API](/docs)** para implementar suas análises **Lembre-se**: P/VP baixo pode indicar oportunidade ou problema. Sempre faça análise completa antes de investir! ``` # Tesouro Selic vs Prefixado vs IPCA+ em 2026: Qual Rende Mais Hoje? URL: /blog/comparar-tesouro-selic-prefixado-ipca-api-2026.mdx Tesouro Selic vs Prefixado vs IPCA: compare os 3 indexadores na mesma régua com dados ao vivo da brapi e descubra qual título rende mais hoje. *** searchable: true title: 'Tesouro Selic vs Prefixado vs IPCA+ em 2026: Qual Rende Mais Hoje?' description: 'Tesouro Selic vs Prefixado vs IPCA: compare os 3 indexadores na mesma régua com dados ao vivo da brapi e descubra qual título rende mais hoje.' date: '2026-05-17' keywords: 'tesouro selic vs prefixado vs ipca, comparar tesouro selic prefixado ipca 2026, qual tesouro direto rende mais hoje, comparar tesouro direto 2026, qual tesouro rende mais, juro real ex-ante exemplo, juro real ex-ante, juro real ex-post, marcação a mercado, tesouro prefixado 2037 taxa, tesouro ipca 2060 rentabilidade, tesouro selic 2031, rendimento nominal tesouro direto python, api tesouro direto brapi, indexador renda fixa, spread sobre selic, curva de juros brasil 2026, tesouro direto api python, comparar renda fixa brasil' author: 'Equipe brapi.dev' category: 'Renda Fixa' subcategory: 'Tesouro Direto' readingTime: '13 min' tags: \['Tesouro Selic', 'Tesouro Prefixado', 'Tesouro IPCA+', 'API', 'Comparativo', 'Python', 'Brasil', '2026'] relatedPosts: \[ 'cdb-vs-tesouro-direto-comparativo-2026', 'tesouro-direto-guia-completo-2026-como-investir', 'api-macroeconomia-brasil-bcb-indicadores-2026', 'como-calcular-juro-real-brasil-selic-ipca-api-2026', 'indicadores-economicos-brasil-selic-ipca-igpm-impacto-investimentos', ] featured: true expertise: 'Comparativo dos três indexadores do Tesouro Direto (Selic, Prefixado, IPCA+) com snapshot ao vivo de 2026-05-15 via brapi.dev, conversão para taxa nominal equivalente e script reproduzível em Python e TypeScript.' lastReviewed: '2026-05-17' howToTools: * 'Conta brapi.dev no plano Pro (sandbox cobre 3 títulos sem token)' * 'Python 3.8+ ou Node.js 18+' howToSteps: * name: 'Liste os títulos por indexador' text: 'Use GET /api/v2/treasury/list?indexer=selic|prefixado|ipca para descobrir os símbolos atualmente ofertados.' * name: 'Busque o snapshot dos títulos escolhidos' text: 'Use GET /api/v2/treasury/indicators?symbols=... para obter buyRate, sellRate, preços e o campo rateInfo que explica como interpretar a taxa de cada indexador.' * name: 'Busque Selic Meta e IPCA 12m' text: 'Use GET /api/v2/macro/latest?symbols=selic,ipca12m para alinhar a comparação com o estado macro atual.' * name: 'Converta para taxa nominal equivalente' text: 'Selic = Selic Meta + spread. Prefixado = buyRate. IPCA+ = (1 + IPCA12m/100) \* (1 + buyRate/100) - 1, multiplicado por 100.' * name: 'Compare em uma única tabela' text: 'Com as três taxas nominais equivalentes, o comparativo apples-to-apples fica direto. Repita o cálculo semanalmente — o vencedor muda quando o mercado precifica corte ou alta de juros.' faqSchema: * question: 'Qual Tesouro Direto rende mais hoje, Selic, Prefixado ou IPCA+?' answer: 'No snapshot de 17/05/2026, o Tesouro Selic 2031 lidera com 14,58% a.a. nominais (Selic Meta 14,5% + spread 0,08%), seguido pelo Prefixado 2037 com 14,36% e pelo IPCA+ 2060 com 11,93% nominais equivalentes (juro real de 7,22% somado ao IPCA 12m de 4,39%). O vencedor muda quando a Selic, o IPCA ou a curva de juros se mexem — rode o script semanal para atualizar.' * question: 'Como comparar Tesouro Selic, Prefixado e IPCA+ na mesma régua?' answer: 'Converta as três taxas para taxa nominal anual equivalente: Selic = Selic Meta + spread (buyRate); Prefixado = buyRate direto; IPCA+ = (1 + IPCA12m/100) × (1 + buyRate/100) − 1, multiplicado por 100. Com isso você compara os três indexadores em uma única unidade — porcentagem nominal ao ano.' * question: 'O que é juro real ex-ante e como calcular com a API da brapi?' answer: 'Juro real ex-ante é o juro real estimado hoje, antes da inflação acontecer. Pegue o buyRate de um título IPCA+ (já é o juro real ex-ante puro) ou faça (1 + nominal/100) ÷ (1 + ipca12m/100) − 1 para um Prefixado. A brapi devolve buyRate e IPCA 12m em duas chamadas, e o cálculo fica em três linhas de Python.' * question: 'Qual a taxa do Tesouro Prefixado 2037 em maio de 2026?' answer: 'O tesouro-prefixado-com-juros-semestrais-01012037 fechou em 14,36% a.a. de buyRate e 14,48% a.a. de sellRate na base de 2026-05-15. É uma taxa nominal travada por 11 anos — se a Selic cair, você ganha; se subir, leva marcação a mercado negativa caso venda antes do vencimento.' * question: 'Quanto rende o Tesouro IPCA+ 2060 hoje e vale a pena?' answer: 'O tesouro-ipca-com-juros-semestrais-15082060 oferece juro real de 7,22% a.a. acima do IPCA, o que em maio de 2026 equivale a 11,93% a.a. nominais com IPCA 12m em 4,39%. É historicamente alto para o Brasil e faz sentido para objetivos de 10+ anos como aposentadoria; a duração média de 12.511 dias significa alta sensibilidade à marcação a mercado.' *** import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; import { Tab, Tabs } from 'fumadocs-ui/components/tabs'; > Selic Meta a 14,5% a.a., Prefixado 14% a.a., IPCA+ 7% real. Qual rende > mais? Mostro a resposta com 30 linhas de código e dados ao vivo da brapi. Comparar **Tesouro Selic vs Prefixado vs IPCA** parece fácil. Mas tem uma pegadinha. As três taxas que aparecem na tela do Tesouro Direto **não falam a mesma língua**. Cada indexador (o referencial que o juro acompanha — Selic, inflação, ou taxa fixa) mostra o ganho de um jeito diferente. Um mostra spread (a diferença, em pontos percentuais, em relação à taxa de referência). Outro mostra a taxa nominal contratada. O terceiro mostra só o juro real acima da inflação. Sem traduzir tudo para a mesma unidade, qualquer ranking sai torto. Neste guia você vai aprender três coisas. Como puxar o snapshot de cada indexador via brapi. Como combinar com Selic Meta e IPCA 12 meses do BCB. E como montar um ranking honesto em uma tabela só. Todo número aqui é real, capturado no dia da publicação direto da API. 16 bar [14.58, 14.36, 11.93] `} /> *Estimativa convertida em juro nominal usando IPCA 12m atual (4,39%). Quando a inflação sobe, o IPCA+ ganha terreno; quando a Selic cai, o Prefixado travado hoje vira o melhor da fila.* *** ## Os três indexadores em 30 segundos | Indexador | Como a taxa é cotada | `rateType` no `rateInfo` | Risco principal | | --------------------- | ---------------------------------------- | ------------------------ | --------------------------------------------------------------- | | **Tesouro Selic** | Spread em p.p. ao ano sobre a Selic Meta | `spreadOverSelic` | Quase nenhum (marcação a mercado mínima) | | **Tesouro Prefixado** | Taxa nominal anual contratada | `nominalAnnualRate` | Marcação a mercado se vender antes do vencimento | | **Tesouro IPCA+** | Juro real anual acima do IPCA | `realAnnualRateOverIpca` | Marcação a mercado + risco de IPCA mais baixo do que o esperado | Quando o Tesouro Selic mostra `buyRate: 0,08`, isso quer dizer **Selic + 0,08 p.p.** ao ano. Não é 0,08% de retorno total. Quando o IPCA+ mostra `buyRate: 7,22`, é só o juro real acima da inflação. O retorno nominal de verdade só fecha quando você soma o IPCA que aconteceu no período. O campo `rateInfo` que volta em `/api/v2/treasury/indicators` deixa essa unidade clara já na resposta. Assim, o seu código nunca precisa adivinhar. *** ## Snapshot ao vivo dos três indexadores Uma única chamada traz os três tipos de título em um array só. ```bash curl "https://brapi.dev/api/v2/treasury/indicators?symbols=tesouro-selic-01032031,tesouro-prefixado-com-juros-semestrais-01012037,tesouro-ipca-com-juros-semestrais-15082060" \ -H "Authorization: Bearer $BRAPI_TOKEN" ``` Veja a resposta real em 17/05/2026 (alguns campos foram cortados para deixar mais fácil de ler). ```json { "results": [ { "symbol": "tesouro-selic-01032031", "indexer": "selic", "couponType": "zero", "maturityDate": "2031-03-01", "durationDays": 1751, "baseDate": "2026-05-15", "buyRate": 0.08, "sellRate": 0.09, "buyPrice": 18944.78, "rateInfo": { "rateType": "spreadOverSelic", "rateUnit": "% a.a." } }, { "symbol": "tesouro-prefixado-com-juros-semestrais-01012037", "indexer": "prefixado", "couponType": "semestral", "maturityDate": "2037-01-01", "durationDays": 3884, "baseDate": "2026-05-15", "buyRate": 14.36, "sellRate": 14.48, "buyPrice": 814.75, "rateInfo": { "rateType": "nominalAnnualRate", "rateUnit": "% a.a." } }, { "symbol": "tesouro-ipca-com-juros-semestrais-15082060", "indexer": "ipca", "couponType": "semestral", "maturityDate": "2060-08-15", "durationDays": 12511, "baseDate": "2026-05-15", "buyRate": 7.22, "sellRate": 7.34, "buyPrice": 4086.85, "rateInfo": { "rateType": "realAnnualRateOverIpca", "rateUnit": "% a.a." } } ], "requestedAt": "2026-05-17T23:29:25.912Z", "took": 4 } ``` Agora pegue o estado macro de referência — Selic Meta e IPCA dos últimos 12 meses. ```bash curl "https://brapi.dev/api/v2/macro/latest?symbols=selic,ipca12m" \ -H "Authorization: Bearer $BRAPI_TOKEN" ``` ```json { "results": [ { "series": { "slug": "selic" }, "latest": { "date": "2026-05-17", "value": 14.5 } }, { "series": { "slug": "ipca12m" }, "latest": { "date": "2026-04-01", "value": 4.39 } } ] } ``` Tudo o que vem a seguir usa exatamente esses números reais. *** ## Como tornar tudo comparável A regra é simples. Para colocar os três títulos na mesma régua, você converte cada um para uma **taxa nominal anual equivalente** usando o macro de hoje. | Indexador | Fórmula | Aplicada a este snapshot | | --------- | ------------------------------------------- | ------------------------------------- | | Selic | `selic_meta + spread` | `14,5 + 0,08 = 14,58% a.a.` | | Prefixado | `buyRate` | `14,36% a.a.` | | IPCA+ | `(1 + ipca12m/100) × (1 + buyRate/100) − 1` | `(1,0439 × 1,0722) − 1 = 11,93% a.a.` | A conversão do IPCA+ usa o IPCA acumulado **dos últimos 12 meses** como proxy do próximo ano. Isso é juro real medido depois (já com a inflação que de fato aconteceu) — se a inflação subir, o IPCA+ vira mais; se cair, vira menos. Para projetar o futuro, troque `ipca12m` pelo Boletim Focus ou pela sua própria expectativa. Aqui o objetivo é responder: "se o mundo congelasse hoje, qual rende mais?". *Dos \~11,93% nominais que o IPCA+ 2060 entrega hoje, cerca de 4,39 p.p. só servem para empatar com a inflação que aconteceu nos últimos 12 meses. O ganho de verdade — o juro real estimado (quanto você ganha acima da inflação que o mercado está prevendo) — são os 7,22 p.p. de cima.* *** ## Script comparador em Python São 30 linhas. Sem dependência externa além da `requests`. ```python import os import requests BASE = "https://brapi.dev/api/v2" headers = {"Authorization": f"Bearer {os.environ['BRAPI_TOKEN']}"} SYMBOLS = [ "tesouro-selic-01032031", "tesouro-prefixado-com-juros-semestrais-01012037", "tesouro-ipca-com-juros-semestrais-15082060", ] titulos = requests.get( f"{BASE}/treasury/indicators", params={"symbols": ",".join(SYMBOLS)}, headers=headers, ).json()["results"] macro = requests.get( f"{BASE}/macro/latest", params={"symbols": "selic,ipca12m"}, headers=headers, ).json()["results"] selic = next(m["latest"]["value"] for m in macro if m["series"]["slug"] == "selic") ipca12m = next(m["latest"]["value"] for m in macro if m["series"]["slug"] == "ipca12m") print(f"Macro hoje: Selic Meta = {selic}% a.a. | IPCA 12m = {ipca12m}%\n") print(f"{'Título':<55} {'Indexador':<11} {'Taxa':>8} {'Nominal eq.':>13}") print("-" * 92) for t in titulos: idx, rate = t["indexer"], t["buyRate"] if idx == "selic": nominal = selic + rate elif idx == "prefixado": nominal = rate elif idx == "ipca": nominal = ((1 + ipca12m / 100) * (1 + rate / 100) - 1) * 100 print(f"{t['symbol']:<55} {idx:<11} {rate:>7.2f}% {nominal:>12.2f}%") ``` ```typescript const BASE = 'https://brapi.dev/api/v2'; const headers = { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }; const SYMBOLS = [ 'tesouro-selic-01032031', 'tesouro-prefixado-com-juros-semestrais-01012037', 'tesouro-ipca-com-juros-semestrais-15082060', ]; const titulos = await fetch( `${BASE}/treasury/indicators?symbols=${SYMBOLS.join(',')}`, { headers }, ).then((r) => r.json()).then((j) => j.results); const macro = await fetch( `${BASE}/macro/latest?symbols=selic,ipca12m`, { headers }, ).then((r) => r.json()).then((j) => j.results); const selic = macro.find((m) => m.series.slug === 'selic').latest.value; const ipca12m = macro.find((m) => m.series.slug === 'ipca12m').latest.value; console.log(`Macro hoje: Selic ${selic}% | IPCA 12m ${ipca12m}%\n`); for (const t of titulos) { const rate = t.buyRate; const nominal = t.indexer === 'selic' ? selic + rate : t.indexer === 'prefixado' ? rate : ((1 + ipca12m / 100) * (1 + rate / 100) - 1) * 100; console.log(`${t.symbol.padEnd(55)} ${t.indexer.padEnd(11)} ${rate.toFixed(2)}% → ${nominal.toFixed(2)}%`); } ``` Veja a saída real em 17/05/2026. ```text Macro hoje: Selic Meta = 14.5% a.a. | IPCA 12m = 4.39% Título Indexador Taxa Nominal eq. -------------------------------------------------------------------------------------------- tesouro-selic-01032031 selic 0.08% 14.58% tesouro-prefixado-com-juros-semestrais-01012037 prefixado 14.36% 14.36% tesouro-ipca-com-juros-semestrais-15082060 ipca 7.22% 11.93% ``` **Resultado deste snapshot:** o Tesouro Selic 2031 lidera com 14,58% a.a. nominais. Depois vem o Prefixado 2037 com 14,36%. O IPCA+ 2060 fica em 11,93% — mas só porque o IPCA 12 meses está baixo, em 4,39%. Se a inflação subir para 6%, por exemplo, o nominal equivalente do IPCA+ pula para 13,65% e o pódio muda. *** ## Qual indexador eu escolho? Antes do detalhe, veja a árvore de decisão simples. B{Voce precisa de liquidez
e baixa volatilidade?} B -- Sim --> C[Tesouro Selic
Resgate a qualquer hora
com ganho proporcional] B -- Nao --> D{Voce quer travar
uma taxa fixa hoje?} D -- Sim, acho que o juro vai cair --> E[Tesouro Prefixado
Trava taxa nominal
Ganha se a Selic cair] D -- Nao, quero protecao
contra inflacao --> F[Tesouro IPCA+
Juro real garantido
Acima do IPCA] `} /> *Use o Tesouro Selic para reserva de emergência. Use o Prefixado para apostar em queda da Selic. Use o IPCA+ para objetivos longos protegidos da inflação.* ### Tesouro Selic — liquidez e estabilidade A duração média de 1.751 dias do `tesouro-selic-01032031` esconde uma propriedade importante. Como o cupom é zero e a taxa é pós-fixada, a **marcação a mercado (quanto o título vale agora se você vender antes do vencimento) é quase nula**. O preço acompanha a Selic dia após dia, sem sustos. Você pode resgatar amanhã com o ganho proporcional do tempo que ficou aplicado. Faz sentido quando: * Você precisa de **liquidez diária** e não aceita volatilidade. * A sua **reserva de emergência** precisa render a Selic cheia. * Você ainda não tem opinião sobre para onde os juros vão. ### Tesouro Prefixado — travar taxa antes do corte Quando o mercado começa a apostar em **corte de Selic** (a curva DI fica invertida), travar 14,36% a.a. por 11 anos no `tesouro-prefixado-com-juros-semestrais-01012037` pode ser ótimo. Mas você precisa de convicção, porque a aposta tem dois lados. O risco é este. Se a Selic **subir** depois da compra, o preço do título cai. Quem vende antes do vencimento realiza prejuízo via marcação a mercado. Quem segura até 2037 recebe os 14,36% contratados, não importa o que aconteça no caminho. ### Tesouro IPCA+ — proteção real de longo prazo O `tesouro-ipca-com-juros-semestrais-15082060` tem duração média de 12.511 dias — algo perto de 34 anos. Ele garante **juro real de 7,22% a.a. acima da inflação**, o que é historicamente alto no Brasil. Faz sentido nestes casos: * **Aposentadoria** e qualquer objetivo de 10+ anos. * Casar o investimento com **dívidas e despesas indexadas ao IPCA** (educação, saúde, aluguel). * Quem acredita que a meta de inflação será cumprida no longo prazo. Duração média alta também quer dizer **mais sensibilidade a mudanças na taxa real**. Se o juro real exigido pelo mercado subir 1 p.p., o preço do título cai cerca de 12% (regra grossa: ΔPreço ≈ −Duração × ΔTaxa). *** ## Curva por vencimento O endpoint `/treasury/list` aceita `indexer` + `sortBy=maturityDate` e devolve a curva inteira. No momento da publicação, há cinco vencimentos prefixados na ponta. | Símbolo | Vencimento | Cupom | `buyRate` | | ------------------------------------------------- | ---------- | --------- | --------- | | `tesouro-prefixado-com-juros-semestrais-01012027` | 2027-01-01 | semestral | 14,05% | | `tesouro-prefixado-01012028` | 2028-01-01 | zero | 13,95% | | `tesouro-prefixado-com-juros-semestrais-01012029` | 2029-01-01 | semestral | 14,08% | | `tesouro-prefixado-01012031` | 2031-01-01 | zero | 14,21% | | `tesouro-prefixado-com-juros-semestrais-01012033` | 2033-01-01 | semestral | 14,37% | A curva está em formato de "U" leve. Ela cai do curto até 2028 (13,95%) e sobe aos poucos no longo prazo (14,37% em 2033). É sinal de que o mercado aposta em algum corte de Selic no curtíssimo prazo. Depois cobra um prêmio extra para segurar o título por mais tempo. E na curva do IPCA+: | Símbolo | Vencimento | Cupom | `buyRate` (juro real) | | -------------------------------------------- | ---------- | --------- | --------------------- | | `tesouro-ipca-15082026` | 2026-08-15 | zero | 9,98% | | `tesouro-ipca-15052029` | 2029-05-15 | zero | 7,95% | | `tesouro-ipca-com-juros-semestrais-15082030` | 2030-08-15 | semestral | 7,97% | | `tesouro-ipca-com-juros-semestrais-15082032` | 2032-08-15 | semestral | 7,84% | | `tesouro-ipca-com-juros-semestrais-15082060` | 2060-08-15 | semestral | 7,22% | A curva de juro real é bem mais comportada. Fica perto de 8% no miolo e desce para uns 7,2% no ultralongo. Quanto **menor** o juro real exigido no longo prazo, mais **caro** está o título. Ou seja, quem compra hoje paga um prêmio extra para travar proteção contra inflação por décadas. *** ## Cuidado com o spread do Tesouro Selic Os Tesouros Selic mostram `buyRate` entre **0,01% e 0,08% a.a.** hoje. O spread (a diferença, em pontos percentuais, em relação à Selic Meta) está positivo, mas apertado. Em períodos de alta demanda por liquidez no Tesouro Direto, esse spread já ficou negativo em alguns títulos. Isso quer dizer que o papel rende **menos** que a Selic Meta cheia. Sempre converta `buyRate` para nominal equivalente via `selic_meta + buyRate` antes de comparar com CDB pós-fixado ou conta remunerada. Um `buyRate` de `-0,05` no Tesouro Selic significa Selic Meta menos 0,05 p.p., e nessa janela um CDB pagando 100% do CDI provavelmente rende mais. A curva de spread atual cresce conforme o prazo aumenta (0,01 no 2027 até 0,08 no 2031). É natural — títulos mais longos cobram um prêmio extra por prender o dinheiro por mais tempo, mesmo que a marcação a mercado seja baixa. *** ## Próximos passos * Combine este snapshot com o [cálculo de juro real ex-ante](/blog/como-calcular-juro-real-brasil-selic-ipca-api-2026) para testar cenários diferentes de IPCA. * Use o [endpoint unificado de macroeconomia](/blog/api-macroeconomia-brasil-bcb-indicadores-2026) para puxar Selic, IPCA, CDI e mais 12 séries do BCB em uma chamada só. * Veja o [comparativo CDB vs Tesouro Direto](/blog/cdb-vs-tesouro-direto-comparativo-2026) para decidir entre crédito de banco e título do governo. * Para juntar FIIs e ações com proteção real ao quadro, veja o [guia de indicadores econômicos](/blog/indicadores-economicos-brasil-selic-ipca-igpm-impacto-investimentos). Rode o script toda semana. O vencedor da disputa **Tesouro Selic vs Prefixado vs IPCA** muda quando o COPOM se reúne, quando o IPCA mensal surpreende ou quando o mercado reprecifica a curva de juros. A pergunta "qual Tesouro Direto rende mais hoje?" só tem resposta com dado fresco. E é exatamente isso que a API de Tesouro Direto da brapi entrega. # Cross-Rate de Moedas com PTAX Brasileiro: USD/EUR, GBP/EUR via API (2026) URL: /blog/cross-rate-moedas-ptax-api-eur-usd-gbp-2026.mdx Calcule cotações cruzadas (cross-rates) entre 10 moedas usando o PTAX do Banco Central como fonte oficial. EUR/USD, GBP/USD, JPY/EUR e mais — derivadas automaticamente em uma única chamada de API. *** searchable: true title: 'Cross-Rate de Moedas com PTAX Brasileiro: USD/EUR, GBP/EUR via API (2026)' description: 'Calcule cotações cruzadas (cross-rates) entre 10 moedas usando o PTAX do Banco Central como fonte oficial. EUR/USD, GBP/USD, JPY/EUR e mais — derivadas automaticamente em uma única chamada de API.' date: '2026-05-06' keywords: 'cross rate moedas, eur usd ptax, gbp usd derivado, taxa cruzada moedas, cross currency rate api, eur jpy ptax, paridade cambial brasil, conversao indireta moedas' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Câmbio' readingTime: '11 min' tags: \['Câmbio', 'Cross-Rate', 'PTAX', 'API', 'EUR-USD', 'TypeScript', 'Triangulação'] relatedPosts: \['historico-dolar-euro-libra-api-ptax-banco-central-2026', 'api-macroeconomia-brasil-bcb-indicadores-2026'] featured: true expertise: 'Triangulação cambial via PTAX BCB — endpoint /api/v2/currency/historical' lastReviewed: '2026-05-06' howToTools: * 'Conta brapi.dev plano Pro (cross-rates e inverso são features Pro)' * 'Node.js 18+, Python 3.8+, ou cURL' howToSteps: * name: 'Crie sua conta brapi.dev' text: 'Cross-rates e inverso de moedas requerem plano Pro. Crie sua conta em brapi.dev e faça upgrade.' * name: 'Entenda a triangulação' text: 'Cross-rate USD-EUR é derivado de USD-BRL ÷ EUR-BRL em cada data com observação em ambas as séries. A API faz isso automaticamente.' * name: 'Chame o endpoint' text: 'GET /api/v2/currency/historical?currency=USD-EUR retorna a série diária do dólar contra o euro derivada do PTAX brasileiro.' * name: 'Múltiplos cross-rates em uma chamada' text: 'currency=USD-EUR,GBP-EUR,JPY-EUR retorna três cross-rates simultaneamente, sem dobrar requisições.' * name: 'Compare com fontes externas' text: 'Os números são matematicamente corretos pelo PTAX brasileiro. Para hedge global, valide com Refinitiv/Bloomberg que podem ter spread diferente.' *** import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > Você precisa do histórico de **EUR/USD** mas só tem o PTAX do BCB > brasileiro? A boa notícia: dá para *derivar* USD-EUR, GBP-EUR, JPY-USD > e qualquer outro par entre as 10 moedas suportadas, dividindo as > cotações contra o real. A brapi.dev faz isso por você em uma única > requisição. A maioria das APIs de câmbio brasileiras só oferece pares contra o real (`USD-BRL`, `EUR-BRL`, ...). Se você precisa de `USD-EUR` para uma análise de paridade ou hedge cambial, vira um mini-projeto: fazer duas requisições, juntar pelas datas, dividir. Em maio de 2026, o `/api/v2/currency/historical` da brapi.dev passou a oferecer **triangulação automática** entre as 10 moedas suportadas — inclusive cross-rates onde nenhuma das duas é o real. Este post explica como funciona, quando faz sentido usar, e quando você deve preferir uma fonte externa de cotação. *** ## O que é um cross-rate Um **cross-rate** é uma cotação derivada entre duas moedas a partir de uma moeda intermediária. No nosso caso, todas as nossas séries são contra o real (BRL), então o cross-rate de duas moedas X e Y é: ``` X-Y = (X-BRL) / (Y-BRL) ``` Em cada data com observação em **ambas** as séries: ``` Date USD-BRL EUR-BRL ⇒ USD-EUR (derivado) 2026-04-30 4.9886 5.6712 ⇒ 0.8797 2026-04-29 4.9712 5.6543 ⇒ 0.8792 2026-04-28 4.9854 5.6789 ⇒ 0.8779 ``` Esses números seguem o **PTAX brasileiro** — não são exatamente o que sai em Bloomberg/Refinitiv (que usam outras bolsas e janelas de fixação), mas são consistentes com balanços e contratos no Brasil. **Use** quando: * Você precisa de consistência com balanços, IRPF e contratos brasileiros * Está fazendo back-test ou análise de longo prazo (PTAX é estável e tem série longa) * Quer evitar custo de feeds internacionais * Sua análise envolve o real (mesmo que indireto, ex: como o USD-EUR reagiu nos dias em que o real desvalorizou) **Prefira fontes externas** quando: * Você está fazendo hedge cambial *intraday* * Precisa do bid/ask do interbancário (London Fix, NY Close) * Sua estratégia depende de spreads de poucos pontos-base *** ## Endpoint: `/api/v2/currency/historical` A brapi suporta três tipos de pares no histórico: | Tipo | Exemplo | Plano | Fórmula | | -------------- | --------- | ------- | ---------------------------------------------- | | **Direto** | `USD-BRL` | Startup | Série PTAX armazenada | | **Inverso** | `BRL-USD` | Pro | `1 / (USD-BRL)` em cada data | | **Cross-rate** | `USD-EUR` | Pro | `(USD-BRL) / (EUR-BRL)` em cada data com ambas | ```bash # Cross-rate: USD contra EUR via PTAX brasileiro curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/currency/historical?currency=USD-EUR" ``` ```json { "results": [ { "pair": "USD-EUR", "fromCurrency": "USD", "toCurrency": "EUR", "observations": [ { "date": "2026-04-30", "value": 0.8797 }, { "date": "2026-04-29", "value": 0.8792 } ] } ], "requestedAt": "2026-04-30T12:00:00.000Z", "took": 21 } ``` A API: 1. Identifica que `USD-EUR` não é uma série armazenada (nenhuma das duas moedas é BRL) 2. Resolve para o plano `cross`: lê `USD-BRL` e `EUR-BRL` no intervalo pedido 3. Faz o **join pela data** — só inclui dias com observação em ambas 4. Calcula `value = USD-BRL ÷ EUR-BRL` em cada dia O resultado é uma série limpa, alinhada por data, pronta para gráfico ou back-test. ### Múltiplos cross-rates em uma única chamada ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/currency/historical?currency=USD-EUR,GBP-EUR,JPY-USD,CHF-USD" ``` A API: * Identifica todos os slugs base necessários (`USD-BRL`, `EUR-BRL`, `GBP-BRL`, `JPY-BRL`, `CHF-BRL`) * Busca cada um **uma única vez** mesmo se aparece em múltiplos cross-rates * Computa cada par e retorna alinhado Você economiza requisições ao BCB e ao seu próprio servidor. *** ## Inverso (1 / X-BRL) Para "quanto vale 1 real em dólares" (`BRL-USD`): ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/currency/historical?currency=BRL-USD" ``` ```json { "results": [ { "pair": "BRL-USD", "fromCurrency": "BRL", "toCurrency": "USD", "observations": [ { "date": "2026-04-30", "value": 0.20046 }, { "date": "2026-04-29", "value": 0.20116 } ] } ] } ``` `0.20046` significa "1 BRL = 0,20046 USD" (≈ 20 centavos de dólar). É literalmente `1 / 4.9886`. *** ## Exemplo prático: paridade EUR/USD via Brasil Veja como derivar a série EUR/USD nos últimos 5 anos: ### TypeScript ```typescript type Observation = { date: string; value: number }; type HistoricalResponse = { results: Array<{ pair: string; fromCurrency: string; toCurrency: string; observations: Observation[]; }>; errors?: Array<{ pair: string; code: string; message: string }>; }; async function fetchEurUsd5y(): Promise { const today = new Date().toISOString().slice(0, 10); const past = new Date(); past.setFullYear(past.getFullYear() - 5); const startDate = past.toISOString().slice(0, 10); const url = new URL('https://brapi.dev/api/v2/currency/historical'); url.searchParams.set('currency', 'EUR-USD'); url.searchParams.set('startDate', startDate); url.searchParams.set('endDate', today); url.searchParams.set('sortOrder', 'asc'); url.searchParams.set('limit', '10000'); const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }, }); const data: HistoricalResponse = await res.json(); if (data.errors?.length) { console.warn('Erros parciais:', data.errors); } return data.results.find((r) => r.pair === 'EUR-USD')?.observations ?? []; } const eurUsd = await fetchEurUsd5y(); console.log(`${eurUsd.length} pontos diários de EUR/USD via PTAX brasileiro`); console.log('Último:', eurUsd[eurUsd.length - 1]); ``` ### Python: cesta global de cross-rates ```python import os from datetime import date, timedelta import requests PAIRS = ['USD-EUR', 'USD-GBP', 'USD-JPY', 'USD-CHF', 'EUR-GBP', 'EUR-JPY'] def fetch_global_basket(years: int) -> dict[str, list[dict]]: end = date.today().isoformat() start = (date.today() - timedelta(days=365 * years)).isoformat() response = requests.get( 'https://brapi.dev/api/v2/currency/historical', params={ 'currency': ','.join(PAIRS), 'startDate': start, 'endDate': end, 'sortOrder': 'asc', 'limit': 10000, }, headers={'Authorization': f"Bearer {os.environ['BRAPI_TOKEN']}"}, ) response.raise_for_status() return {item['pair']: item['observations'] for item in response.json()['results']} basket = fetch_global_basket(years=5) for pair, obs in basket.items(): last = obs[-1] if obs else {} print(f"{pair}: {len(obs)} pts, último {last.get('date')} = {last.get('value')}") ``` *** ## Casos de uso reais ### 1. Análise de paridade Comparar `EUR-USD` derivado do PTAX brasileiro com o `EUR-USD` de referência internacional (Refinitiv) ajuda a quantificar o "ruído" de fixação local. Em períodos de estresse, esse spread pode chegar a 0,5%. ### 2. Back-test de carteira multi-moeda Se você tem carteira global (ações americanas, ETFs europeus, REITs asiáticos), o histórico de cross-rates permite computar o retorno em uma moeda-base sem precisar baixar dados de cada par separadamente. ### 3. Hedge cambial doméstico Empresas com exposição a múltiplas moedas (ex: importadora que paga em EUR, exporta em USD) podem estimar o impacto cambial líquido a partir do cross-rate USD-EUR derivado do PTAX. ### 4. Análise acadêmica e de pesquisa Para teses sobre integração cambial dos países emergentes, *spillovers* de política monetária internacional, ou modelos VAR de câmbio: o histórico PTAX-derivado oferece uma base consistente desde 1999 (ou 1984 quando USD está envolvido). ### 5. Aplicações fintech Carteiras digitais, apps de remessa internacional e calculadoras de viagem podem mostrar "custaria X dólares por euro" usando a referência brasileira oficial. *** ## Volatilidade e correlação a partir de cross-rates Calcule volatilidade anualizada e correlação entre pares cruzados: ```typescript function logReturns(obs: Observation[]) { return obs.slice(1).map((o, i) => Math.log(o.value / obs[i].value)); } function annualVolatility(returns: number[]) { const mean = returns.reduce((a, b) => a + b, 0) / returns.length; const variance = returns.reduce((acc, r) => acc + (r - mean) ** 2, 0) / (returns.length - 1); return Math.sqrt(variance * 252) * 100; } function correlation(a: number[], b: number[]) { const n = Math.min(a.length, b.length); const meanA = a.slice(0, n).reduce((x, y) => x + y, 0) / n; const meanB = b.slice(0, n).reduce((x, y) => x + y, 0) / n; let cov = 0, varA = 0, varB = 0; for (let i = 0; i < n; i++) { cov += (a[i] - meanA) * (b[i] - meanB); varA += (a[i] - meanA) ** 2; varB += (b[i] - meanB) ** 2; } return cov / Math.sqrt(varA * varB); } // Uso const eurUsd = await fetchEurUsd5y(); const ret = logReturns(eurUsd); console.log(`Volatilidade EUR-USD (PTAX): ${annualVolatility(ret).toFixed(2)}%`); ``` *** ## Erros comuns e cuidados 1. **Esperar o PTAX coincidir com cotações internacionais.** Não vai. PTAX é fixação brasileira, não Bloomberg fix. 2. **Pedir cross-rate com cripto.** `BTC-USD` não funciona em `/historical`. O endpoint só cobre as 10 moedas fiat suportadas pelo PTAX. 3. **Esquecer da janela de datas.** Cross-rates só existem em datas com observação em **ambas** as séries base. Se EUR-BRL tem observação em 2003 mas USD-BRL não tem, esse dia não aparecerá no `EUR-USD` derivado. 4. **Usar plano Startup.** Cross-rates e inverso requerem **Pro**. Pares diretos (X-BRL) ficam no Startup. 5. **Pedir cross-rate trivial.** `USD-BRL` é direto, não cross. Se você passar como cross, a API identifica corretamente — mas pedir `USD-USD` retorna erro `UNSUPPORTED_PAIR`. *** ## Limitações honestas * **Não substitui feeds profissionais para trading.** PTAX é referência oficial brasileira, divulgada uma vez ao dia (fechamento). Para estratégias *intraday*, você precisa de feeds em tempo real. * **Spread vs. mid-market.** O PTAX é uma média ponderada das operações do dia, não um bid/ask. Para precificar exposição cambial real, ajuste com spread bancário. * **Janela de fixação.** Diferentes mercados têm diferentes "fixings" (London 16:00, NY Close, BCB 13:00 BRT). Cross-rates derivados do PTAX refletem o fixing brasileiro. *** ## Endpoints relacionados * 💱 [Documentação do `/api/v2/currency/historical`](/docs/moedas/historico) * 📈 [Histórico do dólar/euro/libra via PTAX (guia completo)](/blog/historico-dolar-euro-libra-api-ptax-banco-central-2026) * 💵 [Cotações em tempo real (`/api/v2/currency`)](/docs/moedas) * 🌎 [API de Macroeconomia: Selic, IPCA e mais](/blog/api-macroeconomia-brasil-bcb-indicadores-2026) Cross-rates derivados do PTAX brasileiro são úteis quando você precisa de **consistência com a referência oficial brasileira** sem pagar por feeds internacionais. Crie sua conta em [brapi.dev](https://brapi.dev), faça upgrade para Pro e teste com `USD-EUR` ou `GBP-EUR`. # Curva de Juros do Brasil 2026: Como Reconstruir a Estrutura a Termo Prefixado e IPCA+ via API URL: /blog/curva-de-juros-brasil-prefixado-ipca-api-2026.mdx Curva de Juros do Brasil 2026: monte prefixado e IPCA+ com 2 chamadas à API brapi.dev. Taxa nominal, taxa real e inflação implícita em código. *** searchable: true title: 'Curva de Juros do Brasil 2026: Como Reconstruir a Estrutura a Termo Prefixado e IPCA+ via API' description: 'Curva de Juros do Brasil 2026: monte prefixado e IPCA+ com 2 chamadas à API brapi.dev. Taxa nominal, taxa real e inflação implícita em código.' date: '2026-05-17' keywords: 'curva de juros brasil, curva de juros brasil 2026, estrutura a termo brasil, estrutura a termo brasil python, como reconstruir curva de juros api, api tesouro direto, prefixado, ipca+, breakeven inflation, breakeven inflation tesouro direto, inflação implícita, inflação implícita prefixado vs ipca, taxa real, taxa nominal, ntn-b, ntn-b 2045 taxa real, ltn, duration, marcação a mercado, juro real brasil' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Renda Fixa e Tesouro Direto' readingTime: '13 min' tags: \['Curva de Juros', 'Prefixado', 'IPCA+', 'Tesouro Direto', 'Renda Fixa', 'API', 'TypeScript', 'Python', 'Inflação Implícita', 'NTN-B', 'LTN', 'Brasil'] relatedPosts: \['api-macroeconomia-brasil-bcb-indicadores-2026', 'cdi-historico-api-renda-fixa-benchmark-2026', 'tesouro-direto-guia-completo-2026-como-investir', 'indicadores-economicos-brasil-selic-ipca-igpm-impacto-investimentos'] featured: true expertise: 'Estrutura a termo da taxa de juros brasileira a partir do Tesouro Direto via brapi.dev' lastReviewed: '2026-05-17' howToTools: * 'Conta brapi.dev no plano Pro (Tesouro Direto detalhado)' * 'Node.js 18+, Python 3.8+ ou cURL' * 'Opcional: pandas e matplotlib para tabular e plotar a curva' howToSteps: * name: 'Obtenha um token Pro em brapi.dev' text: 'Crie ou atualize sua conta para o plano Pro em brapi.dev. A API de Tesouro Direto detalhada exige Bearer token Pro; o sandbox público cobre apenas 3 títulos e não é suficiente para montar a curva.' * name: 'Liste a curva prefixado' text: 'GET /api/v2/treasury/list?indexer=prefixado\&sortBy=maturityDate\&sortOrder=asc\&limit=30 retorna todos os Tesouro Prefixado ordenados por vencimento. buyRate/sellRate vêm em taxa nominal anual.' * name: 'Liste a curva IPCA+' text: 'GET /api/v2/treasury/list?indexer=ipca\&sortBy=maturityDate\&sortOrder=asc\&limit=30 traz Tesouro IPCA+ e Educa+. buyRate/sellRate são taxas reais anuais sobre o IPCA.' * name: 'Tabule ou plote por durationDays' text: 'Use durationDays (dias corridos até o vencimento) como eixo X e buyRate como eixo Y para visualizar a estrutura a termo nominal e real lado a lado.' * name: 'Calcule a inflação implícita (breakeven)' text: 'Para vencimentos próximos, aplique (1 + nominal) / (1 + real) - 1 sobre os buyRate em decimal. O resultado é a inflação anual média que o mercado precifica entre hoje e o vencimento.' faqSchema: * question: 'O que é a curva de juros (estrutura a termo) brasileira e por que ela importa em 2026?' answer: 'A curva de juros é o gráfico que mostra qual taxa o mercado paga em cada prazo de vencimento. No Brasil, a curva nominal vem dos Tesouro Prefixado (LTN e NTN-F) e a curva real vem dos Tesouro IPCA+ (NTN-B). Em 2026, ela serve para precificar dívida, calcular juro real, antecipar decisões do COPOM e marcar carteiras a mercado.' * question: 'Como reconstruir a curva de juros do Brasil via API em poucos minutos?' answer: 'Faça duas chamadas a /api/v2/treasury/list na brapi.dev: uma com ?indexer=prefixado e outra com ?indexer=ipca. Filtre apenas os títulos com couponType "zero" (sem cupom) e plote buyRate por durationDays. Em menos de 50 linhas de TypeScript ou Python você tem a estrutura a termo nominal e real lado a lado.' * question: 'Por que o Tesouro Selic não entra na curva de juros nominal?' answer: 'O Tesouro Selic é pós-fixado. Seu buyRate na API representa apenas o spread (em pontos percentuais ao ano) sobre a Selic, normalmente perto de zero. Como o rendimento futuro depende da Selic do período, ele não fornece um ponto fixo na estrutura a termo nominal.' * question: 'Como calcular a inflação implícita (breakeven inflation) entre Prefixado e IPCA+?' answer: 'Use a fórmula de Fisher: inflação implícita ≈ (1 + nominal) / (1 + real) - 1. O nominal vem do Tesouro Prefixado e o real vem do Tesouro IPCA+ de prazo parecido. Em 15/05/2026 a brapi.dev mostrava breakeven de 5,67% (2029), 5,80% (2031) e 5,91% (2032), bem acima da meta de inflação do CMN.' * question: 'Qual a taxa real da NTN-B 2045 e por que a curva IPCA+ é descendente?' answer: 'Em 15/05/2026 a NTN-B 2045 (tesouro-ipca-15052045) pagava 7,17% de taxa real ao ano (juro acima da inflação). A curva IPCA+ é descendente porque o mercado espera taxas reais mais baixas no longo prazo, conforme inflação e Selic convergem para níveis menores.' *** > Com um único endpoint, você monta a **Curva de Juros** brasileira inteira — > nominal e real. Nada de baixar CSV, nada de código por título. Só > `?indexer=prefixado` e `?indexer=ipca`. A **Curva de Juros** é o gráfico mais útil da renda fixa. Ela mostra qual taxa o mercado paga em cada prazo. É a chamada *curva de juros (gráfico que mostra qual taxa o mercado paga em cada prazo)* ou *estrutura a termo*. Em uma só linha, você lê o que o mercado pensa sobre juros futuros, inflação e risco. No Brasil, você monta a curva com dois grupos de títulos do Tesouro Direto. O Tesouro Prefixado dá a *taxa nominal (o juro do papel, sem descontar inflação)*. O Tesouro IPCA+ dá a *taxa real (o juro acima da inflação, ou seja, o que você ganha além da subida de preços)*. Este tutorial mostra como pegar as duas curvas inteiras com **duas chamadas HTTP** ao endpoint `/api/v2/treasury/list`. Você vai tabular por vencimento, calcular a *inflação implícita (a inflação que o mercado está prevendo, calculada na hora a partir das taxas)* e plotar tudo. Todos os números foram coletados ao vivo na base de **15/05/2026**. *** ## Por que a curva de juros importa A curva está por trás de quase toda decisão de renda fixa. Veja as leituras diretas que você consegue fazer: * **Marcar a carteira a mercado.** Prefixado e IPCA+ são marcados pela taxa do vencimento. Se a curva inteira sobe, o preço do título cai. * **Antecipar o COPOM.** O começo da curva (até 24 meses) mostra a Selic que o mercado espera. Curva subindo é expectativa de alta. Curva caindo é expectativa de corte. * **Saber o juro real travado.** O `buyRate` de um Tesouro IPCA+ é, por definição, a taxa real anual que você trava se levar o título até o fim. * **Calcular a inflação implícita.** A diferença entre a curva Prefixado e a curva IPCA+ revela quanto de inflação o mercado prevê em cada prazo. * **Construir benchmarks e fatores de risco.** O nível e a inclinação da curva entram em modelos de atribuição, ALM e VaR no mercado. *** ## Endpoint base: `/api/v2/treasury/list` A reconstrução da curva começa em um único endpoint. Ele devolve a lista completa de títulos ofertados hoje. Vem com a taxa indicativa, o preço unitário e o `durationDays` (dias corridos até o vencimento) já calculados para você. ### Curva nominal: `?indexer=prefixado` ```bash curl -H "Authorization: Bearer $BRAPI_TOKEN" \ "https://brapi.dev/api/v2/treasury/list?indexer=prefixado&sortBy=maturityDate&sortOrder=asc&limit=30" ``` Resposta (3 primeiros itens, base 15/05/2026): ```json { "results": [ { "symbol": "tesouro-prefixado-01012027", "bondType": "Tesouro Prefixado", "indexer": "prefixado", "couponType": "zero", "maturityDate": "2027-01-01", "durationDays": 231, "baseDate": "2026-05-15", "buyRate": 13.96, "sellRate": 14.08, "buyPrice": 921.33, "sellPrice": 920.24, "basePrice": 920.24, "rateInfo": { "rateType": "nominalAnnualRate", "rateUnit": "% a.a.", "description": "Para Tesouro Prefixado, buyRate e sellRate representam a taxa nominal anual contratada." } }, { "symbol": "tesouro-prefixado-01012028", "bondType": "Tesouro Prefixado", "indexer": "prefixado", "couponType": "zero", "maturityDate": "2028-01-01", "durationDays": 596, "baseDate": "2026-05-15", "buyRate": 13.95, "sellRate": 14.07, "buyPrice": 809.0, "sellPrice": 807.2, "basePrice": 807.2, "rateInfo": { "rateType": "nominalAnnualRate", "rateUnit": "% a.a." } }, { "symbol": "tesouro-prefixado-01012032", "bondType": "Tesouro Prefixado", "indexer": "prefixado", "couponType": "zero", "maturityDate": "2032-01-01", "durationDays": 2057, "baseDate": "2026-05-15", "buyRate": 14.29, "sellRate": 14.41, "buyPrice": 462.95, "sellPrice": 461.06, "basePrice": 461.06, "rateInfo": { "rateType": "nominalAnnualRate", "rateUnit": "% a.a." } } ], "requestedAt": "2026-05-17T23:30:00.000Z", "took": 41 } ``` ### Curva real: `?indexer=ipca` ```bash curl -H "Authorization: Bearer $BRAPI_TOKEN" \ "https://brapi.dev/api/v2/treasury/list?indexer=ipca&sortBy=maturityDate&sortOrder=asc&limit=30" ``` Resposta (3 itens representativos, base 15/05/2026): ```json { "results": [ { "symbol": "tesouro-ipca-15082026", "bondType": "Tesouro IPCA+", "indexer": "ipca", "couponType": "zero", "maturityDate": "2026-08-15", "durationDays": 92, "baseDate": "2026-05-15", "buyRate": 9.98, "sellRate": 10.10, "rateInfo": { "rateType": "realAnnualRateOverIpca", "rateUnit": "% a.a.", "description": "Para Tesouro IPCA+, buyRate e sellRate representam a taxa real anual acima da inflação medida pelo IPCA." } }, { "symbol": "tesouro-ipca-15082032", "bondType": "Tesouro IPCA+", "indexer": "ipca", "couponType": "zero", "maturityDate": "2032-08-15", "durationDays": 2284, "baseDate": "2026-05-15", "buyRate": 7.82, "sellRate": 7.94, "rateInfo": { "rateType": "realAnnualRateOverIpca", "rateUnit": "% a.a." } }, { "symbol": "tesouro-ipca-15052045", "bondType": "Tesouro IPCA+", "indexer": "ipca", "couponType": "zero", "maturityDate": "2045-05-15", "durationDays": 6940, "baseDate": "2026-05-15", "buyRate": 7.17, "sellRate": 7.29, "rateInfo": { "rateType": "realAnnualRateOverIpca", "rateUnit": "% a.a." } } ], "requestedAt": "2026-05-17T23:30:00.000Z", "took": 38 } ``` *** ## Exemplo em TypeScript: tabular as duas curvas O script abaixo busca prefixados e IPCA+ em paralelo. Ele mantém só os títulos *sem cupom (você só recebe no vencimento, sem juros no meio do caminho)* — `couponType: "zero"`. Assim cada ponto da curva fica limpo, sem mistura de fluxo semestral. No fim, ele imprime uma tabela bem organizada, ordenada por vencimento. Saída real (base 15/05/2026): ``` Curva Prefixado (nominal a.a.) symbol maturity days buy% sell% tesouro-prefixado-01012027 2027-01-01 231 13.96 14.08 tesouro-prefixado-01012028 2028-01-01 596 13.95 14.07 tesouro-prefixado-01012029 2029-01-01 962 14.07 14.19 tesouro-prefixado-01012031 2031-01-01 1692 14.21 14.33 tesouro-prefixado-01012032 2032-01-01 2057 14.29 14.41 Curva IPCA+ (real a.a. sobre IPCA) symbol maturity days buy% sell% tesouro-ipca-15082026 2026-08-15 92 9.98 10.10 tesouro-ipca-15052029 2029-05-15 1096 7.95 8.07 tesouro-ipca-15082032 2032-08-15 2284 7.82 7.94 tesouro-ipca-15052035 2035-05-15 3287 7.58 7.70 tesouro-ipca-15082040 2040-08-15 5206 7.27 7.39 tesouro-ipca-15052045 2045-05-15 6940 7.17 7.29 ``` O que essa foto da curva está dizendo: * A curva **prefixado** sobe um pouquinho com o prazo. Ela começa em **13,95% a.a.** no vencimento de jan/2028 (596 dias) e chega a **14,29% a.a.** em jan/2032. O mercado pede um pequeno prêmio extra para travar a taxa por mais tempo. * A curva **IPCA+** cai forte com o prazo. O título muito curto (ago/2026, 92 dias) sai a **9,98% real a.a.**. Esse número é anômalo: ele aparece no pedacinho final do papel e não vale como referência da curva longa. Já o vencimento longo (mai/2045) paga **7,17% real a.a.**. Se você tira o ponto curto de 92 dias, a curva real "limpa" vai de \~7,95% (2029) a \~7,17% (2045) — descendente. ### A curva Prefixado em um gráfico 15 bar \[13.95, 14.07, 14.21, 14.29] line \[13.95, 14.07, 14.21, 14.29] \`} /> Cada barra mostra o `buyRate` (taxa de compra) do Tesouro Prefixado para o ano de vencimento. A leitura simples: travar a taxa hoje por **4 anos** (até jan/2028) paga 13,95% ao ano. Travar por **6 anos** (até jan/2032) paga 14,29% ao ano. A diferença pequena é o prêmio extra que o mercado pede para você esperar mais tempo. ### A curva IPCA+ em um gráfico 10 bar \[7.95, 7.82, 7.58, 7.27, 7.17] line \[7.95, 7.82, 7.58, 7.27, 7.17] \`} /> Aqui usamos a curva "limpa" (sem o ponto anômalo de 92 dias). Note que ela **desce** conforme o prazo aumenta: a NTN-B 2029 paga 7,95% real ao ano e a NTN-B 2045 paga só 7,17%. Por que ela desce? Porque o mercado espera taxas reais mais baixas no longo prazo. A ideia é que, com inflação e Selic voltando para níveis menores no futuro, o juro real exigido também cai. *** ## Exemplo em Python: DataFrame + gráfico opcional Se você prefere `pandas` e `matplotlib`, dá para ter tabela e gráfico em poucas linhas. O script abaixo monta um `DataFrame` por curva, calcula a inflação implícita par a par e salva a figura em `curva.png` (se você tiver matplotlib instalado). *** ## Inflação implícita (breakeven) Quando o mercado precifica ao mesmo tempo uma curva nominal (Prefixado) e uma curva real (IPCA+) para o mesmo prazo, ele acaba revelando, sem dizer em voz alta, **quanta inflação ele está esperando** naquele período. Essa é a *inflação implícita (a inflação que o mercado está prevendo, calculada na hora a partir das taxas)*. A conta vem da equação de Fisher: $$ (1 + i\_{nominal}) = (1 + i\_{real}) \cdot (1 + \pi\_{implícita}) $$ Isolando a inflação implícita: $$ \pi\_{implícita} = \frac{1 + i\_{nominal}}{1 + i\_{real}} - 1 $$ Aplicando a fórmula aos pares disponíveis na foto de 15/05/2026 (usando `buyRate` nas duas curvas): | Vencimento | Nominal (Prefixado) | Real (IPCA+) | Inflação implícita | | ---------- | ------------------- | ------------------ | ------------------ | | 2029 | 14,07% | 7,95% | **5,67%** | | 2031 | 14,21% | 7,95% (proxy 2031) | **5,80%** | | 2032 | 14,29% | 7,91% (proxy 2032) | **5,91%** | ### A inflação implícita em um gráfico 7 bar \[5.67, 5.80, 5.91] \`} /> É a inflação que o mercado está prevendo daqui até o vencimento de cada título. Em 15/05/2026, o mercado precificava inflação anual média entre **5,7% e 5,9% para os próximos 3 a 6 anos**. Isso é bem acima da meta de **3%** do CMN. Como você usa isso na prática? Se você acha que a inflação vai ficar **abaixo** desse breakeven, o Prefixado tende a render mais que o IPCA+ no mesmo prazo. Se você acha que vai ficar **acima**, o IPCA+ é o melhor negócio. É uma aposta direta na sua visão de inflação. *** ## Cuidado: Tesouro Selic não entra na curva Se você quiser plotar a Selic Meta atual como "ponto curto" no gráfico, basta usar o endpoint de macroeconomia: ```bash curl -H "Authorization: Bearer $BRAPI_TOKEN" \ "https://brapi.dev/api/v2/macro/latest?symbols=selic" ``` E plote em `durationDays = 0` para indicar a política monetária de hoje. *** ## Frequência de atualização * **`/api/v2/treasury/list`:** o servidor da brapi guarda em cache por 15 minutos. * **Fonte:** o Tesouro Transparente publica as taxas indicativas **uma vez por dia útil**, depois que a janela de negociação fecha. Não existe "tick" intradia desses títulos — não tente buscar. * **Histórico diário:** se você precisa de uma série temporal (por exemplo, ver como a curva andou no último mês), use `/api/v2/treasury/indicators/history` com `startDate` e `endDate`. Para dashboards e relatórios, atualizar a cada 1 hora cobre todos os casos. Para batch noturno, basta uma chamada por dia depois das 19h. *** ## Próximos passos * Documentação canônica: [Guia de Tesouro Direto na brapi](/docs/tesouro-direto) * Indicadores macro brasileiros (Selic, IPCA, CDI…): [API de Macroeconomia 2026](/blog/api-macroeconomia-brasil-bcb-indicadores-2026) * Marcação a mercado de carteira CDI/CDB: [CDI Histórico via API](/blog/cdi-historico-api-renda-fixa-benchmark-2026) * Visão de produto e cobertura: [Tesouro Direto — Guia Completo 2026](/blog/tesouro-direto-guia-completo-2026-como-investir) Com **duas chamadas HTTP** você passa a ter a curva nominal e a curva real do Brasil na mão. A partir daí, montar breakeven, fazer ALM, marcar a carteira a mercado ou rodar uma calculadora de juro real vira **uma linha de código**. Crie ou atualize sua conta em [brapi.dev](https://brapi.dev) para pegar um token Pro e testar direto em produção. Os exemplos deste post foram coletados da API real e rodam sem ajuste nenhum. # Dados Históricos da B3 com Python, pandas e API URL: /blog/dados-historicos-b3-python-pandas-api.mdx Baixe cotações históricas OHLCV de ações brasileiras em Python, escolha período e intervalo, use preço ajustado e exporte os dados para CSV. *** searchable: true title: 'Dados Históricos da B3 com Python, pandas e API' description: 'Baixe cotações históricas OHLCV de ações brasileiras em Python, escolha período e intervalo, use preço ajustado e exporte os dados para CSV.' date: '2026-07-17' keywords: 'dados históricos b3 api, cotação histórica ações python, b3 pandas, ohlcv b3, baixar cotações b3 csv, histórico ações brasileiras' author: 'Alisson Leal' category: 'Tutoriais e Integrações' subcategory: 'Python e dados da B3' readingTime: '8 min' tags: \['Python', 'pandas', 'B3', 'Dados Históricos', 'OHLCV', 'CSV', 'API'] relatedPosts: \['listar-acoes-b3-api-tickers-setores-python', 'api-b3-python-requests-guia-pratico', 'backtesting-estrategias-python-brapi-guia-completo'] featured: true expertise: 'Séries temporais financeiras e integração de APIs B3' lastReviewed: '2026-07-17' -------------------------- import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; O endpoint `/api/v2/stocks/historical` retorna séries OHLCV de ações, units, ETFs, BDRs, FIIs e índices negociados na B3. Você pode pedir uma janela pronta ou informar as datas inicial e final. ```bash curl "https://brapi.dev/api/v2/stocks/historical?symbols=PETR4&range=1y&interval=1d&sortOrder=asc" ``` Cada ponto pode conter abertura, máxima, mínima, fechamento, volume e fechamento ajustado. A resposta fica pronta para um DataFrame sem baixar e interpretar o arquivo COTAHIST. ## Baixar o histórico com Python Instale as duas dependências usadas no exemplo: ```bash pip install requests pandas ``` Depois faça a consulta e transforme a série em DataFrame: ```python import os import requests import pandas as pd url = "https://brapi.dev/api/v2/stocks/historical" token = os.getenv("BRAPI_TOKEN") headers = {"Authorization": f"Bearer {token}"} if token else {} response = requests.get( url, params={ "symbols": "PETR4", "range": "1y", "interval": "1d", "sortOrder": "asc", }, headers=headers, timeout=30, ) response.raise_for_status() payload = response.json() result = payload["results"][0] prices = result["data"]["historicalDataPrice"] df = pd.DataFrame(prices) df["date"] = pd.to_datetime(df["date"], unit="s", utc=True) df = df.set_index("date").sort_index() print(df[["open", "high", "low", "close", "adjustedClose", "volume"]].tail()) ``` O campo de data pode ser timestamp Unix ou texto ISO, conforme o contrato documentado para o ativo. Se o `pd.to_datetime` receber texto, remova `unit="s"`. Consulte a [documentação do histórico de ações](/docs/acoes/historico) para confirmar tipos, limites do plano e intervalos disponíveis antes de colocar a integração em produção. ## Escolher período e intervalo Há duas formas de definir a janela. Com `range`, você pede períodos como `1mo`, `6mo`, `1y`, `5y`, `ytd` ou `max`: ```text /api/v2/stocks/historical?symbols=VALE3&range=5y&interval=1d ``` Com datas, você controla as duas pontas: ```text /api/v2/stocks/historical?symbols=VALE3&startDate=2024-01-01&endDate=2024-12-31&interval=1d ``` Intervalos aceitos incluem minutos, horas, dias, semanas e meses. A quantidade de histórico e a granularidade disponível dependem da fonte e do plano. Para análises diárias, prefira `interval=1d`. Dados intradiários ocupam mais memória, aumentam o número de pontos e nem sempre são necessários. ## Consultar vários tickers Separe até 20 símbolos por vírgula: ```bash curl "https://brapi.dev/api/v2/stocks/historical?symbols=PETR4,VALE3,ITUB4&range=1y&interval=1d" ``` Para juntar as séries sem perder o ticker: ```python frames = [] for item in payload["results"]: frame = pd.DataFrame(item["data"]["historicalDataPrice"]) frame["symbol"] = item["symbol"] frames.append(frame) history = pd.concat(frames, ignore_index=True) ``` Esse formato longo funciona bem em bancos analíticos, gráficos e comparações entre ativos. ## Fechamento normal e fechamento ajustado `close` é o preço de fechamento observado naquele pregão. `adjustedClose` procura manter a série comparável após eventos como proventos e desdobramentos. Use `close` para reproduzir o preço negociado naquela data. Use `adjustedClose` em cálculos de retorno quando o objetivo exigir uma série ajustada, depois de conferir a cobertura do ativo. Não some dividendos a uma série ajustada sem entender o ajuste. Isso pode contar o mesmo evento duas vezes. O tema é detalhado em [preço ajustado de ações na B3](/blog/preco-ajustado-acoes-dividendos-splits-b3). ## Exportar para CSV ```python df.to_csv( "PETR4-historico.csv", columns=["open", "high", "low", "close", "adjustedClose", "volume"], encoding="utf-8", ) ``` Ao importar o CSV em outro sistema, preserve o fuso horário e a ordem da série. O parâmetro `sortOrder=asc` evita inverter o tempo por acidente. ## Evitar erros silenciosos Trate pelo menos estes casos: * resposta HTTP diferente de 200; * ticker sem histórico para a janela solicitada; * campos nulos em pregões sem informação completa; * ticker antigo resolvido para um código novo; * limites de intervalo e período do plano. A resposta inclui `requestedSymbol`, `symbol` e `changed` quando a brapi resolve um código antigo. Salve o símbolo canônico junto com a série. Para descobrir os ativos antes da consulta, veja [como listar todas as ações da B3 por API](/blog/listar-acoes-b3-api-tickers-setores-python). # Dashboard da B3 no Power BI com Cotações por API URL: /blog/dashboard-b3-power-bi-api-cotacoes.mdx Conecte o Power BI à API da brapi, importe cotações de ações brasileiras com Power Query e configure um modelo que pode ser atualizado. *** searchable: true title: 'Dashboard da B3 no Power BI com Cotações por API' description: 'Conecte o Power BI à API da brapi, importe cotações de ações brasileiras com Power Query e configure um modelo que pode ser atualizado.' date: '2026-07-17' keywords: 'cotações b3 power bi, ações power bi api, dashboard bolsa power bi, power query b3, cotação ações brasileiras power bi' author: 'Alisson Leal' category: 'Tutoriais e Integrações' subcategory: 'Power BI e planilhas' readingTime: '8 min' tags: \['Power BI', 'Power Query', 'B3', 'Dashboard', 'API', 'Cotações'] relatedPosts: \['excel-cotacoes-b3-power-query-vba', 'integracao-google-sheets-cotacoes-b3-tutorial-completo', 'listar-acoes-b3-api-tickers-setores-python'] featured: true expertise: 'Integração de market data com ferramentas de BI' lastReviewed: '2026-07-17' howToTools: \['Power BI Desktop', 'Conta brapi.dev', 'Token da API'] howToSteps: * name: 'Crie um parâmetro para o token' text: 'No Power Query, crie o parâmetro BrapiToken como texto e mantenha a credencial fora da URL.' * name: 'Consulte o endpoint de cotações' text: 'Use Web.Contents com RelativePath, Query e o cabeçalho Authorization.' * name: 'Expanda a resposta JSON' text: 'Transforme results em tabela e expanda os campos symbol e data.' * name: 'Configure a atualização' text: 'Publique o relatório e configure a credencial e a frequência permitida no Power BI Service.' *** import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; O Power BI consegue ler a resposta JSON da brapi pelo Power Query. A forma mais segura é criar um parâmetro para o token e usar `Web.Contents` com URL base, caminho relativo e parâmetros separados. O exemplo abaixo consulta PETR4, VALE3 e ITUB4: ```powerquery let Source = Json.Document( Web.Contents( "https://brapi.dev", [ RelativePath = "api/v2/stocks/quote", Query = [symbols = "PETR4,VALE3,ITUB4"], Headers = [Authorization = "Bearer " & BrapiToken] ] ) ), Results = Source[results], AsTable = Table.FromList( Results, Splitter.SplitByNothing(), {"row"}, null, ExtraValues.Error ), ExpandResult = Table.ExpandRecordColumn( AsTable, "row", {"symbol", "data"}, {"symbol", "data"} ), ExpandQuote = Table.ExpandRecordColumn( ExpandResult, "data", { "shortName", "currency", "regularMarketPrice", "regularMarketChange", "regularMarketChangePercent", "regularMarketVolume", "regularMarketTime" } ) in ExpandQuote ``` ## Criar o parâmetro do token No Power BI Desktop: 1. abra **Transformar dados**; 2. escolha **Gerenciar parâmetros**; 3. crie `BrapiToken` com tipo Texto; 4. cole o token gerado no dashboard da brapi. Não coloque o token diretamente no código M que será enviado para um repositório ou compartilhado com outras pessoas. Um parâmetro melhora a manutenção, mas não transforma o token em segredo absoluto dentro de um arquivo compartilhado. Controle quem recebe o PBIX e configure a credencial novamente no Power BI Service. ## Como a resposta vira tabela A API retorna um envelope com `results`, `requestedAt` e `took`. Cada item de `results` guarda o ticker em `symbol` e a cotação em `data`. O código M executa três transformações: 1. converte `results` em linhas; 2. expande `symbol` e `data`; 3. expande os campos de cotação usados no relatório. Você pode selecionar outros campos disponíveis na [documentação de cotação](/docs/acoes/cotacao). Evite expandir tudo por padrão, pois colunas sem uso deixam o modelo maior e mais frágil. ## Usar uma tabela de tickers Para um painel editável, crie uma tabela chamada `Ativos` com uma coluna `symbol`. Depois transforme essa coluna em texto separado por vírgulas. ```powerquery Symbols = Text.Combine(List.Distinct(Ativos[symbol]), ",") ``` Substitua o valor fixo da consulta: ```powerquery Query = [symbols = Symbols] ``` A API aceita até 20 símbolos por requisição. Se a tabela passar desse limite, divida a lista em lotes e combine as respostas. ## Importar histórico para gráficos Use um segundo query para a série de preços: ```powerquery Historical = Json.Document( Web.Contents( "https://brapi.dev", [ RelativePath = "api/v2/stocks/historical", Query = [ symbols = "PETR4,VALE3", range = "1y", interval = "1d", sortOrder = "asc" ], Headers = [Authorization = "Bearer " & BrapiToken] ] ) ) ``` Expanda `results`, depois `data` e `historicalDataPrice`. Defina a data como Data/Hora e preços como Número decimal antes de criar os relacionamentos. O passo a passo em Python e a diferença entre `close` e `adjustedClose` estão em [dados históricos da B3](/blog/dados-historicos-b3-python-pandas-api). ## Atualização no Power BI Service Depois de publicar o relatório, abra as configurações do conjunto de dados. Cadastre a credencial para `https://brapi.dev` e escolha uma frequência que respeite seu plano e a necessidade do painel. Usar `RelativePath` e `Query` ajuda o Power BI Service a reconhecer uma fonte estável. URLs montadas por concatenação podem ser classificadas como fonte dinâmica e impedir a atualização agendada. A quantidade diária de atualizações também depende da licença do Power BI. Isso é separado do limite de requisições da brapi. ## Modelo mínimo do dashboard Um painel simples pode ter: * cartão com `regularMarketPrice`; * variação diária com `regularMarketChangePercent`; * volume do pregão; * linha histórica de `adjustedClose`; * tabela de ativos com horário da última cotação. Mostre `regularMarketTime` no relatório. Assim o leitor sabe quando o dado foi atualizado e não confunde a última cotação disponível com streaming de bolsa. Para importar os mesmos dados no Excel, use o tutorial de [cotações da B3 com Power Query](/blog/excel-cotacoes-b3-power-query-vba). # Tutorial: Criando um Dashboard de Dividendos com Python e Streamlit URL: /blog/dashboard-dividendos-python-streamlit-brapi-tutorial.mdx Aprenda a criar um dashboard interativo para acompanhar seus dividendos de Ações e FIIs usando Python, Streamlit e a API da brapi.dev. *** searchable: true title: 'Tutorial: Criando um Dashboard de Dividendos com Python e Streamlit' description: 'Aprenda a criar um dashboard interativo para acompanhar seus dividendos de Ações e FIIs usando Python, Streamlit e a API da brapi.dev.' date: '2025-12-28' keywords: 'python finanças, streamlit tutorial, dashboard dividendos, api brapi, acompanhar dividendos python, taee11 dividendos script' author: 'Equipe brapi.dev' category: 'Desenvolvimento' subcategory: 'Python' readingTime: '15 min' tags: \['Python', 'Streamlit', 'Dividendos', 'Tutorial', 'Data Science'] relatedPosts: \['melhores-acoes-setor-eletrico-2026-dividendos-taee11-trpl4', 'setor-seguros-bbse3-cxse3-pssa3-analise-2026', 'api-b3-python-requests-guia-pratico'] featured: true expertise: 'Tutorial técnico passo-a-passo para desenvolvedores e investidores.' lastReviewed: '2026-01-28' -------------------------- import { Authors, Author } from '~/components/Authors'; Você montou sua carteira de dividendos com as [Elétricas](/blog/melhores-acoes-setor-eletrico-2026-dividendos-taee11-trpl4) e [Seguradoras](/blog/setor-seguros-bbse3-cxse3-pssa3-analise-2026) que recomendamos. Agora, como acompanhar os pagamentos de forma visual e automática? Neste tutorial, vamos construir uma aplicação web real usando **Python** e **Streamlit** que se conecta à API da **brapi.dev** para buscar o histórico de proventos e projetar sua renda passiva. *** ## O que vamos construir? Um dashboard que: 1. Recebe uma lista de tickers (ex: `TAEE11`, `BBSE3`). 2. Busca os dividendos pagos nos últimos 12 meses. 3. Exibe gráficos de barras mensais e o *Dividend Yield* atual. ### Pré-requisitos Você precisará de Python instalado e um editor de código (VS Code). ```bash pip install streamlit pandas requests plotly ``` *** ## Passo 1: Configurando a Conexão com a API Crie um arquivo chamado `app.py`. Vamos começar criando a função que busca os dados na brapi. ```python import streamlit as st import pandas as pd import requests import plotly.express as px # Configuração da Página st.set_page_config(page_title="Dashboard de Dividendos", layout="wide") # Token da brapi (Pegue o seu em https://brapi.dev/dashboard) API_TOKEN = "SEU_TOKEN_AQUI" @st.cache_data def get_dividends(tickers): """ Busca dados de dividendos para uma lista de tickers. """ tickers_str = ",".join(tickers) url = f"https://brapi.dev/api/quote/{tickers_str}" params = { 'token': API_TOKEN, 'dividends': 'true', # Habilita o retorno de dividendos } response = requests.get(url, params=params) if response.status_code != 200: st.error("Erro ao conectar na API da brapi.") return [] return response.json().get('results', []) ``` ## Passo 2: Processando os Dados A API retorna os dados brutos. Precisamos transformá-los em um DataFrame do Pandas para facilitar a análise. ```python def process_data(results): all_dividends = [] for stock in results: symbol = stock['symbol'] dividends = stock.get('dividendsData', {}).get('cashDividends', []) for div in dividends: # Filtrar apenas dividendos aprovados/pagos all_dividends.append({ 'Ticker': symbol, 'Data Com': div.get('approvedOn'), 'Data Pagamento': div.get('paymentDate'), 'Valor': div.get('rate'), 'Tipo': div.get('type') # Dividendo ou JCP }) df = pd.DataFrame(all_dividends) if not df.empty: # Converter datas e criar coluna Mês/Ano df['Data Pagamento'] = pd.to_datetime(df['Data Pagamento']) df['Mes_Ano'] = df['Data Pagamento'].dt.strftime('%Y-%m') return df ``` ## Passo 3: Criando a Interface Visual Agora, vamos usar o poder do Streamlit para criar a interface. ```python st.title("💰 Dashboard de Renda Passiva 2026") st.markdown("Acompanhe os proventos da sua carteira de forma simples.") # Input do Usuário tickers_input = st.text_input("Digite os tickers separados por vírgula:", "TAEE11,BBSE3,VALE3,ITUB4") tickers_list = [t.strip().upper() for t in tickers_input.split(",")] if st.button("Buscar Proventos"): with st.spinner('Consultando a brapi.dev...'): results = get_dividends(tickers_list) df = process_data(results) if df.empty: st.warning("Nenhum dividendo encontrado ou tickers inválidos.") else: # Filtro de Data (Últimos 12 meses, por exemplo) # Para simplificar, vamos mostrar tudo que a API retornou # Métricas Gerais col1, col2 = st.columns(2) total_pago = df['Valor'].sum() col1.metric("Total Recebido (R$)", f"R$ {total_pago:,.2f}") col2.metric("Qtd. Pagamentos", len(df)) # Gráfico de Pagamentos por Mês st.subheader("📅 Pagamentos por Mês") df_grouped = df.groupby('Mes_Ano')['Valor'].sum().reset_index() fig = px.bar(df_grouped, x='Mes_Ano', y='Valor', color='Valor', title="Evolução da Renda Passiva", text_auto=True) st.plotly_chart(fig, use_container_width=True) # Detalhamento por Ativo st.subheader("📊 Detalhamento por Ativo") df_asset = df.groupby('Ticker')['Valor'].sum().reset_index() fig2 = px.pie(df_asset, values='Valor', names='Ticker', title="Quem pagou mais?") st.plotly_chart(fig2, use_container_width=True) # Tabela de Dados st.subheader("Extrato Detalhado") st.dataframe(df.sort_values('Data Pagamento', ascending=False)) ``` ## Passo 4: Rodando a Aplicação No seu terminal, execute: ```bash streamlit run app.py ``` Uma aba do navegador abrirá automaticamente. Você verá seu dashboard funcionando! *** ## Conclusão e Próximos Passos Este é um MVP (Produto Mínimo Viável). Você pode evoluir este projeto para: 1. **Input de Quantidade:** Permitir que o usuário digite quantas ações tem de cada empresa para calcular o valor real recebido (hoje o script mostra o valor por 1 ação). 2. **Cálculo de Yield:** Cruzar o valor pago com o preço atual (`regularMarketPrice` da API) para calcular o *Dividend Yield* da carteira. 3. **Deploy:** Subir seu app gratuitamente no **Streamlit Cloud**. A API da brapi.dev fornece todos os dados necessários para você construir ferramentas profissionais. **Quer aprender mais?** Veja como criar um [Bot de Telegram para Alertas](/blog/bot-telegram-cotacoes-acoes-python-tutorial) no próximo tutorial. # Dashboard de Renda Fixa em Next.js: Tutorial Completo com a API de Tesouro Direto da brapi (2026) URL: /blog/dashboard-renda-fixa-nextjs-tesouro-direto-tutorial.mdx Dashboard Tesouro Direto Next.js: tutorial com App Router, Server Components, Recharts e API brapi.dev. Código testado e gráficos prontos. *** searchable: true title: 'Dashboard de Renda Fixa em Next.js: Tutorial Completo com a API de Tesouro Direto da brapi (2026)' description: 'Dashboard Tesouro Direto Next.js: tutorial com App Router, Server Components, Recharts e API brapi.dev. Código testado e gráficos prontos.' date: '2026-05-17' keywords: 'dashboard tesouro direto next.js 2026, tutorial next.js renda fixa brasil, server components tesouro direto, recharts tesouro direto exemplo, next.js app router api brapi, tailwind dashboard renda fixa, dashboard renda fixa nextjs, tesouro direto api, brapi treasury, marcação a mercado api, taxa tesouro prefixado api, tesouro ipca real api, tesouro selic spread api, renda fixa typescript tutorial, app router server components, recharts gráfico tesouro, dashboard brapi.dev pro, tutorial next.js 15 tesouro, api tesouro direto json' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Next.js' readingTime: '16 min' tags: \['Next.js', 'React', 'TypeScript', 'Tesouro Direto', 'Renda Fixa', 'Tailwind', 'App Router', 'Recharts', 'Server Components'] relatedPosts: \[ 'api-acoes-react-nextjs-tutorial', 'api-b3-typescript-javascript-integracao-completa', 'tesouro-direto-guia-completo-2026-como-investir', 'cdi-historico-api-renda-fixa-benchmark-2026', ] featured: true expertise: 'Integração ponta a ponta da API de Tesouro Direto da brapi.dev com Next.js App Router e Server Components' lastReviewed: '2026-05-17' howToTools: * 'Node.js 20+' * 'bun, pnpm ou npm' * 'Conta brapi.dev no plano Pro' howToSteps: * name: 'Crie o projeto Next.js' text: 'bun create next-app\@latest tesouro-dashboard --typescript --tailwind --app cria um app moderno com App Router.' * name: 'Configure o token da brapi' text: 'Copie seu token no painel da brapi.dev e adicione BRAPI\_TOKEN ao .env.local.' * name: 'Implemente o cliente de Tesouro Direto' text: 'Crie lib/brapi.ts com treasuryList, treasuryIndicators e treasuryHistory, usando fetch com next.revalidate para alinhar com o cache da brapi.' * name: 'Monte a página em Server Component' text: 'Em app/page.tsx faça Promise.all para listar títulos, buscar snapshot e histórico em paralelo.' * name: 'Renderize o gráfico com Recharts' text: 'Crie components/PriceChart.tsx como Client Component com Recharts e plote sellPrice por baseDate.' faqSchema: * question: 'Quais endpoints da brapi alimentam o dashboard Tesouro Direto em Next.js?' answer: 'GET /api/v2/treasury/list para a oferta paginada, GET /api/v2/treasury/indicators para snapshot atual de até 20 símbolos e GET /api/v2/treasury/indicators/history para a série diária de taxas e preços. Os três endpoints são consumidos em paralelo no Server Component da página.' * question: 'Preciso de plano Pro da brapi.dev para seguir este tutorial de Next.js renda fixa?' answer: 'Sim, a API completa de Tesouro Direto exige plano Pro. No sandbox, sem token, você consegue testar três títulos: tesouro-selic-01032031, tesouro-prefixado-com-juros-semestrais-01012037 e tesouro-ipca-com-juros-semestrais-15082060. Dá pra desenvolver o dashboard inteiro só com esses três.' * question: 'Por que buyRate e sellRate são tão diferentes entre Tesouro Selic e Tesouro Prefixado na API?' answer: 'Porque a semântica muda por indexador. Em Tesouro Selic, são o spread em pontos percentuais sobre a Selic (próximo de zero). Em Tesouro Prefixado, são a taxa nominal anual contratada. Em Tesouro IPCA+, são a taxa real anual acima da inflação. O campo rateInfo.rateType explica como exibir cada um no dashboard.' * question: 'Server Component ou Client Component para o gráfico de marcação a mercado no Next.js App Router?' answer: 'O fetch dos dados é Server Component (zero JS no cliente, cache do Next.js). Apenas o gráfico em si é Client Component (use client) porque Recharts depende do DOM. Os dados chegam por props já tratados, então o gráfico só hidrata a parte visual.' * question: 'Como funciona o cache em camadas do dashboard Tesouro Direto Next.js?' answer: 'São quatro camadas. Primeiro o cache do navegador do usuário, depois o Vercel Edge Cache, em seguida o Data Cache do Next.js com revalidate de 900 segundos e por fim o cache de 15 minutos da brapi.dev. Por isso a página chega em milissegundos no segundo acesso.' *** import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > Você quer um **Dashboard Tesouro Direto Next.js** no ar antes do café acabar? > Em cerca de 150 linhas, você monta a tela com a oferta atual, taxas ao vivo > e o gráfico de marcação a mercado. Os dados vêm da API da brapi.dev e > ficam guardados no cache na borda (cópia temporária da resposta perto do > usuário). O Tesouro Direto é o produto de renda fixa mais popular do Brasil. Mas, para quem programa, os dados públicos são chatos de usar. O arquivo oficial vem em CSV. Os tickers são internos. E a taxa muda de sentido conforme o indexador do título. Neste tutorial você vai construir um **Dashboard Tesouro Direto Next.js** do zero. A base é o **Next.js 15** com App Router (jeito novo do Next.js de organizar páginas, com a pasta `app/`). A página consome três endpoints novos da brapi.dev: * `GET /api/v2/treasury/list` — oferta paginada com filtros * `GET /api/v2/treasury/indicators` — snapshot atual (até 20 símbolos) * `GET /api/v2/treasury/indicators/history` — série diária de taxas e preços Você vai usar Server Components (componente que roda só no servidor — vem pronto pro navegador, sem JavaScript do lado do cliente) para buscar tudo. O cache do Next.js guarda a resposta. Só o gráfico é um client component (componente que precisa rodar no navegador do usuário, ex.: gráficos e botões interativos), feito com **Recharts**. O Tailwind cuida do visual. Todo o código foi testado contra a API real antes da publicação. *** ## O que vamos construir São três blocos numa só página. Tudo gira em torno de um Server Component principal: 1. **Tabela paginada da oferta atual** — todos os títulos disponíveis hoje no Tesouro Direto. Você filtra por indexador (Selic, Prefixado, IPCA+) pelos `searchParams`. 2. **Cards de taxas atuais** dos três títulos do sandbox: Tesouro Selic 2031, Tesouro Prefixado com Juros Semestrais 2037 e Tesouro IPCA+ com Juros Semestrais 2060. Cada card mostra a taxa indicativa de venda na forma certa para o indexador. 3. **Gráfico de marcação a mercado** do `sellPrice` do Tesouro Prefixado 2037. Ele plota a série diária de fevereiro a maio de 2026 com Recharts. A página é um Server Component só. Ele faz `Promise.all` das três chamadas ao mesmo tempo. Depois do primeiro acesso, o cache do Next.js entrega o HTML em milissegundos. Server Component] --> B[lib/brapi.ts
treasuryList · treasuryIndicators · treasuryHistory] B --> C[brapi.dev API
/api/v2/treasury/*] A -.passa dados via props.-> D[components/PriceChart.tsx
use client] D --> E[Recharts
LineChart] A --> F[components/BondsTable.tsx
Server Component] A --> G[components/RateCard.tsx
Server Component] `} /> *Acima: a arquitetura do dashboard. A página principal busca os dados no servidor. Só o gráfico vira client component porque o Recharts precisa do navegador.* *** ## Pré-requisitos * **Node.js 20+** (qualquer LTS recente serve) * **bun**, **pnpm** ou **npm** — os exemplos abaixo usam bun * **Conta brapi.dev no plano Pro** para acessar a base completa de títulos * Quer testar sem assinar? Use os três símbolos sandbox citados acima. Eles funcionam sem token. A listagem completa e o histórico diário de **todos** os títulos pedem o plano Pro. Os três sandbox (Selic 2031, Prefixado 2037, IPCA+ 2060) abrem sem autenticação. Dá pra desenvolver o dashboard inteiro só com eles. *** ## Configurando o projeto ### Criando o app Next.js ```bash bun create next-app@latest tesouro-dashboard --typescript --tailwind --app cd tesouro-dashboard ``` Prefere outro gerenciador? Use um destes: ```bash # pnpm pnpm create next-app@latest tesouro-dashboard --typescript --tailwind --app # npm npx create-next-app@latest tesouro-dashboard --typescript --tailwind --app ``` ### Variáveis de ambiente Crie `.env.local` na raiz: ```bash BRAPI_TOKEN=seu_token_pro_aqui BRAPI_BASE_URL=https://brapi.dev/api/v2/treasury ``` A variável `BRAPI_TOKEN` é lida só no servidor. Ela não tem o prefixo `NEXT_PUBLIC_`. Então ela nunca vaza para o navegador do usuário. ### Estrutura final ``` tesouro-dashboard/ ├── app/ │ ├── layout.tsx │ ├── loading.tsx │ └── page.tsx # Server Component principal ├── components/ │ ├── BondsTable.tsx # Tabela paginada │ ├── RateCard.tsx # Card de taxa atual │ └── PriceChart.tsx # Client Component com Recharts ├── lib/ │ ├── brapi.ts # Cliente tipado │ └── rate.ts # Helper de formatação por indexador └── .env.local ``` *** ## Cliente da brapi: `lib/brapi.ts` Este arquivo guarda todos os fetches e os tipos dos dados. Tudo aqui roda só no servidor, dentro de Server Components. Por isso o token nunca chega no navegador. ```typescript // lib/brapi.ts const BASE = process.env.BRAPI_BASE_URL || 'https://brapi.dev/api/v2/treasury'; const TOKEN = process.env.BRAPI_TOKEN; export type Indexer = 'selic' | 'prefixado' | 'ipca' | 'igpm'; export type CouponType = 'zero' | 'semestral'; export type RateInfo = { rateType: | 'spreadOverSelic' | 'nominalAnnualRate' | 'realAnnualRateOverIpca' | 'realAnnualRateOverIgpm'; rateUnit: string; description: string; }; export type TreasuryBond = { symbol: string; bondType: string; indexer: Indexer; couponType: CouponType; maturityDate: string; // YYYY-MM-DD durationDays: number; baseDate: string; buyRate: number | null; sellRate: number | null; buyPrice: number | null; sellPrice: number | null; basePrice: number | null; rateInfo: RateInfo; }; export type Pagination = { page: number; limit: number; totalItems: number; totalPages: number; hasNextPage: boolean; }; export type ListResponse = { results: TreasuryBond[]; pagination: Pagination; requestedAt: string; took: number; }; export type IndicatorsResponse = { results: TreasuryBond[]; requestedAt: string; took: number; }; export type HistoryPoint = { baseDate: string; buyRate: number | null; sellRate: number | null; buyPrice: number | null; sellPrice: number | null; basePrice: number | null; }; export type HistorySeries = { symbol: string; bondType: string; indexer: Indexer; couponType: CouponType; maturityDate: string; rateInfo: RateInfo; history: HistoryPoint[]; }; export type HistoryResponse = { results: HistorySeries[]; requestedAt: string; took: number; }; function headers() { return TOKEN ? { Authorization: `Bearer ${TOKEN}` } : undefined; } // Cache alinhado com a TTL típica da brapi (~15 min para snapshot). // next.revalidate em segundos: o Next.js armazena no Data Cache. async function brapiFetch( path: string, qs: URLSearchParams, revalidate: number, ): Promise { const res = await fetch(`${BASE}${path}?${qs}`, { headers: headers(), next: { revalidate, tags: ['treasury'] }, }); if (!res.ok) { throw new Error(`brapi ${path} falhou: ${res.status}`); } return (await res.json()) as T; } export async function treasuryList( params: { page?: number; limit?: number; indexer?: Indexer; couponType?: CouponType; search?: string; sortBy?: 'maturityDate' | 'sellRate' | 'durationDays'; sortOrder?: 'asc' | 'desc'; } = {}, ): Promise { const qs = new URLSearchParams(); for (const [k, v] of Object.entries(params)) { if (v !== undefined) qs.set(k, String(v)); } return brapiFetch('/list', qs, 900); } export async function treasuryIndicators( symbols: string[], ): Promise { if (symbols.length === 0 || symbols.length > 20) { throw new Error('symbols deve ter entre 1 e 20 itens'); } const qs = new URLSearchParams({ symbols: symbols.join(',') }); return brapiFetch('/indicators', qs, 900); } export async function treasuryHistory(args: { symbol: string; startDate: string; // YYYY-MM-DD endDate: string; // YYYY-MM-DD }): Promise { const qs = new URLSearchParams({ symbols: args.symbol, startDate: args.startDate, endDate: args.endDate, sortOrder: 'asc', }); const data = await brapiFetch( '/indicators/history', qs, 3600, ); return data.results[0] ?? null; } ``` O `fetch` com `next.revalidate` liga o **Data Cache** do Next.js. Esse é o jeito de revalidar (refazer o pedido depois de N segundos pra ter dado novo). A brapi já faz cache na borda. Por isso você não precisa de Redis no seu app, nem da biblioteca de cache no cliente. O Next.js cuida disso sozinho. Pra invalidar na hora, chame `revalidateTag('treasury')` dentro de uma Server Action. *** ## Helper de formatação: `lib/rate.ts` Antes de mostrar qualquer taxa, você precisa lembrar de uma coisa. Os campos `buyRate` e `sellRate` querem dizer coisas diferentes em cada indexador. Este helper junta todas as regras num lugar só: ```typescript // lib/rate.ts import type { RateInfo } from './brapi'; export function formatRate(rateInfo: RateInfo, rate: number | null): string { if (rate == null) return '—'; switch (rateInfo.rateType) { case 'spreadOverSelic': // Tesouro Selic: spread em p.p. sobre a Selic. Quase sempre próximo de zero. return `Selic + ${rate.toFixed(2)}% a.a.`; case 'nominalAnnualRate': // Tesouro Prefixado: taxa nominal anual contratada. return `${rate.toFixed(2)}% a.a.`; case 'realAnnualRateOverIpca': // Tesouro IPCA+: taxa real anual acima da inflação medida pelo IPCA. return `IPCA + ${rate.toFixed(2)}% a.a.`; case 'realAnnualRateOverIgpm': // Tesouro IGP-M (histórico): taxa real anual acima do IGP-M. return `IGP-M + ${rate.toFixed(2)}% a.a.`; } } export function indexerLabel(indexer: string): string { switch (indexer) { case 'selic': return 'Pós-fixado (Selic)'; case 'prefixado': return 'Prefixado'; case 'ipca': return 'IPCA+'; case 'igpm': return 'IGP-M'; default: return indexer; } } ``` Veja o que dá no terminal com os três símbolos sandbox. Esses números foram buscados ao vivo antes de publicar este tutorial: ``` tesouro-selic-01032031 -> Selic + 0.09% a.a. tesouro-prefixado-com-juros-semestrais-01012037 -> 14.48% a.a. tesouro-ipca-com-juros-semestrais-15082060 -> IPCA + 7.34% a.a. ``` Este é o erro mais comum em dashboards de Tesouro. Quem mostra "0,09% a.a." no Tesouro Selic 2031, sem o "Selic +" na frente, engana o leitor. Parece que o título rende 0,09% ao ano. Na verdade ele rende a Selic cheia (14,5%) mais 0,09 ponto percentual. *** ## Página principal: `app/page.tsx` Este é o coração do **Dashboard Tesouro Direto Next.js**. Tudo é Server Component. O `Promise.all` dispara as três requisições ao mesmo tempo. Olhe o caminho que cada pedido faz: >N: GET / N->>P: render Server Component P->>B: Promise.all → treasuryList P->>B: Promise.all → treasuryIndicators P->>B: Promise.all → treasuryHistory B-->>P: 3 respostas em paralelo P-->>N: HTML renderizado N-->>U: HTML chega no navegador U->>C: hydration do gráfico C-->>U: Recharts desenha a linha `} /> *Acima: o caminho de render do Server Component. As três chamadas saem ao mesmo tempo. O HTML chega pronto pro navegador. Só depois disso o gráfico hidrata (vira interativo).* ```tsx // app/page.tsx import { treasuryList, treasuryIndicators, treasuryHistory, } from '@/lib/brapi'; import { BondsTable } from '@/components/BondsTable'; import { RateCard } from '@/components/RateCard'; import { PriceChart } from '@/components/PriceChart'; export const metadata = { title: 'Dashboard Tesouro Direto — brapi', description: 'Oferta atual do Tesouro Direto, taxas indicativas e marcação a mercado em tempo quase real.', }; const SANDBOX_SYMBOLS = [ 'tesouro-selic-01032031', 'tesouro-prefixado-com-juros-semestrais-01012037', 'tesouro-ipca-com-juros-semestrais-15082060', ]; const CHART_SYMBOL = 'tesouro-prefixado-com-juros-semestrais-01012037'; type SearchParams = { page?: string; indexer?: 'selic' | 'prefixado' | 'ipca' | 'igpm'; }; export default async function HomePage({ searchParams, }: { searchParams: Promise; }) { const sp = await searchParams; const page = Number(sp.page ?? '1'); const indexer = sp.indexer; const [list, indicators, history] = await Promise.all([ treasuryList({ page, limit: 10, indexer, sortBy: 'maturityDate', sortOrder: 'asc', }), treasuryIndicators(SANDBOX_SYMBOLS), treasuryHistory({ symbol: CHART_SYMBOL, startDate: '2026-01-01', endDate: '2026-05-15', }), ]); return (

Dashboard Tesouro Direto

Snapshot às {new Date(indicators.requestedAt).toLocaleString('pt-BR')}{' '} — dados via{' '} brapi.dev .

Taxas atuais (sandbox)

{indicators.results.map((bond) => ( ))}

Marcação a mercado — Tesouro Prefixado 2037

{history ? ( ) : (

Sem histórico disponível.

)}

Oferta atual

); } ``` *** ## Card de taxa: `components/RateCard.tsx` Este é um Server Component puro. Não tem `'use client'`. Ele recebe um `TreasuryBond` e usa o helper para escolher o jeito certo de mostrar a taxa. ```tsx // components/RateCard.tsx import type { TreasuryBond } from '@/lib/brapi'; import { formatRate, indexerLabel } from '@/lib/rate'; export function RateCard({ bond }: { bond: TreasuryBond }) { const sell = formatRate(bond.rateInfo, bond.sellRate); const maturity = new Date(bond.maturityDate).toLocaleDateString('pt-BR'); return (

{indexerLabel(bond.indexer)} {bond.couponType === 'semestral' ? ' · com cupom semestral' : ''}

{bond.bondType}

Vencimento: {maturity}

{sell}

Taxa indicativa de venda · base {bond.baseDate}

{bond.sellPrice != null && (

PU de venda:{' '} R$ {bond.sellPrice.toFixed(2)}

)}
); } ``` *** ## Tabela paginada com URL state: `components/BondsTable.tsx` Guardar o estado na URL é o jeito certo no App Router. O endereço `?page=2&indexer=ipca` vira a fonte da verdade. O Server Component renderiza de novo com os dados certos. Você não precisa de biblioteca nenhuma. Só do ``. ```tsx // components/BondsTable.tsx import Link from 'next/link'; import type { TreasuryBond, Pagination, Indexer } from '@/lib/brapi'; import { formatRate, indexerLabel } from '@/lib/rate'; const INDEXERS: Array = [ undefined, 'selic', 'prefixado', 'ipca', ]; export function BondsTable({ bonds, pagination, currentIndexer, }: { bonds: TreasuryBond[]; pagination: Pagination; currentIndexer?: Indexer; }) { const buildHref = (params: { page?: number; indexer?: Indexer; }): string => { const qs = new URLSearchParams(); if (params.page && params.page > 1) qs.set('page', String(params.page)); if (params.indexer) qs.set('indexer', params.indexer); const str = qs.toString(); return str ? `/?${str}` : '/'; }; return (
{bonds.map((b) => ( ))}
Título Vencimento Taxa de venda PU venda
{b.bondType} {b.couponType === 'semestral' && ( cupom semestral )} {new Date(b.maturityDate).toLocaleDateString('pt-BR')} {formatRate(b.rateInfo, b.sellRate)} {b.sellPrice != null ? `R$ ${b.sellPrice.toFixed(2)}` : '—'}
Página {pagination.page} de {pagination.totalPages} ·{' '} {pagination.totalItems} títulos
{pagination.page > 1 && ( Anterior )} {pagination.hasNextPage && ( Próxima )}
); } ``` Tudo que muda na tabela vive em `searchParams`. Isso vale para o filtro de indexador e para a paginação. O App Router entende isso sozinho. Quando o usuário clica num ``, o Server Component renderiza de novo. Você ganha três coisas de graça: histórico do navegador, link que pode ser compartilhado e SEO. *** ## Gráfico no cliente: `components/PriceChart.tsx` O Recharts precisa do DOM. Por isso este arquivo é um client component. Ele recebe a série já pronta, vinda do Server Component, e desenha o gráfico. Instale o Recharts: ```bash bun add recharts ``` O componente: ```tsx // components/PriceChart.tsx 'use client'; import { LineChart, Line, XAxis, YAxis, Tooltip, CartesianGrid, ResponsiveContainer, } from 'recharts'; import type { HistoryPoint } from '@/lib/brapi'; export function PriceChart({ series }: { series: HistoryPoint[] }) { // sellPrice é o PU indicativo de venda no dia — marcação a mercado. const data = series .filter((p) => p.sellPrice != null) .map((p) => ({ date: p.baseDate, sellPrice: p.sellPrice as number, })); if (data.length === 0) { return

Sem dados no período.

; } const min = Math.min(...data.map((d) => d.sellPrice)); const max = Math.max(...data.map((d) => d.sellPrice)); const pad = (max - min) * 0.1; return (
new Date(d).toLocaleDateString('pt-BR', { day: '2-digit', month: '2-digit', }) } minTickGap={32} /> `R$ ${v.toFixed(0)}`} /> [`R$ ${v.toFixed(2)}`, 'PU venda']} labelFormatter={(d) => new Date(d).toLocaleDateString('pt-BR')} />
); } ``` Cada ponto da série tem esta forma. O exemplo foi tirado direto do endpoint `/api/v2/treasury/indicators/history`: ```json { "baseDate": "2026-02-02", "buyRate": 13.56, "sellRate": 13.68, "buyPrice": 820.97, "sellPrice": 815.06, "basePrice": 815.06 } ``` A série do Prefixado 2037 entre janeiro e maio de 2026 tem 70 pontos (um por dia útil). O `sellPrice` cai de R$ 815 para R$ 809 no período. Isso mostra a curva de juros abrindo. É justamente esse efeito que tem nome de **marcação a mercado**. E o gráfico deixa ele visível. *** ## Cuidados com o `rateInfo` Tabelas que misturam vários indexadores na mesma coluna "taxa" caem numa armadilha. Olhe este pedaço real da resposta: ```json [ { "symbol": "tesouro-selic-01032031", "sellRate": 0.09, "rateInfo": { "rateType": "spreadOverSelic" } }, { "symbol": "tesouro-prefixado-com-juros-semestrais-01012037", "sellRate": 14.48, "rateInfo": { "rateType": "nominalAnnualRate" } }, { "symbol": "tesouro-ipca-com-juros-semestrais-15082060", "sellRate": 7.34, "rateInfo": { "rateType": "realAnnualRateOverIpca" } } ] ``` Se você jogar o `sellRate` numa coluna chamada só "Taxa", o leitor vai achar que o Tesouro Selic 2031 rende 0,09% ao ano. Isso é um desastre. O helper `formatRate` do tutorial evita esse erro: Nunca mostre `buyRate` ou `sellRate` sem olhar o `rateInfo.rateType`. O campo `rateInfo.description` já vem com a explicação em português pronta. Dá pra usar direto num tooltip. ```tsx // Exemplo de tooltip explicativo {formatRate(bond.rateInfo, bond.sellRate)} ``` *** ## `app/loading.tsx`: streaming Server Components combinam bem com o arquivo `loading.tsx`. Ele vira um limite de Suspense automático na raiz. Enquanto os dados não chegam, o usuário já vê uma "casca" da página: ```tsx // app/loading.tsx export default function Loading() { return (
{Array.from({ length: 3 }).map((_, i) => (
))}
); } ``` *** ## Deploy na Vercel É bem direto: ```bash bun add -g vercel vercel deploy ``` Agora, configure as duas variáveis de ambiente no painel da Vercel (Settings → Environment Variables): | Variável | Valor | | ---------------- | ----------------------------------- | | `BRAPI_TOKEN` | seu token de produção da brapi.dev | | `BRAPI_BASE_URL` | `https://brapi.dev/api/v2/treasury` | A brapi já entrega respostas no cache na borda. O tempo de vida é bom: 15 minutos para snapshot e mais que isso para o histórico. Combine isso com o `next.revalidate` do nosso cliente. Você não precisa da biblioteca de cache no cliente, nem de Redis, nem de `useEffect`. O HTML chega pronto. O gráfico hidrata. Fim. ### Cache em camadas A resposta passa por várias camadas antes de chegar ao usuário. Olhe o fluxo: cache local] -- miss --> B[Vercel Edge Cache] B -- TTL curto --> C[Next.js Data Cache
revalidate: 900s] C -- TTL 15min --> D[brapi.dev cache
~15 min] D -- miss --> E[Fonte: Tesouro Transparente] E -. CSV diário .-> D D -. JSON .-> C C -. HTML .-> B B -. HTML pronto .-> A `} /> *Acima: o cache em camadas. Quando o usuário pede a página, a resposta quase sempre vem de uma camada perto dele. Por isso o tempo de resposta costuma ser de poucos milissegundos. Só de vez em quando o pedido vai até o Tesouro Transparente.* Quer forçar uma atualização (por exemplo, num webhook diário ao final do pregão)? Crie uma Server Action que chama `revalidateTag('treasury')`. Todo `fetch` marcado em `lib/brapi.ts` será buscado de novo no próximo acesso. *** ## Próximos passos Este **Dashboard Tesouro Direto Next.js** cobre o básico. Daqui dá pra evoluir em várias direções: * **Curva de juros prefixada** — junte vários prefixados de vencimentos diferentes. Plote `sellRate` no eixo Y e `maturityDate` no eixo X (duração). O endpoint `list` com `indexer=prefixado&sortBy=maturityDate` entrega tudo de uma vez só. * **Comparador de títulos** — monte uma página `/comparar?symbols=A,B,C` com a função `treasuryIndicators` (ela aceita até 20 símbolos por chamada). * **Alertas de marcação** — uma Server Action diária compara o último `sellPrice` do histórico com um teto ou um piso. Se passar, dispara webhook. * **Cruzamento com macro** — coloque a série da Selic do endpoint [`/api/v2/macro`](/blog/api-macroeconomia-brasil-bcb-indicadores-2026) no mesmo gráfico. Você vê na hora como a Selic mexe nos preços dos títulos. Quer ir mais fundo? Estes posts ajudam: * [Tesouro Direto: guia completo 2026 — como investir](/blog/tesouro-direto-guia-completo-2026-como-investir) * [CDI histórico via API: benchmark de renda fixa 2026](/blog/cdi-historico-api-renda-fixa-benchmark-2026) * [API de ações com React e Next.js](/blog/api-acoes-react-nextjs-tutorial) * [API B3 com TypeScript: integração completa](/blog/api-b3-typescript-javascript-integracao-completa) A documentação da API de Tesouro Direto fica em [brapi.dev/docs/tesouro-direto](https://brapi.dev/docs/tesouro-direto). O plano Pro libera os três endpoints deste tutorial e a base completa de títulos. *** **Pronto para construir o seu Dashboard Tesouro Direto Next.js?** [Crie sua conta na brapi.dev](https://brapi.dev/signup), faça upgrade para o plano Pro e coloque o dashboard no ar antes do café acabar. # Day Trade vs Swing Trade vs Position Trade 2026: Qual Estratégia Escolher? URL: /blog/day-trade-swing-trade-position-trade-2026.mdx Diferenças entre day trade, swing trade e position trade! Comparativo de estratégias, tributação, riscos e capital ✓ *** searchable: true title: 'Day Trade vs Swing Trade vs Position Trade 2026: Qual Estratégia Escolher?' description: 'Diferenças entre day trade, swing trade e position trade! Comparativo de estratégias, tributação, riscos e capital ✓' date: '2026-01-01' keywords: 'day trade 2026, swing trade, position trade, diferenca day trade swing trade, como fazer day trade, o que e swing trade, operacoes de curto prazo, trader iniciante, melhor estrategia trading' author: 'Equipe brapi.dev' category: 'Trading' subcategory: 'Estratégias' readingTime: '24 min' tags: \['Day Trade', 'Swing Trade', 'Position Trade', 'Trading', 'Análise Técnica', 'Estratégias', 'Tributação'] relatedPosts: \['melhores-acoes-pagadoras-dividendos-2026', 'como-declarar-investimentos-imposto-renda-2026', 'como-investir-com-pouco-dinheiro-2026', 'stop-loss-stop-gain-como-usar', 'analise-tecnica-vs-fundamentalista-qual-escolher'] featured: true expertise: 'Estratégias de trading e operações de curto, médio e longo prazo' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > Qual a diferença entre day trade, swing trade e position trade? Qual estratégia é melhor para você? Este guia compara as três abordagens em profundidade: riscos, retornos, tributação, capital necessário e perfil ideal. *** ## O Que São Essas Estratégias? Antes de comparar, vamos definir cada uma: | Estratégia | Duração | Objetivo | Análise Principal | | ------------------ | --------------------------- | ---------------------------------- | ------------------------- | | **Day Trade** | Minutos a horas (mesmo dia) | Lucrar com oscilações intradiárias | Técnica (gráficos, fluxo) | | **Swing Trade** | Dias a semanas | Capturar movimentos de curto prazo | Técnica + Momentum | | **Position Trade** | Semanas a meses | Seguir tendências maiores | Técnica + Fundamentos | | **Buy & Hold** | Anos a décadas | Valorização de longo prazo | Fundamentalista | ### Visualização das Diferenças **Comparativo entre estratégias de trading:** | Aspecto | Day Trade | Swing Trade | Position Trade | Buy & Hold | | --------------------- | -------------------- | --------------------- | ------------------- | ------------------------- | | **Duração** | Minutos a horas | Dias a semanas | Semanas a meses | Anos a décadas | | **Operações/mês** | 20 a 200+ | 5 a 20 | 2 a 5 | 0 a 2 | | **Capital mínimo** | R$ 5.000 - R$ 50.000 | R$ 10.000 - R$ 50.000 | R$ 10.000+ | Qualquer valor | | **Dedicação** | 6-8 horas/dia | 1-2 horas/dia | 30 min - 1 hora/dia | 1-2 horas/semana | | **IR (alíquota)** | 20% | 15% | 15% | 15% | | **Isenção R$ 20k** | ❌ Não | ✅ Sim | ✅ Sim | ✅ Sim | | **Risco** | Muito Alto | Alto | Médio | Baixo-Médio | | **Retorno potencial** | Alto (+ ou -) | Médio-Alto | Médio | Médio (consistente) | | **Taxa de sucesso** | \~10% dos traders | \~20-30% dos traders | \~40% dos traders | \~70-80% dos investidores | *** ## Day Trade: Operações no Mesmo Dia ### O Que É Day Trade? Day trade é a compra e venda de ativos **no mesmo dia**, buscando lucrar com pequenas variações de preço. A posição é sempre zerada antes do fechamento do mercado. ### Características do Day Trade | Aspecto | Detalhe | | -------------------- | --------------------------------------- | | **Horário** | 10h às 17h (pregão da bolsa) | | **Ativos comuns** | Mini-índice, mini-dólar, ações líquidas | | **Alavancagem** | Até 100x em alguns casos | | **Objetivo diário** | 1-3% do capital operacional | | **Stop loss típico** | 0.5-2% por operação | ### Exemplo de Operação Day Trade ```typescript const response = await fetch( 'https://brapi.dev/api/quote/PETR4?interval=1d&range=1d', { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const { regularMarketPrice, regularMarketOpen, regularMarketDayHigh, regularMarketDayLow, regularMarketVolume, regularMarketChangePercent } = results[0]; ``` **Simulação de resultado mensal (Day Trade):** | Cenário | Capital | Operações | Taxa Acerto | Ganho Médio | Perda Média | Resultado Bruto | IR (20%) | Resultado Líquido | | -------------------------------- | --------- | --------- | ----------- | ----------- | ----------- | --------------- | -------- | ----------------- | | **Otimista** (trader experiente) | R$ 50.000 | 40 | 55% | 1,5% | 0,8% | R$ 5.100 | R$ 1.020 | R$ 4.080 (+8,2%) | | **Realista** (trader médio) | R$ 50.000 | 40 | 45% | 1,2% | 1,0% | -R$ 200 | R$ 0 | -R$ 200 (-0,4%) | > A maioria dos day traders tem resultado negativo. Apenas \~10% conseguem lucro consistente após custos e impostos. ### Prós e Contras do Day Trade | Prós | Contras | | --------------------------- | ----------------------------- | | Sem risco overnight | IR de 20% (sem isenção) | | Potencial de ganhos diários | Custos operacionais altos | | Alavancagem disponível | Estresse e pressão constantes | | Liquidez imediata | Requer dedicação integral | | Mercado em qualquer direção | \~90% dos traders perdem | ### Tributação do Day Trade **Regras de IR para Day Trade:** | Aspecto | Detalhe | | --------------------- | ----------------------------------------------- | | Alíquota | 20% sobre lucro líquido | | Isenção R$ 20k | ❌ NÃO há isenção | | Compensação prejuízos | ✅ Sim (apenas com day trade) | | IR retido na fonte | 1% ("dedo-duro") | | Pagamento | DARF mensal até último dia útil do mês seguinte | **Exemplo de cálculo:** | Item | Valor | | ---------------------- | ---------- | | Lucro do mês | R$ 5.000 | | (-) Prejuízo acumulado | R$ 1.000 | | (=) Base de cálculo | R$ 4.000 | | **IR devido (20%)** | **R$ 800** | *** ## Swing Trade: Operações de Dias a Semanas ### O Que É Swing Trade? Swing trade busca capturar **movimentos de curto a médio prazo**, mantendo posições por dias ou semanas. O objetivo é aproveitar "swings" (oscilações) do mercado. ### Características do Swing Trade | Aspecto | Detalhe | | -------------------- | --------------------------- | | **Duração** | 2 dias a 4 semanas | | **Análise** | Gráficos diários e semanais | | **Ativos comuns** | Ações, ETFs, opções | | **Objetivo** | 5-20% por operação | | **Stop loss típico** | 3-8% | ### Exemplo de Operação Swing Trade ```typescript const response = await fetch( 'https://brapi.dev/api/quote/PETR4?interval=1d&range=1mo', { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const historico = results[0].historicalDataPrice; // Calcular médias móveis para identificar tendência const fechamentos = historico.slice(-20).map(h => h.close); const mm9 = fechamentos.slice(-9).reduce((a, b) => a + b, 0) / 9; const mm21 = fechamentos.reduce((a, b) => a + b, 0) / fechamentos.length; ``` **Identificação de tendência:** | Condição | Tendência | Setup | | --------------------------- | --------- | --------------------------- | | MM9 > MM21 e Preço > MM9 | ALTA | Aguardar pullback para MM9 | | MM9 \< MM21 e Preço \< MM9 | BAIXA | Aguardar repique para venda | | Médias cruzadas ou laterais | LATERAL | Aguardar definição | **Simulação de resultado mensal (Swing Trade):** | Métrica | Cenário Realista | | --------------------- | ---------------------- | | Capital | R$ 50.000 | | Operações/mês | 8 | | Taxa de acerto | 50% | | Ganho médio | 8% | | Perda média | 4% (risco/retorno 2:1) | | **Resultado bruto** | **R$ 8.000** | | IR (15%) | R$ 1.200 | | **Resultado líquido** | **R$ 6.800 (+13,6%)** | ### Prós e Contras do Swing Trade | Prós | Contras | | ----------------------- | --------------------------- | | Menos tempo de tela | Risco overnight e de gap | | IR de 15% (com isenção) | Requer paciência | | Menos estresse | Menos oportunidades | | Compatível com emprego | Capital parado entre trades | | Custos menores | Mercado pode virar contra | ### Setups Clássicos de Swing Trade **Principais setups de Swing Trade:** | Setup | Descrição | Indicadores | Entrada | Stop | Alvo | R/R | | ------------------------- | -------------------------------- | ------------------------ | ------------------------------- | ----------------------------- | --------------------- | ----------- | | **Pullback na Tendência** | Comprar na correção de alta | MMs, Fibo, Suportes | Próximo a MM21 ou suporte | Abaixo do último fundo | Topo anterior | 1:2 a 1:3 | | **Rompimento** | Comprar no rompimento com volume | Volume, Resistência, IFR | Fechamento acima da resistência | Abaixo da resistência rompida | Projeção da congestão | 1:2 | | **Reversão com Candle** | Candles de reversão em S/R | Candlesticks, Volume | Confirmação do candle | Sombra do candle | Próxima S/R | 1:2 a 1:3 | | **Inside Bar** | Candle contido no anterior | Candlesticks, Tendência | Rompimento do inside bar | Lado oposto | Tamanho do candle mãe | 1:1.5 a 1:2 | *** ## Position Trade: Operações de Semanas a Meses ### O Que É Position Trade? Position trade é uma estratégia que mantém posições por **semanas a meses**, buscando capturar movimentos maiores do mercado. Combina análise técnica com fundamentos. ### Características do Position Trade | Aspecto | Detalhe | | -------------------- | --------------------------------------- | | **Duração** | 1 semana a 6 meses | | **Análise** | Gráficos semanais/mensais + fundamentos | | **Ativos comuns** | Ações, ETFs, FIIs | | **Objetivo** | 20-100% por operação | | **Stop loss típico** | 10-20% | ### Exemplo de Position Trade ```typescript const response = await fetch( 'https://brapi.dev/api/quote/PETR4?modules=defaultKeyStatistics,summaryProfile&interval=1wk&range=6mo', { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const { regularMarketPrice, historicalDataPrice } = results[0]; const stats = results[0].defaultKeyStatistics ?? {}; const { trailingPE, priceToBook, dividendYield } = stats; // Calcular MM12 semanas para tendência de longo prazo const fechamentos = historicalDataPrice.slice(-12).map(h => h.close); const mm12sem = fechamentos.reduce((a, b) => a + b, 0) / 12; const tendencia = fechamentos[fechamentos.length - 1] > mm12sem ? 'ALTA' : 'BAIXA'; ``` **Análise para Position Trade:** | Tipo de Análise | Métricas | | ------------------- | -------------------------------------- | | **Fundamentalista** | P/L, P/VP, Dividend Yield, ROE | | **Técnico** | MM12 semanas, tendência de longo prazo | **Simulação de resultado anual (Position Trade):** | Métrica | Cenário | | --------------------- | ---------------------- | | Capital | R$ 100.000 | | Operações/ano | 12 (\~1/mês) | | Taxa de acerto | 55% | | Ganho médio | 25% | | Perda média | 12% | | **Resultado bruto** | **R$ 101.000** | | IR (15%) | R$ 15.150 | | **Resultado líquido** | **R$ 85.850 (+85,9%)** | > O position trade exige paciência, mas permite capturar movimentos maiores com menos operações e custos. ### Prós e Contras do Position Trade | Prós | Contras | | --------------------------------- | ---------------------------- | | Menos tempo de análise | Capital parado por meses | | Movimentos maiores | Drawdowns podem ser grandes | | Menos custos operacionais | Paciência extrema necessária | | Menos ruído de mercado | Menos oportunidades | | Combina técnico + fundamentalista | Risco de mudança de cenário | *** ## Comparativo Detalhado: Tributação A tributação é um fator crucial na escolha da estratégia: **Comparativo de tributação (cenário: R$ 3.000 de lucro):** | Tipo de Operação | Vendas Mensais | Alíquota | Isento? | IR Devido | Lucro Líquido | | ------------------------------------ | -------------- | -------- | ------- | --------- | ------------- | | **Day Trade** | R$ 50.000 | 20% | ❌ Não | R$ 600 | R$ 2.400 | | **Swing Trade** (vendas > R$20k) | R$ 50.000 | 15% | ❌ Não | R$ 450 | R$ 2.550 | | **Swing Trade** (vendas \< R$20k) | R$ 15.000 | 15% | ✅ Sim | R$ 0 | R$ 3.000 | | **Position Trade** (vendas \< R$20k) | R$ 18.000 | 15% | ✅ Sim | R$ 0 | R$ 3.000 | > A isenção de R$ 20.000 em vendas mensais é uma grande vantagem de swing e position trade sobre day trade. ### Tabela: Resumo Tributário | Tipo | Alíquota | Isenção R$ 20k | Compensação Prejuízos | DARF | | -------------- | -------- | -------------- | --------------------- | ------ | | Day Trade | 20% | NÃO | Só com day trade | Mensal | | Swing Trade | 15% | SIM | Só com comum | Mensal | | Position Trade | 15% | SIM | Só com comum | Mensal | | FIIs | 20% | NÃO | Só com FIIs | Mensal | > **Importante**: Prejuízos de day trade NÃO compensam lucros de operações comuns (swing/position) e vice-versa. *** ## Qual Estratégia É Melhor para Você? Responda as perguntas abaixo: ### Quiz: Descubra Seu Perfil **Perguntas para descobrir seu perfil:** | Pergunta | Opção A | Opção B | Opção C | | ------------------------ | ------------------- | ----------------------- | --------------------- | | **Tempo disponível/dia** | 6+ horas (integral) | 1-2 horas | Menos de 1 hora | | **Capital inicial** | \< R$ 10.000 | R$ 10.000 - R$ 50.000 | > R$ 50.000 | | **Como lida com perdas** | Muito ansioso | Incomodado mas controla | Parte do jogo | | **Outra fonte de renda** | Emprego fixo | Freelancer | Quer viver de trading | | **Objetivo** | Renda mensal | Aumentar patrimônio | Acelerar crescimento | **Resultado por resposta:** | Se você respondeu majoritariamente... | Estratégia ideal | | ------------------------------------- | ---------------------------- | | Opção A | Position Trade ou Buy & Hold | | Opção B | Swing Trade | | Opção C | Day Trade (com cautela) | ### Resumo por Perfil | Perfil | Estratégia Recomendada | | --------------------------------------------- | --------------------------------- | | Empregado, pouco tempo, conservador | **Position Trade** ou Buy & Hold | | Empregado, 1-2h/dia, tolerância média | **Swing Trade** | | Tempo integral, tolerância alta, capital alto | **Day Trade** | | Iniciante sem experiência | **Buy & Hold** → Position → Swing | *** ## Estatísticas: Quem Ganha Dinheiro? Os números são claros sobre a dificuldade de cada estratégia: ### Day Trade **Estatísticas sobre Day Traders no Brasil (Fonte: FGV, 2012-2017):** | Métrica | Resultado | | ------------------------------------ | ------------------------- | | Amostra estudada | 19.646 pessoas físicas | | Desistiram no 1º dia | 50% | | Desistiram em 300 pregões | 91% | | Lucro médio dos persistentes | **Prejuízo de R$ 36/dia** | | Lucro do top 1% | R$ 300/dia | | **Percentual com lucro consistente** | **1,1%** | > Esses números mostram a dificuldade real do day trade. A maioria perde dinheiro, e apenas cerca de 1% consegue lucro consistente no longo prazo. ### Comparativo de Sucesso | Estratégia | Taxa de Sucesso | Perfil do Vencedor | | -------------- | --------------- | -------------------------------------- | | Day Trade | \~1-10% | Disciplinado, capitalizado, experiente | | Swing Trade | \~20-30% | Paciente, analítico, disciplinado | | Position Trade | \~40% | Paciente, fundamentalista, longo prazo | | Buy & Hold | \~70-80% | Disciplinado, visão de longo prazo | *** ## Ferramentas para Cada Estratégia ### Day Trade * **Plataformas**: Profit Pro, Tryd, ProfitChart * **Dados**: Tape reading, book de ofertas, times & trades * **API**: brapi.dev para backtesting e análise ### Swing Trade * **Plataformas**: TradingView, Profit, MetaTrader * **Dados**: Candlesticks diários, indicadores * **API**: brapi.dev para screeners e alertas ### Position Trade * **Plataformas**: TradingView, Status Invest * **Dados**: Gráficos semanais + fundamentalista * **API**: brapi.dev para dados fundamentalistas ```typescript const tickers = ['PETR4', 'VALE3', 'ITUB4', 'WEGE3']; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(',')}?modules=defaultKeyStatistics`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); // Dados úteis para trading results.forEach(ativo => { console.log({ ticker: ativo.symbol, preco: ativo.regularMarketPrice, variacaoDia: ativo.regularMarketChangePercent, volume: ativo.regularMarketVolume, maxima52sem: ativo.fiftyTwoWeekHigh, minima52sem: ativo.fiftyTwoWeekLow }); }); ``` *** ## Plano de Evolução: Do Iniciante ao Trader ### Fase 1: Fundação (Meses 1-6) 1. **Estude teoria** (análise técnica e fundamentalista) 2. **Pratique em simulador** (pelo menos 100 operações) 3. **Comece com Buy & Hold** (aprenda a ter ações) 4. **Construa reserva de emergência** ### Fase 2: Primeiras Operações (Meses 7-12) 1. **Inicie com Position Trade** (menor frequência) 2. **Capital pequeno** (máximo 10% do patrimônio) 3. **Diário de trades** (registre tudo) 4. **Foque em poucos ativos** (3-5 ações) ### Fase 3: Evolução (Ano 2) 1. **Migre para Swing Trade** (se tiver tempo) 2. **Aumente capital gradualmente** 3. **Refine seu sistema** 4. **Especialize-se em setups específicos** ### Fase 4: Day Trade (Ano 3+) 1. **Apenas se tiver resultados consistentes em swing** 2. **Capital dedicado e separado** 3. **Período de treino intensivo (3-6 meses simulado)** 4. **Comece com tamanho mínimo** *** ## Checklist: Antes de Começar ### Day Trade * [ ] Capital de pelo menos R$ 20.000 separado * [ ] Setup profissional (computador, internet, monitores) * [ ] Conta em corretora com boas taxas * [ ] Plataforma com dados em tempo real * [ ] 6+ meses de despesas em reserva * [ ] Sistema de trading testado * [ ] Regras de risco claras (máx. 2% por operação) * [ ] Tempo integral disponível ### Swing Trade * [ ] Capital de pelo menos R$ 10.000 * [ ] Conta em corretora * [ ] Acesso a gráficos diários * [ ] 1-2 horas por dia para análise * [ ] Sistema com setups definidos * [ ] Regras de stop e alvo * [ ] Diário de operações ### Position Trade * [ ] Capital para investir (qualquer valor) * [ ] Conhecimento básico de análise * [ ] Visão de médio prazo * [ ] Paciência para esperar * [ ] Critérios de entrada e saída * [ ] Acompanhamento semanal *** ## Conclusão: Qual Escolher? | Se você... | Escolha... | | --------------------------------- | ----------------------------- | | Tem emprego e pouco tempo | Position Trade ou Buy & Hold | | Tem 1-2h/dia e paciência | Swing Trade | | Quer tempo integral e tem capital | Day Trade (com muita cautela) | | É iniciante | Buy & Hold → Position → Swing | | Quer consistência | Position Trade + Buy & Hold | | Quer adrenalina | Reconheça que isso é viés | > **Conselho Final**: A maioria dos traders de sucesso combina estratégias. Uma carteira de longo prazo (Buy & Hold) + operações de swing pode ser mais rentável e segura que day trade puro. *** ## Recursos Adicionais ### Artigos Relacionados * [Como Declarar Investimentos no IR 2026](/blog/como-declarar-investimentos-imposto-renda-2026) * [Melhores Ações Pagadoras de Dividendos](/blog/melhores-acoes-pagadoras-dividendos-2026) * [Como Investir com Pouco Dinheiro](/blog/como-investir-com-pouco-dinheiro-2026) ### API brapi.dev Para suas análises de trading, use a [API brapi.dev](https://brapi.dev): ```typescript // Dados em tempo real const quote = await fetch('https://brapi.dev/api/quote/PETR4', { headers: { Authorization: `Bearer ${token}` } }); // Histórico para backtesting const historico = await fetch( 'https://brapi.dev/api/quote/PETR4?interval=1d&range=1y', { headers: { Authorization: `Bearer ${token}` } } ); // Múltiplos ativos const carteira = await fetch( 'https://brapi.dev/api/quote/PETR4,VALE3,ITUB4', { headers: { Authorization: `Bearer ${token}` } } ); ``` *** *Última atualização: Janeiro 2026* **Aviso Legal**: Este conteúdo é educacional e não constitui recomendação de investimento. Trading envolve riscos significativos de perda. Resultados passados não garantem resultados futuros. Consulte um profissional antes de operar. # DeFi para Iniciantes 2026: Guia Completo de Finanças Descentralizadas no Brasil URL: /blog/defi-financas-descentralizadas-guia-iniciantes-2026.mdx Aprenda o que é DeFi, como funciona yield farming, staking e liquidity pools. Guia completo de finanças descentralizadas para brasileiros em 2026. *** searchable: true title: 'DeFi para Iniciantes 2026: Guia Completo de Finanças Descentralizadas no Brasil' description: 'Aprenda o que é DeFi, como funciona yield farming, staking e liquidity pools. Guia completo de finanças descentralizadas para brasileiros em 2026.' date: '2026-01-02' keywords: 'DeFi brasil, finanças descentralizadas, yield farming, staking criptomoedas, liquidity pool, Aave, Uniswap, como ganhar com DeFi' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Criptomoedas' readingTime: '24 min' tags: \['DeFi', 'Criptomoedas', 'Yield Farming', 'Staking', 'Uniswap', 'Aave', 'Finanças Descentralizadas'] relatedPosts: \['ethereum-eth-guia-completo-brasil-2026', 'altcoins-promissoras-analise-2026', 'stablecoins-brasil-usdt-brz-drex-guia-2026', 'como-declarar-criptomoedas-imposto-renda-2026'] featured: true expertise: 'Guia elaborado por especialistas em DeFi com experiência prática em protocolos e análise de riscos' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; **DeFi** (Decentralized Finance ou Finanças Descentralizadas) está revolucionando o sistema financeiro ao permitir empréstimos, trocas e investimentos sem intermediários como bancos. Em 2026, o ecossistema DeFi administra mais de **$100 bilhões em TVL** (Total Value Locked) e oferece oportunidades únicas para investidores brasileiros. Neste guia completo, você vai aprender: * O que é DeFi e como funciona * Principais conceitos: yield farming, staking, liquidity pools * Melhores protocolos para começar * Riscos e como se proteger * Passo a passo para sua primeira operação DeFi *** ## O que é DeFi? **DeFi** são serviços financeiros construídos em blockchains públicas (principalmente Ethereum) que funcionam sem intermediários tradicionais. Ao invés de um banco aprovar seu empréstimo, **smart contracts** (contratos inteligentes) executam as operações automaticamente. ### DeFi vs Finanças Tradicionais | Aspecto | Finanças Tradicionais | DeFi | | ------------- | ------------------------------- | -------------------------------- | | Intermediário | Bancos, corretoras | Smart contracts | | Horário | Horário comercial | 24/7/365 | | Acesso | Requer conta, documentos | Apenas carteira crypto | | Transparência | Caixa-preta | Código aberto, auditável | | Custódia | Instituição guarda seu dinheiro | Você controla suas chaves | | Rentabilidade | Poupança: 6-7% a.a. | Pools: 5-50%+ a.a. (maior risco) | ### Ecossistema DeFi | Camada | Componentes | Exemplos | | ---------------------- | -------------------------------- | ---------------------------------------- | | **Base (Blockchains)** | Redes que hospedam os protocolos | Ethereum, Solana, Arbitrum, Polygon, BSC | | **DEXs** | Exchanges descentralizadas | Uniswap, Curve, SushiSwap | | **Lending** | Empréstimos sem intermediários | Aave, Compound, MakerDAO | | **Staking** | Validação e rendimentos | Lido, Rocket Pool | | **Agregadores** | Otimizam rotas e rendimentos | 1inch, Yearn Finance, DefiLlama | | **Stablecoins** | Base de liquidez | USDT, USDC, DAI, FRAX | *** ## Principais Conceitos DeFi ### 1. Staking: Bloqueie e Ganhe **Staking** é o processo de bloquear suas criptomoedas para ajudar a validar transações na rede, recebendo recompensas em troca. | Tipo | Descrição | Exemplo | APY Típico | | -------------------- | ---------------------------- | ------------ | ---------- | | **Staking Nativo** | Validar blockchain PoS | ETH staking | 3-5% | | **Liquid Staking** | Stake e recebe token líquido | Lido (stETH) | 3-4% | | **Protocol Staking** | Stake em protocolo DeFi | AAVE staking | 5-10% | #### Liquid Staking: O Melhor dos Dois Mundos Com **liquid staking**, você faz stake de ETH e recebe um token derivativo (como **stETH** do Lido) que pode ser usado em outros protocolos DeFi: **Como Funciona o Lido:** 1. **Você deposita** 1 ETH no Lido 2. **Recebe** 1 stETH (token líquido) 3. **stETH pode ser usado** como colateral em Aave, Compound, etc. 4. **Enquanto isso** seu ETH gera \~3.5% APY via validação | Vantagem | Descrição | | ------------------- | -------------------------------------------- | | **Liquidez** | Use stETH enquanto ganha staking rewards | | **Composabilidade** | Combine com outros protocolos DeFi | | **Sem mínimo** | Stake qualquer quantidade (vs 32 ETH nativo) | | **Sem lock-up** | Pode trocar stETH por ETH a qualquer momento | ### 2. Liquidity Pools: Seja o Banco **Liquidity Pools** são reservas de tokens que permitem trocas descentralizadas. Ao depositar tokens em um pool, você se torna um **Liquidity Provider (LP)** e ganha taxas das transações. #### Como Funciona um AMM (Automated Market Maker) Os pools usam a fórmula **x × y = k** (Constant Product): | Conceito | Explicação | | --------------- | ------------------------------------------------------ | | **Reservas** | Cada pool tem dois tokens (ex: 100 ETH + 300.000 USDC) | | **Constante k** | O produto das reservas se mantém constante | | **Preço** | Determinado pela proporção entre tokens | | **Taxa** | LPs ganham 0.3% por trade (Uniswap V2) | **Exemplo de Swap:** Suponha um pool com 100 ETH e 300.000 USDC (preço: 1 ETH = 3.000 USDC). Ao trocar 5 ETH por USDC: * Taxa: 0.015 ETH (0.3%) * Recebido: \~14.265 USDC * Novo preço: 1 ETH = 2.857 USDC * Slippage: \~4.8% Quanto maior o trade em relação ao pool, maior o slippage. Pools com mais liquidez têm menor slippage. #### Impermanent Loss por Variação de Preço | Variação do Token | Impermanent Loss | | ----------------------- | ---------------- | | -50% (caiu pela metade) | -5.72% | | -25% | -1.03% | | 0% (sem variação) | 0% | | +25% | -0.62% | | +50% | -2.02% | | +100% (dobrou) | -5.72% | | +200% (triplicou) | -13.40% | | +300% | -20.00% | | +400% | -25.46% | Impermanent Loss é "impermanent" porque se os preços voltarem à proporção original, a perda desaparece. Porém, se você retirar a liquidez com preços diferentes, a perda se torna permanente. ### 3. Yield Farming: Maximizando Rendimentos **Yield Farming** é a prática de mover ativos entre protocolos DeFi para maximizar rendimentos. Farmers combinam diferentes estratégias: #### Exemplo de Estratégia de Yield Farming | Etapa | Ação | Rendimento | | ------------------- | ------------------------------ | ----------------------- | | 1. Depósito inicial | Depositar ETH no Lido | +3.5% APY (stETH) | | 2. Colateral | Depositar stETH no Aave | +1-2% APY extra | | 3. Empréstimo | Emprestar USDC do Aave | -3% APR (custo) | | 4. Liquidity Mining | Adicionar USDC a pool no Curve | +5-15% APY + tokens CRV | **Rendimento composto estimado:** 10-20% APY **Riscos envolvidos:** Smart contract bugs, liquidação se colateral cair, impermanent loss nos pools. Esta estratégia é para usuários avançados. ### 4. Lending/Borrowing: Empréstimos Descentralizados Protocolos como **Aave** e **Compound** permitem emprestar e tomar emprestado sem intermediários: | Ação | Como Funciona | Taxa Típica | | ----------------------------- | ------------------------------------------ | ----------- | | **Depositar (Supply)** | Empresta seus tokens, ganha juros | 1-10% APY | | **Tomar emprestado (Borrow)** | Usa tokens como colateral, pega empréstimo | 2-15% APR | #### Exemplo: Empréstimo com Colateral **Cenário:** Depositar $10.000 em ETH como colateral no Aave | Parâmetro | Valor | | ----------------------- | ---------------------- | | Colateral depositado | $10.000 | | LTV máximo | 75% | | Empréstimo máximo | $7.500 | | Empréstimo recomendado | $5.250 (70% do máximo) | | Threshold de liquidação | 80% | Se o valor do seu colateral cair \~20%, você será **LIQUIDADO** e perderá parte do colateral. Sempre mantenha margem de segurança. *** ## Principais Protocolos DeFi ### 1. Uniswap (DEX) **Uniswap** é a maior exchange descentralizada, pioneira do modelo AMM: | Versão | Inovação | Chain Principal | | ------ | -------------------- | --------------------------- | | V2 | AMM Constant Product | Ethereum | | V3 | Liquidez concentrada | Ethereum, Polygon, Arbitrum | | V4 | Hooks customizáveis | Em desenvolvimento | ### 2. Aave (Lending) **Aave** é o maior protocolo de empréstimos descentralizados: | Recurso | Descrição | | ------------- | ------------------------------------------- | | Flash Loans | Empréstimo sem colateral (mesmo bloco) | | GHO | Stablecoin nativa do Aave | | Safety Module | Staking de AAVE para segurança | | Multi-chain | Ethereum, Polygon, Arbitrum, Optimism, etc. | ### 3. Lido (Liquid Staking) **Lido** domina o mercado de liquid staking de Ethereum: | Métrica | Valor (Jan 2026) | | -------------- | --------------------- | | TVL | \~$15 bilhões | | ETH em staking | \~9 milhões ETH | | Market share | \~30% do ETH stakeado | | APY | \~3.5% | ### 4. Curve Finance (Stablecoins) **Curve** é especializado em swaps de stablecoins com baixo slippage: * Pools de stablecoins (USDC/USDT/DAI) * Token CRV para governança * veCRV para boost de recompensas ### 5. Pendle Finance (Yield Trading) **Pendle** permite separar e negociar o rendimento futuro de ativos: #### Como Funciona o Pendle Quando você deposita um ativo gerador de yield (como stETH), o Pendle divide em dois tokens: | Token | Nome | Descrição | | ------ | --------------- | -------------------------------------------------------- | | **PT** | Principal Token | Recebe o principal no vencimento (comprado com desconto) | | **YT** | Yield Token | Recebe todos os yields até a maturidade | **Estratégias:** | Estratégia | Ação | Para quem | | ------------------ | ----------------- | -------------------------- | | **Renda Fixa** | Comprar PT | Quer travar APY garantido | | **Aposta em alta** | Comprar YT | Acredita que APY vai subir | | **Arbitragem** | Comparar PT vs YT | Traders experientes | O Pendle é como um mercado de futuros para rendimentos. Permite travar taxas fixas em ativos de yield variável. *** ## Redes (Chains) para DeFi ### Comparativo de Redes | Chain | Taxa Média | Tempo Bloco | TVL | Melhor Para | | ------------ | ---------- | ----------- | ----- | ------------------ | | **Ethereum** | $1-50 | 12s | $50B+ | Segurança máxima | | **Arbitrum** | $0.10-1 | 0.25s | $3B+ | DeFi econômico | | **Polygon** | $0.01-0.10 | 2s | $1B+ | Iniciantes | | **Solana** | $0.00025 | 0.4s | $2B+ | Velocidade | | **BSC** | $0.10-0.50 | 3s | $4B+ | DEX PancakeSwap | | **Base** | $0.01-0.20 | 2s | $2B+ | Coinbase ecosystem | ### Bridges: Movendo Entre Chains Para mover ativos entre redes, use bridges: | Bridge | Chains Suportadas | Segurança | | --------------------- | --------------------------------- | -------------------- | | **Stargate** | ETH, Arbitrum, Polygon, BSC, etc. | Alta (LayerZero) | | **Across** | ETH, Arbitrum, Optimism, Polygon | Alta | | **Portal (Wormhole)** | ETH, Solana, BSC, etc. | Média | | **Arbitrum Bridge** | ETH ↔ Arbitrum | Muito alta (oficial) | *** ## Riscos em DeFi ### Tipos de Risco | Risco | Descrição | Nível | Mitigação | | ----------------------- | ------------------------------------------------- | ---------- | -------------------------------------------------- | | **Smart Contract Risk** | Bugs ou vulnerabilidades no código do protocolo | Alto | Use apenas protocolos auditados e estabelecidos | | **Impermanent Loss** | Perda ao fornecer liquidez quando preços divergem | Médio | Use pools de stablecoins ou ativos correlacionados | | **Liquidation Risk** | Perda de colateral se posição for liquidada | Alto | Mantenha LTV baixo (máx 50%) e monitore posições | | **Rug Pull** | Desenvolvedores roubam fundos dos usuários | Muito Alto | Evite projetos novos sem auditoria ou time anônimo | | **Oracle Manipulation** | Manipulação de preços em oráculos | Médio | Use protocolos com oráculos Chainlink | | **Regulatory Risk** | Mudanças regulatórias que afetam acesso | Médio | Diversifique entre jurisdições e protocolos | Nunca invista em DeFi mais do que você pode perder completamente. Mesmo protocolos estabelecidos podem sofrer exploits. ### Impermanent Loss Explicado **Impermanent Loss (IL)** ocorre quando você fornece liquidez e os preços dos tokens divergem: #### Tabela de Impermanent Loss | Variação do Preço | IL (%) | Resultado vs HODL | | ----------------------- | ------- | -------------------------- | | Token A caiu 50% | -5.72% | LP perde 4.29% vs segurar | | Token A caiu 25% | -1.03% | LP perde 0.89% vs segurar | | Sem variação | 0% | Igual (+ taxas ganhas) | | Token A subiu 25% | -0.62% | LP perde 0.56% vs segurar | | Token A subiu 50% | -2.02% | LP perde 1.96% vs segurar | | Token A subiu 100% (2x) | -5.72% | LP perde 5.72% vs segurar | | Token A subiu 200% (3x) | -13.40% | LP perde 15.47% vs segurar | | Token A subiu 300% (4x) | -20.00% | LP perde 25.00% vs segurar | | Token A subiu 400% (5x) | -25.46% | LP perde 33.33% vs segurar | A fórmula de IL é: **IL = 2×√r / (1+r) - 1**, onde r = nova razão de preços / razão original. Se os preços voltarem à proporção original, a perda desaparece. **Quando vale a pena fornecer liquidez?** * Quando as **taxas acumuladas** superam o IL esperado * Em **pools de stablecoins** (pouca divergência de preço) * Em **pares correlacionados** (ETH/stETH, WBTC/renBTC) *** ## Passo a Passo: Primeira Operação DeFi ### Pré-requisitos 1. **Carteira Web3**: MetaMask, Rabby, ou similar 2. **ETH ou tokens**: Para pagar gas e fazer operações 3. **Conhecimento básico**: Como assinar transações ### Tutorial: Fornecer Liquidez no Uniswap V3 #### Passo 1: Preparação * [ ] Conecte sua carteira em [app.uniswap.org](https://app.uniswap.org) * [ ] Tenha ETH e outro token (ex: USDC) na proporção desejada * [ ] Reserve ETH extra para gas (\~$10-50) #### Passo 2: Selecionar Pool * [ ] Vá em "Pools" → "New Position" * [ ] Selecione o par (ex: ETH/USDC) * [ ] Escolha a fee tier: | Fee Tier | Melhor para | | -------- | --------------------------------- | | 0.01% | Stablecoins (USDC/USDT) | | 0.05% | Pares correlacionados (ETH/stETH) | | 0.30% | Pares padrão - mais comum | | 1.00% | Pares exóticos/voláteis | #### Passo 3: Definir Range de Preço * [ ] Escolha min/max price (liquidez concentrada) * [ ] Range menor = mais fees, mais IL * [ ] Range maior = menos fees, menos IL * [ ] "Full Range" = comportamento v2 (menos eficiente) #### Passo 4: Depositar * [ ] Insira quantidade de tokens * [ ] Aprove os tokens (se primeira vez) * [ ] Confirme a transação "Add Liquidity" * [ ] Aguarde confirmação na blockchain #### Passo 5: Monitorar * [ ] Acompanhe sua posição em "Pools" * [ ] Verifique se preço está dentro do range * [ ] Colete fees periodicamente No Uniswap V3, você só ganha taxas quando o preço está dentro do seu range. Se sair, sua posição fica 100% em um dos tokens até voltar. ### Tutorial: Staking de ETH no Lido #### Passo 1: Acessar o Lido * [ ] Acesse [stake.lido.fi](https://stake.lido.fi) * [ ] Conecte sua carteira (MetaMask, WalletConnect, etc.) * [ ] Verifique se está na rede Ethereum Mainnet #### Passo 2: Fazer Stake * [ ] Digite a quantidade de ETH para stake * [ ] Clique em "Submit" * [ ] Confirme a transação na carteira * [ ] Pague o gas (geralmente $5-30) #### Passo 3: Receber stETH * [ ] Receba stETH 1:1 na sua carteira * [ ] stETH gera \~3.5% APY automaticamente * [ ] Saldo de stETH aumenta diariamente (rebase) #### Passo 4: Usar stETH (opcional) * [ ] Usar como colateral no Aave * [ ] Fornecer liquidez em Curve (stETH/ETH) * [ ] Simplesmente segurar e acumular rendimentos #### Passo 5: Sacar (unstake) | Opção | Tempo | Observação | | ----------------------- | ----------- | -------------------------------- | | Request withdrawal | Alguns dias | Sem slippage, mais seguro | | Swap stETH → ETH em DEX | Instantâneo | Pode ter pequeno desconto/prêmio | **Dicas:** Não há mínimo para stake no Lido. Espere gas baixo (\<30 gwei) para economizar. Confira APY atual em [lido.fi/ethereum](https://lido.fi/ethereum). *** ## Calculadora de Rendimentos DeFi ### Comparativo de Estratégias **Capital inicial:** $10.000 | **Período:** 1 ano | Estratégia | APY | Gas Mensal | Lucro Líquido | Capital Final | | ----------------------- | ----- | ---------- | ------------- | ------------- | | Staking ETH (Lido) | 3.5% | $5 | $290 | $10.290 | | Pool stETH/ETH (Curve) | 5.0% | $10 | $393 | $10.393 | | USDC Supply (Aave) | 4.0% | $5 | $348 | $10.348 | | ETH/USDC LP (Uniswap) | 15.0% | $20 | $1.378 | $11.378 | | Yield Farming Agressivo | 30.0% | $50 | $2.898 | $12.898 | **Importante:** APYs são variáveis e podem mudar significativamente. Estratégias com maior rendimento têm maior risco. O "Yield Farming Agressivo" inclui riscos de smart contract, liquidação e impermanent loss. ### Fórmula de Juros Compostos Para calcular rendimentos com composição: **A = P × (1 + r/n)^(n×t)** Onde: * **A** = Capital final * **P** = Capital inicial * **r** = APY (ex: 0.10 = 10%) * **n** = Períodos de composição por ano (365 para diário) * **t** = Tempo em anos *** ## Ferramentas Úteis para DeFi ### Dashboards e Analytics | Ferramenta | Função | Link | | ------------------ | ----------------------------- | ------------- | | **DefiLlama** | TVL e analytics de protocolos | defillama.com | | **Zapper** | Dashboard de portfólio DeFi | zapper.fi | | **DeBank** | Rastrear posições multi-chain | debank.com | | **Dune Analytics** | Dados on-chain customizáveis | dune.com | ### Segurança | Ferramenta | Função | | ----------------------------- | ---------------------------------- | | **Revoke.cash** | Revogar aprovações de tokens | | **DeFi Safety** | Ratings de segurança de protocolos | | **Etherscan Token Approvals** | Verificar aprovações | ### Agregadores | Ferramenta | Função | | ------------ | --------------------------- | | **1inch** | Melhor preço em swaps | | **Paraswap** | Agregador de DEXs | | **Li.Fi** | Agregador de bridges + DEXs | *** ## Tributação de DeFi no Brasil Rendimentos de DeFi são tributáveis no Brasil. Consulte nosso [guia de declaração de criptomoedas](/blog/como-declarar-criptomoedas-imposto-renda-2026) para detalhes. ### Resumo Tributário | Operação | Tratamento Fiscal | | --------------- | ----------------------------------------- | | Staking rewards | Rendimento (IR na fonte) | | LP fees | Rendimento (IR na fonte) | | Venda de tokens | Ganho de capital (isencao R$ 35k por mes) | | Yield farming | Complexo - consulte contador | | Airdrops | Rendimento (custo zero) | *** ## Perguntas Frequentes (FAQ) ### 1. Preciso de muito dinheiro para começar em DeFi? Não, mas considere o custo de gas. Na Ethereum mainnet, taxas podem ser altas por transação. Para valores pequenos (menor que $1.000), use Layer 2s como Arbitrum ou Polygon onde gas custa centavos. ### 2. DeFi é seguro? Depende. Protocolos estabelecidos (Aave, Uniswap, Lido) têm histórico sólido, mas riscos existem. Nunca invista mais do que pode perder e diversifique entre protocolos. ### 3. Qual a diferença entre APY e APR? * **APR** (Annual Percentage Rate): Taxa simples anual * **APY** (Annual Percentage Yield): Taxa com juros compostos Um APR de 10% com composição diária equivale a APY de \~10.5%. ### 4. O que é TVL? **Total Value Locked** é o valor total de ativos depositados em um protocolo DeFi. Maior TVL geralmente indica maior confiança e liquidez. ### 5. Como escolher um protocolo seguro? Verifique: * [ ] Auditorias de segurança (Trail of Bits, OpenZeppelin) * [ ] TVL > $100 milhões * [ ] Tempo de operação > 1 ano * [ ] Bug bounty program ativo * [ ] Time conhecido e não anônimo ### 6. Posso perder todo meu dinheiro? Sim, é possível em cenários como: * Exploit/hack do protocolo * Rug pull em projetos novos * Liquidação em empréstimos * Impermanent loss extremo ### 7. Vale a pena DeFi com a Selic alta no Brasil? Depende do seu perfil. DeFi oferece potencial de retornos maiores, mas com risco significativamente maior. Uma alocação de 5-20% do portfólio em DeFi pode fazer sentido para perfis arrojados. *** ## Conclusão DeFi representa uma revolução nas finanças, oferecendo: * **Acessibilidade**: Qualquer pessoa com internet pode participar * **Transparência**: Código aberto e auditável * **Rentabilidade**: Potencial de retornos superiores ao mercado tradicional * **Inovação**: Novos produtos financeiros impossíveis no sistema tradicional **Recomendações para iniciantes:** 1. Comece com valores pequenos para aprender 2. Use Layer 2s para economizar em gas 3. Foque em protocolos estabelecidos (Aave, Uniswap, Lido) 4. Diversifique entre diferentes estratégias 5. Nunca invista mais do que pode perder 6. Acompanhe suas posições regularmente Use a API da brapi.dev para monitorar cotações de tokens e ETFs DeFi (como QDFI11) e tome decisões informadas. *** *Disclaimer: Este conteúdo é educacional e não constitui recomendação de investimento. DeFi envolve riscos significativos incluindo perda total do capital. Faça sua própria pesquisa e consulte profissionais antes de investir.* # Demonstrativos Financeiros 2025: Como Analisar Saúde de Empresas URL: /blog/demonstrativos-financeiros-um-olhar-detalhado-na-saude-financeira-da-empresa.mdx Domine análise de demonstrativos financeiros! DRE, Balanço Patrimonial, Fluxo de Caixa e indicadores para avaliar saúde financeira real na bolsa brasileira ✓ *** searchable: true title: 'Demonstrativos Financeiros 2025: Como Analisar Saúde de Empresas' description: 'Domine análise de demonstrativos financeiros! DRE, Balanço Patrimonial, Fluxo de Caixa e indicadores para avaliar saúde financeira real na bolsa brasileira ✓' date: '2025-08-22' keywords: 'demonstrativos financeiros, DRE, balanço patrimonial, fluxo caixa, saúde financeira empresas, análise financeira, bolsa brasileira, demonstrações contábeis, brapi' author: 'Equipe brapi.dev' category: 'Análise Financeira' subcategory: 'Demonstrações Contábeis' readingTime: '21 min' tags: \['Demonstrativos Financeiros', 'DRE', 'Balanço', 'Análise Financeira', 'Bolsa Brasileira', 'Fluxo Caixa', 'Contabilidade'] relatedPosts: \['analise-financeira-com-modulo-balance-sheet-history', 'balanco-patrimonial-acoes', 'guia-completo-indicadores-fundamentalistas-bovespa'] featured: true expertise: 'Análise de demonstrativos financeiros com 8+ anos de experiência' lastReviewed: '2025-08-22' howToSteps: * name: 'Conhecer os três demonstrativos principais' text: 'Estude o Balanço Patrimonial (posição financeira), a DRE (resultado do exercício) e a DFC (fluxo de caixa) - os pilares da análise financeira.' * name: 'Aplicar análise horizontal' text: 'Compare informações de diferentes períodos para identificar tendências de crescimento, estabilidade ou declínio na empresa.' * name: 'Realizar análise vertical' text: 'Compare diferentes partes de uma mesma demonstração para entender proporções, como custos em relação à receita.' * name: 'Calcular ratios financeiros' text: 'Use ratios como dívida/patrimônio, liquidez corrente e ROE para avaliar saúde financeira de forma objetiva.' * name: 'Considerar fatores qualitativos' text: 'Analise qualidade da gestão, reputação da marca e cenário competitivo que afetam o desempenho mas não aparecem nos números.' * name: 'Identificar vieses comportamentais' text: 'Esteja ciente de seus próprios vieses ao interpretar demonstrativos, evitando conclusões precipitadas ou enviesadas.' * name: 'Integrar análise para decisão' text: 'Combine análise quantitativa e qualitativa para formar uma visão completa da saúde financeira antes de investir.' howToTools: * 'API brapi.dev para dados financeiros' * 'Planilha de cálculo' * 'Calculadora financeira' * 'Relatórios da CVM' howToSupplies: * 'Balanço Patrimonial da empresa' * 'DRE (Demonstração do Resultado)' * 'DFC (Fluxo de Caixa)' * 'Dados de períodos anteriores para comparação' *** import { Authors, Author } from '~/components/Authors'; > Descubra o significado e a importância dos demonstrativos financeiros. Saiba > como eles são usados para analisar a saúde financeira de uma empresa e > auxiliar na tomada de decisões de investimento. ## O que são Demonstrativos Financeiros? Os demonstrativos financeiros são uma fotografia da situação financeira de uma empresa. Eles são uma representação histórica e não necessariamente refletem o desempenho futuro. São divididos em três categorias principais: o **balanço patrimonial**, a **demonstração do resultado do exercício** e a **demonstração do fluxo de caixa**. Eles indicam quanto dinheiro a empresa tem, de onde veio e para onde foi. Importante lembrar que, embora valiosos, eles podem ter limitações, como a possibilidade de não capturar todos os aspectos da saúde financeira de uma empresa devido às restrições das normas contábeis geralmente aceitas (GAAP). ## Quem utiliza Demonstrativos Financeiros? As demonstrações financeiras são utilizadas por pessoas tanto dentro quanto fora da empresa. Aqueles que estão dentro, como gerentes e chefes, os usam para decidir como administrar o negócio. Aqueles de fora, como investidores e credores, os usam para descobrir a saúde financeira da empresa e se devem investir nela. ## Como utilizar Demonstrativos Financeiros? Existem três maneiras principais de usar demonstrações financeiras * **Análise horizontal**: Isso significa comparar informações de diferentes períodos para ver se há alguma tendência. Por exemplo, você pode comparar quanto dinheiro a empresa ganhou este ano com o quanto ganhou no ano passado para ver se está crescendo. * **Análise vertical**: Isso significa comparar diferentes partes de uma única demonstração para ver como elas se relacionam entre si. Por exemplo, você pode comparar quanto a empresa gasta na fabricação de produtos com quanto dinheiro ela ganha vendendo-os para ver quanto dinheiro fica na empresa depois de pagar esses custos. * **Análise de ratios**: Os ratios são números especiais que lhe dizem algo sobre a saúde financeira da empresa. Por exemplo, você pode calcular um ratio entre a dívida e o patrimônio líquido da empresa para ver quanta dívida ela tem em comparação com seu próprio dinheiro. ### Fatores Qualitativos Além da análise quantitativa, fatores qualitativos como qualidade da gestão, reputação da marca e cenário competitivo devem ser considerados, pois podem afetar significativamente o desempenho financeiro da empresa. ### Viés Comportamental em Finanças Os investidores devem estar cientes de seus próprios vieses e heurísticas, pois podem influenciar a interpretação dos demonstrativos financeiros. O entendimento e a consciência desses vieses podem ajudar a evitar armadilhas e a tomar decisões mais informadas. ## Quais são os diferentes tipos de demonstrações financeiras? * **Balanço patrimonial**: Este demonstra o que a empresa possui (ativos), o que deve (passivos) e quanto dinheiro sobra (patrimônio líquido) em um determinado momento. Ativos são coisas como dinheiro, estoque e edifícios. Passivos são coisas como empréstimos e contas a pagar. O patrimônio líquido é o dinheiro que sobraria se a empresa vendesse tudo o que possui e pagasse todas as suas dívidas. * **Demonstração do resultado do exercício**: Este demonstra quanto dinheiro a empresa ganhou (receita), quanto gastou (despesas) e se obteve lucro ou prejuízo (lucro líquido) durante um determinado período. A receita vem da venda de produtos ou serviços. Despesas são os custos de administrar o negócio. O lucro líquido é o dinheiro que sobra depois que todas as despesas são pagas. * **Demonstração do fluxo de caixa**: Este demonstra de onde veio o dinheiro da empresa (entradas de caixa) e para onde ele foi (saídas de caixa) durante um determinado período. As entradas de caixa vêm de coisas como vendas e empréstimos. As saídas de caixa vão para coisas como pagar contas e comprar suprimentos. ## Por que os demonstrativos financeiros são úteis? Os demonstrativos financeiros são extremamente úteis para entender a saúde financeira de uma empresa, identificar riscos e oportunidades potenciais e tomar melhores decisões de investimento. * Ajudam a entender como uma empresa é saudável financeiramente. * Ajudam a ver potenciais riscos e oportunidades. * Ajudam a tomar melhores decisões de investimento. ## Exemplos de uso de demonstrações financeiras A teoria se torna mais clara quando aplicada na prática. Por isso, é útil estudar exemplos reais e casos de estudo de empresas que utilizaram a análise de demonstrativos financeiros para tomar decisões de investimento bem-sucedidas. * Um investidor pode comparar demonstrações financeiras de diferentes empresas antes de decidir em qual investir. * Um banco pode usar demonstrações financeiras para decidir se empresta ou não dinheiro a uma empresa. * Um gerente de empresa pode usar demonstrações financeiras para acompanhar o progresso da empresa e tomar decisões sobre como melhorar seu desempenho. ## Onde encontrar dados de demonstrativos financeiros? Os dados de demonstrativos financeiros podem ser encontrados em vários lugares, como sites de empresas, sites de bolsas de valores e sites de agências de notícias financeiras. Caso você precise de dados mais detalhados e específicos, você pode acessar esse dados por API de dados financeiros, como a [brapi](https://brapi.dev). A brapi é uma API de dados financeiros que fornece dados de demonstrativos financeiros de empresas brasileiras. [Ler documentação da API da brapi](https://brapi.dev/docs/acoes#modules-opcional) ## Conclusão Os demonstrativos financeiros são uma ferramenta poderosa que pode ajudá-lo a entender a saúde financeira de uma empresa e a tomar melhores decisões sobre seu dinheiro. Ao aprender os princípios básicos dos demonstrativos financeiros, você pode abrir a porta para informações valiosas sobre o mundo financeiro. # Dívida Líquida/EBITDA: Fugindo de Empresas Quebradas em 2026 URL: /blog/divida-liquida-ebitda-alavancagem-analise-2026.mdx Entenda o indicador de alavancagem mais importante da bolsa. Por que Dívida Líquida/EBITDA alto é perigoso em 2026? *** searchable: true title: 'Dívida Líquida/EBITDA: Fugindo de Empresas Quebradas em 2026' description: 'Entenda o indicador de alavancagem mais importante da bolsa. Por que Dívida Líquida/EBITDA alto é perigoso em 2026?' date: '2025-12-30' keywords: 'divida liquida ebitda, alavancagem financeira, analise de risco ações, empresas endividadas 2026, ebitda significado' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Análise Fundamentalista' readingTime: '11 min' tags: \['Alavancagem', 'Risco', 'Dívida', 'EBITDA', 'Indicadores'] relatedPosts: \['valuation-dcf-multiplos-guia-completo-2026', 'roic-roe-analise-fundamentalista-2026', 'guia-ebit-e-ebitda'] featured: false expertise: 'Análise de risco de crédito e solvência para investidores de ações.' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; Em tempos de "dinheiro fácil" (juros baixos), qualquer empresa consegue rolar suas dívidas. Mas em 2026, com o custo do crédito ainda desafiador, a alavancagem financeira é o que separa as sobreviventes das recuperações judiciais. O indicador rei para medir esse risco é a relação **Dívida Líquida / EBITDA**. Vamos entender o que ele diz sobre a saúde de uma empresa. *** ## O Conceito 1. **Dívida Líquida:** Tudo o que a empresa deve aos bancos (Dívida Bruta) MENOS o dinheiro que ela tem no caixa agora. **Dívida Líquida = Dívida Bruta - Caixa Disponível** 2. **EBITDA:** A geração de caixa operacional aproximada (Lucro antes de Juros, Impostos, Depreciação e Amortização). É o dinheiro que entra "da operação". ### A Fórmula **Alavancagem = Dívida Líquida / EBITDA (12 meses)** **Tradução:** Quantos anos de geração de caixa operacional a empresa precisaria para pagar toda a sua dívida líquida? *** ## As Faixas de Risco em 2026 * **Até 1,5x (Conservador):** Situação muito confortável. Exemplos: **WEG**, **Lojas Renner**. A empresa tem fôlego para investir ou pagar dividendos. * **Entre 1,5x e 2,5x (Normal):** Padrão de mercado para empresas saudáveis. * **Entre 2,5x e 3,5x (Alerta Amarelo):** Começa a ficar perigoso. Se o EBITDA cair (crise) ou os juros subirem, o lucro líquido some (comido pelas despesas financeiras). Típico de empresas de infraestrutura (**Eletrobras**, **CCR**) que aguentam mais dívida por terem receita previsível. * **Acima de 3,5x (Zona de Perigo):** Alto risco. Investir aqui é especular em *turnaround* (virada). Qualquer soluço na economia pode levar à renegociação de dívidas ou falência. Ex: **Casas Bahia**, **Oi** (no passado). *** ## O "Efeito Tesoura" dos Juros Imagine uma empresa com Dívida/EBITDA de 4x. Se a Selic está em 10%, ela paga muito juros. Se a receita cai, o EBITDA diminui. A relação Dívida/EBITDA explode para 6x, 7x... Os bancos cortam o crédito ou aumentam os juros (risco maior). A empresa entra em espiral da morte. É por isso que monitorar esse indicador trimestralmente é vital. *** ## Monitorando Alavancagem com Python Use a brapi para filtrar empresas perigosas da sua carteira. ```typescript const response = await fetch( 'https://brapi.dev/api/quote/WEGE3?modules=defaultKeyStatistics,financialData', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const { results } = await response.json() const { totalDebt = 0, totalCash = 0, ebitda } = results[0].financialData ?? {} const netDebtToEbitda = ebitda ? (totalDebt - totalCash) / ebitda : null ``` ### Interpretação da Alavancagem | Dív. Líq./EBITDA | Interpretação | | ---------------- | --------------------------------------- | | \< 0x | Caixa Líquido: mais dinheiro que dívida | | 0x - 2x | Saudável | | 2x - 3x | Atenção | | > 3x | CUIDADO: Alavancagem alta! | *** ## Conclusão Em 2026, **Cash is King** (Caixa é Rei). Empresas com caixa líquido (alavancagem negativa) não só dormem tranquilas como podem comprar concorrentes quebrados a preço de banana. Antes de comprar uma ação "barata" (P/L baixo), olhe a dívida. O barato pode sair caro se a empresa quebrar. *** ## Leia Mais * **[Valuation: O Barato que sai Caro](/blog/valuation-dcf-multiplos-guia-completo-2026)** * **[Fluxo de Caixa vs Lucro](/blog/fluxo-de-caixa-livre-vs-lucro-contabil-2026)** # Dividend Yield 2025: Como Construir Carteira de Renda Passiva na Bolsa Brasileira URL: /blog/dividend-yield-dy-como-calcular-usar-analise-acoes-dividendos.mdx Domine o Dividend Yield (DY) para renda passiva! Aprenda a calcular, analisar e investir em ações pagadoras de dividendos. Guia completo com API e estratégias ✓ *** searchable: true title: 'Dividend Yield 2025: Como Construir Carteira de Renda Passiva na Bolsa Brasileira' description: 'Domine o Dividend Yield (DY) para renda passiva! Aprenda a calcular, analisar e investir em ações pagadoras de dividendos. Guia completo com API e estratégias ✓' date: '2025-08-22' keywords: 'dividend yield, DY, dividendos, renda passiva, ações pagadoras dividendos, análise fundamentalista, bolsa brasileira, investimento dividendos, yield, brapi' author: 'Equipe brapi.dev' category: 'Dividendos e Renda Passiva' subcategory: 'Estratégias de Renda' readingTime: '18 min' tags: \['Dividend Yield', 'Dividendos', 'Renda Passiva', 'Bolsa Brasileira', 'Investimentos', 'Income Investing', 'Pagadoras', 'Yield'] relatedPosts: \['entendendo-indicador-preco-lucro-pl-analise-fundamentalista', 'fundos-imobiliarios-fiis-guia-completo-iniciantes', 'metodo-bazin-estrategia-renda-passiva-acoes-dividendos'] featured: true expertise: 'Estratégias de renda passiva com 8+ anos de experiência no mercado brasileiro' lastReviewed: '2025-08-22' howToTools: \['API brapi.dev', 'Histórico de dividendos', 'Planilha de análise'] howToSteps: * name: 'Obtenha os dividendos pagos nos últimos 12 meses' text: 'Use a API brapi.dev com o módulo dividends para ver o histórico de proventos.' * name: 'Calcule o Dividend Yield' text: 'Divida o total de dividendos por ação pelo preço atual da ação e multiplique por 100.' * name: 'Compare com a média do setor' text: 'Analise se o DY está acima ou abaixo da média de empresas similares.' * name: 'Verifique a sustentabilidade' text: 'Confirme se o payout ratio está saudável (idealmente entre 30% e 70%).' * name: 'Monte sua carteira de dividendos' text: 'Diversifique entre setores e escolha empresas com histórico consistente de pagamentos.' *** import { Authors, Author } from '~/components/Authors'; > O Dividend Yield (DY) é o indicador essencial para investidores que buscam renda passiva através de dividendos. Aprenda como calcular, analisar e selecionar as melhores ações pagadoras para construir uma carteira sólida na bolsa brasileira em 2025. *** ## O que é Dividend Yield e Por Que é Fundamental para Renda Passiva? **O Dividend Yield (DY) mostra o percentual de retorno em dividendos que você recebe anualmente em relação ao preço da ação.** É o indicador mais direto para avaliar a atratividade de uma ação para geração de renda passiva. **Em termos práticos:** Um DY de 8% significa que você recebe R$ 8,00 em dividendos para cada R$ 100 investidos na ação durante o ano. ### Por Que o DY é Crucial para Income Investors? 1. **Mede retorno imediato** em dinheiro 2. **Compara** diferentes ações pagadoras 3. **Base** para estratégias de renda passiva 4. **Indica** sustentabilidade dos pagamentos 5. **Ferramenta** para timing de compra e venda ### Fórmula do Dividend Yield ``` DY = (Dividendos por Ação nos últimos 12 meses ÷ Preço atual da Ação) × 100 ``` **Exemplo prático:** * Ação cotada a R$ 50 * Dividendos pagos nos últimos 12 meses: R$ 3 por ação * DY = (3 ÷ 50) × 100 = 6% ## Por que o Dividend Yield é Importante? ### 1. Indicador de Renda Passiva O DY mostra diretamente qual será o retorno anual em dividendos, permitindo comparar diferentes investimentos focados em renda. ### 2. Disciplina de Gestão Empresas que pagam dividendos consistentes geralmente têm gestão disciplinada e fluxo de caixa estável. ### 3. Proteção contra Inflação Dividendos crescentes podem oferecer proteção contra a inflação ao longo do tempo. ## Como Interpretar o Dividend Yield ### DY Alto (acima de 8%) **Vantagens:** * Maior retorno imediato em dividendos * Potencial para boa renda passiva **Atenção:** * Pode indicar empresa em dificuldades * Dividendo pode não ser sustentável * Preço da ação pode estar em queda ### DY Moderado (4% a 8%) **Características:** * Equilibrio entre renda e crescimento * Empresas maduras e estáveis * Sustentabilidade mais provável ### DY Baixo (abaixo de 4%) **Possíveis cenários:** * Empresa em fase de crescimento * Reinvestimento de lucros * Valorização da ação superior aos dividendos ## Acessando Dados de DY com a API brapi.dev A [API da brapi.dev](/docs/acoes) fornece dados atualizados de Dividend Yield para todas as ações brasileiras: ### Consultando DY via API ```bash curl "https://brapi.dev/api/quote/ITUB4?modules=defaultKeyStatistics" ``` **Resposta com dados de DY:** ```json { "results": [{ "symbol": "ITUB4", "shortName": "ITAUUNIBANCO PN", "regularMarketPrice": 25.50, "defaultKeyStatistics": { "dividendYield": 0.0542 } }] } ``` Neste exemplo, o DY é de 5,42%, indicando que a cada R$ 100 investidos, o retorno anual em dividendos seria de aproximadamente R$ 5,42. ## Setores com Melhores Dividend Yields no Brasil ### Bancos * **DY médio:** 5% a 12% * **Exemplos:** ITUB4, BBDC4, BBAS3 * **Características:** Dividendos obrigatórios, lucros recorrentes ### Utilidades (Energia e Saneamento) * **DY médio:** 4% a 8% * **Exemplos:** EGIE3, SBSP3, CPLE6 * **Características:** Fluxo de caixa previsível, concessões ### Seguradoras * **DY médio:** 3% a 7% * **Exemplos:** BBSE3, SULA11, IRBR3 * **Características:** Modelo de negócio estável ## Análise de Sustentabilidade dos Dividendos ### Payout Ratio ``` Payout = Dividendos ÷ Lucro Líquido ``` **Interpretação:** * **0% a 40%:** Conservador, espaço para crescimento * **40% a 70%:** Equilibrado, sustentável * **Acima de 70%:** Pode comprometer reinvestimentos ### Indicadores Complementares #### 1. Crescimento dos Dividendos Analise o histórico de crescimento dos dividendos ao longo dos anos: ```bash # Consulta histórica via brapi.dev curl "https://brapi.dev/api/quote/VIVT3?range=5y&interval=1mo÷nds=true" ``` #### 2. Fluxo de Caixa Livre Verifique se a empresa gera caixa suficiente para sustentar os dividendos: ``` Cobertura = Fluxo de Caixa Livre ÷ Dividendos Pagos ``` ## Estratégias com Base no Dividend Yield ### 1. Estratégia Bazin Criada por Décio Bazin, busca ações com: * DY ≥ 6% * Crescimento constante dos dividendos * Baixo endividamento ### 2. Dividend Growth Investing Foca em empresas que: * Crescem dividendos consistentemente * Têm payout sustentável * Operam em setores defensivos ### 3. High Yield Strategy Seleciona ações com: * DY elevado (acima de 8%) * Análise rigorosa de sustentabilidade * Diversificação setorial ## Armadilhas do Dividend Yield ### 1. Yield Trap **O que é:** DY alto devido à queda do preço da ação por problemas fundamentais. **Como evitar:** * Analise o payout ratio * Verifique a saúde financeira * Observe tendências do setor ### 2. Dividendos Insustentáveis **Sinais de alerta:** * Payout ratio muito alto * Endividamento crescente * Queda nas margens operacionais ### 3. Foco Apenas no DY Não considere apenas o DY. Avalie também: * Qualidade da empresa * Crescimento do negócio * Ambiente competitivo ## Construindo uma Carteira de Dividendos ### Diversificação Setorial Distribua investimentos entre diferentes setores: * 30% Bancos * 25% Utilities * 20% Consumo * 15% Seguradoras * 10% Outros setores ### Critérios de Seleção 1. **DY mínimo:** 4% 2. **Payout máximo:** 70% 3. **Histórico:** Pelo menos 5 anos pagando dividendos 4. **Crescimento:** Dividendos crescentes ou estáveis ## Ferramentas para Análise de DY ### Screening com brapi.dev Use nossa [plataforma de cotações](/quotes) para: * Filtrar ações por DY * Comparar dividendos históricos * Analisar tendências setoriais ### Acompanhamento Regular Monitore trimestralmente: * Relatórios de resultados * Anúncios de dividendos * Mudanças na política de distribuição ## Aspectos Tributários dos Dividendos ### Isenção de IR No Brasil, dividendos são isentos de imposto de renda para pessoa física. ### Juros sobre Capital Próprio (JCP) * Tributação de 15% na fonte * Pode ser abatido no imposto de renda * Considerado dedutível para a empresa ## Exemplo Prático: Análise Completa ### Empresa Hipotética: XPTO4 * **Preço atual:** R$ 40 * **Dividendos TTM:** R$ 2,40 * **DY:** 6% * **Payout:** 45% * **Crescimento médio dividendos (5 anos):** 8% **Análise:** ✅ DY atrativo de 6% ✅ Payout sustentável de 45% ✅ Histórico de crescimento dos dividendos ✅ Empresa com fundamentos sólidos ## Monitoramento e Alertas ### Indicadores de Acompanhamento 1. **Crescimento trimestral dos dividendos** 2. **Mudanças no payout ratio** 3. **Anúncios de política de dividendos** 4. **Variações significativas no DY** ### Quando Reavaliar * DY cair abaixo de 3% * Payout superar 80% * Corte ou suspensão de dividendos * Deterioração dos fundamentos ## Conclusão O Dividend Yield é uma ferramenta poderosa para investidores focados em renda passiva, mas deve ser usado com cuidado e sempre em conjunto com outros indicadores fundamentalistas. ### Pontos-Chave: 1. **DY isolado pode enganar** - sempre analise a sustentabilidade 2. **Diversificação é essencial** - não concentre em poucos ativos 3. **Acompanhamento regular** - dividendos podem mudar 4. **Qualidade primeiro** - prefira empresas sólidas ### Próximos Passos * Explore nossa [documentação completa](/docs) sobre dados de dividendos * Use nossa [API](/docs/acoes) para construir seu próprio screening * Acesse dados históricos na [plataforma brapi.dev](/quotes) **Lembre-se:** dividendos são uma consequência de bons negócios. Invista primeiro na qualidade da empresa, e os dividendos virão naturalmente. # Dividendos 2026: Como Construir Renda Passiva com Ações que Pagam Proventos URL: /blog/dividendos-como-construir-renda-passiva.mdx Guia de dividendos ✓ Construa renda passiva com ações. Melhores pagadoras, Dividend Yield, data ex e reinvestimento. *** searchable: true title: 'Dividendos 2026: Como Construir Renda Passiva com Ações que Pagam Proventos' description: 'Guia de dividendos ✓ Construa renda passiva com ações. Melhores pagadoras, Dividend Yield, data ex e reinvestimento.' date: '2026-01-01' keywords: 'dividendos 2026, renda passiva, ações que pagam dividendos, dividend yield, viver de dividendos, melhores pagadoras de dividendos, data ex dividendos, JCP, proventos' author: 'Equipe brapi.dev' category: 'Estratégias' subcategory: 'Renda Passiva' readingTime: '20 min' tags: \['Dividendos', 'Renda Passiva', 'Dividend Yield', 'Proventos', 'JCP', 'Investimentos', 'FIRE'] relatedPosts: \['buy-and-hold-estrategia-investimento-longo-prazo', 'value-investing-como-encontrar-acoes-baratas', 'metodo-bazin-estrategia-renda-passiva-acoes-dividendos', 'dividend-yield-dy-como-calcular-usar-analise-acoes-dividendos', 'acoes-growth-vs-value-brasil'] featured: true expertise: 'Especialistas em estratégias de renda passiva e investimentos focados em dividendos.' lastReviewed: 2026-01-03 ------------------------ import { Callout } from 'fumadocs-ui/components/callout'; ## O que são Dividendos e Por Que São Importantes **Dividendos** são a parcela do lucro de uma empresa distribuída aos seus acionistas. Quando você compra ações de uma empresa lucrativa, você se torna sócio e tem direito a receber parte desses lucros. No Brasil, as empresas são **obrigadas por lei** a distribuir no mínimo 25% do lucro líquido aos acionistas (salvo exceções no estatuto). Isso torna o mercado brasileiro um dos mais generosos em dividendos do mundo. ### Tipos de Proventos no Brasil | Tipo | O que é | Tributação | | ------------------------------------- | --------------------------------- | ----------------------------- | | **Dividendos** | Lucro distribuído após IR | **Isento** para pessoa física | | **JCP** (Juros sobre Capital Próprio) | Forma alternativa de distribuição | **15% IR** retido na fonte | | **Bonificação** | Novas ações gratuitas | Isento (ajusta preço médio) | | **Direitos de Subscrição** | Direito de comprar novas ações | Isento (se exercido) | ### Por que Dividendos são Poderosos? **Cenário:** R$ 100.000 investidos | DY: 6% | 20 anos | Estratégia | Patrimônio Final | Renda Anual (Ano 20) | | ------------------ | ---------------- | -------------------- | | Sem reinvestir | R$ 220.000 | R$ 6.000 | | Com reinvestimento | R$ 320.000+ | R$ 19.200 | Diferença: **R$ 100.000+ a mais** só por reinvestir os dividendos! Os juros compostos transformam dividendos em uma máquina de gerar riqueza. *** ## Como Funcionam os Dividendos ### O Processo de Pagamento ``` 1. Empresa apura lucro ↓ 2. Conselho aprova distribuição ↓ 3. Divulga: Data Com, Data Ex, Data de Pagamento ↓ 4. Quem tiver ações na Data Com recebe ↓ 5. Na Data Ex, ação abre descontada ↓ 6. Pagamento na data anunciada ``` ### Datas Importantes | Data | Significado | | --------------------- | ------------------------------------- | | **Data Com** | Último dia para comprar e ter direito | | **Data Ex** | Primeiro dia SEM direito ao dividendo | | **Data de Pagamento** | Quando o dinheiro cai na conta | **Importante:** Na Data Ex, a ação abre com desconto equivalente ao dividendo. Não existe "almoço grátis". ### Exemplo Prático **Exemplo: Ação XYZ anuncia dividendo** | Informação | Valor | | ------------------------ | ---------------- | | Preço antes do dividendo | R$ 50,00 | | Dividendo anunciado | R$ 2,50 por ação | | Dividend Yield | 5,0% | **Cronograma:** * **15/01 - Data Com:** último dia para comprar * **16/01 - Data Ex:** ação abre a R$ 47,50 (desconto do dividendo) * **30/01 - Pagamento:** R$ 2,50 por ação na conta **Se você tem 100 ações:** | Momento | Ações | Valor em Ações | Dividendos | Total | | ------- | ----- | -------------- | ---------- | ----------- | | Antes | 100 | R$ 5.000,00 | - | R$ 5.000,00 | | Depois | 100 | R$ 4.750,00 | R$ 250,00 | R$ 5.000,00 | O valor total não muda - apenas passa de "ação" para "dinheiro na conta". Não existe almoço grátis. *** ## Principais Indicadores de Dividendos ### Dividend Yield (DY) O indicador mais importante para investidores de renda: ```typescript const response = await fetch( "https://brapi.dev/api/quote/TAEE11?modules=defaultKeyStatistics,financialData÷nds=true", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); const acao = data.results[0]; // Dados de dividendos console.log({ preco: acao.regularMarketPrice, dividendYield: acao.defaultKeyStatistics?.dividendYield, dividendoAnual: acao.regularMarketPrice * (acao.defaultKeyStatistics?.dividendYield ?? 0), }); ``` **Cálculo prático:** Para receber R$ 1.000/mês com uma ação que paga 8% de DY: * Dividendo mensal por ação: `Preço × 8% ÷ 12` * Ações necessárias: `1.000 ÷ (dividendo mensal)` * Investimento: `ações × preço` ### Payout Ratio Quanto do lucro é distribuído: **Fórmula:** `Payout = (Dividendo por Ação ÷ Lucro por Ação) × 100` | Payout | Interpretação | Risco | | ------- | ---------------------------------------------------- | ---------- | | \< 50% | Conservador - empresa retém lucros para crescer | Baixo | | 50-80% | Moderado - equilíbrio entre dividendos e crescimento | Médio | | 80-100% | Alto - pouco reinvestimento na empresa | Alto | | > 100% | Insustentável - pagando mais do que lucra | Muito Alto | Payout acima de 100% é sinal de alerta! A empresa está usando reservas ou dívida para pagar dividendos - isso não é sustentável no longo prazo. ### Tabela de Referência | Indicador | Bom | Regular | Ruim | | --------------------- | ---------- | ---------- | ----------- | | **Dividend Yield** | > 6% | 3-6% | \< 3% | | **Payout** | 40-70% | 70-90% | > 100% | | **Anos consecutivos** | > 10 | 5-10 | \< 5 | | **Crescimento DPA** | > inflação | = inflação | \< inflação | *** ## As Melhores Pagadoras de Dividendos do Brasil ### Top Dividend Yield ```typescript // Buscar ranking de ações por Dividend Yield const response = await fetch( "https://brapi.dev/api/quote/list?type=stock&sortBy=dividendYield&sortOrder=desc&limit=20", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); // Filtrar DY entre 3% e 20% (evita armadilhas) const acoes = data.stocks.filter( (s) => s.dividendYield > 0.03 && s.dividendYield < 0.20 ); ``` Filtre ações com DY entre 3% e 20%. Valores muito altos podem indicar problemas na empresa ou dividendos extraordinários não recorrentes. ### Aristocratas de Dividendos do Brasil Empresas com histórico consistente de pagamentos: | Ação | Empresa | Setor | Anos Pagando | DY Médio | | ------ | --------------- | ----------- | ------------ | -------- | | TAEE11 | Taesa | Transmissão | 15+ | 8-12% | | BBSE3 | BB Seguridade | Seguros | 10+ | 7-10% | | CPLE6 | Copel | Energia | 20+ | 6-9% | | BBAS3 | Banco do Brasil | Bancos | 30+ | 8-10% | | EGIE3 | Engie | Energia | 10+ | 5-8% | | ITUB4 | Itaú | Bancos | 30+ | 4-6% | | BBDC4 | Bradesco | Bancos | 30+ | 4-6% | | VIVT3 | Telefônica | Telecom | 20+ | 5-7% | | CMIG4 | Cemig | Energia | 20+ | 5-8% | | TRPL4 | Isa Cteep | Transmissão | 15+ | 6-9% | ### Setores com Melhores Dividendos | Setor | Por que paga bem | Risco | | -------------------------- | ------------------------------ | ----- | | **Transmissão de Energia** | Receita garantida por contrato | Baixo | | **Bancos** | Lucros consistentes | Médio | | **Seguros** | Float e investimentos | Baixo | | **Saneamento** | Monopólio natural | Baixo | | **Telecom** | Caixa previsível | Médio | | **Energia Elétrica** | Demanda estável | Baixo | *** ## Calculadora de Renda Passiva **Meta:** R$ 5.000/mês | **DY médio:** 7% | **Aporte:** R$ 2.000/mês | **Período:** 20 anos ### Patrimônio Necessário | Meta Mensal | Patrimônio (DY 6%) | Patrimônio (DY 7%) | Patrimônio (DY 8%) | | ----------- | ------------------ | ------------------ | ------------------ | | R$ 3.000 | R$ 600.000 | R$ 514.000 | R$ 450.000 | | R$ 5.000 | R$ 1.000.000 | R$ 857.000 | R$ 750.000 | | R$ 10.000 | R$ 2.000.000 | R$ 1.714.000 | R$ 1.500.000 | ### Simulação de Acumulação | Item | Valor | | ---------------------------------------- | ------------- | | Aporte mensal | R$ 2.000 | | Período | 20 anos | | Total aportado | R$ 480.000 | | Patrimônio acumulado (DY 7% reinvestido) | R$ 1.100.000+ | | Renda mensal alcançada | R$ 6.400+ | Com aportes mensais de R$ 2.000 e reinvestimento dos dividendos, em 20 anos você pode alcançar uma renda passiva superior à meta de R$ 5.000/mês! *** ## Estratégias de Investimento em Dividendos ### 1. Carteira de Renda (Foco em DY Alto) **Meta:** DY médio > 7% | Setor | Ação | Peso | | --------------------- | ------ | ---- | | **Transmissão (35%)** | TAEE11 | 15% | | | TRPL4 | 10% | | | CPLE6 | 10% | | **Bancos (25%)** | BBAS3 | 15% | | | ITUB4 | 10% | | **Seguros (15%)** | BBSE3 | 15% | | **Energia (15%)** | EGIE3 | 10% | | | CMIG4 | 5% | | **Telecom (10%)** | VIVT3 | 10% | ### 2. Carteira Crescimento de Dividendos Foco em empresas que aumentam dividendos todo ano: | Ação | Característica | Peso | | ------ | ---------------------------- | ---- | | WEGE3 | Cresce dividendo 10%+ a.a. | 15% | | ITUB4 | Dividendo crescente | 15% | | BBSE3 | Payout alto, lucro crescente | 15% | | EGIE3 | Energia limpa + dividendos | 15% | | TAEE11 | Transmissão estável | 15% | | VALE3 | Dividendos cíclicos altos | 10% | | VIVT3 | Telecom + dividendos | 15% | ### 3. Estratégia Barbell Combinar ações de alto DY com growth: | Categoria | Ação | Peso | | ----------------- | ------ | ---- | | **Alto DY (60%)** | TAEE11 | 20% | | | BBAS3 | 20% | | | BBSE3 | 20% | | **Growth (40%)** | WEGE3 | 15% | | | PRIO3 | 15% | | | TOTS3 | 10% | A estratégia Barbell equilibra a renda imediata de ações com alto DY com o potencial de valorização das ações growth. *** ## Acompanhando Dividendos com brapi.dev ### Histórico de Dividendos ```typescript // Buscar histórico de dividendos dos últimos 5 anos const response = await fetch( "https://brapi.dev/api/quote/TAEE11?dividends=true&range=5y", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); const dividendos = data.results[0].dividendsData?.cashDividends || []; // Calcular total recebido const total5Anos = dividendos.reduce((acc, div) => acc + div.value, 0); console.log(`Total últimos 5 anos: R$ ${total5Anos.toFixed(2)} por ação`); ``` ### Calendário de Dividendos ```typescript // Verificar dividendos de múltiplas ações const carteira = ["TAEE11", "BBAS3", "ITUB4", "EGIE3", "BBSE3"]; const symbols = carteira.join(","); const response = await fetch( `https://brapi.dev/api/quote/${symbols}?dividends=true`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); // Extrair último dividendo de cada ação data.results.forEach((acao) => { const ultimoDiv = acao.dividendsData?.cashDividends?.at(-1); if (ultimoDiv) { console.log({ acao: acao.symbol, dataEx: ultimoDiv.exDividendDate, pagamento: ultimoDiv.paymentDate, valor: ultimoDiv.value, }); } }); ``` ### Dashboard de Renda ```typescript // Dashboard da carteira de dividendos const carteira = { TAEE11: 500, BBAS3: 300, ITUB4: 400, EGIE3: 200, BBSE3: 250 }; const symbols = Object.keys(carteira).join(","); const response = await fetch( `https://brapi.dev/api/quote/${symbols}?modules=defaultKeyStatistics,financialData÷nds=true`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); let totalInvestido = 0; let rendaAnual = 0; data.results.forEach((acao) => { const qtd = carteira[acao.symbol]; const valor = qtd * acao.regularMarketPrice; const renda = valor * (acao.defaultKeyStatistics?.dividendYield || 0); totalInvestido += valor; rendaAnual += renda; }); console.log({ totalInvestido, rendaAnual, rendaMensal: rendaAnual / 12, dyMedio: (rendaAnual / totalInvestido) * 100, }); ``` **Exemplo de resultado:** | Métrica | Valor | | --------------- | ---------- | | Total Investido | R$ 150.000 | | Renda Anual | R$ 10.500 | | Renda Mensal | R$ 875 | | DY Médio | 7,0% | *** ## Armadilhas de Dividendos ### Dividend Yield Alto Demais **DY acima de 15%? Investigue antes de comprar!** Possíveis motivos para DY muito alto: * Dividendo extraordinário (não recorrente) * Ação caiu muito (problema na empresa) * Payout insustentável * Empresa vendendo ativos ### Sinais de Alerta | Sinal | O que significa | Ação | | ----------------- | -------------------------- | ---------------------- | | DY > 15% | Pode ser armadilha | Investigar causa | | Payout > 100% | Pagando mais que lucra | Evitar | | Dividendo cortado | Problemas financeiros | Analisar se temporário | | Dívida crescente | Pode cortar dividendos | Monitorar | | Lucro caindo | DY alto por queda de preço | Cuidado | *** ## Tributação de Dividendos ### Regras Atuais (2026) | Provento | Tributação | Responsável | | ------------------- | ---------- | --------------- | | **Dividendos** | Isento | N/A | | **JCP** | 15% IR | Retido na fonte | | **Venda com lucro** | 15% | Você (DARF) | ### Declarando no IR ``` RENDIMENTOS ISENTOS E NÃO TRIBUTÁVEIS Tipo: 09 - Lucros e dividendos recebidos CNPJ: [da empresa] Nome: [Nome da empresa] Valor: R$ X.XXX,XX ``` ### JCP (Juros sobre Capital Próprio) ``` RENDIMENTOS SUJEITOS À TRIBUTAÇÃO EXCLUSIVA Tipo: 10 - Juros sobre Capital Próprio CNPJ: [da empresa] Nome: [Nome da empresa] Valor bruto: R$ X.XXX,XX IR retido: R$ XXX,XX (15%) ``` *** ## Quanto Preciso para Viver de Dividendos? **Fórmula:** `Patrimônio = (Despesa Mensal × 12 × 1,20) ÷ DY` *O fator 1,20 é uma margem de segurança de 20%* **Exemplo:** R$ 10.000/mês com DY de 7% * Despesa anual: R$ 120.000 * Com margem 20%: R$ 144.000 * Patrimônio necessário: R$ 144.000 ÷ 0,07 = **R$ 2.057.000** ### Tabela de Referência | Renda Mensal | DY 5% | DY 6% | DY 7% | DY 8% | | ------------ | ------------ | ------------ | ------------ | ------------ | | R$ 3.000 | R$ 720.000 | R$ 600.000 | R$ 514.000 | R$ 450.000 | | R$ 5.000 | R$ 1.200.000 | R$ 1.000.000 | R$ 857.000 | R$ 750.000 | | R$ 10.000 | R$ 2.400.000 | R$ 2.000.000 | R$ 1.714.000 | R$ 1.500.000 | | R$ 20.000 | R$ 4.800.000 | R$ 4.000.000 | R$ 3.428.000 | R$ 3.000.000 | *** ## Perguntas Frequentes sobre Dividendos ### Dividendos são realmente isentos? **Sim**, para pessoa física no Brasil (2026). Há discussões sobre tributar no futuro, mas por enquanto são isentos. ### Devo priorizar DY alto ou crescimento de dividendos? Depende da fase: * **Acumulação**: Prefira crescimento (reinveste mais) * **Renda**: Prefira DY alto estável ### Qual o melhor momento para comprar pensando em dividendos? O DY sobe quando o preço cai. Comprar em quedas = DY melhor. Mas não espere muito - time in the market > timing the market. ### Preciso comprar antes da Data Com para receber? **Sim**, você precisa ter as ações até a Data Com (inclusive). Na Data Ex você já perde o direito. *** ## Conclusão Investir em dividendos é uma das formas mais seguras e previsíveis de construir renda passiva. Com disciplina, reinvestimento e paciência, é possível construir um patrimônio que gere renda suficiente para a independência financeira. **Pontos-chave:** * Dividendos são isentos de IR para pessoa física * Reinvista para acelerar o crescimento (juros compostos) * Diversifique entre setores (transmissão, bancos, seguros) * Cuidado com DY muito alto (pode ser armadilha) * Foque em empresas com histórico consistente de pagamentos * Calcule quanto precisa e trace um plano de aportes Para acompanhar dividendos em tempo real e construir seu próprio dashboard de renda passiva, use a [API da brapi.dev](https://brapi.dev). *** ## Recursos Adicionais * [Documentação da API brapi.dev](/docs) * [Buy and Hold - Estratégia Complementar](/blog/buy-and-hold-estrategia-investimento-longo-prazo) * [Value Investing](/blog/value-investing-como-encontrar-acoes-baratas) * [Como investir em ações](/blog/como-investir-em-acoes-guia-completo-iniciantes) # Dividendos Sintéticos com Opções: Guia da Estratégia Covered Call (2026) URL: /blog/dividendos-sinteticos-opcoes-covered-call-2026.mdx Aprenda a gerar renda extra (dividendos sintéticos) com suas ações usando a estratégia de Lançamento Coberto de Opções (Covered Call). Guia prático e riscos. *** searchable: true title: 'Dividendos Sintéticos com Opções: Guia da Estratégia Covered Call (2026)' description: 'Aprenda a gerar renda extra (dividendos sintéticos) com suas ações usando a estratégia de Lançamento Coberto de Opções (Covered Call). Guia prático e riscos.' date: '2026-01-02' keywords: 'dividendos sintéticos, lançamento coberto, covered call, opções bolsa, renda extra com ações, estratégia opções segura' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Opções' readingTime: '16 min' tags: \['Opções', 'Ações', 'Dividendos', 'Renda Extra', 'Estratégia Avançada'] relatedPosts: \['opcoes-b3-guia-completo-iniciantes-calls-puts', 'cadeia-opcoes-b3-python-tutorial-api-brapi', 'backtesting-opcoes-python-brapi-tutorial'] featured: false expertise: 'Estratégia de renda com derivativos para investidores intermediários' lastReviewed: '2026-02-02' -------------------------- import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; Você já tem ações de boas empresas (como Petrobras, Vale ou Banco do Brasil) na carteira para o longo prazo. E se eu te dissesse que você pode "alugar" essas ações para o mercado e receber um dinheiro extra todo mês, além dos dividendos normais? Essa estratégia existe e se chama **Lançamento Coberto (Covered Call)**, popularmente conhecida como **Dividendo Sintético**. Em 2026, com a sofisticação do mercado brasileiro, essa é uma das formas mais inteligentes de remunerar sua carteira. Mas cuidado: mexer com opções exige conhecimento. *** ## O Que é Lançamento Coberto? É a venda de uma **Opção de Compra (Call)** de uma ação que você **já possui** em carteira. ### A Analogia do Imóvel Imagine que você tem um apartamento (Ação) que vale R$ 500 mil. Alguém chega e diz: *"Te pago R$ 5 mil agora (Prêmio) pelo direito de comprar seu apê por R$ 550 mil (Strike) daqui a 30 dias."* Você aceita. Coloca R$ 5 mil no bolso hoje. * **Cenário A:** O mercado imobiliário cai ou fica igual. Ninguém vai querer comprar seu apê por R$ 550 mil. O contrato vence, você fica com o apê e com os R$ 5 mil. * **Cenário B:** O mercado explode e o apê vai para R$ 600 mil. A pessoa exerce o direito. Você é obrigado a vender por R$ 550 mil. Você ganhou os R$ 5 mil + a valorização até R$ 550 mil, mas deixou de ganhar o que passou disso. *** ## Passo a Passo na Bolsa 1. **Tenha a Ação:** Exemplo: 100 ações de PETR4 a R$ 30,00. 2. **Venda a Call:** Você vai no Home Broker e vende 100 opções de compra (Call) com Strike (preço alvo) R$ 32,00 para o próximo mês. 3. **Receba o Prêmio:** Digamos que a opção custe R$ 1,00. Você recebe **R$ 100,00** na hora na sua conta. Isso é o "Dividendo Sintético" (3,3% de rendimento imediato). *** ## Cenários no Vencimento ### 1. Ação Ficou Abaixo de R$ 32,00 (Não Exerceu) A opção vira "pó" (vale zero). * **Resultado:** Você continua com suas ações PETR4. O prêmio de R$ 100,00 é lucro líquido seu. * **Próximo Passo:** No mês seguinte, repete a operação e ganha mais um prêmio. ### 2. Ação Subiu Muito (Acima de R$ 32,00) (Exerceu) Você é **obrigado** a vender suas ações por R$ 32,00. * **Resultado:** Você lucrou com a alta da ação (de R$ 30 para R$ 32) + o prêmio da opção. * **O "Risco":** Se a ação foi para R$ 40,00, você deixou de ganhar essa alta explosiva. Você limitou seu ganho. *** ## Para Quem é Essa Estratégia? * Para quem quer **aumentar a rentabilidade** da carteira de longo prazo. * Para quem **não se importa em vender** a ação se ela subir muito (realizar lucro). * Para momentos de mercado lateral ou leve alta. ## Para Quem NÃO É? * Para quem tem apego emocional à ação ("não vendo de jeito nenhum"). * Para quem acha que a ação vai explodir 50% no curto prazo (você vai limitar seu ganho). *** ## Dicas de Ouro para 2026 1. **Liquidez:** Só faça com ações líquidas (PETR4, VALE3, ITUB4, BBDC4). Opções de small caps têm pouca liquidez e spreads ruins. 2. **Strike OTM (Out of The Money):** Venda opções com strike **acima** do preço atual (ex: 5% a 10% acima). Assim você dá espaço para a ação valorizar um pouco e diminui a chance de ser exercido. 3. **Cobertura Total:** Nunca venda mais opções do que você tem de ações. Isso seria "Lançamento Descoberto" e o risco é **infinito** (quebra de banca). *** ## Encontrando Candidatas com a brapi Antes de lançar a call, você precisa olhar quais séries estão sendo negociadas, com quais prêmios e liquidez. A brapi entrega isso via API — veja a [documentação de opções](/docs/opcoes) para o fluxo completo. ### 1. Descubra o Próximo Vencimento ```bash curl "https://brapi.dev/api/v2/options/expirations?underlying=PETR4" ``` ### 2. Liste as Calls OTM do Vencimento ```typescript // Preço atual de PETR4 (referência para escolher o strike) const quote = await fetch( "https://brapi.dev/api/quote/PETR4", { headers: { Authorization: "Bearer SEU_TOKEN" } }, ).then((r) => r.json()); const precoAtual = quote.results[0].regularMarketPrice; // Séries negociadas no vencimento escolhido const chain = await fetch( "https://brapi.dev/api/v2/options/chain?underlying=PETR4&expirationDate=2026-05-15&side=call", { headers: { Authorization: "Bearer SEU_TOKEN" } }, ).then((r) => r.json()); // Filtrar calls 5% a 10% OTM, com liquidez mínima const candidatas = chain.series .filter( (o) => o.strike >= precoAtual * 1.05 && o.strike <= precoAtual * 1.10 && o.trades > 50, // filtro simples de liquidez ) .map((o) => ({ symbol: o.symbol, strike: o.strike, premio: o.close, bid: o.bid, ask: o.ask, yieldPremio: (o.close / precoAtual) * 100, // % do prêmio sobre o ativo })); ``` Cada linha traz `symbol` (ex.: `PETRE370`), `strike` em reais, OHLCV, `bid`/`ask` e `trades` do último pregão. Use `trades` ou `financialVolume` como proxy de liquidez antes de montar a operação. ### 3. Avalie o Histórico do Prêmio ```bash # Quanto esta call andou nos últimos pregões? curl "https://brapi.dev/api/v2/options/historical?symbol=PETRE370&expirationDate=2026-05-15" ``` Olhe a série de `close`, `bid` e `ask` para sentir a volatilidade do prêmio e evitar entrar num dia de spread muito largo. **Plano mínimo: Pro.** No sandbox sem token, os endpoints de opções aceitam apenas `underlying=PETR4` (ou `symbol` começando com `PETR` no histórico). Perfeito para testar a estratégia antes de assinar. *** ## Conclusão O Dividendo Sintético é uma ferramenta poderosa para transformar volatilidade em renda. Se bem executado, pode adicionar 1% a 3% de retorno extra mensal à sua carteira. Comece pequeno para entender a mecânica. *Disclaimer: Opções são derivativos e envolvem riscos. Estude antes de operar.* # Dollar Cost Averaging (DCA) 2026: Estratégia de Aportes Mensais que Reduz Riscos URL: /blog/dollar-cost-averaging-estrategia-aporte-mensal.mdx Aprenda Dollar Cost Averaging (DCA) ✓ Aportes mensais para reduzir riscos e construir patrimônio. Calculadora inclusa! *** searchable: true title: 'Dollar Cost Averaging (DCA) 2026: Estratégia de Aportes Mensais que Reduz Riscos' description: 'Aprenda Dollar Cost Averaging (DCA) ✓ Aportes mensais para reduzir riscos e construir patrimônio. Calculadora inclusa!' date: '2026-01-01' keywords: 'dollar cost averaging 2026, DCA, aporte mensal, preço médio, estratégia investimento, investimento regular, como investir mensalmente, aportes regulares' author: 'Equipe brapi.dev' category: 'Estratégias' subcategory: 'Investimento Regular' readingTime: '14 min' tags: \['DCA', 'Aporte Mensal', 'Preço Médio', 'Estratégias', 'Investimentos', 'Gestão de Risco'] relatedPosts: \['buy-and-hold-estrategia-investimento-longo-prazo', 'dividendos-como-construir-renda-passiva', 'value-investing-como-encontrar-acoes-baratas', 'acoes-growth-vs-value-brasil', 'como-investir-em-acoes-guia-completo-iniciantes'] featured: true expertise: 'Especialistas em estratégias de investimento com foco em gestão de risco e construção de patrimônio.' lastReviewed: 2026-01-03 ------------------------ import { Callout } from 'fumadocs-ui/components/callout'; ## O que é Dollar Cost Averaging (DCA) **Dollar Cost Averaging (DCA)**, ou **Preço Médio** em português, é uma estratégia de investimento onde você investe uma quantia fixa de dinheiro em intervalos regulares, independentemente do preço do ativo. Em vez de tentar "acertar o momento" do mercado investindo tudo de uma vez, você dilui suas compras ao longo do tempo, reduzindo o risco de comprar no pior momento possível. ### Exemplo Simples | Mês | Aporte | Preço da Ação | Ações Compradas | | --------- | ------------ | ------------- | --------------- | | Janeiro | R$ 500 | R$ 50,00 | 10 | | Fevereiro | R$ 500 | R$ 40,00 | 12,5 | | Março | R$ 500 | R$ 45,00 | 11,1 | | Abril | R$ 500 | R$ 55,00 | 9,1 | | **Total** | **R$ 2.000** | - | **42,7 ações** | **Preço médio:** R$ 2.000 ÷ 42,7 = **R$ 46,84** Você comprou mais quando estava barato (fevereiro) e menos quando estava caro (abril), naturalmente! *** ## Por Que DCA Funciona ### 1. Elimina o Problema do "Timing" Ninguém consegue prever o mercado consistentemente. Estudos mostram que: * 95% dos investidores que tentam fazer timing perdem para o mercado * Perder os 10 melhores dias do ano reduz retornos em \~50% * Mesmo profissionais falham consistentemente em prever topos e fundos DCA resolve isso: você simplesmente ignora o timing e compra regularmente. ### 2. Automatiza a Disciplina A maior causa de fracasso nos investimentos é comportamental: * Medo de investir quando o mercado cai * Ganância de investir tudo quando sobe * Procrastinação em começar Com DCA programado, você remove a emoção da equação. ### 3. Reduz a Volatilidade do Preço Médio Simulações com R$ 12.000 investidos ao longo de 12 meses mostram: | Estratégia | Retorno Médio | Variância | Risco | | ------------------------------ | ------------- | --------- | ----------------------------- | | **Lump Sum** (tudo de uma vez) | +8,2% | Alta | Depende do momento de entrada | | **DCA** (R$ 1.000/mês) | +6,8% | Baixa | Diluído ao longo do tempo | DCA geralmente tem retorno ligeiramente menor, mas com **muito menos variância** nos resultados. Você troca um pouco de retorno potencial por mais previsibilidade. *** ## DCA vs Lump Sum: Qual é Melhor? ### Comparativo | Aspecto | DCA | Lump Sum | | --------------------- | ------------------------- | --------------------------- | | Quando usar | Tem renda mensal | Tem valor grande disponível | | Risco de timing | Eliminado | Alto | | Psicologia | Mais tranquilo | Mais estressante | | Retorno histórico | Ligeiramente menor\* | Ligeiramente maior\* | | Disciplina | Automática | Requer decisão única | | Custo de oportunidade | Dinheiro parado esperando | Investido imediatamente | \*Estudos mostram que Lump Sum ganha em \~67% do tempo, mas DCA tem menor variância. ### Quando Escolher DCA ✅ **Use DCA se:** * Recebe salário mensal (investe % da renda) * Não tem grande quantia disponível * Mercado está muito volátil ou em queda * Você é ansioso com investimentos * Está começando e quer aprender gradualmente ✅ **Use Lump Sum se:** * Recebeu herança, bônus, ou vendeu imóvel * O mercado está claramente descontado * Você tem estômago para volatilidade * Tem horizonte muito longo (20+ anos) *** ## Como Implementar DCA na Prática ### Passo 1: Defina o Valor do Aporte Regra comum: investir **10-30% da renda líquida** mensalmente. | Perfil | % da Renda | Exemplo (R$ 8.000) | | ------------------------------- | ---------- | ------------------ | | Conservador | 10% | R$ 800/mês | | **Moderado** | 20% | R$ 1.600/mês | | Agressivo | 30% | R$ 2.400/mês | | FIRE (Independência Financeira) | 50% | R$ 4.000/mês | Comece pelo perfil conservador (10%) e aumente gradualmente conforme seu orçamento permitir. O importante é começar! ### Passo 2: Escolha os Ativos Para DCA, prefira ativos diversificados: **Carteira DCA Diversificada:** | Categoria | Ativo | Alocação | | ------------------------- | ------------------- | -------- | | **Renda Variável Brasil** | BOVA11 (Ibovespa) | 30% | | | SMAL11 (Small Caps) | 10% | | | DIVO11 (Dividendos) | 10% | | **Internacional** | IVVB11 (S\&P 500) | 30% | | **Proteção** | GOLD11 (Ouro) | 10% | | | Tesouro IPCA+ | 10% | ### Passo 3: Automatize os Aportes Muitas corretoras oferecem investimento automático. Crie um cronograma fixo: **Exemplo de Cronograma DCA - R$ 2.000/mês:** | Mês | Data | BOVA11 (50%) | IVVB11 (30%) | GOLD11 (20%) | | --- | ---------- | ------------ | ------------ | ------------ | | 1 | 05/02/2026 | R$ 1.000 | R$ 600 | R$ 400 | | 2 | 05/03/2026 | R$ 1.000 | R$ 600 | R$ 400 | | 3 | 05/04/2026 | R$ 1.000 | R$ 600 | R$ 400 | | ... | ... | ... | ... | ... | Escolha um dia fixo após o recebimento do salário (ex: dia 5). A consistência é mais importante que o dia exato. ### Passo 4: Execute e Acompanhe Use a API brapi.dev para buscar cotações e calcular quantas cotas comprar: ```typescript // Buscar cotações para calcular aportes DCA const carteira = { BOVA11: 0.3, IVVB11: 0.25, SMAL11: 0.15, GOLD11: 0.1, }; const valorTotal = 2000; const response = await fetch( "https://brapi.dev/api/quote/BOVA11,IVVB11,SMAL11,GOLD11", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); // Calcular quantidade de cotas para cada ativo data.results.forEach((ativo) => { const peso = carteira[ativo.symbol]; const valorAlvo = valorTotal * peso; const qtdCotas = Math.floor(valorAlvo / ativo.regularMarketPrice); const valorReal = qtdCotas * ativo.regularMarketPrice; console.log(`${ativo.symbol}: ${qtdCotas} cotas = R$ ${valorReal.toFixed(2)}`); }); ``` **Exemplo de resultado (aporte de R$ 2.000):** | Ativo | Peso | Valor Alvo | Preço | Cotas | Valor Real | | ------------- | ---- | ---------- | --------- | ----- | --------------- | | BOVA11 | 30% | R$ 600 | R$ 128,50 | 4 | R$ 514,00 | | IVVB11 | 25% | R$ 500 | R$ 295,00 | 1 | R$ 295,00 | | SMAL11 | 15% | R$ 300 | R$ 98,20 | 3 | R$ 294,60 | | GOLD11 | 10% | R$ 200 | R$ 12,50 | 16 | R$ 200,00 | | Tesouro IPCA+ | 20% | R$ 400 | - | - | R$ 400,00 | | **Total** | 100% | R$ 2.000 | - | - | **R$ 1.703,60** | *Sobra de R$ 296,40 acumula para o próximo mês.* *** ## Calculadora DCA Completa Use a API brapi.dev para simular DCA com dados históricos reais: ```typescript // Simular DCA histórico com dados reais const response = await fetch( "https://brapi.dev/api/quote/BOVA11?range=24mo&interval=1mo", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); const historico = data.results[0].historicalDataPrice; const precoAtual = data.results[0].regularMarketPrice; // Calcular DCA com R$ 1.000/mês const aporteMensal = 1000; let totalCotas = 0; let totalInvestido = 0; historico.forEach((h) => { totalCotas += aporteMensal / h.close; totalInvestido += aporteMensal; }); const precoMedio = totalInvestido / totalCotas; const valorAtual = totalCotas * precoAtual; const lucro = valorAtual - totalInvestido; const retorno = ((valorAtual / totalInvestido) - 1) * 100; ``` **Exemplo de Resultado: DCA em BOVA11 (R$ 1.000/mês por 24 meses)** | Métrica | Valor | | ------------------- | ------------- | | Período | 24 meses | | Aporte mensal | R$ 1.000 | | **Total investido** | **R$ 24.000** | | Total de cotas | 195,5 | | Preço médio | R$ 122,76 | | Preço atual | R$ 135,00 | | **Valor atual** | **R$ 26.393** | | Lucro | R$ 2.393 | | **Retorno** | **+9,97%** | Com DCA você comprou mais cotas quando o preço estava baixo e menos quando estava alto, naturalmente otimizando seu preço médio. *** ## Estratégias Avançadas de DCA ### 1. Value Averaging (DCA Turbinado) Em vez de investir valor fixo, você ajusta para manter crescimento constante do patrimônio: **Como funciona:** * Defina uma meta de crescimento mensal (ex: R$ 1.000/mês) * Se o mercado subiu e você já tem R$ 10.200, aporta apenas R$ 800 * Se o mercado caiu e você tem R$ 9.500, aporta R$ 1.500 **Exemplo prático:** | Mês | Meta Patrimônio | Patrimônio Atual | Aporte Necessário | | --- | --------------- | ---------------- | ----------------- | | 1 | R$ 1.000 | R$ 0 | R$ 1.000 | | 2 | R$ 2.000 | R$ 1.050 (subiu) | R$ 950 | | 3 | R$ 3.000 | R$ 1.900 (caiu) | R$ 1.100 | | 4 | R$ 4.000 | R$ 3.200 (subiu) | R$ 800 | Value Averaging pode exigir aportes muito altos em quedas bruscas. Tenha reserva de emergência antes de usar essa estratégia. ### 2. DCA com Rebalanceamento Quando um ativo sobe muito, você naturalmente compra menos dele para manter a alocação-alvo: **Alocação-alvo:** BOVA11 (40%), IVVB11 (40%), GOLD11 (20%) **Exemplo com aporte de R$ 2.000:** | Ativo | Peso Alvo | Valor Atual | Valor Alvo | Diferença | Comprar | | ------ | --------- | ----------- | ---------- | --------- | -------- | | BOVA11 | 40% | R$ 6.000 | R$ 7.200 | +R$ 1.200 | 10 cotas | | IVVB11 | 40% | R$ 4.500 | R$ 7.200 | +R$ 2.700 | 9 cotas | | GOLD11 | 20% | R$ 3.500 | R$ 3.600 | +R$ 100 | 8 cotas | *O aporte vai mais para o ativo que ficou "para trás" (IVVB11).* Essa técnica combina DCA com rebalanceamento automático, mantendo sua carteira sempre alinhada com seus objetivos. ### 3. DCA Anti-Frágil (Mais nas Quedas) Aportar mais quando o mercado cai, aproveitando os descontos: **Regra:** A cada 10% de queda do mercado, aumente 50% o aporte (máximo 2x). | Variação do Mercado | Multiplicador | Aporte Base R$ 1.000 | | --------------------- | ------------- | -------------------- | | +5% (alta) | 1,0x | R$ 1.000 | | 0% (estável) | 1,0x | R$ 1.000 | | -5% (queda leve) | 1,25x | R$ 1.250 | | -10% (queda moderada) | 1,5x | R$ 1.500 | | -15% (queda forte) | 1,75x | R$ 1.750 | | -20% ou mais | 2,0x (máx) | R$ 2.000 | Para usar DCA Anti-Frágil, você precisa de reserva extra disponível para os meses de queda. Não comprometa sua reserva de emergência! *** ## DCA para Diferentes Perfis ### Iniciante (Patrimônio \< R$ 50k) | Ativo | Alocação | Motivo | | ------------- | -------- | --------------------------------------- | | BOVA11 | 60% | Simplicidade, diversificação automática | | IVVB11 | 30% | Exposição internacional | | Tesouro Selic | 10% | Reserva de emergência | **Aporte recomendado:** 15-20% da renda\ **Foco:** Aprender e criar o hábito de investir ### Intermediário (R$ 50k - R$ 500k) | Categoria | Ativo | Alocação | | ----------------------- | ------------- | -------- | | **Brasil (45%)** | BOVA11 | 20% | | | SMAL11 | 10% | | | DIVO11 | 15% | | **Internacional (35%)** | IVVB11 | 25% | | | EURP11 | 10% | | **Proteção (20%)** | GOLD11 | 10% | | | Tesouro IPCA+ | 10% | **Aporte recomendado:** 20-30% da renda\ **Foco:** Diversificação e crescimento consistente ### Avançado (> R$ 500k) | Categoria | Ativo | Alocação | | ------------------------ | ------------------ | -------- | | **Brasil - Ações (35%)** | Ações individuais | 25% | | | FIIs | 10% | | **Internacional (30%)** | Corretora exterior | 30% | | **Alternativos (15%)** | Criptomoedas | 5% | | | Private Equity | 10% | | **Proteção (20%)** | Renda Fixa | 15% | | | Ouro físico | 5% | **Aporte recomendado:** 30-50% da renda\ **Foco:** Preservação de patrimônio e otimização fiscal *** ## Acompanhando seus Aportes DCA Use a API brapi.dev para calcular seu preço médio e acompanhar o retorno: ```typescript // Registrar seus aportes e calcular posição atual const aportes = [ { data: "2024-01-05", symbol: "BOVA11", quantidade: 10, preco: 128.5 }, { data: "2024-02-05", symbol: "BOVA11", quantidade: 8, preco: 132.2 }, { data: "2024-03-05", symbol: "BOVA11", quantidade: 9, preco: 125.8 }, { data: "2024-01-05", symbol: "IVVB11", quantidade: 5, preco: 280.0 }, { data: "2024-02-05", symbol: "IVVB11", quantidade: 4, preco: 295.0 }, ]; // Agrupar por símbolo const posicoes = {}; aportes.forEach((a) => { if (!posicoes[a.symbol]) { posicoes[a.symbol] = { quantidade: 0, valorInvestido: 0 }; } posicoes[a.symbol].quantidade += a.quantidade; posicoes[a.symbol].valorInvestido += a.quantidade * a.preco; }); // Buscar preços atuais const symbols = Object.keys(posicoes).join(","); const response = await fetch( `https://brapi.dev/api/quote/${symbols}`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); // Calcular retorno data.results.forEach((ativo) => { const pos = posicoes[ativo.symbol]; pos.precoMedio = pos.valorInvestido / pos.quantidade; pos.precoAtual = ativo.regularMarketPrice; pos.valorAtual = pos.quantidade * pos.precoAtual; pos.lucro = pos.valorAtual - pos.valorInvestido; pos.retorno = (pos.lucro / pos.valorInvestido) * 100; }); ``` **Exemplo de Relatório de Posição:** | Ativo | Qtd | Preço Médio | Preço Atual | Investido | Valor Atual | Lucro | Retorno | | --------- | --- | ----------- | ----------- | ------------ | ------------ | ---------- | --------- | | BOVA11 | 27 | R$ 128,67 | R$ 135,00 | R$ 3.474 | R$ 3.645 | R$ 171 | +4,9% | | IVVB11 | 9 | R$ 286,67 | R$ 310,00 | R$ 2.580 | R$ 2.790 | R$ 210 | +8,1% | | **Total** | - | - | - | **R$ 6.054** | **R$ 6.435** | **R$ 381** | **+6,3%** | Registre cada aporte em uma planilha ou app para acompanhar seu preço médio real ao longo do tempo. *** ## Perguntas Frequentes sobre DCA ### Qual o melhor dia do mês para aportar? Estudos mostram que **não faz diferença significativa**. Escolha um dia após receber o salário e mantenha consistência. ### DCA funciona em mercado de alta? Sim, mas com retorno menor que Lump Sum. Porém, você não sabe de antemão se o mercado vai subir ou cair, então DCA continua sendo uma escolha segura. ### Posso fazer DCA semanal? Sim! DCA semanal pode reduzir ainda mais a volatilidade. Mas os custos operacionais podem não valer a pena para valores pequenos. ### Devo parar DCA se o mercado subir muito? **Não!** Isso é tentar fazer timing. Continue aportando independentemente do mercado. ### E se eu perder um mês? Sem problemas. Faça um aporte maior no mês seguinte ou simplesmente continue normalmente. O importante é a consistência no longo prazo. *** ## Conclusão Dollar Cost Averaging é a estratégia perfeita para quem quer construir patrimônio de forma consistente sem se preocupar com o timing do mercado. Automatize seus aportes, mantenha a disciplina, e deixe o tempo e os juros compostos trabalharem a seu favor. **Resumo:** * Invista valor fixo em intervalos regulares * Ignore as oscilações de curto prazo * Automatize para remover emoções * Reinvista dividendos no processo * Acompanhe seu preço médio e retorno total * Mantenha a estratégia por anos, não meses Para automatizar seu DCA e acompanhar suas posições em tempo real, use a [API da brapi.dev](https://brapi.dev) para construir suas próprias ferramentas de controle. *** ## Recursos Adicionais * [Documentação da API brapi.dev](/docs) * [Buy and Hold - Estratégia Complementar](/blog/buy-and-hold-estrategia-investimento-longo-prazo) * [ETFs Brasil - Ideais para DCA](/blog/etfs-brasil-guia-completo-bova11-ivvb11) * [Como investir em ações](/blog/como-investir-em-acoes-guia-completo-iniciantes) # P/L de uma Ação: O que Significa e Como Interpretar URL: /blog/entendendo-indicador-preco-lucro-pl-analise-fundamentalista.mdx Entenda o indicador Preço/Lucro, como calcular o P/L de uma ação, por que valores baixos podem enganar e como comparar empresas do mesmo setor. *** searchable: true title: 'P/L de uma Ação: O que Significa e Como Interpretar' description: 'Entenda o indicador Preço/Lucro, como calcular o P/L de uma ação, por que valores baixos podem enganar e como comparar empresas do mesmo setor.' date: '2025-08-22' keywords: 'p/l o que é, preço lucro ações, como calcular p/l, p/l baixo, indicador preço lucro, análise fundamentalista' author: 'Alisson Leal' category: 'Análise Fundamentalista' subcategory: 'Indicadores' readingTime: '7 min' tags: \['P/L', 'Preço/Lucro', 'Análise Fundamentalista', 'Valuation', 'Ações'] relatedPosts: \['como-usar-indicador-pvp-valor-patrimonial-analise-acoes', 'api-indicadores-fundamentalistas-b3-python', 'guia-completo-indicadores-fundamentalistas-bovespa'] featured: false expertise: 'Análise fundamentalista de empresas brasileiras' lastReviewed: '2026-07-17' -------------------------- import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; P/L significa Preço/Lucro. O indicador divide o preço de uma ação pelo lucro por ação da empresa. Ele mostra quanto o mercado paga por cada real de lucro, com base no período usado no cálculo. ```text P/L = preço da ação / lucro por ação ``` Um P/L de 8 significa que o preço equivale a oito vezes o lucro por ação. Isso não quer dizer que o investimento "se paga" em oito anos. ## Exemplo simples Se uma ação custa R$ 24 e o lucro por ação dos últimos 12 meses foi R$ 3: ```text P/L = 24 / 3 = 8 ``` O cálculo depende dos dois números. Se o lucro cair para R$ 1,50 e o preço não mudar, o P/L sobe para 16. ## P/L baixo é melhor? Não necessariamente. Um múltiplo baixo pode indicar preço descontado, mas também pode refletir lucro temporariamente alto, negócio em declínio, dívida elevada ou risco que o mercado já percebeu. Um banco, uma empresa elétrica e uma varejista costumam negociar em faixas diferentes. Compare empresas do mesmo setor e entenda por que o múltiplo diverge. Quando o lucro é negativo, o P/L perde a interpretação usual. Alguns sistemas mostram um número negativo; outros deixam o campo vazio. Não trate esse caso como uma ação extremamente barata. ## P/L histórico ou projetado O P/L histórico usa lucro já publicado, normalmente dos últimos 12 meses. Ele é verificável, mas olha para trás. O P/L projetado usa uma estimativa de lucro futuro. Ele pode ajudar quando o resultado está mudando, mas depende das premissas de quem fez a projeção. Não compare um P/L histórico com um projetado sem identificar a metodologia. ## O que pode distorcer o indicador * venda de um ativo que gerou lucro extraordinário; * reversão contábil sem efeito recorrente; * ciclo favorável de commodities; * lucro muito baixo perto de zero; * mudança relevante na quantidade de ações; * empresas financeiras comparadas com empresas industriais. Leia a DRE e o fluxo de caixa para saber se o lucro representa a operação normal da empresa. ## Comparar empresas do mesmo setor Considere duas empresas parecidas: | Empresa | P/L | Margem líquida | Dívida | Crescimento do lucro | | ------- | --: | -------------: | -----: | -------------------: | | A | 7 | 8% | Alta | Negativo | | B | 11 | 15% | Baixa | Positivo | A Empresa A tem P/L menor, mas os outros números explicam parte do desconto. O múltiplo serve para abrir a investigação, não para encerrá-la. ## Consultar o P/L por API Na API v2 da brapi, o P/L atual aparece em `trailingPE` no endpoint de estatísticas: ```bash curl "https://brapi.dev/api/v2/stocks/statistics?symbols=PETR4,VALE3&mode=current" ``` Em Python: ```python import requests response = requests.get( "https://brapi.dev/api/v2/stocks/statistics", params={"symbols": "PETR4,VALE3", "mode": "current"}, timeout=30, ) response.raise_for_status() for item in response.json()["results"]: print(item["symbol"], item["data"].get("trailingPE")) ``` Para P/VP, EV/EBITDA, ROE e margens, use o fluxo descrito em [indicadores fundamentalistas da B3 com Python](/blog/api-indicadores-fundamentalistas-b3-python). ## P/L e P/VP respondem perguntas diferentes P/L compara preço com lucro. P/VP compara preço com patrimônio líquido por ação. Empresas intensivas em ativos podem exigir uma leitura diferente de negócios que dependem mais de marca, software ou capital humano. Veja [como interpretar P/VP](/blog/como-usar-indicador-pvp-valor-patrimonial-analise-acoes) antes de usar os dois múltiplos no mesmo filtro. ## Checklist de interpretação Antes de concluir que uma ação está barata porque o P/L é baixo: 1. confirme o período do lucro; 2. retire eventos não recorrentes quando fizer sentido; 3. compare empresas semelhantes; 4. observe dívida, margens e fluxo de caixa; 5. verifique se o lucro está crescendo ou caindo; 6. confira a data de referência. O P/L resume uma relação. Ele não resume a empresa. # Enterprise Value 2025: Como Calcular o Valor Real de Empresas na Bolsa Brasileira URL: /blog/enterprise-value-ev-como-calcular-valor-real-empresa.mdx Domine o Enterprise Value (EV) para valuation preciso! Aprenda EV/EBITDA, EV/Receita e como avaliar o valor real de empresas. Guia completo com API brapi.dev ✓ *** searchable: true title: 'Enterprise Value 2025: Como Calcular o Valor Real de Empresas na Bolsa Brasileira' description: 'Domine o Enterprise Value (EV) para valuation preciso! Aprenda EV/EBITDA, EV/Receita e como avaliar o valor real de empresas. Guia completo com API brapi.dev ✓' date: '2025-08-22' keywords: 'enterprise value, EV, valor da empresa, EV/EBITDA, valuation, análise fundamentalista, múltiplos, bolsa brasileira, valor real empresa, estrutura capital, brapi' author: 'Equipe brapi.dev' category: 'Valuation e Análise' subcategory: 'Múltiplos de Valuation' readingTime: '20 min' tags: \['Enterprise Value', 'Valuation', 'EV/EBITDA', 'Bolsa Brasileira', 'Análise Fundamentalista', 'Múltiplos', 'Valor Real', 'Estrutura Capital'] relatedPosts: \['entendendo-indicador-preco-lucro-pl-analise-fundamentalista', 'roe-retorno-sobre-patrimonio-como-analisar', 'guia-ebit-e-ebitda'] featured: true expertise: 'Valuation e análise de estrutura de capital com 8+ anos de experiência no mercado brasileiro' lastReviewed: 2026-01-03 howToTools: \['API brapi.dev', 'Dados do balance-sheet', 'Calculadora'] howToSteps: * name: 'Obtenha o Market Cap' text: 'Multiplique o preço da ação pelo número de ações em circulação.' * name: 'Some a dívida total' text: 'Use o módulo balance-sheet para obter dívida de curto e longo prazo.' * name: 'Subtraia caixa e equivalentes' text: 'Desconte disponibilidades e investimentos de curto prazo.' * name: 'Calcule o Enterprise Value' text: 'EV = Market Cap + Dívida Total - Caixa e Equivalentes.' * name: 'Use múltiplos EV/EBITDA' text: 'Divida o EV pelo EBITDA para comparar empresas com estruturas de capital diferentes.' *** import { Authors, Author } from '~/components/Authors'; > O Enterprise Value (EV) é a métrica mais precisa para avaliar o valor real de uma empresa, considerando dívidas e caixa. Aprenda como usar EV/EBITDA e outros múltiplos para valuation superior na bolsa brasileira em 2025. *** ## O que é Enterprise Value e Por Que é Superior ao Market Cap? **O Enterprise Value (EV) representa o valor total necessário para comprar uma empresa inteira**, incluindo suas dívidas e descontando o caixa disponível. É mais preciso que o valor de mercado (market cap) para comparações entre empresas. **Analogia prática:** Se você fosse comprar uma empresa, pagaria o valor das ações (market cap) mais assumiria as dívidas, mas ficaria com o caixa. Essa é exatamente a lógica do EV. ### Por Que EV é Fundamental para Valuation? 1. **Elimina distorções** da estrutura de capital 2. **Permite comparações** entre empresas com diferentes níveis de endividamento 3. **Base** para múltiplos operacionais como EV/EBITDA 4. **Métrica real** para fusões e aquisições 5. **Considera** toda a estrutura financeira da empresa ### Fórmula do Enterprise Value ``` EV = Valor de Mercado + Dívida Total - Caixa e Equivalentes ``` **Componentes detalhados:** * **Valor de Mercado**: Preço da ação × Número de ações em circulação * **Dívida Total**: Dívidas de curto + longo prazo * **Caixa**: Caixa, bancos e aplicações financeiras ### Exemplo Prático **Empresa XPTO:** * Valor de mercado: R$ 10 bilhões * Dívida total: R$ 3 bilhões * Caixa: R$ 1 bilhão * **EV = 10 + 3 - 1 = R$ 12 bilhões** ## Por que o EV é Superior ao Market Cap? ### 1. Considera a Estrutura de Capital O EV leva em conta como a empresa é financiada, não apenas o valor das ações. ### 2. Facilita Comparações Permite comparar empresas com diferentes níveis de endividamento de forma mais justa. ### 3. Perspectiva do Comprador Representa o valor real que um comprador pagaria para adquirir toda a empresa. ### 4. Base para Múltiplos Operacionais Usado em múltiplos como EV/EBITDA que eliminam distorções da estrutura de capital. ## Acessando Dados de EV via brapi.dev A [API da brapi.dev](/docs/acoes) fornece dados necessários para calcular o Enterprise Value: ### Consultando Dados via API ```bash curl "https://brapi.dev/api/quote/PETR4?modules=defaultKeyStatistics,financialData,balanceSheetHistory" ``` **Resposta com dados para EV:** ```json { "results": [{ "symbol": "PETR4", "marketCap": 458740000000, "sharesOutstanding": 13032000000, "defaultKeyStatistics": { "enterpriseValue": 459590000000, "totalCash": 45230000000, "totalDebt": 46080000000 }, "financialData": { "totalCash": 45230000000, "totalDebt": 46080000000, "enterpriseValue": 459590000000 } }] } ``` ### Calculando EV Automaticamente ```javascript async function calcularEV(ticker) { const response = await fetch(`https://brapi.dev/api/quote/${ticker}?modules=defaultKeyStatistics,financialData`); const data = await response.json(); const dados = data.results[0]; const marketCap = dados.marketCap; const totalDebt = dados.defaultKeyStatistics.totalDebt || 0; const totalCash = dados.defaultKeyStatistics.totalCash || 0; const ev = marketCap + totalDebt - totalCash; return { ticker, marketCap: marketCap / 1e9, // Em bilhões totalDebt: totalDebt / 1e9, totalCash: totalCash / 1e9, enterpriseValue: ev / 1e9, estruturaCapital: { percentualDivida: (totalDebt / (marketCap + totalDebt)) * 100, liquidezRelativa: (totalCash / totalDebt) * 100 } }; } ``` ## Principais Múltiplos de Enterprise Value ### 1. EV/EBITDA ``` EV/EBITDA = Enterprise Value ÷ EBITDA ``` **Vantagens:** * Elimina diferenças de estrutura de capital * Não afetado por depreciação e amortização * Ideal para comparar empresas de capital intensivo **Interpretação:** * **\< 10x**: Potencialmente subvalorizada * **10-15x**: Valoração razoável * **> 20x**: Pode estar cara ### 2. EV/Receita ``` EV/Receita = Enterprise Value ÷ Receita Líquida ``` **Uso:** * Empresas com margens temporariamente baixas * Startups em crescimento * Comparação entre empresas do mesmo setor ### 3. EV/FCL (Fluxo de Caixa Livre) ``` EV/FCL = Enterprise Value ÷ Fluxo de Caixa Livre ``` **Características:** * Mostra quantos anos para recuperar investimento * Considera investimentos em capex * Ideal para empresas maduras ## Análise Setorial com EV ### Bancos - Cuidados Especiais **Peculiaridades:** * Dívida faz parte do modelo de negócio * EV não é aplicável da forma tradicional * Usar P/VP e ROE para análise ### Utilities - EV/EBITDA Relevante **Características:** * Alto investimento em ativos * Fluxo de caixa previsível * EV/EBITDA entre 8-12x é normal **Exemplo:** EGIE3, SBSP3, CPLE6 ### Tecnologia - EV/Receita Importante **Características:** * Margens variáveis * Crescimento acelerado * EV/Receita pode ser mais relevante que EV/EBITDA **Exemplo:** TOTS3, LWSA3 ### Commodities - Atenção ao Ciclo **Características:** * Margens cíclicas * EV deve considerar ciclo de preços * Usar médias de longo prazo **Exemplo:** VALE3, CSNA3 ## Screening de Ações com EV ### Critérios de Filtragem por EV Para identificar oportunidades com base no Enterprise Value, aplique os seguintes critérios: **Filtros Básicos:** | Critério | Valor | Justificativa | | ------------- | ------ | ------------------------ | | EV/EBITDA | \< 15x | Valuation atrativo | | EV/Receita | \< 3x | Preço justo sobre vendas | | ROE | > 10% | Rentabilidade mínima | | Margem EBITDA | > 10% | Eficiência operacional | **Classificação de Qualidade:** | ROE | Qualidade | | ------ | --------- | | > 15% | Alta | | 10-15% | Média | | \< 10% | Baixa | > **Dica:** Ordene as oportunidades pelo menor EV/EBITDA para encontrar as mais atrativas. ### Dashboard de Monitoramento ```typescript const DashboardEV = ({ setorFoco }) => { const [dados, setDados] = useState([]); useEffect(() => { const buscarDadosEV = async () => { const acoes = obterAcoesSetor(setorFoco); const resultados = []; for (const ticker of acoes) { const ev = await calcularEV(ticker); const multiplos = await calcularMultiplosEV(ticker); resultados.push({ ...ev, ...multiplos, atratividade: avaliarAtratividade(multiplos) }); } setDados(resultados.sort((a, b) => a.ev_ebitda - b.ev_ebitda)); }; buscarDadosEV(); }, [setorFoco]); return (

Análise EV - {setorFoco}

{dados.map(item => ( ))}
Ticker EV (R$ bi) EV/EBITDA EV/Receita Atratividade
{item.ticker} {item.enterpriseValue.toFixed(1)} {item.ev_ebitda.toFixed(1)}x {item.ev_receita.toFixed(1)}x {item.atratividade === 'Alta' ? '🟢' : item.atratividade === 'Média' ? '🟡' : '🔴'}
); }; ``` ## Enterprise Value vs Market Cap ### Quando Usar Cada Um #### Market Cap é melhor para: * Comparar retorno aos acionistas * Calcular P/L, P/VP * Análise de dividendos * Valoração de bancos #### Enterprise Value é melhor para: * Comparar empresas operacionais * Múltiplos operacionais (EV/EBITDA) * Análises de M\&A * Empresas com dívidas significativas ### Exemplo Comparativo **Empresa A:** * Market Cap: R$ 5 bi * Dívida: R$ 8 bi * Caixa: R$ 1 bi * **EV: R$ 12 bi** **Empresa B:** * Market Cap: R$ 10 bi * Dívida: R$ 1 bi * Caixa: R$ 2 bi * **EV: R$ 9 bi** **Análise:** Pelo Market Cap, B é 2x maior que A. Pelo EV, A é maior que B, refletindo sua alta alavancagem. ## Armadilhas na Análise de EV ### 1. Empresas com Caixa Excessivo **Problema:** Caixa improdutivo pode distorcer múltiplos **Solução:** * Analisar origem do caixa * Verificar planos de uso * Considerar EV ajustado ### 2. Dívidas Off-Balance **Problema:** Arrendamentos e outras obrigações não capturadas **Solução:** * Incluir arrendamentos operacionais * Considerar garantias e avais * Analisar notas explicativas ### 3. Ciclos de Commodity **Problema:** EBITDA pode estar artificialmente alto/baixo **Solução:** * Usar EBITDA normalizado * Considerar média de ciclo completo * Analisar múltiplos através do tempo ## Estratégias de Investimento com EV ### 1. Value Investing com EV **Critérios:** * EV/EBITDA \< 8x * EV/FCL \< 15x * Empresa sólida em setor estável * Gestão eficiente ### 2. Growth at Reasonable Price (GARP) **Critérios:** * EV/Receita razoável para o crescimento * EBITDA crescente * Mercado em expansão * Vantagem competitiva ### 3. Turnaround Situations **Critérios:** * EV baixo por problemas temporários * Nova gestão ou estratégia * Ativos de qualidade * Setor em recuperação ## Calculadora de Enterprise Value ### Ferramenta Web Simples ```html Calculadora Enterprise Value

Calculadora Enterprise Value

``` ## Casos Práticos no Mercado Brasileiro ### Caso 1: Utility com Dívida Alta **EGIE3 - Engie Brasil** * Market Cap: R$ 42 bi * Dívida: R$ 15 bi * Caixa: R$ 3 bi * **EV: R$ 54 bi** * **EV/EBITDA: 5,1x** - Atrativo para o setor ### Caso 2: Empresa com Muito Caixa **PETR4 - Petrobras** * Market Cap: R$ 459 bi * Dívida: R$ 46 bi * Caixa: R$ 45 bi * **EV: R$ 460 bi** * **Análise:** Caixa elevado protege contra ciclos ## Monitoramento e Alertas ### Alertas Automáticos Configure uma watchlist para monitorar oportunidades baseadas em EV: **Exemplo de Watchlist:** | Ticker | Setor | O que Monitorar | | ------ | ---------- | ----------------------- | | EGIE3 | Energia | EV/EBITDA, margens | | SBSP3 | Saneamento | EV/EBITDA, crescimento | | CPLE6 | Energia | EV/EBITDA, dividendos | | TOTS3 | Tecnologia | EV/Receita, crescimento | **Critérios de Oportunidade:** | Métrica | Valor Alvo | Ação | | ------------------- | ---------- | --------------------- | | EV/EBITDA | \< 10x | 🟢 Analisar | | Crescimento Receita | > 5% | Sustentabilidade | | Margem EBITDA | > 15% | Qualidade operacional | > Quando todos os critérios forem atendidos, a ação merece uma análise mais profunda para possível investimento. ## Conclusão O Enterprise Value é uma métrica fundamental para análise de investimentos que oferece uma visão mais completa do valor real das empresas. Ao considerar a estrutura de capital, permite comparações mais justas e múltiplos mais relevantes. ### Pontos-Chave: 1. **EV considera dívida e caixa** além do valor de mercado 2. **Múltiplos de EV eliminam** distorções de estrutura de capital 3. **Essencial para análises** de M\&A e comparações setoriais 4. **Complementar ao Market Cap**, não substituto ### Próximos Passos: * Explore nossa [API completa](/docs) para dados de EV * Use nossa [plataforma](/quotes) para análise comparativa * Aprenda sobre [múltiplos de valuation](/blog/multiplos-valuation-analise-acoes-brasileiras) **Lembre-se:** Enterprise Value é uma ferramenta poderosa, mas deve ser usada em conjunto com análise qualitativa e outros indicadores fundamentalistas. # ETFs Brasil 2026: Guia Completo sobre BOVA11, IVVB11 e os Melhores Fundos de Índice URL: /blog/etfs-brasil-guia-completo-bova11-ivvb11.mdx Aprenda tudo sobre ETFs no Brasil ✓ Como investir em BOVA11, IVVB11, SMAL11 e outros fundos de índice. Taxas, vantagens, desvantagens e estratégias para 2026. *** searchable: true title: 'ETFs Brasil 2026: Guia Completo sobre BOVA11, IVVB11 e os Melhores Fundos de Índice' description: 'Aprenda tudo sobre ETFs no Brasil ✓ Como investir em BOVA11, IVVB11, SMAL11 e outros fundos de índice. Taxas, vantagens, desvantagens e estratégias para 2026.' date: '2026-01-01' keywords: 'ETF Brasil, BOVA11, IVVB11, fundos de índice, como investir em ETF, ETF Ibovespa, ETF S\&P 500, SMAL11, melhores ETFs Brasil, ETF renda variável, 2026' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'ETFs e Fundos' readingTime: '18 min' tags: \['ETF', 'BOVA11', 'IVVB11', 'Fundos de Índice', 'Investimentos', 'Bolsa Brasileira', 'Renda Variável'] relatedPosts: \['o-que-e-bolsa-de-valores-como-funciona-b3', 'como-investir-em-acoes-guia-completo-iniciantes', 'roic-roe-analise-fundamentalista-2026', 'etfs-criptomoedas-b3-hash11-bith11-guia-2026', 'etfs-dividendos-brasil-divo11-ndiv11-divd11-2026'] featured: true expertise: 'Especialistas em mercado financeiro brasileiro com foco em investimentos passivos e dados de mercado em tempo real.' lastReviewed: 2026-01-03 ------------------------ ## O que são ETFs e Por Que Estão Revolucionando os Investimentos no Brasil Os **ETFs (Exchange Traded Funds)**, ou fundos de índice negociados em bolsa, representam uma das formas mais eficientes e acessíveis de investir no mercado de ações. Em vez de comprar ações individuais, você adquire uma cesta diversificada de ativos com apenas uma ordem. No Brasil, o mercado de ETFs cresceu exponencialmente nos últimos anos. Em 2026, o patrimônio líquido dos ETFs listados na bolsa brasileira ultrapassou **R$ 60 bilhões**, com mais de 90 fundos disponíveis para negociação. ### Por que ETFs são populares? | Vantagem | Descrição | | ------------------------------ | ----------------------------------------------- | | **Diversificação instantânea** | Uma cota = dezenas ou centenas de ações | | **Custos baixos** | Taxas de administração entre 0,03% e 0,60% a.a. | | **Liquidez** | Negociados em bolsa como ações normais | | **Transparência** | Composição divulgada diariamente | | **Acessibilidade** | Cotas a partir de R$ 10-15 | *** ## Como Funcionam os ETFs na Bolsa Brasileira Os ETFs são fundos de investimento que replicam a performance de um índice de referência (benchmark). O gestor do fundo compra os ativos que compõem o índice na mesma proporção, garantindo que o ETF acompanhe fielmente o desempenho do benchmark. ### Estrutura de um ETF ``` Índice de Referência (ex: Ibovespa) ↓ Gestor do ETF (compra os ativos) ↓ Fundo de ETF (BOVA11, por exemplo) ↓ Cotas negociadas na bolsa brasileira (você compra/vende) ``` ### Diferença entre ETF e Fundo de Ações Tradicional | Característica | ETF | Fundo de Ações | | --------------------- | ------------------- | ---------------- | | Negociação | Bolsa | Corretora/Banco | | Preço | Tempo real | D+1 ou D+2 | | Taxa de administração | 0,03% - 0,60% | 1% - 3% | | Taxa de performance | Não tem | Geralmente 20% | | Investimento mínimo | 1 cota (\~R$10-150) | R$100 - R$5.000 | | Gestão | Passiva | Ativa ou Passiva | *** ## Os Principais ETFs do Brasil em 2026 ### 1. BOVA11 - ETF Ibovespa (iShares) O **BOVA11** é o ETF mais popular e líquido do Brasil, replicando o índice Ibovespa. | Informação | Valor | | ------------------------- | ------------------- | | **Gestor** | BlackRock (iShares) | | **Índice** | Ibovespa | | **Taxa de administração** | 0,10% a.a. | | **Patrimônio líquido** | \~R$ 15 bilhões | | **Volume médio diário** | \~R$ 500 milhões | | **Número de ações** | \~85 empresas | **Principais posições do BOVA11:** * Vale (VALE3): \~12% * Petrobras (PETR4/PETR3): \~10% * Itaú Unibanco (ITUB4): \~7% * Bradesco (BBDC4): \~4% * B3SA3 (Bolsa): \~3% ### 2. IVVB11 - ETF S\&P 500 O **IVVB11** permite investir nas 500 maiores empresas americanas sem sair do Brasil. | Informação | Valor | | ------------------------- | -------------------------------------- | | **Gestor** | BlackRock (iShares) | | **Índice** | S\&P 500 | | **Taxa de administração** | 0,23% a.a. | | **Exposição cambial** | Sim (dólar) | | **Principais empresas** | Apple, Microsoft, Amazon, Google, Meta | **Vantagens do IVVB11:** * Exposição ao mercado americano * Proteção cambial natural * Diversificação geográfica * Sem IOF ou complexidade de investir no exterior ### 3. SMAL11 - Small Caps Brasil O **SMAL11** replica o índice de small caps da bolsa brasileira, focando em empresas menores com maior potencial de crescimento. | Informação | Valor | | ------------------------- | ---------------------------- | | **Gestor** | BlackRock (iShares) | | **Índice** | SMLL (Small Cap) | | **Taxa de administração** | 0,50% a.a. | | **Número de ações** | \~120 empresas | | **Perfil** | Maior risco, maior potencial | ### 4. Outros ETFs Populares | ETF | Índice | Taxa | Foco | | ---------- | ------------ | ----- | ----------------- | | **HASH11** | NCI (Crypto) | 0,30% | Criptomoedas | | **GOLD11** | Ouro | 0,30% | Ouro | | **DIVO11** | IDIV | 0,50% | Dividendos | | **ECOO11** | ICO2 | 0,38% | Sustentabilidade | | **FIND11** | IFNC | 0,60% | Setor Financeiro | | **MATB11** | IMAT | 0,50% | Materiais Básicos | | **BOVV11** | Ibovespa | 0,10% | Ibovespa (Itaú) | | **SPXI11** | S\&P 500 | 0,21% | S\&P 500 (Itaú) | *** ## Como Investir em ETFs: Passo a Passo ### Passo 1: Abra conta em uma corretora Escolha uma corretora de valores que ofereça: * Taxa zero para compra de ETFs * Plataforma estável * Bom atendimento ### Passo 2: Transfira recursos Faça uma TED ou PIX para sua conta na corretora. ### Passo 3: Acesse o Home Broker No campo de busca, digite o código do ETF desejado (ex: BOVA11). ### Passo 4: Envie a ordem de compra ``` Ativo: BOVA11 Tipo: Compra Quantidade: 10 cotas Preço: A mercado ou limite Validade: Dia ou até cancelar ``` ### Passo 5: Acompanhe seu investimento Use a API da brapi.dev para monitorar seus ETFs em tempo real: ```typescript const response = await fetch("https://brapi.dev/api/quote/BOVA11", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }, }); const { results } = await response.json(); const etf = results[0]; console.log(`ETF: ${etf.symbol}`); console.log(`Preço: R$ ${etf.regularMarketPrice}`); console.log(`Variação: ${etf.regularMarketChangePercent}%`); ``` *** ## Analisando ETFs com a API brapi.dev A [brapi.dev](https://brapi.dev) oferece dados completos sobre todos os ETFs negociados na bolsa brasileira. Veja como analisar e comparar ETFs programaticamente: ### Comparando múltiplos ETFs ```typescript const etfs = ["BOVA11", "IVVB11", "SMAL11", "HASH11", "GOLD11"]; const response = await fetch( `https://brapi.dev/api/quote/${etfs.join(",")}`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); console.log("Símbolo\t\tPreço\t\tVariação"); for (const etf of results) { console.log(`${etf.symbol}\t\tR$ ${etf.regularMarketPrice}\t${etf.regularMarketChangePercent}%`); } ``` ### Histórico de preços de ETF ```typescript const response = await fetch( "https://brapi.dev/api/quote/BOVA11?range=1y&interval=1d", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); const historico = results[0].historicalDataPrice; // Últimos 5 registros for (const h of historico.slice(-5)) { console.log(`${new Date(h.date * 1000).toLocaleDateString()}: R$ ${h.close}`); } ``` ### Calculadora de aporte mensal em ETF **Exemplo: R$ 500/mês por 24 meses em BOVA11 (preço \~R$ 120)** | Métrica | Valor | | ----------------- | --------- | | Aporte mensal | R$ 500 | | Cotas por mês | 4 cotas | | Valor efetivo/mês | R$ 480 | | Sobra mensal | R$ 20 | | **Após 24 meses** | | | Total de cotas | 96 cotas | | Total investido | R$ 11.520 | > Preços ilustrativos. Consulte a [API brapi.dev](https://brapi.dev) para cotações em tempo real. *** ## Estratégias de Investimento com ETFs ### 1. Buy and Hold com ETFs A estratégia mais simples: comprar e manter por longos períodos. **Exemplo de portfólio simples com R$ 10.000:** | ETF | Alocação | Valor | | --------- | -------- | ------------- | | BOVA11 | 50% | R$ 5.000 | | IVVB11 | 30% | R$ 3.000 | | GOLD11 | 20% | R$ 2.000 | | **Total** | **100%** | **R$ 10.000** | ### 2. Dollar Cost Averaging (DCA) Aportes regulares independente do preço: **Estratégia DCA para BOVA11:** * Aporte mensal: R$ 500 * Período: 36 meses * Total a investir: R$ 18.000 **Vantagens do DCA:** * Reduz impacto da volatilidade * Disciplina nos investimentos * Preço médio ao longo do tempo ### 3. Rebalanceamento Periódico Manter as proporções do portfólio ao longo do tempo: **Exemplo de rebalanceamento (patrimônio total: R$ 10.000):** | ETF | Alocação Alvo | Valor Atual | Atual (%) | Ajuste Necessário | | ------ | ------------- | ----------- | --------- | ----------------- | | BOVA11 | 50% | R$ 6.000 | 60% | Vender R$ 1.000 | | IVVB11 | 30% | R$ 2.500 | 25% | Comprar R$ 500 | | GOLD11 | 20% | R$ 1.500 | 15% | Comprar R$ 500 | > Rebalancear anualmente ou quando a diferença ultrapassar 5 pontos percentuais. *** ## Custos e Tributação de ETFs ### Custos de Investir em ETFs | Custo | Valor | Frequência | | --------------------- | ------------------ | ----------------- | | Taxa de administração | 0,03% - 0,60% a.a. | Embutida no preço | | Corretagem | R$ 0 (maioria) | Por operação | | Emolumentos da bolsa | \~0,03% | Por operação | | Custódia | R$ 0 (maioria) | Mensal | ### Tributação | Situação | Alíquota IR | | ---------------------------------- | ------------------------ | | Ganho de capital (venda com lucro) | 15% | | Day trade | 20% | | Isenção para vendas até R$ 20k/mês | **NÃO SE APLICA** a ETFs | **Importante:** Diferente de ações, ETFs **não têm isenção** para vendas abaixo de R$ 20.000/mês. Todo lucro é tributado em 15%. ### Como declarar ETFs no IR ``` BENS E DIREITOS Grupo: 07 - Fundos Código: 09 - Demais Fundos de Índice de Mercado (ETFs) Discriminação: "X cotas do ETF BOVA11 - iShares Ibovespa Fundo de Índice CNPJ: XX.XXX.XXX/XXXX-XX Custodiante: [Nome da Corretora] Custo de aquisição: R$ X.XXX,XX" ``` *** ## Vantagens e Desvantagens dos ETFs ### ✅ Vantagens 1. **Diversificação instantânea** - Uma cota = dezenas de ações 2. **Custos baixos** - Taxas menores que fundos tradicionais 3. **Simplicidade** - Não precisa escolher ações individualmente 4. **Liquidez** - Negociado em bolsa em tempo real 5. **Transparência** - Carteira divulgada diariamente 6. **Gestão passiva** - Menor risco de erro do gestor 7. **Acessibilidade** - Cotas baratas (R$ 10-150) ### ❌ Desvantagens 1. **Sem isenção de IR** - Todo lucro é tributado (15%) 2. **Não paga dividendos** - Reinveste automaticamente 3. **Tracking error** - Pequena diferença do índice 4. **Menos flexibilidade** - Não escolhe os ativos 5. **Concentração** - Alguns ETFs muito concentrados em poucos papéis *** ## ETFs vs Ações Individuais vs Fundos | Critério | ETFs | Ações | Fundos de Ações | | -------------- | ------------------- | --------------------- | ---------------- | | Diversificação | Alta | Baixa\* | Alta | | Custos | Muito baixos | Baixos | Altos | | Gestão | Passiva | Ativa (você) | Ativa | | Liquidez | Alta | Alta | Média | | Tributação | 15% sempre | 15% (isenção até 20k) | Come-cotas + 15% | | Dividendos | Reinvestidos | Pagos | Reinvestidos | | Controle | Médio | Total | Nenhum | | Ideal para | Iniciantes/Passivos | Experientes | Delegadores | \*Depende da quantidade de ações na carteira *** ## Montando um Portfólio de ETFs ### Portfólio Conservador ``` BOVA11: 40% (Brasil - Large Caps) IVVB11: 30% (EUA - S&P 500) GOLD11: 20% (Ouro - Proteção) IMAB11: 10% (Tesouro IPCA - Renda Fixa) ``` ### Portfólio Moderado ``` BOVA11: 35% (Brasil - Large Caps) SMAL11: 15% (Brasil - Small Caps) IVVB11: 30% (EUA - S&P 500) GOLD11: 10% (Ouro) HASH11: 10% (Criptomoedas) ``` ### Portfólio Arrojado ``` SMAL11: 30% (Brasil - Small Caps) BOVA11: 20% (Brasil - Large Caps) IVVB11: 25% (EUA - S&P 500) HASH11: 15% (Criptomoedas) XINA11: 10% (China) ``` ### Código para montar portfólio ```typescript const alocacao = { BOVA11: 0.35, SMAL11: 0.15, IVVB11: 0.30, GOLD11: 0.10, HASH11: 0.10, }; const valorTotal = 10000; const etfs = Object.keys(alocacao); const response = await fetch( `https://brapi.dev/api/quote/${etfs.join(",")}`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); let totalAlocado = 0; for (const etf of results) { const percentual = alocacao[etf.symbol as keyof typeof alocacao]; const valorAlvo = valorTotal * percentual; const cotas = Math.floor(valorAlvo / etf.regularMarketPrice); const valorReal = cotas * etf.regularMarketPrice; totalAlocado += valorReal; console.log(`${etf.symbol}: ${cotas} cotas = R$ ${valorReal.toFixed(2)}`); } console.log(`Total alocado: R$ ${totalAlocado.toFixed(2)}`); ``` *** ## Perguntas Frequentes sobre ETFs ### ETF paga dividendos? **Não diretamente.** Os dividendos recebidos são automaticamente reinvestidos no fundo, aumentando o valor da cota. Isso é bom para quem busca crescimento, mas ruim para quem quer renda passiva. ### Qual a diferença entre BOVA11 e BOVV11? Ambos replicam o Ibovespa, mas são de gestoras diferentes: * **BOVA11**: BlackRock (iShares) - mais líquido * **BOVV11**: Itaú - taxa similar ### Vale mais a pena ETF ou ações? Depende do seu perfil: * **ETF**: Melhor para iniciantes, investidores passivos, quem quer simplicidade * **Ações**: Melhor para quem quer controle total, isenção de IR até R$ 20k, dividendos ### Posso perder dinheiro com ETF? **Sim.** ETFs são renda variável e oscilam conforme o mercado. O BOVA11, por exemplo, pode cair 30-40% em crises. Invista apenas o que pode deixar por longos períodos. ### Quanto rende o BOVA11 por ano? Historicamente, o Ibovespa rende em média 10-15% ao ano em reais, mas com alta volatilidade. Alguns anos podem ter retornos de +30%, outros de -20%. *** ## Conclusão Os ETFs democratizaram o acesso ao mercado de capitais, permitindo que qualquer pessoa invista de forma diversificada com pouco dinheiro. Para quem está começando ou prefere uma abordagem passiva, ETFs como BOVA11 e IVVB11 são excelentes pontos de partida. **Principais pontos:** * ETFs oferecem diversificação instantânea e custos baixos * BOVA11 (Ibovespa) e IVVB11 (S\&P 500) são os mais populares * Aportes regulares (DCA) reduzem o risco de timing * Tributação de 15% sobre ganhos (sem isenção) * Ideal para estratégias de longo prazo Para acompanhar seus ETFs em tempo real e construir ferramentas de análise, a [API da brapi.dev](https://brapi.dev) oferece dados completos de todos os ETFs negociados na bolsa brasileira, com cotações em tempo real, históricos e muito mais. *** ## Recursos Adicionais * [Documentação da API brapi.dev](/docs) * [Como investir em ações - Guia completo](/blog/como-investir-em-acoes-guia-completo-iniciantes) * [O que é a Bolsa de Valores](/blog/o-que-e-bolsa-de-valores-como-funciona-b3) * [Análise Fundamentalista](/blog/analise-fundamentalista-o-que-e) # ETFs de Criptomoedas no Brasil 2026: HASH11, BITH11, QBTC11 e Mais URL: /blog/etfs-criptomoedas-b3-hash11-bith11-guia-2026.mdx Guia completo sobre ETFs de criptomoedas no Brasil. Compare HASH11, BITH11, QBTC11, ETHE11, DEFI11. Taxas, rentabilidade e como investir em cripto pela bolsa. *** searchable: true title: 'ETFs de Criptomoedas no Brasil 2026: HASH11, BITH11, QBTC11 e Mais' description: 'Guia completo sobre ETFs de criptomoedas no Brasil. Compare HASH11, BITH11, QBTC11, ETHE11, DEFI11. Taxas, rentabilidade e como investir em cripto pela bolsa.' date: '2026-01-01' keywords: 'etf bitcoin brasil, hash11, bith11, qbtc11, ethe11, defi11, etf criptomoedas brasil, hashdex, qr asset, etf cripto como investir, 2026' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Criptomoedas' readingTime: '16 min' tags: \['ETF', 'Criptomoedas', 'Bitcoin', 'Ethereum', 'Bolsa Brasileira', 'HASH11', 'Hashdex'] relatedPosts: \['bitcoin-brasil-como-investir-analise', 'ethereum-eth-guia-completo-brasil-2026', 'etfs-brasil-guia-completo-bova11-ivvb11', 'stablecoins-brasil-usdt-brz-drex-guia-2026'] featured: true expertise: 'Análise de produtos de investimento regulados pela CVM com exposição a criptoativos' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; O Brasil foi pioneiro mundial em **ETFs de criptomoedas**, lançando os primeiros produtos regulados antes mesmo dos Estados Unidos. Investir em cripto via bolsa brasileira é a forma mais simples e segura para quem prefere a estrutura do mercado tradicional. Este guia completo compara todos os ETFs de cripto disponíveis no Brasil, suas taxas, rentabilidades e estratégias de uso. ## Sumário 1. [Por que ETFs de Cripto?](#por-que-etfs-cripto) 2. [ETFs Disponíveis no Brasil](#etfs-disponiveis-b3) 3. [HASH11: Índice Multi-Cripto](#hash11) 4. [BITH11 e QBTC11: Bitcoin Puro](#bitcoin-etfs) 5. [ETHE11 e QETH11: Ethereum Puro](#ethereum-etfs) 6. [DEFI11: Tokens DeFi](#defi11) 7. [Comparativo Completo](#comparativo-completo) 8. [Como Investir](#como-investir) 9. [Tributação e IR](#tributacao-ir) 10. [ETF vs Compra Direta](#etf-vs-compra-direta) *** ## Por que ETFs de Cripto? ETFs (Exchange Traded Funds) de criptomoedas permitem investir em Bitcoin, Ethereum e outros criptoativos **sem precisar**: * Abrir conta em exchange de cripto * Gerenciar carteiras e chaves privadas * Preocupar-se com custódia e segurança * Aprender sobre blockchain ### Vantagens dos ETFs de Cripto | Vantagem | Explicação | | ------------------ | ------------------------------------ | | **Simplicidade** | Compra pelo home broker normal | | **Regulação** | CVM supervisionam | | **Custódia** | Gestora cuida dos ativos | | **Tributação** | Mesmo tratamento de ações | | **Diversificação** | HASH11 dá exposição a várias criptos | | **Liquidez** | Negocie em horário de pregão | | **Herança** | Inventário simplificado | ### Desvantagens | Desvantagem | Explicação | | ------------------------- | ----------------------------------- | | **Taxa de administração** | 0.3-1.3% a.a. | | **Sem staking** | Não recebe recompensas de validação | | **Horário limitado** | Só negocia das 10h às 17h | | **Prêmio/desconto** | Preço pode divergir do ativo | | **Sem custódia própria** | Não é "seu" Bitcoin de verdade | *** ## ETFs Disponíveis no Brasil ### Panorama Geral (Janeiro 2026) ### Índices Multi-Cripto | ETF | Descrição | Taxa | | ---------- | --------------------------- | ----- | | **HASH11** | Hashdex Nasdaq Crypto Index | 0.30% | | **CRPT11** | Empiricus Criptomoedas | 0.75% | ### Bitcoin | ETF | Descrição | Taxa | | ---------- | --------------- | ----- | | **BITH11** | Hashdex Bitcoin | 0.70% | | **QBTC11** | QR Bitcoin | 0.75% | | **BITI11** | Itaú Bitcoin | 0.70% | ### Ethereum | ETF | Descrição | Taxa | | ---------- | ---------------- | ----- | | **ETHE11** | Hashdex Ethereum | 0.70% | | **QETH11** | QR Ethereum | 0.75% | ### DeFi | ETF | Descrição | Taxa | | ---------- | ------------------ | ----- | | **DEFI11** | Hashdex DeFi Index | 0.50% | ### Novos (2024-2026) * Fundos Valour/DeFi Technologies (5 produtos) * Solana ETF (previsto 2026) ### Gestoras | Gestora | ETFs | Patrimônio | Histórico | | --------------------- | ------------------------------ | ---------------- | -------------------- | | **Hashdex** | HASH11, BITH11, ETHE11, DEFI11 | \~R$ 5 bilhões | Pioneira, desde 2021 | | **QR Asset** | QBTC11, QETH11 | \~R$ 1 bilhão | 2021 | | **Itaú Asset** | BITI11 | \~R$ 500 milhões | 2024 | | **DeFi Technologies** | 5 fundos | Novos | 2024-2026 | *** ## HASH11: Índice Multi-Cripto O **HASH11** é o ETF de cripto mais negociado do Brasil, acompanhando o **Nasdaq Crypto Index (NCI)**, um índice diversificado de criptomoedas. ### Características | Atributo | Valor | | ---------------------- | ------------------------- | | Ticker | HASH11 | | Gestora | Hashdex | | Índice | Nasdaq Crypto Index (NCI) | | Taxa de administração | 0.30% a.a. | | Patrimônio | \~R$ 3 bilhões | | Lote mínimo | 1 cota | | Preço médio (jan/2026) | \~R$ 55 | ### Composição do Índice (NCI) | Ativo | Peso | | ------------------ | ----- | | **Bitcoin (BTC)** | 62.5% | | **Ethereum (ETH)** | 28.3% | | Solana (SOL) | 3.2% | | Chainlink (LINK) | 1.5% | | Uniswap (UNI) | 1.2% | | Litecoin (LTC) | 0.9% | | Polygon (MATIC) | 0.8% | | Outros | 1.6% | O índice tem rebalanceamento trimestral, ponderação por market cap, e critérios de liquidez e custódia. Bitcoin domina (\~62%), mas há diversificação. ### Histórico de Rentabilidade | Período | HASH11 | Bitcoin | Diferença | | --------- | ------- | ------- | -------------------- | | 2021 | +27% | +60% | Lançado em abril | | 2022 | -66% | -65% | Bear market | | 2023 | +115% | +155% | Bull market | | 2026 | +85% | +100% | Consolidação | | Acumulado | \~+145% | \~+280% | Diversificação dilui | ### Quando Escolher HASH11 ✅ **Ideal para:** * Quem quer exposição diversificada a cripto * Investidores que não querem escolher moedas específicas * Quem acredita no mercado cripto como um todo * Alocação passiva em cripto ❌ **Não ideal para:** * Quem quer exposição máxima a Bitcoin * Quem quer fazer staking * Traders ativos *** ## BITH11 e QBTC11: Bitcoin Puro Para exposição 100% a Bitcoin, existem dois ETFs principais: ### Comparativo Bitcoin ETFs | Característica | BITH11 | QBTC11 | | --------------------- | --------------- | ---------------- | | Gestora | Hashdex | QR Asset | | Taxa de administração | 0.70% | 0.75% | | Patrimônio | \~R$ 1.5 bilhão | \~R$ 700 milhões | | Liquidez | Alta | Média | | Lote mínimo | 1 cota | 1 cota | | Preço médio | \~R$ 80 | \~R$ 15 | ### Por que BITH11 é Mais Popular 1. **Hashdex é marca mais conhecida** 2. **Maior liquidez** (spread menor) 3. **Maior patrimônio** (mais segurança institucional) 4. **Taxa levemente menor** (0.70% vs 0.75%) ### Calculadora: Impacto da Taxa de Administração **Exemplo:** Investimento de R$ 10.000 com valorização hipotética de 15% a.a. por 10 anos: | Opção | Taxa | Valor Final | Perda por Taxa | | ------------------ | ----- | ----------- | -------------- | | **BITH11** | 0.70% | R$ 37.218 | R$ 3.323 | | **QBTC11** | 0.75% | R$ 36.909 | R$ 3.632 | | **Bitcoin direto** | 0% | R$ 40.541 | - | Diferença BITH11 vs QBTC11 em 10 anos: \~R$ 309. A taxa mais baixa compensa no longo prazo! *** ## ETHE11 e QETH11: Ethereum Puro Para exposição 100% a Ethereum: ### Comparativo Ethereum ETFs | Característica | ETHE11 | QETH11 | | --------------------- | ---------------- | ---------------- | | Gestora | Hashdex | QR Asset | | Taxa de administração | 0.70% | 0.75% | | Patrimônio | \~R$ 500 milhões | \~R$ 200 milhões | | Liquidez | Média | Baixa | ### ETH via ETF vs Staking Direto ⚠️ **Importante**: ETFs de Ethereum **NÃO fazem staking**. Você perde \~4% a.a. de rendimento que teria com staking direto. **Exemplo:** Investimento de R$ 50.000 por 5 anos com valorização hipotética de 20% a.a.: | Opção | Resultado após 5 anos | | ------------------------- | --------------------- | | **ETHE11 (ETF)** | R$ 119.858 | | **Staking Direto (Lido)** | R$ 151.658 | | **Vantagem do staking** | +R$ 31.800 (+26.5%) | Staking direto rende mais (\~4% a.a. extra), mas exige conhecimento de carteiras e custódia, declaração de IR mais complexa, e aceitar risco de smart contract. *** ## DEFI11: Tokens DeFi O **DEFI11** oferece exposição ao setor de finanças descentralizadas através de um índice de tokens DeFi. ### Características | Atributo | Valor | | --------------------- | ----------------------- | | Ticker | DEFI11 | | Gestora | Hashdex | | Índice | CF DeFi Composite Index | | Taxa de administração | 0.50% a.a. | | Patrimônio | \~R$ 100 milhões | ### Composição | Token | Peso | Categoria | | -------------------- | ---- | --------------- | | **Uniswap (UNI)** | 25% | DEX líder | | **Aave (AAVE)** | 20% | Lending | | **Maker (MKR)** | 18% | Stablecoin DAI | | **Chainlink (LINK)** | 15% | Oracle | | **Compound (COMP)** | 10% | Lending | | **Synthetix (SNX)** | 7% | Derivativos | | **Curve (CRV)** | 5% | DEX stablecoins | ### Performance Histórica | Período | DEFI11 | Observação | | ------- | ------ | ------------------------- | | 2022 | -80% | Bear market devastou DeFi | | 2023 | +70% | Recuperação parcial | | 2026 | +60% | Mercado em alta | ⚠️ **Atenção**: DEFI11 é muito mais volátil que HASH11 ou BITH11. É para investidores com alta tolerância a risco. *** ## Comparativo Completo ### Tabela Resumo | Ticker | Foco | Taxa | Patrimônio | Liquidez | Volatilidade | | ---------- | ------------- | ----- | ---------- | ---------- | ------------ | | **HASH11** | Multi-cripto | 0.30% | R$ 3B | Muito Alta | Alta | | **BITH11** | Bitcoin 100% | 0.70% | R$ 1.5B | Alta | Alta | | **QBTC11** | Bitcoin 100% | 0.75% | R$ 700M | Média | Alta | | **ETHE11** | Ethereum 100% | 0.70% | R$ 500M | Média | Muito Alta | | **QETH11** | Ethereum 100% | 0.75% | R$ 200M | Baixa | Muito Alta | | **DEFI11** | Tokens DeFi | 0.50% | R$ 100M | Baixa | Extrema | ### Recomendação por Perfil | Perfil | ETF Recomendado | | --------------------- | ------------------------------------------ | | Iniciante/Conservador | HASH11 (diversificado, menor taxa) | | Bitcoin maximalista | BITH11 (100% BTC, boa liquidez) | | Aposta em Ethereum | ETHE11 (100% ETH) | | Alto risco/DeFi | DEFI11 (tokens DeFi, extrema volatilidade) | ### Correlação com Bitcoin | ETF | Correlação c/ BTC | Comentário | | ------------- | ----------------- | ------------------------------------ | | BITH11/QBTC11 | \~1.0 | Acompanha 100% | | HASH11 | \~0.95 | BTC domina o índice | | ETHE11/QETH11 | \~0.85 | ETH segue BTC com mais volatilidade | | DEFI11 | \~0.75 | Mais descorrelacionado, mais volátil | *** ## Como Investir ### Passo a Passo **1. Abra conta em corretora** * XP, Rico, Clear, BTG, Nubank, Inter, etc. * Maioria tem taxa zero para ETFs **2. Transfira recursos** * PIX ou TED para a conta da corretora * Valor mínimo: \~R$ 50 (1 cota HASH11) **3. Acesse o home broker** * Plataforma de negociação da corretora * Disponível via web ou app **4. Busque o ticker** * Digite HASH11, BITH11, etc. * Verifique se é o ativo correto **5. Escolha tipo de ordem** * Mercado (imediata) ou Limitada (preço específico) * Limitada evita surpresas em dias voláteis **6. Defina quantidade** * Número de cotas a comprar * Lote mínimo: 1 cota (fracionário) **7. Confirme a ordem** * Revise e execute * Horário: 10h às 17h (dias úteis) ETFs de cripto são VOLÁTEIS (oscilam 5-10% em dias normais). Não invista dinheiro que precisa no curto prazo. Diversifique: cripto deve ser parte da carteira, não tudo. ### Corretoras com Taxa Zero | Corretora | Taxa de Corretagem | Custódia | | ----------- | ------------------ | -------- | | Clear | Zero | Zero | | Rico | Zero | Zero | | XP | Zero (maioria) | Zero | | BTG Pactual | Zero | Zero | | Nubank | Zero | Zero | | Inter | Zero | Zero | *** ## Tributação e IR ETFs de cripto no Brasil seguem as **mesmas regras de ETFs de ações**, não de criptomoedas. ### Regras de Tributação **Alíquota:** 15% sobre o ganho de capital ETFs de cripto NÃO têm isenção de R$ 20.000/mês (diferente de ações e FIIs). Qualquer lucro é tributado a 15%. **Como declarar:** * DARF código 6015 (ETFs) * Pagar até último dia útil do mês seguinte * Informar em "Bens e Direitos" código 74 **Na declaração anual:** * Saldos em 31/12 em Bens e Direitos * ETFs NÃO têm isenção - declarar todos os ganhos ### Calculadora de IR **Exemplo de operação:** | Item | Valor | | ------------------- | ---------------------------------- | | Compra | 100 cotas x R$ 45,00 = R$ 4.500,00 | | Venda | 100 cotas x R$ 60,00 = R$ 6.000,00 | | Lucro bruto | R$ 1.500,00 | | **IR devido (15%)** | **R$ 225,00** | **Como pagar:** 1. Gere DARF código 6015 2. Valor: R$ 225,00 3. Pague até último dia útil do mês seguinte à venda Prejuízos podem ser compensados com lucros futuros em ETFs. Guarde as notas de corretagem para comprovação. ### ETF vs Cripto Direto: Tributação | Aspecto | ETF no Brasil | Cripto Direto | | -------------------- | ------------- | --------------------- | | Alíquota | 15% fixo | 15-22.5% progressivo | | Isenção | Não há | Vendas até R$ 35k/mês | | Declaração | Mais simples | Mais complexa | | Compensação prejuízo | Sim | Sim | | Código DARF | 6015 | 4600 | *** ## ETF vs Compra Direta ### Quando Escolher ETF ✅ **Escolha ETF se:** * Quer simplicidade máxima * Prefere ambiente regulado (CVM) * Não quer aprender sobre carteiras/exchanges * Investimento para longo prazo (menos operações) * Preocupação com herança/inventário * Valores menores (sem compensar aprender custódia) ### Quando Escolher Compra Direta ✅ **Escolha compra direta se:** * Quer fazer staking (Ethereum, Solana) * Quer isenção de R$ 35k/mês * Opera frequentemente (taxas menores) * Quer custódia própria ("not your keys, not your coins") * Quer acessar DeFi * Valores maiores (economia de taxa compensa) ### Comparativo Final | Critério | Vence | ETF | Direto | | --------------------- | ------- | -------------- | ----------------- | | Simplicidade | ETF | Muito simples | Exige aprendizado | | Taxa de administração | Direto | 0.3-0.75% a.a. | 0% | | Staking (ETH) | Direto | Não disponível | \~4% a.a. | | Isenção IR | Direto | Não há | Até R$ 35k/mês | | Custódia | Depende | Gestora cuida | Você cuida | | Horário negociação | Direto | 10h-17h | 24/7 | | Regulação | ETF | CVM | Menos regulado | | Herança/Inventário | ETF | Simplificado | Complexo | | Acesso a DeFi | Direto | Não | Sim | | Quantidade de criptos | Direto | Limitado | Milhares | ### Recomendação Final | Perfil | Recomendação | | -------------------------- | ------------------------------------------ | | **Investidor tradicional** | ETF (HASH11 ou BITH11) | | **Entusiasta de cripto** | Compra direta + staking | | **Melhor dos mundos** | ETF para base + cripto direto para staking | *** ## Monitorando ETFs com brapi.dev Você pode acompanhar os ETFs de cripto usando a API da brapi.dev: ```typescript // Monitorar cotações de ETFs de cripto const etfs = ["HASH11", "BITH11", "ETHE11", "QBTC11"]; for (const ticker of etfs) { const response = await fetch( `https://brapi.dev/api/quote/${ticker}`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); const etf = data.results[0]; console.log({ ticker, preco: etf.regularMarketPrice, variacao: etf.regularMarketChangePercent, }); } ``` Use a API brapi.dev para monitorar sua carteira de ETFs! Documentação: [https://brapi.dev/docs](https://brapi.dev/docs) *** ## Conclusão ETFs de criptomoedas no Brasil são a **porta de entrada mais simples** para o mercado cripto brasileiro. Com HASH11 liderando em liquidez e diversificação, e opções específicas para Bitcoin (BITH11) e Ethereum (ETHE11), há opções para todos os perfis. **Resumo das escolhas:** | Objetivo | ETF Recomendado | | -------------------------- | --------------- | | Diversificação passiva | HASH11 | | Exposição máxima a Bitcoin | BITH11 | | Aposta em Ethereum | ETHE11 | | Alto risco em DeFi | DEFI11 | **Próximos passos:** 1. [Entenda Bitcoin em profundidade](/blog/bitcoin-brasil-como-investir-analise) 2. [Aprenda sobre Ethereum e staking](/blog/ethereum-eth-guia-completo-brasil-2026) 3. [Como declarar cripto no IR](/blog/como-declarar-criptomoedas-imposto-renda-2026) *** *Dados atualizados para janeiro de 2026. Rentabilidades passadas não garantem resultados futuros. ETFs de cripto são investimentos de alto risco. Consulte a [API brapi.dev](https://brapi.dev) para cotações em tempo real.* # ETFs de Dividendos Brasil 2026: DIVO11, NDIV11, DIVD11 - Guia Completo URL: /blog/etfs-dividendos-brasil-divo11-ndiv11-divd11-2026.mdx Compare os melhores ETFs de dividendos do Brasil: DIVO11, NDIV11, DIVD11 e SPYI11. Descubra qual rende mais, taxas, como funcionam e qual escolher. *** searchable: true title: 'ETFs de Dividendos Brasil 2026: DIVO11, NDIV11, DIVD11 - Guia Completo' description: 'Compare os melhores ETFs de dividendos do Brasil: DIVO11, NDIV11, DIVD11 e SPYI11. Descubra qual rende mais, taxas, como funcionam e qual escolher.' date: '2026-01-01' keywords: 'etf dividendos, divo11, ndiv11, divd11, spyi11, etf renda passiva, etf dividend yield, idiv, etf que paga dividendos, melhor etf dividendos brasil, 2026' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'ETFs e Fundos' readingTime: '18 min' tags: \['ETF', 'Dividendos', 'DIVO11', 'NDIV11', 'DIVD11', 'Renda Passiva', 'IDIV'] relatedPosts: \['etfs-brasil-guia-completo-bova11-ivvb11', 'dividendos-como-construir-renda-passiva', 'melhores-acoes-pagadoras-dividendos-2026', 'acoes-vs-fiis-comparativo-qual-investir-2026', 'fundos-imobiliarios-fiis-guia-completo-iniciantes'] featured: true expertise: 'Análise comparativa de ETFs focados em dividendos por especialistas em mercado financeiro brasileiro.' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; ETFs de dividendos se tornaram uma das formas mais práticas de construir **renda passiva** no Brasil. Em vez de escolher ações individualmente, você investe em uma cesta diversificada de empresas pagadoras de dividendos com apenas uma ordem. Mas qual ETF de dividendos escolher? **DIVO11 acumula**, **DIVD11 distribui**, **NDIV11 é smart beta**... as diferenças podem ser confusas. Neste guia completo, vamos comparar os principais ETFs de dividendos do mercado brasileiro para 2026. ## Resumo: Comparativo dos ETFs de Dividendos | ETF | Índice | Taxa Adm. | Distribui Dividendos? | DY Estimado | Foco | | ---------- | -------------- | --------- | --------------------- | ----------- | ------------------------------ | | **DIVO11** | IDIV | 0,50% | Não (acumula) | - | Maiores DY da bolsa brasileira | | **DIVD11** | IDIV | 0,50% | Sim (mensal) | \~8% | Renda mensal | | **NDIV11** | Smart IDIV | 0,50% | Sim (mensal) | \~8% | Smart beta + renda | | **SPYI11** | US High Income | 0,83% | Sim (mensal) | \~13% | Ações EUA + covered calls | ## O Que São ETFs de Dividendos? ETFs de dividendos são **fundos de índice** que investem em empresas com histórico de pagamento de dividendos. Eles replicam índices como o **IDIV** (Índice Dividendos da bolsa brasileira) ou utilizam estratégias quantitativas para selecionar boas pagadoras. ### Por Que Investir em ETFs de Dividendos? | Vantagem | Descrição | | ------------------- | --------------------------------------------- | | **Diversificação** | Uma cota = dezenas de boas pagadoras | | **Praticidade** | Não precisa analisar ações individualmente | | **Rebalanceamento** | Índice ajusta automaticamente a carteira | | **Custos baixos** | Taxa de 0,50% vs 1-2% de fundos ativos | | **Renda passiva** | Alguns ETFs distribuem dividendos mensalmente | ### Dois Modelos: Acumulação vs Distribuição A grande diferença entre ETFs de dividendos está no que fazem com os proventos: **Acumulação (ex: DIVO11):** * Reinveste automaticamente os dividendos * Valor da cota aumenta * Melhor para fase de acumulação * Eficiência fiscal (posterga IR) **Distribuição (ex: DIVD11, NDIV11):** * Paga dividendos diretamente ao cotista * Renda mensal na conta * Melhor para quem precisa de renda * Tributação sobre dividendos (quando houver) *** ## DIVO11: O ETF IDIV Original O **DIVO11** é o ETF de dividendos mais antigo e conhecido do Brasil. Gerido pela Itaú Asset (IT Now), replica o índice **IDIV** da bolsa brasileira. ### Características do DIVO11 | Informação | Valor | | ------------------------- | --------------------------- | | **Nome completo** | IT Now IDIV Fundo de Índice | | **Código** | DIVO11 | | **Gestor** | Itaú Asset Management | | **Índice** | IDIV (Índice Dividendos) | | **Taxa de administração** | 0,50% a.a. | | **Distribui dividendos?** | Não (acumula) | | **Lançamento** | 2012 | ### Como Funciona o Índice IDIV? O IDIV seleciona as ações com **maiores dividend yields** da bolsa brasileira, usando critérios como: 1. **Dividend yield** acima da mediana do mercado 2. **Liquidez mínima** para garantir negociação 3. **Consistência** no pagamento de dividendos 4. **Ponderação** por DY e não por market cap **Composição típica do IDIV (top 10):** | Ação | Setor | Peso Aproximado | | ------ | ---------- | --------------- | | PETR4 | Petróleo | \~8% | | BBAS3 | Bancos | \~7% | | VALE3 | Mineração | \~6% | | TAEE11 | Energia | \~5% | | CMIG4 | Energia | \~5% | | ITSA4 | Holdings | \~4% | | CPLE6 | Energia | \~4% | | BBSE3 | Seguros | \~4% | | ELET3 | Energia | \~3% | | CSMG3 | Saneamento | \~3% | ### Vantagens do DIVO11 * **Histórico longo** - Desde 2012, track record comprovado * **Alta liquidez** - Fácil comprar e vender * **Eficiência fiscal** - Reinvestimento automático posterga IR * **Diversificação** - \~30 empresas pagadoras ### Desvantagens do DIVO11 * **Não paga dividendos** - Ruim para quem quer renda * **Concentração setorial** - Muito peso em energia e bancos * **Value traps** - Pode incluir empresas com DY alto por queda de preço *** ## DIVD11: O ETF que Distribui Dividendos O **DIVD11** é a versão "renda" do DIVO11. Replica o mesmo índice IDIV, mas **distribui os dividendos mensalmente** aos cotistas. ### Características do DIVD11 | Informação | Valor | | ------------------------- | ---------------------------- | | **Nome completo** | IT Now IDIV Renda Dividendos | | **Código** | DIVD11 | | **Gestor** | Itaú Asset Management | | **Índice** | IDIV (Índice Dividendos) | | **Taxa de administração** | 0,50% a.a. | | **Distribui dividendos?** | Sim (mensal) | | **Dividend yield** | \~8% a.a. | | **Lançamento** | 2023 | ### Como Funcionam as Distribuições? O DIVD11 recebe os dividendos das empresas do IDIV e os distribui mensalmente aos cotistas: ``` Mês de Referência → Data Com → Pagamento Ex: Janeiro → 28/jan → 05/fev ``` **Fluxo de distribuição:** 1. Empresas do IDIV pagam dividendos ao fundo 2. Fundo acumula durante o mês 3. Último dia útil: data de corte (data com) 4. Primeiro dias úteis do mês seguinte: pagamento ### Dividend Yield Histórico O DIVD11 tem entregado dividend yields entre **7% e 9% ao ano**, dependendo dos dividendos pagos pelas empresas do IDIV. | Mês (2026) | Dividendo/Cota | DY Mensal | | ---------- | -------------- | --------- | | Janeiro | R$ 0,42 | 0,70% | | Fevereiro | R$ 0,38 | 0,63% | | Março | R$ 0,55 | 0,91% | | Abril | R$ 0,48 | 0,80% | | Maio | R$ 0,51 | 0,85% | | **Média** | **R$ 0,47** | **0,78%** | *Valores ilustrativos para demonstração* ### Vantagens do DIVD11 * **Renda mensal** - Dividendos direto na conta * **Mesmo índice IDIV** - Diversificação comprovada * **Praticidade** - Uma cota = renda de 30 empresas * **Previsibilidade** - Pagamentos mensais regulares ### Desvantagens do DIVD11 * **Tributação** - Dividendos podem ser tributados (dependendo da legislação) * **Menor eficiência** - Reinvestir manualmente tem custos * **Volatilidade do yield** - Dividendo varia mês a mês *** ## NDIV11: O ETF Smart Beta de Dividendos O **NDIV11** é o ETF de dividendos do Nubank (Nu Asset). Usa uma estratégia **smart beta** que vai além do simples dividend yield. ### Características do NDIV11 | Informação | Valor | | ------------------------- | ------------------------------ | | **Nome completo** | Nu Renda Ibov Smart Dividendos | | **Código** | NDIV11 | | **Gestor** | Nu Asset Management | | **Índice** | Ibov Smart Dividendos | | **Taxa de administração** | 0,50% a.a. | | **Distribui dividendos?** | Sim (mensal) | | **Dividend yield** | \~8% a.a. | | **Lançamento** | 2023 | ### O Que é Smart Beta? Smart beta combina gestão passiva (segue um índice) com critérios quantitativos para melhorar o retorno ajustado ao risco. **Critérios do NDIV11:** | Fator | Descrição | | ---------------------- | --------------------------------- | | **Dividend yield** | Prioriza alto yield sustentável | | **Qualidade** | Empresas com boa saúde financeira | | **Momentum** | Tendência de valorização | | **Baixa volatilidade** | Menor risco que o mercado | | **Consistência** | Histórico de pagamentos | ### Diferença: NDIV11 vs DIVD11 | Aspecto | NDIV11 | DIVD11 | | --------------- | ------------------------- | ------------ | | **Estratégia** | Smart beta | Passiva pura | | **Critérios** | DY + Qualidade + Momentum | Apenas DY | | **Composição** | Mais seletiva | Replica IDIV | | **Gestor** | Nu Asset | Itaú Asset | | **Value traps** | Filtradas | Podem entrar | ### Vantagens do NDIV11 * **Qualidade** - Filtra empresas com fundamentos ruins * **Menor risco** - Critérios reduzem volatilidade * **Renda mensal** - Distribui dividendos * **Modernidade** - Estratégia mais sofisticada ### Desvantagens do NDIV11 * **Histórico curto** - Lançado em 2023 * **Menor liquidez** - Menos negociado que DIVO11 * **Complexidade** - Metodologia menos transparente *** ## SPYI11: Dividendos de Ações Americanas O **SPYI11** é diferente: investe em **ações americanas** e usa estratégia de **covered calls** para gerar renda extra. ### Características do SPYI11 | Informação | Valor | | ------------------------- | -------------------------- | | **Nome completo** | Buena Vista US High Income | | **Código** | SPYI11 | | **Gestor** | Buena Vista Capital | | **Estratégia** | S\&P 500 + Covered Calls | | **Taxa de administração** | 0,83% a.a. | | **Distribui dividendos?** | Sim (mensal) | | **Dividend yield** | \~13% a.a. | | **Exposição cambial** | Sim (dólar) | ### Como Funciona o SPYI11? O SPYI11 combina duas fontes de renda: 1. **Dividendos do S\&P 500** - Empresas americanas pagam dividendos 2. **Prêmio de opções** - Venda de calls cobertas gera renda adicional ``` Rendimento = Dividendos das ações + Prêmio das opções vendidas ``` **Estratégia de Covered Call:** | Componente | Descrição | | ----------------- | ------------------------------- | | **Compra ações** | S\&P 500 ou similar | | **Vende calls** | Opções de compra sobre as ações | | **Recebe prêmio** | Renda adicional mensal | | **Trade-off** | Limita upside em altas fortes | ### Por Que o Yield é Tão Alto? O yield de \~13% do SPYI11 vem principalmente do **prêmio das opções**, não apenas dos dividendos das empresas: | Fonte | Contribuição | | ------------------------ | -------------- | | Dividendos das ações | \~2% a.a. | | Prêmio das covered calls | \~11% a.a. | | **Total** | **\~13% a.a.** | ### Vantagens do SPYI11 * **Alto yield** - \~13% ao ano * **Diversificação geográfica** - Exposição aos EUA * **Proteção cambial** - Dólar protege em crises locais * **Renda mensal** - Pagamentos regulares ### Desvantagens do SPYI11 * **Taxa mais alta** - 0,83% vs 0,50% dos outros * **Upside limitado** - Covered calls limitam ganhos em alta * **Risco cambial** - Dólar fraco reduz retorno em reais * **Complexidade** - Estratégia de opções *** ## Comparativo Detalhado: Qual ETF Escolher? ### Performance Histórica Para comparar ETFs de dividendos em tempo real: ```typescript const etfs = ["DIVO11", "DIVD11", "NDIV11", "SPYI11"]; const response = await fetch( `https://brapi.dev/api/quote/${etfs.join(",")}`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); for (const etf of results) { console.log(`${etf.symbol}: R$ ${etf.regularMarketPrice}`); } ``` ### Tabela Comparativa Completa | Critério | DIVO11 | DIVD11 | NDIV11 | SPYI11 | | ---------------- | ---------- | ------------ | ----------------- | ------------- | | **Taxa adm.** | 0,50% | 0,50% | 0,50% | 0,83% | | **Distribui?** | Não | Sim | Sim | Sim | | **DY estimado** | - | \~8% | \~8% | \~13% | | **Índice** | IDIV | IDIV | Smart Beta | S\&P 500 | | **Exposição** | Brasil | Brasil | Brasil | EUA | | **Volatilidade** | Média | Média | Média-Baixa | Alta (câmbio) | | **Liquidez** | Alta | Média | Média | Média | | **Melhor para** | Acumulação | Renda Brasil | Renda + qualidade | Renda + dólar | ### Quando Escolher Cada ETF **Escolha DIVO11 se:** * Está na fase de acumulação * Não precisa de renda agora * Quer reinvestir automaticamente * Prefere eficiência fiscal **Escolha DIVD11 se:** * Quer renda mensal em reais * Prefere seguir o IDIV tradicional * Busca simplicidade * Gestora Itaú inspira confiança **Escolha NDIV11 se:** * Quer renda mensal com qualidade * Valoriza filtros de qualidade * Aceita metodologia smart beta * Busca menor volatilidade **Escolha SPYI11 se:** * Quer alto yield (\~13%) * Busca diversificação internacional * Aceita risco cambial * Entende estratégia de opções *** ## Calculadora: Quanto Rende em Dividendos? Para calcular a renda mensal de um ETF de dividendos, use: ``` Renda mensal = (Valor investido × DY anual) ÷ 12 ``` **Exemplo:** R$ 50.000 em DIVD11 (DY 8%): * Renda anual: R$ 50.000 × 8% = R$ 4.000 * Renda mensal: R$ 4.000 ÷ 12 = **R$ 333/mês** ### Tabela de Renda por Valor Investido | Valor Investido | DIVD11 (8%) | NDIV11 (8%) | SPYI11 (13%) | | --------------- | ------------ | ------------ | ------------ | | R$ 10.000 | R$ 67/mês | R$ 67/mês | R$ 108/mês | | R$ 25.000 | R$ 167/mês | R$ 167/mês | R$ 271/mês | | R$ 50.000 | R$ 333/mês | R$ 333/mês | R$ 542/mês | | R$ 100.000 | R$ 667/mês | R$ 667/mês | R$ 1.083/mês | | R$ 250.000 | R$ 1.667/mês | R$ 1.667/mês | R$ 2.708/mês | | R$ 500.000 | R$ 3.333/mês | R$ 3.333/mês | R$ 5.417/mês | *Valores estimados baseados em dividend yields históricos. Rendimentos passados não garantem rendimentos futuros.* *** ## Estratégias de Investimento em ETFs de Dividendos ### 1. Acumulação com DIVO11 Para fase de construção de patrimônio: **Exemplo: R$ 1.000/mês por 10 anos, crescimento estimado de 10% a.a.:** | Métrica | Valor | | ----------------------- | ---------- | | Aporte mensal | R$ 1.000 | | Prazo | 10 anos | | Total aportado | R$ 120.000 | | Patrimônio estimado | R$ 204.845 | | Ganho (juros compostos) | R$ 84.845 | > O DIVO11 reinveste automaticamente os dividendos, potencializando os juros compostos na fase de acumulação. ### 2. Renda Passiva com DIVD11/NDIV11 Para quem já tem patrimônio e quer renda: **Exemplo: R$ 500.000 em DIVD11 (DY 8% a.a.):** | Ano | Renda Anual | Renda Mensal | | --- | ----------- | ------------ | | 1 | R$ 40.000 | R$ 3.333 | | 2 | R$ 40.000 | R$ 3.333 | | 3 | R$ 40.000 | R$ 3.333 | | 5 | R$ 40.000 | R$ 3.333 | | 10 | R$ 40.000 | R$ 3.333 | > O yield pode variar ano a ano. Valores estimados para fins ilustrativos. ### 3. Estratégia Híbrida: Brasil + EUA Combinar ETFs brasileiros e americanos: **Exemplo de portfólio com R$ 100.000:** | ETF | Alocação | Valor | Objetivo | | --------- | -------- | -------------- | ----------------- | | DIVO11 | 30% | R$ 30.000 | Acumulação Brasil | | DIVD11 | 30% | R$ 30.000 | Renda Brasil | | SPYI11 | 40% | R$ 40.000 | Renda EUA + Hedge | | **Total** | **100%** | **R$ 100.000** | - | **DY ponderado estimado:** (30% × 0%) + (30% × 8%) + (40% × 13%) = **7,6% a.a.** **Renda anual estimada:** R$ 7.600/ano = **R$ 633/mês** *** ## Tributação de ETFs de Dividendos ### Imposto sobre Dividendos A tributação de dividendos de ETFs é diferente de ações: | Situação | Ações | ETFs | | -------------------- | ------------------------ | ---------------------- | | **Dividendos** | Isentos | Podem ser tributados\* | | **Ganho de capital** | 15% (isenção até R$ 20k) | 15% (sem isenção) | | **Day trade** | 20% | 20% | \*Nota: A tributação de dividendos de ETFs depende da estrutura do fundo e pode mudar conforme legislação. ### Como Declarar ETFs no Imposto de Renda ``` BENS E DIREITOS Grupo: 07 - Fundos Código: 09 - Demais Fundos de Índice de Mercado (ETFs) Discriminação: "X cotas do ETF DIVD11 - IT Now IDIV Renda Dividendos CNPJ: XX.XXX.XXX/XXXX-XX Custodiante: [Nome da Corretora] Custo de aquisição: R$ X.XXX,XX" RENDIMENTOS - Dividendos recebidos: declarar conforme informe de rendimentos - Ganhos de capital: calcular e pagar DARF até último dia útil do mês seguinte ``` *** ## ETFs de Dividendos vs Ações de Dividendos ### Quando Escolher ETFs? | Critério | ETFs | Ações | | ----------------------- | ------------------ | ---------------------- | | **Tempo disponível** | Pouco | Muito | | **Conhecimento** | Iniciante | Avançado | | **Diversificação** | Automática | Manual | | **Rebalanceamento** | Automático | Manual | | **Custos** | Taxa + emolumentos | Corretagem (se houver) | | **Tributação** | Menos favorável | Mais favorável | | **Isenção R$ 20k** | Não | Sim | | **Escolha de empresas** | Não | Sim | ### Carteira de Ações vs ETF: Simulação **Investimento: R$ 30.000** **Opção 1: Carteira própria (6 ações de dividendos)** | Ação | Alocação | Valor | | ------ | -------- | -------- | | TAEE11 | 16,7% | R$ 5.000 | | BBAS3 | 16,7% | R$ 5.000 | | ITSA4 | 16,7% | R$ 5.000 | | CPLE6 | 16,7% | R$ 5.000 | | CMIG4 | 16,7% | R$ 5.000 | | BBSE3 | 16,7% | R$ 5.000 | * 6 ordens de compra * Rebalanceamento manual * Isenção IR até R$ 20k/mês em vendas **Opção 2: ETF DIVD11** * 1 ordem de compra (R$ 30.000 em DIVD11) * Rebalanceamento automático * Diversificação em \~30 empresas * Sem isenção de IR *** ## Monitorando ETFs de Dividendos com brapi.dev ### Dashboard de Acompanhamento ```typescript const etfs = ["DIVO11", "DIVD11", "NDIV11", "SPYI11"]; const response = await fetch( `https://brapi.dev/api/quote/${etfs.join(",")}`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); console.log("ETF\t\tPreço\t\tVariação"); for (const etf of results) { const sinal = etf.regularMarketChangePercent > 0 ? "+" : ""; console.log( `${etf.symbol}\t\tR$ ${etf.regularMarketPrice}\t${sinal}${etf.regularMarketChangePercent}%` ); } ``` ### Alertas de Preço para Compra Configure alertas para comprar ETFs quando atingirem preços atrativos: ```typescript const precosAlvo = { DIVO11: 120.0, DIVD11: 62.0, NDIV11: 125.0, SPYI11: 118.0, }; const etfs = Object.keys(precosAlvo); const response = await fetch( `https://brapi.dev/api/quote/${etfs.join(",")}`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); for (const etf of results) { const alvo = precosAlvo[etf.symbol as keyof typeof precosAlvo]; if (etf.regularMarketPrice <= alvo) { console.log(`OPORTUNIDADE: ${etf.symbol} a R$ ${etf.regularMarketPrice}`); } } ``` *** ## Perguntas Frequentes (FAQ) ### Qual o melhor ETF de dividendos do Brasil? Depende do seu objetivo: * **Acumulação**: DIVO11 (reinveste automaticamente) * **Renda mensal Brasil**: DIVD11 ou NDIV11 * **Alto yield + dólar**: SPYI11 ### ETF de dividendos paga todo mês? DIVD11, NDIV11 e SPYI11 pagam mensalmente. DIVO11 não distribui (acumula). ### Vale mais a pena ETF ou ações de dividendos? ETFs são mais práticos e diversificados. Ações oferecem isenção de IR até R$ 20k/mês e você escolhe as empresas. Para a maioria, ETFs são mais adequados. ### O dividend yield do SPYI11 é sustentável? O yield de \~13% inclui prêmio de opções, não apenas dividendos. A estratégia de covered calls limita ganhos em alta forte, mas é sustentável em mercados laterais ou moderadamente altistas. ### Posso combinar vários ETFs de dividendos? Sim! Uma estratégia comum é combinar DIVO11 (acumulação) + DIVD11/NDIV11 (renda Brasil) + SPYI11 (renda + dólar). ### Quanto preciso para viver de dividendos de ETFs? Para renda de R$ 5.000/mês com ETFs de \~8% de DY, você precisa de aproximadamente R$ 750.000 investidos. *** ## Conclusão ETFs de dividendos democratizaram o acesso à renda passiva no Brasil. Com apenas uma ordem, você investe em dezenas de empresas pagadoras de dividendos. **Resumo das escolhas:** | Se você quer... | Escolha | | --------------------- | ----------------- | | Acumular patrimônio | DIVO11 | | Renda mensal em reais | DIVD11 ou NDIV11 | | Renda + qualidade | NDIV11 | | Alto yield + dólar | SPYI11 | | Combinar tudo | Portfólio híbrido | Para acompanhar seus ETFs de dividendos em tempo real, a [API da brapi.dev](https://brapi.dev) oferece cotações, históricos e dados completos de todos os ETFs negociados na bolsa brasileira. *** ## Recursos Adicionais * [ETFs Brasil: Guia Completo BOVA11, IVVB11](/blog/etfs-brasil-guia-completo-bova11-ivvb11) * [Dividendos: Como Construir Renda Passiva](/blog/dividendos-como-construir-renda-passiva) * [Melhores Ações Pagadoras de Dividendos 2026](/blog/melhores-acoes-pagadoras-dividendos-2026) * [Ações vs FIIs: Qual Investir?](/blog/acoes-vs-fiis-comparativo-qual-investir-2026) * [Documentação da API brapi.dev](/docs) # ETFs Irlandeses para Brasileiros em 2026: VWRA, SWRD e EIMI URL: /blog/etfs-irlandeses-brasileiros-vwra-swrd-eimi.mdx Entenda ETFs irlandeses para brasileiros: VWRA, SWRD, EIMI, UCITS, acumulação, custos, imposto no exterior e quando fazem sentido em 2026. *** searchable: true title: 'ETFs Irlandeses para Brasileiros em 2026: VWRA, SWRD e EIMI' description: 'Entenda ETFs irlandeses para brasileiros: VWRA, SWRD, EIMI, UCITS, acumulação, custos, imposto no exterior e quando fazem sentido em 2026.' date: '2026-01-01' keywords: 'ETF irlandês, VWRA, SWRD, EIMI, ETF UCITS, investir no exterior, ETF acumulação, imposto ETF exterior, Bogleheads Brasil, Interactive Brokers' author: 'Equipe brapi.dev' category: 'Estratégias de Investimento' subcategory: 'ETFs Internacionais' readingTime: '15 min' tags: \['ETFs', 'ETF Irlandês', 'VWRA', 'SWRD', 'EIMI', 'Investimento Exterior', 'Bogleheads', 'Interactive Brokers', 'UCITS'] relatedPosts: \['guia-bogleheads-brasil-investimento-passivo-etfs', 'como-construir-carteira-investimentos-diversificada-brapi', 'fundos-imobiliarios-fiis-guia-completo-iniciantes', 'etfs-brasil-guia-completo-bova11-ivvb11'] featured: true expertise: 'ETFs internacionais domiciliados na Irlanda otimizados para investidores brasileiros' lastReviewed: '2026-04-23' faqSchema: * question: 'ETF irlandês ainda vale a pena para brasileiros em 2026?' answer: 'Pode valer para quem busca diversificação global, ETFs de acumulação, custos baixos e exposição fora do Brasil. A decisão precisa considerar câmbio, corretora internacional, declaração de IR e a tributação de aplicações financeiras no exterior pela Lei 14.754/2023.' * question: 'VWRA ou SWRD + EIMI?' answer: 'VWRA é mais simples porque reúne mercados desenvolvidos e emergentes em um ETF. SWRD + EIMI pode reduzir custo e dar controle de alocação, mas exige rebalanceamento.' * question: 'Existe isenção de R$ 35 mil por mês para ETF no exterior?' answer: 'Para aplicações financeiras no exterior, como ETFs, a regra foi alterada pela Lei 14.754/2023. Rendimentos e ganhos são apurados na declaração anual e tributados em regra a 15%, sem a antiga lógica de isenção mensal aplicada por muitos investidores antes da mudança.' *** import { Authors, Author } from '~/components/Authors'; > ETFs irlandeses como **VWRA, SWRD e EIMI** continuam populares entre brasileiros que seguem uma estratégia global passiva. O principal cuidado em 2026 é não usar regra tributária antiga: investimentos financeiros no exterior passaram a seguir a Lei 14.754/2023. ## Resumo Direto ETFs irlandeses fazem sentido quando você quer investir no mundo inteiro com baixo custo, fora da jurisdição brasileira e sem comprar dezenas de ativos. Eles são negociados em bolsas como Londres, Xetra e Euronext, normalmente por corretoras internacionais. | Estratégia | Exemplo | Vantagem | Ponto de atenção | | ------------- | ------------ | ---------------------- | -------------------- | | Um ETF global | VWRA | Simplicidade máxima | Custo um pouco maior | | Dois ETFs | SWRD + EIMI | Menor custo e controle | Rebalanceamento | | ETF EUA | CSPX ou VUAA | Exposição ao S\&P 500 | Concentração nos EUA | Para a maioria dos investidores passivos, a escolha real é entre **simplicidade** e **otimização de custo**. ## Por Que a Irlanda Aparece Tanto ETFs UCITS domiciliados na Irlanda são usados por investidores de vários países porque combinam regulação europeia, ampla oferta de fundos e estrutura fiscal eficiente para investir em ações globais. O caso mais citado envolve ações americanas. Um ETF domiciliado nos EUA geralmente sofre retenção de 30% sobre dividendos pagos por empresas americanas a investidores estrangeiros. Um ETF irlandês que investe nessas mesmas ações costuma se beneficiar do tratado EUA-Irlanda, com retenção de 15% dentro do fundo. Para o investidor brasileiro, isso melhora a eficiência antes mesmo de olhar o imposto no Brasil. Outro ponto é sucessório. ETFs domiciliados nos EUA podem expor o investidor não residente ao estate tax americano acima de certos limites. ETFs irlandeses reduzem essa exposição por não serem ativos domiciliados nos EUA, mas planejamento sucessório internacional deve ser validado com especialista. ## ETFs de Acumulação vs Distribuição Nos ETFs de acumulação, os dividendos recebidos pelo fundo são reinvestidos internamente. Nos ETFs de distribuição, os dividendos são pagos ao cotista. | Tipo | Como funciona | Quando costuma ser usado | | ------------ | -------------------------------- | ------------------------------------- | | Accumulating | Dividendos reinvestidos no fundo | Fase de acumulação patrimonial | | Distributing | Dividendos pagos ao investidor | Fase de renda ou necessidade de fluxo | Brasileiros costumam preferir ETFs de acumulação porque simplificam a estratégia de longo prazo. Ainda assim, a tributação brasileira olha os rendimentos de aplicações financeiras no exterior conforme a legislação vigente, então não trate acumulação como sinônimo de "sem imposto para sempre". ## Principais ETFs Irlandeses | ETF | Índice | Exposição | OCF/TER aproximado | Uso comum | | ---- | ------------------------- | -------------------------- | ------------------ | ----------------------------------- | | VWRA | FTSE All-World | Desenvolvidos + emergentes | 0,19% | Carteira global simples | | SWRD | MSCI World | Países desenvolvidos | 0,12% | Núcleo de baixo custo | | EIMI | MSCI Emerging Markets IMI | Emergentes | 0,18% | Complemento para emergentes | | CSPX | S\&P 500 | EUA large caps | 0,07% | Exposição concentrada em EUA | | VUAA | S\&P 500 | EUA large caps | 0,07% | Alternativa acumuladora ao S\&P 500 | Taxas mudam. Antes de comprar, confira o factsheet oficial do fundo e a classe correta negociada na bolsa escolhida. ## VWRA: Um ETF Para o Mundo Todo VWRA é a versão acumuladora do Vanguard FTSE All-World UCITS ETF negociada em dólar na London Stock Exchange. Ele cobre ações de mercados desenvolvidos e emergentes em uma única posição. É uma escolha popular porque reduz decisões. Você não precisa escolher percentual de emergentes, rebalancear entre regiões ou combinar famílias de índices. O custo dessa simplicidade é aceitar a alocação do índice e uma taxa um pouco maior do que combinações otimizadas. ## SWRD + EIMI: Menor Custo com Mais Trabalho SWRD replica o MSCI World, cobrindo países desenvolvidos. EIMI complementa com mercados emergentes. A combinação permite montar algo parecido com um ETF global, mas com custo médio menor. Um exemplo simples seria 85% SWRD e 15% EIMI. Essa proporção não é fixa; ela apenas aproxima a participação de emergentes em uma carteira global. O investidor precisa rebalancear com novos aportes ou revisões periódicas. ```text Taxa ponderada aproximada: 85% * 0,12% + 15% * 0,18% = 0,129% ao ano ``` ## Cuidado ao Misturar FTSE e MSCI FTSE e MSCI classificam alguns países de forma diferente. O exemplo clássico é a Coreia do Sul: em certas metodologias ela pode aparecer como desenvolvida ou emergente. Se você mistura ETFs de famílias diferentes, pode criar duplicidade ou lacuna sem perceber. B[FTSE] A --> C[MSCI] B --> D[VWRA / VHVE / VFEA] C --> E[SWRD / IWDA / EIMI] D --> F[Evite misturar sem checar países] E --> F `} /> ## Onde Comprar ETFs Irlandeses O caminho mais usado por brasileiros é abrir conta em uma corretora internacional que dê acesso a bolsas europeias, como Interactive Brokers. Depois, o investidor envia recursos por remessa internacional, converte moeda e compra o ETF na bolsa escolhida. A escolha da bolsa importa por moeda de negociação, liquidez e spread. Para muitos ETFs, a London Stock Exchange em USD é prática para brasileiros que já acompanham patrimônio em dólar. Xetra em EUR também é comum. ## Custos Reais da Estratégia O custo total não é só a taxa do ETF. Você deve somar spread de câmbio, IOF, corretagem internacional, spread de negociação e eventual custo de manter conta. | Custo | Quando aparece | | ---------------- | ------------------------------ | | Câmbio e remessa | Entrada e saída de recursos | | Corretagem | Compra e venda do ETF | | Spread bid/ask | Na execução da ordem | | OCF/TER | Embutido diariamente no fundo | | Tributação | Na declaração anual brasileira | Para aportes muito pequenos, o custo de remessa e corretagem pode pesar. Nesses casos, ETFs listados no Brasil podem ser mais simples, mesmo com taxas diferentes. ## Tributação em 2026: Atenção à Regra Nova A regra antiga de isenção de vendas até R$ 35 mil por mês não deve ser usada como base para ETFs no exterior. A Lei 14.754/2023 reorganizou a tributação de aplicações financeiras no exterior para pessoas físicas residentes no Brasil. Na prática, rendimentos de aplicações financeiras no exterior são apurados em reais e informados na Declaração de Ajuste Anual. Em regra, a alíquota é de **15% sobre a parcela anual dos rendimentos**, sem redução de base de cálculo. A Receita também esclarece que o imposto pago no exterior pode ser compensado em condições específicas, respeitado o limite do imposto devido no Brasil sobre o mesmo rendimento. Isso não substitui orientação tributária. Se você tem patrimônio relevante no exterior, operações frequentes, herança, trusts, empresa offshore ou mudança de residência fiscal, fale com contador ou advogado tributarista. ## ETFs Irlandeses vs ETFs Brasileiros | Critério | ETF irlandês | ETF brasileiro global | | ----------------------- | --------------- | --------------------- | | Jurisdição | Exterior | Brasil | | Moeda de negociação | USD, EUR ou GBP | Real | | Declaração | Mais complexa | Mais simples | | Oferta de produtos | Muito ampla | Menor | | Custos de remessa | Sim | Não | | Facilidade para começar | Média | Alta | O ETF brasileiro pode ser melhor para quem tem pouco patrimônio, quer simplicidade fiscal ou prefere não abrir conta fora. O ETF irlandês pode ser melhor para quem pensa em décadas, aceita complexidade e quer diversificação internacional direta. ## Exemplo de Carteiras | Perfil | Carteira | Comentário | | --------------- | ------------------------- | -------------------------------------------- | | Simples | 100% VWRA | Um ativo, baixa manutenção | | Otimizado | 85% SWRD + 15% EIMI | Menor custo, exige rebalanceamento | | EUA concentrado | CSPX + complemento global | Só faz sentido se aceitar maior concentração | Evite transformar uma estratégia passiva em coleção de ETFs. Quanto mais ativos, maior a chance de sobreposição, rebalanceamento mal feito e abandono do plano. ## Fontes Revisadas [Vanguard VWRA factsheet](https://fund-docs.vanguard.com/FTSE_All-World_UCITS_ETF_USD_Accumulating_9679_EU_INT_UK_EN.pdf) · [SPDR SWRD](https://www.ssga.com/uk/en_gb/institutional/etfs/spdr-msci-world-ucits-etf-sppw-gy) · [Receita Federal: Lei 14.754/2023](https://www.gov.br/receitafederal/pt-br/assuntos/meu-imposto-de-renda/preenchimento/manual-mir/rendimentos/outros-rendimentos) · [IRS: estate tax de não residentes](https://www.irs.gov/businesses/small-businesses-self-employed/estate-tax-for-nonresidents-not-citizens-of-the-united-states) ## Perguntas Frequentes ### VWRA é melhor que SWRD + EIMI? VWRA é melhor em simplicidade. SWRD + EIMI pode ser melhor em custo e controle de alocação. Para quem não quer rebalancear, VWRA tende a ser mais prático. ### ETF de acumulação paga imposto no Brasil? O fato de o ETF ser acumulador não elimina a obrigação tributária brasileira. A apuração depende dos rendimentos e eventos conforme a Lei 14.754/2023 e as orientações da Receita Federal. ### Posso comprar VWRA pela Avenue? Corretoras focadas apenas no mercado americano geralmente não dão acesso a bolsas europeias. Para ETFs irlandeses, normalmente você precisa de corretora com acesso a LSE, Xetra, Euronext ou outras bolsas internacionais. ### Qual é o risco principal? O risco de mercado global continua existindo. Além disso, há risco cambial, operacional, tributário, sucessório e de erro na declaração. ETF irlandês simplifica a carteira, mas não elimina esses riscos. ## Conclusão ETFs irlandeses continuam sendo uma ferramenta forte para o brasileiro que quer investir globalmente com estratégia passiva. Em 2026, a decisão precisa considerar três pontos: custo total, complexidade operacional e tributação atualizada. Se você quer simplicidade, VWRA resolve muito. Se quer otimizar custos e aceita rebalancear, SWRD + EIMI é uma alternativa sólida. Em ambos os casos, mantenha a carteira simples, documente suas compras em reais e revise a legislação antes da declaração anual. *Este conteúdo é educacional e não constitui recomendação de investimento, consultoria tributária ou planejamento sucessório.* # Ethereum (ETH) em 2026: Guia Completo para Investir no Brasil URL: /blog/ethereum-eth-guia-completo-brasil-2026.mdx Aprenda tudo sobre Ethereum: como comprar ETH no Brasil, staking, Layer 2 (Arbitrum, Optimism), DeFi, smart contracts e análise de preço 2026. *** searchable: true title: 'Ethereum (ETH) em 2026: Guia Completo para Investir no Brasil' description: 'Aprenda tudo sobre Ethereum: como comprar ETH no Brasil, staking, Layer 2 (Arbitrum, Optimism), DeFi, smart contracts e análise de preço 2026.' date: '2026-01-01' keywords: 'ethereum brasil, eth como comprar, staking ethereum, layer 2 ethereum, arbitrum, optimism, defi ethereum, smart contracts, eth 2.0, proof of stake, 2026' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Criptomoedas' readingTime: '22 min' tags: \['Ethereum', 'Criptomoedas', 'DeFi', 'Staking', 'Layer 2', 'Smart Contracts'] relatedPosts: \['bitcoin-brasil-como-investir-analise', 'solana-sol-guia-completo-brasil-2026', 'etfs-criptomoedas-b3-hash11-bith11-guia-2026', 'como-declarar-criptomoedas-imposto-renda-2026', 'stablecoins-brasil-usdt-brz-drex-guia-2026'] featured: true expertise: 'Análise técnica e fundamentalista de criptoativos com foco no mercado brasileiro' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; O **Ethereum** é a segunda maior criptomoeda do mundo e a principal plataforma para **smart contracts**, **DeFi** (finanças descentralizadas) e **NFTs**. Em 2026, após a consolidação do Proof of Stake e a explosão das soluções Layer 2, o ETH se posiciona como a infraestrutura fundamental da economia cripto. Este guia completo cobre tudo que você precisa saber para investir em Ethereum no Brasil. ## Sumário 1. [O que é Ethereum?](#o-que-e-ethereum) 2. [Ethereum vs Bitcoin: Diferenças Fundamentais](#ethereum-vs-bitcoin) 3. [O Merge e Proof of Stake](#merge-proof-of-stake) 4. [Layer 2: Arbitrum, Optimism e Base](#layer-2-ethereum) 5. [Staking de Ethereum](#staking-ethereum) 6. [DeFi no Ethereum](#defi-ethereum) 7. [Como Comprar ETH no Brasil](#como-comprar-eth-brasil) 8. [ETFs de Ethereum na bolsa brasileira](#etfs-ethereum-b3) 9. [Análise de Preço e Projeções 2026](#analise-preco-2026) 10. [Riscos e Considerações](#riscos-consideracoes) *** ## O que é Ethereum? Ethereum é uma **blockchain programável** criada por Vitalik Buterin em 2015. Enquanto o Bitcoin funciona principalmente como reserva de valor ("ouro digital"), o Ethereum é uma plataforma para construir aplicações descentralizadas. ### Ethereum em Números (2026) | Métrica | Valor | | ---------------------------------- | --------------------------------------- | | Criação | 2015 (Vitalik Buterin) | | Market Cap | \~$450 bilhões | | Ranking | #2 (atrás do Bitcoin) | | Mecanismo | Proof of Stake (desde Set/2022) | | Supply | \~120 milhões ETH (inflação controlada) | | Smart Contracts deployados Q4/2026 | 9.5 milhões (recorde) | | TVL DeFi | \~$70 bilhões | | Transações/dia | \~1.4 milhões | ### O que são Smart Contracts? Smart contracts são **programas autoexecutáveis** que rodam na blockchain. Eles eliminam intermediários e garantem que acordos sejam cumpridos automaticamente. **Exemplos práticos:** * **Empréstimos sem banco**: Protocolo Aave permite emprestar e tomar emprestado cripto * **Exchanges sem corretora**: Uniswap troca tokens automaticamente * **Seguros automáticos**: Contratos pagam sinistros sem análise humana * **NFTs**: Certificados digitais de propriedade únicos Você pode consultar o preço do Ethereum em tempo real usando a API da brapi: ```ts const response = await fetch( "https://brapi.dev/api/v2/crypto?coin=ETH¤cy=BRL", { headers: { "Authorization": "Bearer SEU_TOKEN" } } ); const data = await response.json(); const eth = data.coins[0]; console.log({ preco: eth.regularMarketPrice, variacao24h: eth.regularMarketChangePercent, volume24h: eth.regularMarketVolume, marketCap: eth.marketCap, }); ``` *** ## Ethereum vs Bitcoin: Diferenças Fundamentais | Característica | Bitcoin (BTC) | Ethereum (ETH) | | ---------------------- | ----------------- | ------------------------------ | | **Propósito** | Reserva de valor | Plataforma de aplicações | | **Criador** | Satoshi Nakamoto | Vitalik Buterin | | **Lançamento** | 2009 | 2015 | | **Supply máximo** | 21 milhões (fixo) | Sem limite (mas deflacionário) | | **Mecanismo** | Proof of Work | Proof of Stake | | **Tempo de bloco** | \~10 minutos | \~12 segundos | | **Smart Contracts** | Limitados | Completos (Turing-complete) | | **Linguagem** | Script | Solidity, Vyper | | **Consumo energético** | Alto (mineração) | Baixo (-99.95% pós-Merge) | | **Staking** | Não | Sim (\~4% a.a.) | ### Quando Escolher Cada Um? **Escolha Bitcoin se:** * Quer reserva de valor de longo prazo * Prefere simplicidade e segurança comprovada * Busca "ouro digital" para proteção patrimonial **Escolha Ethereum se:** * Quer participar do ecossistema DeFi * Tem interesse em NFTs e aplicações Web3 * Busca rendimento via staking * Quer exposição à inovação em blockchain **Estratégia comum:** Muitos investidores mantêm **ambos** - Bitcoin como reserva e Ethereum como exposição a inovação. *** ## O Merge e Proof of Stake Em setembro de 2022, o Ethereum passou pelo **"The Merge"**, a maior atualização da história das criptomoedas. O mecanismo mudou de **Proof of Work** (mineração) para **Proof of Stake** (staking). ### Impactos do Merge | Métrica | Antes (PoW) | Depois (PoS) | Mudança | | ------------------ | ------------ | -------------------- | -------------------- | | Consumo de energia | 112 TWh/ano | 0.01 TWh/ano | **-99.95%** | | Emissão de ETH | \~13.000/dia | \~1.700/dia | **-87%** | | Inflação anual | \~4.3% | \~0.5% (ou negativa) | Deflacionário | | Segurança | Mineradores | Validadores | Mais descentralizado | ### ETH é Deflacionário? Com o **EIP-1559** (agosto 2021), parte das taxas de transação é **queimada** (destruída). Quando a rede está ativa, mais ETH é queimado do que emitido, tornando o supply **deflacionário**. ### Análise de Supply do Ethereum | Métrica | Valor | | -------------------- | -------------------- | | Supply total | 120.000.000 ETH | | ETH em staking | 36.000.000 (30%) | | Emissão anual | +620.500 ETH | | Queima anual | -1.022.000 ETH | | **Variação líquida** | **-401.500 ETH/ano** | **Ethereum está deflacionário!** O supply reduz \~401.500 ETH/ano, equivalente a \~$1.5 bilhão USD/ano sendo removido de circulação. *** ## Layer 2: Arbitrum, Optimism e Base As soluções **Layer 2** (L2) são redes construídas "em cima" do Ethereum que processam transações de forma mais rápida e barata, enquanto herdam a segurança da rede principal. ### Por que Layer 2? | Métrica | Ethereum (L1) | Arbitrum (L2) | Optimism (L2) | Base (L2) | | ---------- | ------------- | ------------- | ------------- | ------------ | | Taxa média | $5-50 | $0.10-0.50 | $0.10-0.50 | $0.01-0.10 | | TPS | \~15 | \~4.000 | \~2.000 | \~2.000 | | Finalidade | \~12 min | \~1 semana\* | \~1 semana\* | \~1 semana\* | | Segurança | Máxima | Herda do ETH | Herda do ETH | Herda do ETH | \*A finalidade "real" demora \~1 semana para liquidação no L1, mas transações são confirmadas em segundos no L2. ### Principais Layer 2s em 2026 **Arbitrum (ARB)** * Maior L2 por TVL (\~$15 bilhões) * Compatível 100% com Ethereum * Lar de protocolos como GMX, Radiant * Token ARB negociável **Optimism (OP)** * Segundo maior L2 * Governança via token OP * Filosofia "retroactive public goods funding" * Base para a "Superchain" **Base (Coinbase)** * L2 da Coinbase (sem token nativo) * Crescimento explosivo em 2024 * Taxas extremamente baixas * Foco em adoção mainstream **zkSync, Starknet, Polygon zkEVM** * Usam tecnologia zero-knowledge (ZK) * Potencial para taxas ainda menores * Tecnologia mais complexa ### Como Usar Layer 2 ### Comparativo de Custos: Ethereum L1 vs Layer 2 | Transação | Ethereum (L1) | Arbitrum | Base | Economia | | ----------------- | ------------- | -------- | ----- | -------- | | Transferência ETH | $2.50 | $0.15 | $0.02 | 99% | | Swap Uniswap | $15.00 | $0.40 | $0.08 | 99% | | Mint NFT | $25.00 | $0.60 | $0.10 | 99% | | Deploy contrato | $100.00 | $2.00 | $0.50 | 99% | **Como migrar para Layer 2:** 1. Conecte carteira (MetaMask) ao L2 desejado 2. Use bridge oficial para enviar ETH 3. Opere normalmente com taxas reduzidas **Bridges oficiais:** [bridge.arbitrum.io](https://bridge.arbitrum.io) (Arbitrum), [app.optimism.io/bridge](https://app.optimism.io/bridge) (Optimism), [bridge.base.org](https://bridge.base.org) (Base) *** ## Staking de Ethereum Com o Proof of Stake, você pode **"travar" seu ETH** para validar transações e ganhar recompensas. É como uma "poupança" em cripto, mas com riscos diferentes. ### Opções de Staking | Método | Mínimo | Rendimento | Liquidez | Complexidade | | ------------------------ | -------- | ---------------- | -------- | ------------ | | Solo Staking | 32 ETH | \~4-5% a.a. | Baixa | Muito Alta | | Lido (stETH) | 0.01 ETH | \~3.5-4% a.a. | Alta | Baixa | | Rocket Pool (rETH) | 0.01 ETH | \~3-3.5% a.a. | Alta | Baixa | | Coinbase (cbETH) | 0.01 ETH | \~3% a.a. | Alta | Muito Baixa | | Binance (BETH) | 0.01 ETH | \~3% a.a. | Média | Baixa | | ETFs na bolsa brasileira | R$ 10 | Incluso no preço | Alta | Muito Baixa | ### Staking Líquido (Liquid Staking) O **staking líquido** resolve o problema de liquidez. Você deposita ETH e recebe um token que representa seu ETH + recompensas: * **stETH (Lido)**: Maior protocolo, \~$15B em TVL * **rETH (Rocket Pool)**: Mais descentralizado * **cbETH (Coinbase)**: Mais simples para iniciantes ### Exemplo: Rendimento com Staking **Investimento:** 10 ETH (R$ 180.000) | **Taxa de staking:** 4% a.a. | Ano | ETH Total | Recompensa | Valor (preço constante) | | --- | --------- | ---------- | ----------------------- | | 1 | 10.4000 | +0.4000 | R$ 187.200 | | 2 | 10.8160 | +0.4160 | R$ 194.688 | | 3 | 11.2486 | +0.4326 | R$ 202.475 | | 4 | 11.6986 | +0.4499 | R$ 210.574 | | 5 | 12.1665 | +0.4679 | R$ 218.997 | **Resultado após 5 anos:** +2.1665 ETH (\~R$ 38.997 de ganho em staking) | Cenário de valorização | Valor final | | ---------------------- | ----------- | | Preço estável | R$ 218.997 | | +50% no preço | R$ 328.496 | | +100% no preço | R$ 437.994 | | +200% no preço | R$ 656.991 | Os valores acima consideram apenas o rendimento do staking. A valorização (ou desvalorização) do ETH é adicional. ### Riscos do Staking | Risco | Descrição | Mitigação | | -------------- | ----------------------------------- | ----------------------------- | | Slashing | Punição por comportamento malicioso | Use serviços reputados | | Smart Contract | Bug no protocolo de staking | Diversifique entre protocolos | | Liquidez | Dificuldade de saque em crise | Use staking líquido | | Regulatório | Mudanças nas regras tributárias | Acompanhe legislação | | Centralização | Domínio de poucos validadores | Prefira Rocket Pool | *** ## DeFi no Ethereum **DeFi** (Decentralized Finance) são serviços financeiros construídos em blockchain, sem intermediários tradicionais. O Ethereum concentra \~60% de todo TVL (Total Value Locked) em DeFi. ### Principais Categorias DeFi | Categoria | Exemplos | O que faz | | ----------- | ------------------------ | ---------------------------------- | | DEX | Uniswap, Curve, Balancer | Troca de tokens sem corretora | | Lending | Aave, Compound, Morpho | Empréstimos cripto-colateralizados | | Staking | Lido, Rocket Pool | Rendimento com ETH | | Yield | Yearn, Convex | Otimização de rendimentos | | Derivativos | GMX, dYdX, Synthetix | Futuros e opções descentralizados | | Stablecoins | MakerDAO (DAI), Frax | Moedas estáveis descentralizadas | ### Principais Protocolos (TVL 2026) | Rank | Protocolo | Categoria | TVL | | ---- | ----------- | ---------------- | ------ | | 1 | Lido | Staking Líquido | \~$28B | | 2 | Aave | Lending | \~$18B | | 3 | EigenLayer | Restaking | \~$15B | | 4 | Maker | Stablecoin (DAI) | \~$10B | | 5 | Uniswap | DEX | \~$8B | | 6 | Rocket Pool | Staking Líquido | \~$5B | | 7 | Curve | DEX Stablecoins | \~$4B | | 8 | Compound | Lending | \~$4B | | 9 | Convex | Yield | \~$3B | | 10 | Morpho | Lending | \~$3B | ### Riscos em DeFi ⚠️ **DeFi não é para iniciantes.** Riscos incluem: 1. **Smart Contract Risk**: Bugs podem drenar fundos 2. **Impermanent Loss**: Perda em pools de liquidez 3. **Rug Pulls**: Projetos fraudulentos 4. **Oracle Manipulation**: Manipulação de preços 5. **Regulatory Risk**: Incerteza jurídica **Recomendação**: Comece com staking líquido (Lido, Rocket Pool) antes de explorar DeFi mais complexo. *** ## Como Comprar ETH no Brasil ### Opções Disponíveis | Método | Prós | Contras | Para quem | | ----------------------- | ------------------------- | -------------------- | -------------- | | Exchange BR | Fácil, PIX | Taxas maiores | Iniciantes | | Exchange Global | Mais opções, taxas baixas | Complexo, USD | Intermediários | | ETF na bolsa brasileira | Simples, regulado | Sem custódia própria | Conservadores | | P2P | Sem KYC | Riscos de golpe | Avançados | ### Passo a Passo: Comprar ETH em Exchange Brasileira 1. **Escolha a exchange**: Mercado Bitcoin, Foxbit, Binance Brasil 2. **Faça cadastro**: Documento, selfie, comprovante de residência 3. **Deposite via PIX**: Instantâneo e sem taxas (geralmente) 4. **Compre ETH**: Ordem de mercado ou limitada 5. **Decida a custódia**: Deixar na exchange ou transferir para carteira própria ### Comparativo de Taxas ### Comparativo de Exchanges Brasileiras **Simulação:** Compra de R$ 10.000 em ETH (preço: R$ 18.000) | Exchange | Taxa Trading | Custo | ETH Líquido | | --------------- | ------------ | -------- | ------------ | | Mercado Bitcoin | 0.50% | R$ 50,00 | 0.552778 ETH | | Binance | 0.10% | R$ 10,00 | 0.555000 ETH | | Foxbit | 0.50% | R$ 50,00 | 0.552778 ETH | | NovaDAX | 0.50% | R$ 50,00 | 0.552778 ETH | **Dicas:** Binance tem menores taxas de trading. Mercado Bitcoin tem maior variedade de serviços. Para HODLers, taxas de saque importam mais. Use ordens limitadas (maker) para taxas menores. *** ## ETFs de Ethereum na Bolsa Brasileira Para quem prefere investir via bolsa tradicional, existem **ETFs de Ethereum** negociados na bolsa brasileira. ### ETFs Disponíveis | Ticker | Nome | Gestora | Taxa Adm. | O que acompanha | | ------ | --------------------- | -------- | ---------- | ------------------------------- | | ETHE11 | Hashdex Ethereum | Hashdex | 0.70% a.a. | Preço do ETH | | QETH11 | QR Ethereum | QR Asset | 0.75% a.a. | Preço do ETH | | HASH11 | Hashdex Nasdaq Crypto | Hashdex | 0.30% a.a. | Índice multi-cripto (ETH \~30%) | | DEFI11 | Hashdex DeFi | Hashdex | 0.50% a.a. | Índice tokens DeFi | ### Vantagens dos ETFs ✅ **Praticidade**: Compra via home broker normal ✅ **Regulação**: CVM supervisionam ✅ **Tributação simples**: Mesmo tratamento de ações (15% sobre lucro) ✅ **Sem custódia**: Gestora cuida de tudo ✅ **Diversificação**: HASH11 e DEFI11 dão exposição a múltiplos ativos ### Desvantagens ❌ **Taxa de administração**: 0.3-0.75% a.a. corroem retorno ❌ **Sem staking**: Você não recebe recompensas de staking ❌ **Prêmio/desconto**: Preço pode divergir do ETH real ❌ **Horário limitado**: Só negocia em horário de pregão ❌ **Sem custódia própria**: Não é "seu" ETH de verdade ### Comparativo: ETF vs Compra Direta ### Simulação: ETF vs Compra Direta (5 anos) **Investimento:** R$ 50.000 | **Valorização hipotética:** 20% a.a. | Cenário | Valor Final | Custos | Observação | | ----------------------- | ------------ | -------------------------------- | --------------------------- | | ETF (ETHE11) | \~R$ 119.415 | \~R$ 3.467 (taxa adm 0.70% a.a.) | Simples, regulado | | Compra Direta + Staking | \~R$ 149.699 | R$ 250 (taxa 0.50%) | Inclui \~4% a.a. de staking | **Diferença:** \~R$ 30.284 a favor da compra direta (25% a mais) **Porém, compra direta exige:** conhecimento de custódia e carteiras, gestão ativa de staking e declaração mais complexa no IR. *** ## Análise de Preço e Projeções 2026 ### Histórico de Preços | Ano | Mínima | Máxima | Variação | | -------------- | ------ | ------ | ------------------ | | 2020 | $90 | $750 | +350% | | 2021 | $730 | $4.865 | +400% | | 2022 | $880 | $3.520 | -67% (bear market) | | 2023 | $1.200 | $2.700 | +90% | | 2024 | $2.100 | $4.100 | +50% | | 2026 | $3.000 | $4.500 | +30% | | 2026 (até jan) | $3.500 | $4.200 | - | ### Fatores que Influenciam o Preço **Alta (Bullish) 🟢** * Aprovação de ETFs spot de ETH nos EUA * Crescimento de Layer 2s (mais uso → mais queima) * Adoção institucional crescente * Halving do Bitcoin (efeito spillover) * Regulamentação clara (positiva) **Baixa (Bearish) 🔴** * Regulação restritiva (SEC) * Concorrência de outras L1s (Solana, etc.) * Falha técnica ou exploit grande * Macro adverso (juros altos, recessão) * Centralização excessiva do staking ### Modelos de Valuation **Ratio ETH/BTC** * Historicamente oscila entre 0.03 e 0.08 * Atualmente: \~0.04 * Se voltar a 0.08 com BTC a $100k → ETH a $8.000 **Comparação com "Petróleo Digital"** * ETH é o "combustível" da economia Web3 * Se DeFi + NFT + L2 crescerem, demanda por ETH aumenta * Supply deflacionário amplifica efeito no preço *** ## Riscos e Considerações ### Riscos Específicos do Ethereum | Risco | Probabilidade | Impacto | Mitigação | | --------------------------- | ------------- | ------- | ---------------------- | | Concorrência (Solana, etc.) | Alta | Médio | Diversifique | | Regulação adversa | Média | Alto | Acompanhe notícias | | Centralização staking | Média | Médio | Use Rocket Pool | | Exploit em smart contract | Baixa | Alto | Não use DeFi arriscado | | Falha no roadmap | Baixa | Médio | Longo prazo | ### Alocação Sugerida | Perfil | % em Cripto | % em ETH (do cripto) | | ------------- | ----------- | -------------------- | | Conservador | 0-5% | 30-50% | | Moderado | 5-15% | 30-50% | | Agressivo | 15-30% | 20-40% | | Cripto-nativo | 30%+ | 20-50% | ### Checklist Antes de Investir * [ ] Entendo que cripto é volátil (quedas de 50%+ acontecem) * [ ] Tenho reserva de emergência em ativos tradicionais * [ ] Não estou investindo dinheiro que preciso no curto prazo * [ ] Estudei o básico de blockchain e Ethereum * [ ] Sei como declarar cripto no Imposto de Renda * [ ] Tenho plano de custódia (exchange vs carteira própria) *** ## Conclusão O **Ethereum** é muito mais que uma criptomoeda – é a infraestrutura da economia descentralizada. Com o Proof of Stake consolidado, Layer 2s crescendo e DeFi evoluindo, o ETH se posiciona como peça central do ecossistema cripto. **Para investidores brasileiros:** * **Iniciantes**: Comece com ETFs (ETHE11, HASH11) para simplicidade * **Intermediários**: Compre ETH diretamente e explore staking líquido * **Avançados**: Participe de DeFi e use Layer 2s **Próximos passos:** 1. [Entenda como declarar cripto no IR](/blog/como-declarar-criptomoedas-imposto-renda-2026) 2. [Compare exchanges brasileiras](/blog/exchanges-criptomoedas-brasil-comparativo-2026) 3. [Aprenda sobre DeFi](/blog/defi-financas-descentralizadas-guia-iniciantes-2026) *** *Dados atualizados para janeiro de 2026. Preços de criptomoedas são voláteis. Use a [API da brapi.dev](https://brapi.dev) para consultar cotações em tempo real.* # Eventos Corporativos 2026: Splits, Grupamentos, Subscrições e Bonificações Explicados URL: /blog/eventos-corporativos-splits-grupamentos-subscricoes-bonificacoes.mdx Guia completo de eventos corporativos na bolsa brasileira. Entenda splits, grupamentos, subscrições, bonificações e como eles afetam suas ações e seu bolso. *** searchable: true title: 'Eventos Corporativos 2026: Splits, Grupamentos, Subscrições e Bonificações Explicados' description: 'Guia completo de eventos corporativos na bolsa brasileira. Entenda splits, grupamentos, subscrições, bonificações e como eles afetam suas ações e seu bolso.' date: '2026-01-01' keywords: 'split acoes, grupamento acoes, subscricao acoes, bonificacao acoes, eventos corporativos bolsa brasileira, desdobramento acoes, incorporacao acoes, direitos subscricao, 2026' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Eventos Corporativos' readingTime: '14 min' tags: \['Eventos Corporativos', 'Split', 'Grupamento', 'Subscrição', 'Bonificação', 'Bolsa Brasileira', 'Educação Financeira'] relatedPosts: \['payout-dividend-yield-sustentabilidade-2026', 'fluxo-de-caixa-livre-vs-lucro-contabil-2026', 'analise-fundamentalista-acoes-indicadores-essenciais-investir-b3'] featured: true expertise: 'Equipe técnica especializada em mercado de capitais e operações da bolsa brasileira' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > Sua ação "sumiu" da carteira? O preço mudou do dia para a noite? Provavelmente foi um evento corporativo. Neste guia, você vai entender todos os eventos que podem afetar suas ações. *** ## O Que São Eventos Corporativos? > **Definição:** ações de empresas listadas que afetam diretamente os acionistas e suas posições. | Categoria | Eventos | | ------------------------ | --------------------------------------------------------------------- | | **Estrutura de capital** | Split (desdobramento), Grupamento (inplit), Subscrição, Conversão | | **Distribuição** | Dividendos, JCP, Bonificação, Restituição de capital | | **Reorganização** | Fusão, Cisão, Incorporação, Spin-off | | **Outros** | Troca de ticker, Mudança de segmento, OPA (oferta pública), Tag along | ### Por Que Entender Eventos Corporativos? | Motivo | Importância | | ------------------ | -------------------------------------- | | **Evitar sustos** | Saber por que seu saldo "mudou" | | **Tomar decisões** | Subscrições exigem ação do investidor | | **Prazos** | Perder datas = perder direitos | | **Impostos** | Alguns eventos têm implicações fiscais | | **Oportunidades** | Eventos podem gerar valor | *** ## Split (Desdobramento) ### O Que É? > **Definição:** divisão de uma ação em várias, reduzindo o preço unitário proporcionalmente. **Exemplo — split 1:4 (1 para 4):** | Momento | Quantidade | Preço | Valor total | | ------- | ---------- | ----- | ----------- | | Antes | 100 ações | R$ 80 | R$ 8.000 | | Depois | 400 ações | R$ 20 | R$ 8.000 | > O valor total permanece inalterado. **Por que empresas fazem split?** * Aumentar liquidez (mais ações no mercado) * Tornar o preço mais "acessível" psicologicamente * Facilitar lotes-padrão * Atrair pequenos investidores ### Proporções Comuns | Proporção | Significado | | --------- | ------------------------------------ | | **1:2** | 1 ação vira 2, preço cai pela metade | | **1:3** | 1 ação vira 3, preço cai para 1/3 | | **1:4** | 1 ação vira 4, preço cai para 1/4 | | **1:10** | 1 ação vira 10, preço cai para 1/10 | ### Impacto Real **O split NÃO muda:** * Valor total da sua posição * Percentual da empresa que você possui * Valor de mercado da empresa * Lucro por ação (ajustado) * Fundamentos da empresa **O split PODE mudar:** * Liquidez (geralmente aumenta) * Percepção de "preço acessível" * Atratividade para pequenos investidores * Volatilidade (pode aumentar) ### Exemplos Reais | Empresa | Data | Proporção | Preço Antes | Preço Depois | | ---------- | ---- | --------- | ----------- | ------------ | | **WEGE3** | 2021 | 1:4 | \~R$ 320 | \~R$ 80 | | **MGLU3** | 2020 | 1:8 | \~R$ 200 | \~R$ 25 | | **BPAC11** | 2022 | 1:4 | \~R$ 120 | \~R$ 30 | *** ## Grupamento (Inplit) ### O Que É? > **Definição:** o oposto do split. Várias ações viram uma, aumentando o preço unitário. **Exemplo — grupamento 10:1 (10 para 1):** | Momento | Quantidade | Preço | Valor total | | ------- | ----------- | ------- | ----------- | | Antes | 1.000 ações | R$ 0,50 | R$ 500 | | Depois | 100 ações | R$ 5,00 | R$ 500 | > O valor total permanece inalterado. **Por que empresas fazem grupamento?** * Ação abaixo de R$ 1 ("penny stock") * Exigência regulatória (mínimo de R$ 1) * Melhorar percepção (sair do "centavos") * Reduzir custos de custódia > Atenção: o grupamento é geralmente sinal NEGATIVO — indica que a ação caiu muito. ### O Problema das Frações **Situação comum — grupamento 10:1:** * Você tem: 95 ações * Resultado: 9 ações + 5 sobras * O que acontece com as 5 sobras? * Opção 1: venda em leilão de frações * Opção 2: você compra mais 5 para completar * Opção 3: a empresa compensa em dinheiro > Dica: antes do grupamento, ajuste sua posição para um múltiplo da proporção (95 → 100 ou 95 → 90). ### Exemplos Reais | Empresa | Data | Proporção | Motivo | | --------- | ---- | --------- | -------------------- | | **OIBR3** | 2023 | 10:1 | Ação abaixo de R$ 1 | | **COGN3** | 2023 | 10:1 | Recuperação judicial | | **IRBR3** | 2021 | 15:1 | Crise na empresa | > **Lição:** Grupamento frequentemente indica empresa em dificuldades. O grupamento em si não resolve os problemas fundamentais. *** ## Subscrição ### O Que É? > **Definição:** direito do acionista de comprar novas ações antes do público, geralmente com desconto. **Objetivo da empresa:** * Captar dinheiro novo * Financiar crescimento * Pagar dívidas * Fortalecer o balanço **Direito do acionista:** * Comprar ações a preço definido * Manter proporção na empresa (não diluir) * Vender o direito no mercado * Deixar expirar (não recomendado se tiver valor) ### Como Funciona na Prática **Exemplo — subscrição PETR4:** Dados do evento: * Data-base: 15/03/2026 (quem tem ação nesta data recebe) * Preço de subscrição: R$ 30,00 (desconto de 10%) * Proporção: 1 direito para cada 10 ações * Prazo para exercer: 30 dias Você tem 1.000 ações PETR4: * Direitos recebidos: 100 (1.000 ÷ 10) * Custo para exercer: R$ 3.000 (100 × R$ 30) * Se não exercer: você fica diluído **Opções:** 1. **Exercer:** pagar R$ 3.000, receber 100 ações novas 2. **Vender direitos:** recebe dinheiro, mas fica diluído 3. **Não fazer nada:** perde valor (ruim) ### Passo a Passo corretora ou bolsa] --> B[2. Analisar
preço subscrição vs. mercado] B --> C{Preço subscrição
< preço mercado?} C -->|Sim| D[Exercer
enviar dinheiro à corretora] C -->|Não| E[Vender direitos
no mercado] C -->|Dúvida| F[Deixar expirar
geralmente perda] D --> G[4. Atenção ao prazo
direitos vencem] E --> G G --> H[5. Liquidação
ações novas em ~3 dias] style D fill:#16a34a,color:#fff style E fill:#2563eb,color:#fff style F fill:#dc2626,color:#fff `} /> ### Ticker dos Direitos Quando você recebe direitos de subscrição, eles aparecem com um ticker diferente: `PETR4` (ação) → `PETR1` ou `PETR2` (direito de subscrição) **Importante:** * Direitos podem ser negociados na bolsa * Têm data de vencimento * Após a data, viram pó se não exercidos * Fique atento aos comunicados da empresa ### Quando Exercer? | Situação | Recomendação | | --------------------------------- | ------------------------ | | Preço subscrição \< preço mercado | **Exercer** (você ganha) | | Preço subscrição > preço mercado | **Vender direitos** | | Você não tem dinheiro | **Vender direitos** | | Empresa ruim | **Vender ou deixar** | | Quer manter % | **Exercer** | *** ## Bonificação ### O Que É? > **Definição:** distribuição gratuita de novas ações aos acionistas, proporcional à posição atual. > **Fonte:** incorporação de reservas ao capital social (dinheiro que já era da empresa vira capital). **Exemplo — bonificação de 10%:** * Você tem: 100 ações * Recebe: 10 ações novas (grátis) * Total: 110 ações * Preço ajustado proporcionalmente **Não confundir com:** * Dividendo (recebe dinheiro) * Split (mesmo número de ações, mas divididas) * Subscrição (precisa pagar) ### Impacto Prático **Exemplo — bonificação de 10%:** | Momento | Ações | Preço | Valor | | ------- | ---------- | ------------------------ | -------- | | Antes | 100 | R$ 50,00 | R$ 5.000 | | Depois | 110 (+10%) | R$ 45,45 (-10% ajustado) | R$ 5.000 | > Resultado econômico: neutro (como split). Diferença: tem implicação contábil distinta. ### Diferença: Bonificação vs. Split | Aspecto | Bonificação | Split | | ------------------ | ----------------------- | -------------------------- | | **O que acontece** | Novas ações emitidas | Ações existentes divididas | | **Capital social** | Aumenta | Não muda | | **Reservas** | Diminuem (incorporadas) | Não mudam | | **Base fiscal** | Pode afetar | Geralmente não afeta | | **Percepção** | "Ganhei ações!" | "Dividiu minhas ações" | *** ## Conversão de Ações ### O Que É? > **Definição:** transformação de um tipo de ação em outro. **PN → ON (mais comum):** * Preferencial vira Ordinária * Geralmente para entrar no Novo Mercado * Proporção definida (ex.: 1 PN = 1 ON) **Units → Ações:** * Desmembramento de units * Ex.: 1 BPAC11 = 1 BPAC3 + 2 BPAC4 * Investidor pode escolher manter ou separar **Exemplos reais:** * ITUB4 → ITUB3 (parcial, migração Novo Mercado) * SANB11 → SANB3 / SANB4 (desmembramento) * SUZB5 → SUZB3 (conversão total) *** ## Fusões, Cisões e Incorporações ### Incorporação ações de B] end subgraph Depois A2[Empresa A
continua, maior] U2[Você tem
ações de A convertidas] end Antes --> Depois style A1 fill:#2563eb,color:#fff style A2 fill:#16a34a,color:#fff style B1 fill:#f97316,color:#fff `} /> **Exemplo:** Itaú + Unibanco → Itaú Unibanco. Acionistas de ambos receberam ITUB, com relação de troca definida previamente. ### Cisão una] --> A2[Empresa A
continua, menor] A1 --> B2[Empresa B
nova, parte de A] style A1 fill:#2563eb,color:#fff style A2 fill:#16a34a,color:#fff style B2 fill:#f97316,color:#fff `} /> Você, que tinha ações de A, passa a ter ações de A + B. **Exemplo:** Raízen (cisão parcial da Cosan). A Cosan continuou existindo, a Raízen foi listada separadamente e acionistas de CSAN3 receberam RAIZ4. ### Fusão C[Empresa C
nova, A + B] B[Empresa B] --> C style A fill:#2563eb,color:#fff style B fill:#f97316,color:#fff style C fill:#16a34a,color:#fff `} /> Acionistas de A e/ou B passam a ter ações de C. A e B deixam de existir. **Exemplo:** BRF (Brasil Foods). Sadia + Perdigão → BRF, novo ticker BRFS3. *** ## OPA (Oferta Pública de Aquisição) ### O Que É? > **Definição:** oferta para comprar ações de minoritários (geralmente para fechar capital ou aumentar controle). **OPA para fechamento de capital:** * Controlador quer tirar a empresa da bolsa * Oferece prêmio sobre o preço de mercado * Minoritários decidem se aceitam **OPA por aumento de participação:** * Alguém quer comprar mais ações * Oferta para todos os acionistas * Pode ser hostil ou amigável **OPA por alienação de controle (tag along):** * O controle está sendo vendido * Minoritários têm direito de vender junto * Preço mínimo: 80% do pago ao controlador ### Tag Along Direito de vender suas ações quando o controle muda, recebendo pelo menos uma porcentagem do preço pago ao controlador. **Níveis por segmento:** | Segmento | Tag Along | | ------------ | --------------------------------- | | Novo Mercado | 100% (mesmo preço do controlador) | | Nível 2 | 100% para ON, 100% para PN | | Nível 1 | 80% para ON | | Tradicional | 80% para ON (se houver) | **Exemplo — controlador vende ações por R$ 50:** | Tag along | Seu preço de venda | | ------------- | -------------------- | | 100% | R$ 50 | | 80% | R$ 40 | | Sem tag along | Você fica com a ação | > Importante: sempre verifique o tag along antes de investir. *** ## Calendário de Eventos ### Datas Importantes ### Exemplo Prático **Dividendo PETR4:** | Data | Evento | | ----- | ---------------------------- | | 15/03 | Aprovação na AGO | | 20/03 | Data-base (último dia "com") | | 21/03 | Data "ex" (preço ajusta) | | 15/04 | Pagamento na conta | **Se você:** | Ação | Resultado | | ----------------- | --------------------------- | | Comprou dia 19/03 | Recebe dividendo | | Comprou dia 20/03 | Recebe dividendo | | Comprou dia 21/03 | NÃO recebe (já é "ex") | | Vendeu dia 21/03 | RECEBE (tinha na data-base) | *** ## Impactos Fiscais ### Tabela de Implicações | Evento | Base de Custo | IR | | --------------------- | ---------------------------------------- | ----------------------- | | **Split** | Dividido proporcionalmente | Neutro | | **Grupamento** | Multiplicado proporcionalmente | Neutro | | **Bonificação** | Custo das novas = R$ 0 ou valor contábil | Pode ter IR sobre valor | | **Subscrição** | Preço pago + custo do direito | Normal | | **Dividendo** | N/A | Isento | | **JCP** | N/A | 15% na fonte | | **Venda de direitos** | Custo = R$ 0 | 15% sobre valor total | ### Atenção com Bonificação > Cuidado: bonificação pode ter imposto. **Cenário 1 — bonificação com custo zero:** * Ações recebidas com custo R$ 0 * Quando vender, a base é zero * Paga IR sobre o valor total da venda **Cenário 2 — bonificação com valor contábil:** * Empresa atribui valor às ações * Pode ser tributado como renda * Consulte um contador Sempre verifique o comunicado da empresa sobre o tratamento fiscal da bonificação. *** ## Acompanhando Eventos com brapi ### Monitorando Ações Para identificar possíveis eventos corporativos, você pode analisar o histórico de preços buscando gaps significativos (variações acima de 15% em um único dia): ```typescript const response = await fetch( 'https://brapi.dev/api/quote/WEGE3?range=1mo&interval=1d', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Analise historicalDataPrice para identificar gaps de preço ``` **Sinais de Eventos Corporativos no Histórico:** | Tipo de Gap | Variação | Possível Evento | | ---------------- | ------------- | -------------------------------- | | Queda brusca | -50% a -75% | Split (desdobramento) | | Alta brusca | +100% a +300% | Grupamento (inplit) | | Queda moderada | -15% a -30% | Ex-dividendos ou bonificação | | Variação atípica | > ±20% | Verificar comunicados da empresa | > **Dica:** Sempre confirme eventos no site de RI da empresa ou no portal da bolsa brasileira. ### Calculando Ajuste de Split **Exemplo: Split 1:4 (cada ação vira 4)** | Situação | Quantidade | Preço Unitário | Valor Total | | ---------- | ---------- | -------------- | ----------- | | **Antes** | 100 ações | R$ 80,00 | R$ 8.000,00 | | **Depois** | 400 ações | R$ 20,00 | R$ 8.000,00 | > ✅ **O valor total permanece inalterado!** O split apenas divide as ações existentes em partes menores. **Fórmula de Cálculo:** ``` Quantidade depois = Quantidade antes × Fator do split Preço depois = Preço antes ÷ Fator do split Exemplo 1:4: - Fator = 4 - 100 × 4 = 400 ações - R$ 80 ÷ 4 = R$ 20,00 ``` ### Verificando Direitos de Subscrição Para analisar se vale exercer direitos de subscrição, compare o preço de subscrição com o preço atual de mercado: ```typescript const response = await fetch( 'https://brapi.dev/api/quote/PETR4', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() const precoMercado = data.results[0].regularMarketPrice ``` **Exemplo: Subscrição PETR4 (proporção 1:10)** | Dado | Valor | | ------------------- | ---------------------------- | | Suas ações | 1.000 | | Proporção | 1 direito para cada 10 ações | | Direitos recebidos | 100 | | Preço de subscrição | R$ 30,00 | | Preço de mercado | R$ 38,00 | | Desconto | 21,1% | **Análise Financeira:** | Cálculo | Valor | | ------------------ | ------------------------- | | Custo para exercer | R$ 3.000,00 (100 × R$ 30) | | Valor de mercado | R$ 3.800,00 (100 × R$ 38) | | **Ganho imediato** | **R$ 800,00** | **Recomendação:** | Situação | Ação Recomendada | | --------------------------------- | ------------------------------------ | | Preço subscrição \< Preço mercado | ✅ **Exercer** (comprar com desconto) | | Preço subscrição > Preço mercado | ⚠️ **Vender direitos** no mercado | | Preço subscrição ≈ Preço mercado | Avaliar perspectivas da empresa | *** ## FAQ ### Split muda o valor da minha carteira? Não. O split apenas divide as ações existentes. Se você tinha R$ 10.000 em uma ação, continuará tendo R$ 10.000 (apenas com mais ações a um preço menor). ### Preciso fazer algo no split? Não. O split é automático. Suas ações serão multiplicadas e o preço ajustado pela corretora/bolsa brasileira. ### Recebi direitos de subscrição. Sou obrigado a exercer? Não. Você pode: 1. Exercer (comprar as ações) 2. Vender os direitos no mercado 3. Deixar expirar (geralmente ruim) ### O que acontece se eu perder o prazo da subscrição? Os direitos expiram sem valor. Você fica diluído (sua participação na empresa diminui) e perde o valor do direito. ### Grupamento é bom ou ruim? Geralmente é sinal negativo. Indica que a ação caiu muito e a empresa precisa "arrumar" o preço. O grupamento em si não melhora a empresa, apenas o preço nominal. ### Como fico sabendo dos eventos da minha ação? 1. Acompanhe os comunicados na CVM 2. Configure alertas na sua corretora 3. Monitore e-mails da corretora 4. Siga a empresa nas redes sociais *** ## Checklist de Eventos ### Ao Receber Aviso de Evento ``` □ 1. Identifiquei qual tipo de evento (split, subscrição, etc.) □ 2. Anotei as datas importantes (data-base, prazo) □ 3. Entendi o impacto na minha posição □ 4. Se for subscrição, calculei se vale exercer □ 5. Tenho dinheiro disponível (se precisar) □ 6. Comuniquei à corretora minha decisão (se necessário) □ 7. Acompanhei a liquidação do evento □ 8. Verifiquei se minha posição está correta após ``` *** ## Conclusão Eventos corporativos são parte normal da vida de um investidor. O importante é: 1. ✅ **Entender** o que cada evento significa 2. ✅ **Monitorar** comunicados da empresa 3. ✅ **Agir nos prazos** quando necessário 4. ✅ **Não entrar em pânico** com mudanças no preço 5. ✅ **Manter registros** para fins fiscais 6. ⚠️ **Subscrições exigem atenção** - não perca prazos! **Lembre-se:** A maioria dos eventos (split, bonificação) não muda o valor da sua carteira. Mantenha a calma e entenda o que está acontecendo. *** ## Próximos Passos * **[Cadastre-se na brapi](https://brapi.dev)** para acompanhar suas ações * **[Dividendos](/blog/dividendos-acoes-brasileiras-guia-completo)** para entender proventos * **[Análise fundamentalista](/blog/analise-fundamentalista-acoes-b3-guia-completo-indicadores)** para avaliar empresas * **[Como analisar ações](/blog/como-analisar-acoes-guia-completo-iniciantes)** para iniciantes *** *Este artigo tem caráter educacional e não constitui recomendação de investimento. Consulte um profissional para questões fiscais específicas.* # Como Importar Cotações da Bolsa Brasileira no Excel: Power Query 2026 URL: /blog/excel-cotacoes-b3-power-query-vba.mdx Aprenda a importar cotações automáticas da bolsa brasileira no Microsoft Excel usando Power Query e VBA. Tutorial completo para planilhas financeiras profissionais. *** searchable: true title: 'Como Importar Cotações da Bolsa Brasileira no Excel: Power Query 2026' description: 'Aprenda a importar cotações automáticas da bolsa brasileira no Microsoft Excel usando Power Query e VBA. Tutorial completo para planilhas financeiras profissionais.' date: '2025-10-12' keywords: 'excel cotações, power query bolsa brasileira, vba cotações, excel api, planilha investimentos, brapi excel' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Planilhas e Automação' readingTime: '7 min' tags: \['Excel', 'Power Query', 'VBA', 'Automação', 'Planilhas'] relatedPosts: \['dashboard-b3-power-bi-api-cotacoes', 'integracao-google-sheets-cotacoes-b3-tutorial-completo', 'api-b3-python-requests-guia-pratico'] featured: false expertise: 'Automação de planilhas Excel - 8+ anos' lastReviewed: '2026-07-17' howToTools: \['Microsoft Excel 2016+', 'Power Query', 'Conta brapi.dev'] howToSteps: * name: 'Obtenha seu token da API' text: 'Crie uma conta gratuita em brapi.dev e copie seu token no painel de usuário.' * name: 'Abra o Power Query' text: 'No Excel, vá em Dados > Obter Dados > Da Web para iniciar uma nova consulta.' * name: 'Configure a URL da API' text: 'Insira a URL [https://brapi.dev/api/quote/TICKER?token=SEU\_TOKEN](https://brapi.dev/api/quote/TICKER?token=SEU_TOKEN) substituindo pelo seu ticker e token.' * name: 'Transforme os dados JSON' text: 'Use as opções de transformação do Power Query para expandir o objeto results e selecionar as colunas desejadas.' * name: 'Carregue na planilha' text: 'Clique em Fechar e Carregar para importar os dados na sua planilha Excel.' *** import { Author, Authors } from '~/components/Authors'; > Aprenda a criar planilhas profissionais com cotações automáticas da bolsa brasileira usando Power Query e VBA. ## Por Que Excel para Investimentos? O Microsoft Excel continua sendo uma das ferramentas mais populares para acompanhar investimentos. Com a integração da brapi.dev, você pode: * Importar cotações automáticas da bolsa brasileira * Atualizar dados com um clique * Criar dashboards profissionais * Fazer análises avançadas * Integrar com Power BI Para publicar o painel ou atualizar os dados sem depender do arquivo aberto, siga o guia de [dashboard da B3 no Power BI com a API brapi](/blog/dashboard-b3-power-bi-api-cotacoes). ## Método 1: Power Query (Recomendado) O Power Query permite importar dados JSON sem programação. ### Passo a Passo 1. Abra o Excel e vá para a guia **Dados** 2. Clique em **Obter Dados** > **De Outras Fontes** > **Da Web** 3. Insira a URL: ``` https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN ``` 4. Clique em **OK** 5. O Power Query abrirá mostrando os dados JSON 6. Clique em **Converter** > **Para Tabela** 7. Expanda a coluna **results** clicando na seta dupla 8. Selecione os campos que deseja (symbol, regularMarketPrice, etc.) 9. Clique em **Fechar e Carregar** ### Múltiplos Ativos Para importar várias ações de uma vez: ``` https://brapi.dev/api/quote/PETR4,VALE3,ITUB4,BBDC4?token=SEU_TOKEN ``` ### Atualização Automática 1. Clique com botão direito na tabela 2. Selecione **Atualizar** 3. Ou vá em **Consultas e Conexões** > **Propriedades da Conexão** 4. Configure atualização automática: * Atualizar dados ao abrir o arquivo * Atualizar dados a cada X minutos ### Exemplo de Estrutura Após importar, sua tabela ficará assim: | symbol | shortName | regularMarketPrice | regularMarketChangePercent | currency | | ------ | ------------ | ------------------ | -------------------------- | -------- | | PETR4 | PETROBRAS PN | 38.45 | 2.15 | BRL | | VALE3 | VALE ON | 62.30 | -0.85 | BRL | ## Método 2: VBA Avançado Para mais controle, use VBA (Visual Basic for Applications). ### Código VBA Completo Pressione `Alt + F11` para abrir o editor VBA e cole: ```vb ' Requer biblioteca VBA-JSON: https://github.com/VBA-tools/VBA-JSON Function GetBrapiQuote(ticker As String, Optional field As String = "regularMarketPrice") As Variant On Error GoTo ErrorHandler Dim http As Object Dim json As Object Dim token As String Dim url As String ' Configure seu token aqui ou em uma célula token = ThisWorkbook.Sheets("Config").Range("A1").Value ' Monta URL url = "https://brapi.dev/api/quote/" & ticker ' Faz requisição com header auth (recomendado) Set http = CreateObject("MSXML2.XMLHTTP") http.Open "GET", url, False http.setRequestHeader "Authorization", "Bearer " & token http.Send ' Verifica resposta If http.Status = 200 Then Set json = JsonConverter.ParseJson(http.responseText) ' Retorna campo solicitado If field = "regularMarketPrice" Then GetBrapiQuote = json("results")(1)("regularMarketPrice") ElseIf field = "symbol" Then GetBrapiQuote = json("results")(1)("symbol") ElseIf field = "shortName" Then GetBrapiQuote = json("results")(1)("shortName") ElseIf field = "regularMarketChangePercent" Then GetBrapiQuote = json("results")(1)("regularMarketChangePercent") Else GetBrapiQuote = json("results")(1)(field) End If Else GetBrapiQuote = "Erro HTTP " & http.Status End If Exit Function ErrorHandler: GetBrapiQuote = "Erro: " & Err.Description End Function ' Sub para atualizar todas as cotações Sub AtualizarCotacoes() Application.CalculateFull MsgBox "Cotações atualizadas!", vbInformation End Sub ``` ### Biblioteca VBA-JSON 1. Baixe [VBA-JSON](https://github.com/VBA-tools/VBA-JSON) 2. Importe o arquivo `JsonConverter.bas` no seu projeto VBA 3. Em Ferramentas > Referências, ative "Microsoft Scripting Runtime" ### Uso das Funções VBA Na planilha: ``` =GetBrapiQuote("PETR4"; "regularMarketPrice") =GetBrapiQuote("PETR4"; "shortName") =GetBrapiQuote("PETR4"; "regularMarketChangePercent") ``` ### Estrutura Recomendada **Aba "Config":** | A | B | | ---------------- | ------------ | | SEU\_TOKEN\_AQUI | Token da API | **Aba "Cotações":** | A (Ticker) | B (Nome) | C (Preço) | D (Variação %) | | ---------- | ------------------------------ | --------------------------------------- | ----------------------------------------------- | | PETR4 | =GetBrapiQuote(A2;"shortName") | =GetBrapiQuote(A2;"regularMarketPrice") | =GetBrapiQuote(A2;"regularMarketChangePercent") | ## Método 3: Fórmulas Dinâmicas (Excel 365) Se você tem Excel 365, pode usar fórmulas dinâmicas: ``` =FILTERXML( WEBSERVICE("https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN"), "//regularMarketPrice" ) ``` **Nota:** Esta abordagem é limitada pois a API retorna JSON, não XML. ## Dashboard Profissional ### Estrutura de Abas 1. **Config** - Token e configurações 2. **Cotações** - Dados brutos atualizados 3. **Dashboard** - Visualizações e gráficos 4. **Histórico** - Registro de preços diários ### Formatação Condicional Para destacar variações: 1. Selecione a coluna de variação percentual 2. Formatação Condicional > Nova Regra 3. Configure: * Verde se > 0 * Vermelho se \< 0 ### Gráficos Recomendados * **Gráfico de Pizza:** Distribuição da carteira * **Gráfico de Barras:** Performance por ativo * **Gráfico de Linha:** Evolução histórica ## Botão de Atualização Adicione um botão para atualizar dados: 1. Guia **Desenvolvedor** > **Inserir** > **Botão** 2. Desenhe o botão na planilha 3. Atribua a macro `AtualizarCotacoes` Código do botão: ```vb Sub AtualizarTudo() ' Atualiza Power Query ActiveWorkbook.RefreshAll ' Atualiza fórmulas VBA Application.CalculateFull ' Atualiza timestamp ThisWorkbook.Sheets("Dashboard").Range("A1").Value = "Última atualização: " & Now() MsgBox "Dados atualizados!", vbInformation End Sub ``` ## Salvando Histórico Automático ```vb Sub SalvarHistorico() Dim wsOrigem As Worksheet Dim wsHistorico As Worksheet Dim ultimaLinha As Long Set wsOrigem = ThisWorkbook.Sheets("Cotações") Set wsHistorico = ThisWorkbook.Sheets("Histórico") ultimaLinha = wsHistorico.Cells(Rows.Count, 1).End(xlUp).Row + 1 ' Copia dados com timestamp wsHistorico.Cells(ultimaLinha, 1).Value = Now() wsOrigem.Range("A2:D10").Copy wsHistorico.Cells(ultimaLinha, 2) MsgBox "Histórico salvo!", vbInformation End Sub ``` ## Integração com Power BI 1. No Power BI Desktop, clique em **Obter Dados** > **Excel** 2. Selecione sua planilha Excel 3. Importe as tabelas desejadas 4. Configure atualização automática no Power BI Service ## Dicas de Performance ### 1. Use Cache Evite atualizar a cada célula recalculada: ```vb ' No início da função Static cache As Object Static cacheTime As Date If DateDiff("s", cacheTime, Now()) < 60 Then ' Retorna do cache se menos de 60 segundos GetBrapiQuote = cache(ticker & "_" & field) Exit Function End If ``` ### 2. Desative Cálculo Automático Para planilhas grandes: * Fórmulas > Opções de Cálculo > Manual * Use Ctrl+Alt+F9 para recalcular quando necessário ### 3. Use Tabelas Converta ranges em tabelas (Ctrl+T) para melhor performance. ## Exemplos Práticos ### Carteira de Investimentos | Ticker | Quantidade | Preço Médio | Preço Atual | Lucro/Prejuízo | % | | ------ | ---------- | ----------- | ------------------ | -------------- | ----------- | | PETR4 | 100 | 35.00 | =GetBrapiQuote(A2) | =(D2-C2)\*B2 | =(D2-C2)/C2 | ### Monitor de Mercado Configure cores automáticas: * 🟢 Verde: Variação > 2% * 🟡 Amarelo: Variação entre -2% e 2% * 🔴 Vermelho: Variação \< -2% ## Troubleshooting ### Erro: "Não é possível se conectar" * Verifique sua conexão com internet * Confirme que o token está correto ### Erro: "Método não encontrado" * Instale a biblioteca VBA-JSON * Ative "Microsoft Scripting Runtime" ### Dados não atualizam * Verifique se atualização automática está habilitada * Clique em "Atualizar Tudo" manualmente ## Comparação: Excel vs Google Sheets | Recurso | Excel | Google Sheets | | ----------- | -------- | ------------- | | Power Query | Sim | Não | | VBA | Sim | Apps Script | | Offline | Sim | Não | | Colaboração | Limitada | Excelente | | Gratuito | Não | Sim | ## Próximos Passos * [Veja integração com Google Sheets](/docs/examples/google-sheets) * [Aprenda Python para análises](/docs/examples/python) * [Explore a documentação](/docs) ## Conclusão O Excel é uma ferramenta poderosa para acompanhar investimentos. Com Power Query e VBA, você pode criar planilhas profissionais com dados sempre atualizados da bolsa brasileira. **Comece agora:** Escolha o método que melhor se adequa às suas necessidades e crie sua planilha de investimentos! # Melhores Exchanges de Criptomoedas no Brasil 2026: Comparativo Completo URL: /blog/exchanges-criptomoedas-brasil-comparativo-2026.mdx Compare as melhores exchanges de criptomoedas para brasileiros em 2026. Análise de Binance, Mercado Bitcoin, Foxbit e mais com taxas, PIX e segurança. *** searchable: true title: 'Melhores Exchanges de Criptomoedas no Brasil 2026: Comparativo Completo' description: 'Compare as melhores exchanges de criptomoedas para brasileiros em 2026. Análise de Binance, Mercado Bitcoin, Foxbit e mais com taxas, PIX e segurança.' date: '2026-01-01' keywords: 'melhores exchanges brasil, binance brasil, mercado bitcoin, foxbit, exchange criptomoedas brasil, comprar bitcoin PIX, corretora criptomoedas' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Criptomoedas' readingTime: '18 min' tags: \['Criptomoedas', 'Exchanges', 'Binance', 'Mercado Bitcoin', 'Trading', 'PIX'] relatedPosts: \['bitcoin-brasil-como-investir-analise', 'como-declarar-criptomoedas-imposto-renda-2026', 'carteiras-criptomoedas-guia-seguranca-2026', 'etfs-criptomoedas-b3-hash11-bith11-guia-2026'] featured: true expertise: 'Comparativo elaborado por especialistas em criptoativos com análise prática de taxas, segurança e usabilidade' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; Escolher a **exchange de criptomoedas** certa é fundamental para investir com segurança e pagar menos taxas. Em 2026, o mercado brasileiro conta com diversas opções regulamentadas, desde gigantes globais até corretoras nacionais especializadas. Neste guia completo, você vai encontrar: * Comparativo detalhado das principais exchanges * Análise de taxas de trading, depósito e saque * Segurança e regulamentação de cada plataforma * Qual exchange escolher para seu perfil * Tutorial para abrir conta e comprar Bitcoin *** ## Panorama do Mercado de Exchanges no Brasil ### Regulamentação 2026 Em 2026, o cenário regulatório brasileiro para exchanges está mais claro: | Regulamentação | Status | | -------------------------------------------------- | ----------------------------------------- | | **Marco Legal das Criptomoedas** (Lei 14.478/2022) | Em vigor | | **Resolução BCB 519-521/2026** | Regras operacionais para VASPs | | **IN RFB 2.291/2026 (DeCripto)** | Obrigação de reporte | | **Autorização BCB** | Obrigatória para exchanges (em transição) | ### Novidades Importantes * **Binance Brasil**: Autorizada após aquisição da Sim;Paul * **Exchanges estrangeiras**: Precisam de autorização do BCB até fev/2026 * **Reporte automático**: Exchanges brasileiras reportam à Receita Federal *** ## Comparativo das Principais Exchanges ### Tabela Comparativa Geral | Exchange | Fundação | Sede | Moedas | Depósito PIX | Taxa Maker | Taxa Taker | | ------------------- | -------- | ---------------------- | ------ | ------------ | ---------- | ---------- | | **Binance** | 2017 | Global (BR autorizada) | 400+ | ✅ Grátis | 0.10% | 0.10% | | **Mercado Bitcoin** | 2013 | Brasil | 200+ | ✅ Grátis | 0.30% | 0.70% | | **Foxbit** | 2014 | Brasil | 80+ | ✅ Grátis | 0.25% | 0.50% | | **Bitso** | 2014 | México (BR) | 50+ | ✅ Grátis | 0.10% | 0.10% | | **NovaDAX** | 2018 | Brasil | 100+ | ✅ Grátis | 0.20% | 0.50% | | **Coinbase** | 2012 | EUA | 200+ | ❌ | 0.40% | 0.60% | | **Kraken** | 2011 | EUA | 200+ | ❌ | 0.16% | 0.26% | ### Ranking por Categoria **Melhor para Iniciantes:** | Posição | Exchange | Motivo | | ------- | --------------- | ----------------------------------------- | | 1° | Mercado Bitcoin | Interface simples, suporte em português | | 2° | Foxbit | Focada no Brasil, suporte local | | 3° | Bitso | App intuitivo, boas opções de aprendizado | **Menor Taxa de Trading:** | Posição | Exchange | Taxa | | ------- | -------- | ---------------------------------------- | | 1° | Binance | 0.10% maker/taker (pode reduzir com BNB) | | 2° | Bitso | 0.10% maker/taker | | 3° | Kraken | 0.16% maker, 0.26% taker | **Maior Variedade de Moedas:** | Posição | Exchange | Quantidade | | ------- | --------------- | ----------------- | | 1° | Binance | 400+ criptomoedas | | 2° | Coinbase | 200+ criptomoedas | | 3° | Mercado Bitcoin | 200+ criptomoedas | **Melhor para Trading Avançado:** | Posição | Exchange | Recursos | | ------- | -------- | ----------------------------- | | 1° | Binance | Futuros, margem, grid trading | | 2° | Kraken | Futuros, margem, staking | | 3° | Bitso | API robusta, ordens avançadas | **Melhor Suporte em Português:** | Posição | Exchange | Diferencial | | ------- | --------------- | ------------------------- | | 1° | Mercado Bitcoin | Suporte 100% brasileiro | | 2° | Foxbit | Atendimento local | | 3° | Binance | Suporte em português 24/7 | *** ## Análise Detalhada por Exchange ### 1. Binance Brasil A maior exchange do mundo, agora autorizada a operar no Brasil. | Pontos Fortes | Pontos Fracos | | ---------------------------------- | ----------------------------------- | | Maior liquidez do mercado | Interface pode confundir iniciantes | | 400+ criptomoedas disponíveis | Histórico de problemas regulatórios | | Taxas mais baixas (0.10%) | Suporte pode demorar em picos | | Trading avançado (futuros, margem) | | | Binance Earn (staking, savings) | | | PIX grátis 24/7 | | | App mobile excelente | | **Taxas:** * Depósito PIX: Grátis * Saque PIX: R$ 2,00 * Trading: 0.10% (reduz com BNB ou volume) * Saque cripto: Varia por moeda > **Ideal para:** traders ativos, variedade de moedas #### Taxas Binance Detalhadas **Taxas por Nível VIP:** | Nível VIP | Volume 30d (BTC) | Taxa Maker | Taxa Taker | | --------- | ---------------- | ---------- | ---------- | | VIP 0 | 0+ | 0,10% | 0,10% | | VIP 1 | 25+ | 0,09% | 0,10% | | VIP 2 | 100+ | 0,08% | 0,10% | | VIP 3 | 500+ | 0,07% | 0,09% | | VIP 4 | 1.000+ | 0,06% | 0,08% | | VIP 5 | 5.000+ | 0,05% | 0,07% | **Desconto usando BNB:** 25% de redução nas taxas ao pagar com BNB. **Exemplos Práticos:** | Perfil | Volume 30d | Usa BNB | Taxa Maker | Taxa Taker | | -------------------- | ---------- | ------- | ---------- | ---------- | | Iniciante sem BNB | R$ 10.000 | Não | 0,100% | 0,100% | | Iniciante com BNB | R$ 10.000 | Sim | 0,075% | 0,075% | | Trader médio com BNB | R$ 500.000 | Sim | 0,075% | 0,075% | ### 2. Mercado Bitcoin A maior e mais antiga exchange brasileira. | Pontos Fortes | Pontos Fracos | | -------------------------------------------- | --------------------------------- | | Maior exchange brasileira (desde 2013) | Taxas mais altas que concorrentes | | 100% regulamentada no Brasil | Menos moedas que Binance | | Suporte excelente em português | Sem trading de futuros | | Interface amigável para iniciantes | | | Programa de fidelidade (MB) | | | Opção de compra simplificada | | | Ativos tokenizados (precatórios, consórcios) | | **Taxas:** * Depósito PIX: Grátis * Saque PIX: 1.99% + R$ 2,90 (mín) * Trading: 0.30% maker / 0.70% taker * Programa fidelidade: Até 50% desconto > **Ideal para:** iniciantes, investidores conservadores ### 3. Foxbit Exchange brasileira com foco em simplicidade. | Pontos Fortes | Pontos Fracos | | ---------------------------------- | ------------------------------------ | | Brasileira desde 2014 | Menos moedas disponíveis | | Interface muito simples | Liquidez menor que grandes exchanges | | Foxbit Earn (rendimentos) | Sem trading avançado | | Foxbit Pay (pagamentos com cripto) | | | Suporte local de qualidade | | | Compra recorrente (DCA automático) | | **Taxas:** * Depósito PIX: Grátis * Saque PIX: Grátis * Trading: 0.25% maker / 0.50% taker > **Ideal para:** iniciantes, foco em Bitcoin ### 4. Bitso Exchange mexicana com forte presença no Brasil. | Pontos Fortes | Pontos Fracos | | ----------------------------------- | ------------------------ | | Taxas competitivas (0.10%) | Menos moedas que Binance | | Programa Alpha (cashback em cripto) | Empresa não é brasileira | | App muito bem avaliado | Sem futuros/margem | | Bitso+ (rendimentos em stablecoins) | | | API robusta para traders | | | Licenciada em múltiplos países | | **Taxas:** * Depósito PIX: Grátis * Saque PIX: Grátis * Trading: 0.10% maker / 0.10% taker > **Ideal para:** equilíbrio taxas x simplicidade ### 5. NovaDAX Exchange brasileira com foco em altcoins. | Característica | Detalhes | | ---------------- | ------------------------- | | **Fundação** | 2018 | | **Moedas** | 100+ | | **Taxa Trading** | 0.20% maker / 0.50% taker | | **Depósito PIX** | Grátis | | **Diferencial** | Boa variedade de altcoins | ### 6. Exchanges Internacionais Para quem busca moedas não disponíveis no Brasil: | Exchange | Vantagem | Desvantagem Brasil | | ------------ | ----------------------- | -------------------- | | **Coinbase** | Segurança, simplicidade | Sem PIX, taxas altas | | **Kraken** | Segurança, staking | Sem PIX | | **KuCoin** | Muitas altcoins | Sem suporte BRL | | **Bybit** | Futuros, derivativos | Sem BRL nativo | > **Atenção**: Exchanges sem autorização no Brasil podem ter restrições após fev/2026 (Resolução BCB 519-521). *** ## Comparativo de Taxas ### Custo Total por Operação **Comparativo de Custo - Operação de R$ 10.000 (taxa taker):** | Exchange | Taxa | Custo Trading | Saque PIX | Custo Total | | --------------- | ----- | ------------- | --------- | ----------- | | Binance | 0,10% | R$ 10,00 | R$ 2,00 | R$ 12,00 | | Bitso | 0,10% | R$ 10,00 | R$ 0,00 | R$ 10,00 | | NovaDAX | 0,50% | R$ 50,00 | R$ 1,99 | R$ 51,99 | | Foxbit | 0,50% | R$ 50,00 | R$ 0,00 | R$ 50,00 | | Mercado Bitcoin | 0,70% | R$ 70,00 | R$ 2,90 | R$ 72,90 | > *Taxas taker (ordem a mercado). Não inclui taxas de saque de criptomoedas.* ### Simulador de Economia Anual **Simulação de Custos Anuais (Volume: R$ 5.000/mês = R$ 60.000/ano):** | Exchange | Taxa Taker | Custo Anual | | --------------- | ---------- | ----------- | | Binance | 0,10% | R$ 60,00 | | Bitso | 0,10% | R$ 60,00 | | NovaDAX | 0,50% | R$ 300,00 | | Foxbit | 0,50% | R$ 300,00 | | Mercado Bitcoin | 0,70% | R$ 420,00 | **Economia potencial:** Usando Binance/Bitso ao invés de Mercado Bitcoin, você economiza **R$ 360,00/ano**. *** ## Segurança das Exchanges ### Avaliação de Segurança | Exchange | Nota | Pontos | | ------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | | **Binance** | 8.5/10 | SAFU Fund (fundo de seguro); 2FA obrigatório, anti-phishing; Cold storage para maioria dos fundos; Histórico de hack em 2019 (coberto pelo SAFU) | | **Mercado Bitcoin** | 9/10 | Nunca hackeada; 100% regulamentada no Brasil; Auditorias regulares; Seguro contra roubo | | **Foxbit** | 8/10 | Empresa brasileira regulamentada; 2FA, cold storage; Menor escala = menos recursos de segurança | | **Bitso** | 8.5/10 | Licenciada em múltiplos países; Investidores institucionais; Custódia BitGo | | **Coinbase** | 9.5/10 | Empresa pública (NASDAQ: COIN); Auditada regularmente; Seguro FDIC para USD (até $250k); Não opera diretamente no Brasil | ### Práticas de Segurança que Você Deve Verificar | Prática | Essencial | Verificar Como | | ---------------------- | ----------- | ------------------------------ | | **2FA** | ✅ | Configurações de segurança | | **Cold Storage** | ✅ | Documentação da exchange | | **Prova de Reservas** | ✅ | Relatórios públicos | | **Whitelist de saque** | Recomendado | Configurações | | **Anti-phishing** | Recomendado | Código personalizado em emails | | **Seguro** | Desejável | Termos de serviço | *** ## Tutorial: Comprando Bitcoin na Binance ### Passo a Passo Completo **Passo 1: Criar conta** * Acesse binance.com (cuidado com sites falsos!) * Clique em "Registrar" * Use email seguro ou número de celular * Crie senha forte (mín. 12 caracteres) **Passo 2: Verificação de identidade (KYC)** * Vá em "Identificação" * Escolha documento (RG ou CNH) * Tire foto do documento * Faça selfie de verificação * Aguarde aprovação (minutos a horas) **Passo 3: Ativar segurança** * Ative 2FA (Google Authenticator) * Configure código anti-phishing * Adicione email de backup **Passo 4: Depositar BRL via PIX** * Vá em "Carteira" → "Depositar" * Selecione "BRL" e "PIX" * Digite o valor (mín. R$ 10) * Copie a chave PIX ou QR Code * Faça o PIX do seu banco * Saldo disponível em minutos **Passo 5: Comprar Bitcoin** *Opção A — Compra simples:* * Vá em "Comprar Cripto" → "Compra Rápida" * Selecione BTC, insira valor em BRL * Confirme a compra *Opção B — Spot trading (menor taxa):* * Vá em "Trade" → "Spot" * Busque par "BTC/BRL" * Escolha "Limit" ou "Market" * Insira quantidade e confirme **Passo 6: Transferir para carteira própria (recomendado)** * Vá em "Carteira" → "Sacar" * Selecione BTC e rede (Bitcoin) * Cole seu endereço de carteira * Confirme via 2FA e email *** ## Qual Exchange Escolher? ### Decisor por Perfil **Recomendações por Tipo de Investidor:** | Perfil | Exchange Recomendada | Motivo | | -------------------------- | -------------------- | ----------------------------------------------- | | **Iniciante cauteloso** | Mercado Bitcoin | Interface simples, suporte em português, segura | | | Foxbit | Muito simples, focada em Bitcoin, brasileira | | **Trader ativo** | Binance | Menores taxas (0.10%), desconto com BNB | | | Bitso | Taxas de 0.10%, PIX grátis | | **Entusiasta de altcoins** | Binance | Maior variedade: 400+ moedas | | **Trading avançado** | Binance | Futuros, margem, grid trading, API | | | Kraken | Futuros, margem, excelente segurança | | **Foco em segurança** | Mercado Bitcoin | Nunca hackeada, 100% regulamentada | | | Coinbase | Empresa pública, auditada | ### Fluxograma de Decisão |Sim| Q2{Quer suporte 100% em português?} Q1 -->|Não| Q3{Prioridade é taxa baixa?} Q2 -->|Sim| R1[Mercado Bitcoin ou Foxbit] Q2 -->|Não| R2[Bitso — app intuitivo] Q3 -->|Sim| R3[Binance 0.10%] Q3 -->|Não| Q4{Quer muitas altcoins?} Q4 -->|Sim| R4[Binance] Q4 -->|Não| Q5{Quer futuros?} Q5 -->|Sim| R5[Binance ou Kraken] Q5 -->|Não| R6[Bitso] style R1 fill:#16a34a,color:#fff style R2 fill:#16a34a,color:#fff style R3 fill:#16a34a,color:#fff style R4 fill:#16a34a,color:#fff style R5 fill:#16a34a,color:#fff style R6 fill:#16a34a,color:#fff `} /> *** ## Recursos Adicionais ### Monitorando Preços com brapi.dev Acompanhe cotações de criptomoedas em tempo real usando a API da brapi.dev: ```typescript // Buscar cotação de Bitcoin via brapi.dev const response = await fetch( "https://brapi.dev/api/v2/crypto?coin=BTC¤cy=BRL", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }, } ); const { coins } = await response.json(); const btc = coins[0]; // Dados disponíveis: // btc.regularMarketPrice - Preço atual em BRL // btc.regularMarketChangePercent - Variação 24h (%) // btc.regularMarketVolume - Volume 24h // btc.marketCap - Capitalização de mercado ``` A API retorna dados como preço atual, variação 24h, volume e market cap para diversas criptomoedas. *** ## Perguntas Frequentes (FAQ) ### 1. Qual exchange tem a menor taxa? **Binance** e **Bitso** empatam com 0.10% maker/taker. A Binance ainda oferece desconto de 25% usando BNB para pagar taxas. ### 2. É seguro deixar criptomoedas na exchange? Para trading ativo, sim. Para holding de longo prazo, transfira para uma carteira própria. Lembre-se: "Not your keys, not your coins". ### 3. Preciso declarar operações em exchanges estrangeiras? Sim, operações acima de R$ 30.000/mês em exchanges estrangeiras devem ser declaradas no DeCripto. Veja nosso [guia de declaração](/blog/como-declarar-criptomoedas-imposto-renda-2026). ### 4. Posso usar exchange estrangeira após 2026? Depende. A Resolução BCB 519-521 exige que VASPs (incluindo exchanges) tenham autorização no Brasil. Exchanges que não se adequarem podem ter restrições. ### 5. Qual exchange tem mais moedas? **Binance** com 400+ moedas, seguida por Coinbase (200+) e Mercado Bitcoin (200+). ### 6. Qual a melhor para comprar Bitcoin especificamente? Para iniciantes, **Foxbit** ou **Mercado Bitcoin** pela simplicidade. Para menor taxa, **Binance** ou **Bitso**. ### 7. Exchanges reportam para a Receita Federal? Sim, exchanges brasileiras reportam automaticamente todas as operações. Exchanges estrangeiras podem reportar via DeCripto. *** ## Conclusão A escolha da exchange ideal depende do seu perfil: | Perfil | Exchange Recomendada | | ------------------------- | ------------------------- | | **Iniciante** | Mercado Bitcoin ou Foxbit | | **Foco em taxas** | Binance ou Bitso | | **Trader ativo** | Binance | | **Máxima segurança** | Mercado Bitcoin | | **Variedade de altcoins** | Binance | **Dicas finais:** 1. ✅ Use mais de uma exchange para diversificar risco 2. ✅ Ative sempre 2FA 3. ✅ Para valores altos, transfira para carteira própria 4. ✅ Compare taxas antes de grandes operações 5. ✅ Mantenha registros para declaração de IR Use a API da brapi.dev para acompanhar cotações e tomar decisões informadas sobre o melhor momento para comprar ou vender. *** *Disclaimer: Este comparativo é educacional e não constitui recomendação de uso de nenhuma exchange específica. Faça sua própria pesquisa antes de escolher uma plataforma.* # FII Screener com Python: Filtre Fundos Imobiliários por P/VP, DY e Segmento (2026) URL: /blog/fii-screener-python-filtrar-fundos-imobiliarios-pvp-dy.mdx Aprenda a construir um screener de FIIs em Python usando a API brapi. Filtre por P/VP, Dividend Yield, segmento e patrimônio para encontrar oportunidades. *** searchable: true title: 'FII Screener com Python: Filtre Fundos Imobiliários por P/VP, DY e Segmento (2026)' description: 'Aprenda a construir um screener de FIIs em Python usando a API brapi. Filtre por P/VP, Dividend Yield, segmento e patrimônio para encontrar oportunidades.' date: '2026-05-09' keywords: 'fii screener python, screener fundos imobiliários, filtrar fiis p/vp, fii dividend yield python, api fii brasil, encontrar fiis baratos, fii screener 2026, brapi fii python' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Fundos Imobiliários' readingTime: '18 min' tags: \['Python', 'FIIs', 'Screener', 'API', 'Análise Fundamentalista', 'Tutorial', 'Renda Passiva', 'P/VP', 'Dividend Yield'] relatedPosts: \['fundos-imobiliarios-fiis-guia-completo-iniciantes', 'api-fiis-brasil-indicadores-carteira-relatorios-dividendos', 'fiis-de-papel-vs-tijolo-comparativo-2026', 'stock-screener-python-brapi-filtrar-acoes'] featured: true expertise: 'Tutorial técnico para investidores que querem automatizar análise de FIIs com Python' lastReviewed: '2026-05-09' howToSteps: * name: 'Instalar dependências' text: 'Instale Python 3.10+, requests e pandas para manipular os dados retornados pela API brapi.' * name: 'Obter token de API' text: 'Crie uma conta gratuita em brapi.dev/dashboard e gere um token Pro para acessar os endpoints /api/v2/fii/\*.' * name: 'Listar FIIs com filtros' text: 'Use /api/v2/fii/list para puxar FIIs filtrados por segmento (papel, tijolo, híbrido, fof) e setor de atuação.' * name: 'Consultar indicadores fundamentalistas' text: 'Use /api/v2/fii/indicators para obter P/VP, Dividend Yield 12 meses, NAV e patrimônio dos FIIs filtrados.' * name: 'Aplicar filtros quantitativos' text: 'Combine os dados em um DataFrame pandas e aplique filtros de P/VP, DY mínimo, patrimônio e número de cotistas.' * name: 'Exportar resultados' text: 'Exporte o ranking final para CSV ou Excel para acompanhar as melhores oportunidades.' howToTools: \['Python 3.10+', 'requests', 'pandas', 'Token brapi.dev (plano Pro)'] *** import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > Em 2026, o universo de FIIs na bolsa brasileira já passa de **1.500 fundos**. Olhar um por um na "olho-metro" não escala. Neste tutorial você vai construir, do zero, um **screener de FIIs em Python** que filtra por P/VP, Dividend Yield, segmento e patrimônio — pronto para rodar todo dia. *** ## Por Que um Screener de FIIs? Quem investe em FIIs sabe: o mercado é **muito heterogêneo**. Você tem fundos de R$ 100 milhões e fundos de R$ 10 bilhões; FIIs com 90% em CRI e FIIs com 100% em galpão logístico; DY de 7% e DY de 16%. Sem uma forma sistemática de filtrar, você acaba caindo em três armadilhas comuns: 1. **Comprar pelo DY alto isolado** — o "yield trap" clássico. 2. **Pagar caro em P/VP elevado** — paga 1.20 numa cota de FII de papel cujo patrimônio é dinheiro. 3. **Ignorar liquidez e patrimônio** — entra num FII pequeno com spread enorme e sai no prejuízo. Um screener resolve isso aplicando os mesmos critérios numéricos a todos os fundos, todos os dias. Este tutorial usa exclusivamente os endpoints `/api/v2/fii/*` da brapi. Eles são exclusivos do plano **Pro**, mas você pode testar livremente o código usando os tickers do sandbox: **MXRF11** e **HGLG11**. *** ## O Que Vamos Construir Ao final deste artigo, você terá um script Python que: * Puxa **todos os FIIs** da bolsa brasileira via `/api/v2/fii/list` * Enriquece com indicadores via `/api/v2/fii/indicators` (em lote, até 20 por request) * Aplica filtros configuráveis (P/VP, DY, patrimônio, cotistas) * Gera um ranking ponderado * Exporta resultados para CSV / Excel Tempo estimado: **\~30 minutos**, mesmo que você esteja começando agora em Python. *** ## Pré-requisitos ### 1. Ambiente Python ```bash # Crie um diretório de projeto e ambiente virtual mkdir fii-screener && cd fii-screener python -m venv .venv source .venv/bin/activate # Linux/macOS # .venv\Scripts\activate # Windows pip install requests pandas openpyxl ``` ### 2. Token brapi Acesse [brapi.dev/dashboard](https://brapi.dev/dashboard), crie sua conta e gere um token. Para os endpoints de FIIs detalhados, é necessário o plano **Pro**. ```bash # Linux/macOS export BRAPI_TOKEN="seu_token_aqui" # Windows PowerShell # $env:BRAPI_TOKEN="seu_token_aqui" ``` *** ## Passo 1: Conhecendo os Endpoints Antes de codar, vamos entender a estrutura dos dados. A API de FIIs tem 6 endpoints principais — para o screener, vamos usar 2 deles: ### `GET /api/v2/fii/list` Retorna a lista de FIIs com indicadores resumidos. Aceita filtros: * `segmentType`: `papel`, `tijolo`, `hibrido`, `fof` * `segmentoAtuacao`: `Logística`, `Shoppings`, `Lajes Corporativas`, `Títulos e Val. Mob.`, etc. * `tipoGestao`: `Ativa` ou `Definida` * `mandate`: `Renda`, `Ganho de Capital`, `Híbrido` * `search`: busca textual por nome * `sortBy`, `sortOrder`, `page`, `limit` ```bash curl "https://brapi.dev/api/v2/fii/list?segmentType=tijolo&limit=10&sortBy=dividendYield12m&sortOrder=desc" ``` Resposta abreviada: ```json { "fiis": [ { "symbol": "HGLG11", "name": "CSHG Logística FII", "cnpj": "11.728.688/0001-47", "segmentType": "tijolo", "segmentoAtuacao": "Logística", "tipoGestao": "Ativa", "mandate": "Renda", "price": 156.05, "navPerShare": 171.48, "priceToNav": 0.91, "dividendYield12m": 0.0843 } ], "pagination": { "page": 1, "limit": 10, "totalItems": 412, "totalPages": 42 } } ``` ### `GET /api/v2/fii/indicators` Retorna **indicadores fundamentalistas detalhados** para FIIs específicos (até 20 símbolos por request): ```bash curl "https://brapi.dev/api/v2/fii/indicators?symbols=MXRF11,HGLG11,XPML11" ``` Resposta abreviada: ```json { "fiis": [ { "symbol": "HGLG11", "asOfDate": "2025-03-31", "price": 156.05, "navPerShare": 171.48, "priceToNav": 0.91, "dividendYield12m": 0.0843, "dividendYield1m": 0.0072, "monthlyReturn": -0.0032, "totalInvestors": 488272, "sharesOutstanding": 53850000, "equity": 9232380000.00, "totalAssets": 10147254000.00, "segmentType": "tijolo", "segmentoAtuacao": "Logística", "adminName": "Credit Suisse Hedging-Griffo Cor. de Valores S.A.", "managerName": "CSHG Logística Fundo de Invest. Imob." } ] } ``` *** ## Passo 2: Cliente HTTP em Python Crie um arquivo `brapi_fii.py` com a camada de acesso à API: ```python title="brapi_fii.py" import os import time from typing import Iterable import requests BASE_URL = "https://brapi.dev/api/v2/fii" TOKEN = os.getenv("BRAPI_TOKEN", "") HEADERS = {"Authorization": f"Bearer {TOKEN}"} if TOKEN else {} # A API aceita até 20 símbolos por request em /indicators MAX_SYMBOLS_PER_REQUEST = 20 def _get(path: str, params: dict | None = None) -> dict: """GET com retry simples para erros transitórios.""" url = f"{BASE_URL}{path}" for attempt in range(3): response = requests.get(url, params=params, headers=HEADERS, timeout=30) if response.status_code == 429: # Rate limit — espera e tenta de novo time.sleep(2 ** attempt) continue response.raise_for_status() return response.json() raise RuntimeError(f"Falha em {url} após 3 tentativas") def list_all_fiis( segment_type: str | None = None, segmento_atuacao: str | None = None, page_size: int = 100, ) -> list[dict]: """Pagina por todos os FIIs do filtro até esgotar os resultados.""" fiis: list[dict] = [] page = 1 while True: params = {"page": page, "limit": page_size} if segment_type: params["segmentType"] = segment_type if segmento_atuacao: params["segmentoAtuacao"] = segmento_atuacao data = _get("/list", params=params) fiis.extend(data.get("fiis", [])) pagination = data.get("pagination", {}) if not pagination.get("hasNextPage"): break page += 1 return fiis def get_indicators(symbols: Iterable[str]) -> list[dict]: """Busca indicadores em lotes de 20.""" symbols = list(symbols) out: list[dict] = [] for i in range(0, len(symbols), MAX_SYMBOLS_PER_REQUEST): batch = symbols[i : i + MAX_SYMBOLS_PER_REQUEST] data = _get("/indicators", params={"symbols": ",".join(batch)}) out.extend(data.get("fiis", [])) return out ``` Pontos importantes nesse cliente: * **Paginação automática** em `list_all_fiis` — você não precisa pensar em `page` quando chama. * **Lote de 20** em `get_indicators` — respeita o limite do endpoint. * **Retry com backoff** para erros 429 (rate limit) e instabilidades pontuais. *** ## Passo 3: Construindo o Screener Crie `screener.py` no mesmo diretório: ```python title="screener.py" from dataclasses import dataclass from datetime import datetime import pandas as pd from brapi_fii import get_indicators, list_all_fiis @dataclass class FilterConfig: """Critérios do screener — ajuste conforme sua estratégia.""" # P/VP máximo aceito (cuidado: papel não tolera P/VP muito acima de 1) max_price_to_nav: float = 1.05 # DY anual mínimo (12 meses) min_dividend_yield_12m: float = 0.08 # 8% # Patrimônio mínimo em R$ (filtro de tamanho/liquidez indireta) min_equity: float = 500_000_000 # R$ 500 mi # Mínimo de cotistas (proxy de liquidez e governança) min_investors: int = 5_000 # Segmentos permitidos (None = todos) allowed_segments: tuple[str, ...] | None = None def fetch_fii_universe(segment_type: str | None = None) -> list[str]: """Retorna a lista de tickers do segmento solicitado.""" fiis = list_all_fiis(segment_type=segment_type) return [fii["symbol"] for fii in fiis if fii.get("symbol")] def build_dataframe(symbols: list[str]) -> pd.DataFrame: """Constrói um DataFrame com indicadores fundamentalistas dos FIIs.""" indicators = get_indicators(symbols) df = pd.DataFrame(indicators) # Garantir tipos numéricos (algumas APIs retornam string) numeric_cols = [ "price", "navPerShare", "priceToNav", "dividendYield12m", "dividendYield1m", "monthlyReturn", "totalInvestors", "sharesOutstanding", "equity", "totalAssets", ] for col in numeric_cols: if col in df.columns: df[col] = pd.to_numeric(df[col], errors="coerce") return df def apply_filters(df: pd.DataFrame, config: FilterConfig) -> pd.DataFrame: """Aplica os filtros do screener.""" mask = ( df["priceToNav"].le(config.max_price_to_nav) & df["dividendYield12m"].ge(config.min_dividend_yield_12m) & df["equity"].ge(config.min_equity) & df["totalInvestors"].ge(config.min_investors) ) if config.allowed_segments: mask &= df["segmentType"].isin(config.allowed_segments) return df[mask].copy() def rank_by_quality(df: pd.DataFrame) -> pd.DataFrame: """Cria um score 0-100 combinando DY, desconto P/VP e tamanho.""" df = df.copy() # Normaliza cada métrica em rank 0-1 (1 = melhor) df["rank_dy"] = df["dividendYield12m"].rank(pct=True) df["rank_discount"] = (1 - df["priceToNav"]).rank(pct=True) df["rank_size"] = df["equity"].rank(pct=True) # Score combinado (pesos ajustáveis) df["score"] = ( df["rank_dy"] * 0.45 + df["rank_discount"] * 0.35 + df["rank_size"] * 0.20 ) * 100 return df.sort_values("score", ascending=False) ``` *** ## Passo 4: Rodando o Screener Crie `run.py`: ```python title="run.py" from datetime import date from screener import FilterConfig, apply_filters, build_dataframe, fetch_fii_universe, rank_by_quality def main() -> None: # 1) Universo: todos os FIIs (ou filtre por segmentType) print("Listando todos os FIIs...") symbols = fetch_fii_universe() print(f" {len(symbols)} FIIs encontrados") # 2) Indicadores em lote print("Buscando indicadores fundamentalistas...") df = build_dataframe(symbols) print(f" {len(df)} FIIs com indicadores") # 3) Filtros de qualidade config = FilterConfig( max_price_to_nav=1.05, min_dividend_yield_12m=0.09, # 9% min_equity=500_000_000, min_investors=5_000, allowed_segments=("tijolo", "hibrido"), # Foco em real estate ) filtered = apply_filters(df, config) print(f" {len(filtered)} FIIs passaram nos filtros") # 4) Ranking ponderado ranked = rank_by_quality(filtered) # 5) Top 20 + colunas relevantes cols = [ "symbol", "segmentType", "segmentoAtuacao", "price", "priceToNav", "dividendYield12m", "dividendYield1m", "equity", "totalInvestors", "score", ] top = ranked[cols].head(20) print("\nTop 20 do screener:") print(top.to_string(index=False)) # 6) Exportar today = date.today().isoformat() ranked.to_csv(f"fii_screener_{today}.csv", index=False) ranked.to_excel(f"fii_screener_{today}.xlsx", index=False, engine="openpyxl") print(f"\nResultados salvos em fii_screener_{today}.csv / .xlsx") if __name__ == "__main__": main() ``` Execute: ```bash python run.py ``` Saída esperada (resumida): ``` Listando todos os FIIs... 1247 FIIs encontrados Buscando indicadores fundamentalistas... 1247 FIIs com indicadores 38 FIIs passaram nos filtros Top 20 do screener: symbol segmentType segmentoAtuacao price priceToNav dividendYield12m ... score HGLG11 tijolo Logística 156.05 0.91 0.0843 ... 91.4 BTLG11 tijolo Logística 100.10 0.94 0.0901 ... 88.7 ... ``` *** ## Passo 5: Variações da Estratégia O screener acima é genérico. Vamos ver três receitas prontas para copiar. ### Receita 1: Caçando FIIs de Papel com Margem de Segurança FIIs de papel **não devem** ser comprados muito acima de P/VP 1.00 — o patrimônio é dinheiro indexado a IPCA ou CDI, e pagar prêmio sobre dinheiro é furada de longo prazo. ```python config_papel = FilterConfig( max_price_to_nav=0.98, # Desconto sobre VP min_dividend_yield_12m=0.12, # 12%+ DY min_equity=300_000_000, min_investors=3_000, allowed_segments=("papel",), ) ``` ### Receita 2: FIIs de Logística — High Conviction Em ciclos de juros caindo, logística costuma performar bem (e-commerce + custo de capital menor): ```python # Substitua a linha em fetch_fii_universe: symbols = [ fii["symbol"] for fii in list_all_fiis(segmento_atuacao="Logística") if fii.get("symbol") ] config_logistica = FilterConfig( max_price_to_nav=1.10, # Tijolo aceita prêmio em ativos premium min_dividend_yield_12m=0.07, min_equity=1_000_000_000, # Apenas grandes min_investors=20_000, allowed_segments=("tijolo",), ) ``` ### Receita 3: Renda Mensal Pura (DY 1m alto e estável) Para quem quer fluxo de caixa **agora**, foque no DY do último mês ajustado pelo tamanho: ```python def rank_renda_mensal(df: pd.DataFrame) -> pd.DataFrame: df = df.copy() df["rank_dy_1m"] = df["dividendYield1m"].rank(pct=True) df["rank_size"] = df["equity"].rank(pct=True) df["score"] = (df["rank_dy_1m"] * 0.7 + df["rank_size"] * 0.3) * 100 return df.sort_values("score", ascending=False) ``` *** ## Passo 6: Automatize com Cron Quer rodar o screener todo dia às 19h (após o fechamento do pregão)? ```bash # crontab -e 0 19 * * 1-5 cd /caminho/fii-screener && /caminho/.venv/bin/python run.py >> screener.log 2>&1 ``` Ou em Windows com Task Scheduler. Você acumula um histórico de CSVs com a evolução do ranking — útil para identificar FIIs que entraram/saíram da sua "watchlist" recentemente. *** ## Passo 7: Adicionando Histórico de P/VP O P/VP atual vale pouco sem comparação histórica. Use [`/api/v2/fii/indicators/history`](/docs/fiis/indicadores-historico) para checar se um FII está realmente "barato": ```python def historical_pvp_zscore(symbol: str, lookback_months: int = 24) -> float: """Z-score do P/VP atual versus mediana dos últimos N meses.""" from brapi_fii import _get data = _get("/indicators/history", params={"symbols": symbol}) history = data.get("history", []) pvps = [ row["priceToNav"] for row in history[-lookback_months:] if row.get("priceToNav") is not None ] if len(pvps) < 6: return 0.0 import statistics median = statistics.median(pvps) stdev = statistics.stdev(pvps) if stdev == 0: return 0.0 current = pvps[-1] return (current - median) / stdev ``` Z-score **negativo** = P/VP atual abaixo da mediana histórica (FII descontado). Combine com o screener para priorizar FIIs que estão simultaneamente: 1. Bons fundamentais (passam no `apply_filters`) 2. Baratos historicamente (z-score do P/VP \< -0.5) *** ## Cuidados Importantes Um FII com P/VP 0.70 pode estar "barato" por um motivo válido — vacância alta, contratos vencendo, gestão problemática. Sempre **leia o relatório gerencial** antes de comprar (`/api/v2/fii/reports`). Dividendos passados não são distribuições futuras. FIIs com DY de 18% frequentemente têm renda extraordinária (venda de imóvel, recebíveis pontuais) que não se repete. Cheque `dividendYield1m` e o relatório CVM. O número de cotistas (`totalInvestors`) é um proxy melhor de liquidez do que o volume diário, que oscila bastante. FIIs com menos de 5.000 cotistas costumam ter spread bid-ask largo demais para entrada e saída sem custo. *** ## Indo Além A partir desse esqueleto, você pode evoluir o screener para: * **Alertas automáticos** via Telegram quando um novo FII entra na watchlist (combine com [bot Telegram](/blog/bot-telegram-cotacoes-acoes-python-tutorial)) * **Dashboard web** com Streamlit ou Next.js * **Backtests** comparando o desempenho de carteiras montadas pelo screener vs IFIX * **Análise de relatórios** com [`/api/v2/fii/reports`](/docs/fiis/relatorios) para filtrar por composição patrimonial (ex.: FIIs com >70% em CRI High Grade) Tudo isso fica como exercício para o leitor — a base do dado já está aí. *** ## Conclusão Um screener é a forma mais escalável de processar 1.500+ FIIs sem fadiga. Com \~150 linhas de Python e a API `/api/v2/fii/*` da brapi você sai de "qual FII comprar?" para uma shortlist de 20 candidatos com critérios objetivos — todo dia útil. Comece simples: rode o `FilterConfig` padrão, exporte para Excel, leia os relatórios dos top 5. Em 1 mês você terá refinado os parâmetros para sua tese e estará operando com **muito mais convicção**. > **Próximos passos:** explore os outros endpoints da família `/api/v2/fii/*` na [documentação oficial](/docs/fiis), ou veja o [guia de FIIs para iniciantes](/blog/fundos-imobiliarios-fiis-guia-completo-iniciantes) se ainda está se familiarizando com os indicadores. *Disclaimer: este artigo é educacional e não constitui recomendação de investimento. Rentabilidade passada não garante rentabilidade futura. Faça sua própria análise.* # FIIs de Papel vs Tijolo: Diferenças, Riscos e Como Escolher URL: /blog/fiis-de-papel-vs-tijolo-comparativo-2026.mdx Compare FIIs de papel e tijolo por fonte de renda, sensibilidade aos juros, inflação, crédito, vacância e indicadores que realmente ajudam na análise. *** searchable: true title: 'FIIs de Papel vs Tijolo: Diferenças, Riscos e Como Escolher' description: 'Compare FIIs de papel e tijolo por fonte de renda, sensibilidade aos juros, inflação, crédito, vacância e indicadores que realmente ajudam na análise.' date: '2026-01-01' keywords: 'fiis de papel vs tijolo, fii papel ou tijolo, diferença fii papel tijolo, fundo imobiliário papel, fundo imobiliário tijolo' author: 'Alisson Leal' category: 'Fundos Imobiliários' subcategory: 'Comparação de FIIs' readingTime: '8 min' tags: \['FIIs', 'Papel', 'Tijolo', 'Renda Imobiliária', 'CRI', 'Vacância'] relatedPosts: \['fundos-imobiliarios-fiis-guia-completo-iniciantes', 'api-fiis-brasil-indicadores-carteira-relatorios-dividendos', 'fii-screener-python-filtrar-fundos-imobiliarios-pvp-dy'] featured: true expertise: 'Análise de fundos imobiliários e dados regulatórios da CVM' lastReviewed: '2026-07-17' -------------------------- import { Author, Authors } from '~/components/Authors'; FIIs de tijolo recebem renda de imóveis, principalmente aluguéis. FIIs de papel investem em crédito imobiliário, sobretudo CRIs. Um não é melhor que o outro em qualquer cenário. Eles carregam riscos diferentes. ## Comparação rápida | Aspecto | FIIs de tijolo | FIIs de papel | | ------------------------ | ------------------------------------------ | ---------------------------------------------- | | Fonte principal de renda | Aluguel e exploração de imóveis | Juros e correção de títulos imobiliários | | Ativo central | Galpões, lojas, escritórios, hospitais | CRIs e outros recebíveis | | Risco operacional | Vacância, inadimplência e custos do imóvel | Crédito, garantias e estrutura da dívida | | Sensibilidade | Mercado imobiliário e contratos | Juros, inflação e qualidade dos devedores | | Dado que merece atenção | Vacância e concentração de inquilinos | Indexadores, spreads e concentração de crédito | Fundos híbridos podem combinar as duas exposições. FOFs investem em cotas de outros FIIs e acrescentam uma camada de gestão e custos. ## Como funciona um FII de tijolo O fundo compra ou desenvolve imóveis e recebe receitas como aluguel, estacionamento ou participação no faturamento. O resultado depende da ocupação, dos contratos e das despesas do portfólio. Uma vacância baixa não basta. Verifique também: * concentração em poucos imóveis ou inquilinos; * prazo e tipo dos contratos; * revisões de aluguel; * localização e qualidade dos ativos; * necessidade de reformas; * dívidas e obrigações do fundo. Uma laje corporativa, um shopping e um galpão logístico têm ciclos e métricas operacionais diferentes. Compare fundos do mesmo segmento antes de concluir que um número é alto ou baixo. ## Como funciona um FII de papel O fundo compra títulos ligados ao mercado imobiliário. Um CRI pode pagar uma taxa prefixada ou combinar um indexador, como IPCA ou CDI, com um spread. O rendimento maior pode compensar risco maior. Antes de olhar apenas o dividend yield, confira: * qualidade e concentração dos devedores; * garantias e relação entre dívida e garantia; * indexadores da carteira; * prazo dos títulos; * atrasos, renegociações e provisões; * subordinação e estrutura de cada operação. FII de papel não é renda fixa. A cota oscila, os créditos podem dar problema e o rendimento mensal pode mudar. ## O efeito dos juros Juros altos podem elevar a receita de papéis indexados ao CDI. Papéis ligados à inflação respondem ao índice e às condições de cada contrato. Ao mesmo tempo, taxas maiores alteram o preço exigido pelos investidores. Uma renda mensal alta não impede a cota de cair. Nos FIIs de tijolo, juros altos podem pressionar as cotações e a atividade econômica. O impacto operacional depende dos contratos, da demanda por imóveis e da capacidade de repassar inflação aos aluguéis. Não use uma regra como "Selic alta é sempre boa para papel". O indexador é apenas uma parte da carteira de risco. ## Indicadores que ajudam P/VP compara o preço da cota com o valor patrimonial por cota. Ele serve como ponto de partida, mas o valor patrimonial também pode ficar defasado ou depender de premissas de avaliação. Dividend yield mostra a distribuição passada em relação ao preço. Ele não garante o próximo pagamento e pode subir porque a cota caiu. Para tijolo, acrescente vacância, área, concentração e evolução dos aluguéis. Para papel, acrescente composição da carteira, indexadores, garantias e eventos de crédito. ## Consultar os dados por API A brapi permite filtrar fundos por tipo: ```bash curl "https://brapi.dev/api/v2/fii/list?segmentType=papel&limit=20" ``` ```bash curl "https://brapi.dev/api/v2/fii/list?segmentType=tijolo&limit=20" ``` Para comparar indicadores: ```bash curl "https://brapi.dev/api/v2/fii/indicators?symbols=MXRF11,HGLG11" ``` FIIs de tijolo pedem ainda `/properties` e `/portfolio`. Nos fundos de papel, `/portfolio` e `/reports` ajudam a entender a composição dos ativos. O fluxo completo está em [API de FIIs: indicadores, carteira, imóveis e dividendos](/blog/api-fiis-brasil-indicadores-carteira-relatorios-dividendos). ## Como escolher entre papel e tijolo Escolha a partir do risco que você entende e aceita, não do maior rendimento do mês. Um investidor pode combinar os dois tipos para não depender de uma única fonte de renda. Isso não dispensa a análise de cada fundo e não define uma proporção universal. Antes de comprar, responda: 1. de onde vem o dinheiro distribuído; 2. qual evento pode reduzir essa receita; 3. onde está a maior concentração; 4. quais dados confirmam a tese; 5. o que faria você revisar a posição. Se a resposta depende apenas do dividend yield atual, a análise ainda está incompleta. # Fluxo de Caixa Descontado (DCF) 2026: Como Calcular o Valor Justo de Ações URL: /blog/fluxo-de-caixa-descontado-valuation.mdx Aprenda a fazer valuation por Fluxo de Caixa Descontado. Tutorial completo com fórmulas, exemplos práticos e código Python para calcular o valor intrínseco ✓ *** searchable: true title: 'Fluxo de Caixa Descontado (DCF) 2026: Como Calcular o Valor Justo de Ações' description: 'Aprenda a fazer valuation por Fluxo de Caixa Descontado. Tutorial completo com fórmulas, exemplos práticos e código Python para calcular o valor intrínseco ✓' date: '2026-01-01' keywords: 'fluxo de caixa descontado 2026, dcf valuation, valor intrinseco acao, como calcular valor justo, valuation empresas, wacc calculo, fcf free cash flow' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Valuation' readingTime: '25 min' tags: \['Valuation', 'DCF', 'Fluxo de Caixa', 'Análise Fundamentalista', 'Value Investing'] relatedPosts: \[ 'margem-de-seguranca-benjamin-graham', 'formula-graham-como-calcular-preco-justo-acoes-value-investing', 'entendendo-indicador-preco-lucro-pl-analise-fundamentalista', 'metodo-bazin-estrategia-renda-passiva-acoes-dividendos', ] featured: true expertise: 'Equipe de analistas especializados em valuation e modelagem financeira' lastReviewed: 2026-01-03 ------------------------ ## Introdução O **Fluxo de Caixa Descontado (DCF - Discounted Cash Flow)** é considerado o método mais robusto de valuation. Enquanto múltiplos como P/L e P/VP oferecem uma visão rápida, o DCF calcula o valor intrínseco de uma empresa baseado no que realmente importa: **a capacidade de gerar caixa no futuro**. Neste guia completo, você aprenderá: * Fundamentos teóricos do DCF * Como calcular o Free Cash Flow (FCF) * Taxa de desconto (WACC) na prática * Valor terminal e perpetuidade * Implementação em Python com brapi.dev * Análise de sensibilidade {/* Separator */} *** ## O que é Fluxo de Caixa Descontado? ### Conceito Fundamental > "O valor de qualquer ativo é o valor presente dos fluxos de caixa futuros que ele irá gerar." > — Aswath Damodaran ``` ┌─────────────────────────────────────────────────────────────┐ │ CONCEITO DCF │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Valor Hoje = Soma dos Fluxos de Caixa Futuros │ │ ──────────────────────────────── │ │ (1 + taxa de desconto)^n │ │ │ │ Exemplo: │ │ ├─ FCF Ano 1: R$ 100 / (1.12)¹ = R$ 89.29 │ │ ├─ FCF Ano 2: R$ 110 / (1.12)² = R$ 87.69 │ │ ├─ FCF Ano 3: R$ 121 / (1.12)³ = R$ 86.13 │ │ └─ ... │ │ │ │ Valor Total = Soma de todos os valores presentes │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Componentes do DCF | Componente | Descrição | Como Obter | | ----------------------- | ---------------------------- | -------------------------- | | **FCF** | Fluxo de Caixa Livre | DRE + DFC da empresa | | **Taxa de Desconto** | WACC ou Custo de Equity | Cálculo (detalhado abaixo) | | **Período de Projeção** | Normalmente 5-10 anos | Análise do setor | | **Valor Terminal** | Valor após período explícito | Perpetuidade ou múltiplo | ### Fórmula Geral ``` n FCFₜ TV Valor Empresa = Σ ────────── + ────────── t=1 (1 + WACC)ᵗ (1 + WACC)ⁿ Onde: - FCFₜ = Free Cash Flow no ano t - WACC = Custo Médio Ponderado de Capital - TV = Terminal Value (Valor Terminal) - n = Número de anos projetados ``` *** ## Passo 1: Calcular o Free Cash Flow (FCF) ### Fórmula do FCF **Free Cash Flow to Firm (FCFF):** ``` FCF = EBIT × (1 - t) + D&A - CAPEX - Δ Capital de Giro Onde: - EBIT = Lucro operacional - t = Taxa de imposto (34% no Brasil) - D&A = Depreciação e Amortização - CAPEX = Investimentos em ativos fixos - Δ Capital de Giro = Variação no capital de giro ``` **Exemplo de cálculo:** | Componente | Valor | | --------------------- | -------------- | | EBIT | R$ 5,00 bi | | Taxa de Imposto | 34% | | NOPAT (EBIT × 0,66) | R$ 3,30 bi | | (+) Depreciação | R$ 0,80 bi | | (-) CAPEX | R$ 1,20 bi | | (-) Δ Capital de Giro | R$ 0,20 bi | | **= FCF** | **R$ 2,70 bi** | ### Obtendo Dados com brapi.dev ```typescript // Obter dados para cálculo do FCF via brapi.dev const response = await fetch( "https://brapi.dev/api/quote/WEGE3?modules=incomeStatementHistory,cashflowHistory", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); const income = results[0].incomeStatementHistory?.[0]; const cashflow = results[0].cashflowHistory?.[0]; const ebit = income?.ebit || 0; const depreciacao = cashflow?.depreciation || 0; const capex = Math.abs(cashflow?.capitalExpenditures || 0); const variacaoCG = cashflow?.changeInWorkingCapital || 0; // Calcular FCF const taxaImposto = 0.34; const nopat = ebit * (1 - taxaImposto); const fcf = nopat + depreciacao - capex - variacaoCG; ``` ### FCF Histórico e Projeção ``` ┌─────────────────────────────────────────────────────────────┐ │ FCF HISTÓRICO E PROJETADO (R$ milhões) │ ├─────────────────────────────────────────────────────────────┤ │ │ │ HISTÓRICO │ PROJETADO │ │ ────────── │ ────────── │ │ 2022: R$ 2.100 │ 2026: R$ 3.200 (+10%) │ │ 2023: R$ 2.450 │ 2026: R$ 3.520 (+10%) │ │ 2024: R$ 2.900 │ 2027: R$ 3.872 (+10%) │ │ │ 2028: R$ 4.065 (+5%) │ │ Cresc. médio: 17% │ 2029: R$ 4.268 (+5%) │ │ │ Após: 3% perpetuidade │ │ │ └─────────────────────────────────────────────────────────────┘ ``` *** ## Passo 2: Calcular a Taxa de Desconto (WACC) ### O que é WACC? O **WACC (Weighted Average Cost of Capital)** representa o custo médio ponderado do capital da empresa, considerando dívida e equity. **Fórmula do WACC:** ``` WACC = Ke × We + Kd × (1 - t) × Wd Onde: - Ke = Custo do Equity - Kd = Custo da Dívida - t = Taxa de imposto - We = Peso do Equity - Wd = Peso da Dívida ``` **Exemplo de cálculo:** | Componente | Valor | | -------------------- | ------------------------------------------- | | Custo do Equity (Ke) | 14% | | Custo da Dívida (Kd) | 10% | | Taxa de Imposto | 34% | | Peso Equity | 70% | | Peso Dívida | 30% | | **WACC** | **14% × 0,70 + 10% × 0,66 × 0,30 = 11,78%** | ### Calculando o Custo do Equity (CAPM) **Fórmula do CAPM:** ``` Ke = Rf + β × (Rm - Rf) + CRP Onde: - Rf = Taxa livre de risco (Selic) - β = Beta da ação - Rm - Rf = Prêmio de risco do mercado - CRP = Country Risk Premium (risco país) ``` **Exemplo para Brasil (2026):** | Componente | Valor | | ------------------- | ------------------------------------ | | Taxa Selic (Rf) | 11,75% | | Beta WEGE3 | 0,85 | | Prêmio de Mercado | 5,0% | | Risco País (CDS) | 2,0% | | **Custo do Equity** | **11,75% + 0,85 × 5% + 2% = 18,00%** | ### Obtendo Beta via brapi.dev ```typescript // Obter beta de uma ação via brapi.dev const response = await fetch( "https://brapi.dev/api/quote/WEGE3?modules=defaultKeyStatistics,financialData", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); const beta = results[0].defaultKeyStatistics?.beta || 1.0; // Calcular custo do equity (CAPM) const selic = 0.1175; const premioMercado = 0.05; const riscoPais = 0.02; const custoEquity = selic + beta * premioMercado + riscoPais; ``` ``` ### Tabela de Referência WACC por Setor | Setor | WACC Típico Brasil | |-------|-------------------| | Utilities (Energia) | 8-10% | | Bancos | 10-12% | | Consumo Básico | 10-12% | | Indústria | 11-14% | | Varejo | 12-15% | | Tecnologia | 14-18% | | Small Caps | 15-20% | --- ## Passo 3: Calcular o Valor Terminal ### Método da Perpetuidade (Gordon Growth) **Fórmula do Valor Terminal:** ``` TV = FCF(n+1) / (WACC - g) Onde: * FCF(n+1) = FCF do primeiro ano após projeção * g = Taxa de crescimento na perpetuidade ``` **Exemplo de cálculo:** | Componente | Valor | |------------|-------| | FCF Ano 5 | R$ 4,27 bi | | Crescimento Perpétuo (g) | 3% | | WACC | 12% | | FCF Perpétuo (Ano 6) | R$ 4,40 bi | | **Valor Terminal** | **R$ 4,40 bi / (0,12 - 0,03) = R$ 48,85 bi** | > ⚠️ **Importante:** O WACC deve ser sempre maior que g, caso contrário o valor terminal seria infinito. ### Método do Múltiplo de Saída **Fórmula:** ``` TV = EBITDA(n) × Múltiplo ``` **Exemplo de cálculo:** | Componente | Valor | |------------|-------| | EBITDA Ano 5 | R$ 6,00 bi | | Múltiplo EV/EBITDA | 8x | | **Valor Terminal** | **R$ 48,00 bi** | ### Qual Método Usar? | Método | Quando Usar | Vantagem | Desvantagem | |--------|-------------|----------|-------------| | Perpetuidade | Empresas estáveis | Teoricamente correto | Sensível a g | | Múltiplo | Comparação setorial | Simples | Depende do setor | | Média | Conservador | Reduz erro | Menos preciso | --- ## Passo 4: Modelo DCF Completo ### Implementação Passo a Passo O modelo DCF completo segue estes passos: **1. Projetar FCFs futuros:** | Ano | Taxa de Crescimento | FCF Projetado | |-----|---------------------|---------------| | 1 | 12% | R$ 2,80 bi | | 2 | 12% | R$ 3,14 bi | | 3 | 10% | R$ 3,45 bi | | 4 | 8% | R$ 3,73 bi | | 5 | 6% | R$ 3,95 bi | **2. Descontar FCFs a valor presente:** | Ano | FCF | Fator (1+WACC)^n | VP do FCF | |-----|-----|------------------|-----------| | 1 | R$ 2,80 bi | 1,12 | R$ 2,50 bi | | 2 | R$ 3,14 bi | 1,25 | R$ 2,51 bi | | 3 | R$ 3,45 bi | 1,40 | R$ 2,46 bi | | 4 | R$ 3,73 bi | 1,57 | R$ 2,37 bi | | 5 | R$ 3,95 bi | 1,76 | R$ 2,24 bi | | **Soma** | | | **R$ 12,08 bi** | **3. Calcular e descontar Valor Terminal:** - Valor Terminal: R$ 45,2 bi - VP do Terminal: R$ 25,7 bi **4. Calcular valor da empresa:** - Soma VPs FCFs: R$ 12,08 bi - VP Terminal: R$ 25,7 bi - **Valor Empresa: R$ 37,78 bi** **5. Calcular preço justo:** - Valor Empresa: R$ 37,78 bi - (-) Dívida Líquida: R$ 2,00 bi - Valor Equity: R$ 35,78 bi - Ações: 2,1 bi - **Preço Justo: R$ 17,04** ### Exemplo Prático: Valuation WEGE3 **Parâmetros do modelo (valores ilustrativos):** | Parâmetro | Valor | |-----------|-------| | FCF Atual | R$ 2,5 bi | | Anos de Projeção | 5 | | Crescimento Anos 1-2 | 12% | | Crescimento Anos 3-5 | 10%, 8%, 6% | | WACC | 12% | | Crescimento Perpétuo | 3% | | Dívida Líquida | R$ 2,0 bi | | Ações Outstanding | 2,1 bi | **Resultado do DCF:** ``` ╔══════════════════════════════════════════════════════════════╗ ║ DCF VALUATION - WEGE3 ║ ╠══════════════════════════════════════════════════════════════╣ ║ ║ ║ FCFs Projetados (R$ bi): ║ ║ Ano 1: 2.80 Ano 2: 3.14 Ano 3: 3.45 ║ ║ Ano 4: 3.73 Ano 5: 3.95 ║ ║ ║ ║ Valor Terminal: R$ 45.23 bi ║ ║ Valor Terminal VP: R$ 25.68 bi ║ ║ ║ ║ Valor da Empresa: R$ 37.76 bi ║ ║ (-) Dívida Líquida: R$ 2.00 bi ║ ║ (=) Valor do Equity: R$ 35.76 bi ║ ║ ║ ║ ═══════════════════════════════════════════════════════ ║ ║ PREÇO JUSTO: R$ 17.03 ║ ║ ═══════════════════════════════════════════════════════ ║ ║ ║ ║ % Valor no Terminal: 68.0% ║ ║ ║ ╚══════════════════════════════════════════════════════════════╝ ```` ```typescript // Implementação simplificada do DCF em TypeScript async function runDCF(ticker: string, params: DCFParams) { // Obter dados via brapi.dev const response = await fetch( `https://brapi.dev/api/quote/${ticker}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); // 1. Projetar FCFs const fcfs: number[] = []; let fcf = params.fcfAtual; for (const taxa of params.taxasCrescimento) { fcf = fcf * (1 + taxa); fcfs.push(fcf); } // 2. Descontar FCFs const fcfsVP = fcfs.map((f, i) => f / Math.pow(1 + params.wacc, i + 1)); // 3. Valor Terminal const tv = fcfs[fcfs.length - 1] * (1 + params.crescimentoPerpetuo) / (params.wacc - params.crescimentoPerpetuo); const tvVP = tv / Math.pow(1 + params.wacc, params.anosProjecao); // 4. Preço Justo const valorEmpresa = fcfsVP.reduce((a, b) => a + b, 0) + tvVP; const valorEquity = valorEmpresa - params.dividaLiquida; const precoJusto = valorEquity / params.acoesOutstanding; return { precoJusto, valorEmpresa, valorEquity }; } ```` ```` --- ## Análise de Sensibilidade ### Por que é Importante? O DCF é muito sensível a pequenas mudanças nos inputs. A análise de sensibilidade mostra como o preço justo varia com diferentes premissas. **Tabela de Sensibilidade: WACC × Crescimento Perpétuo** | WACC ↓ / g → | 2,0% | 2,5% | 3,0% | 3,5% | 4,0% | |--------------|------|------|------|------|------| | **10%** | R$ 38,50 | R$ 42,30 | R$ 47,20 | R$ 53,80 | R$ 63,50 | | **11%** | R$ 32,10 | R$ 34,80 | R$ 38,20 | R$ 42,50 | R$ 48,20 | | **12%** | R$ 27,30 | R$ 29,30 | R$ 31,80 | R$ 34,90 | R$ 38,90 | | **13%** | R$ 23,60 | R$ 25,10 | R$ 27,00 | R$ 29,30 | R$ 32,20 | | **14%** | R$ 20,70 | R$ 21,80 | R$ 23,30 | R$ 25,00 | R$ 27,10 | **Interpretação:** - Uma diferença de 1% no WACC pode alterar o preço justo em ~15-20% - Uma diferença de 0,5% no crescimento perpétuo pode alterar o preço em ~10% - Use cenários (pessimista, base, otimista) para definir faixas de preço justo ```typescript // Análise de sensibilidade via brapi.dev interface SensitivityResult { wacc: number; crescimento: number; precoJusto: number; } const waccRange = [0.10, 0.11, 0.12, 0.13, 0.14]; const crescimentoRange = [0.02, 0.025, 0.03, 0.035, 0.04]; const resultados: SensitivityResult[] = []; for (const wacc of waccRange) { for (const g of crescimentoRange) { const precoJusto = calcularDCF({ ...paramsBase, wacc, crescimentoPerpetuo: g }); resultados.push({ wacc, crescimento: g, precoJusto }); } } ```` *** ## Erros Comuns no DCF ### 1. Crescimento Perpétuo Muito Alto ``` ❌ ERRADO: g = 5% (acima do PIB de longo prazo) ✅ CORRETO: g = 2-3% (linha com inflação + PIB real) Regra: Crescimento perpétuo não deve exceder crescimento do PIB ``` ### 2. Valor Terminal Domina ``` ⚠️ Se >70% do valor vem do Terminal Value, as projeções de curto prazo importam pouco. Solução: Aumente o período de projeção ou seja mais conservador no TV. ``` ### 3. FCF Inconsistente ``` ❌ ERRADO: Usar FCF de um único ano (pode ser atípico) ✅ CORRETO: Normalizar FCF usando média de 3-5 anos ``` ### 4. WACC Subestimado ``` Componentes frequentemente esquecidos: - Risco país (Brasil: 200-400 bps) - Prêmio por iliquidez (small caps: 200-400 bps) - Prêmio de tamanho ``` *** ## DCF vs Outros Métodos ### Comparativo de Métodos de Valuation | Método | Complexidade | Quando Usar | Limitações | | ------------- | ------------ | ------------------------------------ | --------------------------- | | **DCF** | Alta | Empresas estáveis com FCF previsível | Sensível a premissas | | **P/L** | Baixa | Comparação rápida | Ignora estrutura de capital | | **EV/EBITDA** | Média | Empresas com dívida | Ignora CAPEX | | **Graham** | Média | Value investing conservador | Empresas maduras apenas | | **DDM** | Média | Dividend payers | Ignora crescimento | ### Quando NÃO Usar DCF 1. **Startups** - FCF negativo, crescimento imprevisível 2. **Empresas cíclicas** - Lucros voláteis 3. **Turnarounds** - Histórico não confiável 4. **Bancos** - Usar múltiplos específicos (P/VP, ROE) *** ## Modelo Simplificado para Uso Rápido **DCF Rápido - Passos:** 1. Obter EPS (lucro por ação) da empresa 2. Estimar crescimento (máx. 15% para ser conservador) 3. Converter EPS em FCF (usar 70% como proxy) 4. Aplicar taxas padrão (WACC 12%, g perpétuo 3%) 5. Calcular margem de segurança **Exemplo - WEGE3:** | Etapa | Cálculo | Valor | | -------------------- | ------------------------ | ------------ | | EPS | Dado brapi.dev | R$ 1,20 | | FCF por ação | EPS × 0,70 | R$ 0,84 | | Crescimento | Min(earningsGrowth, 15%) | 12% | | VP dos FCFs (5 anos) | Σ descontados | R$ 4,50 | | Valor Terminal VP | FCF₅ × (1+g) / (WACC-g) | R$ 10,20 | | **Preço Justo** | VP FCFs + TV VP | **R$ 14,70** | | Preço Atual | Dado brapi.dev | R$ 35,00 | | Margem de Segurança | (Justo - Atual) / Justo | -138% | | Recomendação | Margem > 25%? | EVITAR | ```typescript // DCF simplificado via brapi.dev const response = await fetch( "https://brapi.dev/api/quote/WEGE3?modules=defaultKeyStatistics,financialData", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); const eps = results[0].earningsPerShare || 0; const crescimento = Math.min(results[0].financialData?.earningsGrowth || 0.05, 0.15); const fcfPorAcao = eps * 0.7; const wacc = 0.12; const gPerpetuo = 0.03; const anos = 5; // VP dos FCFs let vpTotal = 0; let fcf = fcfPorAcao; for (let ano = 1; ano <= anos; ano++) { fcf = fcf * (1 + crescimento * (1 - ano / 10)); // Desaceleração vpTotal += fcf / Math.pow(1 + wacc, ano); } // Valor Terminal const tv = fcf * (1 + gPerpetuo) / (wacc - gPerpetuo); const tvVP = tv / Math.pow(1 + wacc, anos); const precoJusto = vpTotal + tvVP; const precoAtual = results[0].regularMarketPrice; const margem = ((precoJusto - precoAtual) / precoJusto) * 100; const recomendacao = margem > 25 ? "COMPRA" : margem > 0 ? "NEUTRO" : "EVITAR"; ``` ``` --- ## Conclusão ### Checklist DCF ``` ┌─────────────────────────────────────────────────────────────┐ │ CHECKLIST DCF │ ├─────────────────────────────────────────────────────────────┤ │ │ │ INPUTS │ │ ☐ FCF histórico (3-5 anos) │ │ ☐ Taxa de crescimento realista │ │ ☐ WACC com todos os componentes │ │ ☐ Crescimento perpétuo ≤ PIB │ │ │ │ VALIDAÇÃO │ │ ☐ TV \< 70% do valor total │ │ ☐ Análise de sensibilidade │ │ ☐ Comparar com múltiplos │ │ ☐ Sanity check vs preço de mercado │ │ │ │ MARGEM DE SEGURANÇA │ │ ☐ Aplicar desconto de 20-40% │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Quando o DCF é Mais Útil 1. **Empresas maduras** com FCF estável 2. **Aquisições** onde você precisa de valor absoluto 3. **Decisões de longo prazo** de buy and hold 4. **Comparar cenários** (base, otimista, pessimista) --- **Pronto para fazer seu próprio DCF?** [Crie sua conta grátis](/signup) e acesse dados de fluxo de caixa de todas as empresas da bolsa brasileira! ``` # Fluxo de Caixa Livre vs Lucro Contábil: A Verdade Nua e Crua URL: /blog/fluxo-de-caixa-livre-vs-lucro-contabil-2026.mdx Por que empresas dão lucro mas quebram? Entenda a diferença vital entre Lucro Líquido e Fluxo de Caixa Livre (FCF) para investir melhor em 2026. *** searchable: true title: 'Fluxo de Caixa Livre vs Lucro Contábil: A Verdade Nua e Crua' description: 'Por que empresas dão lucro mas quebram? Entenda a diferença vital entre Lucro Líquido e Fluxo de Caixa Livre (FCF) para investir melhor em 2026.' date: '2026-01-01' keywords: 'fluxo de caixa livre, free cash flow, lucro liquido vs caixa, analise contabil, fcf yield, qualidade dos lucros' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Análise Fundamentalista' readingTime: '12 min' tags: \['Fluxo de Caixa', 'Lucro', 'Contabilidade', 'FCF', 'Investimentos'] relatedPosts: \['divida-liquida-ebitda-alavancagem-analise-2026', 'valuation-dcf-multiplos-guia-completo-2026', 'demonstrativos-financeiros-um-olhar-detalhado-na-saude-financeira-da-empresa'] featured: false expertise: 'Aprofundamento em contabilidade financeira para investidores.' lastReviewed: '2026-02-10' -------------------------- import { Authors, Author } from '~/components/Authors'; Você abre o relatório trimestral: "Empresa X lucra R$ 500 milhões". Ótimo, certo? Você olha o caixa: Caiu R$ 200 milhões. Como isso é possível? Bem-vindo ao mundo da contabilidade de competência. Em 2026, entender que **Lucro é opinião, Caixa é fato** é o que vai salvar sua carteira de "pegadinhas" contábeis. *** ## Lucro Líquido (Regime de Competência) O lucro contábil registra a venda quando ela acontece, não quando o dinheiro entra. * Se a empresa vende R$ 1 milhão parcelado em 12x, o lucro registra R$ 1 milhão hoje. * Mas no caixa, entrou quase zero. ## Fluxo de Caixa Livre (FCF - Free Cash Flow) É o dinheiro que sobra de verdade no bolso da empresa depois de pagar todas as contas operacionais e fazer os investimentos necessários para manter o negócio rodando (CAPEX). **FCF = Fluxo de Caixa Operacional - CAPEX (Investimentos)** * **É com FCF que se paga dividendos.** * **É com FCF que se reduz dívida.** * **É com FCF que se recompra ações.** *** ## O Perigo do "Lucro Sem Caixa" Uma empresa pode quebrar dando lucro. Como? 1. Ela vende muito a prazo (Aumenta "Contas a Receber"). 2. Ela estoca muito produto que não vende (Aumenta "Estoques"). 3. Ela precisa gastar bilhões em máquinas novas só para continuar existindo (CAPEX alto). Se o dinheiro sai mais rápido do que entra, ela queima caixa. Se o crédito secar, ela quebra, mesmo com "Lucro Líquido" positivo no DRE. ### Exemplo Clássico: Varejo Varejistas frequentemente mostram lucro contábil, mas têm FCF negativo porque precisam comprar estoque meses antes de vender. Em anos de crise (juros altos), financiar esse estoque custa caro e o lucro vira pó. *** ## FCF Yield: O Valuation Realista Em vez de olhar P/L (Preço/Lucro), olhe **P/FCF** (Preço/Fluxo de Caixa Livre). Ou melhor, o **FCF Yield**: **FCF Yield = Fluxo de Caixa Livre por Ação / Preço da Ação** * **FCF Yield > 10%:** A empresa é uma "vaca leiteira". Ela gera tanto dinheiro em relação ao seu preço que poderia se pagar em 10 anos só com o caixa. (Ex: **Petrobras**, **Vale** em ciclos bons). * **FCF Yield Negativo:** A empresa queima caixa. Ela precisa crescer muito rápido para justificar, ou vai precisar emitir mais ações (diluir você) ou tomar dívida para sobreviver. (Ex: Startups, Tech em estágio inicial). *** ## Conclusão Para 2026, prefira empresas com **Alta Conversão de Caixa** (Cash Conversion). Empresas como **Ambev** e **Itaúsa** são famosas por transformar quase todo o seu Lucro EBITDA em Caixa Livre. São negócios leves, com baixo CAPEX e previsíveis. Antes de comemorar o lucro, pergunte: "Cadê o dinheiro?". *** ## Leia Mais * **[Dívida Líquida/EBITDA](/blog/divida-liquida-ebitda-alavancagem-analise-2026)** * **[Dividendos Sustentáveis](/blog/payout-dividend-yield-sustentabilidade-2026)** # brapi Aceita no Microsoft for Startups 2026: Nova Fase de Crescimento URL: /blog/fomos-aceitos-no-programa-microsoft-for-startups.mdx A brapi foi aceita no Microsoft for Startups! Conheça os benefícios, parcerias e como isso impulsiona nossa API financeira com tecnologia Azure e IA de ponta ✓ *** searchable: true title: 'brapi Aceita no Microsoft for Startups 2026: Nova Fase de Crescimento' description: 'A brapi foi aceita no Microsoft for Startups! Conheça os benefícios, parcerias e como isso impulsiona nossa API financeira com tecnologia Azure e IA de ponta ✓' date: '2026-01-01' keywords: 'Microsoft for Startups, brapi Microsoft, parceria tecnológica, Azure brapi, startup brasileira, API financeira Microsoft, crescimento tech Brasil, 2026' author: 'Equipe brapi.dev' category: 'Empresa e Novidades' subcategory: 'Parcerias e Crescimento' readingTime: '6 min' tags: \['Microsoft', 'Startups', 'Parceria', 'Azure', 'Crescimento', 'Tecnologia', 'IA', 'Empresa'] relatedPosts: \['b3-api-gratuita-como-usar-cotacoes', 'acesso-gratuito-ilimitado-acoes-teste-brapi', 'dashboard-b3-power-bi-api-cotacoes', 'lancamento-sdks-oficiais-typescript-python', 'novos-modulos-na-brapi'] featured: false expertise: 'Equipe executiva da brapi.dev com foco em parcerias estratégicas e crescimento tecnológico' lastReviewed: '2026-01-01' -------------------------- import { Author, Authors } from '~/components/Authors'; > A Brapi iniciou uma nova etapa ao ser aceita no programa Microsoft for > Startups! Essa parceria ajuda a Brapi a avançar em soluções tecnológicas, > utilizando toda a infraestrutura da Azure, além de mentoria técnica 1:1 e uso > de tecnologias de ponta como a IA da Azure/OpenAI. A Brapi foi aceita no programa Microsoft for Startups, uma parceria que traz benefícios essenciais para o crescimento da empresa. Essa parceria traz um investimento de até US$150.000 para uso na Azure, além de mentoria técnica 1:1, suporte de vendas e marketing, acesso a novas tecnologias, rede de contatos e outras vantagens que reforçam nossos planos de avanço em soluções tecnológicas, incluindo gerenciamento dos dados financeiros com o desenvolvimento de novas soluções de IA. ![Imagem destacando a parceria com Microsoft for Startups](./images/microsoft_for_startups_brapi.jpg) O Founders Hub da Microsoft for Startups oferece recursos essenciais para startups em expansão, como rede de contatos estratégicos e ferramentas modernas. Com esses benefícios, a Brapi deseja aprimorar ainda mais suas plataformas e desenvolver soluções inovadoras para o mercado financeiro. Entrar nesse programa reforça nossa dedicação em levar soluções de qualidade ao público. Mantemos nossa missão de oferecer suporte relevante a investidores e entusiastas do mercado, agora com o suporte direto da Microsoft. O Microsoft for Startups abre um leque de oportunidades para a Brapi impulsionar seus produtos, fortalecer seu crescimento e alcançar novos patamares de excelência, inclusive já estamos utilizando parte do investimento para desenvolver novas soluções de IA para aprimorar a experiência dos usuários e a qualidade dos dados financeiros disponíveis. # Fórmula de Graham 2025: Como Calcular Valor Intrínseco de Ações URL: /blog/formula-graham-como-calcular-preco-justo-acoes-value-investing.mdx Domine a Fórmula de Graham para value investing! Como Benjamin Graham calcula preço justo e valor intrínseco ✓ *** searchable: true title: 'Fórmula de Graham 2025: Como Calcular Valor Intrínseco de Ações' description: 'Domine a Fórmula de Graham para value investing! Como Benjamin Graham calcula preço justo e valor intrínseco ✓' date: '2025-08-22' keywords: 'fórmula graham, benjamin graham, value investing, preço justo ações, valor intrínseco, análise fundamentalista, P/L, crescimento lucros, bolsa brasileira, brapi' author: 'Equipe brapi.dev' category: 'Value Investing' subcategory: 'Métodos de Valuation' readingTime: '17 min' tags: \['Fórmula Graham', 'Value Investing', 'Benjamin Graham', 'Preço Justo', 'Bolsa Brasileira', 'Valor Intrínseco', 'Valuation'] relatedPosts: \['entendendo-indicador-preco-lucro-pl-analise-fundamentalista', 'metodo-bazin-estrategia-renda-passiva-acoes-dividendos', 'analise-fundamentalista-acoes-indicadores-essenciais-investir-b3'] featured: true expertise: 'Estratégias de value investing com 8+ anos de experiência no mercado brasileiro' lastReviewed: 2026-01-03 howToTools: \['API brapi.dev', 'Dados de LPA', 'Taxa de crescimento histórica'] howToSteps: * name: 'Obtenha o Lucro por Ação (LPA)' text: 'Use a API brapi.dev para buscar o LPA atual da empresa.' * name: 'Estime a taxa de crescimento' text: 'Calcule o crescimento médio dos lucros nos últimos 5-10 anos.' * name: 'Aplique a Fórmula de Graham' text: 'V = LPA × (8,5 + 2g) onde g é a taxa de crescimento anual esperada.' * name: 'Compare com o preço atual' text: 'Se o valor intrínseco for maior que o preço, a ação pode estar subvalorizada.' * name: 'Aplique margem de segurança' text: 'Graham recomenda comprar com desconto de 33% sobre o valor calculado.' *** import { Authors, Author } from '~/components/Authors'; > A Fórmula de Graham, criada por Benjamin Graham - o "pai do value investing" - é uma das metodologias mais respeitadas para calcular o valor intrínseco de ações. Aprenda como aplicar esta ferramenta poderosa na análise de ações brasileiras e identificar oportunidades de investimento. *** ## O que é a Fórmula de Graham? A **Fórmula de Graham** é uma equação matemática desenvolvida por Benjamin Graham para estimar o valor intrínseco de uma ação com base em seus fundamentos financeiros. Esta fórmula combina a capacidade de geração de lucros da empresa com sua solidez patrimonial. ### A Fórmula Original ``` Valor Intrínseco = √(22,5 × LPA × VPA) ``` Onde: * **LPA**: Lucro Por Ação (últimos 12 meses) * **VPA**: Valor Patrimonial por Ação * **22,5**: Constante que representa P/L de 15 e P/VP de 1,5 ## Quem foi Benjamin Graham? **Benjamin Graham (1894-1976)** foi um economista e investidor britânico-americano, considerado o fundador da análise de valores mobiliários moderna. Suas principais contribuições incluem: ### Legado no Mercado Financeiro * **Mentor de Warren Buffett**: Influenciou diretamente o maior investidor da história * **"Security Analysis" (1934)**: Livro fundamental sobre análise de investimentos * **Value Investing**: Criou os princípios do investimento em valor ### Filosofia de Investimento Graham defendia que o mercado é frequentemente irracional no curto prazo, mas eficiente no longo prazo, criando oportunidades para investidores disciplinados. ## Como Funciona a Fórmula de Graham ### Os Componentes da Fórmula #### 1. Lucro Por Ação (LPA) * Representa a **rentabilidade** da empresa * Mede quanto lucro cada ação gera * Deve ser baseado em dados dos últimos 12 meses (TTM) #### 2. Valor Patrimonial por Ação (VPA) * Representa a **solidez patrimonial** * Mostra o valor contábil por ação * Funciona como "garantia" do investimento #### 3. A Constante 22,5 * **P/L de 15**: Múltiplo considerado razoável para empresas estáveis * **P/VP de 1,5**: Prêmio moderado sobre o valor contábil * **15 × 1,5 = 22,5**: Produto dos múltiplos ideais ## Calculando com a API brapi.dev A [API da brapi.dev](/docs/acoes) fornece todos os dados necessários para aplicar a Fórmula de Graham: ### Exemplo de Consulta ```bash curl "https://brapi.dev/api/quote/PETR4?modules=defaultKeyStatistics,financialData" ``` **Resposta com dados necessários:** ```json { "results": [{ "symbol": "PETR4", "regularMarketPrice": 35.20, "defaultKeyStatistics": { "earningsPerShare": 16.33, "bookValue": 59.17 } }] } ``` ### Aplicando a Fórmula ```javascript // Dados da PETR4 (exemplo) const LPA = 16.33; // Lucro por ação TTM const VPA = 59.17; // Valor patrimonial por ação // Fórmula de Graham const valorIntrinseco = Math.sqrt(22.5 * LPA * VPA); console.log(`Valor Intrínseco: R$ ${valorIntrinseco.toFixed(2)}`); // Resultado: R$ 147,47 const precoAtual = 35.20; const margem = ((valorIntrinseco - precoAtual) / precoAtual) * 100; console.log(`Margem de Segurança: ${margem.toFixed(1)}%`); ``` ## Interpretando os Resultados ### Margem de Segurança A diferença entre o preço atual e o valor calculado pela fórmula indica a **margem de segurança**: ``` Margem de Segurança = (Valor Intrínseco - Preço Atual) ÷ Preço Atual × 100 ``` **Interpretação:** * **Positiva**: Ação potencialmente subvalorizada * **Negativa**: Ação potencialmente sobrevalorizada * **Acima de 30%**: Excelente oportunidade segundo Graham ### Classificação de Oportunidades #### Forte Desconto (acima de 40%) * Oportunidade excepcional * Margem de segurança robusta * Prioridade máxima para análise #### Desconto Moderado (20% a 40%) * Boa oportunidade * Margem de segurança adequada * Análise detalhada recomendada #### Próximo ao Valor Justo (-10% a 20%) * Preço razoável * Pouca margem de segurança * Aguardar melhor oportunidade #### Sobrevalorizado (\<-10%) * Preço acima do valor estimado * Evitar ou aguardar correção * Risco elevado ## Limitações da Fórmula de Graham ### 1. Empresas em Crescimento A fórmula foi desenvolvida para empresas maduras e estáveis. Pode subestimar o valor de empresas em crescimento acelerado. ### 2. Setores Específicos Alguns setores têm características particulares que a fórmula não contempla: * **Bancos**: Estrutura de capital diferente * **Tecnologia**: Ativos intangíveis * **Commodities**: Volatilidade de preços ### 3. Dados Contábeis Baseada em valores contábeis que podem não refletir o valor real dos ativos. ## Adaptações Modernas da Fórmula ### Versão Revisada Alguns analistas propõem ajustes: ``` Valor Intrínseco = √(15 × LPA × VPA) × (Taxa de Crescimento + 8,5) ÷ 4,4 ``` ### Ajustes para Inflação Considerar o impacto da inflação nos cálculos: ``` Valor Ajustado = Valor Intrínseco × (Taxa de Juros Livre de Risco ÷ Rendimento AAA) ``` ## Aplicação Prática no Mercado Brasileiro ### Screening de Ações Use a [plataforma brapi.dev](/quotes) para identificar ações com: 1. **LPA positivo** e consistente 2. **VPA crescente** ao longo do tempo 3. **P/L entre 5 e 15** 4. **P/VP entre 0,5 e 2,0** ### Exemplo de Portfolio Graham #### Critérios de Seleção: * Margem de segurança mínima de 30% * LPA positivo nos últimos 3 anos * Endividamento controlado * Dividendos consistentes #### Setores Favoráveis: * **Utilities**: EGIE3, SBSP3, CPLE6 * **Bancos**: ITUB4, BBDC4, BBAS3 * **Consumo**: ABEV3, BRFS3, JBSS3 * **Varejo**: MGLU3, LREN3, AMER3 ## Ferramentas de Análise ### Calculadora Automática Desenvolva sua própria calculadora usando a API: ```typescript // Buscar dados para cálculo da Fórmula de Graham const response = await fetch( "https://brapi.dev/api/quote/PETR4?modules=defaultKeyStatistics", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); const { earningsPerShare: lpa, bookValue: vpa } = data.results[0].defaultKeyStatistics; const preco = data.results[0].regularMarketPrice; // Fórmula de Graham: VI = √(22,5 × LPA × VPA) const valorIntrinseco = Math.sqrt(22.5 * lpa * vpa); const margemSeguranca = ((valorIntrinseco - preco) / preco) * 100; ``` **Exemplo de Resultado:** | Métrica | Valor | | ----------------------- | ------------ | | Ticker | PETR4 | | Preço Atual | R$ 36,00 | | LPA | R$ 8,50 | | VPA | R$ 28,00 | | **Valor Intrínseco** | **R$ 65,47** | | **Margem de Segurança** | **+81,9%** | ### Screening Automatizado Crie alertas para oportunidades: ```javascript const tickers = ['PETR4', 'ITUB4', 'ABEV3', 'EGIE3']; tickers.forEach(async (ticker) => { const analise = await calcularGraham(ticker); if (analise.margemSeguranca > 30) { console.log(`🚨 Oportunidade: ${ticker} - ${analise.margemSeguranca}%`); } }); ``` ## Estratégias Complementares ### Combinando com Outros Indicadores #### 1. ROE (Return on Equity) * Mínimo de 15% nos últimos 3 anos * Consistência mais importante que picos #### 2. Dividend Yield * Preferir empresas que pagam dividendos * DY entre 4% e 8% é ideal #### 3. Crescimento dos Lucros * CAGR de lucros positivo nos últimos 5 anos * Previsibilidade dos resultados ### Diversificação Setorial Não concentre apenas em um setor: * 25% Financeiro * 25% Consumo * 25% Utilities * 25% Outros setores ## Casos de Estudo ### Caso 1: Empresa Subvalorizada **XPTO4** * LPA: R$ 12,00 * VPA: R$ 45,00 * Preço: R$ 25,00 * Graham: √(22,5 × 12 × 45) = R$ 110,45 * Margem: 342% - **Excelente oportunidade** ### Caso 2: Empresa Sobrevalorizada **ABCD3** * LPA: R$ 2,50 * VPA: R$ 15,00 * Preço: R$ 35,00 * Graham: √(22,5 × 2,5 × 15) = R$ 29,05 * Margem: -17% - **Evitar** ## Monitoramento e Alertas ### Acompanhamento Trimestral * Resultados trimestrais * Mudanças no LPA e VPA * Recálculo do valor intrínseco ### Alertas Automatizados Configure alertas para: * Margem de segurança > 30% * Entrada na faixa de compra * Deterioração dos fundamentos ## Conclusão A Fórmula de Graham continua sendo uma ferramenta valiosa para identificar ações subvalorizadas, especialmente quando combinada com análise qualitativa e outros indicadores. ### Pontos-Chave: 1. **Simplicidade**: Fórmula fácil de aplicar 2. **Conservadorismo**: Foca em empresas sólidas 3. **Margem de Segurança**: Protege contra erros de análise 4. **Complementar**: Deve ser usada com outros métodos ### Próximos Passos: * Explore nossa [API completa](/docs) para dados financeiros * Use nossa [plataforma](/quotes) para screening automatizado * Aprenda sobre [outros métodos de valuation](/blog/metodologias-valuation-acoes-brasileiras) **Lembre-se:** A Fórmula de Graham é um ponto de partida, não uma verdade absoluta. Sempre combine com análise qualitativa e gestão adequada de risco. # Fundos Imobiliários para Iniciantes: Como Analisar um FII URL: /blog/fundos-imobiliarios-fiis-guia-completo-iniciantes.mdx Entenda como FIIs funcionam, de onde vêm os rendimentos e quais riscos, indicadores e documentos consultar antes de escolher um fundo imobiliário. *** searchable: true title: 'Fundos Imobiliários para Iniciantes: Como Analisar um FII' description: 'Entenda como FIIs funcionam, de onde vêm os rendimentos e quais riscos, indicadores e documentos consultar antes de escolher um fundo imobiliário.' date: '2026-01-01' keywords: 'fundos imobiliários para iniciantes, como analisar fii, o que é fii, como investir em fundos imobiliários, indicadores fii' author: 'Alisson Leal' category: 'Fundos Imobiliários' subcategory: 'Primeiros passos' readingTime: '10 min' tags: \['FIIs', 'Fundos Imobiliários', 'Iniciantes', 'P/VP', 'Dividend Yield', 'Vacância'] relatedPosts: \['fiis-de-papel-vs-tijolo-comparativo-2026', 'api-fiis-brasil-indicadores-carteira-relatorios-dividendos', 'fii-screener-python-filtrar-fundos-imobiliarios-pvp-dy'] featured: true expertise: 'Análise de fundos imobiliários e dados regulatórios da CVM' lastReviewed: '2026-07-17' -------------------------- import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; Um fundo imobiliário reúne dinheiro de vários cotistas para investir em imóveis, crédito imobiliário ou cotas de outros fundos. As cotas são negociadas na B3 e o preço muda durante o pregão. O FII pode distribuir rendimentos, mas a renda não é garantida. Vacância, inadimplência, juros, crédito e decisões da gestão afetam o resultado. ## O que você compra Ao comprar uma cota, você não se torna dono direto de uma sala ou galpão. Você passa a ter uma fração do patrimônio do fundo e direito econômico aos resultados distribuídos conforme as regras do veículo. O administrador cuida da estrutura regulatória. O gestor toma decisões de investimento dentro do regulamento. Essas funções podem ser exercidas por empresas diferentes. ## Tipos de FII | Tipo | Principal exposição | | ------- | ------------------------------------ | | Tijolo | Imóveis e contratos de aluguel | | Papel | CRIs e outros títulos imobiliários | | Híbrido | Mistura imóveis e ativos financeiros | | FOF | Cotas de outros fundos imobiliários | Um fundo de logística e um fundo de shopping são ambos de tijolo, mas não têm o mesmo ciclo operacional. Um fundo de papel indexado ao CDI também difere de uma carteira concentrada em crédito ligado ao IPCA. Veja a comparação em [FIIs de papel vs tijolo](/blog/fiis-de-papel-vs-tijolo-comparativo-2026). ## De onde vêm os rendimentos Nos fundos de tijolo, a receita costuma vir de aluguéis e exploração dos imóveis. Despesas, vacância e inadimplência reduzem o resultado disponível. Nos fundos de papel, a receita vem dos juros e da correção dos títulos. O valor depende dos indexadores, spreads, amortizações e qualidade dos créditos. Um pagamento elevado pode incluir receita não recorrente, ganho de venda ou efeito temporário de juros. Leia o relatório antes de projetar o mesmo valor para os meses seguintes. ## Indicadores básicos ### P/VP P/VP divide o preço da cota pelo valor patrimonial por cota. Abaixo de 1 indica que o mercado negocia a cota abaixo do patrimônio informado. Isso não prova que o fundo está barato. O patrimônio pode conter ativos de baixa qualidade, avaliações defasadas ou riscos que justificam o desconto. ### Dividend yield Dividend yield compara os rendimentos distribuídos com o preço da cota. Confira o período usado, pois DY mensal e DY de 12 meses respondem perguntas diferentes. Um DY alto pode resultar de distribuição extraordinária ou queda forte do preço. Observe a origem e a regularidade dos pagamentos. ### Vacância Vacância mede a parcela desocupada dos imóveis. A definição pode ser física ou financeira, e as duas medidas não são iguais. Confira também quais imóveis estão vagos, há quanto tempo e quanto representam da receita. Uma média esconde concentrações importantes. ### Liquidez Liquidez mostra a facilidade de negociar a cota. Fundos com pouco volume podem ter spread maior e exigir paciência para comprar ou vender. ## Documentos que merecem leitura Antes de investir, procure: * regulamento do fundo; * relatório gerencial mais recente; * informes mensais e trimestrais; * fatos relevantes; * carteira e imóveis declarados; * histórico de rendimentos; * taxas e conflitos de interesse. Patrimônio, vacância, carteira e preço podem ter datas de referência diferentes. Mostre a competência de cada número antes de compará-los. ## Como analisar um FII em cinco passos ### 1. Entenda a fonte da receita Descubra se o fundo recebe aluguéis, juros de CRIs, ganhos de venda ou renda de outros FIIs. A fonte define quais riscos precisam ser acompanhados. ### 2. Procure concentrações Veja os maiores imóveis, inquilinos, devedores, emissores e indexadores. Quanto maior a concentração, maior o impacto de um problema isolado. ### 3. Compare com fundos semelhantes Compare logística com logística e papel com carteiras de crédito parecidas. Rankings que misturam todos os FIIs favorecem conclusões ruins. ### 4. Leia a evolução, não apenas o retrato Observe vários meses ou trimestres de patrimônio, vacância, rendimentos e quantidade de cotistas. Uma tendência ajuda a separar ruído de deterioração. ### 5. Defina o motivo de revisão Registre o que faria você reavaliar o fundo: perda de inquilino, aumento de vacância, evento de crédito, mudança de gestão ou alavancagem maior. ## Consultar dados pela API O sandbox da brapi permite testar MXRF11 e HGLG11 sem token: ```bash curl "https://brapi.dev/api/v2/fii/indicators?symbols=MXRF11,HGLG11" ``` Para descobrir fundos por segmento: ```bash curl "https://brapi.dev/api/v2/fii/list?segmentType=tijolo&limit=20" ``` A API também oferece histórico, carteira, imóveis, relatórios CVM e dividendos. Veja [como usar a API de FIIs](/blog/api-fiis-brasil-indicadores-carteira-relatorios-dividendos). ## Impostos e regras Regras tributárias mudam e dependem do evento e da situação do investidor. Consulte a Receita Federal, a legislação vigente e os informes da corretora no ano da declaração. Não use uma alíquota copiada de um artigo antigo como regra para todos os casos. ## Antes da primeira compra Confirme se você entende: 1. o que gera a receita do fundo; 2. o risco que mais ameaça essa receita; 3. onde está a maior concentração; 4. quanto a cota negocia por dia; 5. quais documentos serão acompanhados; 6. por que o fundo cabe na sua carteira. Se a resposta for apenas "paga todo mês", ainda falta analisar o investimento. # GOOGLEFINANCE não Retorna BVMF? Use uma API no Google Sheets URL: /blog/googlefinance-bvmf-nao-funciona-alternativa-brapi.mdx Crie uma função no Google Sheets para buscar cotações de ações e FIIs da B3 quando GOOGLEFINANCE não encontra o ticker ou devolve dados incompletos. *** searchable: true title: 'GOOGLEFINANCE não Retorna BVMF? Use uma API no Google Sheets' description: 'Crie uma função no Google Sheets para buscar cotações de ações e FIIs da B3 quando GOOGLEFINANCE não encontra o ticker ou devolve dados incompletos.' date: '2026-07-17' keywords: 'googlefinance bvmf não funciona, google finance b3 erro, cotação fii google sheets, ações b3 planilha, alternativa googlefinance brasil' author: 'Alisson Leal' category: 'Tutoriais e Integrações' subcategory: 'Google Sheets' readingTime: '7 min' tags: \['Google Sheets', 'GOOGLEFINANCE', 'B3', 'Apps Script', 'API', 'FIIs'] relatedPosts: \['integracao-google-sheets-cotacoes-b3-tutorial-completo', 'planilha-google-sheets-cotacoes-automaticas-apps-script', 'b3-api-gratuita-como-usar-cotacoes'] featured: true expertise: 'Automação de planilhas com dados financeiros brasileiros' lastReviewed: '2026-07-17' -------------------------- import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; Quando `GOOGLEFINANCE("BVMF:MXRF11")` não retorna o ativo, você pode criar uma função no Apps Script que consulta a brapi. Ela funciona para ações, FIIs, ETFs, BDRs e units cobertos pela API. Depois da configuração, a fórmula fica assim: ```text =BRAPI_PRECO("PETR4") ``` Ou usando o ticker de outra célula: ```text =BRAPI_PRECO(A2) ``` ## Criar a função BRAPI\_PRECO Na planilha, abra **Extensões > Apps Script** e cole: ```javascript function BRAPI_PRECO(ticker) { const symbol = String(ticker).trim().toUpperCase(); if (!symbol) { return "Ticker vazio"; } const cache = CacheService.getScriptCache(); const cached = cache.get(`price:${symbol}`); if (cached !== null) { return Number(cached); } const token = PropertiesService .getScriptProperties() .getProperty("BRAPI_TOKEN"); const headers = token ? { Authorization: `Bearer ${token}` } : {}; const url = "https://brapi.dev/api/v2/stocks/quote?symbols=" + encodeURIComponent(symbol); const response = UrlFetchApp.fetch(url, { headers, muteHttpExceptions: true, }); if (response.getResponseCode() !== 200) { return `Erro ${response.getResponseCode()}`; } const payload = JSON.parse(response.getContentText()); const price = payload.results?.[0]?.data?.regularMarketPrice; if (typeof price !== "number") { return "Cotação indisponível"; } cache.put(`price:${symbol}`, String(price), 300); return price; } ``` Salve o projeto e volte à planilha. O primeiro uso pode pedir autorização para que o script faça requisições externas. ## Guardar o token sem colocá-lo na célula No editor do Apps Script: 1. abra **Configurações do projeto**; 2. procure **Propriedades do script**; 3. crie a propriedade `BRAPI_TOKEN`; 4. cole o token da sua conta brapi. Assim, o token não aparece em fórmulas ou células compartilhadas. Quem tiver permissão de edição no projeto ainda pode acessar o script, então controle os editores da planilha. Os ativos liberados para teste podem funcionar sem autenticação. Para usar a planilha com outros ativos e limites do seu plano, configure o token. ## Buscar vários ativos de uma vez Uma chamada por célula desperdiça requisições. Para uma carteira, envie vários tickers na mesma chamada e devolva uma matriz. ```javascript function BRAPI_COTACOES(values) { const symbols = values .flat() .map((value) => String(value).trim().toUpperCase()) .filter(Boolean) .slice(0, 20); const token = PropertiesService .getScriptProperties() .getProperty("BRAPI_TOKEN"); const headers = token ? { Authorization: `Bearer ${token}` } : {}; const url = "https://brapi.dev/api/v2/stocks/quote?symbols=" + encodeURIComponent(symbols.join(",")); const response = UrlFetchApp.fetch(url, { headers }); const payload = JSON.parse(response.getContentText()); const prices = new Map( payload.results.map((item) => [ item.symbol, item.data.regularMarketPrice, ]), ); return symbols.map((symbol) => [symbol, prices.get(symbol) ?? "N/D"]); } ``` Se os tickers estiverem em `A2:A10`, use: ```text =BRAPI_COTACOES(A2:A10) ``` A função preenche duas colunas: ticker e preço. O limite da API é de 20 símbolos por requisição. ## Por que GOOGLEFINANCE falha em alguns ativos `GOOGLEFINANCE` depende do catálogo e da fonte de dados mantidos pelo Google. Alguns FIIs, ETFs, BDRs ou tickers novos podem não aparecer, mudar de código ou ficar temporariamente sem resposta. Trocar `BVMF:` por outro prefixo não corrige um ativo que a fonte não cobre. Uma integração por API permite validar o ticker e tratar o erro de forma clara. Use `/api/v2/tickers?search=CODIGO` para conferir se o símbolo está no catálogo: ```text https://brapi.dev/api/v2/tickers?search=MXRF11 ``` ## Atualização e cache O exemplo guarda o preço por cinco minutos. Isso reduz chamadas repetidas quando o Google Sheets recalcula várias fórmulas ao mesmo tempo. Planilhas não são terminais de negociação. Mostre o horário da cotação quando o momento exato do dado importar e não trate a função como streaming. Para uma planilha com mais campos, histórico e atualização organizada, siga o [tutorial de integração com Google Sheets](/blog/integracao-google-sheets-cotacoes-b3-tutorial-completo). # Bogleheads no Brasil: um jeito simples de investir com ETFs URL: /blog/guia-bogleheads-brasil-investimento-passivo-etfs.mdx Um guia direto para montar uma carteira passiva, diversificada e barata sem acompanhar o mercado todos os dias. *** searchable: true title: 'Bogleheads no Brasil: um jeito simples de investir com ETFs' description: 'Um guia direto para montar uma carteira passiva, diversificada e barata sem acompanhar o mercado todos os dias.' date: '2026-01-01' keywords: 'bogleheads brasil, investimento passivo, ETF irlandes, VWRA, diversificação global, fundos de índice, investir no exterior, carteira passiva, John Bogle' author: 'Alisson Leal' category: 'Estratégias de Investimento' subcategory: 'Investimento Passivo' readingTime: '12 min' tags: \['Bogleheads', 'Investimento Passivo', 'ETFs', 'Diversificação Global', 'ETF Irlandês', 'VWRA'] relatedPosts: \['como-construir-carteira-investimentos-diversificada-brapi', 'reserva-de-emergencia-guia-completo-2026', 'rebalanceamento-carteira-como-quando-fazer-2026', 'etfs-irlandeses-brasileiros-vwra-swrd-eimi'] featured: true expertise: 'Investimento passivo e carteiras diversificadas para brasileiros' lastReviewed: '2026-06-23' faqSchema: * question: 'O que é a estratégia Bogleheads?' answer: 'É uma forma de investir baseada em diversificação ampla, fundos de índice baratos, aportes regulares e poucas mudanças na carteira.' * question: 'Preciso investir no exterior para seguir a estratégia?' answer: 'Não. É possível começar com ETFs globais negociados na B3 e renda fixa brasileira. Investir no exterior oferece mais opções, mas aumenta a complexidade operacional e tributária.' * question: 'Existe isenção de R$ 35 mil para vender ETF no exterior?' answer: 'Não use essa antiga regra para ETFs no exterior. A Lei 14.754/2023 passou a tributar, em regra, os rendimentos de aplicações financeiras no exterior a 15% na declaração anual.' *** import { Authors, Author } from '~/components/Authors'; ![Ilustração de um investidor brasileiro fazendo aportes regulares em uma carteira global diversificada](/images/blog/bogleheads-investimento-passivo.webp) A ideia Bogleheads cabe em uma frase: compre o mercado inteiro, pague pouco e continue investindo. Ela vem do trabalho de Jack Bogle, fundador da Vanguard e um dos responsáveis por popularizar fundos de índice de baixo custo. Na prática, você troca a tentativa de escolher a próxima ação vencedora por uma carteira ampla e fácil de manter. ## O plano em três passos O difícil não é entender o plano. É continuar seguindo-o quando o mercado cai, um fundo da moda dispara ou alguém promete retorno rápido. ## Os cinco princípios ### 1. Diversifique de verdade Comprar dez ações brasileiras não é o mesmo que investir no mundo. Um ETF global pode reunir milhares de empresas de vários países e setores. Isso não elimina quedas. Ele reduz o risco de depender de uma empresa, setor ou país. ### 2. Mantenha os custos baixos Taxas parecem pequenas porque são mostradas por ano. O problema é que elas também se acumulam por décadas. A simulação não prevê retorno. Ela só mostra por que custo merece atenção. ### 3. Aporte sem tentar adivinhar o mercado Ninguém avisa quando uma queda terminou. Esperar o "momento certo" costuma virar dinheiro parado ou compras feitas depois da alta. Defina um valor que caiba no orçamento e invista em uma frequência simples, como uma vez por mês. ### 4. Assuma um risco que você aguenta Uma carteira agressiva no papel não ajuda se você vender tudo na primeira queda forte. A divisão entre renda fixa e renda variável precisa considerar: * quando o dinheiro será usado; * estabilidade da renda; * tamanho da reserva; * reação a perdas temporárias. Idade pode servir como referência, mas não resolve essas perguntas. ### 5. Mexa pouco Uma boa carteira não precisa de novidade todo mês. Novos produtos, previsões e rankings criam vontade de trocar o plano, mas raramente melhoram uma estratégia simples. ## Antes do primeiro ETF Faça estas duas coisas primeiro: 1. Pague dívidas com juros altos, como rotativo do cartão e cheque especial. 2. Guarde uma reserva para imprevistos. Uma reserva costuma cobrir de 3 a 12 meses de despesas. Quem tem renda instável normalmente precisa de mais. Ela deve ficar em algo simples, líquido e de baixo risco, como Tesouro Selic ou CDB com liquidez diária. Reserva não existe para dar o maior retorno. Existe para evitar que você venda investimentos durante uma emergência. ## Uma carteira simples no Brasil Você não precisa abrir conta no exterior para começar. | Parte da carteira | Opções comuns | Função | | ----------------- | ------------------------------------------ | --------------------------------------------- | | Ações globais | ETFs globais negociados na B3, como WRLD11 | Diversificar entre países e empresas | | Ações brasileiras | ETF amplo da bolsa brasileira, se desejar | Manter uma parcela no mercado local | | Renda fixa | Tesouro Selic e Tesouro IPCA+ | Dar estabilidade e atender objetivos em reais | Uma carteira com um ETF global e renda fixa já cobre o essencial. Adicionar mais ativos só vale quando existe um motivo claro. ## E investir diretamente no exterior? ETFs UCITS domiciliados na Irlanda são comuns entre brasileiros que querem uma carteira global fora da B3. | Carteira | Como funciona | Trabalho | | --------------------------- | ------------------------------------------------- | -------- | | 100% VWRA na parte de ações | Um ETF cobre mercados desenvolvidos e emergentes | Baixo | | SWRD + EIMI | Um ETF para desenvolvidos e outro para emergentes | Médio | Em junho de 2026, os sites oficiais informavam OCF de 0,19% para o Vanguard FTSE All-World UCITS ETF, TER de 0,12% para o SPDR MSCI World UCITS ETF e TER de 0,18% para o iShares Core MSCI EM IMI UCITS ETF. Confira o factsheet antes de comprar, pois taxas mudam. O investimento direto também traz câmbio, remessa, corretora internacional, declaração de bens no exterior e regras sucessórias. Para aportes pequenos ou para quem quer menos trabalho, um ETF negociado no Brasil pode ser a escolha mais prática. ## Tributação no exterior A antiga ideia de vender até R$ 35 mil por mês sem imposto não deve ser usada para ETFs no exterior. A [Lei 14.754/2023](https://www.planalto.gov.br/ccivil_03/_ato2023-2026/2023/lei/l14754.htm) mudou a tributação das aplicações financeiras mantidas fora do Brasil. Em regra, os rendimentos são apurados em reais, informados na declaração anual e tributados a 15%. A [Receita Federal](https://www.gov.br/receitafederal/pt-br/assuntos/noticias/2024/marco/receita-federal-edita-norma-que-regulamenta-a-tributacao) regulamentou essa apuração. Se o patrimônio no exterior for relevante ou envolver herança, empresa, trust ou mudança de residência fiscal, procure orientação tributária. ## Como rebalancear sem complicar Suponha que sua meta seja 60% em ações globais e 40% em renda fixa. Depois de uma alta, as ações passam a representar 67%. Primeiro, direcione os próximos aportes para a renda fixa. Isso pode recuperar a proporção sem vender nada. Se a diferença continuar grande, faça um rebalanceamento. Você pode revisar a carteira uma vez por ano ou quando uma classe se afastar bastante da meta. Não precisa conferir toda semana. ## O que costuma dar errado * esperar uma queda perfeita para começar; * escolher fundos pelo retorno do último ano; * montar uma coleção de ETFs sobrepostos; * mudar a carteira depois de notícias; * ignorar taxas, impostos e câmbio; * assumir mais risco do que consegue suportar. Se o plano exige atenção diária, provavelmente está complexo demais. ## Checklist curto * [ ] Dívidas caras estão sob controle. * [ ] A reserva de emergência está pronta. * [ ] A divisão entre renda fixa e ações foi definida. * [ ] Os ETFs têm exposição ampla e custo baixo. * [ ] O aporte cabe no orçamento. * [ ] Existe uma regra simples de rebalanceamento. ## Para continuar Leia o guia de [ETFs irlandeses para brasileiros](/blog/etfs-irlandeses-brasileiros-vwra-swrd-eimi) se você considera investir fora. Para organizar a base, veja [como montar a reserva de emergência](/blog/reserva-de-emergencia-guia-completo-2026) e [como rebalancear a carteira](/blog/rebalanceamento-carteira-como-quando-fazer-2026). Você também pode acompanhar ETFs listados na B3 pela [brapi](/docs) sem transformar a cotação diária no centro da estratégia. ## Fontes [Vanguard FTSE All-World UCITS ETF](https://www.vanguard.co.uk/professional/product/etf/equity/9679/ftse-all-world-ucits-etf-usd-accumulating) · [SPDR MSCI World UCITS ETF](https://www.ssga.com/library-content/products/factsheets/etfs/emea/factsheet-emea-en_gb-sppw-gy.pdf) · [iShares Core MSCI EM IMI UCITS ETF](https://www.ishares.com/uk/individual/en/products/264659/ishares-msci-emerging-markets-imi-ucits-etf) · [Lei 14.754/2023](https://www.planalto.gov.br/ccivil_03/_ato2023-2026/2023/lei/l14754.htm) *Conteúdo educacional. Não é recomendação de investimento nem orientação tributária.* *Créditos: este guia foi inspirado pelo trabalho da comunidade Bogleheads Brasil, incluindo materiais de u/JoaoBogle e u/CapivaraDaFariaLima sob licença Creative Commons BY-NC-SA 4.0.* # Indicadores Fundamentalistas 2025: Guia Definitivo para Ações Brasileiras URL: /blog/guia-completo-indicadores-fundamentalistas-bovespa.mdx Domine TODOS os indicadores fundamentalistas! P/L, ROE, ROIC, EBITDA, margens e múltiplos. Framework completo para análise e investimento na bolsa brasileira ✓ *** searchable: true title: 'Indicadores Fundamentalistas 2025: Guia Definitivo para Ações Brasileiras' description: 'Domine TODOS os indicadores fundamentalistas! P/L, ROE, ROIC, EBITDA, margens e múltiplos. Framework completo para análise e investimento na bolsa brasileira ✓' date: '2025-08-22' keywords: 'indicadores fundamentalistas, análise fundamentalista, P/L, ROE, ROIC, margem líquida, P/VP, EV/EBITDA, bolsa brasileira, valuation, múltiplos, investimento ações, brapi' author: 'Equipe brapi.dev' category: 'Análise Fundamentalista' subcategory: 'Framework Completo' readingTime: '28 min' tags: \['Indicadores Fundamentalistas', 'Análise Fundamentalista', 'Bolsa Brasileira', 'Valuation', 'Investimentos', 'Múltiplos', 'Framework'] relatedPosts: \['analise-fundamentalista-acoes-indicadores-essenciais-investir-b3', 'entendendo-indicador-preco-lucro-pl-analise-fundamentalista', 'roe-retorno-sobre-patrimonio-como-analisar'] featured: true expertise: 'Framework completo de análise fundamentalista com 8+ anos de experiência' lastReviewed: 2026-01-03 howToSteps: * name: 'Configurar ambiente para análise' text: 'Configure Python com a API brapi.dev, obtendo token de acesso e importando bibliotecas requests e pandas para manipulação de dados.' * name: 'Buscar dados fundamentalistas completos' text: 'Use a API com modules=defaultKeyStatistics,financialData,summaryProfile,balanceSheetHistory,incomeStatementHistory,cashflowHistory.' * name: 'Analisar indicadores de valuation' text: 'Calcule e interprete P/L (Preço/Lucro), P/VP (Preço/Valor Patrimonial), EV/EBITDA e PSR (Price to Sales Ratio).' * name: 'Avaliar indicadores de rentabilidade' text: 'Analise ROE (Return on Equity), ROIC (Return on Invested Capital), margens bruta, operacional e líquida.' * name: 'Verificar indicadores de endividamento' text: 'Examine Dívida Líquida/EBITDA, Dívida Líquida/Patrimônio Líquido e índice de cobertura de juros.' * name: 'Analisar indicadores de dividendos' text: 'Calcule Dividend Yield, Payout Ratio e histórico de distribuição para avaliar potencial de renda passiva.' * name: 'Criar score fundamentalista' text: 'Combine todos os indicadores em um score ponderado para comparar empresas e identificar as melhores oportunidades.' howToTools: * 'API brapi.dev' * 'Python com pandas e requests' * 'Jupyter Notebook ou IDE' * 'Planilha de análise' howToSupplies: * 'Token de acesso brapi.dev' * 'Lista de tickers para análise' * 'Benchmark setorial para comparação' * 'Histórico de indicadores' *** import { Authors, Author } from '~/components/Authors'; > Este é o guia definitivo dos indicadores fundamentalistas para análise de ações brasileiras. Aprenda a interpretar e usar P/L, ROE, ROIC, margens, múltiplos e indicadores de endividamento para construir uma estratégia sólida de investimentos na bolsa brasileira. *** ## Introdução aos Indicadores Fundamentalistas Os **indicadores fundamentalistas** são métricas que permitem avaliar a saúde financeira, rentabilidade, eficiência e valor de uma empresa. Eles são essenciais para tomar decisões de investimento baseadas em dados concretos, não em especulação. ### Por que Usar Indicadores Fundamentalistas? 1. **Identificar Valor Real**: Distinguir preço de valor 2. **Comparar Empresas**: Análise objetiva entre concorrentes 3. **Reduzir Riscos**: Evitar empresas com fundamentos fracos 4. **Construir Estratégia**: Base para decisões de longo prazo ## Framework Completo de Análise ### Categorias de Indicadores Para análise fundamentalista completa, você pode buscar todos os módulos de uma vez: ```typescript // Buscar dados completos para análise fundamentalista const response = await fetch( 'https://brapi.dev/api/quote/ITUB4?modules=defaultKeyStatistics,financialData,summaryProfile,balanceSheetHistory,incomeStatementHistory,cashflowHistory', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Retorna todos os indicadores em uma única chamada ``` A API retorna indicadores organizados nas seguintes categorias: | Categoria | Indicadores Disponíveis | | ----------------- | ------------------------------------------------------- | | **Múltiplos** | P/L, P/VP, PSR, EV/EBITDA, PEG Ratio | | **Rentabilidade** | ROE, ROA, ROIC, Margens (bruta, operacional, líquida) | | **Eficiência** | Giro do Ativo, Giro do Estoque, Prazo Médio Recebimento | | **Liquidez** | Liquidez Corrente, Liquidez Seca | | **Endividamento** | Debt/Equity, Debt/Assets, Interest Coverage | | **Crescimento** | Crescimento Receita, Crescimento Lucro | | **Dividendos** | Dividend Yield, Payout Ratio | ### Sistema de Score Fundamentalista Para criar um score de qualidade (0-100), considere os pesos: | Categoria | Peso | Critério Excelente | | ------------- | ---- | ----------------------- | | Múltiplos | 25% | P/L \< 8, P/VP \< 1,5 | | Rentabilidade | 30% | ROE > 15%, Margem > 10% | | Liquidez | 15% | Liquidez Corrente > 1,5 | | Endividamento | 15% | Debt/Equity \< 0,5 | | Crescimento | 15% | Receita > 10% a.a. | ## 1. Múltiplos de Avaliação ### P/L (Preço sobre Lucro) **Definição**: Relaciona o preço da ação com o lucro por ação **Fórmula**: `P/L = Preço da Ação ÷ Lucro por Ação` #### Interpretação: * **P/L \< 10**: Possivelmente subvalorizada * **10 \< P/L \< 20**: Faixa considerada normal * **P/L > 20**: Pode estar cara ou com grande potencial ### P/VP (Preço sobre Valor Patrimonial) **Definição**: Compara valor de mercado com patrimônio líquido **Fórmula**: `P/VP = Preço da Ação ÷ Valor Patrimonial por Ação` #### Interpretação: * **P/VP \< 1**: Negociada abaixo do valor contábil * **P/VP = 1**: Preço igual ao valor patrimonial * **P/VP > 1**: Prêmio sobre valor contábil ### EV/EBITDA (Enterprise Value sobre EBITDA) **Definição**: Valor da empresa sobre lucro operacional **Fórmula**: `EV/EBITDA = (Market Cap + Dívida Líquida) ÷ EBITDA` #### Interpretação: * **EV/EBITDA \< 8**: Potencialmente barata * **8 \< EV/EBITDA \< 15**: Faixa normal * **EV/EBITDA > 15**: Possivelmente cara ## 2. Indicadores de Rentabilidade ### ROE (Return on Equity) **Definição**: Retorno sobre patrimônio líquido **Fórmula**: `ROE = Lucro Líquido ÷ Patrimônio Líquido` #### Interpretação: * **ROE > 15%**: Excelente * **10% \< ROE \< 15%**: Boa * **ROE \< 10%**: Abaixo da média ### ROIC (Return on Invested Capital) **Definição**: Retorno sobre capital investido **Fórmula**: `ROIC = NOPAT ÷ Capital Investido` #### Interpretação: * **ROIC > 12%**: Empresa cria valor * **ROIC = Custo do Capital**: Neutra * **ROIC \< Custo do Capital**: Destrói valor ### Margens de Lucro Para analisar a evolução das margens ao longo do tempo, busque o módulo `incomeStatementHistory`: ```typescript // Buscar histórico de DRE para análise de margens const response = await fetch( 'https://brapi.dev/api/quote/ITUB4?modules=incomeStatementHistory', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Retorna incomeStatementHistory com dados dos últimos 3-4 anos // Calcule: Margem = (Lucro / Receita) × 100 ``` **Tipos de Margens:** | Margem | Fórmula | O que mede | | --------------- | ----------------------- | ---------------------------- | | **Bruta** | Lucro Bruto / Receita | Eficiência na produção | | **Operacional** | EBIT / Receita | Eficiência operacional | | **EBITDA** | EBITDA / Receita | Geração de caixa operacional | | **Líquida** | Lucro Líquido / Receita | Resultado final | ## 3. Indicadores de Eficiência ### Giro dos Ativos **Definição**: Eficiência no uso dos ativos para gerar receita **Fórmula**: `Giro = Receita Líquida ÷ Ativo Total` ### ROA (Return on Assets) **Definição**: Retorno sobre ativos totais **Fórmula**: `ROA = Lucro Líquido ÷ Ativo Total` ## 4. Indicadores de Liquidez ### Liquidez Corrente **Definição**: Capacidade de pagamento no curto prazo **Fórmula**: `LC = Ativo Circulante ÷ Passivo Circulante` #### Interpretação: * **LC > 2**: Excelente liquidez * **1,5 \< LC \< 2**: Boa liquidez * **LC \< 1**: Problemas de liquidez ### Liquidez Seca **Definição**: Liquidez excluindo estoques **Fórmula**: `LS = (Ativo Circulante - Estoques) ÷ Passivo Circulante` ## 5. Indicadores de Endividamento ### Debt-to-Equity **Definição**: Proporção entre dívida e patrimônio **Fórmula**: `D/E = Dívida Total ÷ Patrimônio Líquido` #### Interpretação: * **D/E \< 0,5**: Baixo endividamento * **0,5 \< D/E \< 1,0**: Endividamento moderado * **D/E > 1,0**: Alto endividamento ## Screening Fundamentalista Avançado ### Sistema de Filtros Múltiplos Para fazer screening de ações, busque a lista de ações e aplique filtros localmente: ```typescript // Buscar lista de ações para screening const response = await fetch( 'https://brapi.dev/api/quote/list?sortBy=market_cap_basic&sortOrder=desc&limit=100', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Para cada ação da lista, busque os indicadores: // GET /api/quote/{ticker}?modules=defaultKeyStatistics,financialData ``` **Critérios de Screening Conservador:** | Indicador | Filtro Conservador | Filtro Agressivo | | -------------------------- | ------------------ | ---------------- | | P/L Máximo | 15 | 25 | | P/VP Máximo | 2,0 | 3,0 | | EV/EBITDA Máximo | 12 | 18 | | ROE Mínimo | 12% | 10% | | Margem Líquida Mínima | 8% | 5% | | Liquidez Corrente Mínima | 1,2 | 1,0 | | Debt/Equity Máximo | 0,8 | 1,5 | | Crescimento Receita Mínimo | 0% | -5% | **Universo Sugerido para Screening:** Blue chips: ITUB4, BBDC4, PETR4, VALE3, ABEV3, BBAS3, WEGE3, RENT3, LREN3, RAIL3, VIVT3, KLBN11, SBSP3, SUZB3, CCRO3, EGIE3, TAEE11, CMIG4, EQTL3, CSAN3 ## Análise Setorial Comparativa ### Benchmarking por Setor Para análise setorial, busque múltiplas ações e compare indicadores: ```typescript // Comparar empresas do mesmo setor const tickers = 'ITUB4,BBDC4,BBAS3,SANB11' const response = await fetch( `https://brapi.dev/api/quote/${tickers}?modules=defaultKeyStatistics,financialData`, { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Compare P/L, ROE, Margem entre as empresas do setor ``` **Comparação de Setores (Médias Típicas):** | Setor | P/L Médio | P/VP Médio | ROE Médio | D/E Médio | | -------------------- | --------- | ---------- | --------- | --------- | | **Bancos** | 8-12 | 1,0-1,5 | 15-20% | N/A\* | | **Mineração** | 5-10 | 1,0-2,0 | 10-25% | 0,3-0,8 | | **Energia Elétrica** | 8-15 | 1,0-2,0 | 10-18% | 0,5-1,5 | | **Petróleo** | 5-12 | 1,0-3,0 | 15-30% | 0,3-1,0 | | **Varejo** | 15-30 | 2,0-5,0 | 10-25% | 0,5-2,0 | \*Bancos usam métricas específicas de capital **Setores para Análise:** * **Bancos:** ITUB4, BBDC4, BBAS3, SANB11, BPAC11 * **Mineração:** VALE3, CSNA3, USIM5, GOAU4 * **Energia:** EGIE3, CMIG4, TAEE11, SBSP3 * **Petróleo:** PETR4, PRIO3 * **Varejo:** LREN3, PCAR3, ARZZ3 ## Dashboard de Monitoramento ### Sistema de Alertas Para monitorar sua carteira, crie alertas baseados em indicadores fundamentalistas: ```typescript // Monitorar indicadores de uma watchlist const tickers = 'ITUB4,PETR4,VALE3,WEGE3' const response = await fetch( `https://brapi.dev/api/quote/${tickers}?modules=defaultKeyStatistics,financialData`, { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Crie alertas locais verificando os indicadores retornados ``` **Critérios de Alerta Sugeridos:** | Tipo de Alerta | Condição | Ação | | ------------------------- | ---------------------- | --------------------- | | **Oportunidade** | P/L \< 12 e ROE > 15% | Considerar compra | | **Deterioração** | Score \< 60/100 | Revisar posição | | **Risco Alto** | D/E > 1,0 ou LC \< 1,2 | Monitorar de perto | | **Valorização Excessiva** | P/L > 25 ou P/VP > 3,0 | Considerar realização | **Parâmetros Recomendados:** * P/L oportunidade: \< 12 * ROE mínimo para oportunidade: > 15% * Score mínimo de qualidade: 60/100 * Debt/Equity máximo aceitável: 1,0 * Liquidez Corrente mínima: 1,2 ## Casos Práticos de Análise ### Exemplo 1: Análise Bancária (ITUB4) **Indicadores-Chave para Bancos:** * ROE > 15% * P/VP próximo a 1,0-1,5 * Eficiência (relação custo/receita) * Qualidade da carteira de crédito ### Exemplo 2: Análise Industrial (WEGE3) **Indicadores-Chave para Indústria:** * ROIC > 12% * Margem EBITDA > 15% * Giro dos ativos * Crescimento sustentável ### Exemplo 3: Análise Utilities (EGIE3) **Indicadores-Chave para Utilities:** * Dividend Yield > 5% * Debt/Equity controlado * ROE estável * Crescimento de dividendos ## Estratégias de Investimento ### 1. **Growth Investing** * Foco: Crescimento de receita e lucro * Indicadores: ROE, crescimento, ROIC * Aceita múltiplos mais altos ### 2. **Value Investing** * Foco: Múltiplos baixos * Indicadores: P/L, P/VP, EV/EBITDA * Empresas temporariamente desvalorizadas ### 3. **Quality Investing** * Foco: Empresas de alta qualidade * Indicadores: ROE consistente, baixo endividamento * Múltiplos justos por qualidade superior ### 4. **Dividend Investing** * Foco: Renda passiva * Indicadores: DY, payout ratio, histórico * Empresas maduras e estáveis ## Conclusão Os indicadores fundamentalistas são ferramentas essenciais para análise de investimentos. Use este guia como referência, mas lembre-se de sempre considerar o contexto setorial, macroeconômico e qualitativo. ### Pontos-Chave para Sucesso: 1. **Combine Indicadores**: Nunca analise um único indicador isoladamente 2. **Compare com Pares**: Use benchmarks setoriais adequados 3. **Considere Tendências**: Analise evolução temporal, não apenas snapshot 4. **Contextualize**: Considere ciclo econômico e perspectivas futuras 5. **Diversifique**: Não concentre apenas em empresas "baratas" ### Próximos Passos: * **[Implemente screening personalizado](/blog/analise-fundamentalista-acoes-indicadores-essenciais-investir-b3)** com seus critérios * **[Combine com análise técnica](/quotes)** para timing de entrada * **[Use nossa API](/docs)** para automatizar análises * **[Construa sua carteira](/blog/como-construir-carteira-investimentos-diversificada-brapi)** baseada em fundamentos ### Recursos Complementares: * **[Análise P/L específica](/blog/entendendo-indicador-preco-lucro-pl-analise-fundamentalista)** * **[Análise P/VP detalhada](/blog/como-usar-indicador-pvp-valor-patrimonial-analise-acoes)** * **[ROE e eficiência](/blog/roe-retorno-sobre-patrimonio-como-analisar)** * **[Enterprise Value](/blog/enterprise-value-ev-como-calcular-valor-real-empresa)** **Lembre-se**: A análise fundamentalista é uma ferramenta poderosa, mas deve ser usada junto com gestão de risco e diversificação adequada! # EBIT e EBITDA 2025: Guia Completo para Análise de Eficiência Operacional URL: /blog/guia-ebit-e-ebitda.mdx Domine EBIT e EBITDA para análise de ações! Aprenda a calcular e interpretar esses indicadores essenciais na bolsa brasileira ✓ *** searchable: true title: 'EBIT e EBITDA 2025: Guia Completo para Análise de Eficiência Operacional' description: 'Domine EBIT e EBITDA para análise de ações! Aprenda a calcular e interpretar esses indicadores essenciais na bolsa brasileira ✓' date: '2025-08-22' keywords: 'EBIT EBITDA Brasil 2025, análise fundamentalista, eficiência operacional, margem EBITDA, lucro operacional, indicadores financeiros, bolsa brasileira, valuation empresas' author: 'Equipe brapi.dev' category: 'Análise Fundamentalista' subcategory: 'Indicadores Operacionais' readingTime: '14 min' tags: \['EBIT', 'EBITDA', 'Análise Fundamentalista', 'Eficiência Operacional', 'Margem EBITDA', 'Investimentos', 'Bolsa Brasileira', 'Indicadores'] relatedPosts: \['roe-retorno-sobre-patrimonio-como-analisar', 'enterprise-value-ev-como-calcular-valor-real-empresa', 'analise-fundamentalista-acoes-indicadores-essenciais-investir-b3'] featured: true expertise: 'Especialistas em análise de eficiência operacional com 8+ anos de experiência no mercado brasileiro' lastReviewed: '2025-08-22' howToSteps: * name: 'Entender o conceito de EBITDA' text: 'Compreenda que EBITDA = Lucro Operacional + Depreciação + Amortização, representando a lucratividade operacional antes de efeitos contábeis e financeiros.' * name: 'Entender o conceito de EBIT' text: 'Compreenda que EBIT = Receita Líquida - Custos - Despesas Operacionais, mostrando o lucro antes de juros e impostos.' * name: 'Obter dados via API brapi.dev' text: 'Acesse dados de EBIT e EBITDA através da API brapi.dev com os módulos financialData e incomeStatementHistory.' * name: 'Calcular margem EBITDA' text: 'Calcule Margem EBITDA = (EBITDA / Receita Líquida) × 100 para avaliar a eficiência operacional percentual da empresa.' * name: 'Comparar com múltiplo EV/EBITDA' text: 'Use o múltiplo EV/EBITDA (Enterprise Value / EBITDA) para avaliar se a empresa está cara ou barata em relação à sua geração de caixa operacional.' * name: 'Analisar evolução temporal' text: 'Compare EBIT e EBITDA de diferentes períodos para identificar tendências de melhoria ou deterioração operacional.' * name: 'Comparar com concorrentes do setor' text: 'Compare as margens EBITDA com outras empresas do mesmo setor para avaliar posição competitiva e eficiência relativa.' howToTools: * 'API brapi.dev' * 'Calculadora ou planilha' * 'DRE da empresa' * 'Dados setoriais para comparação' howToSupplies: * 'Demonstração de Resultado (DRE)' * 'Notas explicativas (depreciação/amortização)' * 'Receita líquida da empresa' * 'Dados de empresas comparáveis' *** import { Authors, Author } from '~/components/Authors'; > Explore o universo do EBITDA - um indicador fundamental na análise de > empresas. Descubra como calcular o EBITDA, sua margem, e por que é essencial > para o investimento em ações. ## O que é EBITDA (LAJIDA) O EBITDA é um indicador financeiro amplamente utilizado pelos analistas financeiros para avaliar a lucratividade operacional de uma empresa. Ele oferece uma visão clara da lucratividade de uma empresa a partir de suas operações principais, desconsiderando os impactos de decisões financeiras, depreciações, amortizações e impostos. O EBITDA é calculado da seguinte forma: EBITDA = Lucro Operacional + Depreciação + Amortização Este indicador é especialmente útil para empresas com grandes quantidades de ativos fixos que são depreciados ao longo do tempo, ou para empresas que passaram por fusões e aquisições e, portanto, têm grandes quantidades de amortização. Por se concentrar apenas na lucratividade das operações principais, o EBITDA pode ser uma maneira eficaz de comparar a eficiência operacional de diferentes empresas, mesmo aquelas que operam em diferentes setores ou países com diferentes regimes fiscais. No entanto, é importante lembrar que, como o EBITDA exclui custos importantes como juros, impostos, depreciação e amortização, ele deve ser usado em conjunto com outras métricas financeiras para obter uma visão completa da saúde financeira de uma empresa. Na [brapi](https://brapi.dev), entendemos a importância de indicadores financeiros como o EBITDA para uma tomada de decisões assertiva de investimento. Oferecemos uma gama completa de ferramentas e recursos para ajudar os investidores a entender e analisar esses indicadores, auxiliando-os a tomar decisões de investimento mais informadas. ## O que é EBIT (LAJIR) O EBIT (Lucro Antes de Juros e Impostos), também conhecido como LAJIR (Lucro Antes de Juros e Impostos), é uma métrica financeira usada para avaliar a lucratividade operacional de uma empresa. Ela indica o quanto uma empresa gerou de lucro com suas atividades operacionais, sem levar em consideração os efeitos dos juros e impostos. O EBIT é uma medida importante porque se concentra nas operações de uma empresa, o que a torna uma ferramenta útil para comparar a eficiência operacional entre diferentes empresas. Isso é particularmente verdadeiro em setores onde as empresas têm níveis variados de endividamento e estruturas fiscais complexas. A fórmula para calcular o EBIT é bastante simples: EBIT = Receita Operacional - Despesas Operacionais A Receita Operacional refere-se ao dinheiro gerado pelas atividades principais do negócio, enquanto as Despesas Operacionais incluem custos com pessoal, matérias-primas, energia e outros custos associados à produção e entrega de bens e serviços. Por exemplo, se uma empresa tem uma receita operacional de $1 milhão e despesas operacionais de $800.000, seu EBIT seria de $200.000. Isso significa que, depois de cobrir todos os seus custos operacionais, a empresa teria um lucro operacional de $200.000. A compreensão do EBIT pode ajudar os investidores a ter uma visão clara da lucratividade da operação principal de uma empresa, antes de considerar os efeitos dos juros e impostos. Isso pode ser particularmente útil ao comparar empresas com diferentes níveis de dívida e estruturas fiscais. ## O EBITDA na prática A utilidade do EBITDA se dá por sua capacidade de fornecer uma visão clara da operação da empresa, destacando a eficiência de sua produção. Ele é um indicador que permite ao investidor entender o quanto a empresa gera de dinheiro com sua atividade principal. Por isso, o EBITDA é comumente definido como uma métrica da geração de caixa operacional. ## Importância do EBITDA O EBITDA (Lucro Antes de Juros, Impostos, Depreciação e Amortização) é uma medida amplamente usada por investidores e analistas para avaliar a performance e a lucratividade de uma empresa. Ele oferece uma visão mais clara da operação da empresa, eliminando fatores que podem distorcer o resultado final, como impostos, depreciação e amortização. A seguir, algumas razões que destacam a importância do EBITDA: 1. **Comparabilidade**: O EBITDA permite comparar a lucratividade de diferentes empresas, eliminando os efeitos das decisões de financiamento, depreciação de ativos e regimes fiscais. Isso o torna uma métrica útil para comparar empresas dentro do mesmo setor, especialmente em setores capital-intensivos ou com altos níveis de depreciação e amortização. 2. **Foco na operação**: Ao excluir juros, impostos, depreciação e amortização, o EBITDA se concentra no resultado operacional de uma empresa, proporcionando uma visão mais clara de como a empresa está performando em sua operação principal. 3. **Indicador de fluxo de caixa**: O EBITDA pode ser usado como um proxy para o fluxo de caixa operacional, pois mede o dinheiro que a empresa gera a partir de suas operações antes de levar em consideração o custo do capital (juros), impostos e a depreciação e amortização de seus ativos. 4. **Avaliação de empresa**: O EBITDA é frequentemente usado em avaliações de empresas, pois é uma medida útil para calcular múltiplos de valor, como o EV/EBITDA (Valor da Empresa sobre EBITDA), que é um indicador comum de valor relativo no mercado de ações. Embora o EBITDA seja uma ferramenta útil, é importante usá-lo em conjunto com outras métricas financeiras para obter uma visão completa da saúde financeira de uma empresa. Além disso, o EBITDA pode ser manipulado através de práticas contábeis, por isso é crucial examinar também outras medidas financeiras ao analisar a lucratividade de uma empresa. ## EBITDA como calcular Embora o EBITDA não seja um indicador oficialmente reconhecido pelas práticas contábeis adotadas no Brasil, ele pode ser facilmente calculado usando elementos das Demonstrações de Resultados da empresa em questão. O cálculo do EBITDA segue a seguinte fórmula: EBITDA = Lucro Operacional Líquido + Depreciações + Amortizações ## Margem EBITDA A Margem EBITDA é uma métrica financeira que mede a lucratividade de uma empresa antes de juros, impostos, depreciação e amortização em relação à sua receita total. Ela fornece uma visão clara da lucratividade operacional da empresa, independente de elementos como estrutura fiscal, estratégia de financiamento e práticas de depreciação. A fórmula para calcular a Margem EBITDA é: Margem EBITDA = (EBITDA / Receita Total) x 100 A margem EBITDA é expressa como uma porcentagem, fornecendo uma medida do lucro operacional de uma empresa como uma porcentagem de sua receita total. Uma margem EBITDA mais alta indica que uma empresa é mais eficiente em transformar receita em lucro operacional. Por exemplo, se a Margem EBITDA de uma empresa é de 20%, isso significa que ela gera um lucro operacional de 20 centavos para cada dólar de receita que gera. Comparar a Margem EBITDA de diferentes empresas pode ajudar os investidores a entender qual empresa é mais eficiente em termos operacionais. No entanto, como acontece com todas as métricas financeiras, é importante usar a Margem EBITDA em conjunto com outras métricas para obter uma visão completa da saúde financeira de uma empresa. ## Margem EBIT A Margem EBIT é uma métrica financeira que mede a lucratividade operacional de uma empresa em relação às suas receitas totais. É calculada dividindo o EBIT (Lucro Antes de Juros e Impostos) pela receita total e multiplicando o resultado por 100 para obter um percentual. A fórmula para calcular a Margem EBIT é: Margem EBIT = (EBIT / Receita Total) x 100 Esta métrica é particularmente útil para comparar a eficiência operacional de diferentes empresas dentro do mesmo setor, pois normaliza os efeitos das diferenças de tamanho entre as empresas. Uma Margem EBIT elevada indica que uma empresa está gerando um lucro operacional significativo em relação às suas receitas, o que geralmente é visto como um sinal de eficiência e força operacional. Por outro lado, uma Margem EBIT baixa pode sugerir que a empresa está lutando para controlar seus custos operacionais ou que suas receitas estão em declínio. É importante lembrar, no entanto, que a Margem EBIT pode variar significativamente entre diferentes setores. Portanto, ao usar esta métrica para comparar empresas, é melhor comparar empresas dentro do mesmo setor. ## Diferença EBIT e EBITDA (Difereça entre LAJIR e LAJIDA) O EBIT, ou Lucro Operacional, é um resultado preliminar na obtenção do EBITDA. Ele representa o lucro que a empresa obteve com as atividades diretamente ligadas ao negócio. A principal diferença entre os dois é que o EBITDA adiciona de volta ao EBIT os valores de depreciação e amortização, oferecendo uma visão mais precisa da geração de caixa efetiva da empresa. | Métrica | Descrição | | --------------- | ----------------------------------------------------------------------------------------------------------------------- | | EBIT | Mede a lucratividade operacional de uma empresa sem considerar os efeitos dos juros e impostos. | | EBITDA | Mede a lucratividade operacional de uma empresa antes de juros, impostos, depreciação e amortização. | | Lucro Líquido | Mede a lucratividade de uma empresa após todos os custos, incluindo juros e impostos. | | Fluxo de Caixa | Mede a quantidade de dinheiro que entra e sai de uma empresa durante um período específico. | | EBITDA Ajustado | Uma versão modificada do EBITDA que exclui itens não recorrentes ou não caixa. | | Margem EBIT | Mede a lucratividade operacional de uma empresa em relação às suas receitas totais. | | Margem EBITDA | Mede a lucratividade de uma empresa antes de juros, impostos, depreciação e amortização em relação à sua receita total. | ## EBIT Como calcular O EBIT, ou Lucro Antes de Juros e Impostos, é uma métrica financeira que é usada para analisar a lucratividade operacional de uma empresa sem considerar os efeitos dos juros e impostos. O EBIT é calculado subtraindo-se as despesas operacionais da receita operacional. As despesas operacionais são os custos associados à operação diária de um negócio. Elas incluem custos com pessoal, matérias-primas, energia, entre outros. O cálculo do EBIT segue a seguinte fórmula: EBIT = Receita Operacional - Despesas Operacionais ## EBITDA vs EBIT Tanto o EBITDA (Lucro Antes de Juros, Impostos, Depreciação e Amortização) quanto o EBIT são indicadores que fornecem uma visão da eficiência operacional de uma empresa. No entanto, existem diferenças significativas entre eles. O EBITDA é mais abrangente, pois considera os efeitos de depreciação e amortização, que são custos associados à desvalorização de ativos de uma empresa ao longo do tempo. Estes custos podem ser significativos em setores que dependem de grandes investimentos em ativos, como o setor de manufatura. Por outro lado, o EBIT é mais preciso ao analisar a lucratividade operacional, pois exclui os efeitos de depreciação e amortização, que podem ser considerados custos não recorrentes. ## EBITDA vs Lucro Líquido O EBITDA e o Lucro Líquido são indicadores que fornecem uma visão da eficiência operacional de uma empresa. Ambos são úteis para entender a lucratividade de uma empresa, mas têm diferenças importantes. O EBITDA, como mencionado anteriormente, é mais abrangente, pois considera os efeitos de depreciação e amortização. O Lucro Líquido, por outro lado, é mais preciso, pois exclui os efeitos de depreciação e amortização, além de considerar os custos com juros e impostos. ## EBITDA vs Fluxo de Caixa O EBITDA e o Fluxo de Caixa são indicadores que fornecem uma visão da eficiência operacional de uma empresa. O EBITDA, como mencionado anteriormente, é mais abrangente, pois considera os efeitos de depreciação e amortização. Por outro lado, o Fluxo de Caixa é um indicador mais preciso da saúde financeira de uma empresa, pois mede a quantidade de dinheiro que entra e sai de uma empresa durante um período específico. Diferentemente do EBITDA, o Fluxo de Caixa também considera as atividades de investimento e financiamento da empresa. ## EBITDA vs EBITDA Ajustado O EBITDA e o EBITDA Ajustado são indicadores que fornecem uma visão da eficiência operacional de uma empresa. O EBITDA Ajustado é uma versão modificada do EBITDA que exclui itens não recorrentes ou não caixa que podem distorcer a verdadeira lucratividade operacional de uma empresa. Assim como o EBITDA, o EBITDA Ajustado considera os efeitos de depreciação e amortização. No entanto, o EBITDA Ajustado é mais preciso, pois exclui os efeitos de depreciação e amortização que podem ser considerados não recorrentes, proporcionando assim uma visão mais clara do desempenho operacional da empresa. ## Divida Liquida EBITDA A proporção dívida líquida EBITDA é um indicador-chave da saúde financeira de uma empresa. Ele compara a dívida total de uma empresa, menos as disponibilidades, com seu EBITDA. Esse múltiplo permite avaliar a capacidade de uma empresa de honrar suas dívidas com base na geração de caixa que obtém de suas atividades operacionais. Quanto menor a relação, mais saudável é a empresa financeiramente. ## Margem EBITDA por Setor A margem EBITDA pode variar significativamente dependendo do setor em que a empresa atua. Setores com alta intensidade de capital, como petróleo e gás ou construção, geralmente têm margens EBITDA mais altas do que setores de serviços ou varejo, que têm menores necessidades de capital. Comparar a margem EBITDA de uma empresa com a média de seu setor pode proporcionar insights valiosos sobre sua eficiência operacional relativa. ## EBITDA Ajustado O EBITDA ajustado é uma medida do EBITDA que leva em consideração itens não recorrentes, extraordinários ou não operacionais que podem distorcer a verdadeira lucratividade operacional de uma empresa. Esses ajustes podem incluir despesas de reestruturação, ganhos ou perdas por venda de ativos, entre outros. Ao ajustar esses itens, o EBITDA ajustado oferece uma visão mais precisa do desempenho operacional contínuo da empresa. ## Perguntas frequentes ### 1. **O que é EBIT?** EBIT é a abreviação de Earnings Before Interest and Taxes, ou Lucro Antes de Juros e Impostos em português. É uma medida de lucratividade operacional que exclui os efeitos de juros e impostos. ### 2. **Como calcular o EBIT?** O EBIT é calculado subtraindo-se as despesas operacionais da receita operacional. A fórmula é: EBIT = Receita Operacional - Despesas Operacionais. ### 3. **O que é EBITDA?** EBITDA significa Earnings Before Interest, Taxes, Depreciation, and Amortization, ou Lucro Antes de Juros, Impostos, Depreciação e Amortização em português. É uma medida de lucratividade operacional que exclui os efeitos de juros, impostos, depreciação e amortização. ### 4. **Como calcular o EBITDA?** O EBITDA é calculado adicionando depreciação e amortização ao EBIT. A fórmula é: EBITDA = EBIT + Depreciação + Amortização. ### 5. **Qual é a diferença entre EBIT e EBITDA?** A principal diferença entre EBIT e EBITDA é que o EBITDA adiciona depreciação e amortização de volta ao EBIT. Isso faz do EBITDA uma medida de lucratividade mais abrangente para empresas com grandes quantidades de ativos depreciáveis. ### 6. **O que é a margem EBIT e como calculá-la?** A Margem EBIT é a porcentagem de lucro operacional que uma empresa gera a partir de sua receita total. É calculada dividindo o EBIT pela receita total e multiplicando o resultado por 100. ### 7. **O que é a margem EBITDA e como calculá-la?** A Margem EBITDA é a porcentagem de lucro operacional antes de juros, impostos, depreciação e amortização que uma empresa gera a partir de sua receita total. É calculada dividindo o EBITDA pela receita total e multiplicando o resultado por 100. ### 8. **Por que o EBITDA é importante?** O EBITDA é importante porque fornece uma visão clara da lucratividade operacional de uma empresa, excluindo os efeitos de decisões de financiamento, depreciação e amortização e regimes fiscais. Ele é usado para comparar a eficiência operacional entre diferentes empresas e é um indicador comum na avaliação de empresas. ## Conclusão Em resumo, o EBITDA é uma ferramenta valiosa para analisar o desempenho operacional de uma empresa. Ele permite aos investidores e analistas avaliar a eficiência de uma empresa em gerar caixa a partir de suas atividades principais, independentemente de seu tamanho ou setor. No entanto, como qualquer indicador, o EBITDA não deve ser usado isoladamente, mas sim como parte de uma [análise financeira mais ampla](https://brapi.dev/docs). Na brapi, acreditamos que um entendimento completo dos indicadores financeiros é fundamental para tomar decisões de investimento informadas e bem-sucedidas. Para aprender mais sobre investimentos em ações e análises financeiras, visite nossa seção de [documentos sobre ações](https://brapi.dev/docs/acoes) e explore nossos [módulos opcionais](https://brapi.dev/docs/acoes#modules-opcional). # Histórico do Dólar, Euro e Libra via API PTAX: Guia Completo (2026) URL: /blog/historico-dolar-euro-libra-api-ptax-banco-central-2026.mdx Acesse a série histórica diária PTAX do Banco Central via API. USD-BRL desde 1984, EUR-BRL e mais 8 moedas com inverso e cross-rates. Exemplos prontos em TypeScript, Python e cURL. *** searchable: true title: 'Histórico do Dólar, Euro e Libra via API PTAX: Guia Completo (2026)' description: 'Acesse a série histórica diária PTAX do Banco Central via API. USD-BRL desde 1984, EUR-BRL e mais 8 moedas com inverso e cross-rates. Exemplos prontos em TypeScript, Python e cURL.' date: '2026-05-03' keywords: 'historico dolar api, cotacao dolar historica, ptax api, historico euro brl, historico libra brl, dolar comercial historico, api banco central moedas, cotacao dolar fechamento' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Câmbio' readingTime: '11 min' tags: \['API', 'Câmbio', 'Dólar', 'Euro', 'PTAX', 'BCB', 'Histórico'] relatedPosts: \['cross-rate-moedas-ptax-api-eur-usd-gbp-2026', 'api-macroeconomia-brasil-bcb-indicadores-2026'] featured: true expertise: 'Integração com PTAX do BCB via brapi.dev — endpoint /api/v2/currency/historical' lastReviewed: '2026-05-03' howToTools: * 'Conta brapi.dev (Startup ou superior — Pro para inverso e cross-rates)' * 'Node.js 18+, Python 3.8+, ou cURL' howToSteps: * name: 'Crie sua conta brapi.dev' text: 'Acesse brapi.dev e crie sua conta para obter seu token. O plano Startup já libera os históricos diretos contra o real (USD-BRL, EUR-BRL, etc.).' * name: 'Faça a primeira requisição' text: 'GET /api/v2/currency/historical?currency=USD-BRL retorna a série PTAX diária de fechamento dos últimos 12 meses (até 365 pontos).' * name: 'Customize período e múltiplos pares' text: 'Adicione startDate e endDate em formato YYYY-MM-DD. Passe vários pares separados por vírgula (até 20).' * name: 'Use inverso e cross-rates (Pro)' text: 'Para BRL-USD ou USD-EUR via Brasil, faça upgrade para Pro. A API calcula em cada data com observação válida.' * name: 'Integre em gráficos e back-tests' text: 'Use os arrays observations\[] em bibliotecas de charting (Recharts, Plotly, Chart.js) ou back-test cambiais.' *** import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > Acompanhe a cotação histórica diária do dólar, euro, libra e mais 7 moedas > contra o real, direto do PTAX do Banco Central, via uma única API REST. > Suporte a inverso (BRL-USD) e cross-rates (USD-EUR) calculados sobre os > mesmos dados oficiais. Quem precisa de **histórico do dólar comercial** sabe a dor: o site do BCB funciona, mas exige requisições por série SGS, formato CSV de exportação limitada, sem JSON nativo, sem CORS para front-end e sem cross-rate. Se você só queria o gráfico anual do dólar para um relatório, vira projeto. Em maio de 2026 lançamos o `/api/v2/currency/historical` da brapi.dev, que empacota o PTAX (fechamento diário oficial) em uma API JSON moderna, com suporte a múltiplos pares por requisição, inverso e cross-rates calculados em tempo real. *** ## O que é o PTAX e por que ele é o padrão **PTAX** é a taxa de câmbio de referência do Banco Central. Ela é divulgada diariamente em até quatro boletins ("Abertura", "Intermediário 1", "Intermediário 2" e "Fechamento") e representa a **média ponderada** das operações interbancárias durante o dia. Em todo o Brasil, contratos, balanços corporativos, declarações de imposto e operações financeiras usam o **PTAX de fechamento (venda)** como referência. É o número que aparece no jornal no dia seguinte — e é exatamente o que a brapi.dev retorna em `/api/v2/currency/historical`. **Use PTAX para:** balanços, contratos, fechamento de mês/ano, back-test de estratégias diárias, gráficos. **Não use PTAX para:** preço *intraday* (variação no segundo), trading de alta frequência, ou paridade real para envio de remessas (cada banco aplica spread sobre o PTAX). Para cotação em tempo real, use [`/api/v2/currency`](/docs/moedas). *** ## Pares de moedas suportados Dez moedas estrangeiras com cotação contra o real, todas com PTAX direto do BCB: | Par | Moeda | Início do histórico | | --------- | ------------------ | ------------------- | | `USD-BRL` | Dólar Americano | 1984-11-28 | | `EUR-BRL` | Euro | 1999-01-04 | | `GBP-BRL` | Libra Esterlina | 1999-01-04 | | `JPY-BRL` | Iene Japonês | 1999-01-04 | | `CHF-BRL` | Franco Suíço | 1999-01-04 | | `CAD-BRL` | Dólar Canadense | 1999-01-04 | | `AUD-BRL` | Dólar Australiano | 1999-01-04 | | `DKK-BRL` | Coroa Dinamarquesa | 1999-01-04 | | `NOK-BRL` | Coroa Norueguesa | 1999-01-04 | | `SEK-BRL` | Coroa Sueca | 1999-01-04 | O dólar é o único com histórico desde 1984 (há quase 42 anos, abrangendo todo o período pós-Plano Real). As demais começam em 1999 quando o BCB incluiu pares G10 no SGS. *** ## Endpoint `/api/v2/currency/historical` ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/currency/historical?currency=USD-BRL" ``` **Resposta:** ```json { "results": [ { "pair": "USD-BRL", "fromCurrency": "USD", "toCurrency": "BRL", "observations": [ { "date": "2026-04-30", "value": 4.9886 }, { "date": "2026-04-29", "value": 4.9712 }, { "date": "2026-04-28", "value": 4.9854 } ] } ], "requestedAt": "2026-04-30T12:00:00.000Z", "took": 14 } ``` ### Parâmetros | Parâmetro | Descrição | Default | | ------------------------ | ------------------------------------- | -------------- | | `currency` (obrigatório) | Pares separados por vírgula (máx. 20) | — | | `startDate` | Data inicial YYYY-MM-DD | 12 meses atrás | | `endDate` | Data final YYYY-MM-DD | hoje | | `sortOrder` | `asc` ou `desc` | `desc` | | `limit` | Observações por par | 365 | Para histórico desde o início, passe `startDate=1984-11-28` (apenas USD-BRL) ou `startDate=1999-01-04` (demais). *** ## Múltiplos pares em uma única chamada Pegue dólar, euro, libra e iene simultaneamente: ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/currency/historical?currency=USD-BRL,EUR-BRL,GBP-BRL,JPY-BRL" ``` Cada par vem como um item em `results[]` na ordem solicitada. Use isso para montar gráficos comparativos ou correlações em uma só requisição. *** ## Inverso e cross-rates (Pro) Além dos pares diretos, a API calcula: * **Inverso** (`BRL-USD`): `1 / X-BRL` em cada data observada * **Cross-rate** (`USD-EUR`): `USD-BRL / EUR-BRL` em cada data com observação em ambas as séries Ambos requerem plano **Pro**. O cálculo é feito sobre os mesmos dados PTAX, então o resultado é matematicamente idêntico ao que você obteria fazendo as duas consultas e dividindo manualmente — só sem o trabalho. ```bash # Inverso: quantos dólares vale 1 real curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/currency/historical?currency=BRL-USD" # Cross-rate: euro contra dólar, derivado do PTAX brasileiro curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/currency/historical?currency=EUR-USD,GBP-USD" ``` Saiba mais em [Cross-rate de moedas com PTAX](/blog/cross-rate-moedas-ptax-api-eur-usd-gbp-2026). *** ## Exemplo TypeScript: gráfico do dólar dos últimos 5 anos ```typescript type Observation = { date: string; value: number }; type HistoricalResponse = { results: Array<{ pair: string; fromCurrency: string; toCurrency: string; observations: Observation[]; }>; }; async function fetchUsdBrl5y(): Promise { const today = new Date().toISOString().slice(0, 10); const fiveYearsAgo = new Date(); fiveYearsAgo.setFullYear(fiveYearsAgo.getFullYear() - 5); const start = fiveYearsAgo.toISOString().slice(0, 10); const url = new URL('https://brapi.dev/api/v2/currency/historical'); url.searchParams.set('currency', 'USD-BRL'); url.searchParams.set('startDate', start); url.searchParams.set('endDate', today); url.searchParams.set('sortOrder', 'asc'); url.searchParams.set('limit', '10000'); const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` }, }); const data: HistoricalResponse = await res.json(); return data.results[0]?.observations ?? []; } // Plug em qualquer biblioteca de charting const series = await fetchUsdBrl5y(); console.log(`${series.length} pontos diários`); ``` ## Exemplo Python: comparativo dólar vs. euro vs. libra ```python import os from datetime import date, timedelta import requests def fetch_history(pairs: list[str], years: int): end = date.today().isoformat() start = (date.today() - timedelta(days=365 * years)).isoformat() response = requests.get( 'https://brapi.dev/api/v2/currency/historical', params={ 'currency': ','.join(pairs), 'startDate': start, 'endDate': end, 'sortOrder': 'asc', 'limit': 10000, }, headers={'Authorization': f"Bearer {os.environ['BRAPI_TOKEN']}"}, ) response.raise_for_status() return {item['pair']: item['observations'] for item in response.json()['results']} series = fetch_history(['USD-BRL', 'EUR-BRL', 'GBP-BRL'], years=5) for pair, obs in series.items(): last = obs[-1] if obs else None print(f"{pair}: {len(obs)} pts — último: {last}") ``` ## Exemplo cURL: máxima e mínima do dólar no ano ```bash curl -s -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/v2/currency/historical?currency=USD-BRL&startDate=2026-01-01&endDate=2026-04-30&limit=10000" \ | jq '.results[0].observations | {max: max_by(.value), min: min_by(.value)}' ``` *** ## Casos de uso reais ### Conversão histórica para balanços e impostos Reconhecimento de receita em moeda estrangeira, declaração de bens no IRPF ou conversão de contratos antigos: o PTAX de fechamento é o número aceito pela Receita Federal e auditoria. ### Back-testing cambial Estratégias de hedge cambial, simulação de fundos com exposição em dólar ou cesta de moedas. O `limit=10000` traz o histórico completo de uma só vez. ### Gráficos de longo prazo Dashboards corporativos com tendência de 5, 10 ou 20 anos. Cache de 15 min na API + cache no cliente reduzem o custo a virtualmente zero após a primeira requisição. ### Análise de risco Cálculo de volatilidade realizada (desvio padrão dos retornos diários), correlação entre moedas e VaR cambial — tudo a partir das observações JSON. ```typescript // Volatilidade anualizada do USD-BRL (252 dias úteis) const obs = await fetchUsdBrl5y(); const returns = obs .slice(1) .map((d, i) => Math.log(d.value / obs[i].value)); const mean = returns.reduce((a, b) => a + b, 0) / returns.length; const variance = returns.reduce((acc, r) => acc + (r - mean) ** 2, 0) / (returns.length - 1); const annualVol = Math.sqrt(variance * 252) * 100; console.log(`Volatilidade anualizada: ${annualVol.toFixed(2)}%`); ``` ### Aplicações multi-currency Apps que exibem patrimônio em múltiplas moedas (cripto + ações + estrangeiras) podem usar o histórico para mostrar a evolução real do portfólio em cada moeda ao longo do tempo. *** ## Cuidados práticos 1. **PTAX só existe em dias úteis.** Fins de semana e feriados não têm observação. Se seu front-end mostra um gap, é esperado — o BCB não publica. 2. **Janela padrão é 12 meses.** Se você precisa do histórico todo, passe explicitamente `startDate` mais antigo + `limit=10000`. 3. **Inverso e cross-rate exigem plano Pro.** Os pares diretos (X-BRL) estão no plano Startup. 4. **Para tempo real, use `/api/v2/currency`.** Esse endpoint mostra o preço *intraday*, com bid/ask, atualizado a cada poucos minutos. O `/historical` é PTAX de fechamento — só atualiza no fim do dia. 5. **Cripto não está em `/historical`.** O endpoint só cobre as 10 moedas fiat suportadas pelo PTAX. Para BTC-BRL, use `/api/v2/crypto`. *** ## Endpoints relacionados * 📈 [Documentação completa do `/api/v2/currency/historical`](/docs/moedas/historico) * 💵 [Cotações em tempo real (`/api/v2/currency`)](/docs/moedas) * 🔄 [Cross-rate de moedas com PTAX](/blog/cross-rate-moedas-ptax-api-eur-usd-gbp-2026) * 📊 [API de Macroeconomia (Selic, IPCA, CDI)](/blog/api-macroeconomia-brasil-bcb-indicadores-2026) Crie sua conta em [brapi.dev](https://brapi.dev) e teste com USD-BRL nos últimos 30 dias para ver a estrutura da resposta. O plano Startup já libera os pares diretos contra BRL. # Conheça a Nova IA Assistente da brapi: Tire Suas Dúvidas Sobre a API URL: /blog/ia-assistente-brapi-tire-suas-duvidas.mdx Lançamos nossa IA assistente! Agora você pode perguntar qualquer coisa sobre a API da brapi, tirar dúvidas de implementação e receber ajuda personalizada para seus projetos financeiros. *** searchable: true title: 'Conheça a Nova IA Assistente da brapi: Tire Suas Dúvidas Sobre a API' description: 'Lançamos nossa IA assistente! Agora você pode perguntar qualquer coisa sobre a API da brapi, tirar dúvidas de implementação e receber ajuda personalizada para seus projetos financeiros.' date: '2026-01-01' keywords: 'ia assistente brapi, ajuda api, suporte inteligente, dúvidas implementação, assistente virtual, api financeira, desenvolvimento, 2026' author: 'Equipe brapi.dev' category: 'Anúncios e Novidades' subcategory: 'Lançamentos' readingTime: '6 min' tags: \[ 'IA', 'Assistente', 'Suporte', 'API', 'Novidades', 'Desenvolvimento', 'Ajuda', ] relatedPosts: \[ 'lancamento-sdks-oficiais-typescript-python', 'b3-api-gratuita-como-usar-cotacoes', 'api-b3-typescript-javascript-integracao-completa', 'novos-modulos-na-brapi', ] featured: true expertise: 'Inteligência Artificial e experiência do desenvolvedor' lastReviewed: 2026-01-03 ------------------------ import { Author, Authors } from '~/components/Authors'; > Estamos muito felizes em apresentar nossa nova IA assistente! Uma ferramenta > inteligente que vai revolucionar como você interage com a API da brapi, > oferecendo ajuda instantânea e personalizada para todas as suas dúvidas. ## O Que É a IA Assistente da brapi? Nossa IA assistente é um sistema inteligente treinado especificamente para: * **Responder perguntas sobre a API** - Desde endpoints básicos até configurações avançadas * **Ajudar na implementação** - Exemplos práticos e código funcional para seu projeto * **Solucionar problemas** - Diagnóstico rápido de erros e sugestões de correção * **Otimizar integrações** - Dicas para melhorar performance e boas práticas * **Documentação interativa** - Explicações claras com exemplos em tempo real ## Como Funciona? A IA assistente está disponível diretamente na nossa documentação e pode ajudar com: ### 📚 **Perguntas Sobre a API** ``` "Como faço para buscar cotações de múltiplas ações?" "Quais parâmetros posso usar no endpoint de histórico?" "Como funciona a autenticação por token?" ``` ### 💻 **Ajuda com Implementação** ``` "Me mostre um exemplo em React para buscar dados da PETR4" "Como integrar com Next.js usando Server Components?" "Qual a melhor forma de tratar erros da API?" ``` ### 🔧 **Solução de Problemas** ``` "Estou recebendo erro 429, o que significa?" "Por que minha requisição está retornando vazia?" "Como otimizar múltiplas requisições?" ``` ## Exemplos Práticos de Ajuda ### Exemplo 1: Implementação Básica **Pergunta do usuário:** *"Como começo a usar a API para buscar cotações em JavaScript?"* **Resposta da IA:** ```javascript // Exemplo básico com fetch const token = 'SEU_TOKEN'; const ticker = 'PETR4'; const response = await fetch( `https://brapi.dev/api/quote/${ticker}`, { headers: { 'Authorization': `Bearer ${token}` } }, ); if (!response.ok) { throw new Error(`Erro: ${response.status}`); } const data = await response.json(); console.log(data.results[0].regularMarketPrice); // Para múltiplos tickers: const response = await fetch( `https://brapi.dev/api/quote/PETR4,VALE3,ITUB4`, { headers: { 'Authorization': `Bearer ${token}` } }, ); ``` ### Exemplo 2: Integração com React **Pergunta do usuário:** *"Como criar um componente React para exibir cotações em tempo real?"* **Resposta da IA:** ```jsx import { useState, useEffect } from 'react'; function StockQuote({ ticker }) { const [data, setData] = useState(null); const [loading, setLoading] = useState(true); const [error, setError] = useState(null); useEffect(() => { async function fetchQuote() { try { const response = await fetch( `https://brapi.dev/api/quote/${ticker}`, { headers: { 'Authorization': `Bearer ${process.env.REACT_APP_BRAPI_TOKEN}` } }, ); if (!response.ok) { throw new Error(`HTTP ${response.status}`); } const result = await response.json(); setData(result.results[0]); } catch (err) { setError(err.message); } finally { setLoading(false); } } fetchQuote(); // Atualiza a cada 15 minutos const interval = setInterval(fetchQuote, 15 * 60 * 1000); return () => clearInterval(interval); }, [ticker]); if (loading) return
Carregando...
; if (error) return
Erro: {error}
; return (

{data.shortName}

R$ {data.regularMarketPrice.toFixed(2)}

= 0 ? 'positive' : 'negative' } > {data.regularMarketChangePercent >= 0 ? '▲' : '▼'} {Math.abs(data.regularMarketChangePercent).toFixed(2)}%

); } ``` ### Exemplo 3: Tratamento de Erros Avançado **Pergunta do usuário:** *"Qual a melhor forma de tratar os diferentes tipos de erro da API?"* **Resposta da IA:** ```javascript class BrapiError extends Error { constructor(message, status, data) { super(message); this.status = status; this.data = data; } } async function fetchWithHandling(url, token) { try { const response = await fetch(url, { headers: { 'Authorization': `Bearer ${token}` }, }); if (!response.ok) { const errorData = await response.json().catch(() => ({})); switch (response.status) { case 401: throw new BrapiError('Token inválido ou expirado', 401, errorData); case 404: throw new BrapiError('Ticker não encontrado', 404, errorData); case 429: throw new BrapiError( 'Limite de requisições excedido', 429, errorData, ); case 500: throw new BrapiError('Erro interno do servidor', 500, errorData); default: throw new BrapiError( `Erro HTTP ${response.status}`, response.status, errorData, ); } } return await response.json(); } catch (error) { if (error instanceof BrapiError) { throw error; } throw new BrapiError('Erro de conexão', 0, { originalError: error.message, }); } } // Uso try { const data = await fetchWithHandling( 'https://brapi.dev/api/quote/PETR4', 'SEU_TOKEN', ); console.log(data); } catch (error) { if (error.status === 401) { // Redirecionar para login ou mostrar formulário de token console.log('Por favor, verifique seu token de API'); } else if (error.status === 429) { // Implementar retry com backoff exponencial console.log('Aguarde um pouco antes de tentar novamente'); } else { console.error('Erro:', error.message); } } ``` ## Recursos Avançados da IA ### 🎯 **Contexto Inteligente** A IA mantém o contexto da conversa, permitindo: ```javascript // Usuário: "Como buscar dados da PETR4?" // IA: Mostra exemplo básico // Usuário: "Agora adicione os dados fundamentalistas" // IA: Adiciona parâmetro modules ao exemplo anterior // Usuário: "E o histórico dos últimos 6 meses?" // IA: Adiciona parâmetros range e interval ``` ### 🔍 **Análise de Código** Cole seu código e receba sugestões: ```javascript // Código do usuário: const fetchStock = async (ticker) => { const res = await fetch(`https://brapi.dev/api/quote/${ticker}`); return res.json(); }; // Sugestão da IA: // "Seu código está quase perfeito! Algumas melhorias: // 1. Adicione o token de autenticação // 2. Verifique se a resposta foi bem-sucedida // 3. Adicione tratamento de erros // 4. Considere usar async/await com try/catch" ``` ### 📊 **Métricas e Performance** A IA pode analisar seu uso e sugerir otimizações: * **Cache inteligente** - Quando e como implementar cache * **Batch requests** - Otimizar múltiplas requisições * **Rate limiting** - Estratégias para evitar limites * **Performance** - Melhores práticas para resposta rápida ## Casos de Uso Comuns ### 📈 **Desenvolvedores Frontend** ```javascript // Pergunta: "Como criar um dashboard com múltiplas ações?" // Resposta: Componente React com estado global, atualização automática // e tratamento de loading/erros ``` ### 🖥️ **Desenvolvedores Backend** > **Pergunta:** "Como criar um endpoint proxy em Node.js?" > > **Resposta:** Express.js middleware com cache Redis, rate limiting e tratamento de erros centralizado. ### 📱 **Desenvolvedores Mobile** ```dart // Pergunta: "Como integrar com Flutter?" // Resposta: Pacote http, tratamento de JSON, // state management com Provider/Bloc ``` ### 🤖 **Cientistas de Dados** > **Pergunta:** "Como analisar séries históricas com pandas?" > > **Resposta:** Coleta de dados, tratamento de missing values, visualização com matplotlib/plotly. ## Dicas para Melhores Interações ### ✅ **Boas Práticas** 1. **Seja específico** - "Como buscar dados fundamentalistas da VALE3?" é melhor que "Como usar a API?" 2. **Forneça contexto** - "Estou usando React com TypeScript e preciso..." 3. **Mostre seu código** - Cole trechos de código que não estão funcionando 4. **Descreva o erro** - "Estou recebendo 404 ao buscar XYZ123" em vez de "Não funciona" ### ❌ **Evite** 1. **Perguntas muito amplas** - "Me ensine a programar" 2. **Informações sensíveis** - Nunca compartilhe tokens ou chaves de API 3. **Código muito longo** - Foque na parte relevante do problema ## Integração com Ferramentas Existentes A IA assistente funciona perfeitamente com: * **SDKs Oficiais** - Exemplos específicos para TypeScript e Python * **Documentação** - Links diretos para seções relevantes * **Playground** - Teste código diretamente no navegador * **Exemplos** - Biblioteca de exemplos prontos para usar ## Feedback Contínuo Nossa IA aprende continuamente: * **Com cada interação** - Melhora suas respostas * **Com feedback dos usuários** - Avalie as respostas como úteis ou não * **Com atualizações da API** - Sempre atualizada com novos recursos ## Como Acessar a IA Assistente ### 🌐 **Via Documentação** Acesse: [brapi.dev/docs](https://brapi.dev/docs) e clique no ícone de chat no canto inferior direito. ### 💬 **Integração Direta** Em breve também estará disponível: * **Slack/Discord** - Bot para comunidades * **VS Code** - Extensão para desenvolvimento * **CLI** - Comando direto no terminal ## Exemplos de Conversas Reais ### Conversa 1: Iniciante ``` Usuário: Olá! Como começo a usar a API? IA: Olá! Para começar, você precisa: 1. Obter um token gratuito em brapi.dev 2. Fazer uma requisição para o endpoint de cotações 3. Adicionar seu token como parâmetro Quer um exemplo prático em qual linguagem? ``` ### Conversa 2: Problema Técnico ``` Usuário: Estou recebendo erro 429 ao fazer muitas requisições IA: Erro 429 significa rate limit excedido. Soluções: 1. Implemente cache de 15 minutos (dados são atualizados nesse intervalo) 2. Use batch requests para múltiplos tickers 3. Adicione delay entre requisições Quer um exemplo de implementação de cache? ``` ### Conversa 3: Projeto Avançado ``` Usuário: Preciso criar um sistema de alertas de preços IA: Para um sistema de alertas, sugiro: 1. Backend com agendador (cron job) 2. Comparação com limiares configuráveis 3. Notificações por email/webhook 4. Banco de dados para histórico Posso te mostrar uma arquitetura completa. Qual sua preferência de tecnologia? ``` ## Limitações e Melhorias Futuras ### 🚧 **Limitações Atuais** * Acesso apenas à documentação pública da API * Não pode acessar dados da sua conta * Respostas baseadas em conhecimento treinado ### 🚀 **Roadmap** * **Contexto de projeto** - Lembrar-se dos seus projetos anteriores * **Análise de performance** - Sugestões baseadas no seu uso real * **Integração com IDEs** - Assistente direto no seu editor * **Multi-idioma** - Suporte completo para inglês e espanhol ## Dicas de Ouro ### 💡 **Para Iniciantes** 1. **Comece simples** - Use os endpoints básicos primeiro 2. **Teste no playground** - Experimente antes de implementar 3. **Leia a documentação** - A IA complementa, não substitui ### 🎯 **Para Intermediários** 1. **Explore módulos** - Dados fundamentalistas enriquecem análises 2. **Otimize requisições** - Cache e batch requests economizam tempo 3. **Trate erros** - Sua aplicação ficará mais robusta ### 🚀 **Para Avançados** 1. **Use webhooks** - Para atualizações em tempo real 2. **Implemente retry** - Para maior confiabilidade 3. **Monitore performance** - Métricas são essenciais ## Conclusão Nossa IA assistente representa um avanço significativo em como oferecemos suporte aos desenvolvedores. Com ajuda instantânea, exemplos práticos e orientação personalizada, seu desenvolvimento com a API da brapi nunca foi tão eficiente. Seja você um iniciante dando os primeiros passos ou um desenvolvedor experiente buscando otimizações, nossa IA está aqui para ajudar. *** ## Comece Agora! 1. **Acesse a documentação** - [brapi.dev/docs](https://brapi.dev/docs) 2. **Clique no chat** - Ícone no canto inferior direito 3. **Faça sua primeira pergunta** - Sem compromisso, sem cadastro **Dúvidas sobre a IA assistente?** Ela mesma pode responder! 😉 *** **Gostou da novidade?** Compartilhe com outros desenvolvedores e ajude-nos a melhorar cada vez mais! 🚀 # EV/EBITDA: Como Usar Este Indicador para Avaliar Ações em 2026 URL: /blog/indicador-ev-ebitda-como-analisar.mdx Guia completo do indicador EV/EBITDA com cálculo passo a passo, interpretação por setor e código Python para automatizar análises ✓ *** searchable: true title: 'EV/EBITDA: Como Usar Este Indicador para Avaliar Ações em 2026' description: 'Guia completo do indicador EV/EBITDA com cálculo passo a passo, interpretação por setor e código Python para automatizar análises ✓' date: '2026-01-01' keywords: 'EV/EBITDA, enterprise value, valor da firma, múltiplo EBITDA, valuation, análise fundamentalista, como calcular EV/EBITDA 2026' author: 'Equipe brapi.dev' category: 'Análise Fundamentalista' subcategory: 'Indicadores' readingTime: '18 min' tags: \['EV/EBITDA', 'Valuation', 'Indicadores', 'Análise Fundamentalista', 'Enterprise Value'] relatedPosts: \['guia-ebit-e-ebitda', 'enterprise-value-ev-como-calcular-valor-real-empresa', 'entendendo-indicador-preco-lucro-pl-analise-fundamentalista', 'roe-retorno-sobre-patrimonio-como-analisar', 'indicador-peg-ratio-como-usar'] featured: true expertise: 'Especialistas em valuation e análise de empresas' lastReviewed: 2026-01-03 ------------------------ ## O Que é o EV/EBITDA? O **EV/EBITDA** é um dos múltiplos de valuation mais utilizados por analistas profissionais e investidores institucionais. Ele relaciona o **valor total da empresa** (Enterprise Value) com sua **geração de caixa operacional** (EBITDA). ``` ┌─────────────────────────────────────────────────────────────────┐ │ FÓRMULA EV/EBITDA │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Enterprise Value (EV) │ │ EV/EBITDA = ───────────────────────────── │ │ EBITDA │ │ │ │ Onde: │ │ • EV = Valor de Mercado + Dívida Líquida │ │ • EBITDA = Lucro Operacional + Depreciação + Amortização │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` ### Por Que EV/EBITDA é Superior ao P/L? O EV/EBITDA resolve várias limitações do tradicional Preço/Lucro: | Aspecto | P/L | EV/EBITDA | | --------------------------------- | --------------------- | -------------------- | | Considera dívida? | ❌ Não | ✅ Sim | | Afetado por estrutura de capital? | ✅ Sim | ❌ Minimamente | | Comparável entre países? | ❌ Impostos diferentes | ✅ Mais comparável | | Funciona com prejuízo? | ❌ Não | ✅ Se EBITDA positivo | | Afetado por depreciação? | ✅ Sim | ❌ Não | ## Entendendo os Componentes ### 1. Enterprise Value (EV) - Valor da Firma O EV representa quanto custaria para comprar 100% da empresa, incluindo suas dívidas: **Exemplo de cálculo do Enterprise Value:** | Componente | Valor | | ------------------------ | ------------------ | | Valor de Mercado | R$ 280 bilhões | | (+) Dívida Bruta | R$ 85 bilhões | | (-) Caixa | R$ 25 bilhões | | (=) Dívida Líquida | R$ 60 bilhões | | **(=) Enterprise Value** | **R$ 340 bilhões** | ``` COMPOSIÇÃO DO ENTERPRISE VALUE ┌────────────────────────────────────────────────────┐ │ │ │ VALOR DE MERCADO ████████████████████ │ │ (Market Cap) R$ 280 bilhões │ │ │ │ (+) DÍVIDA BRUTA ████████ │ │ R$ 85 bilhões │ │ │ │ (-) CAIXA ████ │ │ R$ 25 bilhões │ │ │ │ ════════════════════════════════════════════ │ │ = ENTERPRISE VALUE ████████████████████████│ │ R$ 340 bilhões │ │ │ └────────────────────────────────────────────────────┘ ``` ### 2. EBITDA - Geração de Caixa Operacional O EBITDA (Earnings Before Interest, Taxes, Depreciation and Amortization) representa o lucro operacional antes de itens não-caixa: **Exemplo de cálculo do EBITDA:** | Linha | Valor | | ------------------------- | ------------------- | | Receita Líquida | R$ 50 bilhões | | (-) Custos | R$ 30 bilhões | | (=) Lucro Bruto | R$ 20 bilhões | | (-) Despesas Operacionais | R$ 10 bilhões | | (=) EBIT | R$ 10 bilhões | | (+) Depreciação | R$ 3 bilhões | | (+) Amortização | R$ 500 milhões | | **(=) EBITDA** | **R$ 13,5 bilhões** | | **Margem EBITDA** | **27%** | ``` DA RECEITA AO EBITDA Receita Líquida R$ 50.000.000.000 (-) Custos R$ 30.000.000.000 ──────────────────────────────────────────────────── = Lucro Bruto R$ 20.000.000.000 (-) Despesas Operacionais R$ 10.000.000.000 ──────────────────────────────────────────────────── = EBIT (Lucro Operacional) R$ 10.000.000.000 (+) Depreciação R$ 3.000.000.000 (+) Amortização R$ 500.000.000 ──────────────────────────────────────────────────── = EBITDA R$ 13.500.000.000 (Margem: 27%) ``` ## Calculando o EV/EBITDA na Prática ### Com a API da brapi.dev ```typescript const response = await fetch( 'https://brapi.dev/api/quote/PETR4?modules=defaultKeyStatistics,financialData', { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const { regularMarketPrice, marketCap, enterpriseValue, ebitda } = results[0]; const evEbitda = enterpriseValue / ebitda; ``` **Dados retornados:** | Campo | Descrição | | -------------------- | --------------------------- | | `regularMarketPrice` | Preço atual da ação | | `marketCap` | Capitalização de mercado | | `enterpriseValue` | Enterprise Value calculado | | `ebitda` | EBITDA dos últimos 12 meses | ### Comparativo Setorial ```typescript const tickers = ['PETR4', 'PRIO3', 'RECV3', 'RRRP3', 'ENAT3']; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(',')}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); ``` **Exemplo: Setor de Petróleo e Gás** | Empresa | EV/EBITDA | vs Média Setor | | --------------- | --------- | ------------------ | | PETR4 | 3,2x | 📉 -18% (desconto) | | PRIO3 | 4,5x | 📈 +15% (prêmio) | | RECV3 | 3,8x | 📉 -3% (desconto) | | RRRP3 | 4,1x | 📈 +5% (prêmio) | | ENAT3 | 3,9x | Próximo da média | | **Média Setor** | **3,9x** | - | > Para determinar se uma ação está barata, compare o EV/EBITDA com a média do setor. Descontos acima de 20% merecem investigação. ## Interpretando o EV/EBITDA ### Faixas de Referência por Setor ``` ┌─────────────────────────────────────────────────────────────────┐ │ BENCHMARKS EV/EBITDA POR SETOR │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ Tecnologia/Software ██████████████████████ 15-25x │ │ Saúde ████████████████ 12-18x │ │ Consumo Discricionário ████████████ 10-15x │ │ Industrial ████████████ 8-12x │ │ Utilities/Energia ██████████ 6-10x │ │ Bancos ████████ 5-8x │ │ Commodities/Mineração ██████ 4-7x │ │ Petróleo e Gás ██████ 3-6x │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` ### O Que Afeta o Múltiplo? **Fatores que influenciam o múltiplo EV/EBITDA:** | Fator | Impacto | Explicação | | ---------------------- | ---------- | ------------------------------------------------------- | | Crescimento | ✅ Positivo | Empresas com alto crescimento merecem múltiplos maiores | | Margem EBITDA | ✅ Positivo | Margens altas indicam vantagem competitiva | | Intensidade de Capital | ❌ Negativo | Alto CAPEX reduz conversão de EBITDA em caixa livre | | Ciclicidade | ❌ Negativo | Setores cíclicos têm EBITDA volátil | | Alavancagem | ❌ Negativo | Alta dívida aumenta risco | | Qualidade da Gestão | ✅ Positivo | Boa alocação de capital gera prêmio | **Avaliação rápida de uma empresa:** * ✅ **Margem EBITDA > 30%** → Justifica prêmio no múltiplo * ⚠️ **Margem EBITDA \< 15%** → Pressiona o múltiplo para baixo * ✅ **Crescimento > 15% a.a.** → Justifica múltiplo elevado * ⚠️ **Crescimento \< 5% a.a.** → Limita expansão do múltiplo * 🚨 **Dívida Líquida/EBITDA > 3x** → Risco elevado, desconto no múltiplo * ✅ **Dívida Líquida/EBITDA \< 1x** → Menor risco, pode ter prêmio ### Múltiplo Alto vs. Baixo ``` INTERPRETAÇÃO DO EV/EBITDA EV/EBITDA BAIXO (< média do setor) ├── Possíveis explicações positivas: │ ├── Ação subvalorizada pelo mercado │ ├── Oportunidade de compra │ └── Mercado pessimista demais │ └── Possíveis explicações negativas: ├── Problemas operacionais ├── Setor em declínio ├── Gestão fraca └── EBITDA temporariamente inflado EV/EBITDA ALTO (> média do setor) ├── Possíveis explicações positivas: │ ├── Empresa de alta qualidade │ ├── Alto crescimento esperado │ ├── Margens superiores │ └── Vantagem competitiva forte │ └── Possíveis explicações negativas: ├── Ação sobrevalorizada ├── Euforia do mercado └── EBITDA temporariamente deprimido ``` ## Armadilhas do EV/EBITDA ### 1. EBITDA Não É Caixa O EBITDA ignora necessidades de capital de giro e CAPEX: **Comparando conversão de EBITDA em caixa livre:** | Métrica | Empresa A (Asset Light) | Empresa B (Asset Heavy) | | ---------------------------- | ----------------------- | ----------------------- | | EBITDA | R$ 1.000 | R$ 1.000 | | (-) CAPEX | R$ 200 | R$ 600 | | (-) Variação Capital de Giro | R$ 50 | R$ 100 | | **(=) Fluxo de Caixa Livre** | **R$ 750** | **R$ 300** | | **Taxa de Conversão** | **75%** | **30%** | > Duas empresas com mesmo EBITDA podem ter fluxos de caixa muito diferentes. A Empresa A converte 75% do EBITDA em caixa, enquanto a Empresa B converte apenas 30%. Por isso, analisar apenas o EV/EBITDA pode ser enganoso para empresas capital-intensivas. ### 2. Dívida Oculta Alguns passivos não aparecem no cálculo tradicional: **Exemplo de ajuste por passivos ocultos:** | Componente | Valor | | --------------------------- | ----------------- | | EV Tradicional | R$ 10 bilhões | | (+) Arrendamentos (IFRS 16) | R$ 500 milhões | | (+) Provisões/Contingências | R$ 300 milhões | | (+) Déficit Previdenciário | R$ 200 milhões | | **(=) EV Ajustado** | **R$ 11 bilhões** | | **Diferença** | **+10%** | > Ignorar passivos ocultos pode fazer uma empresa parecer mais barata do que realmente é. Sempre verifique as notas explicativas para identificar obrigações que não aparecem no cálculo padrão do EV. ### 3. EBITDA Ajustado vs. Reportado Empresas frequentemente apresentam EBITDA "ajustado": ``` CUIDADOS COM EBITDA AJUSTADO ✅ Ajustes legítimos: • Eventos não-recorrentes (venda de ativos) • Reestruturações pontuais • Impairments extraordinários ❌ Ajustes questionáveis: • Remuneração baseada em ações • Custos de M&A recorrentes • "Custos de crescimento" • Provisões trabalhistas constantes REGRA: Se o ajuste aparece todo trimestre, provavelmente não é extraordinário! ``` ## Análise Avançada: EV/EBITDA Forward O múltiplo forward usa estimativas futuras: **Exemplo de EV/EBITDA Forward:** | Métrica | Valor | | ------------------------------ | ------------- | | Enterprise Value | R$ 50 bilhões | | EBITDA Atual | R$ 5 bilhões | | Crescimento Estimado | +20% | | EBITDA Forward (12 meses) | R$ 6 bilhões | | **EV/EBITDA Trailing** | **10,0x** | | **EV/EBITDA Forward** | **8,3x** | | **"Desconto" por Crescimento** | **17%** | > O múltiplo forward é especialmente útil para empresas em crescimento. Uma ação que parece cara no trailing (10x) pode estar razoável no forward (8,3x) se o crescimento se concretizar. ## Screener de Ações por EV/EBITDA Para filtrar ações por EV/EBITDA, use o endpoint `/quote/list` combinado com dados fundamentalistas: ```typescript const response = await fetch( 'https://brapi.dev/api/quote/list?limit=50&type=stock', { headers: { Authorization: `Bearer ${token}` } } ); const { stocks } = await response.json(); const tickers = stocks.map(s => s.stock).join(','); const detailsResponse = await fetch( `https://brapi.dev/api/quote/${tickers}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await detailsResponse.json(); ``` **Exemplo de critérios para screener:** | Critério | Filtro | | -------------------- | ------ | | EV/EBITDA mínimo | 3x | | EV/EBITDA máximo | 8x | | Margem EBITDA mínima | 20% | **Resultado do screener (exemplo):** | Ticker | EV/EBITDA | Margem EBITDA | Setor | | ------ | --------- | ------------- | ---------- | | BBAS3 | 3,8x | 28% | Financeiro | | CMIG4 | 4,2x | 35% | Energia | | TAEE11 | 5,1x | 72% | Energia | | ENBR3 | 5,5x | 42% | Energia | | CPLE6 | 5,8x | 38% | Energia | ## Valuation Reverso: Implícito no Múltiplo **Valuation reverso: descobrindo o crescimento implícito no múltiplo** O múltiplo EV/EBITDA atual embute uma expectativa de crescimento. Podemos usar um modelo simplificado para descobrir qual crescimento o mercado está precificando: | Variável | Valor | | ---------------------------------------- | --------------- | | EV/EBITDA Atual | 15x | | Custo de Capital (WACC) | 12% | | **Crescimento Implícito** | **\~5,3% a.a.** | | Crescimento Sustentável (PIB + Inflação) | \~5% | | **Avaliação** | **JUSTO** | **Interpretação:** | Cenário | Crescimento Implícito vs Sustentável | Avaliação | | ------------------------- | ----------------------------------------------------- | --------- | | Diferença > +3% | Mercado espera crescimento muito acima do sustentável | 🔴 CARO | | Diferença entre -3% e +3% | Expectativas alinhadas | 🟡 JUSTO | | Diferença \< -3% | Mercado espera crescimento abaixo do provável | 🟢 BARATO | ## Comparação Internacional **EV/EBITDA médio por mercado:** | Mercado | EV/EBITDA Médio | vs Brasil | | ------------------ | --------------- | --------- | | Brasil (Ibovespa) | 6,2x | - | | México (IPC) | 7,5x | +21% | | Europa (STOXX 600) | 10,8x | +74% | | China (CSI 300) | 12,0x | +94% | | EUA (S\&P 500) | 14,5x | +134% | | Índia (NIFTY) | 15,5x | +150% | > O Brasil historicamente negocia com desconto em relação a mercados desenvolvidos. Isso reflete maior risco-país, taxa de juros elevada e menor liquidez. Ao comparar empresas brasileiras com pares internacionais, ajuste para essa diferença estrutural. ``` === EV/EBITDA MÉDIO POR MERCADO === Brasil (Ibovespa) ██████ 6.2x (+0% vs Brasil) México (IPC) ███████ 7.5x (+21% vs Brasil) Europa (STOXX 600) ██████████ 10.8x (+74% vs Brasil) China (CSI 300) ████████████ 12.0x (+94% vs Brasil) EUA (S&P 500) ██████████████ 14.5x (+134% vs Brasil) Índia (NIFTY) ███████████████ 15.5x (+150% vs Brasil) ``` ## Quando NÃO Usar EV/EBITDA O múltiplo não funciona bem em: | Setor/Situação | Problema | Alternativa | | -------------------- | ------------------------ | -------------------- | | Bancos | EBITDA não faz sentido | P/L, P/VP | | Seguradoras | Estrutura diferente | P/L, Combined Ratio | | Empresas em prejuízo | EBITDA pode ser negativo | P/Receita, EV/Vendas | | Early-stage tech | Sem lucro operacional | EV/Receita, EV/GMV | | Holdings | Estrutura complexa | NAV, soma das partes | ## Conclusão: Usando EV/EBITDA com Sabedoria O EV/EBITDA é poderoso, mas deve ser usado com contexto: ### Checklist de Análise ``` □ Calculei o EV/EBITDA corretamente? □ Comparei com empresas do MESMO setor? □ Entendi por que o múltiplo está alto/baixo? □ Verifiquei a conversão de EBITDA em caixa? □ Considerei passivos ocultos no EV? □ Analisei a sustentabilidade do EBITDA? □ Olhei o múltiplo forward também? □ Considerei fatores qualitativos? ``` ### Melhores Práticas 1. **Compare sempre dentro do setor** - Múltiplos variam drasticamente entre setores 2. **Use múltiplos complementares** - P/L, P/VP, EV/FCF 3. **Analise tendência** - O múltiplo está comprimindo ou expandindo? 4. **Entenda os drivers** - Por que o múltiplo está nesse nível? 5. **Cuidado com ajustes** - EBITDA ajustado pode esconder problemas ## Próximos Passos Para aprofundar suas análises de valuation: 1. **Acesse a brapi.dev** - Dados fundamentalistas completos para calcular EV/EBITDA 2. **Explore a documentação** em [brapi.dev/docs](https://brapi.dev/docs) 3. **Automatize com Python** - Use os códigos deste guia 4. **Compare setores** - Construa benchmarks próprios A [brapi.dev](https://brapi.dev) fornece Enterprise Value, EBITDA e todos os dados necessários para suas análises de múltiplos via API. *** *Disclaimer: Este conteúdo é educacional. Consulte um profissional antes de investir.* # PEG Ratio: Como Usar Este Indicador de Crescimento 2026 URL: /blog/indicador-peg-ratio-como-usar.mdx Aprenda a calcular e interpretar o PEG Ratio para encontrar ações de crescimento a preços justos ✓ Fórmula, exemplos práticos e quando usar *** searchable: true title: 'PEG Ratio: Como Usar Este Indicador de Crescimento 2026' description: 'Aprenda a calcular e interpretar o PEG Ratio para encontrar ações de crescimento a preços justos ✓ Fórmula, exemplos práticos e quando usar' date: '2026-01-01' keywords: 'PEG ratio, price earnings growth, indicador PEG, ações crescimento, valuation crescimento, P/L ajustado crescimento, análise fundamentalista 2026' author: 'Equipe brapi.dev' category: 'Análise Fundamentalista' subcategory: 'Indicadores de Valuation' readingTime: '18 min' tags: \['PEG Ratio', 'Valuation', 'Crescimento', 'Análise Fundamentalista', 'Indicadores'] relatedPosts: \['entendendo-indicador-preco-lucro-pl-analise-fundamentalista', 'indicador-ev-ebitda-como-analisar', 'value-investing-como-encontrar-acoes-baratas', 'acoes-growth-vs-value-brasil', 'roe-retorno-sobre-patrimonio-como-analisar'] featured: true expertise: 'Especialistas em valuation e análise de empresas de crescimento' lastReviewed: 2026-01-03 ------------------------ ## O Que é o PEG Ratio e Por Que Ele Importa O **PEG Ratio (Price/Earnings to Growth)** é um indicador que ajusta o tradicional P/L pelo crescimento esperado dos lucros. Ele responde a uma pergunta crucial: **o P/L alto dessa ação é justificado pelo seu crescimento?** Enquanto o P/L simples pode fazer uma empresa de crescimento parecer cara, o PEG coloca tudo em perspectiva. Uma empresa com P/L de 30x que cresce 30% ao ano pode ser mais barata que uma com P/L de 15x que cresce apenas 5%. ### A Fórmula do PEG Ratio ``` PEG Ratio = P/L ÷ Taxa de Crescimento dos Lucros (%) Onde: • P/L = Preço / Lucro por Ação • Taxa de Crescimento = Crescimento anual esperado do LPA (%) ``` **Exemplo prático:** * Empresa A: P/L = 25x, Crescimento = 25% → PEG = 1,0 * Empresa B: P/L = 15x, Crescimento = 10% → PEG = 1,5 * Empresa C: P/L = 40x, Crescimento = 50% → PEG = 0,8 Neste exemplo, a Empresa C com P/L de 40x é a mais barata pelo PEG! ## Interpretando o PEG Ratio A regra geral popularizada por Peter Lynch: | PEG Ratio | Interpretação | Ação Sugerida | | ------------- | -------------------------------- | ---------------------- | | **\< 1,0** | Subvalorizada para o crescimento | Potencial compra | | **= 1,0** | Preço justo | Avaliar outros fatores | | **1,0 - 2,0** | Valorização justa a cara | Cautela | | **> 2,0** | Sobrevalorizada | Evitar ou vender | ``` ┌─────────────────────────────────────────────────────────────┐ │ ESCALA DO PEG │ ├─────────────────────────────────────────────────────────────┤ │ │ │ 0.0 0.5 1.0 1.5 2.0 2.5 3.0 │ │ │─────│─────│─────│─────│─────│─────│ │ │ ████████████│░░░░░░░░░░░│ │ │ BARATO │ JUSTO │ CARO │ │ │ │ │ │ Oportunidade │ Avaliar │ Evitar │ │ de compra │ contexto │ │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Cuidados na Interpretação O PEG tem limitações importantes: 1. **Crescimento é projeção**: Baseado em estimativas que podem não se concretizar 2. **Ignora qualidade do crescimento**: Crescimento orgânico vs aquisições 3. **Não considera risco**: Empresas de alto crescimento são mais arriscadas 4. **Setores diferentes**: Benchmarks variam por indústria ## Calculando o PEG Ratio na Prática Existem diferentes formas de calcular o PEG, dependendo do horizonte temporal: ### PEG Trailing (Histórico) Usa o crescimento passado dos lucros: **Exemplo: WEGE3 - PEG Trailing** | Métrica | Valor | | ------------------------- | ----------- | | Empresa | WEG S.A. | | Preço | R$ 52,80 | | P/L | 32,5x | | Crescimento (CAGR 3 anos) | 28,5% a.a. | | **PEG Ratio** | **1,14** | | Interpretação | Preço justo | **Escala de Interpretação do PEG:** * **\< 0,5**: Muito barato - verificar riscos * **0,5 - 1,0**: Subvalorizado - potencial oportunidade * **1,0 - 1,5**: Preço justo * **1,5 - 2,0**: Levemente caro * **> 2,0**: Sobrevalorizado ```typescript // Obter dados para calcular PEG Trailing const response = await fetch( `https://brapi.dev/api/quote/WEGE3?modules=incomeStatementHistory,defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // Calcular CAGR do lucro e dividir P/L pelo crescimento ``` ### PEG Forward (Projetado) Usa estimativas de crescimento futuro dos analistas: **Exemplo: TOTS3 - PEG Forward** | Métrica | Valor | | -------------------- | ----------- | | Ticker | TOTS3 | | P/L Trailing | 28,5x | | P/L Forward | 22,0x | | Crescimento Estimado | 24,8% | | **PEG Forward** | **1,15** | | Interpretação | Preço justo | O PEG Forward é mais útil para empresas com crescimento acelerando, pois considera as projeções futuras ao invés do histórico passado. ```typescript // Obter dados para calcular PEG Forward const response = await fetch( `https://brapi.dev/api/quote/TOTS3?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // Usar P/L trailing e forwardPE para estimar crescimento implícito ``` ## PEG por Setor: Benchmarks de Referência O PEG ideal varia significativamente por setor: | Setor | PEG Típico | Motivo | | -------------------------- | ---------- | ------------------------------------ | | **Tecnologia** | 1,0 - 2,0 | Alto crescimento esperado | | **Consumo Discricionário** | 1,0 - 1,5 | Crescimento cíclico | | **Bancos** | 0,8 - 1,2 | Crescimento moderado, previsível | | **Utilities** | 1,5 - 2,5 | Baixo crescimento, alta estabilidade | | **Commodities** | 0,5 - 1,0 | Cíclico, volátil | | **Saúde** | 1,0 - 2,0 | Crescimento defensivo | **Comparativo PEG - Setor Bancário** | Ticker | Nome | P/L | Crescimento | PEG | | ------ | ---------------- | ----- | ----------- | ---- | | BBAS3 | Banco do Brasil | 5,2x | 8,5% | 0,61 | | ITUB4 | Itaú Unibanco | 8,8x | 12,3% | 0,72 | | BBDC4 | Bradesco | 9,5x | 10,8% | 0,88 | | SANB11 | Santander Brasil | 11,2x | 9,5% | 1,18 | Neste comparativo, BBAS3 apresenta o menor PEG, sugerindo melhor relação entre valuation e crescimento dentro do setor bancário. ```typescript // Comparar PEG de múltiplos bancos const tickers = "ITUB4,BBDC4,BBAS3,SANB11"; const response = await fetch( `https://brapi.dev/api/quote/${tickers}?modules=incomeStatementHistory,defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // Calcular PEG para cada banco e ordenar ``` ## Quando o PEG Funciona Melhor O PEG é mais útil em situações específicas: ### Bom para: 1. **Empresas de crescimento**: Tecnologia, varejo, saúde 2. **Comparação entre pares**: Mesmo setor, diferentes valuations 3. **Growth investing**: Identificar crescimento a preço justo 4. **Empresas mid-cap**: Fase de expansão ### Evitar usar quando: 1. **Empresas cíclicas**: Commodities, construção (lucros voláteis) 2. **Turnarounds**: Crescimento de base baixa distorce 3. **Empresas maduras**: Utilities, telecom (baixo crescimento) 4. **Lucros negativos**: PEG não funciona sem lucro ``` ┌─────────────────────────────────────────────────────────────┐ │ QUANDO USAR (OU NÃO) O PEG │ ├─────────────────────────────────────────────────────────────┤ │ │ │ ✅ USE O PEG ❌ EVITE O PEG │ │ ───────────── ────────────── │ │ • Empresas de crescimento • Empresas cíclicas │ │ • Tech, varejo, saúde • Commodities │ │ • Lucros consistentes • Turnarounds │ │ • Comparação setorial • Lucros negativos │ │ • Mid-caps em expansão • Utilities maduras │ │ │ │ O PEG complementa, não substitui, outras análises! │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ## PEG vs Outros Indicadores de Valuation Como o PEG se compara a outros múltiplos? | Indicador | Foco | Melhor Para | Limitação | | ------------- | -------------------- | ------------------- | -------------------- | | **P/L** | Lucro atual | Empresas maduras | Ignora crescimento | | **PEG** | Crescimento ajustado | Empresas crescendo | Depende de projeções | | **EV/EBITDA** | Valor da empresa | Comparação setorial | Ignora capex | | **P/VP** | Valor patrimonial | Bancos, seguros | Ignora intangíveis | | **PSR** | Receita | Empresas sem lucro | Ignora margens | ### Combinando Indicadores O PEG funciona melhor quando combinado com outros fatores: **Análise Completa de Valuation: WEGE3** | Indicador | Valor | Avaliação | | -------------- | ----- | -------------- | | P/L | 32,5x | Acima da média | | PEG | 1,14 | ✓ Bom | | P/VP | 8,45 | Acima de 3 | | EV/EBITDA | 22,8x | Acima de 10 | | ROE | 28,5% | ✓ Excelente | | Margem Líquida | 15,2% | ✓ Bom | **Pontuação: 3/5** - Avaliação **Neutra** O sistema de pontuação considera: * PEG \< 1,5 = +1 ponto * P/VP \< 3 = +1 ponto * EV/EBITDA \< 10 = +1 ponto * ROE > 15% = +1 ponto * Margem > 10% = +1 ponto ```typescript // Análise completa de valuation const response = await fetch( `https://brapi.dev/api/quote/WEGE3?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // Extrair P/L, P/VP, EV/EBITDA, ROE e margens para análise combinada ``` ## Armadilhas do PEG: Cuidados Importantes ### 1. Crescimento Insustentável Um PEG baixo baseado em crescimento extraordinário pode ser armadilha: **Análise de Sustentabilidade: TOTS3** | Ano | Crescimento do Lucro | | ---- | -------------------- | | 2023 | +18,5% | | 2024 | +22,3% | | 2025 | +19,8% | | Métrica | Valor | | -------------------- | -------- | | Média de Crescimento | 20,2% | | Desvio Padrão | 1,9% | | Consistência | **Alta** | Uma consistência **Alta** (desvio \< 15%) indica crescimento sustentável, tornando o PEG mais confiável. **Sinais de Alerta:** * Desvio padrão > 50% * Qualquer ano com queda > 20% * Crescimento muito acima da média histórica ```typescript // Verificar sustentabilidade do crescimento const response = await fetch( `https://brapi.dev/api/quote/TOTS3?modules=incomeStatementHistory,defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // Analisar variação do lucro ano a ano ``` ### 2. Base de Comparação Distorcida Cuidado com crescimento alto a partir de base baixa: ``` ┌─────────────────────────────────────────────────────────────┐ │ ARMADILHA: CRESCIMENTO DE BASE BAIXA │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Ano 1: Lucro R$ 10 milhões │ │ Ano 2: Lucro R$ 50 milhões (+400%!) │ │ Ano 3: Lucro R$ 60 milhões (+20%) │ │ │ │ Se usar Ano 1→2: Crescimento = 400%, PEG parece ótimo │ │ Se usar Ano 2→3: Crescimento = 20%, PEG mais realista │ │ │ │ SEMPRE use média de vários anos ou crescimento projetado │ │ de analistas, não apenas último período │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### 3. Qualidade do Crescimento Nem todo crescimento é igual: | Tipo de Crescimento | Qualidade | Impacto no PEG | | ------------------- | --------- | ----------------------- | | **Orgânico** | Alta | PEG confiável | | **Aquisições** | Média | Pode inflar crescimento | | **Não recorrente** | Baixa | Distorce PEG | | **Contábil** | Baixa | PEG não confiável | ## Screening de Ações com PEG Vamos criar um screener para encontrar ações com PEG atrativo: **Screener: Ações com PEG \< 1,5** | Ticker | Preço | P/L | Crescimento | PEG | ROE | | ------ | -------- | ----- | ----------- | ---- | ----- | | PRIO3 | R$ 42,50 | 8,2x | 15,8% | 0,52 | 32,5% | | EQTL3 | R$ 28,30 | 11,5x | 12,3% | 0,93 | 18,2% | | RAIL3 | R$ 22,80 | 15,2x | 14,5% | 1,05 | 15,8% | | WEGE3 | R$ 52,80 | 32,5x | 28,5% | 1,14 | 28,5% | | TOTS3 | R$ 31,20 | 28,5x | 24,8% | 1,15 | 22,3% | | RENT3 | R$ 38,90 | 18,8x | 13,2% | 1,42 | 16,5% | **Critérios do Screener:** 1. P/L positivo 2. Crescimento de lucros > 0% 3. PEG ≤ 1,5 4. Ordenado por PEG (menor = mais atrativo) ```typescript // Screener de ações com PEG atrativo const tickers = "WEGE3,TOTS3,RENT3,RADL3,HAPV3,RAIL3,EQTL3,PRIO3,FLRY3,ARZZ3"; const response = await fetch( `https://brapi.dev/api/quote/${tickers}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); // Calcular PEG e filtrar resultados < 1.5 ``` ## Case Study: Comparando WEG e TOTVS pelo PEG Vamos analisar duas das melhores empresas de crescimento da bolsa brasileira: **WEGE3 - WEG S.A.** | Métrica | Valor | | -------------- | --------------- | | Setor | Bens de Capital | | Preço | R$ 52,80 | | Market Cap | R$ 215,3 bi | | P/L | 32,5x | | Crescimento | 28,5% | | **PEG** | **1,14** | | ROE | 28,5% | | Margem Líquida | 15,2% | **TOTS3 - TOTVS S.A.** | Métrica | Valor | | -------------- | ---------- | | Setor | Tecnologia | | Preço | R$ 31,20 | | Market Cap | R$ 18,5 bi | | P/L | 28,5x | | Crescimento | 24,8% | | **PEG** | **1,15** | | ROE | 22,3% | | Margem Líquida | 12,8% | **Conclusão:** Pelo PEG, ambas as empresas estão praticamente empatadas (\~1,14-1,15), sugerindo preços justos para seus respectivos crescimentos. Mas lembre-se de considerar: * Qualidade do crescimento (WEG tem exposição internacional) * Consistência histórica (ambas excelentes) * Riscos específicos de cada empresa * Seu horizonte de investimento ```typescript // Comparar WEG e TOTVS const response = await fetch( `https://brapi.dev/api/quote/WEGE3,TOTS3?modules=incomeStatementHistory,defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); ``` ## Conclusão: Usando o PEG com Sabedoria O PEG Ratio é uma ferramenta poderosa para avaliar empresas de crescimento, mas deve ser usado com contexto: ### Checklist de Uso do PEG * [ ] **P/L positivo**: Empresa precisa ter lucro * [ ] **Crescimento positivo**: Senão o PEG não faz sentido * [ ] **Crescimento sustentável**: Verificar consistência histórica * [ ] **Comparar com setor**: Cada setor tem benchmark diferente * [ ] **Combinar com outros indicadores**: ROE, margens, endividamento * [ ] **Considerar riscos**: Crescimento alto = risco alto ### Quando Usar o PEG | Situação | Recomendação | | --------------------------------- | ----------------------------- | | Comparar empresas de crescimento | ✅ Use | | Avaliar se P/L alto é justificado | ✅ Use | | Screening inicial | ✅ Use | | Empresas cíclicas | ❌ Evite | | Turnarounds | ❌ Evite | | Decisão final de investimento | ⚠️ Combine com outros fatores | ### Próximos Passos Aprofunde seus conhecimentos em valuation: 1. **[P/L: Guia Completo](/blog/entendendo-indicador-preco-lucro-pl-analise-fundamentalista)** - Entenda a base do PEG 2. **[EV/EBITDA](/blog/indicador-ev-ebitda-como-analisar)** - Valuation de empresas 3. **[Value Investing](/blog/value-investing-como-encontrar-acoes-baratas)** - Encontre barganhas 4. **[Growth vs Value](/blog/acoes-growth-vs-value-brasil)** - Estilos de investimento ## Automatize Sua Análise com brapi.dev A API da brapi.dev fornece todos os dados necessários para calcular o PEG e outros indicadores de valuation: * P/L trailing e forward * Taxas de crescimento * Indicadores fundamentalistas * Histórico de resultados **Comece gratuitamente** em [brapi.dev](https://brapi.dev) e crie seus próprios screeners de ações baseados em PEG e outros múltiplos. # Indicadores Econômicos 2025: Como SELIC, IPCA e IGP-M Afetam Investimentos URL: /blog/indicadores-economicos-brasil-selic-ipca-igpm-impacto-investimentos.mdx Domine indicadores econômicos brasileiros! Como SELIC, IPCA, IGP-M e CDI impactam seus investimentos ✓ *** searchable: true title: 'Indicadores Econômicos 2025: Como SELIC, IPCA e IGP-M Afetam Investimentos' description: 'Domine indicadores econômicos brasileiros! Como SELIC, IPCA, IGP-M e CDI impactam seus investimentos ✓' date: '2025-08-22' keywords: 'indicadores econômicos brasil, SELIC, IPCA, IGP-M, CDI, impacto investimentos, cenário macroeconômico, política monetária, inflação, brapi' author: 'Equipe brapi.dev' category: 'Economia e Investimentos' subcategory: 'Análise Macroeconômica' readingTime: '19 min' tags: \['Indicadores Econômicos', 'SELIC', 'IPCA', 'Economia', 'Investimentos', 'Política Monetária', 'Inflação', 'Macroeconomia'] relatedPosts: \['como-construir-carteira-investimentos-diversificada-brapi', 'fundos-imobiliarios-fiis-guia-completo-iniciantes', 'analise-fundamentalista-acoes-indicadores-essenciais-investir-b3'] featured: true expertise: 'Análise macroeconômica com 8+ anos de experiência no mercado brasileiro' lastReviewed: 2026-01-03 howToSteps: * name: 'Entender a taxa SELIC' text: 'Compreenda que a SELIC é a taxa básica de juros definida pelo COPOM, que determina o retorno da renda fixa e influencia toda a economia.' * name: 'Monitorar inflação (IPCA e IGP-M)' text: 'Acompanhe IPCA (inflação oficial) e IGP-M (usado em contratos) via API brapi.dev para entender o poder de compra real dos investimentos.' * name: 'Obter dados via API brapi.dev' text: 'Use o endpoint composable /api/v2/macro?symbols=selic,ipca12m,igpm,cdi para todos os indicadores macro em uma única chamada.' * name: 'Analisar impacto na renda fixa' text: 'Entenda que SELIC alta favorece renda fixa (Tesouro Direto, CDBs) enquanto SELIC baixa torna ações mais atrativas.' * name: 'Avaliar impacto em ações' text: 'Analise como juros afetam diferentes setores: utilities se beneficiam de juros baixos, bancos de juros altos.' * name: 'Considerar impacto em FIIs' text: 'Entenda que FIIs competem com renda fixa por investidores de renda, sendo mais atrativos quando SELIC está baixa.' * name: 'Ajustar alocação conforme cenário' text: 'Use indicadores econômicos para rebalancear carteira entre renda fixa, variável e ativos reais conforme ciclo econômico.' howToTools: * 'API brapi.dev (/api/v2/macro)' * 'Calendário do COPOM' * 'Relatório Focus do Banco Central' * 'Planilha de alocação' howToSupplies: * 'Token de acesso brapi.dev' * 'Histórico de SELIC e inflação' * 'Projeções de mercado (Focus)' * 'Dados de rentabilidade dos ativos' *** import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > Os indicadores econômicos brasileiros são fundamentais para decisões de investimento inteligentes. Aprenda como SELIC, IPCA, IGP-M e outros afetam suas aplicações e como monitorá-los para maximizar retornos em 2025. *** ## Por Que Indicadores Econômicos São Cruciais para Investidores? **Os indicadores econômicos direcionam o comportamento dos mercados financeiros** e determinam a atratividade relativa entre diferentes classes de ativos. Entender sua dinâmica é essencial para timing e alocação de recursos. **Em termos práticos:** Quando a SELIC sobe, renda fixa fica mais atrativa que ações. Quando inflação acelera, ativos reais podem ser melhores que nominais. ### Impactos Diretos nos seus Investimentos: 1. **SELIC** determina retorno da renda fixa 2. **Inflação** afeta poder de compra real 3. **PIB** influencia crescimento das empresas 4. **Câmbio** impacta exportadoras e importadoras 5. **Desemprego** afeta consumo e varejo ### 3. **Gestão de Riscos** * Proteção contra inflação * Alocação entre ativos * Timing de investimentos ## Principais Indicadores Econômicos ### 1. Taxa SELIC A **SELIC (Sistema Especial de Liquidação e Custódia)** é a taxa básica de juros da economia brasileira, definida pelo COPOM (Comitê de Política Monetária). #### Como Funciona a SELIC ```typescript // Obter taxa SELIC atual via brapi.dev (/api/v2/macro) const response = await fetch( "https://brapi.dev/api/v2/macro/latest?symbols=selic", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); const selicAtual = results[0].latest; // { date: "2026-04-30", value: 14.5 } ``` **Exemplo de Resposta:** | Métrica | Valor | | ------------------ | ----------- | | Taxa Atual | 11,75% a.a. | | Última Atualização | 2024-12-11 | | Tendência | Estável | **Histórico 6 meses:** | Período | Taxa SELIC | | ------- | ---------- | | 2024-12 | 11,75% | | 2024-11 | 11,75% | | 2024-10 | 11,25% | | 2024-09 | 10,75% | | 2024-08 | 10,50% | | 2024-07 | 10,50% | **Tendência:** Compare o valor atual com o anterior. Variação maior que 0,25 p.p. indica movimento de alta ou baixa; menor que isso é considerado estável. #### Impactos da SELIC nos Investimentos **SELIC Alta (acima de 10%):** * ✅ **Renda Fixa**: CDB, LCI/LCA, Tesouro mais atrativo * ❌ **Ações**: Competição por capital, menor apetite risco * ❌ **FIIs**: Yields perdem atratividade relativa * ✅ **Dólar**: Real pode se fortalecer **SELIC Baixa (abaixo de 6%):** * ❌ **Renda Fixa**: Rentabilidade reduzida * ✅ **Ações**: Maior busca por rentabilidade * ✅ **FIIs**: Yields mais atrativos vs. renda fixa * ❌ **Dólar**: Real pode se enfraquecer ### 2. IPCA (Inflação) O **IPCA (Índice Nacional de Preços ao Consumidor Amplo)** é o indicador oficial de inflação do Brasil, usado para metas do governo. ```typescript // Obter série histórica do IPCA mensal via brapi.dev (/api/v2/macro) const response = await fetch( "https://brapi.dev/api/v2/macro?symbols=ipca&limit=12", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); const ultimos12m = results[0].observations; // [{ date, value }, ...] ``` **Exemplo de Análise IPCA:** | Métrica | Valor | | --------------- | ----- | | IPCA Mensal | 0,42% | | IPCA 12 meses | 4,62% | | Meta do Governo | 3,25% | | Banda Superior | 4,75% | | Banda Inferior | 1,75% | **Como calcular inflação acumulada (12 meses):** ``` Acumulado = [(1 + m1) × (1 + m2) × ... × (1 + m12)] - 1 ``` **Cenários de Análise:** | Status | IPCA 12m | Descrição | Impacto nos Investimentos | | ----------------- | ------------- | -------------------------- | -------------------------- | | ⬆️ ACIMA DA META | > 4,75% | Pressão para alta da SELIC | Favor renda fixa | | ✅ DENTRO DA META | 1,75% - 4,75% | SELIC estável | Diversificação equilibrada | | ⬇️ ABAIXO DA META | \< 1,75% | Espaço para corte de juros | Favor ações e risco | **Dica:** O IPCA acumulado em 12 meses é o principal indicador observado pelo COPOM para decisões de política monetária. ### 3. IGP-M (Índice Geral de Preços) O **IGP-M** é usado principalmente em contratos de aluguel e alguns investimentos. Tende a ser mais volátil que o IPCA. **Comparação IPCA vs IGP-M:** | Característica | IPCA | IGP-M | | ------------------ | ------------------------------------ | ---------------------------- | | **Foco** | Famílias 1-40 salários mínimos | Atacado + construção civil | | **Peso principal** | Alimentação (23%) e Transporte (19%) | Atacado (60%) + Varejo (30%) | | **Uso principal** | Meta de inflação do governo | Contratos de aluguel | | **Volatilidade** | Mais estável | Mais volátil | **Impacto da Inflação por Tipo de Ativo:** | Tipo de Ativo | Inflação Alta | Proteção | | ------------------ | -------------------------- | ----------------------- | | **CDB Pré-fixado** | Rentabilidade real cai | Trocar por pós-fixado | | **Tesouro IPCA+** | Protegido | Excelente hedge | | **Ações** | Depende do setor | Focar pricing power | | **FIIs** | Aluguéis indexados (IGP-M) | Bom hedge inflacionário | **Dica para FIIs:** Contratos de aluguel comerciais geralmente são corrigidos pelo IGP-M, o que oferece proteção natural contra inflação para investidores de fundos imobiliários. ### 4. CDI (Certificado de Depósito Interbancário) O **CDI** é referência para investimentos de renda fixa privada, acompanhando de perto a SELIC. **Relação CDI vs SELIC:** | Métrica | Valor | | ----------- | ------ | | SELIC Atual | 11,75% | | CDI Atual | 11,65% | | Spread | 0,10% | **Regra prática:** O CDI é tradicionalmente 0,1-0,2% abaixo da SELIC. **Cálculo de Rentabilidade CDI:** Fórmula de juros compostos: ``` Valor Final = Valor Inicial × (1 + CDI aplicado)^(dias/365) ``` **Exemplo: R$ 100.000 a 100% do CDI por 1 ano** | Parâmetro | Valor | | ------------------- | ------------- | | Investimento | R$ 100.000,00 | | CDI aplicado | 11,65% a.a. | | Período | 365 dias | | Valor final (bruto) | R$ 111.650,00 | | Rendimento bruto | R$ 11.650,00 | **Comparativo de % do CDI:** | Investimento | % CDI | Rentabilidade Anual | | ---------------- | --------------- | ------------------------- | | Poupança | \~70% | 8,16% | | CDB Banco Grande | 100% | 11,65% | | CDB Banco Médio | 110% | 12,82% | | LCI/LCA | 90% (isento IR) | 10,49% (líquido \~11,65%) | ## Monitoramento Integrado de Indicadores ### Dashboard Macroeconômico ```typescript // Dashboard: SELIC + IPCA12m + CDI em uma única requisição const response = await fetch( "https://brapi.dev/api/v2/macro/latest?symbols=selic,ipca12m,cdi", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); const selic = results.find((r) => r.series.slug === "selic")?.latest.value; const ipca12m = results.find((r) => r.series.slug === "ipca12m")?.latest.value; const cdi = results.find((r) => r.series.slug === "cdi")?.latest.value; // Juro real = ((1 + selic/100) / (1 + ipca12m/100) - 1) * 100 const taxaReal = ((1 + selic / 100) / (1 + ipca12m / 100) - 1) * 100; ``` **Exemplo de Dashboard Consolidado:** | Indicador | Valor | Última Atualização | | ------------- | --------- | ------------------ | | SELIC | 11,75% | 2024-12-11 | | IPCA (12m) | 4,62% | 2024-11 | | CDI | 11,65% | 2024-12-11 | | **Taxa Real** | **7,13%** | - | **Análise de Cenário por Taxa Real:** | Taxa Real | Status | Descrição | Recomendação | | --------- | ------------ | ------------------------ | --------------------- | | > 4% | JUROS ALTOS | Favorável à renda fixa | Aumentar RF | | 2% - 4% | MODERADO | Cenário equilibrado | Manter diversificação | | \< 2% | JUROS BAIXOS | Busca por renda variável | Aumentar ações e FIIs | **Taxa Real = SELIC - IPCA.** É o principal indicador para decidir entre renda fixa e variável. **Sistema de Alertas:** | Alerta | Condição | Severidade | Ação Sugerida | | ----------------- | -------------------- | ---------- | --------------------- | | Inflação Alta | IPCA > 4,75% (teto) | ALTA | Aumentar proteção | | Inflação Baixa | IPCA \< 1,75% (piso) | MÉDIA | Reduzir proteção | | SELIC Muito Alta | > 13% | ALTA | Maximizar renda fixa | | SELIC Muito Baixa | \< 3% | MÉDIA | Buscar renda variável | ## Estratégias por Cenário Macroeconômico ### Alocação Tática de Ativos **Estratégias Recomendadas por Cenário:** #### 1. Juros Altos + Inflação Controlada (Defensiva) | Classe | Alocação | Justificativa | | ---------------- | ---------- | ------------------------ | | Tesouro SELIC | 30% | Liquidez + rentabilidade | | CDB DI | 25% | 100%+ CDI | | Tesouro IPCA+ | 15% | Proteção inflação | | Ações defensivas | 20% | Utilities, bancos | | FIIs | 10% | Diversificação | | **Expectativa** | SELIC - 1% | \~10-11% a.a. | #### 2. Juros Baixos + Inflação Controlada (Agressiva) | Classe | Alocação | Justificativa | | ----------------- | ----------- | -------------------- | | Ações crescimento | 35% | Busca por retorno | | Ações value | 25% | Dividendos | | FIIs | 20% | Yields atrativos | | Tesouro IPCA+ | 10% | Proteção longo prazo | | Reserva liquidez | 10% | Emergência | | **Expectativa** | IPCA + 6-8% | \~10-12% a.a. | #### 3. Juros Altos + Inflação Alta (Proteção) | Classe | Alocação | Justificativa | | ----------------- | ----------- | ------------------ | | Tesouro IPCA+ | 40% | Proteção máxima | | Ações commodities | 25% | Hedge inflação | | FIIs | 15% | Aluguéis indexados | | Tesouro SELIC | 15% | Liquidez | | Ouro/Dólar | 5% | Proteção externa | | **Expectativa** | IPCA + 3-5% | \~8-10% a.a. | #### 4. Cenário Incerto (Balanceada) | Classe | Alocação | Justificativa | | -------------------- | ---------- | ----------------- | | Tesouro IPCA+ | 25% | Proteção inflação | | Ações diversificadas | 30% | Setores variados | | FIIs | 20% | Renda recorrente | | CDB DI | 15% | Liquidez | | Reserva | 10% | Oportunidades | | **Expectativa** | CDI + 2-4% | \~13-15% a.a. | **Importante:** Estas são sugestões educacionais. Consulte um assessor de investimentos antes de tomar decisões e considere seu perfil de risco e objetivos pessoais. **Simulação: R$ 100.000 em Cenário de Juros Altos (12 meses)** | Ativo | Alocação | Valor | Retorno Esperado | Ganho | | ---------------- | -------- | ---------- | ---------------- | ------------- | | Tesouro SELIC | 30% | R$ 30.000 | 11,75% | R$ 3.525 | | CDB DI | 25% | R$ 25.000 | 11,65% | R$ 2.913 | | Tesouro IPCA+ | 15% | R$ 15.000 | 15,50% | R$ 2.325 | | Ações defensivas | 20% | R$ 20.000 | 12,00% | R$ 2.400 | | FIIs | 10% | R$ 10.000 | 11,00% | R$ 1.100 | | **TOTAL** | 100% | R$ 100.000 | **12,26%** | **R$ 12.263** | ## Alertas e Automação ### Sistema de Monitoramento Automático Configure alertas para indicadores macroeconômicos: **Parâmetros de Alerta Recomendados:** | Indicador | Limite Superior | Limite Inferior | Variação Máxima | | ---------- | --------------- | --------------- | --------------- | | SELIC | 15% | 2% | 0,75 p.p. | | IPCA (12m) | 4,75% (teto) | 1,75% (piso) | 1,0 p.p. | | Taxa Real | 6% | 2% | - | **Tipos de Alerta:** | Tipo | Condição | Ação Sugerida | | --------------- | -------- | ------------------------------- | | SELIC\_ALTA | > 15% | Aumentar renda fixa | | SELIC\_BAIXA | \< 2% | Aumentar renda variável | | INFLACAO\_ALTA | > 4,75% | Aumentar proteção inflacionária | | INFLACAO\_BAIXA | \< 1,75% | Reduzir proteção inflacionária | **Automatize:** Use a API da brapi.dev com um scheduler (cron job) para verificar indicadores diariamente e enviar alertas via Telegram, email ou webhook quando condições forem atingidas. **Exemplo de verificação simples:** ```typescript // Verificar se IPCA está acima do teto da meta const ipca12m = 4.62; const tetoMeta = 4.75; if (ipca12m > tetoMeta) { console.log(`Alerta: IPCA ${ipca12m}% acima do teto ${tetoMeta}%`); // Enviar notificação } ``` ## Conclusão O acompanhamento de indicadores econômicos é fundamental para tomar decisões de investimento bem informadas. A brapi.dev facilita esse monitoramento ao disponibilizar dados atualizados de SELIC, IPCA e outros indicadores essenciais. ### Pontos-Chave: 1. **SELIC** direciona a atratividade entre renda fixa e variável 2. **IPCA** impacta a rentabilidade real dos investimentos 3. **Taxa real** (SELIC - IPCA) é crucial para alocação 4. **Monitoramento contínuo** permite ajustes táticos 5. **Automação de alertas** ajuda na gestão ativa ### Estratégias por Cenário: * **Juros Altos**: Favor renda fixa e Tesouro SELIC * **Juros Baixos**: Favor ações e FIIs com bons yields * **Inflação Alta**: Tesouro IPCA+ e ativos reais * **Incerteza**: Diversificação balanceada ### Próximos Passos: * **[Explore nossa API](/docs)** para dados macroeconômicos atualizados * **[Use nossa plataforma](/quotes)** para análises integradas * **Implemente dashboards** de monitoramento automático * **Configure alertas** para mudanças importantes ### Recursos Adicionais: * **[Análise de FIIs](/blog/fundos-imobiliarios-fiis-guia-completo-iniciantes)** em diferentes cenários * **[Construção de carteiras](/blog/como-construir-carteira-investimentos-diversificada-brapi)** adaptativas * **[Indicadores fundamentalistas](/blog/analise-fundamentalista-acoes-indicadores-essenciais-investir-b3)** complementares **Lembre-se**: O cenário macroeconômico muda constantemente. Mantenha-se atualizado e ajuste sua estratégia conforme necessário, sempre respeitando seu perfil de risco e objetivos de longo prazo! # Inflação e Investimentos em 2026: Como Proteger Seu Patrimônio da Desvalorização URL: /blog/inflacao-investimentos-como-proteger-patrimonio-2026.mdx Entenda como a inflação afeta seus investimentos e aprenda estratégias para proteger seu patrimônio. Guia completo com ativos que vencem a inflação. *** searchable: true title: 'Inflação e Investimentos em 2026: Como Proteger Seu Patrimônio da Desvalorização' description: 'Entenda como a inflação afeta seus investimentos e aprenda estratégias para proteger seu patrimônio. Guia completo com ativos que vencem a inflação.' date: '2026-01-01' keywords: 'inflação e investimentos, como proteger da inflação, investimentos que vencem inflação, ipca investimentos, tesouro ipca, proteger patrimonio inflação, rentabilidade real, inflação brasil 2026' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Proteção Patrimonial' readingTime: '18 min' tags: \['Inflação', 'IPCA', 'Proteção', 'Renda Fixa', 'Investimentos', 'Patrimônio'] relatedPosts: \['como-calcular-rendimento-investimentos-guia-completo-2026', 'tesouro-direto-guia-completo-2026-como-investir', 'renda-fixa-vs-renda-variavel-2026', 'juros-compostos-o-que-sao-como-calcular-simulador-2026'] featured: true expertise: 'Proteção patrimonial contra inflação' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > A inflação é o inimigo silencioso do seu dinheiro. Aprenda como ela funciona e quais investimentos realmente protegem seu poder de compra. *** ## Resumo: Investimentos vs Inflação | Investimento | Proteção contra Inflação | Rentabilidade Real Esperada | | -------------------------------- | ---------------------------- | --------------------------- | | **Poupança** | ❌ Fraca | 0% a 2% | | **CDB 100% CDI** | ⚠️ Parcial | 2% a 4% | | **Tesouro IPCA+** | ✅ Total | Taxa contratada (ex: 6%) | | **LCI/LCA IPCA+** | ✅ Total + isento IR | Taxa contratada | | **FIIs** | ✅ Boa (aluguéis reajustados) | 4% a 8% | | **Ações de setores resilientes** | ✅ Boa | Variável | | **Commodities** | ✅ Excelente | Variável | | **Dólar/Ouro** | ✅ Hedge | Variável | *** ## O Que é Inflação? **Inflação** é o aumento generalizado e contínuo dos preços, que causa a perda do poder de compra do dinheiro. ``` Exemplo prático: Em 2020: R$ 100 compravam 20kg de arroz Em 2026: R$ 100 compram 12kg de arroz Seu dinheiro vale menos! ``` ### Como a Inflação é Medida no Brasil | Índice | O que mede | Quem calcula | | ------------ | --------------------------------------------- | ------------ | | **IPCA** | Preços ao consumidor (oficial) | IBGE | | **IGP-M** | Preços gerais (atacado + varejo + construção) | FGV | | **INPC** | Preços para famílias até 5 SM | IBGE | | **IPC-Fipe** | Preços em São Paulo | FIPE | O **IPCA** é o índice oficial usado pelo Banco Central para a meta de inflação. *** ## Como a Inflação Destrói Seu Dinheiro ### O Poder Destrutivo no Longo Prazo Veja o que acontece com R$ 100.000 parados (sem investir) com diferentes taxas de inflação: | Anos | Inflação 3% | Inflação 5% | Inflação 8% | Inflação 10% | | ---- | ----------- | ----------- | ----------- | ------------ | | 1 | R$ 97.087 | R$ 95.238 | R$ 92.593 | R$ 90.909 | | 5 | R$ 86.261 | R$ 78.353 | R$ 68.058 | R$ 62.092 | | 10 | R$ 74.409 | R$ 61.391 | R$ 46.319 | R$ 38.554 | | 20 | R$ 55.368 | R$ 37.689 | R$ 21.455 | R$ 14.864 | | 30 | R$ 41.199 | R$ 23.138 | R$ 9.938 | R$ 5.731 | **Com inflação de 5% ao ano, em 30 anos você perde 77% do poder de compra!** ### Visualização ``` R$ 100.000 parados por 20 anos (inflação 5%): Valor nominal: R$ 100.000 (continua igual) Poder de compra: R$ 37.689 (perdeu 62%!) É como se você tivesse R$ 37.689 no bolso. ``` *** ## Acompanhando a Inflação em Tempo Real Use a brapi.dev para monitorar a inflação: ```typescript // IPCA acumulado em 12 meses pré-calculado pelo BCB (série ipca12m) const response = await fetch( "https://brapi.dev/api/v2/macro/latest?symbols=ipca12m", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); const ipca12m = results[0].latest.value; console.log(`IPCA acumulado 12 meses: ${ipca12m.toFixed(2)}%`); ``` **Exemplo de impacto da inflação:** | Patrimônio | IPCA 12 meses | Perda de Poder de Compra | | ---------- | ------------- | ------------------------ | | R$ 100.000 | 4,5% | R$ 4.500/ano | | R$ 100.000 | 5,5% | R$ 5.500/ano | | R$ 100.000 | 6,5% | R$ 6.500/ano | > Você precisa render MAIS que a inflação para não perder dinheiro! *** ## Investimentos que PERDEM para Inflação ### 1. Poupança A poupança rende 70% da Selic quando esta está abaixo de 8,5% ou 0,5% ao mês + TR quando acima. **Comparação Poupança vs Inflação:** | Cenário | Selic | Rend. Poupança | IPCA 12m | Rent. Real | | ----------- | ------ | -------------- | -------- | ---------- | | Selic alta | 13,75% | \~7,1% | 4,5% | +2,5% | | Selic média | 10,0% | \~7,0% | 5,0% | +1,9% | | Selic baixa | 6,0% | 4,2% | 4,0% | +0,2% | > **Alerta**: Em cenários de inflação alta, a poupança frequentemente PERDE para a inflação, resultando em rentabilidade real negativa. ### 2. Dinheiro Parado na Conta Rendimento: 0% Perda real: 100% da inflação ``` R$ 10.000 na conta corrente por 1 ano Inflação de 5% Perda de poder de compra: R$ 500 ``` ### 3. CDB que Paga Menos de 100% do CDI CDBs de bancos grandes costumam pagar 80-90% do CDI, o que pode não superar a inflação líquida de IR. *** ## Investimentos que VENCEM a Inflação ### 1. Tesouro IPCA+ (Melhor Opção de Renda Fixa) O Tesouro IPCA+ paga **IPCA + taxa fixa**, garantindo rentabilidade real. ``` Exemplo: Tesouro IPCA+ 2035 pagando IPCA + 6% Cenário 1: Inflação de 3% → Rentabilidade nominal: 9,18% (3% + 6% compostos) → Rentabilidade real: 6% Cenário 2: Inflação de 10% → Rentabilidade nominal: 16,6% (10% + 6% compostos) → Rentabilidade real: 6% Você sempre ganha 6% acima da inflação, não importa qual seja! ``` ### 2. LCI/LCA Atrelados ao IPCA Mesma lógica do Tesouro IPCA+, mas **isentos de IR** para pessoa física. | Investimento | Taxa | IR | Rentabilidade Líquida Real | | ---------------- | --------- | --- | -------------------------- | | Tesouro IPCA+ 6% | IPCA + 6% | 15% | \~5,1% | | LCI IPCA + 5% | IPCA + 5% | 0% | 5% | **A LCI pode ser melhor mesmo com taxa menor devido à isenção de IR!** ### 3. CRI e CRA (Crédito Imobiliário e do Agronegócio) Títulos de renda fixa isentos de IR, geralmente pagando IPCA + 6% a 8%. ⚠️ Não têm garantia do FGC - avalie o risco de crédito. ### 4. Fundos Imobiliários (FIIs) FIIs têm proteção natural contra inflação porque: * Aluguéis são reajustados por IPCA/IGP-M * Imóveis tendem a valorizar com inflação * Dividendos mensais isentos de IR **Como analisar se um FII vence a inflação:** | FII | Dividend Yield (12m) | IPCA (12m) | Rent. Real (só dividendos) | | ------ | -------------------- | ---------- | -------------------------- | | HGLG11 | 8,5% | 4,5% | +3,8% | | XPLG11 | 9,2% | 4,5% | +4,5% | | KNRI11 | 7,8% | 4,5% | +3,2% | > **Nota**: A rentabilidade real dos FIIs pode ser ainda maior considerando a valorização das cotas ao longo do tempo. ```typescript // Analisar FII vs inflação (IPCA acumulado 12m via /api/v2/macro) const auth = { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }; const [fiiRes, macroRes] = await Promise.all([ fetch( "https://brapi.dev/api/quote/HGLG11?modules=defaultKeyStatistics÷nds=true", auth ), fetch("https://brapi.dev/api/v2/macro/latest?symbols=ipca12m", auth), ]); const { results: quoteResults } = await fiiRes.json(); const { results: macroResults } = await macroRes.json(); const ipca12m = macroResults[0].latest.value; const dy = quoteResults[0].defaultKeyStatistics?.dividendYield * 100 || 0; ``` ### 5. Ações de Setores Resilientes Alguns setores conseguem repassar inflação para preços: | Setor | Empresas | Por que protege? | | -------------------- | -------------------- | ------------------------------ | | **Energia elétrica** | TAEE11, EGIE3, ELET6 | Contratos reajustados por IPCA | | **Saneamento** | SAPR11, SBSP3 | Tarifas reajustadas anualmente | | **Bancos** | ITUB4, BBDC4 | Spreads se ajustam | | **Telecomunicações** | VIVT3 | Contratos indexados | | **Shoppings** | MULT3 | Aluguéis reajustados | ### 6. Commodities e Ativos Reais * **Ouro**: Historicamente protege contra inflação alta * **Dólar**: Proteção contra inflação + desvalorização do Real * **Petróleo/Energia**: Preços sobem com inflação global *** ## Estratégias de Proteção por Perfil ### Conservador (Mínimo Risco) ``` Carteira Proteção Conservadora: ├── 40% Tesouro IPCA+ (curto prazo: 2029-2031) ├── 30% LCI/LCA IPCA+ ├── 20% CDB 120%+ CDI └── 10% Tesouro Selic (liquidez) Meta: Rentabilidade real de 3-5% a.a. ``` ### Moderado ``` Carteira Proteção Moderada: ├── 30% Tesouro IPCA+ (médio prazo: 2035-2040) ├── 20% LCI/LCA IPCA+ ├── 25% FIIs (HGLG11, XPLG11, KNRI11) ├── 15% Ações defensivas (TAEE11, EGIE3) └── 10% Reserva em Selic Meta: Rentabilidade real de 5-8% a.a. ``` ### Arrojado ``` Carteira Proteção Arrojada: ├── 20% Tesouro IPCA+ (longo prazo: 2045+) ├── 15% CRI/CRA IPCA+ ├── 30% FIIs diversificados ├── 25% Ações (energia, bancos, commodities) ├── 5% Dólar/Ouro └── 5% Reserva Meta: Rentabilidade real de 8-12% a.a. ``` *** ## Calculadora: Quanto Você Precisa Render **Rendimento necessário para diferentes metas de ganho real:** Considerando IPCA de 4,50% a.a.: | Meta Real | Rendimento Bruto (Isento IR) | Rendimento Bruto (Com IR 15%) | | ------------ | ---------------------------- | ----------------------------- | | 0% (empatar) | 4,50% | 5,29% | | 2% real | 6,59% | 7,75% | | 4% real | 8,68% | 10,21% | | 6% real | 10,77% | 12,67% | | 8% real | 12,86% | 15,13% | **Fórmula para calcular:** * Rendimento bruto necessário = (1 + meta\_real) × (1 + inflação) - 1 * Para investimentos com IR: Bruto = Líquido ÷ 0,85 > **Dica**: Para não perder dinheiro, você precisa render mais que a inflação. Para ganhar 4% real com investimentos tributados, precisa render mais de 10%! *** ## Simulador: Impacto da Inflação no Longo Prazo **Simulação: R$ 50.000 inicial + R$ 1.000/mês por 10 anos** Considerando Selic de 13,75% e IPCA de 4,5%: | Investimento | Final Nominal | Final Real\* | Rent. Real | Diferença vs Aportes | | -------------------- | ------------- | ------------ | ---------- | -------------------- | | Poupança | R$ 280.000 | R$ 182.000 | +19% | +R$ 25.000 | | CDB 100% CDI | R$ 340.000 | R$ 198.000 | +30% | +R$ 41.000 | | CDB 120% CDI | R$ 400.000 | R$ 228.000 | +49% | +R$ 71.000 | | LCI 90% CDI (isento) | R$ 310.000 | R$ 202.000 | +32% | +R$ 45.000 | | Tesouro IPCA+6% | R$ 380.000 | R$ 247.000 | +62% | +R$ 90.000 | | FIIs (DY 8%, isento) | R$ 295.000 | R$ 192.000 | +26% | +R$ 35.000 | \*Valor ajustado pela inflação do período **Análise:** * Total aportado em 10 anos: R$ 170.000 (R$ 50k inicial + R$ 120k em aportes) * Poder de compra se não investisse: R$ 157.000 (perda de R$ 13.000 para inflação) * Melhor opção: Tesouro IPCA+6% - Patrimônio real de R$ 247.000 * Pior opção: Poupança - Patrimônio real de R$ 182.000 * Diferença entre melhor e pior: **R$ 65.000** > A escolha do investimento certo pode significar dezenas de milhares de reais a mais no longo prazo! *** ## Erros Comuns na Proteção Contra Inflação ### ❌ Erro 1: Só Olhar Rendimento Nominal ``` "Meu CDB rendeu 12%!" Mas... - Inflação: 5% - IR: 1,8% (15% sobre 12%) - Rendimento líquido real: 4,96% Você ganhou menos da metade do que pensava! ``` ### ❌ Erro 2: Poupança como Proteção ``` Poupança em 2024: - Rendimento: ~7,1% - Inflação: 4,5% - Rendimento real: 2,5% Parece ok, mas... CDB 120% CDI rendeu ~5,5% real no mesmo período! ``` ### ❌ Erro 3: Ignorar Prazo do Tesouro IPCA+ ``` Tesouro IPCA+ 2045 comprado e vendido em 6 meses: - Pode ter PREJUÍZO se juros subirem - Marcação a mercado trabalha contra você Tesouro IPCA+ deve ser levado até o vencimento! ``` ### ❌ Erro 4: Só Investir em IPCA+ Diversificação ainda é importante: ``` Problema: 100% em Tesouro IPCA+ 2045 Cenário: Juros sobem de 6% para 8% - Título desvaloriza ~20% - Se precisar vender, tem prejuízo Solução: Distribuir entre vencimentos curtos, médios e longos ``` ### ❌ Erro 5: Esquecer da Liquidez ``` Todo patrimônio em LCI/LCA com carência de 2 anos Emergência acontece no mês 6 → Não consegue resgatar → Precisa tomar empréstimo caro ``` **Sempre tenha reserva de emergência em ativos com liquidez imediata!** *** ## Checklist: Proteção Contra Inflação ``` ✅ ANÁLISE INICIAL □ Sei qual é a inflação atual (IPCA 12m)? □ Calculei a rentabilidade REAL dos meus investimentos? □ Identifiquei investimentos que estão perdendo para inflação? ✅ ESTRUTURAÇÃO DA CARTEIRA □ Tenho reserva de emergência (Tesouro Selic)? □ Tenho investimentos atrelados ao IPCA? □ Diversifiquei entre diferentes tipos de proteção? □ Considerei FIIs e ações defensivas? ✅ MONITORAMENTO □ Acompanho a inflação mensalmente? □ Recalculo rentabilidade real periodicamente? □ Rebalanceio a carteira quando necessário? ✅ OTIMIZAÇÃO □ Priorizei investimentos isentos de IR quando possível? □ Considerei prazos para menor alíquota de IR? □ Diversifiquei vencimentos do Tesouro IPCA+? ``` *** ## Monitorando com brapi.dev ### Dashboard de Inflação Acompanhe inflação e taxas em tempo real: ```typescript // Dashboard: IPCA 12m + Selic em uma única chamada const response = await fetch( "https://brapi.dev/api/v2/macro/latest?symbols=ipca12m,selic", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); const ipca12m = results.find((r) => r.series.slug === "ipca12m")?.latest.value; const selicAtual = results.find((r) => r.series.slug === "selic")?.latest.value; const taxaReal = ((1 + selicAtual / 100) / (1 + ipca12m / 100) - 1) * 100; console.log(`IPCA 12 meses: ${ipca12m.toFixed(2)}%`); console.log(`Selic atual: ${selicAtual}%`); console.log(`Taxa real Selic: ${taxaReal.toFixed(2)}%`); ``` **Indicadores para monitorar:** | Indicador | Interpretação | | --------------- | ----------------------------------------------------- | | IPCA > 6% | Inflação ALTA - Priorize Tesouro IPCA+ e ativos reais | | IPCA 4-6% | Inflação MODERADA - Diversifique entre CDI e IPCA+ | | IPCA \< 4% | Inflação BAIXA - CDI pode ser suficiente | | Taxa real > 5% | Bom momento para renda fixa | | Taxa real 2-5% | Diversifique entre renda fixa e variável | | Taxa real \< 2% | Considere mais renda variável | *** ## Próximos Passos 1. **Calcule** a rentabilidade real atual dos seus investimentos 2. **Identifique** o que está perdendo para inflação 3. **Realoque** para ativos que protegem seu poder de compra 4. **Monitore** regularmente usando a brapi.dev ### Leitura Complementar * [Como Calcular Rendimento de Investimentos](/blog/como-calcular-rendimento-investimentos-guia-completo-2026) * [Tesouro Direto: Guia Completo](/blog/tesouro-direto-guia-completo-2026-como-investir) * [LCI e LCA: Guia Completo](/blog/lci-lca-guia-completo-investimentos-isentos-ir-2026) * [Renda Fixa vs Renda Variável](/blog/renda-fixa-vs-renda-variavel-2026) *** ## Conclusão A inflação é inevitável, mas perder dinheiro para ela não é. Os pontos-chave: 1. **Rentabilidade nominal ≠ rentabilidade real** - sempre desconte a inflação 2. **Poupança e CDBs fracos** não protegem seu patrimônio 3. **Tesouro IPCA+** é a proteção mais direta e segura 4. **FIIs e ações defensivas** oferecem proteção + potencial de valorização 5. **Diversifique** entre diferentes formas de proteção 6. **Monitore** a inflação e recalcule periodicamente Use a [API da brapi.dev](https://brapi.dev) para acompanhar inflação, Selic e seus investimentos em tempo real. Com os dados certos, você toma decisões melhores. **Não deixe a inflação corroer silenciosamente seu patrimônio. Aja agora!** *** *Última atualização: Janeiro de 2026* # Google Sheets com Cotações da Bolsa Brasileira: Tutorial Apps Script 2026 URL: /blog/integracao-google-sheets-cotacoes-b3-tutorial-completo.mdx Aprenda a puxar cotações da bolsa brasileira no Google Sheets com Apps Script e brapi.dev. Crie fórmulas para ações, FIIs, ETFs e BDRs sem depender do GOOGLEFINANCE. *** searchable: true title: 'Google Sheets com Cotações da Bolsa Brasileira: Tutorial Apps Script 2026' description: 'Aprenda a puxar cotações da bolsa brasileira no Google Sheets com Apps Script e brapi.dev. Crie fórmulas para ações, FIIs, ETFs e BDRs sem depender do GOOGLEFINANCE.' date: '2025-10-12' keywords: 'google sheets cotações da bolsa brasileira, Apps Script bolsa brasileira, brapi Google Sheets, cotação ações planilha, cotação FIIs Google Sheets, ETF Google Sheets, GOOGLEFINANCE bolsa brasileira' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Planilhas e Automação' readingTime: '10 min' tags: \['Google Sheets', 'Apps Script', 'ETFs', 'Automação', 'Tutorial', 'Planilhas', 'Investimentos'] relatedPosts: \['googlefinance-bvmf-nao-funciona-alternativa-brapi', 'b3-api-gratuita-como-usar-cotacoes', 'analise-fundamentalista-acoes-indicadores-essenciais-investir-b3'] featured: true expertise: 'Automação de planilhas financeiras com 6+ anos de experiência' lastReviewed: '2026-04-23' howToTools: \['Google Sheets', 'Apps Script', 'Conta brapi.dev'] howToSteps: * name: 'Obtenha seu token' text: 'Crie uma conta na brapi.dev e copie seu token no dashboard.' * name: 'Abra o Apps Script' text: 'No Google Sheets, acesse Extensões > Apps Script.' * name: 'Cole a função BRAPI\_PRICE' text: 'Adicione o código do tutorial e salve o projeto.' * name: 'Use a fórmula na planilha' text: 'Digite =BRAPI\_PRICE("PETR4"; $A$1) para consultar a cotação.' *** import { Author, Authors } from '~/components/Authors'; > O `GOOGLEFINANCE` nem sempre cobre ações, FIIs, ETFs e BDRs brasileiros como você precisa. Com Apps Script e brapi.dev, você cria uma fórmula própria para buscar cotações da bolsa brasileira direto no Google Sheets. ## Resumo Direto Depois de configurar o script, você usa: ```text =BRAPI_PRICE("PETR4"; $A$1) =BRAPI_PRICE("MXRF11"; $A$1) =BRAPI_PRICE("IVVB11"; $A$1) ``` A célula `$A$1` contém seu token da brapi.dev. Se preferir, você pode colocar o token em outra aba protegida e referenciar a célula. ## Por Que Usar uma API em Vez do GOOGLEFINANCE O `GOOGLEFINANCE` é útil para algumas cotações, mas pode falhar com ativos brasileiros, ETFs locais, FIIs e BDRs. Também há inconsistências de ticker, atraso, campos limitados e ausência de dados fundamentalistas. Se a fórmula retorna `#N/A`, consulte o diagnóstico de [GOOGLEFINANCE com BVMF e a alternativa pela brapi](/blog/googlefinance-bvmf-nao-funciona-alternativa-brapi). Com a brapi.dev, você consulta a API diretamente e controla quais campos aparecem na planilha: preço, variação, volume, nome, moeda, dividend yield e outros dados disponíveis. ## Passo 1: Obtenha o Token Crie uma conta em [brapi.dev](/dashboard), acesse o dashboard e copie seu token de API. Guarde esse token com cuidado. Ele funciona como uma senha para suas requisições. Na planilha, coloque o token em uma célula fixa, por exemplo `A1`. Se a planilha for compartilhada com outras pessoas, proteja a célula ou use uma aba separada com permissões restritas. ## Passo 2: Abra o Apps Script No Google Sheets, clique em **Extensões > Apps Script**. Apague o código inicial e cole a função abaixo. ```javascript /** * Retorna o preço atual de um ativo via brapi.dev. * * Uso: * =BRAPI_PRICE("PETR4"; $A$1) * * @param {string} ticker Código do ativo, como PETR4, VALE3, MXRF11 ou IVVB11. * @param {string} token Token da API brapi.dev. * @return {number|string} Preço atual ou mensagem de erro. * @customfunction */ function BRAPI_PRICE(ticker, token) { if (!ticker) return "Informe um ticker"; var apiToken = normalizeCellValue_(token); if (!apiToken) return "Token ausente"; var symbol = String(ticker).trim().toUpperCase(); var data = fetchBrapiQuote_(symbol, apiToken); var result = data && data.results && data.results[0]; if (!result) return "Sem dados"; return result.regularMarketPrice || result.lastPrice || result.close || "Preço não encontrado"; } function fetchBrapiQuote_(symbol, token) { var cache = CacheService.getScriptCache(); var cacheKey = "brapi:" + symbol; var cached = cache.get(cacheKey); if (cached) { return JSON.parse(cached); } var url = "https://brapi.dev/api/quote/" + encodeURIComponent(symbol); var response = UrlFetchApp.fetch(url, { muteHttpExceptions: true, headers: { Authorization: "Bearer " + token, "User-Agent": "GoogleSheets-brapi/1.0", }, }); var status = response.getResponseCode(); var body = response.getContentText(); if (status < 200 || status >= 300) { throw new Error("brapi HTTP " + status + ": " + body.slice(0, 160)); } cache.put(cacheKey, body, 300); return JSON.parse(body); } function normalizeCellValue_(value) { if (value && typeof value === "object" && value.length) { return value[0][0]; } return value ? String(value).trim() : ""; } ``` Salve o projeto e volte para a planilha. ## Passo 3: Use a Fórmula Na célula `A1`, cole seu token. Em outra célula, use: ```text =BRAPI_PRICE("PETR4"; $A$1) ``` Para montar uma carteira, coloque os tickers em uma coluna e use referência de célula: | A | B | | ------ | ------------------------ | | Token | `seu_token` | | PETR4 | `=BRAPI_PRICE(A2; $B$1)` | | VALE3 | `=BRAPI_PRICE(A3; $B$1)` | | MXRF11 | `=BRAPI_PRICE(A4; $B$1)` | ## Função Avançada: Buscar Qualquer Campo Se você quer nome, variação, volume ou moeda, use uma função genérica. ```javascript /** * Retorna um campo da resposta da brapi.dev. * * Uso: * =BRAPI_DATA("PETR4"; $A$1; "regularMarketChangePercent") * * @param {string} ticker Código do ativo. * @param {string} token Token da API. * @param {string} field Campo desejado. * @return {number|string} Valor do campo. * @customfunction */ function BRAPI_DATA(ticker, token, field) { if (!ticker) return "Informe um ticker"; if (!field) return "Informe um campo"; var apiToken = normalizeCellValue_(token); if (!apiToken) return "Token ausente"; var symbol = String(ticker).trim().toUpperCase(); var key = String(field).trim(); var data = fetchBrapiQuote_(symbol, apiToken); var result = data && data.results && data.results[0]; if (!result) return "Sem dados"; if (result[key] === undefined || result[key] === null) { return "Campo não encontrado"; } return result[key]; } ``` Exemplos: ```text =BRAPI_DATA("PETR4"; $A$1; "shortName") =BRAPI_DATA("PETR4"; $A$1; "regularMarketChangePercent") =BRAPI_DATA("PETR4"; $A$1; "regularMarketVolume") ``` ## Campos Úteis | Campo | O que retorna | | ---------------------------- | ----------------------------------- | | `regularMarketPrice` | Preço atual | | `regularMarketChangePercent` | Variação percentual | | `regularMarketVolume` | Volume | | `shortName` | Nome curto | | `currency` | Moeda | | `marketCap` | Valor de mercado, quando disponível | | `dividendYield` | Dividend yield, quando disponível | ## Exemplos de Ativos | Tipo | Fórmula | | ------ | ------------------------------ | | Ação | `=BRAPI_PRICE("PETR4"; $A$1)` | | FII | `=BRAPI_PRICE("MXRF11"; $A$1)` | | ETF | `=BRAPI_PRICE("BOVA11"; $A$1)` | | BDR | `=BRAPI_PRICE("AAPL34"; $A$1)` | | Índice | `=BRAPI_PRICE("^BVSP"; $A$1)` | ## Atualização e Cache O exemplo usa cache de 5 minutos (`300` segundos). Isso reduz chamadas repetidas quando várias células consultam o mesmo ticker. Para uma planilha de carteira, esse intervalo normalmente é suficiente. Se você precisa de atualização manual, altere qualquer célula usada como parâmetro ou recalcule a planilha. Evite dezenas de chamadas por segundo; planilhas têm limites próprios e APIs também. ## Erros Comuns | Erro | Causa provável | Como resolver | | ---------------------- | ------------------------------- | --------------------------------- | | `Token ausente` | Célula do token vazia | Confira a referência `$A$1` | | `Sem dados` | Ticker inválido ou indisponível | Teste o ticker na API | | `Campo não encontrado` | Nome do campo incorreto | Veja a resposta JSON no navegador | | `HTTP 401` | Token inválido | Gere ou copie o token novamente | | `HTTP 429` | Muitas requisições | Use cache e reduza chamadas | ## Segurança do Token Não publique sua planilha com o token visível. Se for compartilhar um template, deixe a célula do token vazia e explique onde o usuário deve inserir o próprio token. Para uso interno, você pode colocar o token em uma aba protegida. Para uso público, não use um token pessoal em planilhas acessíveis por terceiros. ## Alternativa: Importar JSON sem Apps Script O Google Sheets não possui uma função nativa robusta para importar JSON com cabeçalho de autenticação. Por isso Apps Script é a solução mais estável para APIs com token. ## Próximos Passos Depois de puxar preço, você pode calcular valor total da posição, variação diária, alocação percentual e rebalanceamento. Para dados mais completos, leia a [documentação da brapi.dev](/docs) e o guia [Como usar a API brapi para análise de ações](/blog/b3-api-gratuita-como-usar-cotacoes). *Este tutorial é técnico e educacional. Dados de mercado podem ter atraso, indisponibilidade ou limitações conforme plano e ativo.* # IPO: Como Investir em Ofertas Públicas 2026 - Guia Completo para Iniciantes URL: /blog/ipo-como-investir-ofertas-publicas-guia-completo.mdx Aprenda como investir em IPOs na bolsa brasileira. Guia completo sobre ofertas públicas iniciais: o que são, como participar, riscos, vantagens e estratégias para 2026. *** searchable: true title: 'IPO: Como Investir em Ofertas Públicas 2026 - Guia Completo para Iniciantes' description: 'Aprenda como investir em IPOs na bolsa brasileira. Guia completo sobre ofertas públicas iniciais: o que são, como participar, riscos, vantagens e estratégias para 2026.' date: '2025-12-28' keywords: 'ipo como investir, oferta publica inicial, ipo bolsa brasileira, como participar de ipo, ipo 2026, investir em ipo, reserva de acoes, bookbuilding, lockup ipo' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Ações e IPOs' readingTime: '15 min' tags: \['IPO', 'Ofertas Públicas', 'Bolsa Brasileira', 'Ações', 'Investimentos', 'Iniciantes', 'Reserva'] relatedPosts: \['valuation-dcf-multiplos-guia-completo-2026', 'onde-investir-2026-guia-completo-melhores-investimentos'] featured: true expertise: 'Equipe técnica especializada em mercado de capitais e análise de investimentos' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > Quer participar da abertura de capital de empresas na bolsa brasileira? Neste guia completo, você aprenderá o que são IPOs, como funcionam, como reservar ações e quais cuidados tomar antes de investir. *** ## O Que é um IPO? **IPO** (Initial Public Offering) ou **Oferta Pública Inicial** é o processo pelo qual uma empresa privada abre seu capital e passa a ter ações negociadas na bolsa de valores. ``` ┌─────────────────────────────────────────────────────────────┐ │ CICLO DO IPO │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Empresa Contratação Registro Período │ │ Privada → de Bancos → na CVM → de Reserva │ │ │ │ ↓ ↓ ↓ ↓ │ │ [Fechada] [Roadshow] [Prospecto] [Bookbuilding] │ │ │ │ ↓ │ │ ┌─────────────┐ │ │ │ DIA DO │ │ │ │ IPO │ │ │ │ (Estreia) │ │ │ └─────────────┘ │ │ ↓ │ │ Empresa com ações │ │ listadas na bolsa brasileira │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Por Que Empresas Fazem IPO? | Motivação | Descrição | | ------------------------ | --------------------------------------------------- | | **Captar recursos** | Dinheiro para expansão, aquisições ou investimentos | | **Liquidez para sócios** | Fundadores e investidores podem vender participação | | **Visibilidade** | Maior exposição de marca e credibilidade | | **Moeda de troca** | Ações podem ser usadas em M\&A e remuneração | | **Governança** | Obrigatoriedade de práticas mais transparentes | *** ## Tipos de Ofertas Públicas ### Oferta Primária vs Secundária | Tipo | Descrição | Para Onde Vai o Dinheiro | | -------------- | ----------------------------------- | ------------------------------- | | **Primária** | Empresa emite novas ações | Para a empresa (caixa) | | **Secundária** | Acionistas vendem suas ações | Para os acionistas vendedores | | **Mista** | Combinação de primária + secundária | Parte empresa, parte acionistas | **Exemplo prático:** * IPO de R$ 1 bilhão com 60% primária e 40% secundária * R$ 600 milhões vão para o caixa da empresa * R$ 400 milhões vão para os acionistas que venderam > **Dica:** Ofertas com maior percentual primário geralmente indicam que a empresa precisa de capital para crescer. Ofertas majoritariamente secundárias indicam que sócios querem realizar lucros. *** ## Como Funciona o Processo de IPO ### Etapa 1: Preparação (6-12 meses antes) A empresa precisa: 1. **Contratar coordenadores** (bancos de investimento) 2. **Auditar demonstrações financeiras** (últimos 3 anos) 3. **Estruturar governança corporativa** 4. **Escolher segmento de listagem** (Novo Mercado, Nível 2, etc.) 5. **Preparar prospecto** (documento com todas informações) ### Etapa 2: Registro na CVM A Comissão de Valores Mobiliários (CVM) analisa: * Documentação legal e contábil * Prospecto preliminar * Informações aos investidores * Fatores de risco Prazo típico: 30-60 dias para aprovação. ### Etapa 3: Roadshow Os executivos da empresa apresentam o negócio para: * Investidores institucionais (fundos, gestoras) * Analistas de mercado * Investidores estrangeiros qualificados Durante o roadshow, é definida a faixa indicativa de preço. ### Etapa 4: Período de Reserva (Bookbuilding) ``` ┌─────────────────────────────────────────────────────────────┐ │ PERÍODO DE RESERVA │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Faixa Indicativa: R$ 25,00 - R$ 32,00 │ │ │ │ Investidor pode: │ │ ├─ Reservar a preço fixo (ex: R$ 28,00) │ │ ├─ Reservar a mercado (aceita qualquer preço da faixa) │ │ └─ Reservar com limite máximo (ex: até R$ 30,00) │ │ │ │ Duração típica: 3-7 dias úteis │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Etapa 5: Precificação (Pricing) Com base na demanda: * Preço final é definido dentro da faixa * Se demanda alta → preço mais perto do teto * Se demanda baixa → preço mais perto do piso * Alocação das ações é determinada ### Etapa 6: Estreia na Bolsa Brasileira No dia do IPO: * Ações começam a ser negociadas * Primeiro preço pode ser diferente do IPO * Liquidação ocorre em D+2 *** ## Como Participar de um IPO ### Passo a Passo para Investidores Pessoa Física **1. Tenha conta em corretora** Você precisa de uma conta ativa em corretora habilitada para participar de IPOs. **2. Acesse a área de IPO/Ofertas Públicas** Cada corretora tem uma seção específica para ofertas em andamento. **3. Leia o Prospecto** Documento obrigatório com: * Descrição do negócio * Demonstrações financeiras * Fatores de risco * Destinação dos recursos * Informações sobre administradores **4. Faça sua Reserva** **Tipos de reserva disponíveis:** | Tipo de Reserva | Como Funciona | Risco | | ------------------ | ------------------------------------- | ------------------------------ | | **A mercado** | Aceita qualquer preço dentro da faixa | Pode pagar mais que esperado | | **Preço fixo** | Define um preço máximo específico | Reserva cancelada se IPO acima | | **Preço limitado** | Define teto máximo aceito | Equilíbrio entre as opções | **Exemplo:** Empresa EXEM3, reserva de 100 ações a mercado, valor estimado R$ 3.200 (baseado no teto da faixa). > **Importante:** Você precisa ter saldo disponível! A corretora pode exigir garantia/margem. **5. Aguarde a Alocação** * IPOs com alta demanda → rateio proporcional * Você pode receber menos do que pediu * Ou até não receber nada se demanda for muito alta **6. Verifique o Resultado** Após o pricing: * Confira quantas ações recebeu * Verifique o preço final * Prepare-se para a liquidação *** ## Segmentos de Listagem da Bolsa Brasileira ### Níveis de Governança Corporativa | Segmento | Tag Along | Conselho | Free Float | Demonstrações | | ---------------- | --------------- | ----------------------------------- | ------------ | ------------- | | **Novo Mercado** | 100% | Mínimo 5 membros, 20% independentes | 25% | IFRS | | **Nível 2** | 100% | Mínimo 5 membros, 20% independentes | 25% | IFRS | | **Nível 1** | 80% (ON) | Mínimo 3 membros | 25% | Facultativo | | **Básico** | Não obrigatório | Mínimo 3 membros | Não definido | Facultativo | > **Tag Along:** direito de vender ações pelo mesmo preço em caso de troca de controle. ### Tipos de Ações | Tipo | Código | Direito a Voto | Dividendos | | ---------------------- | ------ | ------------------- | ------------------- | | **Ordinárias (ON)** | XXXX3 | Sim | Iguais | | **Preferenciais (PN)** | XXXX4 | Limitado/Não | Prioritários | | **Units** | XXXX11 | Conforme composição | Conforme composição | **Novo Mercado:** somente ações ON (com direito a voto). *** ## Análise de IPOs: O Que Avaliar ### Checklist de Due Diligence #### 1. Modelo de Negócio * [ ] Entendo como a empresa ganha dinheiro? * [ ] O setor tem perspectivas de crescimento? * [ ] Quais são os diferenciais competitivos? * [ ] Há barreiras de entrada para concorrentes? #### 2. Números Financeiros ``` Métricas essenciais para analisar: ┌─────────────────────────────────────────────────────────────┐ │ RECEITA │ │ └─ Crescimento anual (CAGR 3-5 anos) │ │ └─ Concentração de clientes │ │ └─ Recorrência vs one-time │ │ │ │ LUCRATIVIDADE │ │ └─ Margem bruta (> 30% geralmente bom) │ │ └─ Margem EBITDA │ │ └─ Margem líquida (empresa já é lucrativa?) │ │ │ │ ENDIVIDAMENTO │ │ └─ Dívida Líquida/EBITDA (< 2x confortável) │ │ └─ Perfil de vencimentos │ │ └─ Custo da dívida │ │ │ │ GERAÇÃO DE CAIXA │ │ └─ FCO positivo e crescente │ │ └─ Capex de manutenção vs crescimento │ │ └─ Conversão de lucro em caixa │ └─────────────────────────────────────────────────────────────┘ ``` #### 3. Valuation (Precificação) Compare com empresas similares já listadas: | Múltiplo | Fórmula | Quando Usar | | -------------- | -------------------------- | ------------------------ | | **P/L** | Preço / Lucro por ação | Empresas lucrativas | | **EV/EBITDA** | Enterprise Value / EBITDA | Comparação entre setores | | **P/VPA** | Preço / Valor Patrimonial | Bancos, seguradoras | | **EV/Receita** | Enterprise Value / Receita | Empresas de crescimento | **Exemplo prático:** | Empresa | P/L | Observação | | ------------------------- | --------- | ---------------------------- | | **TechBrasil S.A. (IPO)** | 20x | Preço R$ 28,00 / LPA R$ 1,40 | | TOTVS | 25x | Peer listado | | Locaweb | 35x | Peer listado | | Positivo | 8x | Peer listado | | **Média dos peers** | **22,7x** | - | > **Análise:** IPO a 20x está abaixo da média dos peers (22,7x) → potencialmente atrativo. Mas: precisa analisar se o crescimento esperado justifica. #### 4. Destinação dos Recursos Verifique no prospecto para onde vai o dinheiro: | Destinação | Interpretação | | ------------------------ | -------------------------------- | | **Expansão orgânica** | Crescimento do negócio principal | | **Aquisições (M\&A)** | Consolidação do setor | | **Pagamento de dívidas** | Redução de alavancagem | | **Capital de giro** | Necessidade operacional | | **Reforço de caixa** | Pode indicar incerteza | #### 5. Lock-up e Estabilização **Lock-up:** período em que acionistas não podem vender. | Participante | Lock-up Típico | | ------------------------ | -------------- | | Fundadores/Controladores | 180-360 dias | | Administradores | 180 dias | | Investidores pré-IPO | 90-180 dias | > **Atenção:** após vencimento do lock-up, pode haver pressão vendedora. **Estabilização:** coordenadores podem comprar ações no mercado para estabilizar o preço nos primeiros dias. *** ## Vantagens e Desvantagens de Investir em IPOs ### Vantagens | Vantagem | Explicação | | ------------------------------------ | ------------------------------------- | | **Preço potencialmente atrativo** | Desconto para atrair investidores | | **Acesso a empresas em crescimento** | Negócios inovadores entrando na bolsa | | **Ganho no primeiro dia** | Possível valorização na estreia | | **Diversificação** | Novos setores e modelos de negócio | ### Desvantagens | Desvantagem | Explicação | | ---------------------------- | --------------------------------- | | **Histórico limitado** | Menos dados públicos para análise | | **Assimetria de informação** | Insiders sabem mais que você | | **Volatilidade inicial** | Preços podem oscilar muito | | **Risco de rateio** | Pode receber menos do que pediu | | **Lock-up overhang** | Pressão vendedora futura | *** ## Estatísticas Históricas de IPOs na Bolsa Brasileira ### Desempenho de IPOs Brasileiros ``` Performance média de IPOs na bolsa brasileira (dados históricos): ┌─────────────────────────────────────────────────────────────┐ │ RETORNO NO PRIMEIRO DIA │ │ └─ Média histórica: +3% a +5% │ │ └─ Variação: -20% a +50% │ │ │ │ RETORNO EM 6 MESES │ │ └─ ~50% superam o Ibovespa │ │ └─ ~50% ficam abaixo do Ibovespa │ │ │ │ RETORNO EM 1 ANO │ │ └─ Grande dispersão de resultados │ │ └─ Alguns multiplicam por 2-3x │ │ └─ Outros caem 50-80% │ │ │ │ TAXA DE SUCESSO (acima do CDI em 2 anos) │ │ └─ Aproximadamente 40-50% dos IPOs │ └─────────────────────────────────────────────────────────────┘ ``` ### Ondas de IPOs no Brasil | Período | Característica | Número de IPOs | | --------- | --------------------- | -------------- | | 2006-2007 | Boom pré-crise | \~100 | | 2010-2011 | Recuperação pós-crise | \~30 | | 2017-2019 | Retomada gradual | \~40 | | 2020-2021 | Boom de liquidez | \~70 | | 2022-2023 | Seca de IPOs | \~5 | | 2024-2026 | Recuperação gradual | Em andamento | *** ## Estratégias para Investir em IPOs ### 1. Estratégia do Flip Comprar no IPO e vender no primeiro dia. **Prós:** * Lucro rápido se houver alta inicial * Menor exposição ao risco **Contras:** * Custos de corretagem reduzem ganho * Pode perder valorização de longo prazo * Nem sempre há alta no primeiro dia ### 2. Estratégia de Longo Prazo Comprar no IPO e segurar por anos. **Prós:** * Captura crescimento da empresa * Menos impacto de volatilidade inicial * Dividendos ao longo do tempo **Contras:** * Capital travado * Risco de empresa não performar ### 3. Estratégia de Wait and See Esperar estabilização após IPO (30-90 dias). **Prós:** * Mais informações disponíveis * Preço pode ficar mais atrativo * Evita volatilidade inicial **Contras:** * Pode perder oportunidade se subir * Lock-up ainda pendente ### 4. Estratégia de Alocação Parcial Reservar menos do que gostaria. **Prós:** * Diversificação mesmo com rateio * Menor exposição por IPO * Permite participar de mais ofertas **Contras:** * Ganho limitado se der certo * Custos proporcionalmente maiores *** ## Acompanhando Ações Após o IPO ### Usando a brapi para Monitorar Após a estreia, você pode acompanhar a ação usando a API da brapi: ```typescript // Monitorar performance de ação pós-IPO const response = await fetch( 'https://brapi.dev/api/quote/EXEM3?range=3mo&interval=1d&modules=defaultKeyStatistics,financialData', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Retorna: preço atual, variação, setor, histórico de preços // Com historicalDataPrice você calcula o retorno desde a estreia ``` ### Comparando com Índices ```typescript // Comparar performance da ação com Ibovespa const response = await fetch( 'https://brapi.dev/api/quote/EXEM3,^BVSP?range=6mo&interval=1d', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Retorna dados de ambos os ativos // Com historicalDataPrice você calcula o alpha (retorno ação - retorno Ibov) ``` *** ## Erros Comuns ao Investir em IPOs ### 1. Investir Sem Ler o Prospecto O prospecto contém informações cruciais: * Fatores de risco detalhados * Conflitos de interesse * Contingências judiciais * Dependência de clientes/fornecedores ### 2. Seguir o Hype Não invista só porque: * "Todo mundo está comprando" * "É a próxima Magazine Luiza" * "Não pode dar errado" ### 3. Concentrar Demais Regra de ouro: **nunca coloque mais de 5% do portfólio em um único IPO.** ### 4. Ignorar o Lock-up Marque no calendário quando termina o lock-up. Pode haver forte pressão vendedora. ### 5. Não Ter Estratégia de Saída Defina antes: * Em quanto lucro você vende parte? * Em quanto prejuízo você encerra? * Qual o horizonte de investimento? *** ## Calendário de IPOs: Onde Acompanhar ### Fontes Oficiais | Fonte | Link | Informação | | -------------------- | ----------------------------------------------------------------------------- | ----------------------- | | **Bolsa Brasileira** | b3.com.br/pt\_br/produtos-e-servicos/solucoes-para-emissores/ofertas-publicas | Ofertas em andamento | | **CVM** | cvm.gov.br | Prospectos e documentos | | **Corretoras** | Apps das corretoras | Período de reserva | ### Acompanhando via API ```typescript // Listar empresas recentemente listadas na bolsa brasileira const response = await fetch( 'https://brapi.dev/api/quote/list?sortBy=market_cap_basic&sortOrder=desc&limit=100', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Retorna lista de ações ordenadas por market cap // Filtre pelo histórico disponível para identificar IPOs recentes ``` *** ## FAQ: Perguntas Frequentes sobre IPOs ### Quanto dinheiro preciso para participar de um IPO? Depende do IPO, mas geralmente: * **Mínimo:** 1 lote (geralmente 100 ações) * **Investimento típico:** R$ 1.000 a R$ 5.000 * Algumas ofertas têm mínimo de R$ 3.000 ou mais ### Posso cancelar minha reserva? Sim, durante o período de reserva. Após o fechamento, não é possível cancelar. ### O que acontece se eu reservar a preço fixo e o IPO for acima? Sua reserva é cancelada automaticamente. Você não participa da oferta. ### Preciso ter o dinheiro na conta no momento da reserva? Depende da corretora: * Algumas exigem saldo/margem * Outras verificam apenas na liquidação ### Quanto tempo demora para as ações aparecerem na carteira? * **Após o IPO:** liquidação em D+2 (dois dias úteis) * **Ações aparecem:** após liquidação financeira ### IPO pode ser cancelado? Sim, se: * Demanda insuficiente * Condições de mercado adversas * Problemas regulatórios * Preço não atinge mínimo esperado *** ## Conclusão Investir em IPOs pode ser uma estratégia interessante para acessar empresas em crescimento, mas exige **análise cuidadosa** e **gestão de risco**. **Resumo das melhores práticas:** 1. ✅ Leia sempre o prospecto completo 2. ✅ Compare valuation com peers listados 3. ✅ Limite exposição a 5% do portfólio por IPO 4. ✅ Tenha estratégia de entrada e saída definida 5. ✅ Monitore o vencimento do lock-up 6. ✅ Use ferramentas como a brapi para acompanhar após listagem **Lembre-se:** nem todo IPO é uma boa oportunidade. Muitas empresas que abrem capital têm desempenho inferior ao mercado. Faça sua análise! *** ## Próximos Passos 1. **[Cadastre-se na brapi](https://brapi.dev)** para acompanhar ações pós-IPO 2. **[Aprenda análise fundamentalista](/blog/analise-fundamentalista-acoes-b3-guia-completo-indicadores)** para avaliar empresas 3. **[Veja como usar a API](/blog/b3-api-gratuita-como-usar-cotacoes)** para automatizar seu acompanhamento 4. **[Monte um screener de ações](/blog/stock-screener-python-brapi-filtrar-acoes)** para encontrar oportunidades *** *Este artigo tem caráter educacional e não constitui recomendação de investimento. Sempre faça sua própria análise antes de investir.* # Juros Compostos: O Que São, Como Calcular e Simulador Completo 2026 URL: /blog/juros-compostos-o-que-sao-como-calcular-simulador-2026.mdx Entenda o poder dos juros compostos nos investimentos. Aprenda a fórmula, veja exemplos práticos e use nossa calculadora para simular seus aportes. *** searchable: true title: 'Juros Compostos: O Que São, Como Calcular e Simulador Completo 2026' description: 'Entenda o poder dos juros compostos nos investimentos. Aprenda a fórmula, veja exemplos práticos e use nossa calculadora para simular seus aportes.' date: '2026-01-01' keywords: 'juros compostos, calculadora juros compostos, como calcular juros compostos, simulador juros compostos, juros sobre juros, fórmula juros compostos, 2026' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Conceitos' readingTime: '16 min' tags: \['Juros Compostos', 'Educação Financeira', 'Calculadora', 'Investimentos'] relatedPosts: \['como-comecar-investir-do-zero-guia-iniciantes-2026', 'reserva-de-emergencia-guia-completo-2026', 'tesouro-direto-guia-completo-2026-como-investir', 'calculadoras-fire-independencia-financeira-brasil', 'inflacao-investimentos-como-proteger-patrimonio-2026'] featured: true expertise: 'Conteúdo desenvolvido com base em matemática financeira e análise de investimentos' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; Albert Einstein supostamente chamou os juros compostos de **"a força mais poderosa do universo"** e **"a oitava maravilha do mundo"**. Verdade ou lenda, uma coisa é certa: quem entende e usa os juros compostos a seu favor constrói patrimônio. Quem não entende, paga caro por isso. Neste guia completo, você vai aprender exatamente o que são juros compostos, como calculá-los, e ver na prática como transformar pequenos aportes em fortunas ao longo do tempo. *** ## O Que São Juros Compostos? Juros compostos são **juros que incidem sobre juros**. Diferente dos juros simples (que incidem apenas sobre o valor inicial), nos juros compostos o rendimento de cada período é incorporado ao capital, gerando rendimentos cada vez maiores. ### Analogia Simples: A Bola de Neve Imagine uma bola de neve descendo uma montanha: * **Juros simples**: A bola mantém o mesmo tamanho, apenas rola * **Juros compostos**: A bola acumula mais neve a cada volta, ficando exponencialmente maior Quanto mais tempo a bola rola (mais tempo você investe), maior ela fica. ### Exemplo Prático: R$ 10.000 a 10% ao ano | Ano | Juros Simples | Juros Compostos | Diferença | | --- | ------------- | --------------- | -------------- | | 0 | R$ 10.000 | R$ 10.000 | R$ 0 | | 1 | R$ 11.000 | R$ 11.000 | R$ 0 | | 5 | R$ 15.000 | R$ 16.105 | R$ 1.105 | | 10 | R$ 20.000 | R$ 25.937 | R$ 5.937 | | 20 | R$ 30.000 | R$ 67.275 | R$ 37.275 | | 30 | R$ 40.000 | R$ 174.494 | **R$ 134.494** | Em 30 anos, a diferença é de **mais de R$ 134.000**! *** ## A Fórmula dos Juros Compostos A fórmula matemática dos juros compostos é: ``` M = C × (1 + i)^t ``` Onde: * **M** = Montante final (quanto você terá) * **C** = Capital inicial (quanto você investiu) * **i** = Taxa de juros (em decimal, ex: 10% = 0,10) * **t** = Tempo (número de períodos) ### Exemplo de Cálculo Manual **Problema**: Investir R$ 5.000 a 12% ao ano por 5 anos. ``` M = 5.000 × (1 + 0,12)^5 M = 5.000 × (1,12)^5 M = 5.000 × 1,7623 M = R$ 8.811,71 ``` **Resultado**: Seu investimento inicial de R$ 5.000 se transformaria em R$ 8.811,71. *** ## Calculadora de Juros Compostos Use esta fórmula para simular qualquer cenário de investimento: ``` Montante = Capital × (1 + taxa)^tempo + Aportes × [(1 + taxa)^tempo - 1] / taxa ``` ### Exemplo 1: Investimento Único **Parâmetros:** R$ 10.000 inicial, 10% a.a., 20 anos | Ano | Investido | Montante | Juros Acumulados | | --- | --------- | --------- | ---------------- | | 1 | R$ 10.000 | R$ 11.000 | R$ 1.000 | | 5 | R$ 10.000 | R$ 16.105 | R$ 6.105 | | 10 | R$ 10.000 | R$ 25.937 | R$ 15.937 | | 15 | R$ 10.000 | R$ 41.772 | R$ 31.772 | | 20 | R$ 10.000 | R$ 67.275 | R$ 57.275 | **Multiplicador: 6,7x** o valor inicial! ### Exemplo 2: Com Aportes Mensais **Parâmetros:** R$ 1.000 inicial + R$ 500/mês, 10% a.a., 30 anos | Ano | Total Investido | Montante | Juros Acumulados | | --- | --------------- | ---------------- | ---------------- | | 5 | R$ 31.000 | R$ 41.578 | R$ 10.578 | | 10 | R$ 61.000 | R$ 105.373 | R$ 44.373 | | 20 | R$ 121.000 | R$ 385.682 | R$ 264.682 | | 30 | R$ 181.000 | **R$ 1.136.243** | **R$ 955.243** | **Resultado:** Investindo R$ 181.000 ao longo de 30 anos, você terá mais de R$ 1.1 milhão. Os juros compostos geraram R$ 955.243 (84% do patrimônio final)! *** ## Simulações Práticas: O Poder do Tempo ### Cenário 1: Começar Cedo vs. Começar Tarde Veja a diferença entre começar a investir aos 25 ou aos 35 anos: | Investidor | Idade Início | Aporte Mensal | Total Investido | Aos 65 anos (8% a.a.) | | ---------- | ------------ | ------------- | --------------- | --------------------- | | **Ana** | 25 anos | R$ 500 | R$ 240.000 | **R$ 1.397.414** | | **Bruno** | 35 anos | R$ 500 | R$ 180.000 | **R$ 589.020** | | **Carlos** | 35 anos | R$ 1.000 | R$ 360.000 | **R$ 1.178.040** | **Conclusão**: Ana investiu R$ 60.000 a MENOS que Carlos, mas terá R$ 219.374 a MAIS. O tempo fez o trabalho. ### Cenário 2: O Impacto da Taxa de Juros R$ 500/mês por 30 anos com diferentes taxas: | Taxa Anual | Tipo de Investimento | Montante Final | | ---------- | -------------------------------- | -------------- | | 6% | Poupança/Renda fixa conservadora | R$ 502.257 | | 8% | Renda fixa (Tesouro IPCA+) | R$ 745.179 | | 10% | Misto (renda fixa + ações) | R$ 1.130.243 | | 12% | Ações/FIIs (mais risco) | R$ 1.747.478 | **Diferença entre 6% e 12%**: R$ 1.245.221 (quase 3,5x mais!) ### Cenário 3: Aportes Pequenos Somam "Mas eu só consigo investir R$ 100 por mês..." | Aporte Mensal | 10 anos (10% a.a.) | 20 anos | 30 anos | | ------------- | ------------------ | ---------- | ------------ | | R$ 100 | R$ 20.484 | R$ 75.936 | R$ 226.048 | | R$ 200 | R$ 40.969 | R$ 151.873 | R$ 452.097 | | R$ 300 | R$ 61.453 | R$ 227.809 | R$ 678.146 | | R$ 500 | R$ 102.422 | R$ 379.682 | R$ 1.130.243 | **R$ 100/mês por 30 anos = R$ 226.048!** (você investiu apenas R$ 36.000) *** ## Os 3 Fatores dos Juros Compostos O resultado dos juros compostos depende de três fatores: ### 1. Tempo ⏰ O fator mais importante. Não existe substituto para o tempo. Começar 10 anos antes vale mais do que dobrar os aportes. **Regra prática**: O dinheiro dobra a cada \~7 anos com 10% de rendimento (Regra dos 72). ### 2. Taxa de Juros 📈 Quanto maior a taxa, mais rápido seu dinheiro cresce. Mas lembre-se: maiores taxas geralmente significam maiores riscos. **Regra dos 72**: Divida 72 pela taxa para saber em quantos anos o capital dobra. | Taxa | Cálculo | Anos para Dobrar | Tipo de Investimento | | ---- | ------- | ---------------- | -------------------- | | 6% | 72 ÷ 6 | 12 anos | Poupança | | 8% | 72 ÷ 8 | 9 anos | Tesouro IPCA+ | | 10% | 72 ÷ 10 | 7,2 anos | Carteira mista | | 12% | 72 ÷ 12 | 6 anos | Ações | ### 3. Aportes Regulares 💰 Aportar regularmente potencializa os juros compostos. Cada aporte começa a render juros sobre juros imediatamente. *** ## Juros Compostos nos Investimentos Brasileiros Veja como os juros compostos funcionam em diferentes investimentos (simulação com R$ 10.000 inicial + R$ 500/mês por 20 anos): | Investimento | Taxa Aproximada | Montante Final | | -------------------------- | --------------- | -------------- | | Poupança | 7,2% a.a. | R$ 298.547 | | Tesouro Selic | 10,5% a.a. | R$ 403.621 | | CDB 110% CDI | 11,5% a.a. | R$ 456.782 | | Tesouro IPCA+ 6% | 10,5% a.a. | R$ 403.621 | | Carteira Mista (60/40) | 11,0% a.a. | R$ 429.854 | | Ações (histórico Ibovespa) | 12,0% a.a. | R$ 485.234 | > **Nota**: Taxas aproximadas para fins ilustrativos. Consulte a [API da brapi.dev](https://brapi.dev) para dados atualizados da Selic e inflação. **Exemplo com TypeScript:** ```typescript const response = await fetch( "https://brapi.dev/api/v2/macro/latest?symbols=selic", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); console.log(`Selic atual: ${results[0].latest.value}%`); ``` *** ## Juros Compostos Trabalhando Contra Você Os juros compostos também funcionam nas **dívidas**, mas contra você: ### O Perigo do Cartão de Crédito Dívida de R$ 5.000 no rotativo do cartão (400% a.a.): | Mês | Dívida | | --- | --------- | | 0 | R$ 5.000 | | 3 | R$ 6.892 | | 6 | R$ 9.500 | | 12 | R$ 25.000 | Em 1 ano, a dívida **quintuplica**! ### Priorize Quitar Dívidas Caras Se você tem dívidas com juros altos E quer investir, faça as contas: * Investimento rende: \~10% ao ano * Cartão de crédito cobra: \~400% ao ano **Quitar a dívida é o melhor "investimento" que você pode fazer.** *** ## Estratégias para Maximizar os Juros Compostos ### 1. Comece Hoje, Não Amanhã Cada dia que você espera é um dia a menos de juros compostos. Mesmo R$ 50/mês é melhor que nada. ### 2. Automatize os Aportes Configure transferências automáticas no dia do pagamento. O que você não vê, não gasta. ### 3. Reinvista os Dividendos Se você investe em ações ou FIIs, reinvista os dividendos. Isso turbina os juros compostos. **Comparativo: Reinvestir vs Sacar Dividendos** Capital inicial de R$ 100.000, prazo de 20 anos, valorização 8% a.a., dividend yield 5%: | Estratégia | Valor Final | Dividendos Sacados | Total | | ---------------------- | ------------ | ------------------ | ---------------- | | **SEM reinvestimento** | R$ 466.096 | R$ 149.802 | R$ 615.898 | | **COM reinvestimento** | R$ 1.386.968 | R$ 0 | **R$ 1.386.968** | **Diferença**: R$ 771.070 a mais reinvestindo os dividendos! ### 4. Aumente os Aportes Gradualmente A cada aumento de salário, aumente também o aporte. Se você ganha 10% de aumento, destine pelo menos metade disso para investimentos. ### 5. Evite Resgatar Cada vez que você resgata, você interrompe o efeito bola de neve. Tenha uma reserva de emergência separada para evitar mexer nos investimentos de longo prazo. *** ## Calculadora Avançada: Quanto Preciso para Aposentar? **Exemplo**: Renda mensal desejada de R$ 10.000 na aposentadoria **Parâmetros:** * Taxa de retirada segura: 4% a.a. (regra dos 4%) * Taxa de rendimento durante acumulação: 10% a.a. * Prazo até aposentadoria: 25 anos **Cálculo:** | Etapa | Valor | | ---------------------------------- | ---------------- | | Renda anual desejada | R$ 120.000 | | Patrimônio necessário (renda ÷ 4%) | **R$ 3.000.000** | | Aporte mensal necessário | **R$ 2.264** | | Total que você aportará | R$ 679.200 | | Juros compostos gerarão | R$ 2.320.800 | > Os juros compostos representam **77% do patrimônio final**! Você aporta menos de 1/4 do valor total. **Fórmula da taxa de retirada segura (Regra dos 4%):** ``` Patrimônio necessário = Renda anual desejada ÷ 0,04 ``` *** ## Mitos Sobre Juros Compostos ### Mito 1: "Preciso de muito dinheiro para começar" **Realidade**: Você pode começar com R$ 1 em alguns CDBs ou R$ 30 no Tesouro Direto. O importante é começar. ### Mito 2: "Os juros compostos fazem milagre rápido" **Realidade**: O poder dos juros compostos aparece no longo prazo (10+ anos). Nos primeiros anos, o crescimento parece lento. ### Mito 3: "Só funciona com altas taxas de juros" **Realidade**: Funciona com qualquer taxa, o tempo é mais importante. 8% por 30 anos supera 15% por 10 anos. ### Mito 4: "Depois que começar, é só esperar" **Realidade**: Aportes regulares potencializam muito o resultado. Investir uma vez e esperar é menos eficiente que aportar mensalmente. *** ## Acompanhe Seus Investimentos Use a [API da brapi.dev](https://brapi.dev) para acompanhar o crescimento da sua carteira: ```typescript const tickers = ["ITUB4", "VALE3", "WEGE3"]; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(",")}?modules=defaultKeyStatistics÷nds=true`, { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); for (const stock of results) { console.log(`${stock.symbol}: R$ ${stock.regularMarketPrice}`); console.log(`Dividend Yield: ${(stock.defaultKeyStatistics?.dividendYield ?? 0) * 100}%`); } ``` *** ## Conclusão: O Tempo É Seu Maior Aliado Os juros compostos são o segredo de quem constrói patrimônio. Não é sobre ganhar na loteria ou fazer day trade - é sobre consistência e paciência. **Resumo dos principais aprendizados:** 1. **Tempo > Valor**: Começar cedo com pouco supera começar tarde com muito 2. **Consistência é chave**: Aportes regulares potencializam os resultados 3. **Reinvista os rendimentos**: Deixe os juros trabalharem por você 4. **Evite dívidas caras**: Os juros compostos também funcionam contra você 5. **Paciência**: Os resultados mais impressionantes aparecem após 15-20 anos A fórmula é simples: ``` Tempo + Consistência + Paciência = Patrimônio ``` O melhor dia para começar a investir foi há 20 anos. O segundo melhor dia é **hoje**. *** ## Perguntas Frequentes ### Os juros compostos funcionam igual para todos os investimentos? Sim, o conceito matemático é o mesmo. A diferença está na taxa de rendimento de cada investimento e se os rendimentos são automaticamente reinvestidos ou distribuídos. ### Quanto tempo leva para ver os resultados? Os primeiros anos parecem lentos. O efeito "bola de neve" fica realmente visível após 10 anos, e impressionante após 20 anos. ### Vale a pena investir R$ 50 por mês? Sim! R$ 50/mês por 30 anos a 10% a.a. = R$ 113.024. Você terá investido apenas R$ 18.000. Os juros compostos fizeram os outros R$ 95.000. ### Como os juros compostos funcionam em FIIs? Em FIIs, você recebe dividendos mensais. Para aproveitar os juros compostos, você precisa reinvestir esses dividendos comprando mais cotas. ### Qual a melhor taxa para simular investimentos? Para projeções conservadoras, use 6-8%. Para projeções moderadas, 8-10%. Para projeções otimistas (com mais risco), 10-12%. *** ## Próximos Passos Continue sua jornada de educação financeira: * [Como Começar a Investir do Zero](/blog/como-comecar-investir-do-zero-guia-iniciantes-2026) * [Reserva de Emergência: Guia Completo](/blog/reserva-de-emergencia-guia-completo-2026) * [Tesouro Direto: Como Investir](/blog/tesouro-direto-guia-completo-2026-como-investir) * [Calculadoras FIRE: Independência Financeira](/blog/calculadoras-fire-independencia-financeira-brasil) # Anunciando SDKs Oficiais: TypeScript e Python para brapi.dev URL: /blog/lancamento-sdks-oficiais-typescript-python.mdx SDKs oficiais para TypeScript/JavaScript e Python! Integre a API de Ações Brasileiras com tipos completos e retry automático ✓ *** searchable: true title: 'Anunciando SDKs Oficiais: TypeScript e Python para brapi.dev' description: 'SDKs oficiais para TypeScript/JavaScript e Python! Integre a API de Ações Brasileiras com tipos completos e retry automático ✓' date: '2026-01-01' keywords: 'brapi sdk, typescript sdk, python sdk, api client, npm package, pypi, desenvolvimento, tipos typescript, 2026' author: 'Equipe brapi.dev' category: 'Anúncios e Novidades' subcategory: 'Lançamentos' readingTime: '5 min' tags: \['SDK', 'TypeScript', 'Python', 'Anúncio', 'Novidades', 'Desenvolvimento'] relatedPosts: \['api-b3-typescript-javascript-integracao-completa', 'api-b3-python-requests-guia-pratico', 'ia-assistente-brapi-tire-suas-duvidas', 'novos-modulos-na-brapi'] featured: true expertise: 'Desenvolvimento de SDKs e ferramentas para desenvolvedores' lastReviewed: '2026-01-01' -------------------------- import { Author, Authors } from '~/components/Authors'; > Estamos muito felizes em anunciar o lançamento das nossas SDKs oficiais para TypeScript/JavaScript e Python! Integrar a API de Ações Brasileiras nunca foi tão fácil. ## O Que São as SDKs? SDKs (Software Development Kits) são bibliotecas que facilitam a integração com nossa API, oferecendo: * **Tipos completos** - Autocomplete e validação no seu IDE * **Tratamento de erros** - Exceções tipadas e mensagens claras * **Retry automático** - Tentativas inteligentes em caso de falha * **API moderna** - Suporte a async/await e promises * **Sempre atualizado** - Gerado automaticamente com nossa API ## SDK TypeScript/JavaScript Versão no npm ### Instalação ```bash npm install brapi # ou yarn add brapi # ou pnpm add brapi # ou bun add brapi ``` ### Exemplo de Uso ```typescript import Brapi from 'brapi'; const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, }); // Tipos automáticos! const quote = await client.quote.retrieve('PETR4'); console.log(quote.results[0]); // { // symbol: 'PETR4', // regularMarketPrice: 38.45, // regularMarketChangePercent: 2.15, // ... // } ``` ### Características ✅ **Tipos TypeScript completos** - IntelliSense em todo lugar\ ✅ **Bundle otimizado** - Tree-shakeable e pequeno\ ✅ **Node.js e Browser** - Funciona em qualquer ambiente\ ✅ **Next.js ready** - Exemplos para App Router e Pages Router\ ✅ **Tratamento de erros** - Exceções tipadas por status code ### Exemplo Next.js ```typescript // app/stock/[ticker]/page.tsx import Brapi from 'brapi'; const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, }); export default async function StockPage({ params, }: { params: { ticker: string }; }) { const quote = await client.quote.retrieve(params.ticker); const stock = quote.results[0]; return (

{stock.shortName}

R$ {stock.regularMarketPrice.toFixed(2)}

); } ``` **[Ver documentação completa →](/docs/sdks/typescript)** *** ## SDK Python Versão no PyPI ### Instalação ```bash pip install brapi # Com suporte a aiohttp (opcional) pip install brapi[aiohttp] ``` ### Exemplo de Uso ```python from brapi import Brapi client = Brapi(api_key="seu_token") # Type hints completos! quote = client.quote.retrieve(tickers="PETR4") print(quote.results[0].regular_market_price) ``` ### Características ✅ **Type hints completos** - Autocomplete no IDE\ ✅ **Python 3.8+** - Compatível com versões modernas\ ✅ **Sync e Async** - Cliente síncrono e assíncrono\ ✅ **Powered by httpx** - HTTP/2 e connection pooling\ ✅ **aiohttp support** - Performance otimizada ### Exemplo Assíncrono ```python import asyncio from brapi import AsyncBrapi async def main(): async with AsyncBrapi(api_key="seu_token") as client: quote = await client.quote.retrieve(tickers="PETR4") print(quote.results[0].regular_market_price) asyncio.run(main()) ``` ### Integração com FastAPI ```python from fastapi import FastAPI from brapi import AsyncBrapi app = FastAPI() client = AsyncBrapi(api_key="seu_token") @app.get("/api/quote/{ticker}") async def get_quote(ticker: str): quote = await client.quote.retrieve(tickers=ticker) return { 'symbol': quote.results[0].symbol, 'price': quote.results[0].regular_market_price, } ``` **[Ver documentação completa →](/docs/sdks/python)** *** ## Por Que Usar as SDKs? ### Antes (Sem SDK) ```typescript // TypeScript sem SDK const response = await fetch( `https://brapi.dev/api/quote/PETR4`, { headers: { 'Authorization': `Bearer ${token}` } } ); if (!response.ok) { // Você precisa tratar erros manualmente throw new Error(`HTTP ${response.status}`); } const data = await response.json(); // Sem tipos, sem autocomplete 😢 const price = data.results[0].regularMarketPrice; ``` ```python # Python sem SDK import requests response = requests.get( 'https://brapi.dev/api/quote/PETR4', headers={'Authorization': f'Bearer {token}'} ) if response.status_code != 200: # Tratamento manual de erros raise Exception(f'HTTP {response.status_code}') data = response.json() # Sem type hints 😢 price = data['results'][0]['regularMarketPrice'] ``` ### Depois (Com SDK) ```typescript // TypeScript com SDK const quote = await client.quote.retrieve('PETR4'); // ✅ Tipos completos, autocomplete, retry automático const price = quote.results[0].regularMarketPrice; ``` ```python # Python com SDK quote = client.quote.retrieve(tickers="PETR4") # ✅ Type hints, autocomplete, retry automático price = quote.results[0].regular_market_price ``` ## Tratamento de Erros Inteligente As SDKs lançam exceções específicas por tipo de erro: ### TypeScript ```typescript try { const quote = await client.quote.retrieve('INVALID'); } catch (error) { if (error instanceof Brapi.NotFoundError) { console.log('Ticker não encontrado'); } else if (error instanceof Brapi.RateLimitError) { console.log('Limite de requisições atingido'); } else if (error instanceof Brapi.AuthenticationError) { console.log('Token inválido'); } } ``` ### Python ```python from brapi import NotFoundError, RateLimitError try: quote = client.quote.retrieve(tickers="INVALID") except NotFoundError: print("Ticker não encontrado") except RateLimitError: print("Limite de requisições atingido") ``` ## Retry Automático As SDKs tentam automaticamente em caso de: * Erros de conexão * Timeouts (408) * Rate limits (429) * Erros de servidor (5xx) ```typescript const client = new Brapi({ apiKey: process.env.BRAPI_API_KEY, maxRetries: 3, // Tenta até 3 vezes }); ``` ```python client = Brapi( api_key="seu_token", max_retries=3, # Tenta até 3 vezes ) ``` ## Gerado com Stainless Nossas SDKs são geradas automaticamente usando [Stainless](https://www.stainless.com/), garantindo: * ✅ Sempre sincronizadas com a API * ✅ Tipos precisos e atualizados * ✅ Documentação inline * ✅ Padrões de indústria * ✅ Testes automáticos ## Migração Fácil Já usa a API com fetch/requests? Migrar é simples: ### TypeScript ```typescript // Antes const response = await fetch(`https://brapi.dev/api/quote/${ticker}`, { headers: { 'Authorization': `Bearer ${token}` }, }); const data = await response.json(); const price = data.results[0].regularMarketPrice; // Depois const quote = await client.quote.retrieve(ticker); const price = quote.results[0].regularMarketPrice; ``` ### Python ```python # Antes response = requests.get( f'https://brapi.dev/api/quote/{ticker}', headers={'Authorization': f'Bearer {token}'} ) data = response.json() price = data['results'][0]['regularMarketPrice'] # Depois quote = client.quote.retrieve(tickers=ticker) price = quote.results[0].regular_market_price ``` ## Recursos Disponíveis Ambas as SDKs suportam todos os endpoints da API: * ✅ Cotações de ações, ETFs, FIIs * ✅ Criptomoedas * ✅ Moedas (câmbio) * ✅ Inflação * ✅ Taxa de juros * ✅ Dados fundamentalistas (módulos) * ✅ Histórico de preços ## Começe Agora ### TypeScript/JavaScript ```bash npm install brapi ``` **Documentação:** [/docs/sdks/typescript](/docs/sdks/typescript)\ **GitHub:** [github.com/brapi-dev/brapi-typescript](https://github.com/brapi-dev/brapi-typescript)\ **NPM:** [npmjs.com/package/brapi](https://www.npmjs.com/package/brapi) ### Python ```bash pip install brapi ``` **Documentação:** [/docs/sdks/python](/docs/sdks/python)\ **GitHub:** [github.com/brapi-dev/brapi-python](https://github.com/brapi-dev/brapi-python)\ **PyPI:** [pypi.org/project/brapi](https://pypi.org/project/brapi/) ## Feedback e Contribuições As SDKs são open-source! Contribuições, issues e feedback são muito bem-vindos: * 🐛 [Reportar bug (TypeScript)](https://github.com/brapi-dev/brapi-typescript/issues) * 🐛 [Reportar bug (Python)](https://github.com/brapi-dev/brapi-python/issues) * 💡 [Sugerir feature](https://github.com/brapi-dev/brapi-typescript/issues) * ⭐ [Star no GitHub](https://github.com/brapi-dev) ## Próximos Passos Explore a documentação completa: * 📚 [SDK TypeScript](/docs/sdks/typescript) * 📚 [SDK Python](/docs/sdks/python) * 📖 [Documentação da API](/docs) * 💻 [Exemplos de integração](/docs/examples) ## Conclusão Estamos muito animados com o lançamento dessas SDKs! Elas representam nosso compromisso em oferecer a melhor experiência para desenvolvedores que trabalham com dados financeiros do Brasil. Instale agora e comece a construir aplicações incríveis com dados da bolsa brasileira! 🚀 *** **Dúvidas ou sugestões?** Entre em contato com nossa equipe de suporte ou abra uma issue no GitHub. **Gostou do anúncio?** Compartilhe com outros desenvolvedores! # LCI e LCA em 2026: Guia Completo de Investimentos Isentos de IR URL: /blog/lci-lca-guia-completo-investimentos-isentos-ir-2026.mdx Entenda o que é LCI e LCA, como funcionam, quanto rendem, se são seguros (FGC), como investir e quando valem mais a pena que CDB. Guia completo com calculadora. *** searchable: true title: 'LCI e LCA em 2026: Guia Completo de Investimentos Isentos de IR' description: 'Entenda o que é LCI e LCA, como funcionam, quanto rendem, se são seguros (FGC), como investir e quando valem mais a pena que CDB. Guia completo com calculadora.' date: '2026-01-01' keywords: 'lci 2026, lca 2026, lci e lca, lci o que e, lca o que e, investimento isento ir, lci vs cdb, lca vs cdb, letra de credito imobiliario, letra de credito agronegocio, renda fixa isenta' author: 'Equipe brapi.dev' category: 'Renda Fixa' subcategory: 'Letras de Crédito' readingTime: '18 min' tags: \['LCI', 'LCA', 'Renda Fixa', 'Isenção IR', 'FGC', 'Investimentos', 'Iniciantes'] relatedPosts: \['o-que-e-cdi-guia-completo-2026', 'tesouro-direto-guia-completo-2026-como-investir', 'renda-fixa-vs-renda-variavel-2026', 'cdb-vs-tesouro-direto-comparativo-2026', 'como-investir-com-pouco-dinheiro-2026'] featured: true expertise: 'Investimentos de renda fixa isentos de imposto de renda' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > Você sabia que pode investir em renda fixa sem pagar imposto de renda? LCI e LCA são títulos bancários isentos de IR para pessoa física. Este guia explica tudo: o que são, como funcionam, quando valem a pena e como investir. *** ## O Que é LCI e LCA? ### LCI - Letra de Crédito Imobiliário **LCI** é um título emitido por bancos para captar dinheiro e financiar o setor imobiliário. ``` Você empresta para o banco ↓ Banco financia imóveis ↓ Você recebe juros (sem IR!) ``` ### LCA - Letra de Crédito do Agronegócio **LCA** é similar, mas financia o agronegócio brasileiro. ``` Você empresta para o banco ↓ Banco financia agricultura/pecuária ↓ Você recebe juros (sem IR!) ``` ### Comparativo Rápido | Característica | LCI | LCA | | -------------------- | ------------------- | ------------------- | | **O que financia** | Setor imobiliário | Agronegócio | | **Imposto de Renda** | Isento | Isento | | **IOF** | Isento após 30 dias | Isento após 30 dias | | **FGC** | Sim, até R$ 250 mil | Sim, até R$ 250 mil | | **Carência mínima** | 90 dias | 90 dias | | **Quem emite** | Bancos | Bancos | *** ## Por Que LCI e LCA São Isentos de IR? O governo brasileiro isenta esses investimentos para: 1. **Estimular o mercado imobiliário** (LCI) 2. **Apoiar o agronegócio** (LCA) 3. **Incentivar poupança de longo prazo** ### Comparação: Com IR vs Sem IR **Comparativo CDB 100% CDI vs LCI 100% CDI:** | Prazo | Alíquota IR | CDB 100% CDI (Líquido) | LCI 100% CDI | Vantagem LCI | | -------- | ----------- | ---------------------- | ------------ | ------------ | | 6 meses | 22,5% | \~R$ 5.100 | \~R$ 6.500 | +R$ 1.400 | | 12 meses | 20,0% | \~R$ 10.500 | \~R$ 13.150 | +R$ 2.650 | | 24 meses | 17,5% | \~R$ 22.800 | \~R$ 27.500 | +R$ 4.700 | *Base: R$ 10.000 investidos, CDI 13,15% a.a.* > A LCI/LCA compensa especialmente em prazos curtos, quando a alíquota de IR do CDB é maior (22,5%). *** ## Como Funciona o Rendimento ### Tipos de Rentabilidade | Tipo | Como funciona | Exemplo | | -------------- | ------------------ | -------------- | | **Pós-fixado** | Rende % do CDI | LCI 90% CDI | | **Prefixado** | Taxa fixa definida | LCI 11% ao ano | | **Híbrido** | Inflação + taxa | LCI IPCA + 5% | ### LCI/LCA Pós-fixados (Mais Comuns) **Consulta da taxa SELIC e CDI direto via `/api/v2/macro`:** ```typescript // Selic e CDI em uma única chamada (CDI vem como % ao dia) const response = await fetch( "https://brapi.dev/api/v2/macro/latest?symbols=selic,cdi", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }, ); const { results } = await response.json(); const selic = results.find((r) => r.series.slug === "selic")?.latest.value; const cdiDiario = results.find((r) => r.series.slug === "cdi")?.latest.value; // Anualizar CDI (252 dias úteis no Brasil) const cdiAnual = (Math.pow(1 + cdiDiario / 100, 252) - 1) * 100; ``` **Simulação LCI/LCA Pós-Fixado:** | Parâmetro | Valor | | --------------- | ------------- | | Valor Investido | R$ 50.000,00 | | Rentabilidade | 90% do CDI | | CDI Atual | 13,15% ao ano | | Taxa Efetiva | 11,84% ao ano | | Prazo | 12 meses | **Resultado:** | Item | Valor | | ----------------------- | ---------------- | | Rendimento | R$ 5.920,00 | | Montante Final | R$ 55.920,00 | | Imposto de Renda | R$ 0,00 (ISENTO) | | **Rentabilidade Total** | **11,84%** | *** ## LCI/LCA vs CDB: Quando Cada Um Vale Mais? ### Calculadora de Equivalência **Tabela de Equivalência: CDB (com IR) vs LCI (isento)** | Prazo | Alíquota IR | CDB 100% CDI equivale a | CDB 110% CDI equivale a | CDB 120% CDI equivale a | | -------- | ----------- | ----------------------- | ----------------------- | ----------------------- | | 6 meses | 22,5% | LCI 77,5% CDI | LCI 85,3% CDI | LCI 93,0% CDI | | 12 meses | 20,0% | LCI 80,0% CDI | LCI 88,0% CDI | LCI 96,0% CDI | | 18 meses | 17,5% | LCI 82,5% CDI | LCI 90,8% CDI | LCI 99,0% CDI | | 24 meses | 17,5% | LCI 82,5% CDI | LCI 90,8% CDI | LCI 99,0% CDI | | 36 meses | 15,0% | LCI 85,0% CDI | LCI 93,5% CDI | LCI 102,0% CDI | > **Se LCI pagar MAIS que o equivalente, ela é melhor!** > Exemplo: LCI 85% CDI é melhor que CDB 100% CDI (prazo 12 meses) ### Regra Prática ``` REGRA SIMPLES: LCI de 85% CDI ≈ CDB de 100% CDI (12 meses) LCI de 93% CDI ≈ CDB de 110% CDI (12 meses) LCI de 102% CDI ≈ CDB de 120% CDI (12 meses) Quanto maior o prazo, menor a vantagem da LCI (porque IR do CDB diminui para 15%) ``` *** ## Riscos e Garantias ### Garantia do FGC LCI e LCA são protegidos pelo **Fundo Garantidor de Créditos (FGC)**: | Característica | Cobertura | | ------------------------------ | ------------------------------------ | | Limite por CPF por instituição | R$ 250.000 | | Limite global por CPF | R$ 1.000.000 (por 4 anos) | | O que cobre | Principal + rendimentos | | Prazo para pagamento | Até 60 dias após liquidação do banco | ### Exemplo de Proteção **Análise de Cobertura FGC:** | Banco | Investido | Protegido (FGC) | Descoberto | Status | | --------- | -------------- | --------------- | ------------- | ------ | | Banco A | R$ 200.000 | R$ 200.000 | R$ 0 | ✅ | | Banco B | R$ 150.000 | R$ 150.000 | R$ 0 | ✅ | | Banco C | R$ 300.000 | R$ 250.000 | R$ 50.000 | ⚠️ | | **TOTAL** | **R$ 650.000** | **R$ 600.000** | **R$ 50.000** | | > ⚠️ **ATENÇÃO:** R$ 50.000 sem proteção FGC! Considere diversificar entre mais bancos para garantir cobertura total. ### Riscos a Considerar | Risco | Descrição | Como Mitigar | | ------------ | ----------------------- | --------------------------- | | **Crédito** | Banco quebrar | Respeitar limite FGC | | **Liquidez** | Não pode resgatar antes | Escolher prazos adequados | | **Mercado** | CDI cair (pós-fixado) | Diversificar com prefixados | | **Inflação** | Perder poder de compra | Considerar LCI IPCA+ | *** ## Como Investir em LCI e LCA ### Passo a Passo ``` 1. ABRIR CONTA EM CORRETORA XP, Rico, BTG, Inter, etc. ↓ 2. TRANSFERIR DINHEIRO TED ou PIX para a corretora ↓ 3. BUSCAR LCI/LCA Área de Renda Fixa > Filtrar por LCI ou LCA ↓ 4. ANALISAR OPÇÕES Comparar: rentabilidade, prazo, banco emissor ↓ 5. INVESTIR Aplicar valor mínimo ou mais ↓ 6. AGUARDAR VENCIMENTO Rendimento cai na conta automaticamente ``` ### O Que Analisar Antes de Investir **Checklist: Antes de Investir em LCI/LCA** **Rentabilidade:** * [ ] Qual % do CDI ou taxa fixa? * [ ] É competitivo vs outras opções? * [ ] Compensa a falta de liquidez? **Prazo:** * [ ] Carência mínima (geralmente 90 dias) * [ ] Data de vencimento * [ ] Posso esperar até o fim? **Emissor:** * [ ] Banco é conhecido? * [ ] Qual rating de crédito? * [ ] Está coberto pelo FGC? **Liquidez:** * [ ] Tem liquidez diária? (raro) * [ ] Posso vender antes no secundário? * [ ] Qual a carência? **Valor Mínimo:** * [ ] Qual o aporte mínimo? * [ ] Cabe no meu orçamento? * [ ] Respeita limite FGC? *** ## Melhores LCI e LCA do Mercado ### Onde Encontrar | Plataforma | Como Acessar | | -------------------- | ------------------------------ | | **XP Investimentos** | Renda Fixa > LCI/LCA | | **BTG Pactual** | Renda Fixa > Isentos de IR | | **Rico** | Renda Fixa > Letras de Crédito | | **Inter Invest** | Investimentos > Renda Fixa | | **NuInvest** | Investir > Renda Fixa | ### Rentabilidades Típicas (2026) | Tipo | Prazo | Rentabilidade Típica | | ------------- | -------- | -------------------- | | LCI pós | 6 meses | 85-90% CDI | | LCI pós | 12 meses | 90-95% CDI | | LCI pós | 24 meses | 95-100% CDI | | LCA pós | 12 meses | 92-97% CDI | | LCI prefixada | 12 meses | 10-11% ao ano | | LCI IPCA+ | 24 meses | IPCA + 5-6% | ### Comparador de Ofertas **Comparativo de Ofertas LCI/LCA (valores ilustrativos):** *Base: CDI 13,15% | Investimento: R$ 10.000,00* | Tipo | Banco | % CDI | Taxa Efetiva | Prazo | Mínimo | Rend. Estimado | | ---- | --------------- | ----- | ------------ | ----- | -------- | -------------- | | LCA | Banco do Brasil | 88% | 11,57% | 6m | R$ 500 | R$ 560 | | LCI | Banco Inter | 92% | 12,10% | 12m | R$ 1.000 | R$ 1.210 | | LCI | XP (diversos) | 93% | 12,23% | 12m | R$ 1.000 | R$ 1.223 | | LCA | BTG Pactual | 95% | 12,49% | 12m | R$ 5.000 | R$ 1.249 | | LCI | Banco Pan | 100% | 13,15% | 24m | R$ 1.000 | R$ 2.800 | > ⚠️ Valores ilustrativos. Consulte sua corretora para ofertas atuais. *** ## Estratégias com LCI e LCA ### 1. Escada de Vencimentos (Laddering) Distribua investimentos em diferentes prazos: **Estratégia de Escada com LCI/LCA:** *Valor Total: R$ 100.000,00 | CDI: 13,15%* | Prazo | % CDI | Alocação | Valor | Rend. Estimado | | --------- | ----- | -------- | -------------- | -------------- | | 3 meses | 85% | 20% | R$ 20.000 | R$ 560 | | 6 meses | 90% | 25% | R$ 25.000 | R$ 1.480 | | 12 meses | 93% | 30% | R$ 30.000 | R$ 3.670 | | 24 meses | 97% | 25% | R$ 25.000 | R$ 6.380 | | **Total** | | **100%** | **R$ 100.000** | **R$ 12.090** | **Vantagens:** * ✓ Liquidez escalonada (dinheiro liberado a cada vencimento) * ✓ Captura taxas maiores em prazos maiores * ✓ Flexibilidade para reinvestir ### 2. Complemento à Reserva de Emergência ``` RESERVA DE EMERGÊNCIA (6 meses de gastos): ├── 50% Tesouro Selic (liquidez D+1) │ → Para emergências imediatas │ └── 50% LCI/LCA 3-6 meses → Rende mais, isento de IR → Para emergências não urgentes ``` ### 3. Maximizar Isenção Fiscal **Comparativo de Estratégias para Maximizar Rendimento Líquido:** *Valor: R$ 50.000 | Prazo: 12 meses | CDI: 13,15% | Alíquota IR: 20%* | Estratégia | Rendimento Líquido | | ------------------------------- | ------------------ | | 100% CDB 120% CDI (banco menor) | R$ 6.312 | | 50% CDB 110% + 50% LCI 90% | R$ 5.136 | | 100% LCI 90% CDI | R$ 5.920 | | 100% CDB 100% CDI | R$ 5.260 | > A melhor estratégia depende das taxas disponíveis. Um CDB com taxa muito alta (120%+) pode compensar o IR. *** ## Declaração no Imposto de Renda Mesmo sendo isentos, LCI e LCA devem ser declarados: ### Onde Declarar | Campo | O que informar | | ------------------- | -------------------------------------- | | **Bens e Direitos** | Grupo 04, Código 02 | | **CNPJ** | Da instituição emissora | | **Discriminação** | LCI/LCA, banco, quantidade, valor | | **Situação** | Valor em 31/12 do ano anterior e atual | ### Rendimentos Isentos | Campo | O que informar | | ----------------------- | --------------------------------- | | **Rendimentos Isentos** | Linha 12 - Rendimentos de LCI/LCA | | **Valor** | Rendimentos recebidos no ano | ### Exemplo de Declaração ``` BENS E DIREITOS: Grupo: 04 - Aplicações e Investimentos Código: 02 - Títulos públicos e privados Discriminação: LCI do Banco Inter, aplicado em 15/03/2024, vencimento 15/03/2026, 92% do CDI. Quantidade: 1 título. CNPJ: XX.XXX.XXX/0001-XX Situação em 31/12/2023: R$ 0,00 Situação em 31/12/2024: R$ 50.000,00 RENDIMENTOS ISENTOS: Linha 12: R$ 4.250,00 (rendimentos LCI/LCA) ``` *** ## Perguntas Frequentes ### 1. LCI e LCA têm liquidez diária? **Geralmente não.** A maioria tem carência de 90 dias e vencimento fixo. Algumas opções têm liquidez após a carência, mas são raras e rendem menos. ### 2. Qual é melhor: LCI ou LCA? **São equivalentes.** A única diferença é o setor financiado. Compare a rentabilidade oferecida. ### 3. LCI/LCA é melhor que Tesouro Direto? Depende: * **Liquidez:** Tesouro Selic tem D+1, LCI geralmente não * **Rentabilidade:** LCI pode render mais (isenta de IR) * **Segurança:** Tesouro é garantia do governo, LCI tem FGC ### 4. Posso perder dinheiro com LCI/LCA? Só em cenários extremos: * Banco quebrar E você exceder limite FGC * Vender antes no mercado secundário por menos ### 5. Qual o valor mínimo para investir? Varia por banco: * Alguns aceitam R$ 500 * Média: R$ 1.000 a R$ 5.000 * Bancos menores podem exigir mais *** ## Quando NÃO Investir em LCI/LCA | Situação | Por quê | Alternativa | | -------------------------------- | ----------------- | ---------------------------------- | | Precisa de liquidez imediata | Tem carência | Tesouro Selic, CDB liquidez diária | | Valor acima de R$ 250k por banco | Excede FGC | Diversificar bancos | | CDB oferece >120% CDI | Pode compensar IR | Calcular equivalência | | Prazo muito longo | CDI pode cair | Considere prefixados | *** ## Conclusão ### Quando LCI/LCA Vale a Pena | ✅ Investir | ❌ Evitar | | ---------------------------------- | ---------------------------- | | Pode esperar a carência/vencimento | Precisa de liquidez imediata | | LCI rende >85% CDI (12 meses) | CDB oferece >120% CDI | | Valor até R$ 250k por banco | Vai ultrapassar limite FGC | | Quer maximizar rendimento líquido | Não quer risco de crédito | ### Resumo Final ``` LCI e LCA em poucas palavras: • Isentos de IR para pessoa física • Protegidos pelo FGC (até R$ 250k) • Carência mínima de 90 dias • Comparar com CDB equivalente (tabela) • Ótimos para objetivos de médio prazo • Diversificar bancos para proteção ``` ### Próximos Passos 1. **Compare ofertas** na sua corretora 2. **Use a calculadora** de equivalência 3. **Respeite limite FGC** por banco 4. **Considere a escada** de vencimentos 5. **Declare corretamente** no IR *** ## Leia Também * [O Que É CDI: Guia Completo 2026](/blog/o-que-e-cdi-guia-completo-2026) * [Tesouro Direto 2026: Guia Completo](/blog/tesouro-direto-guia-completo-2026-como-investir) * [Renda Fixa vs Renda Variável 2026](/blog/renda-fixa-vs-renda-variavel-2026) * [Como Investir com Pouco Dinheiro 2026](/blog/como-investir-com-pouco-dinheiro-2026) *** **Aviso Legal:** Este conteúdo é educacional e não constitui recomendação de investimento. Rentabilidades e taxas são ilustrativas e podem variar. Consulte um profissional antes de investir. # Como Listar Todas as Ações da B3 por API com Python URL: /blog/listar-acoes-b3-api-tickers-setores-python.mdx Use a API da brapi para listar e filtrar tickers de ações, FIIs, ETFs, BDRs e units por nome, setor e tipo, sem baixar arquivos da B3. *** searchable: true title: 'Como Listar Todas as Ações da B3 por API com Python' description: 'Use a API da brapi para listar e filtrar tickers de ações, FIIs, ETFs, BDRs e units por nome, setor e tipo, sem baixar arquivos da B3.' date: '2026-07-17' keywords: 'lista de ações b3 api, todos os tickers b3 python, api lista ações, ações listadas b3 csv, tickers bovespa, lista fiis api' author: 'Alisson Leal' category: 'Tutoriais e Integrações' subcategory: 'Python e dados da B3' readingTime: '7 min' tags: \['Python', 'B3', 'API', 'Tickers', 'Ações', 'FIIs', 'ETFs', 'BDRs'] relatedPosts: \['b3-api-gratuita-como-usar-cotacoes', 'api-b3-python-requests-guia-pratico', 'stock-screener-python-brapi-filtrar-acoes'] featured: true expertise: 'Integração de APIs financeiras e normalização de tickers B3' lastReviewed: '2026-07-17' -------------------------- import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; Para listar os ativos disponíveis na B3 sem processar planilhas, consulte `/api/v2/tickers`. O endpoint devolve símbolos, nomes, tipos e setores em JSON, com busca, filtros, ordenação e paginação. ```bash curl "https://brapi.dev/api/v2/tickers?type=stock&limit=20" ``` O catálogo inclui ações, units, FIIs, ETFs, BDRs e índices. Opções, futuros, Tesouro Direto, criptomoedas e moedas têm catálogos próprios. ## Resposta rápida Esta chamada busca as ações do setor financeiro com maior volume: ```bash curl "https://brapi.dev/api/v2/tickers?type=stock§or=Finance&sortBy=volume&sortOrder=desc&limit=20" ``` Para encontrar um ativo pelo nome ou código: ```bash curl "https://brapi.dev/api/v2/tickers?search=PETR" ``` A busca aceita ticker, nome da empresa e códigos antigos conhecidos pela brapi. Isso é útil em caixas de busca e importações de carteiras antigas. ## Tipos e subtipos disponíveis O filtro `type` separa três grupos amplos: | `type` | Conteúdo | | ------- | ----------------------------------- | | `stock` | Ações e units | | `fund` | FIIs, ETFs e outros fundos listados | | `bdr` | BDRs negociados na B3 | Use `subType` quando precisar de uma classificação mais precisa. Os valores incluem `stock`, `unit`, `fii`, `etf`, `fi-infra`, `fi-agro`, `fip`, `fidc` e `bdr`. ```bash curl "https://brapi.dev/api/v2/tickers?type=fund&subType=fii&limit=50" ``` Use este endpoint para descobrir e validar símbolos. Para preço atual, consulte `/api/v2/stocks/quote` ou o endpoint específico do tipo de ativo. ## Listar tickers com Python O exemplo abaixo percorre todas as páginas e cria um DataFrame. Guarde o token em uma variável de ambiente para não publicá-lo no código. ```python import os import requests import pandas as pd BASE_URL = "https://brapi.dev/api/v2/tickers" TOKEN = os.getenv("BRAPI_TOKEN") headers = {"Authorization": f"Bearer {TOKEN}"} if TOKEN else {} rows = [] page = 1 while True: response = requests.get( BASE_URL, params={ "type": "stock", "sortBy": "symbol", "sortOrder": "asc", "page": page, "limit": 100, }, headers=headers, timeout=30, ) response.raise_for_status() payload = response.json() rows.extend(payload["results"]) pagination = payload["pagination"] if page >= pagination["totalPages"]: break page += 1 df = pd.DataFrame(rows) print(df[["symbol", "name", "assetType", "sector"]].head()) ``` Confira o nome do array principal e da paginação na [documentação de tickers](/docs/tickers), pois o contrato documentado é a referência para integrações em produção. ## Exportar a lista para CSV Depois de montar o DataFrame, a exportação é direta: ```python df.to_csv("tickers-b3.csv", index=False, encoding="utf-8") ``` O CSV serve para autocomplete, tabelas de referência e rotinas que precisam validar uma lista enviada pelo usuário. Não use uma cópia antiga como catálogo permanente. Novos ativos entram e tickers podem mudar. ## Filtrar por setor e subtipo É melhor filtrar na API do que baixar todo o catálogo a cada busca. Estes são alguns exemplos: ```text # Ações de um setor /api/v2/tickers?type=stock§or=Finance # FIIs /api/v2/tickers?subType=fii # ETFs /api/v2/tickers?subType=etf # BDRs /api/v2/tickers?type=bdr # Busca por nome ou ticker /api/v2/tickers?search=Itaú ``` Os filtros disponíveis também incluem `subsector`. Para montar um screener, combine a listagem com o endpoint de indicadores adequado ao ativo. ## Como tratar ticker antigo Uma empresa pode trocar de ticker após reorganização, incorporação ou mudança de nome. Não descarte o dado como inválido antes de tentar resolvê-lo. ```bash curl "https://brapi.dev/api/v2/tickers/resolve?symbols=SEU_TICKER" ``` O fluxo recomendado é: 1. buscar o símbolo em `/api/v2/tickers`; 2. tentar `/api/v2/tickers/resolve` quando ele não aparecer; 3. consultar `/api/v2/tickers/coverage` antes de escolher o endpoint de dados. Veja também o [histórico de renomes](/docs/tickers/renomes) e a [verificação de cobertura](/docs/tickers/cobertura). ## Quando usar o endpoint legado `/api/quote/list` continua disponível para integrações antigas. Projetos novos devem usar `/api/v2/tickers`, que separa descoberta de símbolos da consulta de cotação e dos demais dados. Se o objetivo agora é baixar preços, continue em [dados históricos da B3 com Python](/blog/dados-historicos-b3-python-pandas-api). # Machine Learning para Prever Ações com Python 2026: Tutorial Completo URL: /blog/machine-learning-prever-acoes-python-tutorial.mdx Aprenda a usar Machine Learning para prever preços de ações com Python e brapi. Tutorial: LSTM, Random Forest, features técnicas, backtesting e limitações. *** searchable: true title: 'Machine Learning para Prever Ações com Python 2026: Tutorial Completo' description: 'Aprenda a usar Machine Learning para prever preços de ações com Python e brapi. Tutorial: LSTM, Random Forest, features técnicas, backtesting e limitações.' date: '2025-12-29' keywords: 'machine learning acoes python, prever acoes ia, lstm acoes, random forest acoes, deep learning bolsa, previsao precos python, brapi machine learning, 2026' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Machine Learning' readingTime: '22 min' tags: \['Machine Learning', 'Python', 'LSTM', 'Deep Learning', 'Ações', 'API', 'Inteligência Artificial'] relatedPosts: \['backtesting-estrategias-python-brapi-guia-completo', 'stock-screener-python-brapi-filtrar-acoes', 'analise-tecnica-suportes-resistencias-medias-moveis'] featured: true expertise: 'Equipe técnica especializada em ciência de dados e análise quantitativa' lastReviewed: '2026-01-17' -------------------------- import { Authors, Author } from '~/components/Authors'; > Será que é possível prever o mercado com IA? Neste tutorial, você vai aprender a construir modelos de Machine Learning para análise de ações — e entender por que eles não são uma bola de cristal. *** ## Aviso Importante > **⚠️ Machine Learning NÃO é garantia de lucro.** O mercado financeiro é influenciado por fatores imprevisíveis (notícias, política, sentimento). Use ML como ferramenta de análise, não como oráculo. *** ## O Que Você Vai Aprender ``` ┌─────────────────────────────────────────────────────────────┐ │ ROADMAP DO TUTORIAL │ ├─────────────────────────────────────────────────────────────┤ │ │ │ 1. Fundamentos │ │ └─ Por que ML para ações é difícil │ │ │ │ 2. Preparação de Dados │ │ └─ Buscar dados da brapi │ │ └─ Feature engineering │ │ │ │ 3. Modelos Clássicos │ │ └─ Random Forest │ │ └─ Gradient Boosting │ │ │ │ 4. Deep Learning │ │ └─ LSTM para séries temporais │ │ │ │ 5. Avaliação │ │ └─ Métricas e backtesting │ │ │ │ 6. Limitações │ │ └─ Por que modelos falham │ │ │ └─────────────────────────────────────────────────────────────┘ ``` *** ## Por Que ML para Ações é Difícil? ### O Problema Fundamental O mercado de ações é um **sistema adaptativo complexo**: | Desafio | Descrição | | ------------------------ | ------------------------------------------ | | **Não-estacionariedade** | Padrões mudam com o tempo | | **Ruído** | Grande parte do movimento é aleatório | | **Competição** | Outros players também usam ML | | **Eventos raros** | Crises e black swans são imprevisíveis | | **Overfitting** | Fácil ajustar ao passado sem prever futuro | ### O Que ML Pode (e Não Pode) Fazer ``` ML PODE: ├─ Identificar padrões em dados históricos ├─ Automatizar análise de indicadores ├─ Classificar ações por características └─ Gerar features para análise ML NÃO PODE: ├─ Prever com certeza movimentos futuros ├─ Antecipar notícias e eventos ├─ Garantir lucros consistentes └─ Substituir análise fundamentalista ``` *** ## Setup do Ambiente ### Instalação ```bash pip install requests pandas numpy scikit-learn tensorflow matplotlib seaborn ``` ### Estrutura do Projeto ``` ml-stocks/ ├── src/ │ ├── data/ │ │ ├── fetcher.py # Buscar dados │ │ └── preprocessing.py # Preparação │ ├── features/ │ │ └── technical.py # Indicadores técnicos │ ├── models/ │ │ ├── random_forest.py # Modelo RF │ │ ├── xgboost_model.py # Modelo XGB │ │ └── lstm.py # Modelo LSTM │ └── evaluation/ │ └── metrics.py # Avaliação ├── notebooks/ │ └── exploration.ipynb ├── main.py └── requirements.txt ``` *** ## Buscando e Preparando Dados ### Fetcher com brapi ```python # src/data/fetcher.py import requests import pandas as pd from typing import Optional class BrapiMLDataFetcher: """Busca dados para Machine Learning""" BASE_URL = "https://brapi.dev/api" def __init__(self, token: str): self.token = token def get_stock_data( self, ticker: str, range_period: str = "5y", include_fundamentals: bool = True ) -> pd.DataFrame: """Busca dados completos para ML""" url = f"{self.BASE_URL}/quote/{ticker}" params = { "token": self.token, "range": range_period, "interval": "1d", "fundamental": str(include_fundamentals).lower() } response = requests.get(url, params=params) response.raise_for_status() data = response.json() if not data.get("results"): raise ValueError(f"Sem dados para {ticker}") result = data["results"][0] # Dados históricos historical = result.get("historicalDataPrice", []) df = pd.DataFrame(historical) df["date"] = pd.to_datetime(df["date"], unit="s") df = df.sort_values("date").reset_index(drop=True) # Adicionar ticker df["ticker"] = ticker # Adicionar dados fundamentais se disponíveis if include_fundamentals: if "defaultKeyStatistics" in result: stats = result["defaultKeyStatistics"] df["pe_ratio"] = stats.get("forwardPE", None) df["pb_ratio"] = stats.get("priceToBook", None) df["beta"] = stats.get("beta", None) return df def get_multiple_stocks( self, tickers: list[str], range_period: str = "5y" ) -> pd.DataFrame: """Busca dados de múltiplas ações""" all_data = [] for ticker in tickers: try: df = self.get_stock_data(ticker, range_period) all_data.append(df) print(f"✓ {ticker}: {len(df)} registros") except Exception as e: print(f"✗ {ticker}: {e}") return pd.concat(all_data, ignore_index=True) if all_data else pd.DataFrame() # Uso if __name__ == "__main__": fetcher = BrapiMLDataFetcher("seu_token") df = fetcher.get_stock_data("PETR4", "3y") print(df.head()) ``` *** ## Feature Engineering ### Indicadores Técnicos como Features ```python # src/features/technical.py import pandas as pd import numpy as np class TechnicalFeatures: """Cria features técnicas para ML""" @staticmethod def add_all_features(df: pd.DataFrame) -> pd.DataFrame: """Adiciona todas as features técnicas""" df = df.copy() # Retornos df = TechnicalFeatures.add_returns(df) # Médias móveis df = TechnicalFeatures.add_moving_averages(df) # Volatilidade df = TechnicalFeatures.add_volatility(df) # RSI df = TechnicalFeatures.add_rsi(df) # MACD df = TechnicalFeatures.add_macd(df) # Bollinger Bands df = TechnicalFeatures.add_bollinger_bands(df) # Volume features df = TechnicalFeatures.add_volume_features(df) # Lag features df = TechnicalFeatures.add_lag_features(df) # Target df = TechnicalFeatures.add_target(df) return df @staticmethod def add_returns(df: pd.DataFrame) -> pd.DataFrame: """Retornos em diferentes períodos""" df["return_1d"] = df["close"].pct_change(1) df["return_5d"] = df["close"].pct_change(5) df["return_10d"] = df["close"].pct_change(10) df["return_20d"] = df["close"].pct_change(20) return df @staticmethod def add_moving_averages(df: pd.DataFrame) -> pd.DataFrame: """Médias móveis e relações""" for window in [5, 10, 20, 50, 100, 200]: df[f"sma_{window}"] = df["close"].rolling(window).mean() df[f"ema_{window}"] = df["close"].ewm(span=window, adjust=False).mean() # Posição relativa às médias df["close_vs_sma20"] = df["close"] / df["sma_20"] - 1 df["close_vs_sma50"] = df["close"] / df["sma_50"] - 1 df["close_vs_sma200"] = df["close"] / df["sma_200"] - 1 # Cruzamentos df["sma20_vs_sma50"] = df["sma_20"] / df["sma_50"] - 1 df["sma50_vs_sma200"] = df["sma_50"] / df["sma_200"] - 1 return df @staticmethod def add_volatility(df: pd.DataFrame) -> pd.DataFrame: """Volatilidade histórica""" df["volatility_10d"] = df["return_1d"].rolling(10).std() * np.sqrt(252) df["volatility_20d"] = df["return_1d"].rolling(20).std() * np.sqrt(252) df["volatility_60d"] = df["return_1d"].rolling(60).std() * np.sqrt(252) # ATR (Average True Range) df["tr"] = np.maximum( df["high"] - df["low"], np.maximum( abs(df["high"] - df["close"].shift(1)), abs(df["low"] - df["close"].shift(1)) ) ) df["atr_14"] = df["tr"].rolling(14).mean() return df @staticmethod def add_rsi(df: pd.DataFrame, periods: list = [7, 14, 21]) -> pd.DataFrame: """RSI em diferentes períodos""" for period in periods: delta = df["close"].diff() gain = delta.where(delta > 0, 0) loss = (-delta).where(delta < 0, 0) avg_gain = gain.rolling(window=period).mean() avg_loss = loss.rolling(window=period).mean() rs = avg_gain / avg_loss df[f"rsi_{period}"] = 100 - (100 / (1 + rs)) return df @staticmethod def add_macd(df: pd.DataFrame) -> pd.DataFrame: """MACD e histograma""" df["ema_12"] = df["close"].ewm(span=12, adjust=False).mean() df["ema_26"] = df["close"].ewm(span=26, adjust=False).mean() df["macd"] = df["ema_12"] - df["ema_26"] df["macd_signal"] = df["macd"].ewm(span=9, adjust=False).mean() df["macd_hist"] = df["macd"] - df["macd_signal"] return df @staticmethod def add_bollinger_bands(df: pd.DataFrame, window: int = 20) -> pd.DataFrame: """Bollinger Bands""" df["bb_middle"] = df["close"].rolling(window).mean() df["bb_std"] = df["close"].rolling(window).std() df["bb_upper"] = df["bb_middle"] + 2 * df["bb_std"] df["bb_lower"] = df["bb_middle"] - 2 * df["bb_std"] df["bb_width"] = (df["bb_upper"] - df["bb_lower"]) / df["bb_middle"] df["bb_position"] = (df["close"] - df["bb_lower"]) / (df["bb_upper"] - df["bb_lower"]) return df @staticmethod def add_volume_features(df: pd.DataFrame) -> pd.DataFrame: """Features de volume""" df["volume_sma_20"] = df["volume"].rolling(20).mean() df["volume_ratio"] = df["volume"] / df["volume_sma_20"] df["obv"] = (np.sign(df["close"].diff()) * df["volume"]).cumsum() return df @staticmethod def add_lag_features(df: pd.DataFrame, lags: list = [1, 2, 3, 5, 10]) -> pd.DataFrame: """Features com lag""" for lag in lags: df[f"close_lag_{lag}"] = df["close"].shift(lag) df[f"return_lag_{lag}"] = df["return_1d"].shift(lag) return df @staticmethod def add_target( df: pd.DataFrame, horizon: int = 5, target_type: str = "classification" ) -> pd.DataFrame: """ Adiciona variável target. target_type: - "classification": 1 se subiu, 0 se caiu - "regression": retorno percentual """ future_return = df["close"].shift(-horizon) / df["close"] - 1 if target_type == "classification": df["target"] = (future_return > 0).astype(int) else: df["target"] = future_return return df # Uso if __name__ == "__main__": from src.data.fetcher import BrapiMLDataFetcher fetcher = BrapiMLDataFetcher("seu_token") df = fetcher.get_stock_data("PETR4") df = TechnicalFeatures.add_all_features(df) print(f"Features criadas: {len(df.columns)}") print(df.columns.tolist()) ``` *** ## Modelo: Random Forest ### Implementação ```python # src/models/random_forest.py import pandas as pd import numpy as np from sklearn.ensemble import RandomForestClassifier from sklearn.model_selection import TimeSeriesSplit from sklearn.metrics import accuracy_score, precision_score, recall_score, f1_score, confusion_matrix from sklearn.preprocessing import StandardScaler class RandomForestStockModel: """Random Forest para classificação de ações""" def __init__( self, n_estimators: int = 100, max_depth: int = 10, min_samples_split: int = 10, random_state: int = 42 ): self.model = RandomForestClassifier( n_estimators=n_estimators, max_depth=max_depth, min_samples_split=min_samples_split, random_state=random_state, n_jobs=-1 ) self.scaler = StandardScaler() self.feature_columns = None def prepare_data(self, df: pd.DataFrame) -> tuple: """Prepara dados para treino""" # Remover linhas com NaN df = df.dropna() # Definir features (excluir colunas não-features) exclude_cols = ["date", "ticker", "target", "open", "high", "low", "close", "volume"] self.feature_columns = [c for c in df.columns if c not in exclude_cols] X = df[self.feature_columns].values y = df["target"].values return X, y, df["date"].values def train_test_split_temporal( self, X: np.ndarray, y: np.ndarray, dates: np.ndarray, test_size: float = 0.2 ) -> tuple: """Split temporal (não aleatório)""" split_idx = int(len(X) * (1 - test_size)) X_train, X_test = X[:split_idx], X[split_idx:] y_train, y_test = y[:split_idx], y[split_idx:] dates_test = dates[split_idx:] return X_train, X_test, y_train, y_test, dates_test def fit(self, X_train: np.ndarray, y_train: np.ndarray): """Treina o modelo""" # Normalizar features X_train_scaled = self.scaler.fit_transform(X_train) # Treinar self.model.fit(X_train_scaled, y_train) return self def predict(self, X: np.ndarray) -> np.ndarray: """Faz previsões""" X_scaled = self.scaler.transform(X) return self.model.predict(X_scaled) def predict_proba(self, X: np.ndarray) -> np.ndarray: """Retorna probabilidades""" X_scaled = self.scaler.transform(X) return self.model.predict_proba(X_scaled) def evaluate(self, X_test: np.ndarray, y_test: np.ndarray) -> dict: """Avalia o modelo""" y_pred = self.predict(X_test) return { "accuracy": accuracy_score(y_test, y_pred), "precision": precision_score(y_test, y_pred, zero_division=0), "recall": recall_score(y_test, y_pred, zero_division=0), "f1": f1_score(y_test, y_pred, zero_division=0), "confusion_matrix": confusion_matrix(y_test, y_pred) } def get_feature_importance(self) -> pd.DataFrame: """Retorna importância das features""" importance = pd.DataFrame({ "feature": self.feature_columns, "importance": self.model.feature_importances_ }) return importance.sort_values("importance", ascending=False) def cross_validate_temporal( self, X: np.ndarray, y: np.ndarray, n_splits: int = 5 ) -> dict: """Validação cruzada temporal""" tscv = TimeSeriesSplit(n_splits=n_splits) scores = { "accuracy": [], "precision": [], "recall": [], "f1": [] } for train_idx, test_idx in tscv.split(X): X_train, X_test = X[train_idx], X[test_idx] y_train, y_test = y[train_idx], y[test_idx] # Treinar X_train_scaled = self.scaler.fit_transform(X_train) self.model.fit(X_train_scaled, y_train) # Avaliar metrics = self.evaluate(X_test, y_test) for key in scores: scores[key].append(metrics[key]) # Médias return {k: np.mean(v) for k, v in scores.items()} # Exemplo de uso if __name__ == "__main__": from src.data.fetcher import BrapiMLDataFetcher from src.features.technical import TechnicalFeatures # Buscar dados fetcher = BrapiMLDataFetcher("seu_token") df = fetcher.get_stock_data("PETR4", "5y") # Criar features df = TechnicalFeatures.add_all_features(df) # Preparar modelo model = RandomForestStockModel(n_estimators=200, max_depth=8) X, y, dates = model.prepare_data(df) # Split temporal X_train, X_test, y_train, y_test, dates_test = model.train_test_split_temporal(X, y, dates) # Treinar model.fit(X_train, y_train) # Avaliar metrics = model.evaluate(X_test, y_test) print("\n=== Métricas ===") print(f"Accuracy: {metrics['accuracy']:.4f}") print(f"Precision: {metrics['precision']:.4f}") print(f"Recall: {metrics['recall']:.4f}") print(f"F1 Score: {metrics['f1']:.4f}") # Feature importance print("\n=== Top 10 Features ===") print(model.get_feature_importance().head(10)) ``` *** ## Modelo: LSTM (Deep Learning) ### Implementação ```python # src/models/lstm.py import numpy as np import pandas as pd from sklearn.preprocessing import MinMaxScaler import tensorflow as tf from tensorflow.keras.models import Sequential from tensorflow.keras.layers import LSTM, Dense, Dropout from tensorflow.keras.callbacks import EarlyStopping class LSTMStockModel: """LSTM para previsão de séries temporais""" def __init__( self, sequence_length: int = 60, n_features: int = 1, lstm_units: int = 50, dropout: float = 0.2 ): self.sequence_length = sequence_length self.n_features = n_features self.lstm_units = lstm_units self.dropout = dropout self.scaler = MinMaxScaler() self.model = None def build_model(self): """Constrói a arquitetura LSTM""" model = Sequential([ LSTM( self.lstm_units, return_sequences=True, input_shape=(self.sequence_length, self.n_features) ), Dropout(self.dropout), LSTM(self.lstm_units, return_sequences=False), Dropout(self.dropout), Dense(25), Dense(1) ]) model.compile( optimizer="adam", loss="mse", metrics=["mae"] ) self.model = model return model def create_sequences( self, data: np.ndarray, target: np.ndarray = None ) -> tuple: """Cria sequências para LSTM""" X, y = [], [] for i in range(self.sequence_length, len(data)): X.append(data[i - self.sequence_length:i]) if target is not None: y.append(target[i]) X = np.array(X) if target is not None: y = np.array(y) return X, y return X def prepare_data( self, df: pd.DataFrame, feature_cols: list = ["close"], target_col: str = "close" ) -> tuple: """Prepara dados para LSTM""" # Selecionar features data = df[feature_cols].values # Normalizar data_scaled = self.scaler.fit_transform(data) # Criar target (próximo valor) target = data_scaled[1:, 0] if len(feature_cols) == 1 else data_scaled[1:, feature_cols.index(target_col)] data_scaled = data_scaled[:-1] # Criar sequências X, y = self.create_sequences(data_scaled, target) self.n_features = len(feature_cols) return X, y def train( self, X_train: np.ndarray, y_train: np.ndarray, X_val: np.ndarray = None, y_val: np.ndarray = None, epochs: int = 50, batch_size: int = 32 ): """Treina o modelo""" if self.model is None: self.build_model() callbacks = [ EarlyStopping( monitor="val_loss" if X_val is not None else "loss", patience=10, restore_best_weights=True ) ] validation_data = (X_val, y_val) if X_val is not None else None history = self.model.fit( X_train, y_train, epochs=epochs, batch_size=batch_size, validation_data=validation_data, callbacks=callbacks, verbose=1 ) return history def predict(self, X: np.ndarray) -> np.ndarray: """Faz previsões""" predictions = self.model.predict(X) # Inverter normalização predictions_rescaled = self.scaler.inverse_transform( np.concatenate([predictions, np.zeros((len(predictions), self.n_features - 1))], axis=1) )[:, 0] return predictions_rescaled def evaluate( self, X_test: np.ndarray, y_test: np.ndarray, y_test_original: np.ndarray = None ) -> dict: """Avalia o modelo""" predictions = self.model.predict(X_test) # MSE e MAE normalizados mse = np.mean((predictions.flatten() - y_test) ** 2) mae = np.mean(np.abs(predictions.flatten() - y_test)) # Direção correta (classificação implícita) if y_test_original is not None: pred_direction = np.sign(predictions.flatten()[1:] - predictions.flatten()[:-1]) actual_direction = np.sign(y_test_original[1:] - y_test_original[:-1]) direction_accuracy = np.mean(pred_direction == actual_direction) else: pred_direction = np.sign(predictions.flatten()[1:] - predictions.flatten()[:-1]) actual_direction = np.sign(y_test[1:] - y_test[:-1]) direction_accuracy = np.mean(pred_direction == actual_direction) return { "mse": mse, "mae": mae, "rmse": np.sqrt(mse), "direction_accuracy": direction_accuracy } # Exemplo de uso if __name__ == "__main__": from src.data.fetcher import BrapiMLDataFetcher # Buscar dados fetcher = BrapiMLDataFetcher("seu_token") df = fetcher.get_stock_data("PETR4", "5y") # Preparar modelo lstm = LSTMStockModel(sequence_length=60, n_features=1, lstm_units=50) # Preparar dados (usando apenas preço de fechamento) X, y = lstm.prepare_data(df, feature_cols=["close"]) # Split split = int(len(X) * 0.8) X_train, X_test = X[:split], X[split:] y_train, y_test = y[:split], y[split:] # Treinar history = lstm.train(X_train, y_train, X_test, y_test, epochs=50) # Avaliar metrics = lstm.evaluate(X_test, y_test) print("\n=== Métricas LSTM ===") print(f"RMSE: {metrics['rmse']:.4f}") print(f"MAE: {metrics['mae']:.4f}") print(f"Acurácia de Direção: {metrics['direction_accuracy']:.2%}") ``` *** ## Comparando Modelos ### Pipeline Completo ```python # main.py import pandas as pd import numpy as np import matplotlib.pyplot as plt from src.data.fetcher import BrapiMLDataFetcher from src.features.technical import TechnicalFeatures from src.models.random_forest import RandomForestStockModel from src.models.lstm import LSTMStockModel def run_complete_pipeline(ticker: str, token: str): """Pipeline completo de ML para ações""" print(f"\n{'='*60}") print(f"MACHINE LEARNING PARA {ticker}") print(f"{'='*60}") # 1. Buscar dados print("\n[1/5] Buscando dados...") fetcher = BrapiMLDataFetcher(token) df = fetcher.get_stock_data(ticker, "5y") print(f" Registros: {len(df)}") print(f" Período: {df['date'].min()} a {df['date'].max()}") # 2. Feature engineering print("\n[2/5] Criando features...") df = TechnicalFeatures.add_all_features(df) print(f" Features criadas: {len(df.columns)}") # 3. Treinar Random Forest print("\n[3/5] Treinando Random Forest...") rf_model = RandomForestStockModel(n_estimators=200, max_depth=8) X, y, dates = rf_model.prepare_data(df) X_train, X_test, y_train, y_test, dates_test = rf_model.train_test_split_temporal(X, y, dates) rf_model.fit(X_train, y_train) rf_metrics = rf_model.evaluate(X_test, y_test) print(f" Accuracy: {rf_metrics['accuracy']:.4f}") print(f" F1 Score: {rf_metrics['f1']:.4f}") # 4. Treinar LSTM print("\n[4/5] Treinando LSTM...") lstm_model = LSTMStockModel(sequence_length=60, lstm_units=50) X_lstm, y_lstm = lstm_model.prepare_data(df[["close"]]) split = int(len(X_lstm) * 0.8) lstm_model.train(X_lstm[:split], y_lstm[:split], X_lstm[split:], y_lstm[split:], epochs=30) lstm_metrics = lstm_model.evaluate(X_lstm[split:], y_lstm[split:]) print(f" RMSE: {lstm_metrics['rmse']:.4f}") print(f" Acurácia Direção: {lstm_metrics['direction_accuracy']:.2%}") # 5. Comparação print("\n[5/5] Resumo Comparativo...") print(f""" ┌─────────────────────────────────────────────────┐ │ COMPARAÇÃO DE MODELOS │ ├─────────────────────────────────────────────────┤ │ Random Forest │ │ - Accuracy: {rf_metrics['accuracy']:.2%} │ │ - Precision: {rf_metrics['precision']:.2%} │ │ - F1 Score: {rf_metrics['f1']:.2%} │ │ │ │ LSTM │ │ - RMSE: {lstm_metrics['rmse']:.4f} │ │ - Acurácia Direção: {lstm_metrics['direction_accuracy']:.2%} │ └─────────────────────────────────────────────────┘ """) # Importância das features print("\n=== Top 10 Features (Random Forest) ===") importance = rf_model.get_feature_importance() print(importance.head(10).to_string(index=False)) return { "rf_metrics": rf_metrics, "lstm_metrics": lstm_metrics, "feature_importance": importance } def baseline_comparison(ticker: str, token: str): """Compara ML com estratégia baseline (buy and hold)""" fetcher = BrapiMLDataFetcher(token) df = fetcher.get_stock_data(ticker, "5y") # Buy and hold return buy_hold_return = (df["close"].iloc[-1] / df["close"].iloc[0] - 1) * 100 print(f"\n=== Baseline: Buy and Hold ===") print(f"Retorno total: {buy_hold_return:.2f}%") # Estratégia "sempre subir" (naive) df["naive_pred"] = 1 # sempre prevê alta df["actual"] = (df["close"].shift(-5) > df["close"]).astype(int) naive_accuracy = (df["naive_pred"] == df["actual"]).mean() print(f"\n=== Baseline: Sempre Prever Alta ===") print(f"Accuracy: {naive_accuracy:.2%}") return buy_hold_return, naive_accuracy if __name__ == "__main__": TOKEN = "seu_token_brapi" TICKER = "PETR4" # Comparar com baseline baseline_comparison(TICKER, TOKEN) # Pipeline completo results = run_complete_pipeline(TICKER, TOKEN) ``` *** ## Backtesting do Modelo ### Simulação de Trading ```python # src/evaluation/backtest_ml.py import pandas as pd import numpy as np def backtest_ml_model( model, df: pd.DataFrame, initial_capital: float = 100000, commission: float = 0.001, threshold: float = 0.6 # Confiança mínima para operar ) -> dict: """ Backtesta modelo de ML. Estratégia: - Compra quando modelo prevê alta com confiança > threshold - Vende quando modelo prevê baixa ou posição aberta há muito tempo """ # Preparar dados X, y, dates = model.prepare_data(df) split = int(len(X) * 0.8) # Treinar em dados de treino model.fit(X[:split], y[:split]) # Previsões no período de teste X_test = X[split:] y_test = y[split:] dates_test = dates[split:] predictions = model.predict(X_test) probas = model.predict_proba(X_test)[:, 1] # Probabilidade de alta # Simular trading capital = initial_capital position = 0 shares = 0 # Preços de fechamento do período de teste close_prices = df["close"].values[split + len(df) - len(X):][:len(predictions)] equity_curve = [] trades = [] for i in range(len(predictions)): price = close_prices[i] proba = probas[i] pred = predictions[i] # Decisão de trading if position == 0 and proba > threshold: # Comprar investment = capital * 0.95 # 95% do capital shares = int(investment / price) cost = shares * price * (1 + commission) capital -= cost position = 1 trades.append({ "type": "buy", "date": dates_test[i], "price": price, "shares": shares }) elif position == 1 and proba < (1 - threshold): # Vender revenue = shares * price * (1 - commission) capital += revenue trades.append({ "type": "sell", "date": dates_test[i], "price": price, "shares": shares, "pnl": revenue - (shares * trades[-1]["price"]) }) position = 0 shares = 0 # Calcular equity equity = capital + (shares * price if position == 1 else 0) equity_curve.append(equity) # Fechar posição aberta if position == 1: final_price = close_prices[-1] revenue = shares * final_price * (1 - commission) capital += revenue final_equity = capital # Calcular métricas total_return = (final_equity / initial_capital - 1) * 100 # Buy and hold para comparação buy_hold_return = (close_prices[-1] / close_prices[0] - 1) * 100 # Sharpe ratio returns = pd.Series(equity_curve).pct_change().dropna() sharpe = returns.mean() / returns.std() * np.sqrt(252) if returns.std() > 0 else 0 # Max drawdown peak = pd.Series(equity_curve).expanding().max() drawdown = (pd.Series(equity_curve) - peak) / peak max_dd = drawdown.min() * 100 return { "total_return": total_return, "buy_hold_return": buy_hold_return, "excess_return": total_return - buy_hold_return, "sharpe_ratio": sharpe, "max_drawdown": max_dd, "n_trades": len([t for t in trades if t["type"] == "buy"]), "final_equity": final_equity, "equity_curve": equity_curve } # Uso if __name__ == "__main__": from src.data.fetcher import BrapiMLDataFetcher from src.features.technical import TechnicalFeatures from src.models.random_forest import RandomForestStockModel fetcher = BrapiMLDataFetcher("seu_token") df = fetcher.get_stock_data("PETR4", "5y") df = TechnicalFeatures.add_all_features(df) model = RandomForestStockModel() results = backtest_ml_model(model, df, threshold=0.55) print("\n=== Backtest ML ===") print(f"Retorno Total: {results['total_return']:.2f}%") print(f"Buy & Hold: {results['buy_hold_return']:.2f}%") print(f"Excess Return: {results['excess_return']:.2f}%") print(f"Sharpe Ratio: {results['sharpe_ratio']:.2f}") print(f"Max Drawdown: {results['max_drawdown']:.2f}%") print(f"Número de Trades: {results['n_trades']}") ``` *** ## Por Que Modelos Falham ### Armadilhas Comuns ``` ┌─────────────────────────────────────────────────────────────┐ │ POR QUE ML FALHA EM AÇÕES │ ├─────────────────────────────────────────────────────────────┤ │ │ │ 1. OVERFITTING │ │ └─ Modelo memoriza padrões do passado │ │ └─ Não generaliza para novos dados │ │ └─ Solução: regularização, cross-validation temporal │ │ │ │ 2. DATA LEAKAGE │ │ └─ Usar informação futura no treino │ │ └─ Exemplo: normalizar antes de split │ │ └─ Solução: pipeline cuidadoso │ │ │ │ 3. REGIME CHANGES │ │ └─ Mercado muda ao longo do tempo │ │ └─ Modelo treinado em bull market falha em bear │ │ └─ Solução: retreino periódico, features adaptativas │ │ │ │ 4. SURVIVORSHIP BIAS │ │ └─ Dados não incluem empresas que faliram │ │ └─ Backtests otimistas │ │ └─ Solução: dados com delisted stocks │ │ │ │ 5. TRANSACTION COSTS │ │ └─ Ignorar corretagem, slippage, spread │ │ └─ Lucro vira prejuízo │ │ └─ Solução: simular custos realistas │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Quando ML Pode Ajudar | Caso de Uso | ML Útil? | Por Quê | | --------------------- | --------- | ------------------------------- | | Prever preço exato | ❌ Não | Muito ruído, imprevisível | | Classificar tendência | ⚠️ Talvez | \~55-60% é difícil de bater | | Selecionar ações | ✅ Sim | Ranking relativo funciona | | Detectar anomalias | ✅ Sim | Padrões incomuns | | Clustering de ativos | ✅ Sim | Agrupamento por características | | Análise de sentimento | ✅ Sim | NLP em notícias/redes sociais | *** ## Checklist de Boas Práticas ``` Antes de confiar no seu modelo: □ Usou split temporal (não aleatório)? □ Features não usam dados futuros? □ Testou em múltiplos ativos? □ Comparou com baseline simples? □ Incluiu custos de transação? □ Fez walk-forward validation? □ Modelo é simples o suficiente? □ Resultados fazem sentido econômico? □ Testou em diferentes regimes de mercado? □ Tem margem de segurança nos resultados? ``` *** ## Conclusão Machine Learning pode ser uma ferramenta útil para análise de ações, mas: 1. **Não é mágica** - mercado é difícil de prever 2. **Baseline é rei** - compare sempre com buy-and-hold 3. **Simplicidade vence** - modelos complexos tendem a overfitar 4. **Features importam mais** - garbage in, garbage out 5. **Custos matam** - simule transações realistas **Use ML como complemento, não substituto, de análise fundamentalista e gestão de risco.** *** ## Próximos Passos * **[Cadastre-se na brapi](https://brapi.dev)** para acessar dados * **[Backtesting tradicional](/blog/backtesting-estrategias-python-brapi-guia-completo)** para comparar * **[Análise técnica](/blog/analise-tecnica-suportes-resistencias-medias-moveis)** para features * **[Stock screener](/blog/stock-screener-python-brapi-filtrar-acoes)** para selecionar ativos *** *Este artigo tem caráter educacional. Machine Learning não garante resultados. Sempre faça sua própria análise.* # Magic Formula de Joel Greenblatt: Como Aplicar no Brasil em 2026 URL: /blog/magic-formula-joel-greenblatt-brasil-2026.mdx Aprenda a aplicar a Magic Formula de Joel Greenblatt no mercado brasileiro. Calculadora, código Python, ranking de ações e resultados históricos. *** searchable: true title: 'Magic Formula de Joel Greenblatt: Como Aplicar no Brasil em 2026' description: 'Aprenda a aplicar a Magic Formula de Joel Greenblatt no mercado brasileiro. Calculadora, código Python, ranking de ações e resultados históricos.' date: '2026-01-01' keywords: 'magic formula, joel greenblatt, magic formula brasil, formula magica acoes, roic, earnings yield, value investing, acoes baratas, investimento em valor, 2026' author: 'Equipe brapi.dev' category: 'Análise Fundamentalista' subcategory: 'Estratégias de Investimento' readingTime: '16 min' tags: \['Magic Formula', 'Value Investing', 'Joel Greenblatt', 'ROIC', 'Earnings Yield', 'Análise Fundamentalista'] relatedPosts: \['value-investing-como-encontrar-acoes-baratas', 'formula-graham-como-calcular-preco-justo-acoes-value-investing', 'metodo-bazin-estrategia-renda-passiva-acoes-dividendos', 'guia-completo-indicadores-fundamentalistas-bovespa'] featured: true expertise: 'Guia desenvolvido por especialistas em análise fundamentalista e value investing' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; A **Magic Formula** (Fórmula Mágica) é uma das estratégias de value investing mais simples e eficazes já desenvolvidas. Criada por **Joel Greenblatt** e apresentada no livro "The Little Book That Beats The Market" (2005), essa metodologia busca identificar **ações de empresas boas a preços baratos** usando apenas dois indicadores fundamentalistas. Neste guia completo, você vai aprender como a Magic Formula funciona, como adaptá-la ao mercado brasileiro, e como automatizar a busca por ações usando a [API da brapi.dev](https://brapi.dev). ## O Que é a Magic Formula? A Magic Formula é uma estratégia quantitativa que combina dois critérios fundamentais: 1. **Earnings Yield (Rendimento dos Lucros)**: Identifica ações baratas em relação aos lucros 2. **ROIC (Retorno sobre Capital Investido)**: Identifica empresas de qualidade A ideia é simples: **comprar boas empresas (alto ROIC) a preços baixos (alto Earnings Yield)**. ### Por Que Funciona? Joel Greenblatt testou a estratégia com dados de 17 anos (1988-2004) e descobriu que: * A Magic Formula superou o S\&P 500 em **96% dos períodos de 3 anos** * Retorno médio anual: **30,8%** vs 12,4% do S\&P 500 * Funcionou mesmo considerando custos de transação e impostos | Período | Magic Formula | S\&P 500 | Diferença | | ------- | -------------- | -------- | --------- | | 1 ano | Superou em 83% | Base | +18% | | 2 anos | Superou em 89% | Base | +24% | | 3 anos | Superou em 96% | Base | +30% | ## Os Dois Indicadores da Magic Formula ### 1. Earnings Yield (EY) O Earnings Yield mede quanto a empresa lucra em relação ao seu preço de mercado: ``` Earnings Yield = EBIT / Enterprise Value ``` Onde: * **EBIT**: Lucro antes de juros e impostos * **Enterprise Value (EV)**: Valor de mercado + Dívida líquida **Por que usar EV ao invés de Preço?** O Enterprise Value considera a estrutura de capital completa da empresa, tornando a comparação mais justa entre empresas com diferentes níveis de endividamento. ### 2. ROIC (Return on Invested Capital) O ROIC mede a eficiência da empresa em gerar lucros com o capital investido: ``` ROIC = EBIT / Capital Investido Capital Investido = Capital de Giro Líquido + Ativos Fixos ``` **Por que ROIC ao invés de ROE?** O ROIC não é afetado pela alavancagem financeira, mostrando a verdadeira eficiência operacional da empresa. ## Como Aplicar a Magic Formula ### Passo a Passo Original 1. **Calcule o Earnings Yield** de todas as ações do mercado 2. **Calcule o ROIC** de todas as ações 3. **Ranqueie** as ações do maior para o menor EY (1º lugar = maior EY) 4. **Ranqueie** as ações do maior para o menor ROIC (1º lugar = maior ROIC) 5. **Some as posições** de cada ação nos dois rankings 6. **Selecione as 20-30 ações** com menor soma (melhor classificação combinada) 7. **Mantenha por 1 ano** e rebalanceie ### Filtros Adicionais (Recomendados) Greenblatt recomenda excluir: * Empresas financeiras (bancos, seguradoras, holdings) * Utilities (empresas de serviços públicos) * ADRs e empresas estrangeiras * Empresas com valor de mercado muito pequeno ## Implementação com Python e brapi.dev Vamos criar uma implementação completa da Magic Formula para o mercado brasileiro: ```typescript // 1. Listar ações disponíveis const listaResponse = await fetch( 'https://brapi.dev/api/quote/list?type=stock&limit=200', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) // 2. Obter dados fundamentalistas para cada ação const dadosResponse = await fetch( 'https://brapi.dev/api/quote/PETR4,VALE3,WEGE3?modules=defaultKeyStatistics,financialData,summaryProfile', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const { results } = await dadosResponse.json() // Calcular Earnings Yield e ROIC para ranking ``` ### Cálculo dos Indicadores **Earnings Yield (EY):** ``` EY = EBIT / Enterprise Value ``` * Quanto maior, mais barata a ação em relação aos lucros operacionais * Similar ao inverso do P/L, mas usando EBIT ao invés de lucro líquido **ROIC (Return on Invested Capital):** ``` ROIC = NOPAT / Capital Investido ``` * Mede a eficiência da empresa em gerar retorno sobre o capital investido * Quanto maior, melhor a qualidade do negócio ### Metodologia do Ranking 1. **Ranquear por EY:** Ordenar todas as ações do maior para menor EY (posição 1 = maior EY) 2. **Ranquear por ROIC:** Ordenar todas as ações do maior para menor ROIC (posição 1 = maior ROIC) 3. **Somar os rankings:** Rank Total = Rank EY + Rank ROIC 4. **Ordenar pelo total:** Menor Rank Total = Melhor posição ### Exemplo de Ranking Magic Formula | Pos | Ticker | Nome | EY | ROIC | Rank EY | Rank ROIC | Total | | --- | ------ | -------- | ----- | ----- | ------- | --------- | ----- | | 1 | WEGE3 | WEG S.A. | 8,5% | 28,0% | 15 | 2 | 17 | | 2 | PRIO3 | PetroRio | 18,0% | 22,0% | 3 | 8 | 11 | | 3 | CSAN3 | Cosan | 12,0% | 18,5% | 8 | 12 | 20 | | 4 | SBSP3 | Sabesp | 15,0% | 15,0% | 5 | 18 | 23 | | 5 | RENT3 | Localiza | 9,0% | 19,0% | 12 | 10 | 22 | *Valores ilustrativos - execute a análise para dados atualizados* ### Critérios de Filtro Recomendados | Filtro | Valor Sugerido | Motivo | | ----------------------- | -------------- | ------------------------------ | | **Market Cap mínimo** | R$ 1 bilhão | Liquidez adequada | | **Excluir financeiros** | Sim | Estrutura de capital diferente | | **Excluir utilities** | Sim | Regulação afeta ROIC | | **EY mínimo** | > 0 | Empresas lucrativas | | **ROIC mínimo** | > 0 | Empresas eficientes | ## Entendendo os Resultados ### Interpretação do Ranking | Posição | Interpretação | | ------- | ----------------------------------------------- | | 1-10 | Melhores candidatos - combina qualidade e preço | | 11-20 | Muito bons - segunda linha de oportunidades | | 21-30 | Bons - considerar se os primeiros não agradarem | ### O Que os Números Significam **Earnings Yield Alto (>15%):** * Empresa está barata em relação aos lucros * Pode indicar oportunidade ou problema estrutural **ROIC Alto (>20%):** * Empresa eficiente no uso do capital * Vantagem competitiva provável * Barreira de entrada no setor **Rank Total Baixo:** * Melhor combinação de qualidade + preço * Quanto menor, melhor ## Adaptações para o Brasil ### Desafios do Mercado Brasileiro 1. **Menor liquidez**: Algumas ações podem ser difíceis de negociar 2. **Volatilidade cambial**: Afeta empresas exportadoras/importadoras 3. **Juros altos**: Competição com renda fixa 4. **Concentração setorial**: Muitas empresas em commodities e bancos ### Ajustes Recomendados #### Filtros Adicionais para o Brasil | Filtro | Valor Sugerido | Motivo | | -------------------------------- | -------------- | ----------------------------------- | | **Market Cap mínimo** | R$ 1 bilhão | Garantir liquidez | | **Volume diário mínimo** | R$ 1 milhão | Facilidade de entrada/saída | | **Dívida Líquida/EBITDA máximo** | 3x | Evitar empresas muito endividadas | | **Excluir estatais** | Opcional | Governança e interferência política | | **Excluir financeiros** | Sim | Estrutura de capital diferente | | **Considerar dividendos** | Sim | Complementar análise de qualidade | **Processo de filtragem:** 1. Aplicar Magic Formula básica para top 50 2. Filtrar por volume diário (liquidez) 3. Filtrar por endividamento (segurança) 4. Resultado final: top 30 ações ## Backtest: Resultados Históricos no Brasil ### Metodologia Para avaliar a eficácia da Magic Formula no Brasil, analisamos dados históricos: ```typescript // Obter dados históricos para análise de performance const response = await fetch( 'https://brapi.dev/api/quote/WEGE3,PRIO3,CSAN3?range=1y&interval=1mo', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const { results } = await response.json() // Calcular retorno de cada ação no período ``` #### Métricas de Performance da Carteira | Métrica | Como Calcular | Interpretação | | ----------------- | ------------------------------ | ----------------- | | **Retorno médio** | Média dos retornos individuais | Performance geral | | **Acertos** | Ações com retorno > 0 | Taxa de sucesso | | **Melhor ação** | Maior retorno individual | Outlier positivo | | **Pior ação** | Menor retorno individual | Outlier negativo | ### Resultados Típicos | Período | Magic Formula BR | Ibovespa | Diferença | | ------- | ---------------- | -------- | ------------ | | 1 ano | +18% a +35% | +12% | +6% a +23% | | 3 anos | +45% a +90% | +35% | +10% a +55% | | 5 anos | +80% a +180% | +60% | +20% a +120% | *Resultados variam conforme o período analisado e critérios de seleção* ## Pontos de Atenção ### Limitações da Magic Formula 1. **Value Traps**: Ações baratas por bons motivos (problemas estruturais) 2. **Timing**: Pode demorar 2-3 anos para resultados 3. **Setores excluídos**: Pode perder oportunidades em bancos e utilities 4. **Dados contábeis**: Dependem da qualidade das demonstrações financeiras ### Como Mitigar Riscos | Risco | Mitigação | | ------------ | ----------------------------------- | | Value trap | Analisar qualitativamente as top 10 | | Concentração | Diversificar com 20-30 ações | | Liquidez | Estabelecer volume mínimo | | Timing | Manter horizonte de 3+ anos | ## Checklist de Implementação ### Antes de Investir * [ ] Confirmar que entende a metodologia * [ ] Definir critérios de filtro (market cap, liquidez) * [ ] Estabelecer tamanho da carteira (20-30 ações) * [ ] Decidir frequência de rebalanceamento (anual) * [ ] Calcular aporte por ação ### Análise Qualitativa Adicional Para as top 10 do ranking, verificar: * [ ] Notícias recentes (escândalos, processos) * [ ] Mudanças na gestão * [ ] Perspectivas do setor * [ ] Endividamento * [ ] Concentração de receita ### Execução * [ ] Comprar em lotes para reduzir impacto * [ ] Documentar preços e datas * [ ] Monitorar trimestralmente (sem trading) * [ ] Rebalancear anualmente * [ ] Registrar resultados para aprendizado ## Comparação com Outras Estratégias ### Magic Formula vs Fórmula de Graham | Aspecto | Magic Formula | Graham | | ------------------ | ----------------- | --------------------------- | | **Foco** | Qualidade + Preço | Preço (margem de segurança) | | **Indicadores** | ROIC, EY | P/L, P/VP, DY | | **Complexidade** | Média | Baixa | | **Turnover** | Anual | Quando atingir preço-alvo | | **Diversificação** | 20-30 ações | 10-30 ações | ### Magic Formula vs Método Bazin | Aspecto | Magic Formula | Bazin | | ---------------- | ------------- | ------------------ | | **Foco** | Crescimento | Dividendos | | **Indicadores** | ROIC, EY | DY, Payout, Dívida | | **Objetivo** | Valorização | Renda passiva | | **Perfil ideal** | Acumulação | Viver de renda | ## Ferramentas e Recursos ### Automatização com brapi.dev A [API da brapi.dev](https://brapi.dev) oferece todos os dados necessários para implementar a Magic Formula: ```typescript // Endpoints úteis para Magic Formula // 1. Lista de ações const lista = await fetch('https://brapi.dev/api/quote/list?type=stock') // 2. Dados fundamentalistas const dados = await fetch( 'https://brapi.dev/api/quote/PETR4?modules=defaultKeyStatistics,financialData' ) // 3. Dados históricos para backtest const historico = await fetch('https://brapi.dev/api/quote/PETR4?range=1y&interval=1mo') // 4. Múltiplas ações de uma vez const multiplas = await fetch( 'https://brapi.dev/api/quote/PETR4,VALE3,ITUB4?modules=defaultKeyStatistics' ) ``` ### Planilha de Acompanhamento #### Formato de Exportação CSV | Coluna | Exemplo | Descrição | | ---------- | -------------- | -------------------------- | | Posição | 1 | Ranking final | | Ticker | WEGE3 | Símbolo da ação | | Nome | WEG S.A. | Nome da empresa | | Setor | Industrials | Setor de atuação | | EY% | 8.50 | Earnings Yield | | ROIC% | 28.00 | Return on Invested Capital | | Rank EY | 15 | Posição no ranking de EY | | Rank ROIC | 2 | Posição no ranking de ROIC | | Rank Total | 17 | Soma dos rankings | | Preço | 42.50 | Preço atual | | Market Cap | 50,000,000,000 | Valor de mercado | **Dica:** Exporte para planilha para acompanhamento e análise qualitativa adicional. ## Perguntas Frequentes ### Posso usar a Magic Formula com ações de bancos? Greenblatt recomenda excluir financeiras porque os indicadores ROIC e EV são difíceis de calcular para essas empresas. No entanto, alguns investidores adaptam a fórmula usando ROE e P/L para bancos. ### Qual o tamanho mínimo da carteira? Greenblatt sugere 20-30 ações para diversificação adequada. Com menos ações, o risco individual aumenta significativamente. ### Com que frequência devo rebalancear? Anualmente é o padrão. Rebalancear com mais frequência gera custos de transação e impostos sem benefício comprovado. ### A Magic Formula funciona em mercados emergentes? Estudos mostram resultados positivos em diversos mercados, incluindo Brasil. No entanto, a volatilidade tende a ser maior. ### Devo vender se uma ação cair muito? Não necessariamente. A estratégia é baseada em manter por um ano. Quedas podem representar oportunidades de compra adicional (se ainda estiver no ranking). ## Conclusão A Magic Formula de Joel Greenblatt é uma estratégia simples, testada e eficaz para identificar boas empresas a preços atrativos. Para o mercado brasileiro, recomendamos: 1. **Usar filtros adicionais**: Liquidez, endividamento, governança 2. **Diversificar adequadamente**: 20-30 ações 3. **Manter horizonte longo**: Mínimo 3 anos 4. **Analisar qualitativamente**: As top 10 do ranking 5. **Automatizar o processo**: Com a [API da brapi.dev](https://brapi.dev) A combinação de análise quantitativa (Magic Formula) com qualitativa (revisão das melhores) oferece o melhor dos dois mundos para o investidor brasileiro. *** *Disclaimer: Este conteúdo é educacional e não constitui recomendação de investimento. Resultados passados não garantem resultados futuros.* # Magic Number nos Investimentos: O Segredo dos Juros Compostos URL: /blog/magic-number-investimentos-juros-compostos-2026.mdx Descubra o Magic Number nos investimentos: o ponto onde seus dividendos compram novas ações sozinhos ✓ *** searchable: true title: 'Magic Number nos Investimentos: O Segredo dos Juros Compostos' description: 'Descubra o Magic Number nos investimentos: o ponto onde seus dividendos compram novas ações sozinhos ✓' date: '2025-12-31' keywords: 'magic number investimentos, juros compostos, bola de neve financeira, viver de dividendos, liberdade financeira, cálculo magic number' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Estratégia' readingTime: '10 min' tags: \['Juros Compostos', 'Dividendos', 'Magic Number', 'Liberdade Financeira'] relatedPosts: \['onde-investir-2026-guia-completo-melhores-investimentos', 'como-calcular-rendimento-investimentos-guia-completo-2026'] featured: false expertise: 'Conceito matemático de aceleração de patrimônio' lastReviewed: '2026-02-12' -------------------------- import { Authors, Author } from '~/components/Authors'; Existe um momento na jornada de todo investidor que muda tudo. É o momento em que você para de empurrar a bola de neve ladeira acima, e ela começa a rolar sozinha, crescendo exponencialmente. Esse momento tem nome: **Magic Number (Número Mágico)**. Em 2026, se o seu objetivo é viver de renda, você não deve focar apenas em "ficar rico". Você deve focar em atingir o seu Magic Number. *** ## O Que é o Magic Number? É a quantidade exata de cotas (de um FII) ou ações que você precisa ter para que **os dividendos mensais pagos por elas sejam suficientes para comprar UMA nova cota/ação do mesmo ativo**. A partir desse ponto, o investimento se retroalimenta. * Mês 1: Dividendos compram 1 cota extra. * Mês 2: Você tem mais cotas, recebe mais dividendos -> compra 1,1 cotas. * Mês 12: Dividendos compram 2 cotas extras. Isso, somado aos seus aportes mensais do bolso, cria a verdadeira **Bola de Neve**. *** ## Como Calcular? A fórmula é simples: **Magic Number = Preço da Cota / Dividendo por Cota** ### Exemplo Prático: Fundo Imobiliário (FII) Vamos usar um FII fictício "BRP11": * **Preço da Cota:** R$ 10,00 * **Dividendo Mensal:** R$ 0,10 (Yield de 1,0% a.m.) **Magic Number = 10,00 / 0,10 = 100 cotas** **Interpretação:** Quando você tiver **100 cotas** de BRP11: 1. Você receberá 100 \* R$ 0,10 = **R$ 10,00** de dividendos. 2. Com esses R$ 10,00, você compra **mais 1 cota** sem tirar dinheiro do bolso. 3. Agora você tem 101 cotas. No mês seguinte, receberá R$ 10,10. *** ## O Poder Psicológico O início dos investimentos é chato. Você junta, junta, e o rendimento paga uma bala. O Magic Number é uma meta tangível. * "Minha meta não é ter 1 milhão. Minha meta é chegar em 100 cotas de MXRF11". * Depois 150 cotas de HGLG11. Cada Magic Number atingido é uma pequena máquina de dinheiro que você construiu e que agora trabalha sozinha. *** ## Aceleração da Curva (Juros Compostos) Até o Magic Number, o esforço é 90% aporte (suor) e 10% rentabilidade. Depois do Magic Number, a proporção começa a inverter. Em 10-15 anos, a rentabilidade (dividendos reinvestidos) será responsável por mais crescimento do seu patrimônio do que o dinheiro que sai do seu salário. *** ## Conclusão Não desanime se os resultados parecerem pequenos hoje. Calcule o Magic Number dos seus ativos favoritos. Foque em atingir essa meta de quantidade. Quando você chegar lá, a física dos juros compostos estará a seu favor. Em 2026, construa sua bola de neve. # Marcação a Mercado no Tesouro Direto com Python: Medindo o Risco de Vender Antes do Vencimento (2026) URL: /blog/marcacao-a-mercado-tesouro-direto-python-api.mdx Marcação a mercado Tesouro Direto explicada com dados reais via API: meça drawdown, volatilidade e sensibilidade do preço em dez linhas de Python. *** searchable: true title: 'Marcação a Mercado no Tesouro Direto com Python: Medindo o Risco de Vender Antes do Vencimento (2026)' description: 'Marcação a mercado Tesouro Direto explicada com dados reais via API: meça drawdown, volatilidade e sensibilidade do preço em dez linhas de Python.' date: '2026-05-17' keywords: 'marcacao a mercado tesouro direto, marcação a mercado tesouro direto explicação simples, tesouro prefixado risco vender antes do vencimento, tesouro prefixado drawdown, tesouro ipca volatilidade, brapi tesouro direto python, api tesouro direto historico, api brapi histórico taxa tesouro direto, calcular drawdown tesouro direto python, sellPrice tesouro, duration tesouro direto, duration tesouro direto exemplo, curva de juros brasil python, volatilidade diária tesouro direto, sensibilidade preço taxa tesouro, tesouro selic sem marcação, beta taxa preço tesouro, ipca+ 2060 drawdown, prefixado 2037 análise' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Renda Fixa' readingTime: '14 min' tags: \['Python', 'Tesouro Direto', 'Renda Fixa', 'Marcação a Mercado', 'API', 'Duration', 'Curva de Juros', 'Volatilidade', 'Risco', 'Brasil'] relatedPosts: \['tesouro-direto-guia-completo-2026-como-investir', 'cdi-historico-api-renda-fixa-benchmark-2026', 'api-macroeconomia-brasil-bcb-indicadores-2026'] featured: true expertise: 'Análise de marcação a mercado em títulos públicos com dados diários da brapi.dev' lastReviewed: '2026-05-17' howToTools: * 'Conta brapi.dev (plano Pro) com token Bearer' * 'Python 3.10+ com requests, pandas e matplotlib' * 'Endpoint /api/v2/treasury/indicators/history' howToSteps: * name: 'Gere o token brapi' text: 'Crie uma conta brapi.dev no plano Pro e copie o token Bearer no painel.' * name: 'Baixe o histórico de taxas e preços' text: 'GET /api/v2/treasury/indicators/history?symbols=...\&startDate=...\&endDate=... retorna a série diária com buyRate, sellRate, buyPrice, sellPrice e basePrice.' * name: 'Interprete o rateInfo' text: 'Para Tesouro Selic a taxa é spread sobre a Selic; para Prefixado é nominal % a.a.; para IPCA+ é real % a.a. acima do IPCA. Sempre confira rateInfo.rateType antes de comparar números.' * name: 'Calcule a marcação' text: 'Use sellPrice como preço de saída antecipada e meça drawdown, desvio-padrão diário e a sensibilidade preço/taxa para entender o risco real do título.' * name: 'Compare com o Tesouro Selic' text: 'A mesma rotina aplicada ao Tesouro Selic mostra volatilidade ordens de magnitude menor — esse é o "controle" de risco-zero da carteira.' faqSchema: * question: 'O que é marcação a mercado Tesouro Direto explicação simples?' answer: 'Marcação a mercado é quanto o seu título vale agora se você vender hoje, antes do vencimento. O preço sobe e desce todo dia, mesmo o título sendo do governo. Quem segura até o fim recebe a taxa contratada. Quem vende antes pega o preço do dia, que pode ser maior ou menor que o de compra.' * question: 'Tesouro prefixado risco vender antes do vencimento: quanto posso perder?' answer: 'Nos nossos testes, o Tesouro Prefixado 2037 caiu 3,63% em dez pregões sem nenhuma crise. Cada subida de 1 ponto percentual na taxa derruba o preço em cerca de 5,42% no mesmo dia. Se você vender no fundo, esse desconto vira prejuízo de verdade.' * question: 'Como calcular drawdown tesouro direto python passo a passo?' answer: 'Baixe a série diária do sellPrice pela API brapi, calcule o máximo acumulado com cummax() e divida o preço atual por esse máximo menos 1. O mínimo dessa razão é o drawdown (maior mergulhada de preço). O post traz a função max\_drawdown pronta para copiar.' * question: 'Como usar a api brapi histórico taxa tesouro direto?' answer: 'Chame GET /api/v2/treasury/indicators/history passando symbols, startDate e endDate. A resposta tem o histórico diário com sellRate (taxa de venda), sellPrice (preço de saída antecipada) e rateInfo, que explica como ler a taxa para cada tipo de título.' * question: 'Duration tesouro direto exemplo: por que prazo longo balança mais?' answer: 'Duration é a duração média até você receber seu dinheiro de volta. O IPCA+ 2060 tem prazo de 35 anos e variou 11,79% por ponto percentual de taxa. O Prefixado 2037 (11 anos) variou só 5,42%. Quanto maior o prazo, maior o balanço diário do preço.' *** import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > Vender um Tesouro Prefixado antes do vencimento pode dar prejuízo > nominal — mesmo quando "a Selic está subindo". É a marcação a mercado em > ação. Neste post você mede o efeito em dez linhas de Python, usando o > endpoint `/api/v2/treasury/indicators/history` da brapi. A **marcação a mercado Tesouro Direto** (quanto o título vale agora se você vender hoje, antes do vencimento) pega muita gente de surpresa. Quem comprou Tesouro Prefixado 2037 no começo de fevereiro de 2026 pagou R$ 815. Poucas semanas depois, o preço caiu para R$ 795. Isso é uma queda de **3,63%** — a "maior mergulhada" do período. E nada de grave aconteceu na economia. No mesmo intervalo, quem ficou com o Tesouro Selic 2031 viu o preço subir devagar e sem sustos. A diferença tem nome. Este guia mostra, passo a passo, como medir esse risco com dados diários da API da brapi.dev e um pouco de Python. *** ## O que é marcação a mercado Quando você compra um título prefixado, **trava uma taxa** com o Tesouro. Por exemplo, 13,68% ao ano até o vencimento. Esse acordo não muda. O que muda todo dia é o **preço de revenda** desse acordo. Se o mercado começa a pedir uma taxa mais alta para emprestar o mesmo prazo (sobe para 14,5%), o seu papel de 13,68% perde valor. Ninguém quer pagar caro por algo que rende menos do que o atual. O Tesouro, ao recomprar antes do prazo, ajusta o preço com a taxa nova. Por isso o preço cai. A regra é simples e mecânica: | Movimento na curva | Efeito no preço | | ------------------------ | -------------------------------- | | Taxa **sobe** | Preço **cai** | | Taxa **cai** | Preço **sobe** | | Quanto **maior o prazo** | Maior a sensibilidade (duration) | Duration é a **duração média** (quanto tempo, em média, demora pra você receber de volta o seu dinheiro). Prazo longo balança mais. Prazo curto balança pouco. Se você ignora o preço diário e segura o título até o vencimento, recebe exatamente a taxa contratada. A marcação a mercado só "machuca" quem vende antes — e só "premia" quem compra na baixa. Para te ajudar a decidir se a marcação importa para a sua estratégia, use esta árvore rápida: B{"Vou segurar até o vencimento?"} B -- "Sim" --> C["Pode ignorar a marcação
Recebe a taxa contratada"] B -- "Não, posso vender antes" --> D{"Qual o indexador?"} D -- "Selic" --> E["Preço sobe devagar
Risco quase zero"] D -- "Prefixado" --> F["Risco médio
Ver duration e curva"] D -- "IPCA+" --> G["Risco alto se prazo longo
Ver duration"] `} /> *Decisão rápida: se você não vai vender antes, pode esquecer a marcação a mercado.* *** ## Pré-requisitos * Conta [brapi.dev](https://brapi.dev) no plano **Pro** (Tesouro Direto detalhado é Pro). Os três títulos sandbox (`tesouro-selic-01032031`, `tesouro-prefixado-com-juros-semestrais-01012037`, `tesouro-ipca-com-juros-semestrais-15082060`) respondem mesmo sem token, ótimos para reproduzir este tutorial. * Python 3.10+ com: ```bash pip install requests pandas matplotlib ``` * Token salvo em `BRAPI_TOKEN` no ambiente: ```bash export BRAPI_TOKEN=seu_token_aqui ``` *** ## Endpoint base O ponto de entrada deste post é [`/api/v2/treasury/indicators/history`](/docs/tesouro-direto/indicadores-historico). Ele devolve, dia a dia, as taxas e os preços de cada título: ```bash curl "https://brapi.dev/api/v2/treasury/indicators/history?\ symbols=tesouro-prefixado-com-juros-semestrais-01012037&\ startDate=2026-02-01&endDate=2026-05-15&sortOrder=asc" \ -H "Authorization: Bearer $BRAPI_TOKEN" ``` Resposta (resumida): ```json { "results": [ { "symbol": "tesouro-prefixado-com-juros-semestrais-01012037", "bondType": "Tesouro Prefixado com Juros Semestrais", "indexer": "prefixado", "couponType": "semestral", "maturityDate": "2037-01-01", "rateInfo": { "rateType": "nominalAnnualRate", "rateUnit": "% a.a.", "description": "Para Tesouro Prefixado, buyRate e sellRate representam a taxa nominal anual contratada." }, "history": [ { "baseDate": "2026-02-02", "buyRate": 13.56, "sellRate": 13.68, "buyPrice": 820.97, "sellPrice": 815.06, "basePrice": 815.06 }, { "baseDate": "2026-05-15", "buyRate": 14.36, "sellRate": 14.48, "buyPrice": 814.75, "sellPrice": 809.22, "basePrice": 809.22 } ] } ], "requestedAt": "2026-05-17T23:29:20.468Z", "took": 169 } ``` `buyRate` e `sellRate` mudam de significado por indexador. Em **Selic** são o *spread sobre a Selic* (valor cobrado a mais ou de menos em cima do preço base, não a rentabilidade total). Em **Prefixado** são a taxa nominal. Em **IPCA+** são a taxa real acima da inflação. Antes de comparar números, leia `rateInfo.rateType` — a brapi devolve esse metadado em toda resposta justamente para evitar confusão. *** ## Baixando o histórico em Python Vamos criar uma função que recebe `symbol`, `start`, `end` e devolve a lista de observações diárias. Dá pra reusar para qualquer título: ```python import os import requests BASE = "https://brapi.dev/api/v2/treasury" TOKEN = os.getenv("BRAPI_TOKEN") HEADERS = {"Authorization": f"Bearer {TOKEN}"} if TOKEN else {} def fetch_history(symbol: str, start: str, end: str) -> list[dict]: """Histórico diário de taxas e preços para um título do Tesouro Direto.""" response = requests.get( f"{BASE}/indicators/history", params={ "symbols": symbol, "startDate": start, "endDate": end, "sortOrder": "asc", }, headers=HEADERS, timeout=30, ) response.raise_for_status() return response.json()["results"][0]["history"] ``` Agora puxamos três séries — Prefixado longo, IPCA+ longo e Selic — e montamos um `DataFrame` pra cada uma: ```python import pandas as pd START, END = "2025-01-01", "2026-05-15" pre = pd.DataFrame(fetch_history( "tesouro-prefixado-com-juros-semestrais-01012037", START, END, )) ipca = pd.DataFrame(fetch_history( "tesouro-ipca-com-juros-semestrais-15082060", START, END, )) selic = pd.DataFrame(fetch_history( "tesouro-selic-01032031", START, END, )) for df in (pre, ipca, selic): df["baseDate"] = pd.to_datetime(df["baseDate"]) df.set_index("baseDate", inplace=True) print(pre[["sellRate", "sellPrice"]].head()) print(pre[["sellRate", "sellPrice"]].tail()) ``` Saída real: ``` sellRate sellPrice baseDate 2026-02-02 13.68 815.06 2026-02-03 13.65 816.85 2026-02-04 13.75 812.71 2026-02-05 13.75 813.13 2026-02-06 13.76 813.09 sellRate sellPrice baseDate 2026-05-11 14.31 811.34 2026-05-12 14.40 808.83 2026-05-13 14.36 810.16 2026-05-14 14.36 809.49 2026-05-15 14.48 809.22 ``` Olha o que acontece: a `sellRate` foi de 13,58% a 14,48% no período, e o `sellPrice` foi pro lado oposto. Esse é o jeito mais simples de ver a marcação a mercado funcionando. *** ## Plotando a marcação do Prefixado 2037 ```python import matplotlib.pyplot as plt fig, ax_price = plt.subplots(figsize=(10, 5)) ax_rate = ax_price.twinx() ax_price.plot(pre.index, pre["sellPrice"], color="#0F62FE", label="sellPrice (R$)") ax_rate.plot(pre.index, pre["sellRate"], color="#DA1E28", label="sellRate (% a.a.)") ax_price.set_ylabel("Preço de venda (R$)", color="#0F62FE") ax_rate.set_ylabel("Taxa (% a.a.)", color="#DA1E28") ax_price.set_title("Tesouro Prefixado 2037 — preço × taxa") fig.tight_layout() plt.savefig("prefixado_2037.png", dpi=120) ``` O gráfico mostra duas linhas espelhadas. Quando a taxa de venda sobe, o preço cai. A ligação entre a **variação da taxa em pontos percentuais** e a **variação do preço** é quase perfeita: ```python import numpy as np delta_rate = pre["sellRate"].diff().dropna() # variação em p.p. delta_price = pre["sellPrice"].pct_change().dropna() # variação relativa corr = np.corrcoef(delta_rate, delta_price)[0, 1] beta = np.cov(delta_rate, delta_price, ddof=0)[0, 1] / delta_rate.var(ddof=0) print(f"correlação ΔsellRate × ΔsellPrice: {corr:.3f}") print(f"beta: +1 p.p. na taxa → {beta*100:.2f}% no preço") ``` Saída real: ``` correlação ΔsellRate × ΔsellPrice: -1.000 beta: +1 p.p. na taxa → -5.42% no preço ``` Lendo em português claro: **cada 1 ponto a mais na taxa de venda derruba o preço do Prefixado 2037 em mais ou menos 5,42% no mesmo dia**. Esse é o efeito da duration aparecendo nos dados. Para o IPCA+ 2060, que tem prazo muito maior, o número sobe pra **-11,79% por p.p.** Veja na seção dele. *** ## Quantificando o drawdown Drawdown é a **queda máxima de preço entre um pico e o próximo fundo (a maior "mergulhada")**. Quanto mais fundo, mais dor para quem precisou vender no pior momento. ```python def max_drawdown(series: pd.Series) -> tuple[float, pd.Timestamp, pd.Timestamp]: cummax = series.cummax() drawdown = series / cummax - 1 trough = drawdown.idxmin() peak = series.loc[:trough].idxmax() return drawdown.min(), peak, trough dd, peak, trough = max_drawdown(pre["sellPrice"]) print(f"max drawdown Prefixado 2037: {dd*100:.2f}%") print(f"pico {peak.date()} → fundo {trough.date()}") ``` Saída real: ``` max drawdown Prefixado 2037: -3.63% pico 2026-02-25 → fundo 2026-03-09 ``` Em **dez pregões** o preço caiu 3,63%. Quem precisou vender nessa janela perdeu, em dinheiro nominal, mais do que vários meses do CDI rendendo junto. O pior dia isolado foi este: | Data | Δ sellRate | Δ sellPrice | | ---------- | -------------------------- | ---------------------------- | | 2026-03-19 | +0,37 p.p. (13,94 → 14,31) | **-1,93%** (815,92 → 800,16) | E o melhor dia (2026-03-10) foi o oposto: | Data | Δ sellRate | Δ sellPrice | | ---------- | -------------------------- | ---------------------------- | | 2026-03-10 | -0,40 p.p. (14,33 → 13,93) | **+2,25%** (795,91 → 813,83) | É esse vai-e-volta que define um título marcado a mercado. Ele sobe ou desce mais de 2% num pregão só, sem nenhum acontecimento extraordinário na economia. É só a curva se mexendo. *** ## Por que Tesouro Selic não sofre Vamos rodar a mesma rotina no `tesouro-selic-01032031`: ```python dd_sel, _, _ = max_drawdown(selic["sellPrice"]) ret_sel = selic["sellPrice"].pct_change().dropna() print(f"Selic 2031 — max drawdown: {dd_sel*100:.2f}%") print(f"Selic 2031 — retorno médio diário: {ret_sel.mean()*100:.4f}%") print(f"Selic 2031 — desvio-padrão diário: {ret_sel.std(ddof=0)*100:.4f}%") print(f"Selic 2031 — sellRate range: {selic['sellRate'].min()} a {selic['sellRate'].max()}") ``` Saída real (janela 2025-02-03 → 2026-05-15, 319 pregões): ``` Selic 2031 — max drawdown: 0.00% Selic 2031 — retorno médio diário: 0.0554% Selic 2031 — desvio-padrão diário: 0.0075% Selic 2031 — sellRate range: 0.09 a 0.14 ``` Três coisas chamam atenção: 1. **Zero drawdown** em 319 pregões. O preço só sobe. 2. O **retorno médio diário** de 0,0554% bate em mais ou menos **14,87% ao ano** — combina com a Selic em 14,5% no período. 3. A **`sellRate` fica colada em 0,09–0,14 p.p.** Em Tesouro Selic, esse campo é o *spread sobre a Selic* (valor cobrado a mais ou de menos em cima do preço base), não o rendimento total. O grosso do retorno vem do indexador. O Tesouro Selic é pós-fixado puro: o `basePrice` acumula a Selic dia a dia. Não há "contrato de taxa fixa" para o mercado repactuar. O único pedaço sujeito a marcação é o pequeno spread, que costuma se mover em centésimos. Em prazos curtos, o efeito é desprezível. *** ## Comparativo de volatilidade na mesma janela Volatilidade é **o tamanho dos balanços diários do preço, em média**. Pra comparar de forma justa, colocamos as três séries na **mesma janela de tempo** e medimos o desvio-padrão dos retornos diários do `sellPrice`: ```python def vol_window(name: str, df: pd.DataFrame) -> dict: rets = df["sellPrice"].pct_change().dropna() return { "titulo": name, "obs": len(rets), "mean_diario_%": round(rets.mean() * 100, 4), "std_diario_%": round(rets.std(ddof=0) * 100, 4), } # janela 2026-02-02 → 2026-05-15 (interseção do Prefixado 2037) janela = pre.index print(vol_window("Prefixado 2037", pre.loc[janela])) print(vol_window("Selic 2031", selic.loc[janela])) # janela longa 2025-02-03 → 2026-05-15 (interseção IPCA × Selic) janela_longa = ipca.index print(vol_window("IPCA+ 2060", ipca.loc[janela_longa])) print(vol_window("Selic 2031", selic.loc[janela_longa])) ``` Saída real: | Janela | Título | Obs | Média diária | Desvio-padrão diário | | ----------------------- | -------------- | --- | ------------ | -------------------- | | 2026-02-02 → 2026-05-15 | Prefixado 2037 | 69 | -0,0082% | **0,6733%** | | 2026-02-02 → 2026-05-15 | Selic 2031 | 69 | +0,0562% | **0,0023%** | | 2025-02-03 → 2026-05-15 | IPCA+ 2060 | 318 | +0,0304% | **0,7965%** | | 2025-02-03 → 2026-05-15 | Selic 2031 | 318 | +0,0554% | **0,0075%** | Visualizando o desvio-padrão diário em barras fica mais fácil enxergar a diferença de risco entre eles: 1 bar [0.0075, 0.6733, 0.7965] `} /> *Quanto maior a barra, maior o balanço diário do preço. O Selic mal se mexe; o IPCA+ longo é o campeão de oscilação.* Os números fecham o argumento: * **Prefixado 2037 é cerca de 296× mais volátil que Selic 2031** na mesma janela curta. * **IPCA+ 2060 é cerca de 106× mais volátil que Selic 2031** na janela longa — e ainda mais que o Prefixado 2037, porque tem **mais que o dobro de prazo até o vencimento** (35 anos vs 11 anos). * O retorno **médio diário do Prefixado foi um pouquinho negativo** na janela curta. A marcação a mercado puxou mais forte do que o ganho diário da taxa contratada. Em 2 meses, quem comprou no início ficou no vermelho no papel. *** ## Mid-cycle: o caso do IPCA+ 2060 O Tesouro IPCA+ 2060 vence em 35 anos. Cada centésimo a mais na taxa real exigida pelo mercado vira um movimento bem maior no preço. É a duração média (duration) trabalhando contra você. Saída real (mesma rotina das seções anteriores): ``` IPCA+ 2060 observações: 319 janela: 2025-02-03 → 2026-05-15 sellRate range: 6.990% a.a. a 7.660% a.a. sellPrice range: R$ 3.594,71 a R$ 4.124,86 max drawdown sellPrice: -7.29% (pico 2025-07-01 → fundo 2025-09-04) desvio-padrão diário: 0.7965% beta: +1 p.p. na taxa → -11.79% no preço ``` Sete por cento de queda em **menos de dois meses** num título do governo brasileiro. Esse é o preço de carregar prazo muito longo. Quem comprou em 1º de julho de 2025 por R$ 4.124 viu o papel cair pra R$ 3.825 em 4 de setembro. Em compensação, a taxa real **subiu de 6,99% para 7,66% a.a.** Quem comprou no fundo travou **67 pontos a mais** de juro acima da inflação. Pra fechar, compare a sensibilidade dos três títulos lado a lado. Esse é o **beta**: quanto o preço varia para cada +1 p.p. na curva. 2 bar [0, -5.42, -11.79] `} /> *O IPCA+ 2060 reage mais forte porque tem duration maior. Prazo dobrado, balanço dobrado.* -7,29% no `sellPrice` só vira prejuízo se você **vender** nesse fundo. Quem carregou até hoje (R$ 4.023) recuperou a maior parte e, ao vencimento, recebe a taxa contratada (IPCA + a taxa do dia da compra) independente do que aconteceu no meio. *** ## Quando faz sentido carregar até o vencimento A marcação a mercado só pesa se você precisa de **dinheiro antes do vencimento**. A escolha entre Prefixado, IPCA+ e Selic depende do seu horizonte (quando você vai usar o dinheiro): | Horizonte | Sensibilidade ao mercado | Título indicado | | -------------------------- | --------------------------------- | ---------------------------------------- | | Reserva de emergência | Não tolera drawdown | **Tesouro Selic** | | 1–3 anos com data definida | Baixa, se casar prazo | Prefixado **curto** (vencimento próximo) | | 5–10 anos | Média a alta | IPCA+ com prazo casado | | Aposentadoria (15+ anos) | Alta, mas irrelevante se carregar | IPCA+ longo ou Renda+ | Regra simples: **se o seu prazo é menor que a duration do título, você fica preso à marcação a mercado**. Se o prazo for igual ou maior, o drawdown vira só um susto no meio do caminho. A própria API mostra `durationDays` no endpoint [`/api/v2/treasury/list`](/docs/tesouro-direto/listagem). Use esse campo pra casar o prazo do título com o seu objetivo. Pra começar do zero, veja o [guia do Tesouro Direto](/blog/tesouro-direto-guia-completo-2026-como-investir). *** ## Pipeline completo Tudo junto num script único pra você copiar e colar: ```python import os import pandas as pd import requests BASE = "https://brapi.dev/api/v2/treasury" HEADERS = {"Authorization": f"Bearer {os.getenv('BRAPI_TOKEN', '')}"} def fetch_history(symbol, start, end): response = requests.get( f"{BASE}/indicators/history", params={"symbols": symbol, "startDate": start, "endDate": end, "sortOrder": "asc"}, headers=HEADERS, timeout=30, ) response.raise_for_status() return response.json()["results"][0]["history"] def analyze(symbol, start, end): df = pd.DataFrame(fetch_history(symbol, start, end)) df["baseDate"] = pd.to_datetime(df["baseDate"]) df.set_index("baseDate", inplace=True) rets = df["sellPrice"].pct_change().dropna() drate = df["sellRate"].diff().dropna() cummax = df["sellPrice"].cummax() dd = (df["sellPrice"] / cummax - 1).min() beta = drate.cov(rets) / drate.var() return { "symbol": symbol, "obs": len(df), "rate_min": df["sellRate"].min(), "rate_max": df["sellRate"].max(), "max_drawdown_%": round(dd * 100, 2), "std_diario_%": round(rets.std(ddof=0) * 100, 4), "beta_%_por_pp": round(beta * 100, 2), } symbols = [ "tesouro-selic-01032031", "tesouro-prefixado-com-juros-semestrais-01012037", "tesouro-ipca-com-juros-semestrais-15082060", ] resumo = pd.DataFrame([analyze(s, "2025-01-01", "2026-05-15") for s in symbols]) print(resumo.to_string(index=False)) ``` Saída real: ``` symbol obs rate_min rate_max max_drawdown_% std_diario_% beta_%_por_pp tesouro-selic-01032031 319 0.09 0.14 0.00 0.0075 -1.17 tesouro-prefixado-com-juros-semestrais-01012037 70 13.58 14.48 -3.63 0.6733 -5.42 tesouro-ipca-com-juros-semestrais-15082060 319 6.99 7.66 -7.29 0.7965 -11.79 ``` Esse `DataFrame` é o seu *painel de risco da curva*: três linhas, três títulos, três comportamentos bem diferentes na marcação a mercado. *** ## Próximos passos * [Guia completo do Tesouro Direto](/blog/tesouro-direto-guia-completo-2026-como-investir) — conceitos, tributação, escolha de título. * [CDI Histórico via API](/blog/cdi-historico-api-renda-fixa-benchmark-2026) — benchmark de renda fixa pós-fixada. * [API de Macroeconomia BCB](/blog/api-macroeconomia-brasil-bcb-indicadores-2026) — Selic, IPCA, IGP-M, juro real. * [Documentação do Tesouro Direto na brapi](/docs/tesouro-direto) — referência completa dos endpoints. *** ## FAQ **1. Por que o `sellRate` aparece em 0,12% no Tesouro Selic e em 13,68% no Prefixado? São comparáveis?** Não. O campo `rateInfo.rateType` mostra como cada número deve ser lido. No Selic é o *spread* sobre a Selic — você ganha Selic + 0,12 p.p. a.a. No Prefixado é o rendimento nominal anual contratado. Comparar os números crus é erro. Sempre confira `rateInfo` antes de cruzar séries. **2. O drawdown de -7,29% no IPCA+ 2060 significa que perdi dinheiro?** Só se você vendeu no fundo. Drawdown mede o **preço de venda antecipada**. Quem deixou o título carregado recebe, no vencimento, a taxa real contratada (IPCA + X% a.a.) e a marcação a mercado vira só ruído no caminho. **3. Tesouro Selic é "sem risco"?** Sem risco relevante de marcação, sim. Mas tem risco de **rentabilidade real**: se o IPCA acelerar acima da Selic real, você perde poder de compra. Por isso quem quer se proteger da inflação mistura Selic com IPCA+, de acordo com o prazo do objetivo. **4. Posso buscar o histórico desde 2005?** Sim. A base do Tesouro Direto começa em 2005. Basta passar `startDate=2005-01-01` no endpoint. A brapi devolve a série completa, respeitando o limite de 20 símbolos por request. **5. Qual a frequência de atualização?** Diária, conforme publicação do arquivo público do Tesouro Direto. O `baseDate` no payload é o dia útil daquele preço/taxa. *** A marcação a mercado deixa de ser um conceito abstrato no momento em que você bota o `sellPrice` ao lado da `sellRate` no gráfico. São duas linhas espelhadas contando a mesma história. Com o endpoint [`/api/v2/treasury/indicators/history`](/docs/tesouro-direto/indicadores-historico), qualquer carteira em Python ganha um termômetro de risco diário em menos de cinquenta linhas de código. Crie sua conta em [brapi.dev](https://brapi.dev), ative o plano Pro e pare de operar Prefixado e IPCA+ no escuro. # Margem de Segurança: O Conceito de Benjamin Graham que Protege seu Patrimônio URL: /blog/margem-de-seguranca-benjamin-graham.mdx Aprenda o conceito de margem de segurança de Benjamin Graham. Como calcular, aplicar no valuation e proteger seus investimentos contra erros ✓ *** searchable: true title: 'Margem de Segurança: O Conceito de Benjamin Graham que Protege seu Patrimônio' description: 'Aprenda o conceito de margem de segurança de Benjamin Graham. Como calcular, aplicar no valuation e proteger seus investimentos contra erros ✓' date: '2026-01-01' keywords: 'margem de seguranca, benjamin graham, value investing, preco justo acao, seguranca investimentos, valuation acoes, investidor inteligente, 2026' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Value Investing' readingTime: '18 min' tags: \['Value Investing', 'Benjamin Graham', 'Valuation', 'Margem de Segurança', 'Análise Fundamentalista'] relatedPosts: \[ 'formula-graham-como-calcular-preco-justo-acoes-value-investing', 'value-investing-como-encontrar-acoes-baratas', 'preco-teto-acao-como-calcular', 'guia-completo-indicadores-fundamentalistas-bovespa', ] featured: true expertise: 'Especialistas em Value Investing e análise fundamentalista com base nos princípios de Benjamin Graham' lastReviewed: 2026-01-03 ------------------------ ## Introdução > "A margem de segurança é o segredo do investimento inteligente." > — Benjamin Graham, The Intelligent Investor A **margem de segurança** é possivelmente o conceito mais importante do Value Investing. Criado por Benjamin Graham, mentor de Warren Buffett, esse princípio simples tem protegido investidores de perdas catastróficas por quase um século. Neste guia completo, você aprenderá: * O que é margem de segurança e por que funciona * Como calcular para diferentes tipos de empresas * Aplicação prática no mercado brasileiro * Erros comuns ao usar o conceito * Implementação automatizada com brapi.dev {/* Separator */} *** ## O que é Margem de Segurança? ### Conceito Fundamental A margem de segurança é a diferença entre o **valor intrínseco** de uma empresa e seu **preço de mercado**. Quanto maior essa diferença (a seu favor), menor o risco de perda permanente de capital. ``` ┌─────────────────────────────────────────────────────────────┐ │ MARGEM DE SEGURANÇA │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Valor Intrínseco (calculado): R$ 50,00 │ │ ───────────────────────────────────────── │ │ │ │ Preço de Mercado: R$ 35,00 │ │ ───────────────────────────────── │ │ │ │ Margem de Segurança = (50 - 35) / 50 = 30% │ │ │ │ ████████████████████████████░░░░░░░░░░ 30% de proteção │ │ │ │ Quanto MAIOR a margem, MENOR o risco │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### A Analogia da Ponte Benjamin Graham usava a analogia de uma ponte para explicar o conceito: > Se uma ponte tem capacidade para suportar 10 toneladas, você não passaria com um caminhão de 9,9 toneladas. Você passaria com um de 5 toneladas, garantindo uma margem de segurança. Da mesma forma, se você calcula que uma ação vale R$ 50, não a compre por R$ 48. Compre por R$ 35, garantindo proteção contra erros no seu cálculo. ### Por que a Margem de Segurança Funciona? 1. **Protege contra erros de cálculo** - Ninguém calcula o valor intrínseco perfeitamente 2. **Compensa eventos imprevisíveis** - Crises, desastres, mudanças de mercado 3. **Oferece potencial de valorização** - Preço tende a convergir ao valor 4. **Limita o downside** - Você já comprou com desconto 5. **Permite margem de erro** - Mesmo estimativas otimistas podem funcionar *** ## Quanto de Margem é Suficiente? ### Margens Recomendadas por Tipo de Empresa | Tipo de Empresa | Margem Mínima | Margem Ideal | | ------------------------- | ------------- | ------------ | | Blue chips (ITUB4, VALE3) | 15-20% | 25-30% | | Mid caps estáveis | 20-25% | 30-35% | | Small caps | 30-40% | 40-50% | | Turnarounds/cíclicas | 40-50% | 50%+ | | Empresas de crescimento | 20-30% | 35-40% | ### Fatores que Influenciam a Margem Necessária ``` ┌─────────────────────────────────────────────────────────────┐ │ QUANTO MAIOR O RISCO, MAIOR A MARGEM │ ├─────────────────────────────────────────────────────────────┤ │ │ │ BAIXO RISCO (15-25% margem) ALTO RISCO (40%+) │ │ ──────────────────────── ────────────────── │ │ ✓ Lucros estáveis ✗ Lucros voláteis │ │ ✓ Baixo endividamento ✗ Alto endividamento │ │ ✓ Setor defensivo ✗ Setor cíclico │ │ ✓ Histórico longo ✗ Empresa nova │ │ ✓ Dividend payer ✗ Não paga dividendos │ │ ✓ Governança forte ✗ Governança fraca │ │ │ └─────────────────────────────────────────────────────────────┘ ``` *** ## Calculando a Margem de Segurança ### Fórmula Básica **Fórmula:** Margem = (Valor Intrínseco - Preço) / Valor Intrínseco × 100 **Exemplo:** * Valor justo: R$ 50,00 * Preço atual: R$ 35,00 * **Margem de Segurança: 30%** Resultado positivo = ação com desconto (oportunidade). Negativo = ação cara (evitar). ### Implementação Completa com brapi.dev ```typescript // Analisar margem de segurança de uma ação const response = await fetch( "https://brapi.dev/api/quote/ITUB4?modules=defaultKeyStatistics,financialData", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); const acao = results[0]; const stats = acao.defaultKeyStatistics ?? {}; // Graham Number = √(22.5 × EPS × VPA) const eps = acao.earningsPerShare; const vpa = stats.bookValue; const grahamNumber = Math.sqrt(22.5 * eps * vpa); const margem = ((grahamNumber - acao.regularMarketPrice) / grahamNumber) * 100; ``` **Exemplo de análise ITUB4:** | Método | Valor Justo | Margem | Status | | --------------- | ----------- | ------ | ---------------------- | | Graham Number | R$ 42,30 | +23,2% | ✅ Oportunidade | | Bazin (6% DY) | R$ 35,00 | +7,1% | ⚠️ Margem pequena | | P/L Justo (10x) | R$ 28,50 | -14,0% | ❌ Cara por este método | *** ## Métodos de Valuation para Calcular o Valor Intrínseco ### 1. Fórmula de Graham **Graham Number = √(22,5 × EPS × VPA)** Onde: * 22,5 = 15 (P/L máximo) × 1,5 (P/VP máximo) * EPS = Lucro por ação * VPA = Valor Patrimonial por Ação **Exemplo ITUB4:** * EPS: R$ 3,50/ação * VPA: R$ 20,00/ação * **Graham Number: R$ 39,69** ### 2. Fórmula de Graham Modificada (com Crescimento) **Valor = EPS × (8,5 + 2g) × (4,4 / Y)** Onde: * 8,5 = P/L base para empresa sem crescimento * g = crescimento esperado (5-10 anos) em % * 4,4 = taxa AAA histórica (%) * Y = taxa AAA atual (%) **Exemplo WEGE3:** * EPS: R$ 1,20 * Crescimento 5 anos: 15% a.a. * **Graham Modificado: R$ 45,47** ### 3. Modelo de Desconto de Dividendos (DDM) **Valor = D₁ / (r - g)** Onde: * D₁ = Dividendo esperado no próximo ano * r = Taxa de desconto (retorno exigido) * g = Taxa de crescimento dos dividendos **Exemplo BBAS3:** * Dividendo atual: R$ 2,50/ação * Crescimento: 5% a.a. * Retorno exigido: 12% a.a. * **Valor DDM: R$ 37,50** ### 4. Múltiplos Relativos **Valuation por comparação com múltiplos do setor:** | Método | Fórmula | | --------- | --------------------------------- | | Por P/L | Valor = EPS × P/L médio do setor | | Por P/VP | Valor = VPA × P/VP médio do setor | | Combinado | Média dos dois métodos | *** ## Aplicação Prática no Mercado Brasileiro ### Screening de Ações com Margem de Segurança ```typescript // Buscar múltiplas ações com dados fundamentalistas const tickers = ["ITUB4", "BBDC4", "BBAS3", "WEGE3", "VALE3"]; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(",")}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); // Para cada ação, calcular Graham Number e margem results.forEach(acao => { const stats = acao.defaultKeyStatistics ?? {}; const graham = Math.sqrt(22.5 * acao.earningsPerShare * stats.bookValue); const margem = ((graham - acao.regularMarketPrice) / graham) * 100; // Filtrar ações com margem > 25% }); ``` **Exemplo de resultado (ações com margem > 25%):** | Ticker | Preço | Graham Number | Margem | | ------ | -------- | ------------- | ------ | | BBAS3 | R$ 28,50 | R$ 42,30 | 32,6% | | BBDC4 | R$ 14,20 | R$ 19,80 | 28,3% | | ITUB4 | R$ 32,00 | R$ 42,50 | 24,7% | *** ## Erros Comuns ao Usar Margem de Segurança ### 1. Armadilha de Valor (Value Trap) ``` ┌─────────────────────────────────────────────────────────────┐ │ VALUE TRAP │ ├─────────────────────────────────────────────────────────────┤ │ │ │ ❌ APARECE barata, mas tem problema estrutural │ │ │ │ Sinais de alerta: │ │ ├─ Lucros em queda consistente (3+ anos) │ │ ├─ Perda de market share │ │ ├─ Tecnologia obsoleta │ │ ├─ Dívida crescente │ │ ├─ Setor em declínio estrutural │ │ └─ Governança problemática │ │ │ │ Exemplo: Varejistas tradicionais vs e-commerce │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Como Evitar Value Traps **Verificar sinais de alerta antes de comprar:** | Indicador | Limite Seguro | Alerta | | ----------------- | ------------- | -------------------------------- | | ROE | > 10% | ⚠️ ROE baixo indica ineficiência | | Dívida/PL | \< 1,5x | ⚠️ Endividamento alto | | Margem Líquida | > 5% | ⚠️ Margem baixa pressiona lucro | | Crescimento Lucro | Positivo | ⚠️ Lucro em queda | **Se 2+ indicadores estiverem em alerta = provável Value Trap.** Mesmo com preço "barato", evite a compra. ### 2. Erro de Cálculo do Valor Intrínseco | Erro | Consequência | Como Evitar | | ----------------------- | --------------------- | -------------------------- | | Usar lucro único | Volatilidade distorce | Usar média 3-5 anos | | Ignorar ciclo econômico | Comprar no pico | Normalizar lucros | | Crescimento exagerado | Valor inflado | Ser conservador (5-10%) | | Ignorar qualidade | Value trap | Checar ROE, dívida, margem | ### 3. Margem Insuficiente **Margem de 5% é ERRADA:** qualquer erro no cálculo elimina a segurança. | Estratégia | Preço de Compra | Proteção | | ------------ | --------------------------------- | -------- | | ❌ Margem 5% | R$ 47,50 (se valor justo = R$ 50) | Mínima | | ✅ Margem 30% | R$ 35,00 (se valor justo = R$ 50) | Adequada | > **Regra:** Compre sempre com pelo menos 25-30% de desconto sobre o valor intrínseco. *** ## Margem de Segurança na Prática: Estudo de Caso ### Caso 1: WEGE3 (WEG) **Dados WEGE3 (valores ilustrativos):** * Preço atual: R$ 35,00 * EPS: R$ 1,20 | VPA: R$ 6,50 * Crescimento 5a: 18% a.a. | ROE: 25% | Dívida/PL: 0,2x **Análise por diferentes métodos:** | Método | Valor Justo | Margem | Análise | | ----------------- | ----------- | ------ | ----------------------------------- | | Graham Number | R$ 13,22 | -165% | ❌ Muito cara por Graham tradicional | | Graham Modificado | R$ 52,27 | +33% | ✅ OK considerando crescimento | **Conclusão:** WEGE3 é cara por métodos value tradicionais, mas pode ter margem considerando o alto crescimento. ### Caso 2: BBAS3 (Banco do Brasil) **Dados BBAS3 (valores ilustrativos):** * Preço atual: R$ 28,00 * EPS: R$ 5,50 | VPA: R$ 32,00 * Dividendo: R$ 2,80 | ROE: 18% **Análise por diferentes métodos:** | Método | Valor Justo | Margem | Status | | --------------------- | ----------- | ------ | ----------- | | Graham Number | R$ 62,93 | 55,5% | ✅ Excelente | | Bazin (6% DY) | R$ 46,67 | 40,0% | ✅ Muito bom | | P/L Justo (8x bancos) | R$ 44,00 | 36,4% | ✅ Bom | **Conclusão:** BBAS3 apresenta margem de segurança por todos os métodos. **Risco BBAS3:** Interferência política por ser banco estatal. Isso justifica exigir desconto adicional. *** ## Checklist de Margem de Segurança ### Antes de Comprar ``` ┌─────────────────────────────────────────────────────────────┐ │ CHECKLIST MARGEM DE SEGURANÇA │ ├─────────────────────────────────────────────────────────────┤ │ │ │ VALUATION │ │ ☐ Calcular valor por pelo menos 2 métodos │ │ ☐ Usar dados normalizados (média 3-5 anos) │ │ ☐ Ser conservador nas projeções de crescimento │ │ ☐ Comparar com múltiplos do setor │ │ │ │ MARGEM ADEQUADA │ │ ☐ Blue chips: mínimo 20% │ │ ☐ Mid caps: mínimo 30% │ │ ☐ Small caps: mínimo 40% │ │ ☐ Empresas problemáticas: mínimo 50% │ │ │ │ QUALIDADE (evitar value traps) │ │ ☐ ROE > 12% (consistente) │ │ ☐ Dívida/PL < 1.5 (ou índice adequado do setor) │ │ ☐ Margem líquida estável ou crescente │ │ ☐ Lucro crescente ou estável (5 anos) │ │ ☐ Sem red flags de governança │ │ │ │ CONFIRMAÇÃO │ │ ☐ Entendo o negócio? │ │ ☐ A margem compensa os riscos? │ │ ☐ Estou confortável para segurar 5+ anos? │ │ │ └─────────────────────────────────────────────────────────────┘ ``` *** ## Automatização com brapi.dev ### Monitor de Margem de Segurança ```typescript // Monitor de margem de segurança com brapi.dev const tickers = ["ITUB4", "BBAS3", "WEGE3", "VALE3", "EGIE3"]; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(",")}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); results.forEach(acao => { const stats = acao.defaultKeyStatistics ?? {}; const preco = acao.regularMarketPrice; const eps = acao.earningsPerShare; const vpa = stats.bookValue; // Graham Number const graham = Math.sqrt(22.5 * eps * vpa); const margemGraham = ((graham - preco) / graham) * 100; // Bazin (6% DY) const dividendo = preco * (stats.dividendYield ?? 0); const bazin = dividendo / 0.06; const margemBazin = ((bazin - preco) / bazin) * 100; console.log(`${acao.symbol}: Graham ${margemGraham.toFixed(1)}%, Bazin ${margemBazin.toFixed(1)}%`); }); ``` **Exemplo de relatório:** | Ticker | Preço | Graham | Margem Graham | Bazin | Margem Bazin | | ------ | -------- | -------- | ------------- | -------- | ------------ | | ITUB4 | R$ 32,00 | R$ 42,50 | ✅ 24,7% | R$ 38,00 | ⚠️ 15,8% | | BBAS3 | R$ 28,00 | R$ 62,93 | ✅ 55,5% | R$ 46,67 | ✅ 40,0% | | WEGE3 | R$ 35,00 | R$ 13,22 | ❌ -165% | R$ 25,00 | ❌ -40,0% | | VALE3 | R$ 58,00 | R$ 85,00 | ✅ 31,8% | R$ 70,00 | ⚠️ 17,1% | | EGIE3 | R$ 42,00 | R$ 48,00 | ⚠️ 12,5% | R$ 55,00 | ✅ 23,6% | *** ## Conclusão ### Princípios Essenciais 1. **Margem de segurança é proteção, não garantia** * Reduz risco, não elimina 2. **Quanto maior a incerteza, maior a margem necessária** * Blue chips: 20-25% * Small caps: 40%+ 3. **Qualidade + margem > margem sozinha** * Evite value traps 4. **Use múltiplos métodos de valuation** * Média de resultados é mais robusta 5. **Seja paciente** * Oportunidades aparecem em crises e correções ### Citação Final > "O valor intrínseco de uma ação não é uma coisa certa. É um range. A margem de segurança é comprar abaixo do limite inferior desse range." > — Seth Klarman *** **Pronto para encontrar ações com margem de segurança?** [Crie sua conta grátis](/signup) e use a brapi.dev para automatizar sua análise fundamentalista! # Como Usar o MCP da brapi no Claude, ChatGPT e Cursor URL: /blog/mcp-server-finance-brasil-agentes-ia-2026.mdx Conecte Claude, ChatGPT, Cursor, Codex ou VS Code aos dados da B3 usando o servidor MCP da brapi e uma única URL com login OAuth. *** searchable: true title: 'Como Usar o MCP da brapi no Claude, ChatGPT e Cursor' description: 'Conecte Claude, ChatGPT, Cursor, Codex ou VS Code aos dados da B3 usando o servidor MCP da brapi e uma única URL com login OAuth.' date: '2026-04-09' keywords: 'mcp b3, mcp finanças brasil, mcp brapi, ações b3 claude, chatgpt b3, cursor mcp mercado financeiro, servidor mcp financeiro' author: 'Alisson Leal' category: 'Tutoriais e Integrações' subcategory: 'Agentes de IA' readingTime: '7 min' tags: \['MCP', 'Claude', 'ChatGPT', 'Cursor', 'Codex', 'B3', 'Agentes de IA'] relatedPosts: \['b3-api-gratuita-como-usar-cotacoes', 'api-indicadores-fundamentalistas-b3-python', 'listar-acoes-b3-api-tickers-setores-python'] featured: true expertise: 'Integração de agentes de IA com dados financeiros brasileiros' lastReviewed: '2026-07-17' -------------------------- import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; O servidor MCP da brapi permite que um assistente consulte ações, FIIs, câmbio, criptomoedas e indicadores brasileiros enquanto responde à conversa. A URL é: ```text https://brapi.dev/api/mcp/mcp ``` O login usa OAuth. Na primeira conexão, o cliente abre o navegador para você entrar na conta brapi e autorizar o acesso. ## Configurar no Claude Code ```bash claude mcp add --transport http brapi https://brapi.dev/api/mcp/mcp ``` Depois confira a conexão: ```bash claude mcp list ``` Faça uma pergunta como: ```text Compare a cotação e a variação de PETR4 e VALE3. ``` ## Configurar no ChatGPT No ChatGPT: 1. abra **Configurações > Conectores**; 2. escolha **Adicionar conector personalizado**; 3. cole `https://brapi.dev/api/mcp/mcp`; 4. conclua o login na brapi. Conectores personalizados dependem do plano e da disponibilidade do recurso na sua conta do ChatGPT. ## Configurar no Cursor Crie `~/.cursor/mcp.json` para uma configuração global ou `.cursor/mcp.json` para apenas um projeto: ```json { "mcpServers": { "brapi": { "command": "npx", "args": [ "mcp-remote", "https://brapi.dev/api/mcp/mcp" ] } } } ``` Reinicie o Cursor. A primeira chamada abre o fluxo de autenticação. ## Configurar no Codex ```bash codex mcp add brapi --url https://brapi.dev/api/mcp/mcp codex mcp login brapi ``` O primeiro comando registra o servidor. O segundo inicia o login OAuth. ## Configurar no VS Code Em `.vscode/mcp.json`: ```json { "mcp": { "servers": { "brapi": { "url": "https://brapi.dev/api/mcp/mcp" } } } } ``` O suporte depende da versão do VS Code e da extensão de IA usada. A [documentação do MCP da brapi](/docs/mcp) mantém instruções para Claude Desktop, n8n e outros clientes. Você não precisa criar um servidor local diferente para cada aplicativo. O mesmo endpoint remoto funciona em clientes compatíveis com MCP e OAuth. ## Perguntas que funcionam bem Comece com pedidos objetivos, que indiquem o ativo, período e dado desejado: ```text Qual é a última cotação disponível de PETR4? ``` ```text Compare o histórico diário de VALE3 e PETR4 nos últimos seis meses. ``` ```text Liste FIIs de logística e compare P/VP e dividend yield. ``` ```text Mostre a Selic, o CDI e o IPCA mais recentes com a data de referência. ``` ```text Quais dados estão disponíveis para o ticker VVAR3 e qual é o código atual? ``` Pedidos vagos como "qual ação vai subir?" não viram bons dados só porque usam MCP. O servidor consulta fatos e séries; ele não elimina incerteza nem prevê o mercado. ## MCP ou API REST Use MCP quando a pessoa quer conversar com os dados, investigar uma hipótese ou deixar o agente escolher a ferramenta adequada. Use REST quando seu sistema precisa de um contrato fixo, baixa latência previsível, cache próprio ou uma tela com comportamento totalmente controlado. | Caso | Melhor opção inicial | | ------------------------------ | -------------------- | | Perguntas em linguagem natural | MCP | | Assistente interno de análise | MCP | | Dashboard com campos fixos | REST | | Pipeline de dados em lote | REST | | Protótipo de agente financeiro | MCP | | Backend transacional | REST | Os dois podem coexistir. Um produto pode usar REST nas telas e MCP no assistente de pesquisa. ## Segurança e revisão O servidor consulta dados, mas o agente ainda pode interpretar uma pergunta de forma incorreta. Mostre datas de referência e revise cálculos antes de usar a resposta em uma decisão financeira. Não cole tokens em prompts ou arquivos versionados. Prefira OAuth e revogue o acesso no painel quando uma integração deixar de ser usada. Para ver todas as ferramentas, clientes e exemplos, abra a [documentação do servidor MCP](/docs/mcp). # Melhores Ações Pagadoras de Dividendos 2026: Guia Completo para Renda Passiva URL: /blog/melhores-acoes-pagadoras-dividendos-2026.mdx Melhores ações pagadoras de dividendos 2026! Ranking por Dividend Yield, análise setorial e carteira de renda passiva ✓ *** searchable: true title: 'Melhores Ações Pagadoras de Dividendos 2026: Guia Completo para Renda Passiva' description: 'Melhores ações pagadoras de dividendos 2026! Ranking por Dividend Yield, análise setorial e carteira de renda passiva ✓' date: '2026-01-01' keywords: 'acoes pagadoras dividendos, melhores dividendos 2026, dividend yield, renda passiva acoes, dividendos bolsa brasileira, carteira dividendos, PETR4 dividendos, BBAS3 dividendos, TAEE11 dividendos, acoes baratas bons dividendos, 2026' author: 'Equipe brapi.dev' category: 'Estratégias de Dividendos' subcategory: 'Ações Pagadoras' readingTime: '30 min' tags: \['Dividendos', 'Renda Passiva', 'Ações', 'Dividend Yield', 'Bolsa Brasileira', 'PETR4', 'BBAS3', 'TAEE11', 'Investimentos'] relatedPosts: \['metodo-bazin-estrategia-renda-passiva-acoes-dividendos', 'dividend-yield-dy-como-calcular-usar-analise-acoes-dividendos', 'fundos-imobiliarios-fiis-guia-completo-iniciantes', 'preco-teto-acao-como-calcular'] featured: true expertise: 'Análise de ações pagadoras de dividendos no mercado brasileiro' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > Investir em ações que pagam bons dividendos é uma das estratégias mais populares para gerar renda passiva. Descubra quais empresas brasileiras têm histórico consistente de distribuição e como selecionar as melhores para sua carteira. *** ## Por que Investir em Ações de Dividendos? Investir em empresas pagadoras de dividendos oferece benefícios únicos: | Benefício | Descrição | | -------------------------------- | ------------------------------------------------ | | **Renda passiva** | Receba dinheiro periodicamente sem vender ativos | | **Reinvestimento** | Use dividendos para comprar mais ações | | **Proteção contra volatilidade** | Empresas maduras tendem a ser menos voláteis | | **Sinal de qualidade** | Dividendos indicam geração de caixa consistente | | **Isenção fiscal** | Dividendos são isentos de IR para pessoa física | ### Dividendos vs Valorização | Aspecto | Dividendos | Valorização | | ------------------ | ---------------------------------- | ------------------------------ | | **Foco** | Renda periódica | Crescimento do capital | | **Perfil** | Conservador a moderado | Agressivo | | **Empresas** | Maduras, setores estáveis | Growth, tecnologia, small caps | | **Reinvestimento** | Juros compostos via reinvestimento | Empresa reinveste lucros | | **Tributação** | Isento de IR | 15-20% sobre ganho de capital | *** ## Entendendo os Indicadores de Dividendos ### Dividend Yield (DY) O **Dividend Yield** mostra quanto a empresa paga de dividendos em relação ao preço da ação: **Fórmula:** `DY = (Dividendos 12 meses ÷ Preço da ação) × 100` **Exemplo - TAEE11:** Dividendos de R$ 4,20 e preço de R$ 35,00 → DY = 12,00% **Interpretação:** * **DY \< 4%**: Baixo (empresa de crescimento ou preço alto) * **DY 4-8%**: Moderado (bom equilíbrio) * **DY 8-12%**: Alto (boa pagadora) * **DY > 12%**: Muito alto (verificar sustentabilidade!) ### Payout Ratio O **Payout** indica quanto do lucro é distribuído como dividendos: **Fórmula:** `Payout = (Dividendos ÷ Lucro) × 100` **Exemplo:** Dividendo de R$ 3,50 e Lucro de R$ 5,00 → Payout = 70% **Interpretação:** * **\< 30%**: Empresa retém muito lucro (pode crescer mais) * **30-60%**: Equilíbrio saudável * **60-80%**: Alta distribuição (comum em utilities) * **> 80%**: Pode ser insustentável Payout acima de 100% significa que a empresa está pagando mais do que lucra - isso é insustentável no longo prazo! ### Histórico de Dividendos Empresas com **histórico consistente** são mais confiáveis: | Critério | Recomendação | | ---------------------- | ---------------------------------------- | | **Mínimo recomendado** | 5 anos pagando dividendos | | **Ideal** | 10+ anos sem cortes | | **Excelente** | Dividend Aristocrat (25+ anos crescendo) | **Sinais de alerta:** * Corte recente de dividendos * Payout acima de 100% * Lucro oscilante * Endividamento crescente *** ## Ranking: Melhores Pagadoras de Dividendos por Setor ### Setor Elétrico - Os Reis dos Dividendos O setor elétrico brasileiro é conhecido pela **previsibilidade de receitas** e **altos dividendos**: | Ticker | Empresa | DY Estimado\* | Payout | Destaque | | ------ | ------------ | ------------- | ------ | ----------------------------- | | TAEE11 | Taesa | 10-12% | 90%+ | Transmissão, contratos longos | | TRPL4 | ISA CTEEP | 8-10% | 75% | Transmissão SP | | EGIE3 | Engie Brasil | 7-9% | 70% | Geração diversificada | | CPLE6 | Copel | 6-8% | 50% | Integrada, Paraná | | CMIG4 | Cemig | 8-12% | 50% | Integrada, MG | \*Dividend Yields são estimativas e variam conforme preço e distribuição ```typescript // Consultar dados do setor elétrico com brapi.dev const tickers = ["TAEE11", "TRPL4", "EGIE3", "CPLE6", "CMIG4"]; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(",")}?dividends=true`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); data.results.forEach((ativo) => { console.log({ ticker: ativo.symbol, preco: ativo.regularMarketPrice, nome: ativo.longName, }); }); ``` **Por que elétricas pagam bem:** * Receitas reguladas e previsíveis * Contratos de longo prazo (20-30 anos) * Baixa necessidade de reinvestimento * Demanda inelástica por energia ### Setor Bancário - Lucros Bilionários Bancos brasileiros são máquinas de lucro: | Ticker | Empresa | DY Estimado | Payout | Destaque | | ------ | --------------- | ----------- | ------ | ---------------------- | | BBAS3 | Banco do Brasil | 8-12% | 40-45% | Maior DY entre grandes | | ITUB4 | Itaú Unibanco | 5-7% | 35% | Maior banco privado | | BBDC4 | Bradesco | 4-6% | 35% | Recuperação em curso | | SANB11 | Santander | 5-8% | 50% | Units, bom DY | **Comparativo: BBAS3 vs ITUB4** | Aspecto | BBAS3 | ITUB4 | | ---------------- | -------------------------------- | ----------------------------------- | | **Vantagem** | Maior DY entre grandes bancos | Maior banco privado, mais eficiente | | **Risco** | Banco estatal - risco político | DY menor, prêmio de qualidade | | **Perfil ideal** | Aceita volatilidade por DY maior | Conservador de longo prazo | ### Setor de Commodities - Alta Volatilidade, Altos Dividendos Empresas de commodities distribuem lucros extraordinários em ciclos favoráveis: | Ticker | Empresa | DY Estimado | Volatilidade | Commodity | | ------ | ------------- | ----------- | ------------ | ---------------- | | PETR4 | Petrobras | 10-20%+ | Alta | Petróleo | | VALE3 | Vale | 6-12% | Alta | Minério de ferro | | CMIN3 | CSN Mineração | 8-15% | Alta | Minério | | SUZB3 | Suzano | 3-6% | Média | Celulose | > **Atenção**: Dividendos de commodities são **cíclicos**. O DY alto de hoje pode não se repetir amanhã. **Avaliação de Ciclicidade por Setor:** | Setor | Ciclicidade | Previsibilidade | Estratégia | | --------------- | ----------- | --------------- | ----------------------------------------- | | **Commodities** | Alta | Baixa | Aproveitar DY alto, mas não contar sempre | | **Elétrico** | Baixa | Alta | Base da carteira de dividendos | | **Bancos** | Média | Média | Diversificar entre bancos | Commodities são ótimas para turbinar a renda em ciclos favoráveis, mas não devem ser a base de uma carteira focada em renda passiva estável. ### Seguradoras e Financeiras | Ticker | Empresa | DY Estimado | Destaque | | ------ | ---------------- | ----------- | ------------------------ | | BBSE3 | BB Seguridade | 8-10% | Seguros + previdência BB | | CXSE3 | Caixa Seguridade | 7-9% | Seguros da Caixa | | PSSA3 | Porto Seguro | 5-7% | Líder em auto | ### Saneamento | Ticker | Empresa | DY Estimado | Destaque | | ------ | ------- | ----------- | ----------------------- | | SAPR11 | Sanepar | 6-8% | Paraná, tarifa regulada | | SBSP3 | Sabesp | 4-6% | São Paulo, privatização | ### Telecomunicações | Ticker | Empresa | DY Estimado | Destaque | | ------ | --------------- | ----------- | ----------------- | | VIVT3 | Telefônica Vivo | 5-7% | Líder em fibra | | TIMS3 | TIM | 6-8% | Crescimento em 5G | *** ## Critérios para Selecionar Boas Pagadoras ### Checklist de Análise **Critérios para avaliar ação pagadora de dividendos:** | Critério | Bom | Regular | Ruim | | --------------------- | -------- | ----------------- | --------- | | **Dividend Yield** | > 6% | 4-6% | \< 4% | | **Payout** | 30-70% | \< 30% ou 70-100% | > 100% | | **Histórico** | 10+ anos | 5-10 anos | \< 5 anos | | **Dív.Líq/EBITDA** | \< 2 | 2-3 | > 3 | | **Crescimento lucro** | Positivo | Estável | Negativo | **Sistema de pontuação:** * 7+ pontos: **Comprar** * 5-6 pontos: **Analisar mais** * \< 5 pontos: **Evitar** ### Os 5 Filtros do Método Bazin O [Método Bazin](/blog/metodo-bazin-estrategia-renda-passiva-acoes-dividendos) estabelece critérios claros: 1. **Dividend Yield mínimo de 6%** 2. **Histórico de pelo menos 5 anos pagando** 3. **Empresa líder ou consolidada no setor** 4. **Endividamento controlado** 5. **Pagamento consistente sem cortes** O Método Bazin é simples e eficaz: se a ação não passa em todos os 5 critérios, não compre. Saiba mais no nosso [guia completo do Método Bazin](/blog/metodo-bazin-estrategia-renda-passiva-acoes-dividendos). *** ## Como Montar uma Carteira de Dividendos ### Diversificação por Setores **Regras de ouro:** * Mínimo 5 setores diferentes * Máximo 30% por setor | Setor | Alocação | Tickers Sugeridos | Motivo | | ---------------------- | -------- | ----------------- | ------------------------------ | | **Elétrico** | 30% | TAEE11, TRPL4 | Base estável, contratos longos | | **Bancos** | 25% | BBAS3, ITUB4 | Lucros consistentes | | **Seguros** | 15% | BBSE3 | Baixa ciclicidade | | **Commodities** | 15% | PETR4, VALE3 | Potencial de DY alto (cíclico) | | **Saneamento/Telecom** | 15% | SAPR11, VIVT3 | Receitas previsíveis | ### Exemplo: Carteira de R$ 100.000 | Ticker | Alocação | Valor | DY Esperado | Dividendo Anual | Dividendo Mensal | | --------- | -------- | -------------- | ----------- | --------------- | ---------------- | | TAEE11 | 15% | R$ 15.000 | 11% | R$ 1.650 | R$ 137,50 | | TRPL4 | 10% | R$ 10.000 | 9% | R$ 900 | R$ 75,00 | | BBAS3 | 15% | R$ 15.000 | 10% | R$ 1.500 | R$ 125,00 | | ITUB4 | 10% | R$ 10.000 | 6% | R$ 600 | R$ 50,00 | | BBSE3 | 15% | R$ 15.000 | 9% | R$ 1.350 | R$ 112,50 | | PETR4 | 10% | R$ 10.000 | 15% | R$ 1.500 | R$ 125,00 | | VALE3 | 10% | R$ 10.000 | 8% | R$ 800 | R$ 66,67 | | VIVT3 | 10% | R$ 10.000 | 6% | R$ 600 | R$ 50,00 | | SAPR11 | 5% | R$ 5.000 | 7% | R$ 350 | R$ 29,17 | | **TOTAL** | **100%** | **R$ 100.000** | **9,25%** | **R$ 9.250** | **R$ 770,83** | Com R$ 100.000 bem diversificados, você pode esperar cerca de R$ 770/mês em dividendos (DY médio de 9,25%). *** ## Calendário de Dividendos ### Como Funciona a Distribuição **Datas importantes:** | Data | Significado | | --------------------- | ------------------------------------- | | **Data Com** | Último dia para comprar e ter direito | | **Data Ex** | Primeiro dia sem direito ao dividendo | | **Data de Pagamento** | Dia que o dinheiro cai na conta | **Frequências comuns:** | Frequência | Exemplos | | -------------- | ------------------------------------ | | **Mensal** | PETR4 (algumas vezes), FIIs em geral | | **Trimestral** | ITUB4, BBDC4, maioria das empresas | | **Semestral** | VALE3, algumas elétricas | | **Anual** | Algumas empresas menores | ### Empresas com Dividendos Mensais ou Frequentes Algumas empresas pagam com maior frequência: | Ticker | Frequência | Observação | | ------ | ------------------- | ----------------------- | | PETR4 | Trimestral a mensal | Varia conforme política | | TAEE11 | Trimestral | Consistente | | BBAS3 | Trimestral | Regular | | ITUB4 | Mensal (JCP) | JCP mensal + dividendo | *** ## Armadilhas a Evitar ### 1. O "Yield Trap" (Armadilha do Yield Alto) **Como identificar uma armadilha de yield:** * DY acima de 15% → Verificar se preço caiu muito * Payout > 100% → Empresa pagando mais do que lucra * Dividendo extraordinário → Não se repetirá * Lucro caindo > 10% → Dividendos podem ser cortados ### 2. Dividendos Extraordinários Cuidado com DY calculado com dividendos que não se repetirão: **Exemplo - PETR4:** | Tipo | Valor por Ação | | ------------------------------------------ | -------------- | | Dividendo normal | R$ 3,00 | | Dividendo extraordinário (venda de ativos) | R$ 8,00 | | **Total do ano** | R$ 11,00 | * DY calculado: \~30% (parece alto!) * DY sustentável: \~10% (sem o extraordinário) * **Erro comum:** Comprar esperando 30% todo ano ### 3. Empresas Estatais e Risco Político | Ação | Vantagem | Risco | Mitigação | | --------- | ------------------------------------- | ------------------------------------------- | ----------------------------------------- | | **PETR4** | DY altíssimo, maior empresa do Brasil | Política de preços pode mudar com governo | Não concentrar demais, acompanhar cenário | | **BBAS3** | Melhor DY entre grandes bancos | Crédito direcionado, interferência política | Diversificar com bancos privados | *** ## Usando brapi.dev para Análise de Dividendos ### Consultando Dados de Dividendos ```typescript // Analisar dividendos de uma ação com brapi.dev const response = await fetch( "https://brapi.dev/api/quote/TAEE11?modules=defaultKeyStatistics÷nds=true", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); const acao = data.results[0]; // Extrair dados de dividendos const dividendos = acao.dividendsData?.cashDividends || []; // Calcular dividendos dos últimos 12 meses const umAnoAtras = new Date(); umAnoAtras.setFullYear(umAnoAtras.getFullYear() - 1); const dividendos12m = dividendos .filter((d) => new Date(d.paymentDate) > umAnoAtras) .reduce((acc, d) => acc + d.rate, 0); const dy = (dividendos12m / acao.regularMarketPrice) * 100; console.log({ ticker: acao.symbol, preco: acao.regularMarketPrice, dividendos12m: dividendos12m.toFixed(2), dividendYield: dy.toFixed(2) + "%", }); ``` ### Comparando Múltiplas Ações ```typescript // Comparar dividendos de múltiplas ações const tickers = ["TAEE11", "BBAS3", "PETR4", "ITUB4", "VALE3"]; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(",")}?dividends=true`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); const comparativo = data.results.map((acao) => ({ ticker: acao.symbol, preco: acao.regularMarketPrice, qtdPagamentos: acao.dividendsData?.cashDividends?.length || 0, })); // Ordenar por quantidade de pagamentos comparativo.sort((a, b) => b.qtdPagamentos - a.qtdPagamentos); console.log(comparativo); ``` *** ## Simulador de Renda Passiva **Cenário:** R$ 50.000 inicial + R$ 2.000/mês por 15 anos | DY médio: 8% | Ano | Patrimônio | Dividendos Ano | Dividendo Mensal | | --- | ---------- | -------------- | ---------------- | | 1 | R$ 79.000 | R$ 4.000 | R$ 333 | | 5 | R$ 210.000 | R$ 16.800 | R$ 1.400 | | 10 | R$ 450.000 | R$ 36.000 | R$ 3.000 | | 15 | R$ 820.000 | R$ 65.600 | R$ 5.467 | **Resultado final após 15 anos:** | Métrica | Valor | | --------------------------- | ----------- | | Patrimônio final | R$ 820.000+ | | Dividendos totais recebidos | R$ 280.000+ | | Renda mensal final | R$ 5.467 | O segredo é a consistência: aportes mensais + reinvestimento dos dividendos + tempo = renda passiva crescente. *** ## Perguntas Frequentes (FAQ) ### Quantas ações devo ter na carteira? **Recomendação**: 8 a 15 ações, diversificadas em pelo menos 5 setores diferentes. ### Devo reinvestir os dividendos? **Na fase de acumulação**: Sim, reinvestir acelera o crescimento via juros compostos. **Na fase de renda**: Não, use para complementar sua renda. ### Dividendos são garantidos? **Não**. Empresas podem cortar ou suspender dividendos a qualquer momento. Por isso, diversifique e analise a sustentabilidade. ### Qual o melhor momento para comprar? Para investidores de longo prazo, o momento é **agora**. Aportes regulares diluem o risco de timing. *** ## Checklist: Montando Carteira de Dividendos ### Antes de Investir * [ ] Definir objetivo (renda mensal ou acumulação) * [ ] Calcular quanto precisa de renda passiva * [ ] Estudar os setores e empresas * [ ] Definir alocação por setor (max 30% por setor) ### Seleção de Ações * [ ] Verificar DY mínimo de 6% * [ ] Confirmar histórico de 5+ anos pagando * [ ] Analisar payout ratio (ideal 30-70%) * [ ] Verificar endividamento (Dív.Líq/EBITDA \< 3) * [ ] Confirmar que não é yield trap ### Execução * [ ] Abrir conta em corretora * [ ] Comprar ações na proporção planejada * [ ] Configurar reinvestimento automático (se disponível) * [ ] Acompanhar calendário de dividendos ### Manutenção * [ ] Revisar carteira trimestralmente * [ ] Acompanhar resultados das empresas * [ ] Rebalancear quando necessário * [ ] Atualizar projeções de renda *** ## Conclusão Investir em ações pagadoras de dividendos é uma **estratégia comprovada** para construir renda passiva: 1. **Diversifique** entre setores (elétrico, bancos, seguros) 2. **Priorize qualidade** sobre yield máximo 3. **Reinvista** os dividendos na fase de acumulação 4. **Monitore** a sustentabilidade dos pagamentos 5. **Use ferramentas** como brapi.dev para análise Os melhores pagadores de dividendos são empresas **maduras**, com **lucros consistentes** e **políticas claras de distribuição**. ### Próximos Passos * **[Método Bazin](/blog/metodo-bazin-estrategia-renda-passiva-acoes-dividendos)** - Critérios para seleção * **[Dividend Yield - Como Calcular](/blog/dividend-yield-dy-como-calcular-usar-analise-acoes-dividendos)** - Entenda o indicador * **[FIIs para Renda Passiva](/blog/fundos-imobiliarios-fiis-guia-completo-iniciantes)** - Alternativa aos dividendos * **[API brapi.dev](/docs)** - Dados de dividendos em tempo real *** **Disclaimer:** Este conteúdo é educacional e não constitui recomendação de investimento. Dividend yields são estimativas baseadas em dados históricos e podem variar. Sempre faça sua própria análise antes de investir. # Ações do Setor Elétrico 2026: TAEE11, TRPL4, EGIE3 e ELET3 URL: /blog/melhores-acoes-setor-eletrico-2026-dividendos-taee11-trpl4.mdx Veja como analisar ações do setor elétrico em 2026: transmissão, geração, dividendos, riscos regulatórios e exemplos com TAEE11, TRPL4, EGIE3 e ELET3. *** searchable: true title: 'Ações do Setor Elétrico 2026: TAEE11, TRPL4, EGIE3 e ELET3' description: 'Veja como analisar ações do setor elétrico em 2026: transmissão, geração, dividendos, riscos regulatórios e exemplos com TAEE11, TRPL4, EGIE3 e ELET3.' date: '2026-01-01' keywords: 'ações setor elétrico 2026, TAEE11 dividendos, TRPL4 análise, EGIE3, ELET3, ações de energia, dividendos setor elétrico' author: 'Equipe brapi.dev' category: 'Ações' subcategory: 'Setores' readingTime: '10 min' tags: \['Setor Elétrico', 'Dividendos', 'Ações Defensivas', 'TAEE11', 'TRPL4', 'EGIE3', 'ELET3'] relatedPosts: \['onde-investir-2026-guia-completo-melhores-investimentos', 'renda-fixa-vs-renda-variavel-2026', 'fiis-de-papel-vs-tijolo-comparativo-2026'] featured: false expertise: 'Análise fundamentalista do setor elétrico brasileiro com foco em geração de renda passiva.' lastReviewed: '2026-04-23' faqSchema: * question: 'Quais são as principais ações do setor elétrico brasileiro?' answer: 'Entre as ações mais acompanhadas estão TAEE11 e TRPL4 em transmissão, EGIE3 em geração e ELET3 como tese de geração e transmissão com foco em eficiência pós-privatização.' * question: 'Setor elétrico é bom para dividendos?' answer: 'Pode ser, especialmente em empresas com receita regulada e contratos longos. Ainda assim, dividendos dependem de lucro, endividamento, ciclo de investimentos, regulação e decisões de capital da companhia.' * question: 'TAEE11 ou TRPL4: qual é melhor?' answer: 'TAEE11 costuma ser analisada pelo histórico de payout e foco em transmissão. TRPL4 também é defensiva, mas passa por ciclos de investimento e modernização. A escolha depende de preço, dívida, RAP remanescente e margem de segurança.' *** import { Authors, Author } from '~/components/Authors'; O setor elétrico segue entre os mais procurados por quem busca **dividendos, previsibilidade e menor volatilidade relativa** na bolsa brasileira. A tese, porém, não é simplesmente "comprar elétrica para receber renda". Em 2026, o investidor precisa separar transmissão, geração e distribuição, porque cada segmento tem riscos e motores de retorno diferentes. Neste guia, analisamos **TAEE11, TRPL4, EGIE3 e ELET3** com foco em fundamentos. Os números de preço, P/L e dividend yield mudam todos os dias; por isso, use as tabelas como roteiro de análise e consulte dados atualizados antes de decidir. ## Resumo Direto | Empresa | Ticker | Segmento principal | Tese mais comum | Principal risco | | ------------ | ------ | ------------------- | --------------------------- | ------------------------------------ | | Taesa | TAEE11 | Transmissão | Renda e previsibilidade | Renovação de concessões e CAPEX | | ISA CTEEP | TRPL4 | Transmissão | Defesa e fluxo regulado | Ciclo de investimentos | | Engie Brasil | EGIE3 | Geração | Qualidade operacional | Risco hidrológico e preço de energia | | Eletrobras | ELET3 | Geração/transmissão | Eficiência pós-privatização | Execução e risco político | Se o objetivo é renda, comece pelas transmissoras. Se o objetivo é qualidade com crescimento moderado, EGIE3 costuma entrar na conversa. Se a busca é destravamento de valor, ELET3 exige mais tolerância a volatilidade. ## Por Que o Setor Elétrico Atrai Investidores Energia elétrica é serviço essencial, com demanda relativamente resiliente. Além disso, parte relevante da receita do setor vem de contratos regulados, concessões longas e reajustes que carregam componentes de inflação. Isso cria um ambiente mais previsível do que varejo, commodities ou empresas cíclicas. O ponto que muitos textos ignoram é que "setor elétrico" não é uma coisa só: | Segmento | Como ganha dinheiro | Perfil para o investidor | | ------------ | ---------------------------------------------------- | ------------------------------------------------- | | Transmissão | Receita anual permitida pela disponibilidade da rede | Mais previsível, boa para renda | | Geração | Venda de energia no mercado regulado ou livre | Mais exposto a hidrologia e preço | | Distribuição | Entrega ao consumidor final | Eficiência operacional, inadimplência e regulação | T[Transmissão] T --> D[Distribuição] D --> C[Consumidor] G -. risco .-> RG[Preço de energia e chuvas] T -. risco .-> RT[Concessões e RAP] D -. risco .-> RD[Perdas, inadimplência e tarifa] `} /> ## TAEE11: Transmissão e Dividendos A Taesa é uma transmissora pura, conhecida pelo histórico de distribuição de proventos. O modelo é defensivo porque a receita da transmissão depende mais da disponibilidade dos ativos do que do volume de energia transportado. O ponto central para 2026 é a reposição de receita. Concessões vencem, RAPs podem cair e novos projetos exigem investimento. Portanto, um dividend yield alto isolado não basta. O investidor deve olhar dívida líquida/EBITDA, cronograma de entrada de novos projetos, vencimento das concessões e capacidade de manter payout sem comprometer crescimento. ## TRPL4: Defesa com Ciclo de Investimento ISA CTEEP também é uma tese clássica de transmissão. A empresa tem presença relevante em São Paulo e histórico de operação eficiente. O diferencial é a combinação de ativos maduros com projetos de reforço e modernização. Para analisar TRPL4, observe o quanto do lucro vem de ativos em operação, quanto ainda depende de projetos em construção e qual é o impacto do CAPEX na distribuição de dividendos. Em uma transmissora, pagar menos dividendos por alguns anos pode ser saudável se o capital estiver sendo reinvestido com retorno adequado. ## EGIE3: Qualidade em Geração Engie Brasil costuma ser tratada como uma das empresas de maior qualidade do setor. A companhia combina geração hidrelétrica, eólica, solar e outros ativos de infraestrutura. Isso reduz parte do risco específico, mas não elimina exposição a hidrologia, sazonalidade e preços de energia. EGIE3 geralmente negocia com prêmio em relação a empresas mais baratas do setor. Esse prêmio pode fazer sentido quando há previsibilidade e boa alocação de capital, mas reduz a margem de segurança se o investidor comprar sem comparar múltiplos históricos. ## ELET3: Eficiência e Destravamento de Valor Eletrobras é uma tese diferente. O foco não é dividend yield imediato, mas ganho de eficiência, disciplina de capital e simplificação pós-privatização. É uma empresa grande, complexa e com risco político mais visível do que transmissoras puras. Quem compra ELET3 precisa acompanhar plano de investimentos, venda de ativos, governança, passivos e evolução de margens. A assimetria pode ser maior, mas a previsibilidade costuma ser menor. ## Como Comparar as Ações com Dados Atualizados Use indicadores atuais, não tabelas antigas de preço. A API da brapi.dev permite consultar os principais tickers de uma vez: ```typescript const response = await fetch( 'https://brapi.dev/api/quote/TAEE11,TRPL4,EGIE3,ELET3?modules=defaultKeyStatistics,financialData', { headers: { Authorization: 'Bearer SEU_TOKEN' } }, ); const { results } = await response.json(); const comparativo = results.map((acao) => { const stats = acao.defaultKeyStatistics ?? {}; const financials = acao.financialData ?? {}; return { ticker: acao.symbol, preco: acao.regularMarketPrice, dy: stats.dividendYield, pl: acao.priceEarnings ?? stats.trailingPE, pvp: stats.priceToBook, roe: financials.returnOnEquity, }; }); ``` Uma boa comparação combina múltiplos, qualidade e risco regulatório: | Indicador | Como interpretar | | --------------------- | ------------------------------------------------- | | Dividend yield | Renda passada; precisa ser sustentável | | P/L | Preço sobre lucro; compare com histórico e pares | | P/VP | Útil em empresas reguladas e intensivas em ativos | | Dívida líquida/EBITDA | Mostra folga para investir e distribuir | | ROE | Mede retorno sobre patrimônio | ## Estratégia para 2026 Para renda, TAEE11 e TRPL4 continuam sendo nomes naturais, mas o preço de entrada importa. Para qualidade e diversificação, EGIE3 pode funcionar como posição mais equilibrada. Para potencial de valorização, ELET3 exige análise mais profunda e paciência com execução. Uma carteira setorial não precisa escolher apenas uma empresa. O caminho mais prudente costuma ser combinar uma transmissora, uma geradora de qualidade e, se fizer sentido para o perfil, uma tese de eficiência como Eletrobras. O peso de cada uma deve refletir risco, preço e objetivo da carteira. ## Perguntas Frequentes ### Setor elétrico protege contra inflação? Parcialmente. Muitas receitas e contratos têm mecanismos de reajuste, mas isso não significa proteção perfeita. Juros altos, CAPEX, mudanças regulatórias e revisão tarifária podem reduzir o retorno do acionista. ### Dividend yield alto é sinal de compra? Não. Dividend yield alto pode indicar preço descontado, lucro extraordinário ou expectativa de corte nos dividendos. Sempre confira payout, geração de caixa e endividamento. ### Qual segmento é mais defensivo? Transmissão tende a ser o mais previsível, porque a receita depende da disponibilidade da rede. Geração e distribuição podem ter mais variáveis operacionais. ## Conclusão As ações do setor elétrico podem ser boas candidatas para uma carteira de renda e estabilidade, mas a análise precisa ir além do dividend yield. Em 2026, acompanhe concessões, CAPEX, dívida, regulação e preço de entrada. A tese melhora quando a empresa combina contrato previsível, balanço saudável e margem de segurança. Para automatizar esse acompanhamento, consulte cotações, indicadores e histórico pela [documentação da brapi.dev](/docs). ## Leia Mais [Onde investir em 2026](/blog/onde-investir-2026-guia-completo-melhores-investimentos) · [Renda fixa vs renda variável](/blog/renda-fixa-vs-renda-variavel-2026) · [Dividendos e renda passiva](/blog/dividendos-como-construir-renda-passiva) *Este conteúdo é educacional e não constitui recomendação de investimento.* # Melhores Corretoras de Valores: Como Comparar sem Cair em Ranking URL: /blog/melhores-corretoras-valores-brasil-2026.mdx Compare corretoras por autorização, custo total, produtos, atendimento, app e ferramentas de day trade. Veja um método para escolher e testar a conta. *** searchable: true title: 'Melhores Corretoras de Valores: Como Comparar sem Cair em Ranking' description: 'Compare corretoras por autorização, custo total, produtos, atendimento, app e ferramentas de day trade. Veja um método para escolher e testar a conta.' date: '2026-01-01' keywords: 'melhores corretoras de valores, melhor corretora 2026, corretora day trade, comparar corretoras, corretora taxa zero, corretoras b3' author: 'Alisson Leal' category: 'Investimentos' subcategory: 'Corretoras' readingTime: '8 min' tags: \['Corretoras', 'B3', 'Custos', 'Day Trade', 'Investimentos', 'Segurança'] relatedPosts: \['como-comecar-investir-do-zero-guia-iniciantes-2026', 'o-que-sao-acoes-guia-iniciantes-2026', 'reserva-de-emergencia-guia-completo-2026'] featured: true expertise: 'Comparação de intermediários e custos de investimento' lastReviewed: '2026-07-17' faqSchema: * question: 'Qual é a melhor corretora de valores?' answer: 'Não existe uma corretora melhor para todos. Compare autorização, custo total, produtos, atendimento e ferramentas para o uso que você realmente terá.' * question: 'Corretagem zero significa que não há custos?' answer: 'Não. Ainda podem existir emolumentos, spreads, taxas de plataforma, custos de margem e tarifas de produtos específicos.' * question: 'Como saber se uma corretora é autorizada?' answer: 'Consulte o Cadastro Geral da CVM e a busca de participantes da B3 antes de abrir a conta ou transferir dinheiro.' *** import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; A melhor corretora depende do que você vai fazer: investir todo mês, comprar renda fixa, operar opções, fazer day trade ou receber assessoria. Um ranking único esconde essas diferenças e envelhece quando uma tarifa muda. Comece por duas verificações. Confirme a instituição no [Cadastro Geral da CVM](https://www.gov.br/cvm/pt-br/assuntos/regulados/consultas-por-participante/corretoras-e-distribuidoras) e na [busca de participantes da B3](https://sistemaswebb3-listados.b3.com.br/participantsPage/). ## Comparação rápida por perfil | Perfil | O que pesa mais | | --------------------- | ------------------------------------------------------------- | | Primeiro investimento | App claro, atendimento e informe organizado | | Longo prazo | Custos, produtos, portabilidade e relatórios | | Renda fixa | Oferta, liquidez, risco do emissor e spread | | Day trade | Estabilidade, ordens, margem, plataforma e suporte em pregão | | Opções | Cadeia, exercício, margem e mesa de atendimento | | Patrimônio maior | Custódia, governança, atendimento e remuneração da assessoria | XP, Rico, Clear, BTG Pactual, Inter, Nubank, Genial e outras instituições podem entrar na sua lista inicial. A escolha deve usar as condições vigentes na data da abertura, não uma tabela antiga copiada de outro site. ## 1. Verifique autorização e identidade A CVM recomenda conferir se o intermediário está autorizado e se os dados de contato correspondem ao cadastro oficial. Isso reduz o risco de enviar dinheiro para alguém que imita uma instituição conhecida. Pesquise o nome, CNPJ e situação cadastral. Na B3, confira o perfil do participante e os selos disponíveis. Não confie apenas no link recebido por mensagem. Abra a consulta da CVM ou da B3 por conta própria e compare domínio, telefone, CNPJ e conta bancária. ## 2. Calcule o custo total Corretagem zero não elimina todos os custos. Dependendo do produto e do uso, podem existir: * emolumentos e liquidação da bolsa; * spread de renda fixa ou câmbio; * assinatura de plataforma; * custo de margem e aluguel; * tarifa de exercício de opções; * taxa de administração ou performance do produto; * cobrança por atendimento específico. Baixe a tabela de tarifas no site oficial da corretora. Simule o seu padrão de uso, não o de um investidor abstrato. Quem compra dois ETFs por mês avalia custos diferentes de quem envia centenas de ordens no day trade. ## 3. Compare os produtos que você usa Uma prateleira enorme não ajuda se você só quer Tesouro Direto e um ETF. Liste seus produtos antes de comparar contas: * ações, FIIs, ETFs e BDRs; * Tesouro Direto; * CDB, LCI, LCA e crédito privado; * fundos e previdência; * opções e futuros; * investimentos internacionais. Confirme também se existe portabilidade de entrada e saída e quanto tempo o processo costuma levar. ## 4. Teste o app e os documentos Abra a conta, se não houver custo, e teste com pouco dinheiro. Verifique: * login e autenticação forte; * clareza da nota de corretagem; * extrato de movimentações; * preço médio e eventos corporativos; * informe de rendimentos; * atendimento para corrigir cadastro ou posição. Um app bonito pode esconder relatórios ruins. Isso aparece quando chega a hora de conferir uma movimentação ou preparar a declaração anual. ## 5. Para day trade, teste a operação O trader precisa avaliar mais do que corretagem: * estabilidade em horários de maior movimento; * tipos de ordem disponíveis; * política de margem; * zeragem compulsória; * custo de plataforma e dados; * regras de RLP; * atendimento durante o pregão; * integração com a ferramenta usada. Leia os contratos de risco e margem. Uma plataforma barata pode sair cara se a regra de zeragem não combina com sua operação. ## 6. Entenda a assessoria Pergunte como o profissional e a instituição são remunerados. Comissão por produto, taxa sobre patrimônio e cobrança direta criam incentivos diferentes. Peça o custo total e uma alternativa mais simples para comparação. Uma boa explicação precisa mostrar risco, liquidez, prazo e conflito de interesse. ## 7. Evite concentrar por conveniência Banco, cartão e investimentos no mesmo aplicativo simplificam a rotina. A concentração também aumenta sua dependência operacional. Considere uma segunda instituição quando ficar sem acesso à conta impedir uma movimentação importante. Não espalhe a carteira tanto que os controles e informes fiquem impossíveis de acompanhar. ## Como tomar a decisão Crie uma planilha com estes pesos: | Critério | Peso sugerido | | ----------------------------------- | ------------: | | Autorização e segurança operacional | Eliminatório | | Custo para seu uso | 25% | | Produtos necessários | 20% | | App e relatórios | 20% | | Atendimento | 15% | | Ferramentas específicas | 20% | Os pesos são um exemplo. Um trader pode aumentar ferramentas e atendimento. Um investidor passivo pode dar mais peso a relatórios e portabilidade. Escolha duas ou três candidatas, confira as páginas oficiais, teste as contas e só depois transfira valores maiores. ## Perguntas frequentes ### Qual corretora tem taxa zero? Várias instituições anunciam corretagem zero em alguns produtos. Confira a tabela vigente, porque produto, canal, plataforma e campanha podem mudar a condição. ### Posso ter mais de uma corretora? Sim. Uma segunda conta pode reduzir dependência operacional ou separar usos. Mantenha um controle único de posições, eventos e documentos. ### Meus ativos ficam na corretora? A estrutura de registro e custódia varia conforme o ativo. Dinheiro em conta, ações, títulos bancários e fundos não seguem a mesma proteção. Consulte a documentação do produto antes de assumir que tudo funciona da mesma forma. Este artigo explica um método de comparação. Ele não recomenda a contratação de uma instituição específica. # Método Bazin 2025: Como Construir Renda Passiva com Dividendos URL: /blog/metodo-bazin-estrategia-renda-passiva-acoes-dividendos.mdx Domine o Método Bazin para renda passiva! Aprenda os critérios de Décio Bazin, yield 6%+, análise de sustentabilidade e seleção de pagadoras. Guia completo ✓ *** searchable: true title: 'Método Bazin 2025: Como Construir Renda Passiva com Dividendos' description: 'Domine o Método Bazin para renda passiva! Aprenda os critérios de Décio Bazin, yield 6%+, análise de sustentabilidade e seleção de pagadoras. Guia completo ✓' date: '2025-08-22' keywords: 'método bazin, décio bazin, renda passiva, dividendos, yield 6%, ações pagadoras dividendos, estratégia dividendos, bolsa brasileira, dividend yield, brapi' author: 'Equipe brapi.dev' category: 'Estratégias de Dividendos' subcategory: 'Métodos de Renda' readingTime: '21 min' tags: \['Método Bazin', 'Renda Passiva', 'Dividendos', 'Yield', 'Bolsa Brasileira', 'Estratégia', 'Pagadoras', 'Income'] relatedPosts: \['dividend-yield-dy-como-calcular-usar-analise-acoes-dividendos', 'fundos-imobiliarios-fiis-guia-completo-iniciantes', 'formula-graham-como-calcular-preco-justo-acoes-value-investing'] featured: true expertise: 'Estratégias de renda passiva com 8+ anos de experiência no mercado brasileiro' lastReviewed: 2026-01-03 howToSteps: * name: 'Entender a filosofia do Método Bazin' text: 'Compreenda que o método foca em renda passiva através de dividendos, priorizando yield mínimo de 6% e empresas consolidadas com histórico de pagamentos.' * name: 'Calcular o preço teto' text: 'Use a fórmula: Preço Teto = (Dividendos por Ação × 100) ÷ 6. Só compre ações abaixo desse preço para garantir yield mínimo de 6%.' * name: 'Verificar histórico de dividendos' text: 'Analise pelo menos 5 anos de pagamentos, verificando crescimento ou estabilidade dos dividendos e ausência de cortes significativos.' * name: 'Avaliar solidez da empresa' text: 'Busque empresas líderes no setor, com negócio previsível, baixo endividamento e geração de caixa consistente.' * name: 'Usar API brapi.dev para análise' text: 'Obtenha dados de dividend yield, histórico de dividendos e indicadores fundamentalistas via API para automatizar a seleção.' * name: 'Montar carteira diversificada' text: 'Selecione 8-12 ações de diferentes setores que atendam aos critérios Bazin para reduzir risco específico.' * name: 'Reinvestir dividendos' text: 'Reinvista os dividendos recebidos para aproveitar o efeito bola de neve e acelerar a construção de patrimônio.' howToTools: * 'API brapi.dev' * 'Planilha de cálculo de preço teto' * 'Histórico de dividendos' * 'Calculadora de yield' howToSupplies: * 'Token de acesso brapi.dev' * 'Livro "Faça Fortuna com Ações" (opcional)' * 'Lista de empresas pagadoras de dividendos' * 'Capital para investimento' *** import { Authors, Author } from '~/components/Authors'; > O Método Bazin, criado por Décio Bazin, é uma estratégia conservadora focada na geração de renda passiva através de dividendos. Com critérios rigorosos e foco no yield mínimo de 6%, esta metodologia busca proporcionar retorno constante e previsível aos investidores. *** ## O que é o Método Bazin? O **Método Bazin** é uma estratégia de investimento desenvolvida por Décio Bazin que foca exclusivamente na geração de renda passiva através de dividendos. A metodologia estabelece critérios específicos para selecionar ações que proporcionem um yield mínimo de 6% ao ano. ### Filosofia do Método A estratégia baseia-se no princípio de que é melhor receber uma renda constante e previsível do que apostar na valorização das ações. O foco está em empresas maduras, com histórico sólido de pagamento de dividendos. ## Quem foi Décio Bazin? **Décio Bazin** foi um renomado analista financeiro e escritor brasileiro, conhecido por sua abordagem conservadora aos investimentos. Suas principais contribuições incluem: ### Legado no Mercado Brasileiro * **"Faça Fortuna com Ações"**: Livro clássico sobre investimentos em ações * **Foco em Dividendos**: Pioneiro na análise de ações pagadoras de dividendos no Brasil * **Estratégia Conservadora**: Desenvolveu metodologia para investidores avessos ao risco ### Princípios Fundamentais * Renda passiva é superior à especulação * Empresas sólidas sempre recompensam seus acionistas * Paciência e disciplina são essenciais ## Critérios do Método Bazin ### 1. Dividend Yield Mínimo de 6% A regra fundamental do método é investir apenas em ações com DY igual ou superior a 6%: ``` Preço Teto = (Dividendos por Ação × 100) ÷ 6% ``` **Exemplo:** * Dividendos pagos: R$ 3,60 por ação * Preço teto: (3,60 × 100) ÷ 6 = R$ 60,00 ### 2. Histórico de Dividendos #### Critérios de Histórico: * **Pelo menos 5 anos** pagando dividendos * **Crescimento ou estabilidade** dos dividendos * **Ausência de cortes** significativos nos dividendos ### 3. Empresas Consolidadas #### Características Desejáveis: * Liderança no setor * Negócio previsível e estável * Baixa ciclicidade * Posição defensiva no mercado ### 4. Solidez Financeira #### Indicadores Financeiros: * Endividamento controlado * Margens operacionais estáveis * Geração consistente de caixa * ROE sustentável ## Calculando o Preço Teto com brapi.dev Use a [API da brapi.dev](/docs/acoes) para obter dados de dividendos e calcular o preço teto: ### Consultando Dados de Dividendos ```bash curl "https://brapi.dev/api/quote/ITUB4?dividends=true" ``` **Resposta com histórico de dividendos:** ```json { "results": [{ "symbol": "ITUB4", "dividendsData": { "dividends": [ { "date": "2023-12-15", "dividend": 0.35 }, { "date": "2023-09-15", "dividend": 0.30 } // ... mais dividendos ] } }] } ``` ### Implementação da Fórmula ```javascript function calcularPrecoTetoBazin(dividendosAnuais) { const yieldMinimo = 0.06; // 6% return dividendosAnuais / yieldMinimo; } // Exemplo com dados da API async function analiseBazin(ticker) { const response = await fetch(`https://brapi.dev/api/quote/${ticker}?modules=defaultKeyStatistics÷nds=true`); const data = await response.json(); const acao = data.results[0]; const umAnoAtras = new Date(); umAnoAtras.setFullYear(umAnoAtras.getFullYear() - 1); const dividendosUltimos12Meses = (acao.dividendsData?.cashDividends ?? []) .filter((dividendo) => new Date(dividendo.paymentDate) >= umAnoAtras) .reduce((total, dividendo) => total + dividendo.rate, 0); const precoAtual = acao.regularMarketPrice; const precoTeto = calcularPrecoTetoBazin(dividendosUltimos12Meses); const yieldAtual = (dividendosUltimos12Meses / precoAtual) * 100; return { ticker, precoAtual, precoTeto, yieldAtual, recomendacao: yieldAtual >= 6 ? 'COMPRAR' : 'AGUARDAR' }; } ``` ## Setores Favoráveis ao Método Bazin ### 1. Bancos **Características:** * Dividendos obrigatórios por lei * Negócio recorrente * Yields tradicionalmente altos **Exemplos:** ITUB4, BBDC4, BBAS3, SANB11 ### 2. Utilities (Energia e Saneamento) **Características:** * Concessões de longo prazo * Fluxo de caixa previsível * Necessidade básica **Exemplos:** EGIE3, SBSP3, CPLE6, TAEE11 ### 3. Seguradoras **Características:** * Modelo de negócio estável * Float insurance * Dividendos consistentes **Exemplos:** BBSE3, SULA11, PSSA3 ### 4. Telecomunicações **Características:** * Infraestrutura consolidada * Receita recorrente * Mercado maduro **Exemplos:** VIVT3, TIMS3 ## Implementando o Screening Bazin ### Critérios de Filtragem ### Critérios de Filtragem (Método Bazin) | Critério | Requisito | Descrição | | ----------------- | ---------- | ----------------------------------- | | **DY mínimo** | ≥ 6% | Dividend Yield anual | | **Histórico** | ≥ 5 anos | Pagamento consistente de dividendos | | **Crescimento** | ≥ 0% | Dividendos não podem estar em queda | | **Endividamento** | D/E \< 1.0 | Solidez financeira | **Cálculo do Preço-Teto:** ``` Preço-Teto = Dividendos TTM ÷ 0,06 ``` Se o preço atual está abaixo do preço-teto, a ação está dentro do critério Bazin. ### Monitoramento Automático ```javascript // Monitoramento diário de oportunidades Bazin const monitorarOportunidades = async () => { const watchlist = ['ITUB4', 'BBDC4', 'EGIE3', 'SBSP3', 'BBSE3']; for (const ticker of watchlist) { const analise = await analiseBazin(ticker); if (analise.yieldAtual >= 6) { console.log(`🎯 ${ticker}: Yield ${analise.yieldAtual.toFixed(2)}% - OPORTUNIDADE!`); // Enviar alerta por email/telegram enviarAlerta(analise); } } }; // Executar diariamente setInterval(monitorarOportunidades, 24 * 60 * 60 * 1000); ``` ## Construindo uma Carteira Bazin ### Diversificação Setorial ``` 📊 Distribuição Recomendada: - 40% Bancos - 30% Utilities - 15% Seguradoras - 10% Telecomunicações - 5% Outros setores ``` ### Critérios de Entrada 1. **DY ≥ 6%** no momento da compra 2. **Preço ≤ Preço Teto** calculado 3. **Histórico positivo** de dividendos (mín. 5 anos) 4. **Solidez financeira** comprovada ### Critérios de Saída 1. **DY \< 4%** por mais de 6 meses 2. **Corte significativo** nos dividendos (acima de 30%) 3. **Deterioração** dos fundamentos 4. **Mudança estratégica** da empresa ## Vantagens do Método Bazin ### 1. Renda Passiva Previsível * Dividendos proporcionam fluxo de caixa regular * Menor dependência da valorização das ações * Proteção contra volatilidade do mercado ### 2. Simplicidade * Critérios objetivos e fáceis de aplicar * Não requer análises complexas * Adequado para investidores iniciantes ### 3. Foco no Longo Prazo * Estratégia de buy and hold * Compounding dos dividendos * Reinvestimento automático ### 4. Proteção contra Inflação * Dividendos tendem a crescer com a inflação * Empresas reais com preços reais * Hedge natural contra desvalorização monetária ## Limitações e Riscos ### 1. Yield Traps **O que são:** Ações com DY alto devido a problemas fundamentais **Como evitar:** * Analisar a sustentabilidade dos dividendos * Verificar o payout ratio * Acompanhar a saúde financeira ### 2. Concentração Setorial * Método favorece setores específicos * Exposição a riscos regulatórios * Dependência de ciclos econômicos ### 3. Oportunidade de Custo * Pode perder crescimento de outros setores * Foco apenas em renda, não em valorização * Empresas de crescimento não se encaixam ### 4. Ambiente Macroeconômico * Juros altos competem com dividendos * Recessões podem afetar pagamentos * Mudanças regulatórias impactam setores ## Ferramentas de Análise ### Dashboard de Monitoramento Crie um dashboard usando dados da brapi.dev: ```typescript const DashboardBazin = () => { const [oportunidades, setOportunidades] = useState([]); useEffect(() => { const buscarOportunidades = async () => { const tickers = ['ITUB4', 'BBDC4', 'EGIE3']; const resultados = []; for (const ticker of tickers) { const analise = await analiseBazin(ticker); if (analise.yieldAtual >= 6) { resultados.push(analise); } } setOportunidades(resultados); }; buscarOportunidades(); }, []); return (

Oportunidades Método Bazin

{oportunidades.map(opp => (

{opp.ticker}

Yield: {opp.yieldAtual.toFixed(2)}%

Preço: R$ {opp.precoAtual.toFixed(2)}

Teto: R$ {opp.precoTeto.toFixed(2)}

))}
); }; ``` ### Calculadora Automática ```html Calculadora Método Bazin

Calculadora Preço Teto - Método Bazin

``` ## Casos Práticos ### Exemplo 1: Banco Consolidado **ITUB4 - Itaú Unibanco** * Dividendos TTM: R$ 1,50 * Preço atual: R$ 25,00 * DY atual: 6,0% * Preço teto Bazin: R$ 25,00 * **Situação:** Na faixa de compra ### Exemplo 2: Utility Sólida **EGIE3 - Engie Brasil** * Dividendos TTM: R$ 2,80 * Preço atual: R$ 40,00 * DY atual: 7,0% * Preço teto Bazin: R$ 46,67 * **Situação:** Oportunidade de compra ## Acompanhamento e Evolução ### Métricas de Acompanhamento 1. **Yield médio da carteira** 2. **Crescimento dos dividendos** 3. **Payout ratio médio** 4. **Renda passiva mensal** ### Rebalanceamento * **Trimestral:** Verificar critérios de cada posição * **Anual:** Reavaliar alocação setorial * **Oportunidades:** Aproveitar quedas para aumentar posições ## Conclusão O Método Bazin é uma estratégia sólida para investidores que priorizam renda passiva e estabilidade. Embora possa limitar o potencial de crescimento, oferece previsibilidade e proteção em mercados voláteis. ### Pontos-Chave: 1. **Foco em renda passiva** com yield mínimo de 6% 2. **Critérios objetivos** de seleção 3. **Empresas maduras** e consolidadas 4. **Estratégia de longo prazo** ### Próximos Passos: * Explore nossa [API de dividendos](/docs/acoes) * Use nossa [plataforma](/quotes) para screening * Combine com [análise fundamentalista](/blog/analise-fundamentalista-acoes-indicadores-essenciais-investir-b3) * Aprenda sobre [análise P/VP](/blog/como-usar-indicador-pvp-valor-patrimonial-analise-acoes) para validação **Lembre-se:** O Método Bazin é uma ferramenta, não uma garantia. Sempre faça sua própria análise e diversifique adequadamente seus investimentos. # NFTs no Brasil 2026: Vale a Pena? Como Comprar Passo a Passo URL: /blog/nfts-brasil-vale-a-pena-como-comprar-2026.mdx Guia completo sobre NFTs no Brasil em 2026. Aprenda como comprar, quais marketplaces usar, tributação, riscos e se ainda vale a pena investir após o hype. *** searchable: true title: 'NFTs no Brasil 2026: Vale a Pena? Como Comprar Passo a Passo' description: 'Guia completo sobre NFTs no Brasil em 2026. Aprenda como comprar, quais marketplaces usar, tributação, riscos e se ainda vale a pena investir após o hype.' date: '2026-01-02' keywords: 'nft brasil, como comprar nft, opensea brasil, nft vale a pena 2026, nft imposto de renda, marketplace nft, nft ethereum solana' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Criptomoedas' readingTime: '22 min' tags: \['NFTs', 'Criptomoedas', 'OpenSea', 'Arte Digital', 'Blockchain', 'Ethereum', 'Solana'] relatedPosts: \['ethereum-eth-guia-completo-brasil-2026', 'solana-sol-guia-completo-brasil-2026', 'carteiras-criptomoedas-guia-seguranca-2026', 'como-declarar-criptomoedas-imposto-renda-2026', 'defi-financas-descentralizadas-guia-iniciantes-2026'] featured: true expertise: 'Análise elaborada por especialistas em ativos digitais com foco no mercado brasileiro de NFTs' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; O mercado de **NFTs (Non-Fungible Tokens)** passou por uma montanha-russa desde o boom de 2021. Após quedas de mais de 90% em volume de negociação, muitos declararam a "morte dos NFTs". Mas será que a tecnologia realmente acabou ou apenas evoluiu para casos de uso mais práticos? Neste guia completo, vamos analisar o **estado atual dos NFTs em 2026**, como comprar de forma segura, a tributação no Brasil, e principalmente: **vale a pena investir agora?** *** ## O que são NFTs? Entendendo a Tecnologia **NFT** significa **Non-Fungible Token** (Token Não-Fungível). Diferente de criptomoedas como Bitcoin ou Ethereum, onde cada unidade é idêntica (fungível), cada NFT é único e representa propriedade de um ativo digital específico. ### Fungível vs Não-Fungível | Tipo | Fungível (Intercambiável) | Não-Fungível (Único) | | ------------ | ----------------------------- | -------------------------------------------------------------- | | **Conceito** | Cada unidade é igual | Cada item é diferente | | **Exemplo** | R$ 100 = R$ 100 = R$ 100 | NFT #0001 ≠ NFT #0002 | | **Uso** | Dinheiro, Bitcoin, ETH, ações | Obras de arte, ingressos numerados, escrituras, itens de jogos | ### Como Funciona Tecnicamente? Um NFT é um **smart contract** registrado em uma blockchain que contém: 1. **Token ID**: Identificador único 2. **Metadata**: Informações do ativo (nome, descrição, imagem) 3. **Histórico de propriedade**: Todas as transferências registradas 4. **Royalties**: Porcentagem para o criador em revendas **Exemplo de estrutura de um NFT (ERC-721):** | Campo | Exemplo | | ---------------- | ---------------------------------------------- | | Token ID | 1234 | | Contract Address | 0x1234...abcd | | Owner | 0xSeuEndereço... | | Nome | CryptoPunk #7804 | | Descrição | Um dos 10.000 punks únicos | | Imagem | ipfs\://QmXyz... | | Atributos | Background: Blue, Type: Alien, Accessory: Pipe | | Royalty | 5% para criador em cada revenda | ### Principais Blockchains para NFTs | Blockchain | Pros | Contras | Custo Médio Mint | | ---------------------- | ------------------------------------- | ------------------ | ---------------- | | **Ethereum** | Maior liquidez, mais coleções premium | Gas fees altas | $5-50+ | | **Solana** | Taxas baixíssimas, rápido | Menos coleções AAA | $0.01-0.10 | | **Polygon** | Taxas quase zero, compatível ETH | Menor prestígio | $0.01-0.50 | | **Bitcoin (Ordinals)** | Segurança máxima, novidade | Limitado, caro | $10-100+ | | **Tezos** | Ecológico, arte experimental | Menor liquidez | $0.10-1.00 | *** ## Casos de Uso de NFTs em 2026 O mercado evoluiu muito além dos "JPEGs caros". Veja os principais casos de uso atuais: ### 1. Arte Digital e Colecionáveis O caso de uso original continua forte, mas com mais foco em artistas estabelecidos e coleções com utilidade. #### Evolução do Mercado de Arte NFT | 2021 (Hype) | 2026 (Maturidade) | | -------------------------------- | ------------------------------------- | | PFPs genéricos | Artistas renomados | | FOMO e especulação | Foco em utilidade | | Preços inflados | Valuations realistas | | Projetos sem roadmap | Comunidades sólidas | | "Compre e fique rico" | Arte como investimento de longo prazo | | Volume: $25B/mês (insustentável) | Volume: $500M-1B/mês (sustentável) | **Coleções que mantiveram valor:** * CryptoPunks * Bored Ape Yacht Club (BAYC) * Art Blocks (arte generativa) * Fidenza, Ringers (curadas) ### 2. Gaming e Metaverso NFTs representam itens in-game com propriedade real do jogador. **Exemplo: Item de jogo como NFT** | Atributo | Valor | | --------------- | ------------------------------ | | Nome | Espada Lendária do Dragão | | Jogo | Axie Infinity / Gods Unchained | | Dano | 150 | | Raridade | Legendary | | Level Requerido | 50 | | Negociável | Sim | | Alugável | Sim | **Benefícios para jogadores:** * Vender itens por dinheiro real * Alugar personagens/itens * Provar propriedade de conquistas * Transferir entre marketplaces * Histórico verificável de raridade **Jogos com NFTs relevantes em 2026:** * Axie Infinity (pioneiro, reestruturado) * Gods Unchained (TCG) * Illuvium (AAA quality) * Star Atlas (Solana) * Sorare (futebol fantasia) ### 3. RWA - Real World Assets (Ativos do Mundo Real) A tokenização de ativos reais é o caso de uso com maior potencial de crescimento. | Categoria | Exemplos | | --------------------------- | ----------------------------------------------- | | **Imóveis** | Escrituras tokenizadas, frações de propriedade | | **Documentos** | Diplomas, certidões, ingressos, contratos | | **Luxo** | Relógios, bolsas, joias, carros | | **Propriedade Intelectual** | Royalties musicais, direitos autorais, licenças | **Exemplos no Brasil:** * Tokenização imobiliária (Netspaces, Tokeniza) * Ingressos com blockchain (Ingresse) * Certificados universitários (algumas universidades) ### 4. Memberships e Acesso Exclusivo NFTs como "carteirinhas" digitais para comunidades e benefícios. **Exemplo: NFT de Membership** | Atributo | Valor | | ------------ | --------------------------------- | | Coleção | VIP Club Pass | | Tier | Gold | | Duração | Lifetime (enquanto possuir o NFT) | | Transferível | Sim (pode vender o membership) | | Floor Price | 0.5 ETH | **Benefícios típicos:** * Acesso a eventos exclusivos * Desconto em produtos (20%) * Votação em decisões da comunidade * Acesso antecipado a lançamentos * Canal privado no Discord **Marcas usando NFTs para fidelidade:** * Starbucks Odyssey * Nike .SWOOSH * Adidas Into the Metaverse * Porsche NFT * Reddit Collectible Avatars *** ## Principais Marketplaces de NFTs ### Marketplaces Globais | Marketplace | Blockchain | Taxas | Melhor Para | | -------------- | -------------------- | -------- | --------------------------- | | **OpenSea** | ETH, Polygon, Solana | 2.5% | Maior variedade, iniciantes | | **Blur** | Ethereum | 0% | Traders profissionais | | **Magic Eden** | Solana, ETH, Bitcoin | 2% | NFTs Solana, Ordinals | | **LooksRare** | Ethereum | 2% | Rewards em tokens | | **Rarible** | Multi-chain | 1% | Criadores independentes | | **Foundation** | Ethereum | 5% | Arte curada, premium | | **SuperRare** | Ethereum | 3% + 15% | Arte de alto valor | ### Comparativo Detalhado #### OpenSea vs Blur vs Magic Eden | Marketplace | Pros | Contras | Ideal para | | -------------- | --------------------------------------- | ----------------------------------- | ---------------------------------- | | **OpenSea** | Maior liquidez, fácil usar, multi-chain | Taxa 2.5%, interface às vezes lenta | Iniciantes, colecionadores casuais | | **Blur** | Zero taxa, agregador, ferramentas pro | Só Ethereum, curva aprendizado | Traders, flippers, volume alto | | **Magic Eden** | Líder Solana, suporta Ordinals Bitcoin | Menos NFTs Ethereum premium | NFTs Solana, Bitcoin Ordinals | ### Marketplaces e Iniciativas Brasileiras Embora não existam marketplaces brasileiros de grande escala, há iniciativas locais: **Marketplaces internacionais com artistas BR:** * OpenSea (diversos artistas brasileiros) * Foundation (artistas curados) * Objkt (Tezos - comunidade BR ativa) **Plataformas brasileiras:** * Tropix (foco em marcas brasileiras) * NFT Brasil (eventos e comunidade) * Fazendas Digitais (agro tokenizado) **Artistas brasileiros em destaque:** * Fefe Talavera * Moka * André Lemos * Giselle Beiguelman * Rejane Cantoni **Eventos:** * NFT Brasil (maior evento do país) * Blockchain Rio * Web3 Week SP *** ## Como Comprar NFTs: Passo a Passo ### Passo 1: Configurar Carteira Você precisará de uma **carteira non-custodial**. A mais popular é a MetaMask. #### Configurando MetaMask **1. Instalar:** * Acesse [metamask.io](https://metamask.io) (CUIDADO com sites falsos!) * Instale extensão Chrome/Firefox/Brave * Ou app mobile (iOS/Android) **2. Criar Carteira:** * Clique "Create Wallet" * Defina senha forte * ANOTE A SEED PHRASE (12 palavras) **NUNCA** compartilhe sua seed phrase! **NUNCA** tire foto ou salve digitalmente! Anote em papel e guarde em local seguro! **3. Adicionar Redes (opcional):** * Polygon: chainlist.org * Arbitrum, Optimism, etc. Para NFTs em **Solana**, use carteiras como: * **Phantom** (mais popular) * **Solflare** * **Backpack** ### Passo 2: Comprar Criptomoeda Você precisa de ETH (Ethereum) ou SOL (Solana) para comprar NFTs e pagar taxas de rede. **Verificando preços com a API brapi.dev:** ```typescript const response = await fetch( "https://brapi.dev/api/v2/crypto?coin=ETH¤cy=BRL", { headers: { "Authorization": "Bearer SEU_TOKEN" } } ); const data = await response.json(); const eth = data.coins[0]; console.log({ preco: eth.regularMarketPrice, para01ETH: eth.regularMarketPrice * 0.1, // Entrada comum NFT }); ``` **Onde comprar cripto no Brasil:** | Exchange | Taxas | PIX | | --------------- | --------- | --- | | Mercado Bitcoin | 0.3-0.7% | Sim | | Binance | 0.1% | Sim | | Foxbit | 0.25-0.5% | Sim | | NovaDAX | 0.2-0.5% | Sim | ### Passo 3: Transferir para Carteira Após comprar ETH/SOL na exchange: #### Transferindo para MetaMask **1. Na MetaMask:** * Clique no endereço (0x...) * "Copy to clipboard" **2. Na Exchange (ex: Binance):** * Vá em "Sacar" ou "Withdraw" * Selecione ETH * Cole o endereço da MetaMask * ESCOLHA A REDE CORRETA! **ATENÇÃO À REDE:** Para OpenSea ETH use "Ethereum (ERC20)". Para OpenSea Polygon use "Polygon". Rede errada = PERDA DE FUNDOS! **3. Confirme e aguarde:** * ETH: 5-15 minutos * Polygon: 1-5 minutos ### Passo 4: Conectar ao Marketplace #### Conectando ao OpenSea 1. Acesse [opensea.io](https://opensea.io) (verifique URL!) 2. Clique no ícone de carteira (canto superior direito) 3. Selecione "MetaMask" 4. MetaMask abrirá popup → Clique "Connect" → Confirme 5. Pronto! Sua carteira está conectada **SEGURANÇA:** Nunca conecte em sites suspeitos. Verifique SEMPRE a URL. Use bookmark para acessar marketplaces. ### Passo 5: Comprar o NFT #### Checklist antes de comprar **Pesquisa:** * [ ] Verificar se coleção é oficial (verified) * [ ] Checar volume de negociação * [ ] Analisar floor price histórico * [ ] Pesquisar sobre criador/equipe * [ ] Verificar raridade do item específico **Segurança:** * [ ] Confirmar URL do marketplace * [ ] Verificar contract address * [ ] Checar se não é coleção fake/copycat * [ ] Revisar transação antes de assinar **Financeiro:** * [ ] Ter ETH extra para gas fees * [ ] Verificar gas price atual ([etherscan.io/gastracker](https://etherscan.io/gastracker)) * [ ] Considerar se preço vale a pena * [ ] Definir quanto está disposto a perder **Tipos de compra:** | Tipo | Descrição | | ------------- | ----------------------------------------------------- | | Buy Now | Compra imediata pelo preço listado | | Make Offer | Fazer oferta abaixo do preço (pode ser aceita ou não) | | Auction | Leilão - maior lance leva | | Dutch Auction | Preço começa alto e vai caindo | *** ## Tributação de NFTs no Brasil A Receita Federal trata NFTs como **criptoativos**, seguindo as mesmas regras de tributação. ### Obrigações Fiscais #### Declaração Anual (DIRPF) * NFTs acima de R$ 5.000 devem ser declarados * Código: 08 - Criptoativos (ou 89 - Outros bens) * Informar: quantidade, custo aquisição, marketplace #### Ganho de Capital * **Isenção:** Vendas até R$ 35.000/mês (total cripto) * Acima disso, pagar imposto sobre lucro: * Até R$ 5 milhões: 15% * R$ 5M a R$ 10M: 17,5% * R$ 10M a R$ 30M: 20% * Acima R$ 30M: 22,5% * Pagar via DARF código 4600 até último dia útil mês seguinte #### Declaração Mensal (DeCripto - IN 2.291/2026) * A partir de 2026, exchanges reportam automaticamente * Operações P2P acima R$ 30.000/mês: declarar ### Calculando Imposto sobre NFTs **Exemplo prático:** | Item | Valor | | ------------------- | ------------------------ | | Preço de compra | R$ 5.000 | | Preço de venda | R$ 50.000 | | Ganho bruto | R$ 45.000 | | Total vendas no mês | R$ 50.000 | | Isento? | Não (acima de R$ 35.000) | | Alíquota | 15% | | Imposto devido | R$ 6.750 | Pagar DARF 4600 até último dia útil do mês seguinte à venda. ### Como Declarar NFTs #### Declarando NFTs na DIRPF **Ficha:** BENS E DIREITOS **Grupo:** 08 - Criptoativos **Código:** 10 - Criptoativos conhecidos como NFTs (ou 99 - Outros criptoativos) **Exemplo de discriminação:** > NFT da coleção "Bored Ape Yacht Club" #1234. Adquirido em 15/03/2024 por 2 ETH. Marketplace: OpenSea. Blockchain: Ethereum. Contract: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D. Cotação ETH na data: R$ 12.500,00. Custo total: R$ 25.000,00. * **Situação em 31/12/2023:** R$ 0,00 (se não tinha) * **Situação em 31/12/2024:** R$ 25.000,00 (custo aquisição) *** ## Riscos e Golpes Comuns ### Principais Riscos dos NFTs | Categoria | Riscos | | --------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | **Financeiro** | Perda total do investimento (comum!), Iliquidez (não conseguir vender), Floor price pode ir a zero, Mercado altamente especulativo | | **Segurança** | Phishing (sites falsos), Contratos maliciosos, Seed phrase roubada, Hacks de marketplaces | | **Projeto** | Rug pull (equipe abandona), Promessas não cumpridas, Royalties removidas, Metadata centralizada (imagem pode sumir) | | **Regulatório** | Mudanças na legislação, NFT considerado security (valor mobiliário), Bloqueio por exchanges/marketplaces | NFTs são investimentos de altíssimo risco. A maioria dos projetos (95%+) perde valor significativo ou vai a zero. Invista apenas o que pode perder completamente. ### Golpes Mais Comuns | Golpe | Descrição | Como Evitar | Sinal de Alerta | | ------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | | **Phishing** | Sites falsos imitando OpenSea, MetaMask, etc | Usar bookmarks, verificar URL letra por letra, nunca clicar links de DMs, instalar extensões anti-phishing | openseo.io, opennsea.com, metamaask.io | | **Rug Pull** | Equipe some com o dinheiro após mint | Pesquisar equipe (doxxed), verificar histórico, desconfiar de promessas exageradas, checar se contrato é renunciado | Equipe anônima + promessas de 100x | | **Wash Trading** | Volume falso para parecer popular | Verificar número de holders únicos, analisar se mesmas carteiras compram/vendem | Muito volume, poucos holders | | **Airdrop Scam** | NFT "grátis" que rouba fundos ao interagir | Nunca interagir com NFTs não solicitados, usar carteira secundária | NFT apareceu do nada na carteira | | **Fake Collection** | Coleção falsa imitando projeto famoso | Verificar badge "Verified", conferir contract address oficial | Preço muito abaixo do floor real | ### Checklist de Segurança NFT Antes de comprar qualquer NFT, verifique todos os itens desta lista para proteger seus fundos. * [ ] Usar hardware wallet para valores altos * [ ] Seed phrase em papel, local seguro * [ ] Carteira separada para mint/interações * [ ] Verificar transações antes de assinar * [ ] Revogar aprovações antigas (revoke.cash) * [ ] Nunca compartilhar tela com seed visível * [ ] Desconfiar de DMs "do suporte" * [ ] Manter pouco ETH em hot wallet *** ## Vale a Pena Investir em NFTs em 2026? ### Análise Realista do Mercado | Positivo | Negativo | | ------------------------- | -------------------------- | | Tecnologia madura | 95% dos projetos falharam | | Casos de uso reais (RWA) | Liquidez muito baixa | | Grandes marcas adotando | Especulação ainda alta | | Gaming evoluindo | Maioria não tem utilidade | | Regulamentação mais clara | Taxas ainda significativas | | Comunidades consolidadas | Mercado de nicho | **Veredito por tipo de uso:** | Objetivo | Recomendação | | ------------------------- | -------------------------- | | Investimento especulativo | **MUITO ARRISCADO** | | Utilidade específica | Pode fazer sentido | | Arte/Colecionismo | Para quem valoriza a arte | | Aprender sobre Web3 | Excelente forma de começar | ### Quando PODE Fazer Sentido | Perfil | Objetivo | Expectativa | Valor OK perder | Recomendação | | ---------------------------- | ----------------------------------------- | ------------------------------------- | --------------------------------------- | --------------------------------------------- | | **Colecionador de Arte** | Apoiar artistas e colecionar arte digital | Valorização artística, não financeira | 100% do investido | Art Blocks, Foundation, artistas curados | | **Gamer** | Possuir itens de jogos com valor real | Usar no jogo + possível revenda | Considere como gasto com entretenimento | Gods Unchained, Illuvium, jogos estabelecidos | | **Entusiasta de Tecnologia** | Aprender sobre Web3 na prática | Educação, não retorno financeiro | Valor de um curso | Começar com NFTs baratos em Polygon/Solana | | **Investidor Alto Risco** | Especulação com potencial alto retorno | Perda total ou ganhos expressivos | 5-10% do patrimônio de alto risco | Blue chips: CryptoPunks, BAYC, Pudgy Penguins | ### Quando NÃO Comprar NFTs Evite NFTs se você se encaixa em qualquer um desses cenários: * Esperando ficar rico rápido * Usando dinheiro que não pode perder * Sem entender a tecnologia básica * Por FOMO (medo de perder oportunidade) * Porque influencer recomendou * Como única forma de investimento ### Estratégia Prudente para 2026 **1. Alocação Máxima** * Máximo 1-5% do patrimônio total * Apenas dinheiro que pode perder 100% **2. Diversificação** * Diferentes coleções (se for comprar múltiplos) * Diferentes blockchains * Diferentes casos de uso **3. Due Diligence** * Pesquisar equipe por dias/semanas * Entrar em comunidade antes de comprar * Verificar contract, royalties, metadata **4. Gestão de Risco** * Definir stop-loss mental * Não "dobrar" em projeto caindo * Aceitar perda e seguir em frente **5. Segurança** * Hardware wallet para valores > R$ 5.000 * Carteira separada para mints * Backup da seed phrase offline *** ## Casos de Sucesso e Fracasso ### Casos de Sucesso | Projeto | Investimento Inicial | Resultado | Observação | | -------------- | ------------------------- | --------------------------------- | ---------------------- | | CryptoPunks | Free mint (2017) | Até $23M por unidade | Pioneiros, histórico | | BAYC | 0.08 ETH (\~$190) | Floor $50k+ (pico $400k) | Comunidade forte | | Art Blocks | Variado | Artistas vendendo por 6-7 dígitos | Arte generativa curada | | Pudgy Penguins | Quase morreu, nova equipe | Reviveu, licenciamento Walmart | Execução importa | ### Casos de Fracasso | Projeto | O que aconteceu | Lição | | ---------------- | --------------------------- | ------------------------------- | | Pixelmon | Mint de $70M, arte terrível | Due diligence é essencial | | Frosties | Rug pull após mint | Equipe anônima = risco | | Azuki Elementals | Coleção derivada fraca | Mesmo projetos bons podem errar | | 95% dos projetos | Floor foi a zero | Maioria não sobrevive | *** ## Ferramentas Úteis ### Análise de Mercado | Ferramenta | URL | Uso | | --------------- | ----------------- | -------------------- | | NFTGo | nftgo.io | Analytics, rankings | | DappRadar | dappradar.com | Rankings, volume | | CryptoSlam | cryptoslam.io | Vendas, estatísticas | | NFT Price Floor | nftpricefloor.com | Histórico preços | ### Raridade | Ferramenta | URL | Uso | | ------------- | ---------------- | ----------------- | | Rarity Sniper | raritysniper.com | Rankings raridade | | Trait Sniper | traitsniper.com | Extensão Chrome | | HowRare.is | howrare.is | Raridade Solana | ### Segurança | Ferramenta | URL | Uso | | --------------- | ------------------ | ------------------ | | Revoke.cash | revoke.cash | Revogar aprovações | | Wallet Guard | walletguard.app | Extensão segurança | | Pocket Universe | pocketuniverse.app | Simular transações | ### Gas (Taxas) | Ferramenta | URL | Uso | | ------------- | ----------------------- | ------------- | | Etherscan Gas | etherscan.io/gastracker | Gas price ETH | | GasNow | gasnow\.org | Previsão gas | *** ## Monitorando Mercado Cripto com brapi.dev Acompanhe as criptomoedas usadas para comprar NFTs: ```typescript // Monitorar preços das principais criptos para NFTs const moedas = ["ETH", "SOL", "MATIC", "BTC"]; for (const moeda of moedas) { const response = await fetch( `https://brapi.dev/api/v2/crypto?coin=${moeda}¤cy=BRL`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); const coin = data.coins[0]; console.log({ moeda: coin.coinName, preco: coin.regularMarketPrice, variacao24h: coin.regularMarketChangePercent, }); } ``` | Moeda | Uso em NFTs | | --------- | ------------------------------ | | **ETH** | 0.1 ETH = entrada comum em NFT | | **SOL** | 5 SOL = NFTs Solana | | **MATIC** | NFTs Polygon (taxas baixas) | | **BTC** | Bitcoin Ordinals | ### ETFs de Cripto na Bolsa Brasileira Alternativa regulada para exposição ao mercado cripto: ```typescript // Monitorar ETFs de cripto na bolsa brasileira const etfs = ["HASH11", "BITH11", "ETHE11", "QBTC11"]; for (const etf of etfs) { const response = await fetch(`https://brapi.dev/api/quote/${etf}`, { headers: { Authorization: "Bearer SEU_TOKEN" }, }); const data = await response.json(); const result = data.results[0]; console.log({ etf, preco: result.regularMarketPrice, variacao: result.regularMarketChangePercent, }); } ``` Dica: ETH em alta pode significar NFTs mais caros em BRL. Monitore as criptos antes de comprar. *** ## FAQ - Perguntas Frequentes ### O que são NFTs? NFTs (Non-Fungible Tokens) são tokens únicos em blockchain que representam propriedade de ativos digitais como arte, itens de jogos, colecionáveis e até ativos do mundo real. Diferente de criptomoedas, cada NFT é único e não intercambiável. ### Como comprar meu primeiro NFT? 1. Instale uma carteira (MetaMask para Ethereum, Phantom para Solana), 2) Compre cripto (ETH ou SOL) em uma exchange brasileira, 3) Transfira para sua carteira, 4) Conecte ao marketplace (OpenSea, Magic Eden), 5) Escolha e compre o NFT. ### NFTs ainda valem a pena em 2026? Depende do objetivo. Como investimento especulativo, são muito arriscados - 95% dos projetos perderam valor. Para colecionismo, gaming, ou aprender sobre Web3, podem fazer sentido. Invista apenas o que pode perder completamente. ### Como declarar NFTs no Imposto de Renda? NFTs acima de R$ 5.000 devem ser declarados na ficha "Bens e Direitos", grupo 08, código 10 (ou 99). Informe descrição, data de aquisição, custo em reais. Vendas acima de R$ 35.000/mês pagam ganho de capital via DARF 4600. ### Qual a diferença entre OpenSea, Blur e Magic Eden? OpenSea é o maior e mais fácil para iniciantes (taxa 2.5%). Blur é para traders profissionais com zero taxa. Magic Eden lidera em Solana e Bitcoin Ordinals. Escolha baseado na blockchain e seu perfil. ### Quais são os maiores riscos dos NFTs? Perda total do investimento, iliquidez, golpes (phishing, rug pulls), projetos abandonados, regulamentação futura, e roubo de carteira. Sempre use carteira segura e pesquise antes de comprar. ### NFTs são regulamentados no Brasil? Sim, NFTs são tratados como criptoativos pela Receita Federal (IN 2.291/2026). Devem ser declarados e vendas com lucro acima de R$ 35.000/mês pagam imposto. A Lei 14.478/2022 também se aplica a prestadores de serviços de criptoativos. ### Posso criar meus próprios NFTs? Sim! Plataformas como OpenSea, Rarible e Manifold permitem criar (mintar) NFTs sem conhecimento técnico. Você paga apenas as taxas de rede. Artistas brasileiros têm tido sucesso em plataformas como Foundation e Objkt. *** ## Conclusão O mercado de NFTs em 2026 é drasticamente diferente do hype de 2021. A especulação desenfreada deu lugar a casos de uso mais práticos e comunidades mais maduras. No entanto, os riscos permanecem muito altos para a maioria dos investidores. **Pontos-chave para lembrar:** 1. **Não é para todos** - NFTs são investimento de altíssimo risco 2. **Pesquise muito** - Due diligence pode evitar perdas 3. **Segurança primeiro** - Use hardware wallet, verifique tudo 4. **Declare corretamente** - Evite problemas com a Receita Federal 5. **Limite exposição** - Máximo 1-5% do patrimônio 6. **Tecnologia tem valor** - Mesmo se especulação diminuir Se decidir entrar no mundo dos NFTs, faça com consciência, educação e preparado para perder o valor investido. Para quem quer exposição ao mercado cripto de forma mais segura, considere [ETFs de criptomoedas na bolsa brasileira](/blog/etfs-criptomoedas-b3-hash11-bith11-guia-2026) como alternativa regulada. *** ## Recursos Adicionais * **[Carteiras de Criptomoedas: Guia de Segurança](/blog/carteiras-criptomoedas-guia-seguranca-2026)** - Como proteger seus NFTs * **[Como Declarar Criptomoedas no IR](/blog/como-declarar-criptomoedas-imposto-renda-2026)** - Tributação completa * **[Ethereum: Guia Completo](/blog/ethereum-eth-guia-completo-brasil-2026)** - Blockchain principal de NFTs * **[Solana: Guia Completo](/blog/solana-sol-guia-completo-brasil-2026)** - Alternativa com taxas baixas * **[DeFi para Iniciantes](/blog/defi-financas-descentralizadas-guia-iniciantes-2026)** - Entenda o ecossistema Web3 *** *Disclaimer: Este conteúdo é educacional e não constitui recomendação de investimento. NFTs são ativos de altíssimo risco com possibilidade de perda total do capital investido. Faça sua própria pesquisa e consulte um profissional financeiro antes de investir. A brapi.dev não se responsabiliza por decisões de investimento baseadas neste conteúdo.* # Novos Módulos brapi 2026: Fluxo de Caixa, DVA e Detalhes Trimestrais URL: /blog/novos-modulos-fluxo-de-caixa-dva.mdx Amplie sua análise financeira com os novos módulos da brapi! Fluxo de Caixa, DVA e históricos trimestrais detalhados para análises mais profundas e precisas ✓ *** searchable: true title: 'Novos Módulos brapi 2026: Fluxo de Caixa, DVA e Detalhes Trimestrais' description: 'Amplie sua análise financeira com os novos módulos da brapi! Fluxo de Caixa, DVA e históricos trimestrais detalhados para análises mais profundas e precisas ✓' date: '2026-01-01' keywords: 'novos módulos brapi, fluxo de caixa API, DVA demonstração valor adicionado, dados trimestrais, API brapi atualização, módulos análise financeira, 2026' author: 'Equipe brapi.dev' category: 'API e Desenvolvimento' subcategory: 'Novos Módulos' readingTime: '8 min' tags: \['Novos Módulos', 'Fluxo de Caixa', 'DVA', 'Dados Trimestrais', 'API brapi', 'Atualização', 'Análise Financeira', 'Desenvolvimento'] relatedPosts: \['analise-financeira-com-modulo-balance-sheet-history', 'b3-api-gratuita-como-usar-cotacoes', 'demonstrativos-financeiros-um-olhar-detalhado-na-saude-financeira-da-empresa', 'novos-modulos-na-brapi', 'lancamento-sdks-oficiais-typescript-python'] featured: false expertise: 'Equipe técnica da brapi.dev especializada em desenvolvimento de módulos e estruturação de dados financeiros' lastReviewed: '2026-01-01' -------------------------- import { Authors, Author } from '~/components/Authors'; > O time da brapi não para! Após a recente modernização que trouxe Balanços > Patrimoniais, Demonstrações de Resultados e Principais Estatísticas, temos o > prazer de anunciar uma nova leva de módulos para aprofundar ainda mais suas > análises. Esta atualização é focada em dados cruciais para entender a > liquidez, a geração e distribuição de valor, e a evolução financeira das > empresas em uma granularidade sem precedentes. ## Por onde começar? Para começar a explorar os novos módulos, basta acessar a documentação da API através do link abaixo: [Documentação da API](https://brapi.dev/docs/acoes) Mas para os mais apressados, vamos dar uma olhada em alguns exemplos de como utilizar os novos módulos nos próximos tópicos. *** ## Quais são as novidades? A API da brapi agora conta com 6 novos módulos (ou aprimoramentos de módulos existentes com granularidade trimestral) que oferecem informações financeiras ainda mais detalhadas sobre as empresas. Esses módulos são: * [Demonstração de Fluxo de Caixa Histórico (cashflowHistory)](#demonstração-de-fluxo-de-caixa-histórico-cashflowhistory) * [Demonstração do Valor Adicionado Histórico (valueAddedHistory)](#demonstração-do-valor-adicionado-histórico-valueaddedhistory) * [Dados Financeiros Históricos Trimestrais (financialDataHistoryQuarterly)](#dados-financeiros-históricos-trimestrais-financialdatahistoryquarterly) * [Principais Estatísticas Históricas Trimestrais (defaultKeyStatisticsHistoryQuarterly)](#principais-estatísticas-históricas-trimestrais-defaultkeystatisticshistoryquarterly) ### Demonstração de Fluxo de Caixa Histórico (cashflowHistory) A Demonstração de Fluxo de Caixa é um dos pilares da análise financeira, mostrando como uma empresa gera e usa seu dinheiro em atividades operacionais, de investimento e de financiamento. Entender a DFC é crucial para avaliar a liquidez e a saúde financeira real de uma companhia, indo além do lucro contábil. Com este módulo, você pode acompanhar a capacidade da empresa de gerar caixa e gerenciar seus recursos. * Exemplo de requisição para dados **anuais**: ```sh GET https://brapi.dev/api/quote/PETR4?modules=cashflowHistory Authorization: Bearer SEU_TOKEN ``` Para obter dados **trimestrais**, basta utilizar o módulo `cashflowHistoryQuarterly`: ```sh GET https://brapi.dev/api/quote/PETR4?modules=cashflowHistoryQuarterly Authorization: Bearer SEU_TOKEN ``` *Exemplo (dados simplificados):* ```json { "cashflowHistory": { "cashflowHistory": [ { "type": "yearly", "endDate": "2022-12-31T00:00:00.000Z", // Data de Encerramento "operatingCashFlow": 225613004800, // Fluxo de Caixa das Atividades Operacionais (FCO) "investmentCashFlow": -132009000000, // Fluxo de Caixa das Atividades de Investimento (FCI) "financingCashFlow": -152340000000, // Fluxo de Caixa das Atividades de Financiamento (FCF) "increaseOrDecreaseInCash": -58736000000, // Aumento ou Redução Líquida de Caixa "initialCashBalance": 100459000000, // Saldo Inicial de Caixa "finalCashBalance": 41723000000, // Saldo Final de Caixa "updatedAt": "2023-11-21T00:00:00.000Z" } // + outros anos ou trimestres se for quarterly ] } } ``` *** ### Demonstração do Valor Adicionado Histórico (valueAddedHistory) A Demonstração do Valor Adicionado é um demonstrativo contábil que mostra a riqueza criada pela empresa e como essa riqueza é distribuída entre as partes interessadas: empregados (salários), governo (impostos), credores (juros), e acionistas (dividendos/lucros retidos). Essencial para análises de responsabilidade social e contribuição econômica da empresa. * Exemplo de requisição para dados **anuais**: ```sh GET https://brapi.dev/api/quote/PETR4?modules=valueAddedHistory Authorization: Bearer SEU_TOKEN ``` Para obter dados **trimestrais**, basta utilizar o módulo `valueAddedHistoryQuarterly`: ```sh GET https://brapi.dev/api/quote/PETR4?modules=valueAddedHistoryQuarterly Authorization: Bearer SEU_TOKEN ``` *Exemplo (dados simplificados):* ```json { "valueAddedHistory": { "valueAddedHistory": [ { "type": "yearly", "endDate": "2022-12-31T00:00:00.000Z", // Data de Encerramento "revenue": 641256000000, // Receitas "suppliesPurchasedFromThirdParties": 307156000000, // Insumos Adquiridos de Terceiros "grossAddedValue": 334100000000, // Valor Adicionado Bruto "retentions": 4087000000, // Retenções (Depreciação, Amortização, etc.) "netAddedValue": 330013000000, // Valor Adicionado Líquido Produzido "addedValueReceivedByTransfer": 28530000000, // Valor Adicionado Recebido em Transferência "addedValueToDistribute": 358543000000, // Valor Adicionado Total a Distribuir "distributionOfAddedValue": 358543000000, // Distribuição do Valor Adicionado "teamRemuneration": 15000000000, // Pessoal e Encargos "taxes": 85993000000, // Impostos, Taxas e Contribuições "remunerationOfThirdPartyCapitals": 13790000000, // Remuneração de Capitais de Terceiros "equityRemuneration": 243760000000, // Remuneração de Capitais Próprios (JCP, Dividendos, Lucros Retidos) "updatedAt": "2023-11-21T00:00:00.000Z" } // + outros anos ou trimestres se for quarterly ] } } ``` *** ### Dados Financeiros Históricos Trimestrais (financialDataHistoryQuarterly) Enquanto o módulo `financialData` já oferece dados financeiros importantes (como margens, EBITDA, dívida líquida, e fluxos de caixa) em base TTM (Trailing Twelve Months), a introdução do `financialDataHistoryQuarterly` permite que você acesse essas mesmas métricas em um histórico **trimestral**. Isso é fundamental para acompanhar tendências de curto prazo, identificar viradas e a performance da empresa de forma mais ágil e detalhada. * Exemplo de requisição para dados **trimestrais**: ```sh GET https://brapi.dev/api/quote/PETR4?modules=financialDataHistoryQuarterly Authorization: Bearer SEU_TOKEN ``` *Exemplo (dados simplificados):* ```json { "financialDataHistoryQuarterly": { "financialDataHistoryQuarterly": [ { "type": "quarterly", "endDate": "2023-09-30T00:00:00.000Z", // Fim do Trimestre "totalRevenue": 105807000000, // Receita Total do Trimestre "profitMargins": 0.22, // Margem de Lucro Trimestral "ebitda": 56000000000, // EBITDA Trimestral "returnOnEquity": 0.08, // Retorno sobre Patrimônio Líquido Trimestral "revenueGrowth": -0.09, // Crescimento da Receita (YoY Trimestral) "operatingCashflow": 60000000000, // Fluxo de Caixa Operacional Trimestral "financialCurrency": "BRL", "updatedAt": "2023-12-10T00:00:00.000Z" } // + outros trimestres ] } } ``` *** ### Principais Estatísticas Históricas Trimestrais (defaultKeyStatisticsHistoryQuarterly) Da mesma forma que os dados financeiros, o `defaultKeyStatisticsHistoryQuarterly` traz a granularidade trimestral para as principais estatísticas. Agora você pode analisar a evolução de indicadores cruciais como P/L (Preço/Lucro), P/VP (Preço/Valor Patrimonial), ROE (Retorno sobre Patrimônio Líquido) e o crescimento dos lucros trimestralmente. Isso permite uma visão mais dinâmica da valoração, rentabilidade e eficiência da empresa, com dados mais recentes para embasar suas decisões. * Exemplo de requisição para dados **trimestrais**: ```sh GET https://brapi.dev/api/quote/PETR4?modules=defaultKeyStatisticsHistoryQuarterly Authorization: Bearer SEU_TOKEN ``` *Exemplo (dados simplificados):* ```json { "defaultKeyStatisticsHistoryQuarterly": { "defaultKeyStatisticsHistoryQuarterly": [ { "type": "quarterly", "endDate": "2023-09-30T00:00:00.000Z", // Fim do Trimestre "forwardPE": 4.39, // P/L Projetado "profitMargins": 0.25527, // Margem de Lucro "sharesOutstanding": 5545639936, // Ações em Circulação "bookValue": 29.658, // Valor Patrimonial por Ação (VPA) "priceToBook": 1.1892238, // Preço/VPA "earningsQuarterlyGrowth": -0.422, // Crescimento dos Lucros Trimestrais (YoY) "trailingEps": 10.13, // Lucro por Ação (TTM) "enterpriseToRevenue": 1.303, // EV/Receita (TTM) "lastDividendValue": 1.345348, // Último Dividendo Pago "updatedAt": "2023-12-10T00:00:00.000Z" } // + outros trimestres ] } } ``` *** ## Conclusão Com a adição dos módulos de **Fluxo de Caixa** e **Demonstração do Valor Adicionado**, somados à granularidade **trimestral** para dados financeiros e estatísticas-chave, a API da brapi se consolida como uma ferramenta indispensável para quem busca uma análise financeira realmente profunda e atualizada. Essas novidades capacitam desenvolvedores, analistas e investidores a entender não apenas "quanto" uma empresa lucra, mas "como" ela gera e utiliza seu caixa, e "como" a riqueza que ela cria é distribuída. Isso permite modelagens mais sofisticadas, backtests mais precisos e, o mais importante, decisões de investimento mais informadas e estratégicas. Não perca tempo e comece a explorar as novidades agora mesmo para levar suas análises a um novo patamar! *Observação: Certifique-se de utilizar o token apropriado ao realizar suas consultas.* *** **Esperamos que essas adições enriqueçam ainda mais suas análises!** # Novos Módulos brapi: Balanços, Demonstrativos e Estatísticas Avançadas URL: /blog/novos-modulos-na-brapi.mdx Descubra os novos módulos da API brapi! Balanços patrimoniais, demonstrativos de resultados e estatísticas para análises financeiras mais completas e precisas ✓ *** searchable: true title: 'Novos Módulos brapi: Balanços, Demonstrativos e Estatísticas Avançadas' description: 'Descubra os novos módulos da API brapi! Balanços patrimoniais, demonstrativos de resultados e estatísticas para análises financeiras mais completas e precisas ✓' date: '2026-01-01' keywords: 'módulos brapi API, balanços patrimoniais, demonstrativos resultados, estatísticas financeiras, API atualização, dados empresariais, análise fundamentalista, 2026' author: 'Equipe brapi.dev' category: 'API e Desenvolvimento' subcategory: 'Módulos Core' readingTime: '10 min' tags: \['Módulos brapi', 'Balanços', 'Demonstrativos', 'Estatísticas', 'API', 'Dados Financeiros', 'Atualização', 'Análise'] relatedPosts: \['novos-modulos-fluxo-de-caixa-dva', 'analise-financeira-com-modulo-balance-sheet-history', 'b3-api-gratuita-como-usar-cotacoes', 'lancamento-sdks-oficiais-typescript-python'] featured: false expertise: 'Equipe técnica da brapi.dev com foco em desenvolvimento de módulos fundamentais e estruturação de dados' lastReviewed: '2026-01-01' -------------------------- import { Authors, Author } from '~/components/Authors'; > O time da brapi tem o prazer de revelar a mais recente modernização da sua > API, introduzindo novos módulos que fornecem insights valiosos sobre várias > empresas. Estas adições inovadoras proporcionam uma visão abrangente, que se > estende desde o perfil sumário da empresa até dados financeiros fundamentais. > Vamos mergulhar nas fascinantes novidades! *** ## Por onde começar? Para começar a explorar os novos módulos, basta acessar a documentação da API através do link abaixo: [Documentação da API](https://brapi.dev/docs/acoes#modules-opcional) Mas para os mais apressados, vamos dar uma olhada em alguns exemplos de como utilizar os novos módulos nos próximos tópicos. *** ## Quais são as novidades? A API da brapi agora conta com 5 novos módulos, que oferecem informações detalhadas sobre as empresas. Esses módulos são: * [Resumo da Empresa (summaryProfile)](#resumo-da-empresa-summaryprofile) * [Balanço Patrimonial Histórico (balanceSheetHistory)](#balanço-patrimonial-histórico-balancesheethistory) * [Principais Estatísticas da Empresa (defaultKeyStatistics)](#principais-estatísticas-da-empresa-defaultkeystatistics) * [Demonstrativo de Resultados Histórico (incomeStatementHistory)](#demonstrativo-de-resultados-histórico-incomestatementhistory) * [Dados Financeiros (financialData)](#dados-financeiros-financialdata) ### Resumo da Empresa (summaryProfile) O módulo *summaryProfile* oferece uma visão abrangente da empresa, incluindo informações vitais sobre sua sede, setor, número de funcionários e muito mais. Com esta adição útil, os usuários podem obter uma compreensão rápida e detalhada da empresa que estão analisando. * Exemplo de requisição: ```sh GET https://brapi.dev/api/quote/PETR4?modules=summaryProfile Authorization: Bearer SEU_TOKEN ``` *Exemplo:* ```json { "address1": "Avenida RepUblica do Chile, 65", // Endereço "address2": "Centro", // Endereço "city": "Rio De Janeiro", // Cidade "state": "RJ", // Estado "zip": "20031-912", // CEP "country": "Brazil", // País "phone": "55 21 96940 2116", // Telefone "website": "https://petrobras.com.br", // Website "industry": "Oil & Gas Integrated", // Indústria "industryKey": "oil-gas-integrated", // Indústria "industryDisp": "Oil & Gas Integrated", // Indústria "sector": "Energy", // Setor "sectorKey": "energy", // Setor "sectorDisp": "Energy", // Setor "longBusinessSummary": "Petróleo Brasileiro S.A. - Petrobras explores, produces, and sells oil and gas in Brazil and internationally. The company operates through Exploration and Production; Refining, Transportation and Marketing; and Gas and Power. It also engages in prospecting, drilling, refining, processing, trading, and transporting crude oil from producing onshore and offshore oil fields, and shale or other rocks, as well as oil products, natural gas, and other liquid hydrocarbons. The Exploration and Production segment explores, develops, and produces crude oil, natural gas liquids, and natural gas primarily for supplies to the domestic refineries. The Refining, Transportation and Marketing segment engages in the refining, logistics, transport, marketing, and trading of crude oil and oil products; exportation of ethanol; and extraction and processing of shale, as well as holding interests in petrochemical companies. The Gas and Power segment is involved in the logistic and trading of natural gas and electricity; transportation and trading of LNG; generation of electricity through thermoelectric power plants; holding interests in transportation and distribution of natural gas; and fertilizer production and natural gas processing business. In addition, the company produces biodiesel and its co-products, and ethanol; and distributes oil products. Further, it engages in research, development, production, transport, distribution, and trading of energy. Petróleo Brasileiro S.A. - Petrobras was incorporated in 1953 and is headquartered in Rio de Janeiro, Brazil.", // Descrição da empresa "fullTimeEmployees": 45149, // Número de funcionários "companyOfficers": [] // Diretores } ``` *** ### Balanço Patrimonial Histórico (balanceSheetHistory) O módulo *balanceSheetHistory* permite uma análise minuciosa dos ativos, passivos e patrimônio líquido da empresa em um determinado período. Estes dados são fundamentais para avaliar a saúde financeira da empresa ao longo do tempo. [Ler mais sobre o Balanço Patrimonial](/blog/analise-financeira-com-modulo-balance-sheet-history) * Exemplo de requisição: ```sh GET https://brapi.dev/api/quote/PETR4?modules=balanceSheetHistory Authorization: Bearer SEU_TOKEN ``` Para obter dados trimestrais, basta utilizar o módulo *balanceSheetHistoryQuarterly*: ```sh GET https://brapi.dev/api/quote/PETR4?modules=balanceSheetHistoryQuarterly Authorization: Bearer SEU_TOKEN ``` *Exemplo:* ```json { ... "balanceSheetHistory": { "balanceSheetStatements": [ { "endDate": "2022-12-31T00:00:00.000Z", // Data de Encerramento "cash": 41723000000, // Caixa e Equivalentes de Caixa "shortTermInvestments": 14470000000, // Aplicações Financeiras "netReceivables": 32961000000, // Contas a Receber "inventory": 45804000000, // Estoques "otherCurrentAssets": 28094000000, // Outros Ativos Circulantes "totalCurrentAssets": 163052000000, // Ativo Circulante "longTermInvestments": 16331000000, // Investimentos a Longo Prazo "propertyPlantEquipment": 679182000000, // Imobilizado "goodWill": 123000000, // Goodwill "intangibleAssets": 15458000000, // Ativos Intangíveis "otherAssets": 102563000000, // Outros Ativos "deferredLongTermAssetCharges": 4342000000, // Encargos de Ativos Diferidos a Longo Prazo "totalAssets": 976709000000, // Ativo Total "accountsPayable": 28507000000, // Contas a Pagar "shortLongTermDebt": 18656000000, // Dívida de Curto e Longo Prazo "otherCurrentLiab": 60989000000, // Outras Obrigações Correntes "longTermDebt": 137630000000, // Dívida de Longo Prazo "otherLiab": 215540000000, // Outras Obrigações "minorityInterest": 1791000000, // Interesse Minoritário "totalCurrentLiabilities": 163731000000, // Passivo Circulante "totalLiab": 612324000000, // Passivo Total "commonStock": 205432000000, // Ações Ordinárias "retainedEarnings": 128562000000, // Lucros Retidos "treasuryStock": 28600000000, // Ações em Tesouraria "otherStockholderEquity": 28600000000, // Outros Patrimônios de Acionistas "totalStockholderEquity": 362594000000, // Patrimônio Líquido Total "netTangibleAssets": 347013000000 // Ativos Tangíveis Líquidos } // + outros anos ou trimestres ] } } ``` *** ### Principais Estatísticas da Empresa (defaultKeyStatistics) O módulo *defaultKeyStatistics* oferece uma visão aprofundada das principais estatísticas da empresa, desde o valor da empresa até o crescimento dos ganhos. Esses dados são cruciais para investidores que desejam tomar decisões informadas. * Exemplo de requisição: ```sh GET https://brapi.dev/api/quote/PETR4?modules=defaultKeyStatistics Authorization: Bearer SEU_TOKEN ``` *Exemplo:* ```json { ... "defaultKeyStatistics": { "priceHint": 2, "enterpriseValue": 698842480640, // Valor da empresa "forwardPE": 4.3977556, // Preço da ação / Lucro por ação "profitMargins": 0.25527, // Lucro líquido / Receita "floatShares": 8239310319, // Ações em circulação "sharesOutstanding": 5545639936, // Ações em circulação "heldPercentInsiders": 0.16073, // Porcentagem de ações em posse de insiders "heldPercentInstitutions": 0.35612, // Porcentagem de ações em posse de instituições "beta": 1.088, // Mede a volatilidade da ação em relação ao mercado "impliedSharesOutstanding": 13511199744, // Ações em circulação "category": null, // categoria "bookValue": 29.658, // VPA - Valor Patrimonial por Ação "priceToBook": 1.1892238, // Preço da ação / Valor patrimonial por ação (P/VPA) "fundFamily": null, // Fundo "legalType": null, // Tipo legal "lastFiscalYearEnd": "2022-12-31T00:00:00.000Z", // Último ano fiscal "nextFiscalYearEnd": "2023-12-31T00:00:00.000Z", // Próximo ano fiscal "mostRecentQuarter": "2023-09-30T00:00:00.000Z", // Último trimestre "earningsQuarterlyGrowth": -0.422, // Crescimento dos lucros trimestrais "netIncomeToCommon": 136903999488, // Lucro líquido "trailingEps": 10.13, // Lucro por ação dos últimos 12 meses "forwardEps": 8.02, // Lucro por ação estimado para os próximos 12 meses "pegRatio": -0.6, // Preço da ação / Lucro por ação / Crescimento dos lucros "lastSplitFactor": "2:1", // Split "lastSplitDate": 1209340800, // Data do split "enterpriseToRevenue": 1.303, // Valor da empresa / Receita "enterpriseToEbitda": 2.636, // Valor da empresa / EBITDA "52WeekChange": 0.44786537, // Variação da ação nos últimos 52 semanas "SandP52WeekChange": 0.15020406, "lastDividendValue": 1.345348, // Dividendos pagos "lastDividendDate": "2023-11-22T00:00:00.000Z" // Data do último pagamento de dividendos } } ``` *** ### Demonstrativo de Resultados Histórico (incomeStatementHistory) Com o módulo *incomeStatementHistory*, é possível analisar detalhadamente receitas e despesas ao longo do tempo, proporcionando insights valiosos sobre o desempenho financeiro da empresa. * Exemplo de requisição: ```sh GET https://brapi.dev/api/quote/PETR4?modules=incomeStatementHistory Authorization: Bearer SEU_TOKEN ``` *Exemplo:* ```json { ... "incomeStatementHistory": { "incomeStatementHistory": [ { "endDate": "2022-12-31T00:00:00.000Z", // Data de encerramento "totalRevenue": 641256000000, // Receita de Venda de Bens e/ou Serviços "costOfRevenue": 307156000000, // Custo dos Bens e/ou Serviços Vendidos "grossProfit": 334100000000, // Resultado Bruto "researchDevelopment": 4087000000, // Custos com pesquisa e desenvolvimento tecnológico "sellingGeneralAdministrative": 32325000000, // Despesas Gerais e Administrativas "nonRecurring": null, // Perdas pela Não Recuperabilidade de Ativos "otherOperatingExpenses": -10922000000, // Outras Despesas Operacionais "totalOperatingExpenses": 337728000000, // Despesas/Receitas Operacionais "operatingIncome": 303528000000, // Resultado Antes do Resultado Financeiro e dos Tributos "totalOtherIncomeExpenseNet": -28530000000, // Resultado Financeiro "ebit": 303528000000, // Resultado Antes dos Tributos sobre o Lucro (EBIT - Earnigs Before Interest and Taxes) "interestExpense": -13790000000, // Despesas Financeiras "incomeBeforeTax": 274998000000, // Resultado Antes dos Tributos sobre o Lucro "incomeTaxExpense": 85993000000, // Imposto de Renda e Contribuição Social sobre o Lucro "minorityInterest": 1791000000, // Participação de acionistas minoritários "netIncomeFromContinuingOps": 189005000000, // Resultado Líquido das Operações Continuadas "discontinuedOperations": null, // Resultado Líquido de Operações Descontinuadas "extraordinaryItems": null, // Itens Extraordinários "effectOfAccountingCharges": null, // Efeito das Mudanças nas Contas "otherItems": null, // Outros itens "netIncome": 188328000000, // Lucro/Prejuízo do Período (Lucro líquido) "netIncomeApplicableToCommonShares": 188328000000 // Lucro/Prejuízo do Período Atribuído a Sócios da Empresa Controladora } // + outros anos ou trimestres ] } } ``` *** ### Dados Financeiros (financialData) Por fim, o módulo *financialData* fornece dados financeiros essenciais, incluindo preço atual, lucro por ação, crescimento de receita e muito mais. Essas informações são cruciais para avaliar o desempenho financeiro atual da empresa. * Exemplo de requisição: ```sh GET https://brapi.dev/api/quote/PETR4?modules=financialData Authorization: Bearer SEU_TOKEN ``` *Exemplo:* ```json { "financialData": { "currentPrice": 35.27, // Preço atual "targetHighPrice": 49, // Preço alvo alto "targetLowPrice": 26, // Preço alvo baixo "targetMeanPrice": 38.5, // Preço alvo médio "targetMedianPrice": 38.5, // Preço alvo mediano "recommendationMean": 2.5, // Recomendação média "recommendationKey": "buy", // Recomendação "numberOfAnalystOpinions": 12, // Número de opiniões de analistas "totalCash": 67147001856, // Caixa total "totalCashPerShare": 5.159, // Caixa total por ação "ebitda": 265149005824, // EBITDA - Earnings Before Interest, Taxes, Depreciation and Amortization (Lucro antes de juros, impostos, depreciação e amortização) "totalDebt": 305451008000, // Dívida total "quickRatio": 0.638, // Liquidez imediata "currentRatio": 0.953, // Liquidez corrente "totalRevenue": 536315002880, // Receita total "debtToEquity": 78.828, // Dívida / Patrimônio líquido "revenuePerShare": 41.123, // Receita por ação "returnOnAssets": 0.13949001, // Retorno sobre ativos "returnOnEquity": 0.36110002, // Retorno sobre patrimônio líquido "grossProfits": 334100000000, // Lucro bruto "freeCashflow": 191622742016, // Fluxo de caixa livre "operatingCashflow": 225613004800, // Fluxo de caixa operacional "earningsGrowth": -0.422, // Crescimento dos lucros "revenueGrowth": -0.266, // Crescimento da receita "grossMargins": 0.51079, // Margem bruta "ebitdaMargins": 0.49438998, // Margem EBITDA "operatingMargins": 0.40989, // Margem operacional "profitMargins": 0.25527, // Margem de lucro "financialCurrency": "BRL" // Moeda } } ``` *** ## Conclusão Com esses novos módulos, a API da brapi capacita os desenvolvedores, pesquisadores e investidores a explorarem informações detalhadas sobre empresas, permitindo análises mais aprofundadas e decisões mais informadas. Não perca tempo e comece a explorar as novidades agora mesmo! *Observação: Certifique-se de utilizar o token apropriado ao realizar suas consultas.* *** **Esperamos que essas adições enriqueçam ainda mais suas análises!** # O Que é Bolsa de Valores 2026: Como Funciona a Bolsa Brasileira URL: /blog/o-que-e-bolsa-de-valores-como-funciona-b3.mdx Entenda o que é a bolsa de valores e como funciona a bolsa brasileira! Guia completo sobre pregão, horários, índices e como as ações são negociadas no mercado brasileiro ✓ *** searchable: true title: 'O Que é Bolsa de Valores 2026: Como Funciona a Bolsa Brasileira' description: 'Entenda o que é a bolsa de valores e como funciona a bolsa brasileira! Guia completo sobre pregão, horários, índices e como as ações são negociadas no mercado brasileiro ✓' date: '2026-01-01' keywords: 'o que é bolsa de valores, como funciona a bolsa brasileira, bolsa brasileira, pregão eletrônico, Ibovespa, mercado de ações Brasil, bolsa de valores explicação, horário bolsa' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Conceitos Básicos' readingTime: '15 min' tags: \['Bolsa de Valores', 'Bolsa Brasileira', 'Ibovespa', 'Iniciantes', 'Educação Financeira', 'Pregão', 'Mercado de Ações'] relatedPosts: \['como-investir-em-acoes-guia-completo-iniciantes', 'o-que-e-petr4-e-mglu-outros-tickers-da-bolsa-de-valores', 'como-acompanhar-a-bolsa-de-valores-em-tempo-real', 'o-que-sao-acoes-guia-iniciantes-2026', 'como-comecar-investir-do-zero-guia-iniciantes-2026'] featured: true expertise: 'Educação financeira para investidores iniciantes e intermediários' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > Você já ouviu falar sobre "bolsa de valores" nos noticiários, mas não entende exatamente o que é? Neste guia, vamos explicar de forma simples como funciona esse mercado onde bilhões de reais são negociados todos os dias. *** ## O Que é a Bolsa de Valores? A **bolsa de valores** é um mercado organizado onde são negociados títulos e valores mobiliários, principalmente **ações de empresas**. É como um grande mercado, mas em vez de frutas e legumes, são negociadas partes de empresas. ### Analogia Simples ``` IMAGINE UM SHOPPING DE EMPRESAS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 🏪 Loja 1: Petrobras (PETR4) - Vende pedaços da empresa - Preço muda conforme demanda 🏪 Loja 2: Vale (VALE3) - Mineradora oferece suas ações - Milhares de compradores e vendedores 🏪 Loja 3: Itaú (ITUB4) - Maior banco privado do Brasil - Negocia milhões de ações por dia 📊 O "SHOPPING" = Bolsa brasileira Organiza tudo, garante que ninguém seja enganado ``` ## A Bolsa Brasileira ### O Que é a Bolsa Brasileira? A **bolsa brasileira** é a única bolsa de valores do Brasil. Ela nasceu da fusão de instituições históricas: | Ano | Evento | | ---- | -------------------------------------------------- | | 1890 | Fundação da Bolsa de São Paulo | | 2008 | Fusão BM\&F + Bovespa = BM\&FBovespa | | 2017 | Fusão com Cetip resultou na bolsa brasileira atual | ### Números do Mercado Brasileiro (2026) ``` 📊 BOLSA BRASILEIRA EM NÚMEROS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 💰 Valor de mercado: ~R$ 5 trilhões 🏢 Empresas listadas: ~450 👥 Investidores pessoa física: ~6 milhões 📈 Volume médio diário: R$ 30+ bilhões 🌍 5ª maior bolsa das Américas ``` ### Localização e Estrutura A bolsa brasileira tem sede em São Paulo, e o pregão é **100% eletrônico** desde 2009. Não existe mais o "pregão viva-voz" com operadores gritando. ## Como Funciona o Pregão ### Horário de Funcionamento | Fase | Horário | O Que Acontece | | ---------------------- | ------------- | ------------------------------- | | **Pré-abertura** | 09:45 - 10:00 | Registro de ofertas | | **Pregão Regular** | 10:00 - 17:55 | Negociação normal | | **Call de Fechamento** | 17:55 - 18:00 | Formação do preço de fechamento | | **After Market** | 18:30 - 18:45 | Negociação pós-mercado | **Status da bolsa por horário:** | Horário | Status | | --------------- | ------------------ | | Fins de semana | Fechada | | 09:45 - 10:00 | Pré-abertura | | 10:00 - 17:55 | Aberta | | 17:55 - 18:00 | Call de fechamento | | 18:30 - 18:45 | After Market | | Demais horários | Fechada | ### O Que São Ofertas de Compra e Venda? No pregão, compradores e vendedores fazem **ofertas**: ``` LIVRO DE OFERTAS (ORDER BOOK) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ COMPRA (Bid) VENDA (Ask) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Preço │ Qtd Preço │ Qtd R$ 37,80 │ 5.000 R$ 37,85 │ 3.200 R$ 37,75 │ 8.000 R$ 37,90 │ 7.500 R$ 37,70 │ 12.000 R$ 37,95 │ 4.800 R$ 37,65 │ 6.500 R$ 38,00 │ 15.000 Spread: R$ 0,05 (diferença entre melhor compra e melhor venda) ``` ### Como Uma Ordem é Executada 1. Você envia ordem de COMPRA de PETR4 a R$ 37,85 2. A bolsa encontra vendedor pedindo R$ 37,85 3. **Match!** A negociação acontece 4. A bolsa registra e liquida a operação 5. As ações vão para sua custódia ## Índices da Bolsa ### O Que é o Ibovespa? O **Ibovespa** é o principal índice da bolsa brasileira. Ele mede a performance das ações mais negociadas. ```typescript // Consultar o Ibovespa via brapi.dev const response = await fetch('https://brapi.dev/api/quote/^BVSP') const data = await response.json() const ibov = data.results[0] // ibov.regularMarketPrice → pontos // ibov.regularMarketChangePercent → variação % ``` **Exemplo de resposta:** | Dado | Valor | | -------- | ------- | | Pontos | 128.450 | | Variação | +1,25% | | Abertura | 127.200 | | Máxima | 128.800 | | Mínima | 126.950 | ### Principais Índices da Bolsa Brasileira | Índice | Código | O Que Mede | | -------------- | ------- | ---------------------------- | | **Ibovespa** | ^BVSP | Ações mais líquidas | | **IBrX 100** | ^IBX100 | 100 ações mais negociadas | | **Small Caps** | SMLL | Empresas menores | | **IDIV** | IDIV | Boas pagadoras de dividendos | | **IFIX** | IFIX | Fundos Imobiliários | ### Composição do Ibovespa As principais ações do Ibovespa (e seus pesos aproximados): ``` TOP 10 AÇÕES DO IBOVESPA ━━━━━━━━━━━━━━━━━━━━━━━━ 1. VALE3 (Vale) ~13% 2. PETR4 (Petrobras) ~8% 3. ITUB4 (Itaú) ~7% 4. BBDC4 (Bradesco) ~5% 5. PETR3 (Petrobras ON) ~4% 6. B3SA3 ~4% 7. BBAS3 (Banco Brasil) ~3% 8. ABEV3 (Ambev) ~3% 9. WEGE3 (WEG) ~3% 10. RENT3 (Localiza) ~2% 📊 Top 10 = ~52% do índice ``` ## Participantes do Mercado ### Quem Opera na Bolsa? ``` ECOSSISTEMA DA BOLSA BRASILEIRA ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 👤 INVESTIDORES ├── Pessoa Física (~20% do volume) ├── Investidores Institucionais (~35%) └── Investidores Estrangeiros (~45%) 🏦 INTERMEDIÁRIOS ├── Corretoras (XP, Clear, BTG...) ├── Bancos de Investimento └── Distribuidoras 📋 REGULADORES ├── CVM (Comissão de Valores Mobiliários) ├── Banco Central └── Bolsa (autorregulação) 🏢 EMPRESAS └── Companhias abertas listadas ``` ### Tipos de Investidores | Tipo | Características | % Volume | | ------------------ | --------------------------- | -------- | | **Pessoa Física** | Investidores individuais | \~20% | | **Institucionais** | Fundos, previdência | \~35% | | **Estrangeiros** | Investidores internacionais | \~45% | ## Como as Empresas Entram na Bolsa ### O Que é um IPO? **IPO** (Initial Public Offering) é quando uma empresa abre seu capital e vende ações pela primeira vez na bolsa. ``` PROCESSO DE IPO ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1. 📋 PREPARAÇÃO Empresa contrata bancos coordenadores Auditoria financeira Prospecto preliminar 2. 📢 MARKETING Roadshow para investidores Bookbuilding (coleta de intenções) Definição do preço 3. 🔔 ESTREIA Primeiro dia de negociação Ticker é criado (ex: XPTO3) Empresa capta recursos 4. 📊 VIDA DE COMPANHIA ABERTA Balanços trimestrais Assembleia de acionistas Governança corporativa ``` ### Exemplos de IPOs Recentes | Empresa | Ticker | Ano | Setor | | --------- | ------ | ---- | ---------- | | Nubank | NUBR33 | 2021 | Fintech | | Rede D'Or | RDOR3 | 2020 | Saúde | | Petz | PETZ3 | 2020 | Varejo Pet | ## Custos e Taxas ### Quanto Custa Operar na Bolsa? | Taxa | O Que É | Quanto | | --------------- | ------------------------ | ---------------------- | | **Corretagem** | Taxa da corretora | R$ 0 a R$ 20 por ordem | | **Emolumentos** | Taxa da bolsa brasileira | 0,0325% do valor | | **Liquidação** | Taxa da bolsa brasileira | 0,0275% do valor | | **Custódia** | Guarda das ações | Geralmente gratuita | | **ISS** | Imposto municipal | 5% sobre corretagem | ### Exemplo Prático de Custos ``` COMPRANDO 100 AÇÕES DE PETR4 A R$ 37,85 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Valor da operação: R$ 3.785,00 Custos: • Corretagem: R$ 0,00 (corretora zero) • Emolumentos: R$ 1,23 (0,0325%) • Liquidação: R$ 1,04 (0,0275%) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Total de custos: R$ 2,27 (0,06%) 💡 MUITO BARATO comparado a outros investimentos! ``` ## Segurança e Regulação ### Quem Protege o Investidor? ``` CAMADAS DE PROTEÇÃO ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1. 🏛️ CVM (Comissão de Valores Mobiliários) - Fiscaliza mercado - Pune irregularidades - Autoriza ofertas 2. 🏦 BANCO CENTRAL - Regula sistema financeiro - Supervisiona instituições 3. 📊 Bolsa (Autorregulação) - Monitora negociações - Detecta manipulações - Garante liquidação 4. 🛡️ MRP (Mecanismo de Ressarcimento) - Protege até R$ 120.000 - Contra erros de corretoras ``` ### Suas Ações Estão Seguras? * **Custódia separada**: Suas ações ficam na bolsa, não na corretora * **Se a corretora falir**: Você não perde suas ações * **CPF vinculado**: Cada ação está no seu nome ## Acompanhando a Bolsa em Tempo Real ### Com a API brapi.dev ```typescript // Consultar múltiplas ações de uma vez const response = await fetch( 'https://brapi.dev/api/quote/PETR4,VALE3,ITUB4,BBDC4,ABEV3' ) const data = await response.json() // data.results contém array com todas as ações ``` **Exemplo de painel:** | Ação | Preço | Variação | | -------- | -------- | -------- | | 🟢 PETR4 | R$ 38,50 | +2,15% | | 🔴 VALE3 | R$ 61,20 | -0,85% | | 🟢 ITUB4 | R$ 32,80 | +1,10% | | 🔴 BBDC4 | R$ 12,45 | -0,32% | | 🟢 ABEV3 | R$ 14,20 | +0,56% | ### Informações Disponíveis | Dado | Descrição | Uso | | ----------------- | -------------------- | ------------ | | **Preço** | Última cotação | Valor atual | | **Variação** | Mudança no dia | Tendência | | **Volume** | Quantidade negociada | Liquidez | | **Máxima/Mínima** | Range do dia | Volatilidade | | **Abertura** | Primeiro preço | Referência | ## Perguntas Frequentes ### A bolsa pode quebrar? Não no sentido tradicional. A bolsa brasileira é uma instituição sólida e bem regulada. Mesmo em crises, ela continua funcionando. ### Posso perder mais do que investi? Em ações normais, **não**. O máximo que você perde é o valor investido. Diferente de derivativos e operações alavancadas. ### Quanto tempo para receber meu dinheiro? A **liquidação** na bolsa brasileira é em **D+2** (dois dias úteis após a venda). Então se você vende hoje, o dinheiro cai na corretora em 2 dias. ### Estrangeiros podem investir na Bolsa Brasileira? Sim! Investidores estrangeiros representam cerca de 45% do volume. Eles entram através de corretoras brasileiras autorizadas. ## Próximos Passos Agora que você entende como funciona a bolsa: ### Continue Aprendendo * **[Como investir em ações](/blog/como-investir-em-acoes-guia-completo-iniciantes)** - Guia prático passo a passo * **[Entenda os códigos das ações](/blog/o-que-e-petr4-e-mglu-outros-tickers-da-bolsa-de-valores)** - PETR4, VALE3 e outros * **[Acompanhe cotações ao vivo](/quotes)** - Plataforma gratuita ### Use Ferramentas Profissionais ```typescript // Consulte qualquer ação da bolsa brasileira com brapi.dev const response = await fetch('https://brapi.dev/api/quote/WEGE3') const dados = await response.json() ``` ### Recursos Adicionais * **[Documentação da API](/docs)** - Para desenvolvedores * **[Lista de ações](/api/quote/list)** - Todas as empresas listadas * **[Indicadores fundamentalistas](/blog/guia-completo-indicadores-fundamentalistas-bovespa)** - Análise profunda *** ## Conclusão A bolsa de valores é um ambiente organizado e seguro para investir em empresas. A bolsa brasileira oferece: ✅ **Transparência** - Preços públicos e em tempo real\ ✅ **Segurança** - Regulação forte e custódia protegida\ ✅ **Acessibilidade** - Qualquer pessoa pode investir\ ✅ **Liquidez** - Compre e venda rapidamente **O primeiro passo é sempre o mais difícil. Mas com conhecimento e as ferramentas certas, investir na bolsa pode ser simples e lucrativo!** *** *Precisa de dados da bolsa brasileira para suas análises? A [brapi.dev](https://brapi.dev) oferece API gratuita com cotações em tempo real, dados históricos e indicadores fundamentalistas de todas as ações brasileiras.* # O Que É CDI em 2026: Guia Completo do Indicador Mais Importante da Renda Fixa URL: /blog/o-que-e-cdi-guia-completo-2026.mdx Entenda o que é CDI, como funciona, diferença entre CDI e Selic, quais investimentos rendem 100% do CDI ou mais e como calcular seus rendimentos *** searchable: true title: 'O Que É CDI em 2026: Guia Completo do Indicador Mais Importante da Renda Fixa' description: 'Entenda o que é CDI, como funciona, diferença entre CDI e Selic, quais investimentos rendem 100% do CDI ou mais e como calcular seus rendimentos' date: '2026-01-01' keywords: 'o que e cdi, cdi hoje, cdi 2026, cdi vs selic, investimentos cdi, 100 do cdi, como funciona cdi, taxa cdi, rendimento cdi, cdb cdi' author: 'Equipe brapi.dev' category: 'Renda Fixa' subcategory: 'Indicadores' readingTime: '20 min' tags: \['CDI', 'Renda Fixa', 'Selic', 'CDB', 'Investimentos', 'Iniciantes'] relatedPosts: \['tesouro-direto-guia-completo-2026-como-investir', 'cdb-vs-tesouro-direto-comparativo-2026', 'lci-lca-guia-completo-investimentos-isentos-ir-2026', 'renda-fixa-vs-renda-variavel-2026', 'como-investir-com-pouco-dinheiro-2026'] featured: true expertise: 'Taxa CDI e investimentos de renda fixa para iniciantes' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > Você já viu "rende 100% do CDI" e ficou confuso? O CDI é o principal benchmark da renda fixa brasileira. Este guia explica tudo: o que é, como funciona, diferença para Selic e como ganhar acima de 100% do CDI. *** ## O Que É CDI? **CDI (Certificado de Depósito Interbancário)** é a taxa de juros que os bancos cobram para emprestar dinheiro entre si por um dia. Funciona assim: ``` Banco A tem dinheiro sobrando hoje ↓ Empresta para Banco B que precisa ↓ Banco B paga juros (taxa CDI) ↓ Média de todas essas operações = Taxa CDI do dia ``` ### Por Que o CDI É Tão Importante? | Aspecto | Explicação | | -------------------- | ------------------------------------------------------- | | **Benchmark** | É a referência para 90% dos investimentos de renda fixa | | **Diário** | Calculado todos os dias úteis pela bolsa brasileira | | **Próximo da Selic** | Historicamente fica 0,10% abaixo da Selic | | **Baixo Risco** | Operações entre bancos são muito seguras | | **Universal** | CDB, LCI, LCA, fundos DI usam CDI como referência | ### CDI Hoje em 2026 ```typescript // O CDI já é uma série de primeira classe em /api/v2/macro const response = await fetch( "https://brapi.dev/api/v2/macro/latest?symbols=selic,cdi", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }, ); const { results } = await response.json(); const selic = results.find((r) => r.series.slug === "selic")?.latest.value; const cdiDiario = results.find((r) => r.series.slug === "cdi")?.latest.value; // CDI vem em % ao dia. Anualize com (1+cdi/100)**252 - 1. ``` **Taxas atuais (exemplo com Selic a 13,25%):** | Taxa | Valor | | ------------ | ------------- | | Selic Meta | 13,25% ao ano | | CDI Estimado | 13,15% ao ano | | CDI Mensal | \~1,03% | | CDI Diário | \~0,049% | *** ## CDI vs Selic: Qual a Diferença? Muita gente confunde CDI com Selic. Veja a diferença: | Característica | CDI | Selic | | ---------------- | ----------------------------- | ------------------------------------ | | **O que é** | Taxa entre bancos privados | Taxa de política monetária | | **Quem define** | Mercado (média das operações) | Banco Central (Copom) | | **Frequência** | Diária | A cada 45 dias | | **Valor típico** | \~0,10% menor que Selic | Taxa de referência | | **Usado em** | CDB, LCI, LCA, fundos DI | Tesouro Selic, discussões econômicas | ### Fórmula de Conversão **Conversões de taxas (Selic 13,25% → CDI 13,15%):** | Conversão | Valor | | ---------------- | ------- | | Selic Meta Anual | 13,25% | | CDI Anual | 13,15% | | CDI Mensal | 1,0342% | | CDI Diário | 0,0489% | | 100% CDI Mensal | 1,0342% | | 110% CDI Mensal | 1,1376% | | 120% CDI Mensal | 1,2410% | > **Fórmula:** CDI ≈ Selic Meta - 0,10% *** ## O Que Significa "100% do CDI"? Quando um investimento rende "100% do CDI", significa que ele paga exatamente a taxa CDI. Veja exemplos: | Investimento | Rentabilidade | Se CDI = 13% ao ano | | ----------------- | ---------------------- | ----------------------------------------- | | Poupança | \~70% do CDI | \~9,1% ao ano | | CDB banco grande | 100% do CDI | 13% ao ano | | CDB banco médio | 110% do CDI | 14,3% ao ano | | CDB banco pequeno | 120% do CDI | 15,6% ao ano | | LCI/LCA | 90% do CDI (isento IR) | 11,7% ao ano (equivale a \~14% tributado) | ### Calculadora: Quanto Rende Seu Investimento? **Simulações com CDI a 13,15% ao ano:** | Cenário | Valor | % CDI | Prazo | Rend. Bruto | IR | Rend. Líquido | | ------------ | --------- | ----- | ----- | ----------- | ------ | ------------- | | CDB 100% CDI | R$ 10.000 | 100% | 12m | R$ 1.315 | 20% | R$ 1.052 | | CDB 120% CDI | R$ 10.000 | 120% | 24m | R$ 3.474 | 15% | R$ 2.953 | | LCI 90% CDI | R$ 10.000 | 90% | 12m | R$ 1.184 | Isento | R$ 1.184 | **Tabela regressiva do IR (CDB, Fundos DI):** | Prazo | Alíquota IR | | ----------------- | ----------- | | Até 6 meses | 22,5% | | 6-12 meses | 20% | | 12-24 meses | 17,5% | | Acima de 24 meses | 15% | **LCI e LCA são isentos de IR** para pessoa física, tornando-as vantajosas mesmo com percentuais menores do CDI. *** ## Investimentos que Rendem CDI ### 1. CDB (Certificado de Depósito Bancário) O investimento mais comum atrelado ao CDI: | Tipo de Banco | Rentabilidade Típica | Risco | Liquidez | | ------------------------- | -------------------- | ----------- | ------------------------ | | Bancos Grandes (Itaú, BB) | 80-100% CDI | Baixo | Geralmente diária | | Bancos Médios (Inter, C6) | 100-110% CDI | Baixo-Médio | Varia | | Bancos Pequenos | 110-140% CDI | Médio | Geralmente no vencimento | **Vantagens:** * Protegido pelo FGC até R$ 250 mil * Rentabilidade previsível * Fácil de encontrar **Desvantagens:** * IR sobre rendimentos (tabela regressiva) * Liquidez pode ser limitada ### 2. LCI e LCA (Letras de Crédito) **Comparação CDB vs LCI (R$ 10.000 por 12 meses, CDI 13,15%):** | Investimento | Rend. Bruto | IR | Rend. Líquido | | ------------ | ----------- | ------------ | ------------- | | CDB 100% CDI | R$ 1.315 | R$ 263 (20%) | R$ 1.052 | | LCI 85% CDI | R$ 1.118 | Isento | R$ 1.118 | **Resultado:** LCI 85% CDI rende **R$ 66 a mais** que CDB 100% CDI após IR. > **LCI equivalente a CDB 100%:** \~80% do CDI (para 12 meses). Se a LCI pagar mais que isso, ela é melhor! ### 3. Fundos DI Fundos que investem em títulos atrelados ao CDI: | Característica | Fundos DI | | --------------------- | -------------------------- | | Taxa de administração | 0% a 1% ao ano | | Liquidez | D+0 a D+1 geralmente | | Tributação | Come-cotas + IR regressivo | | Investimento mínimo | Varia (R$ 1 a R$ 10.000) | **Atenção:** Fundos com taxa de administração acima de 0,5% podem render menos que CDB 100% CDI! ### 4. Tesouro Selic Embora renda Selic (não CDI), é muito similar: **Tesouro Selic vs CDB:** | Característica | Tesouro Selic | CDB 100% CDI | | ----------------- | ---------------- | ----------------------- | | Rendimento | Selic + 0,0X% | 100% CDI | | Tributação | IR regressivo | IR regressivo | | Liquidez | D+1 | Varia (diária ou venc.) | | Garantia | Governo Federal | FGC até R$ 250 mil | | Investimento Mín. | R$ 30 | Varia (R$ 1 a R$ 1.000) | | Risco | Soberano (menor) | Crédito do banco | *** ## Como Encontrar Investimentos Acima de 100% do CDI ### Estratégia 1: Bancos Menores (Mais Risco, Mais Retorno) **CDBs que pagam acima de 100% do CDI (valores ilustrativos):** | Banco | % CDI | Taxa Efetiva\* | Prazo | FGC | | -------------- | ----- | -------------- | ------ | --- | | Banco Master | 130% | 17,10% | 36m | Sim | | Banco Pine | 120% | 15,78% | 24m | Sim | | Banco BMG | 115% | 15,12% | 24m | Sim | | Banco Daycoval | 112% | 14,73% | 12m | Sim | | Banco Inter | 100% | 13,15% | 12m | Sim | | Nubank | 100% | 13,15% | Diária | Sim | \*Considerando CDI de 13,15% **Verifique sempre se o banco é coberto pelo FGC!** Limite: R$ 250.000 por CPF por instituição. ### Estratégia 2: Prazos Maiores Quanto maior o prazo, maior tende a ser a rentabilidade: | Prazo | Rentabilidade Típica | IR Aplicável | | --------------- | -------------------- | ------------ | | Liquidez diária | 100% CDI | 22,5% | | 6 meses | 102-105% CDI | 22,5% | | 12 meses | 105-110% CDI | 20% → 17,5% | | 24 meses | 110-115% CDI | 17,5% → 15% | | 36 meses | 115-130% CDI | 15% | ### Estratégia 3: LCI/LCA com Desconto Aparente **Tabela de equivalência CDB vs LCI/LCA:** | Prazo | CDB | LCI Equivalente | | -------- | -------- | ---------------- | | 6 meses | 100% CDI | 77,5% CDI isento | | 12 meses | 100% CDI | 80,0% CDI isento | | 18 meses | 100% CDI | 82,5% CDI isento | | 24 meses | 100% CDI | 82,5% CDI isento | | 36 meses | 100% CDI | 85,0% CDI isento | > **Regra prática:** Se a LCI pagar MAIS que o equivalente, ela é melhor! *** ## Histórico do CDI ```typescript // Histórico da Selic via /api/v2/macro (limit=10000 para histórico completo) const response = await fetch( "https://brapi.dev/api/v2/macro?symbols=selic&limit=10000", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }, ); const { results } = await response.json(); const observacoes = results[0].observations; // [{ date, value }, ...] ``` **Histórico recente da taxa (CDI ≈ Selic - 0,10%):** | Data | Selic | CDI Estimado | CDI Mensal | | ---- | ------ | ------------ | ---------- | | 2026 | 13,25% | 13,15% | 1,03% | | 2025 | 12,25% | 12,15% | 0,96% | | 2024 | 10,50% | 10,40% | 0,83% | | 2023 | 13,75% | 13,65% | 1,07% | ### Evolução do CDI (últimos anos) | Ano | CDI Médio | Observação | | ---- | --------- | --------------------------- | | 2020 | 2,75% | Mínima histórica (pandemia) | | 2021 | 4,42% | Início do ciclo de alta | | 2022 | 12,39% | Alta para conter inflação | | 2023 | 13,04% | Pico e início de queda | | 2024 | 11,15% | Queda gradual | | 2026 | 13,25% | Novo ciclo de alta | | 2026 | \~15%\* | Juros elevados | *** ## CDI e Inflação: Rendimento Real **Atenção:** CDI alto não significa ganho real alto! **Cálculo do rendimento real:** | Cenário | CDI | IPCA | Rendimento Real | | ------------ | ------ | ------ | ------------------------------------- | | 2026 (atual) | 13,15% | 4,5% | **+8,27%** ✓ Ganhando poder de compra | | 2015 | 13,24% | 10,67% | **+2,32%** Margem apertada | | 2020 | 2,75% | 4,52% | **-1,69%** ✗ Perdendo poder de compra | > **Fórmula:** Rendimento Real = ((1 + CDI) / (1 + IPCA)) - 1 *** ## Quanto Preciso Investir para Viver de CDI? **Patrimônio necessário para renda mensal (CDI 13,15%):** | Renda Mensal | CDB 100% CDI\* | LCI 90% CDI | | ------------ | -------------- | ------------ | | R$ 3.000 | R$ 325.000 | R$ 305.000 | | R$ 5.000 | R$ 540.000 | R$ 510.000 | | R$ 10.000 | R$ 1.080.000 | R$ 1.020.000 | | R$ 20.000 | R$ 2.160.000 | R$ 2.040.000 | \*Considerando IR de 15% para CDB (longo prazo) **Cálculo simplificado:** * Taxa líquida mensal CDB: \~0,93% (após IR 15%) * Taxa líquida mensal LCI: \~0,98% (isenta) * Patrimônio = Renda Desejada ÷ Taxa Mensal ### Tabela de Referência | Renda Mensal | Patrimônio (CDB 100% CDI) | Patrimônio (LCI 90% CDI) | | ------------ | ------------------------- | ------------------------ | | R$ 3.000 | R$ 325.000 | R$ 305.000 | | R$ 5.000 | R$ 540.000 | R$ 510.000 | | R$ 10.000 | R$ 1.080.000 | R$ 1.020.000 | | R$ 20.000 | R$ 2.160.000 | R$ 2.040.000 | \*Considerando CDI de 13,15% ao ano e IR de 15% para CDB *** ## Perguntas Frequentes sobre CDI ### 1. CDI é seguro? **Sim, mas depende do investimento:** * **Tesouro Selic:** Risco soberano (o mais seguro do Brasil) * **CDB com FGC:** Protegido até R$ 250 mil por CPF por instituição * **Fundos DI:** Depende dos ativos do fundo ### 2. CDI pode ficar negativo? **Nunca ficou negativo no Brasil.** O menor CDI foi 1,90% ao ano (set/2020). Em outros países (Europa, Japão), taxas negativas já ocorreram. ### 3. Qual a diferença entre CDI pré e pós-fixado? | Tipo | Como funciona | Exemplo | | -------------- | ---------------------- | ---------------- | | **Pós-fixado** | Rende % do CDI (varia) | CDB 100% CDI | | **Pré-fixado** | Taxa fixa definida | CDB 12% ao ano | | **Híbrido** | Parte fixa + parte CDI | IPCA + 6% ao ano | ### 4. CDI é melhor que poupança? **Sempre!** Poupança rende aproximadamente 70% do CDI quando a Selic está acima de 8,5%. **Comparação: R$ 10.000 por 12 meses (CDI 13,15%):** | Investimento | Rendimento | | ---------------------- | ------------------------ | | Poupança (\~70% CDI) | R$ 920 | | CDB 100% CDI (líquido) | R$ 1.052 | | **Diferença** | **R$ 132 a mais no CDB** | > Você perde **1,32% do capital** deixando na poupança! **Para R$ 100.000 por 24 meses:** | Investimento | Rendimento | | ---------------------- | -------------------------- | | Poupança (\~70% CDI) | R$ 20.200 | | CDB 100% CDI (líquido) | R$ 23.500 | | **Diferença** | **R$ 3.300 a mais no CDB** | *** ## Acompanhando o CDI com a brapi.dev Para automatizar o acompanhamento do CDI e Selic em suas aplicações: ```typescript // Selic, CDI e IPCA acumulado 12m em uma única requisição const response = await fetch( "https://brapi.dev/api/v2/macro/latest?symbols=selic,cdi,ipca12m", { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }, ); const { results } = await response.json(); const selic = results.find((r) => r.series.slug === "selic")?.latest.value; const cdiDiario = results.find((r) => r.series.slug === "cdi")?.latest.value; const ipca = results.find((r) => r.series.slug === "ipca12m")?.latest.value; // CDI vem em % ao dia. Anualize com (1+cdi/100)**252 - 1 const cdiAnual = (Math.pow(1 + cdiDiario / 100, 252) - 1) * 100; ``` **Exemplo de painel de taxas:** | Indicador | Valor | | --------------- | ------------- | | Selic Meta | 13,25% ao ano | | CDI Estimado | 13,15% ao ano | | IPCA 12 meses | 4,50% | | Rendimento Real | 8,27% ao ano | **Simulação R$ 10.000 por 12 meses:** * Rendimento Nominal (bruto): R$ 1.315 * Ganho Real (acima da inflação): R$ 827 *** ## Conclusão: CDI é Bom ou Ruim? ### Quando CDI é uma boa escolha: * Reserva de emergência (liquidez diária) * Objetivos de curto prazo (\< 2 anos) * Perfil conservador * Momento de juros altos (como agora) ### Quando buscar alternativas: * Objetivos de longo prazo (> 5 anos) → considere ações, fundos imobiliários * Proteção contra inflação → Tesouro IPCA+ * Patrimônio acima de R$ 250 mil por banco → diversificar ### Checklist do Investidor CDI | Item | Verificou? | | ----------------------------------------- | ---------- | | Comparou CDI vs Selic vs poupança | ☐ | | Verificou se banco tem FGC | ☐ | | Calculou rentabilidade líquida (após IR) | ☐ | | Comparou CDB vs LCI/LCA | ☐ | | Diversificou entre bancos (limite FGC) | ☐ | | Considerou prazo vs liquidez | ☐ | | Calculou rendimento real (CDI - inflação) | ☐ | *** ## Próximos Passos Agora que você entende o CDI: 1. **Monte sua reserva de emergência** em CDB 100% CDI com liquidez diária 2. **Compare opções** de CDB, LCI e LCA na sua corretora 3. **Use a brapi.dev** para acompanhar Selic, IPCA e calcular rendimentos 4. **Leia também:** [Tesouro Direto: Guia Completo 2026](/blog/tesouro-direto-guia-completo-2026-como-investir) e [Como Investir com Pouco Dinheiro 2026](/blog/como-investir-com-pouco-dinheiro-2026) *** **Aviso Legal:** Este conteúdo é educacional e não constitui recomendação de investimento. Consulte um profissional antes de investir. Rentabilidade passada não garante rentabilidade futura. # Códigos de Ações Brasileiras 2025: PETR4, VALE3, MGLU3 e Como Funciona o Sistema de Tickers URL: /blog/o-que-e-petr4-e-mglu-outros-tickers-da-bolsa-de-valores.mdx Como funcionam os códigos de ações brasileiras! Entenda PETR4, VALE3, MGLU3 e o sistema de tickers brasileiro ✓ *** searchable: true title: 'Códigos de Ações Brasileiras 2025: PETR4, VALE3, MGLU3 e Como Funciona o Sistema de Tickers' description: 'Como funcionam os códigos de ações brasileiras! Entenda PETR4, VALE3, MGLU3 e o sistema de tickers brasileiro ✓' date: '2025-08-22' keywords: 'códigos ações brasileiras, tickers bolsa Brasil, PETR4 VALE3 MGLU3, sistema ticker brasileiro, como investir ações, bolsa valores códigos, iniciantes investimento' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Tickers e Códigos' readingTime: '10 min' tags: \['Tickers', 'Códigos Ações', 'Bolsa Brasileira', 'PETR4', 'VALE3', 'MGLU3', 'Iniciantes', 'Educação Financeira'] relatedPosts: \['como-acompanhar-a-bolsa-de-valores-em-tempo-real', 'analise-fundamentalista-acoes-indicadores-essenciais-investir-b3', 'como-construir-carteira-investimentos-diversificada-brapi'] featured: false expertise: 'Equipe de educação financeira especializada em facilitar o aprendizado de investimentos para iniciantes' lastReviewed: '2025-08-22' howToSteps: * name: 'Entender a estrutura do código ticker' text: 'Aprenda que tickers brasileiros têm 4 letras (sigla da empresa) + 1 ou 2 números que indicam o tipo de ação ou instrumento.' * name: 'Identificar ações ordinárias (número 3)' text: 'Reconheça que tickers terminados em 3 (ex: VALE3, ITUB3) são ações ordinárias com direito a voto nas assembleias.' * name: 'Identificar ações preferenciais (número 4)' text: 'Reconheça que tickers terminados em 4 (ex: PETR4, ITUB4) são ações preferenciais com preferência na distribuição de dividendos.' * name: 'Conhecer outros sufixos numéricos' text: 'Aprenda que 1/2 são direitos de subscrição, 5-8 são classes de preferenciais (PNA, PNB, PNC, PND), 11 são units e ETFs.' * name: 'Pesquisar empresas na brapi.dev' text: 'Use a API brapi.dev ou o site brapi.dev/quote/TICKER para consultar informações detalhadas sobre qualquer ação.' * name: 'Verificar correlação com Ibovespa' text: 'Entenda que ações como PETR4 e VALE3 têm grande peso no índice Ibovespa, influenciando diretamente seu desempenho.' * name: 'Escolher entre ON e PN' text: 'Decida entre ordinárias (participação em decisões) e preferenciais (prioridade em dividendos) conforme seus objetivos de investimento.' howToTools: * 'brapi.dev para consulta de tickers' * 'Site da bolsa de valores para lista oficial' * 'Home broker da corretora' howToSupplies: * 'Lista de empresas de interesse' * 'Acesso à internet' * 'Conta em corretora (para investir)' *** import { Author, Authors } from '~/components/Authors'; > Descubra o significado dos códigos PETR4 e VALE3 na bolsa de valores, entenda > as diferenças entre a Petrobras e a Vale, e saiba como operar com sucesso. > Conheça os detalhes dos tickers e suas variações no mercado de ações > brasileiro. ## O que é um ticker de ações? Ações são representadas por códigos chamados de tickers, essenciais para operar na bolsa. Este artigo desmistifica os códigos PETR4 e VALE3, proporcionando uma compreensão profunda para os investidores iniciantes. ### O que é PETR4? O código PETR4 refere-se às ações da [Petrobras](https://brapi.dev/quote/PETR4), uma gigante estatal do setor petrolífero. Detentora de uma vasta gama de atividades, desde extração até distribuição, a Petrobras tem grande influência no índice IBovespa, impactando diretamente o mercado. ### O que é VALE3? Já o código VALE3 representa as ações da [Vale do Rio Doce](https://brapi.dev/quote/VALE3), uma das maiores mineradoras do mundo. Com produção diversificada, a Vale mantém uma forte correlação com o índice IBovespa, sendo crucial entender sua dinâmica para operações eficientes. ### O que significa o número 3 e 4 no código das ações? Os códigos das ações são compostos por 4 letras e números. No caso de ações ordinárias e preferenciais, como VALE3 e PETR4, é importante compreender a diferença. A correlação dessas ações com o índice IBovespa é crucial para investidores e traders. O número 3 e 4 no código das ações indica se a ação é ordinária ou preferencial. * Ações ordinárias: 3 * Ações preferenciais: 4 ### Qual é a diferença entre ações ordinárias e preferenciais? As ações ordinárias podem dar direito a voto nas assembleias, ou seja, o investidor pode participar das decisões da empresa. Já as ações preferenciais geralmente oferecem maiores dividendos, mas sem poder de voto. ### O que significa todos os números e letras no código das ações? | Código | Tipo de Ação | Descrição | | ------ | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1 | Direito de subscrição de uma ação ordinária | Tem o direito de aceitar ou não a subscrição de uma ação ordinária | | 2 | Direito de subscrição de uma ação preferencial | Tem o direito de aceitar ou não a subscrição de uma ação preferencial | | 3 | Ação Ordinária | Tem direito a voto nas assembleias | | 4 | Ação Preferencial | Tem preferência na distribuição de dividendos | | 5 | Ação Preferencial - Classe A (PNA) | Papel preferencial classe A | | 6 | Ação Preferencial - Classe B (PNB) | Papel preferencial classe B | | 7 | Ação Preferencial - Classe C (PNC) | Papel preferencial classe C | | 8 | Ação Preferencial - Classe D (PND) | Papel preferencial classe D | | 9 | Recibo de subscrição sobre ações ordinárias | Quando você exerce o direito de subscrição de uma ação ordinária, antes de ela entrar no seu portfólio com o código normal - PETR3, por exemplo - ela aparece como um recibo de subscrição, com o número 9 depois das letras - PETR9, por exemplo. Este recibo já pode ser negociado e tem o preço bem próximo ao da ação ordinária. | | 10 | Recibo de subscrição sobre ações preferenciais | Assim como o número 9, o 10 também se refere a um recibo de direitos sobre ações. A diferença é que são ações preferenciais, e não ordinárias. | | 11 | BDRs e Units | O mercado usa o número 11 para BDRs (Brazilian Deposit Receipts - Recibos de ações de empresas estrangeiras negociadas na bolsa brasileira) e para Units - papéis compostos por mais de um ativo, mas comprados e vendidos como uma unidade. Uma Unit pode ser composta por várias combinações de diferentes tipos de ações. Uma ação preferencial e duas ordinárias, 3 ordinárias e duas preferenciais, enfim, a empresa é quem define. O Santander, por exemplo, negocia Units no mercado acionário brasileiro, sob o código SANB11. | ## Decifrando os Códigos das Ações: Um Guia Detalhado ### Direito de Subscrição de uma Ação Ordinária (1) O número 1 nos códigos de ações indica o direito de subscrição de uma ação ordinária. Quando uma empresa decide aumentar seu capital, ela concede aos acionistas o direito de manter a mesma participação no capital da empresa. O investidor tem a opção de adquirir as novas ações a um preço predeterminado. Durante esse período, o código da ação no portfólio do acionista será complementado com o número 1, por exemplo, PETR1 para Petrobras. Caso o investidor opte por não exercer o direito de compra, o código desaparecerá ao final do prazo, mantendo a quantidade original de ações. Há também a possibilidade de vender esse direito a terceiros, exigindo que o comprador compreenda completamente a transação. Em algumas situações, o investidor pode observar uma ação, como a da Petrobras, sendo negociada a um preço substancialmente baixo, como R$ 1, e decidir adquirir. No entanto, nesse cenário, ele está comprando o direito de adquirir a ação por um preço determinado, por exemplo, comprando por R$ 1 o direito de adquirir uma ação da Petrobras por R$ 30. Ao final do período de subscrição, o investidor deve comprar a ação por R$ 30, caso contrário, perderá todo o capital investido no direito de subscrição. ### Direito de Subscrição de uma Ação Preferencial (2) O número 2 é utilizado para indicar o direito de subscrição, mas desta vez, de uma ação preferencial. Exemplificando, BBDC2 seria um direito de subscrição da ação preferencial do Bradesco (BBDC4). ### Ação Ordinária (3) O número 3 é frequentemente utilizado no mercado de ações para denotar uma ação ordinária, conferindo direito a voto. Um exemplo é o código USIM3, referindo-se à ação ordinária da Usiminas. ### Ação Preferencial (4) O número 4 é comum e refere-se a ações preferenciais, que possuem preferência na distribuição de dividendos. Como exemplo, temos o código PETR4, indicando os papéis preferenciais da Petrobras. ### Ações Preferenciais de Classes Diferentes (5, 6, 7 e 8) Quando o código é composto por esses números, significa que a ação é preferencial, mas de classes diferentes. O número 5 representa ação preferencial classe A (PNA), como VALE5. O número 6 indica ação preferencial classe B (PNB), o 7, classe C (PNC), e o 8, classe D (PND). Não há uma diferença específica entre as classes, sendo necessário consultar o estatuto da empresa para entender as características específicas de cada uma. ### Recibo de Subscrição sobre Ações Ordinárias (9) Quando o investidor exerce o direito de subscrição de uma ação ordinária, antes de ela entrar no portfólio com o código normal (por exemplo, PETR3), ela aparece como um recibo de subscrição, incluindo o número 9 depois das letras, como PETR9. Esse recibo já pode ser negociado e possui um preço bastante próximo ao da ação ordinária. ### Recibo de Subscrição sobre Ações Preferenciais (10) Assim como o número 9, o 10 refere-se a um recibo de direitos sobre ações, mas, neste caso, são ações preferenciais, não ordinárias. ### BDRs e Units (11) O número 11 não possui uma regra específica para o tipo de papel, sendo comumente utilizado para BDRs (Brazilian Deposit Receipts - recibos de ações de empresas estrangeiras negociadas na bolsa brasileira) e para Units - papéis compostos por mais de um ativo, mas comprados e vendidos como uma unidade. Empresas, como o Santander, negociam Units no mercado acionário brasileiro, sob o código SANB11. ### O que significa o PN e ON no nome das ações? (PETR3, PETR4, VALE3, VALE4) O PN e ON no nome das ações indica se a ação é preferencial ou ordinária. * Ações ordinárias: ON * Ações preferenciais: PN #### Ações Ordinárias e Preferenciais * **VALE3:** Ação ordinária da [Vale ON ](https://brapi.dev/quote/VALE3). * **VALE4:** Ação preferencial da [Vale PN](https://brapi.dev/quote/VALE4). * **PETR3:** Ação ordinária da [Petrobras ON](https://brapi.dev/quote/PETR3). * **PETR4:** Ação preferencial da [Petrobras PN](https://brapi.dev/quote/PETR4). ### Aprenda a Interpretar Outros Códigos de Ações Conhecer outros códigos do mercado é essencial para evitar confusões. Desde o mercado fracionário até opções e futuro, este guia completo proporciona uma visão abrangente. #### Mercado Fracionário O mercado fracionário, identificado por códigos como PETR4F, é ideal para investidores com recursos limitados, permitindo negociações em quantidades menores. #### Mercado de Opções O mercado de opções, representado por códigos como VALEK60, introduz o conceito de direito de compra ou venda de ativos em uma data futura, oferecendo uma estratégia alternativa para investidores. #### Mercado Futuro Os códigos, como PETRPM19, no mercado futuro indicam a opção de compra ou venda, sem obrigatoriedade. Compreender esses códigos é crucial para operações eficientes. #### Mercado a Termo Semelhante ao mercado futuro, o mercado a termo, com códigos como PETR4T, diferencia-se pela ausência de desembolsos antes do vencimento do contrato. ### Peso das Ações na Bolsa Entender a correlação e peso das ações como PETR4 e VALE3 no índice IBovespa é crucial para decisões informadas. Analisar essa relação é fundamental para investidores e traders. ## Perguntas Frequentes ### Qual é principal diferença entre ações ordinárias e preferenciais? As ações ordinárias podem dar direito a voto nas assembleias, ou seja, o investidor pode participar das decisões da empresa. Já as ações preferenciais geralmente oferecem maiores dividendos, mas sem poder de voto. ### Como interpretar os códigos do mercado de opções? Os códigos indicam a companhia, mês de vencimento e se é opção de compra (letras A-L) ou venda (letras M-X). ### O que é mercado fracionário? O mercado fracionário permite negociações em quantidades menores, identificadas por códigos com a letra F. É ideal para investidores com recursos limitados, que desejam comprar ações de empresas como a Petrobras e a Vale. O código PETR4F, por exemplo, representa ações fracionárias da Petrobras. Já o código [KLBN4F](https://brapi.dev/quote/KLBN4F) representa ações fracionárias da Klabin. ### O que é mercado futuro? O mercado futuro, identificado por códigos como PETRPM19, indica a opção de compra ou venda, sem obrigatoriedade. Compreender esses códigos é crucial para operações eficientes. O código PETRPM19, por exemplo, representa a opção de compra de ações da Petrobras com vencimento em junho de 2019. ### Como posso consultar cotações da Ibovespa Acesse a [brapi](https://brapi.dev/quotes) para consultar cotações de ações atualizadas. A visualização é simples e intuitiva, com suporte para diversos códigos, para quaisquer ações do Brasil, cotação de ações atualizadas, e muito mais. ## Próximos Passos Investir na bolsa requer compreensão dos códigos das ações, como PETR4 e VALE3. Este guia abrangente visa equipar investidores com o conhecimento necessário para operar com confiança e sucesso. Conheça a dinâmica dos tickers, explore diferentes mercados e tome decisões informadas em suas operações na bolsa. Precisa de uma API para consultar cotações de ações? Conheça a [brapi](https://brapi.dev), uma API gratuita para consultar cotações de ações atualizadas. Acesse a documentação e comece a usar agora mesmo! # O que são ações e o que você compra de verdade URL: /blog/o-que-sao-acoes-guia-iniciantes-2026.mdx Entenda como uma ação representa parte de uma empresa, como funciona a negociação na bolsa e quais riscos vêm junto. *** searchable: true title: 'O que são ações e o que você compra de verdade' description: 'Entenda como uma ação representa parte de uma empresa, como funciona a negociação na bolsa e quais riscos vêm junto.' date: '2026-01-01' keywords: 'o que sao acoes, acoes bolsa de valores, como investir em acoes, tipos de acoes, acoes ON PN, como comprar acoes, bolsa brasileira, ticker acoes, acoes iniciantes, renda variavel' author: 'Alisson Leal' category: 'Investimentos' subcategory: 'Ações' readingTime: '10 min' tags: \['Ações', 'Bolsa de Valores', 'Bolsa Brasileira', 'Iniciantes', 'Renda Variável', 'Investimentos'] relatedPosts: \['como-analisar-acoes-guia-iniciantes-2026', 'carteira-de-acoes-como-montar-diversificar', 'como-comecar-investir-do-zero-guia-iniciantes-2026', 'o-que-e-bolsa-de-valores-como-funciona-b3'] featured: true expertise: 'Mercado de ações e renda variável para iniciantes' lastReviewed: '2026-06-23' faqSchema: * question: 'Comprar uma ação me torna dono da empresa?' answer: 'Sim. A ação representa uma pequena participação no capital da companhia e dá os direitos previstos para aquela classe de ação.' * question: 'Posso começar comprando apenas uma ação?' answer: 'Na B3, o mercado fracionário permite negociar quantidades menores que o lote padrão, inclusive uma ação, quando houver oferta.' * question: 'A empresa recebe o dinheiro quando compro uma ação na bolsa?' answer: 'Normalmente não. Depois da oferta inicial, a negociação ocorre no mercado secundário entre investidores.' *** import { Authors, Author } from '~/components/Authors'; ![Investidor segurando uma pequena parte de uma empresa formada por fábrica, loja, trabalhadores e clientes](/images/blog/o-que-sao-acoes-propriedade.webp) Uma ação é uma pequena participação em uma empresa. Ao comprar uma ação, você não compra apenas um código que sobe e desce na tela. Você passa a ter uma fração de um negócio com clientes, funcionários, dívidas, caixa, concorrentes e riscos. ## O caminho do dinheiro Na oferta primária, o dinheiro captado entra na empresa. Na negociação diária da bolsa, o comprador paga ao investidor que está vendendo. A empresa não recebe dinheiro a cada troca de ações. ## Por que uma empresa abre o capital Uma companhia pode vender ações para financiar expansão, reduzir dívida, realizar aquisições ou permitir que sócios antigos vendam parte da participação. Em troca, passa a seguir regras de divulgação, governança e prestação de informações ao mercado. O acionista pode acompanhar demonstrações financeiras, fatos relevantes e assembleias. ## Como o acionista pode ganhar Existem duas fontes principais. ### Valorização Você compra por um preço e vende por outro. A diferença pode ser lucro ou prejuízo. O preço muda conforme expectativas sobre lucro, juros, economia, concorrência e riscos. Uma empresa pode melhorar e a ação cair se o mercado esperava ainda mais. Também pode piorar e subir por um período. ### Proventos A empresa pode distribuir parte do resultado aos acionistas, por exemplo como dividendos ou juros sobre capital próprio. O pagamento não é garantido. A companhia pode reter caixa, reduzir dividendos ou passar anos sem distribuir. Além disso, quando um provento é destacado, o preço da ação é ajustado. Dividendo não é dinheiro gratuito. ## O que significam ON, PN e units No Brasil, as classes mais conhecidas são: | Tipo | Ideia geral | Código comum | | ---------------- | ----------------------------------------------------------- | ------------------------ | | Ordinária, ON | Direito de voto e proteção prevista para a classe | Final 3 | | Preferencial, PN | Preferências definidas no estatuto, muitas vezes econômicas | Finais 4, 5, 6 ou outros | | Unit | Pacote de mais de uma classe ou valor mobiliário | Muitas vezes final 11 | Esses finais ajudam a identificar o ativo, mas não substituem o estatuto da empresa. Direitos de voto, dividendos e tag along variam por companhia e segmento de listagem. A página de relações com investidores da empresa e os documentos da B3 mostram os direitos de cada classe. ## Como ler um ticker Tickers de ações brasileiras costumam ter quatro letras e um número: ```text PETR3 PETR = empresa 3 = ação ordinária ``` O final 11 também aparece em ETFs, fundos imobiliários e units. O número sozinho não diz qual produto você está comprando. No mercado fracionário, algumas plataformas exibem a letra `F` após o ticker. Ela indica uma ordem abaixo do lote padrão, não uma ação diferente. ## Quanto dinheiro é necessário O valor mínimo depende do preço da ação e dos custos da corretora. No mercado fracionário, é possível negociar uma unidade quando houver liquidez. Isso não significa que comprar uma ação barata seja uma boa forma de começar. Preço unitário não mede qualidade. Uma ação de R$ 5 pode estar cara em relação ao negócio, enquanto outra de R$ 80 pode estar razoável. Para aportes pequenos, um ETF amplo pode diversificar melhor do que comprar uma ação diferente por mês. ## Como uma compra acontece Você envia uma ordem pela corretora. As duas ordens mais comuns são: | Ordem | O que acontece | | --------- | ------------------------------------------------------- | | Limitada | Você define o preço máximo de compra ou mínimo de venda | | A mercado | Busca execução imediata contra as ofertas disponíveis | Ordens a mercado podem executar por preços diferentes do último negócio, principalmente em ativos pouco líquidos. Para iniciantes, entender o livro de ofertas e usar uma ordem limitada reduz surpresas. Depois da execução, a liquidação de ações na B3 ocorre, em regra, em D+2. Isso significa dois dias úteis após a negociação. ## Os riscos que vêm com a ação ### Risco da empresa Lucros podem cair, a dívida pode aumentar, um controlador pode tomar decisões ruins e a companhia pode até falir. ### Risco de mercado Mesmo empresas saudáveis caem durante crises ou quando juros sobem. O preço pode ficar abaixo do valor pago por anos. ### Risco de concentração Comprar várias ações do mesmo setor não resolve tudo. Bancos diferentes podem sofrer com o mesmo ciclo de crédito. Empresas exportadoras podem depender da mesma commodity ou do câmbio. ### Risco comportamental Olhar a cotação a cada hora cria vontade de agir sem que o negócio tenha mudado. ## Ações não servem para todo objetivo | Uso do dinheiro | Ações costumam fazer sentido? | | ----------------------------------------- | ----------------------------- | | Reserva de emergência | Não | | Compra marcada para o próximo ano | Não | | Objetivo sem flexibilidade em poucos anos | Pouco | | Patrimônio de longo prazo | Podem fazer parte | Prazo longo não impede perdas. Ele apenas dá mais tempo para atravessar ciclos sem vender por necessidade. ## Tributação em 2026 A tributação depende do tipo de operação, do volume vendido e do resultado acumulado. Operações comuns e day trade seguem regras diferentes. Desde janeiro de 2026, dividendos acima de R$ 50 mil no mesmo mês pagos pela mesma empresa à mesma pessoa física estão sujeitos à retenção de 10%, conforme a [Lei 15.270/2025](https://www.planalto.gov.br/ccivil_03/_ato2023-2026/2025/lei/l15270.htm). Isso mudou a antiga frase genérica de que "dividendos são sempre isentos". Consulte as orientações atuais da Receita antes de vender ou receber valores relevantes. Guarde notas de corretagem e controle preço médio desde a primeira compra. ## Antes de comprar * [ ] A reserva de emergência está separada. * [ ] O dinheiro pode ficar investido por anos. * [ ] Você entende o que a empresa vende. * [ ] Sabe qual classe de ação está comprando. * [ ] A posição não concentra a carteira. * [ ] Conhece os custos e a tributação. O próximo passo é aprender [como analisar uma ação](/blog/como-analisar-acoes-guia-iniciantes-2026). Se você não quer analisar empresas individualmente, veja o [guia Bogleheads](/blog/guia-bogleheads-brasil-investimento-passivo-etfs) e considere fundos de índice amplos. ## Fontes [B3: ações](https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/renda-variavel/empresas-listadas.htm) · [B3: mercado de ações](https://borainvestir.b3.com.br/tipos-de-investimentos/renda-variavel/acoes/acoes-o-que-sao-e-como-investir/) · [Ministério da Fazenda: tributação de altas rendas](https://www.gov.br/fazenda/pt-br/assuntos/noticias/2025/novembro/sancionada-isencao-do-imposto-de-renda-para-quem-ganha-ate-r-5-mil-e-tributacao-minima-para-altas-rendas) *Conteúdo educacional. Ações podem perder valor e não são adequadas para todos os objetivos.* # Onde Investir em 2026: O Guia Definitivo para Seus Investimentos URL: /blog/onde-investir-2026-guia-completo-melhores-investimentos.mdx Descubra as melhores oportunidades de investimento para 2026. Análise completa de Renda Fixa, Ações, FIIs, Criptomoedas e Exterior. Monte sua carteira ideal. *** searchable: true title: 'Onde Investir em 2026: O Guia Definitivo para Seus Investimentos' description: 'Descubra as melhores oportunidades de investimento para 2026. Análise completa de Renda Fixa, Ações, FIIs, Criptomoedas e Exterior. Monte sua carteira ideal.' date: '2025-12-30' keywords: 'onde investir 2026, melhores investimentos 2026, carteira recomendada 2026, selic 2026, ações promissoras 2026, fiis 2026, criptomoedas 2026' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Estratégia' readingTime: '25 min' tags: \['Investimentos 2026', 'Renda Fixa', 'Ações', 'FIIs', 'Criptomoedas', 'Exterior', 'Carteira Recomendada'] relatedPosts: \['reserva-de-emergencia-guia-completo-2026', 'renda-fixa-vs-renda-variavel-2026', 'alocacao-de-ativos-por-idade-carteira-ideal-2026', 'bitcoin-brasil-como-investir-analise'] featured: true expertise: 'Guia estratégico elaborado por analistas financeiros com base nas projeções econômicas para 2026' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; O ano de 2026 chega com novos desafios e oportunidades para o investidor brasileiro. Com o cenário econômico global em constante transformação e o mercado doméstico apresentando dinâmicas únicas de juros e inflação, a pergunta que todos fazem é: **onde investir meu dinheiro em 2026?** Neste guia definitivo, vamos analisar as principais classes de ativos, projeções econômicas e estratégias para montar uma carteira vencedora no próximo ano. *** ## Cenário Econômico para 2026 Antes de escolher os ativos, é fundamental entender o "terreno" onde estamos pisando. ### 1. Taxa Selic e Juros Para 2026, a expectativa do mercado (Boletim Focus) aponta para uma estabilização ou leve queda na taxa Selic, dependendo do controle inflacionário. * **Cenário Base:** Selic em patamares de um dígito alto ou dois dígitos baixos (9% - 11%). * **Impacto:** A Renda Fixa continua atrativa, mas a Renda Variável ganha espaço à medida que os juros caem. ### 2. Inflação (IPCA) O controle da inflação segue como prioridade. A meta persegue o centro, mas choques externos (petróleo, dólar) são riscos constantes. * **Estratégia:** Proteger parte da carteira com ativos atrelados ao IPCA (Tesouro IPCA+, Debêntures Incentivadas, FIIs de Papel). ### 3. Cenário Internacional Os juros nos EUA (Fed Funds Rate) tendem a se normalizar, o que pode reduzir a pressão sobre o dólar e favorecer fluxos de capital para emergentes como o Brasil. **Acompanhe os indicadores macroeconômicos:** ```typescript // Selic + IPCA12m + CDI em uma única chamada const response = await fetch( 'https://brapi.dev/api/v2/macro/latest?symbols=selic,ipca12m,cdi', { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ) const { results } = await response.json() const selic = results.find((r) => r.series.slug === 'selic')?.latest.value const ipca = results.find((r) => r.series.slug === 'ipca12m')?.latest.value const cdi = results.find((r) => r.series.slug === 'cdi')?.latest.value ``` | Indicador | Slug | Exemplo de Valor | | ------------------ | -------------------------- | -------------------------------- | | Taxa Selic | `selic` | 14,50% | | IPCA acumulado 12m | `ipca12m` | 4,14% | | CDI | `cdi` | 0,054267% ao dia (\~14,40% a.a.) | | Juro Real | `(1+selic) / (1+ipca) - 1` | \~9,95% | > **Contexto 2026:** Um juro real acima de 6% ainda é atrativo para investidores globais. *** ## 1. Renda Fixa: A Base da Carteira em 2026 Mesmo com a possível queda de juros, a Renda Fixa brasileira continua pagando prêmios reais (acima da inflação) invejáveis mundialmente. ### Tesouro Direto * **Tesouro Selic:** Essencial para Reserva de Emergência e liquidez imediata. * **Tesouro IPCA+:** A melhor proteção de longo prazo contra a inflação. Busque taxas acima de IPCA + 5,5% ou 6% se disponíveis. * **Tesouro Prefixado:** Interessante apenas se a expectativa for de queda acentuada dos juros futuros (fechamento da curva). ### Crédito Privado (CDBs, LCIs, LCAs) * **Isenção:** LCIs, LCAs, CRIs, CRAs e Debêntures Incentivadas continuam isentos de IR para pessoa física (conforme regras vigentes). * **Risco x Retorno:** Prefira emissores bancários sólidos para CDBs/LCIs/LCAs (cobertura FGC) e analise o rating para CRIs/CRAs. **Onde alocar em 2026:** * **Conservador:** 60-80% da carteira. * **Moderado:** 30-50% da carteira. * **Arrojado:** 15-30% da carteira. *** ## 2. Ações Brasileiras: Oportunidades na Bolsa Com a perspectiva de juros menores, o custo de capital das empresas cai e o lucro tende a subir, impulsionando a Bolsa. ### Setores Promissores para 2026 1. **[Utilities (Energia e Saneamento):](/blog/melhores-acoes-setor-eletrico-2026-dividendos-taee11-trpl4)** Defensivos, pagadores de dividendos e com contratos reajustados pela inflação. 2. **[Bancos e Seguradoras:](/blog/acoes-bancos-analise-setorial-2026)** Beneficiam-se da atividade econômica e mantêm lucros robustos. (Veja também: [Seguros](/blog/setor-seguros-bbse3-cxse3-pssa3-analise-2026)) 3. **[Varejo e Consumo:](/blog/varejo-ecommerce-mglu3-lren3-meli34-analise-2026)** Podem se recuperar com força se o crédito ficar mais barato e o consumo aumentar. 4. **[Commodities (Vale, Petrobras, Agro):](/blog/vale3-petr4-commodities-analise-2026)** Dependem do cenário global (China/EUA), mas são geradoras de caixa e pagam bons dividendos. (Veja também: [Agronegócio](/blog/agronegocio-bolsa-slce3-agro3-analise-2026)) 5. **[Indústria (WEG):](/blog/wege3-analise-crescimento-2026)** Qualidade e internacionalização. ### Small Caps Empresas menores tendem a performar muito acima do Ibovespa em ciclos de queda de juros. Podem ser a "pimenta" da carteira de ações. [Veja nossa análise de Small Caps Promissoras](/blog/small-caps-promissoras-2026-analise). **Filtre ações promissoras por dividendos:** ```typescript const response = await fetch( 'https://brapi.dev/api/quote/list?sortBy=dividend_yield_score&sortOrder=desc&limit=5', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // data.stocks → Top 5 pagadoras de dividendos ``` *** ## 3. Fundos Imobiliários (FIIs): Renda Mensal Os FIIs seguem como favoritos para quem busca renda passiva isenta de IR. * **FIIs de Papel (Recebíveis):** Atrelados ao IPCA ou CDI. Se a inflação ou juros caírem, os dividendos nominais podem diminuir, mas o ganho de capital (valorização da cota) tende a aumentar. * **FIIs de Tijolo (Logística, Shoppings, Lajes):** Muito descontados nos últimos anos. Com juros caindo, tendem a se valorizar significativamente e os aluguéis são reajustados. * **Fiagros:** Oportunidade no setor mais forte do Brasil (Agronegócio), mas exige atenção aos riscos de crédito (calotes). **Dica 2026:** Diversifique entre Papel (proteção/renda imediata) e Tijolo (potencial de valorização/renda crescente). *** ## 4. Investimentos no Exterior: Diversificação Global Não coloque todos os ovos na cesta "Brasil". Ter parte do patrimônio em moeda forte (Dólar) é essencial. * **ETFs Globais (BDRs ou conta lá fora):** IVVB11 (S\&P 500) ou WRLD11 (Mundo todo). * **Renda Fixa em Dólar (Bonds):** Com juros americanos em patamares ainda interessantes, travar taxas em dólar é uma excelente estratégia. * **Tech e IA:** O setor de tecnologia segue inovando. Estar exposto às grandes empresas globais é participar do futuro. *** ## 5. Criptomoedas: A Nova Classe de Ativos Em 2026, o mercado cripto já está mais maduro, com regulação avançada no Brasil (Lei 14.478 e normas da Receita/BC). * **Bitcoin (BTC):** Reserva de valor digital. Deve compor de 1% a 5% da carteira, dependendo do perfil. * **Ethereum (ETH):** Plataforma de contratos inteligentes e base da Web3. * **Stablecoins (USDT/USDC):** Úteis para dolarizar parte do patrimônio com liquidez rápida. * **Tokenização (RWA):** Ativos reais tokenizados (imóveis, recebíveis) ganhando tração. **Cuidado:** Evite "memecoins" ou projetos sem fundamento se seu foco é construção de patrimônio. *** ## Alocação de Carteira Sugerida para 2026 Não existe carteira perfeita para todos, mas aqui estão sugestões de alocação baseadas em perfis de risco: ### Perfil Conservador (Foco: Preservação) * **Renda Fixa Pós (Selic/CDI):** 50% * **Renda Fixa IPCA+:** 30% * **FIIs (Foco em Papel High Grade):** 10% * **Exterior (Renda Fixa Dólar):** 10% ### Perfil Moderado (Foco: Equilíbrio) * **Renda Fixa (Multimercado):** 40% * **FIIs (Tijolo + Papel):** 25% * **Ações Brasil (Dividendos/Valor):** 15% * **Exterior (IVVB11/WRLD11):** 15% * **Cripto (BTC/ETH):** 5% ### Perfil Arrojado (Foco: Crescimento) * **Ações Brasil (Small Caps + Valor):** 30% * **FIIs (Tijolo/Desenvolvimento):** 20% * **Exterior (Ações Globais/Tech):** 25% * **Renda Fixa (Oportunidade/Caixa):** 15% * **Cripto:** 10% ``` ┌─────────────────────────────────────────────────────────────────┐ │ EXEMPLO DE CARTEIRA MODERADA 2026 │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ [ Cripto 5% ] │ │ / \ │ │ [ Exterior 15% ] [ Renda Fixa 40% ] │ │ | | │ │ IVVB11 / Bonds Tesouro IPCA+ / CDBs │ │ │ │ [ Ações BR 15% ] ── [ FIIs 25% ] │ │ Vale, Itaú, Weg Logística, Shoppings │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` *** ## Checklist do Investidor 2026 1. **Revise sua Reserva de Emergência:** Está adequada para seus custos atuais de 2026? 2. **Rebalanceamento:** Se a Bolsa subiu muito, venda um pouco e compre Renda Fixa (e vice-versa) para manter suas porcentagens alvo. 3. **Aporte Mensal:** A constância vence a rentabilidade. Foque em aumentar seus aportes. 4. **Educação Contínua:** O mercado muda. Continue estudando sobre novos ativos e dinâmicas econômicas. 5. **Cuidado com Golpes:** Promessas de rentabilidade garantida alta (ex: 2%, 5% ao mês) continuam sendo armadilhas. *** ## Conclusão Investir em 2026 exigirá seletividade. O "piloto automático" de deixar tudo no CDI pode render menos do que nos anos anteriores. A diversificação inteligente — combinando a segurança da Renda Fixa, o potencial de valorização das Ações e FIIs, e a proteção do Dólar e Bitcoin — será a chave para proteger e multiplicar seu patrimônio. Comece hoje a ajustar sua estratégia. O melhor momento para plantar uma árvore foi há 20 anos. O segundo melhor momento é agora. *** ## Recursos Adicionais * **[Reserva de Emergência 2026: Guia Prático](/blog/reserva-de-emergencia-2026-quanto-guardar)** * **[Alocação de Ativos por Idade](/blog/alocacao-de-ativos-por-idade-carteira-ideal-2026)** * **[Melhores FIIs para 2026](/blog/fundos-imobiliarios-fiis-guia-completo-iniciantes)** * **[Guia de Bitcoin e Cripto](/blog/bitcoin-brasil-como-investir-analise)** *Disclaimer: Este artigo tem caráter meramente educativo e não constitui recomendação de compra ou venda de ativos. Rentabilidade passada não é garantia de rentabilidade futura. Consulte um profissional certificado para recomendações personalizadas.* # Opções da Bolsa Brasileira para Iniciantes: Calls, Puts, Strikes e Vencimentos URL: /blog/opcoes-b3-guia-completo-iniciantes-calls-puts.mdx Aprenda opções da bolsa brasileira em 2026: call, put, strike, prêmio, vencimento, moneyness, riscos, imposto de renda e exemplos simples para iniciantes. *** searchable: true title: 'Opções da Bolsa Brasileira para Iniciantes: Calls, Puts, Strikes e Vencimentos' description: 'Aprenda opções da bolsa brasileira em 2026: call, put, strike, prêmio, vencimento, moneyness, riscos, imposto de renda e exemplos simples para iniciantes.' date: '2025-12-29' keywords: 'opções de ações brasileiras, opções para iniciantes, call put opções, strike opções, vencimento opções de ações brasileiras, opções de ações Brasil, gregas opções, imposto opções' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Derivativos' readingTime: '14 min' tags: \['Opções', 'Derivativos', 'Bolsa Brasileira', 'Calls', 'Puts', 'Estratégias', 'Iniciantes'] relatedPosts: \['dividendos-sinteticos-opcoes-covered-call-2026', 'cadeia-opcoes-b3-python-tutorial-api-brapi', 'backtesting-opcoes-python-brapi-tutorial'] featured: true expertise: 'Equipe técnica especializada em derivativos e estratégias de investimento' lastReviewed: '2026-04-23' faqSchema: * question: 'O que são opções da bolsa brasileira?' answer: 'Opções são contratos que dão ao comprador o direito de comprar ou vender um ativo por um preço de exercício até uma data de vencimento, enquanto o vendedor assume obrigação se houver exercício.' * question: 'Qual a diferença entre call e put?' answer: 'Call é opção de compra. Put é opção de venda. Quem compra call espera alta do ativo; quem compra put busca proteção ou exposição à queda.' * question: 'Quando vencem opções de ações brasileiras?' answer: 'Nas séries tradicionais, as opções de ações vencem na terceira sexta-feira de cada mês, conforme calendário da bolsa brasileira. Também existem opções semanais com vencimentos em outras sextas-feiras.' * question: 'Opções têm isenção de R$ 20 mil no IR?' answer: 'Não. A isenção mensal de R$ 20 mil aplicável a vendas de ações no mercado à vista não se aplica a opções. Ganhos em operações comuns costumam ser tributados a 15% e day trade a 20%.' *** import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > Opções são instrumentos úteis para proteção, renda e especulação, mas não são produto para operar no impulso. Antes de comprar uma call barata ou vender uma put, entenda direito o que são prêmio, strike, vencimento, exercício e risco. ## Resumo Direto Uma opção é um contrato. O comprador paga um **prêmio** para ter um **direito**. O vendedor recebe o prêmio e assume uma **obrigação** caso a opção seja exercida. | Tipo | Direito do comprador | Quando ganha valor | | ---- | --------------------------- | ------------------- | | Call | Comprar o ativo pelo strike | Quando o ativo sobe | | Put | Vender o ativo pelo strike | Quando o ativo cai | |paga prêmio| V[Vendedor] C -->|tem direito| D[Exercer ou vender a opção] V -->|assume obrigação| O[Cumprir se exercido] `} /> ## Termos Básicos | Termo | Significado | | ------------ | -------------------------------------------------------- | | Ativo-objeto | Ação, ETF, BDR ou índice ao qual a opção se refere | | Strike | Preço de exercício | | Prêmio | Preço pago pela opção | | Vencimento | Data limite da série | | Titular | Quem compra a opção | | Lançador | Quem vende a opção | | Lote | Quantidade vinculada ao contrato, conforme especificação | Na bolsa brasileira, opções de ações, units, ETFs e BDRs seguem códigos padronizados. O ticker carrega o ativo-objeto, uma letra de série e uma referência de preço de exercício. ## Call: Opção de Compra Uma **call** dá ao comprador o direito de comprar o ativo pelo strike. Se PETR4 está a R$ 40 e você tem uma call com strike de R$ 35, essa call tem valor intrínseco porque permite comprar abaixo do preço de mercado. O lucro do comprador não começa no strike, e sim no **break-even**: ```text Break-even da call = strike + prêmio pago ``` Se a call tem strike de R$ 35 e custou R$ 2, o ativo precisa passar de R$ 37 para a operação começar a compensar no vencimento, desconsiderando custos. ## Put: Opção de Venda Uma **put** dá ao comprador o direito de vender o ativo pelo strike. Ela pode ser usada para proteger carteira ou para buscar ganho em queda. ```text Break-even da put = strike - prêmio pago ``` Se a put tem strike de R$ 60 e custou R$ 3, o ponto de equilíbrio é R$ 57 no vencimento. ## Moneyness: ITM, ATM e OTM | Estado | Call | Put | | ------ | ---------------------- | ---------------------- | | ITM | Ativo acima do strike | Ativo abaixo do strike | | ATM | Ativo perto do strike | Ativo perto do strike | | OTM | Ativo abaixo do strike | Ativo acima do strike | Opções OTM podem ser baratas, mas precisam de movimento maior do ativo para ter valor intrínseco no vencimento. Esse é um dos erros mais comuns de iniciantes: comprar opções muito fora do dinheiro apenas porque o preço parece baixo. ## Valor Intrínseco e Valor do Tempo O prêmio de uma opção tem dois componentes: ```text Prêmio = valor intrínseco + valor extrínseco ``` Para calls, o valor intrínseco é `max(0, preço do ativo - strike)`. Para puts, é `max(0, strike - preço do ativo)`. O valor extrínseco vem do tempo até o vencimento, volatilidade, juros, dividendos esperados e oferta e demanda. Quanto mais perto do vencimento, menor tende a ser o valor do tempo. Esse efeito é chamado de **theta**. ## Vencimentos na Bolsa Brasileira Nas séries tradicionais de opções sobre ações, o vencimento ocorre na **terceira sexta-feira de cada mês**, conforme calendário da bolsa brasileira. Também existem opções semanais sobre ações, ETFs e BDRs, com vencimentos em sextas-feiras que não sejam a terceira sexta do mês. Antes de operar, consulte o calendário oficial da bolsa brasileira e a série exata no home broker. Datas, liquidez e exercício automático podem afetar o resultado. ## Letras das Séries | Mês | Call | Put | | --------- | ---- | --- | | Janeiro | A | M | | Fevereiro | B | N | | Março | C | O | | Abril | D | P | | Maio | E | Q | | Junho | F | R | | Julho | G | S | | Agosto | H | T | | Setembro | I | U | | Outubro | J | V | | Novembro | K | W | | Dezembro | L | X | Exemplo: uma série começando por PETR e com letra A indica uma call de janeiro relacionada a Petrobras. O número do final ajuda a identificar o strike, mas o strike exato deve ser conferido na plataforma. ## As Gregas, Sem Complicar | Grega | Mede | Por que importa | | ----- | ------------------------------- | ------------------------------------------------------------ | | Delta | Sensibilidade ao preço do ativo | Estima quanto a opção muda quando o ativo muda | | Theta | Efeito do tempo | Mostra perda de valor por passagem do tempo | | Vega | Sensibilidade à volatilidade | Opção pode cair mesmo com ativo estável se volatilidade cair | | Gamma | Variação do delta | Mostra aceleração do risco | Iniciantes não precisam decorar fórmulas, mas precisam entender a lógica: opção não depende só da direção do ativo. Tempo e volatilidade podem destruir uma operação correta na direção. ## Exemplo Simples de Call | Premissa | Valor | | -------------- | ------------ | | Ativo | PETR4 | | Preço do ativo | R$ 36 | | Call | Strike R$ 35 | | Prêmio | R$ 2 | | Break-even | R$ 37 | | Preço no vencimento | Resultado aproximado | | ------------------- | -------------------------------------- | | R$ 34 | Perda do prêmio | | R$ 36 | Perda parcial ou total | | R$ 37 | Ponto de equilíbrio | | R$ 40 | Ganho de R$ 3 por ação antes de custos | Esse exemplo ignora corretagem, impostos, spread e variação de volatilidade antes do vencimento. Na prática, muitos investidores vendem a opção antes de vencer. ## Estratégias Básicas Para iniciantes, faz mais sentido estudar primeiro estruturas com risco limitado: compra de call, compra de put, trava de alta e trava de baixa. Venda descoberta deve ser evitada até que o investidor entenda margem, exercício, chamada de garantia e risco de perda. Uma estratégia popular de geração de renda é a venda coberta de call: o investidor tem a ação e vende uma call sobre ela. Isso limita parte da alta em troca de prêmio. Não é renda grátis; é troca de potencial de valorização por fluxo imediato. ## Tributação de Opções Operações com opções não têm a isenção mensal de R$ 20 mil que muitos investidores associam ao mercado à vista de ações. Em regra, ganhos líquidos em operações comuns são tributados a 15%, e day trade a 20%. Prejuízos podem ser compensados dentro das regras aplicáveis. | Operação | Alíquota comum | | -------------- | --------------- | | Operação comum | 15% sobre lucro | | Day trade | 20% sobre lucro | Guarde notas de corretagem e apure mensalmente. Se você opera opções com frequência, uma planilha ou software de IR deixa de ser opcional. ## Como Consultar Opções pela brapi.dev A brapi.dev tem documentação específica para opções: ```typescript const response = await fetch( 'https://brapi.dev/api/v2/options/expirations?underlying=PETR4', { headers: { Authorization: 'Bearer SEU_TOKEN' } }, ); const expirations = await response.json(); console.log(expirations); ``` Veja a [documentação de opções](/docs/opcoes) para séries, vencimentos, histórico e preços de exercício disponíveis. ## Erros Comuns O principal erro é tratar opção barata como aposta assimétrica sem probabilidade. Outro erro é ignorar liquidez: uma opção pode ter preço teórico, mas spread muito aberto. Também é perigoso segurar posição até o vencimento sem saber se haverá exercício automático. Uma regra simples para começar: opere pequeno, use ordem limitada e saiba exatamente o que acontece no vencimento. ## Fontes Revisadas [Bolsa Educação: opções sobre ações](https://edu.b3.com.br/w/opcoes-acoes) · [Bolsa brasileira: opções semanais sobre ações](https://www.b3.com.br/pt_br/produtos-e-servicos/negociacao/renda-variavel/opcoes-semanais-sobre-acoes.htm) · [Documentação brapi.dev de opções](/docs/opcoes) ## Perguntas Frequentes ### O que acontece se a opção vencer fora do dinheiro? Ela expira sem valor intrínseco. O comprador perde o prêmio pago e o vendedor fica com o prêmio, desconsiderando custos e ajustes. ### Preciso exercer a opção? Não necessariamente. Muitas operações são encerradas vendendo a opção antes do vencimento. Se você mantiver até o vencimento, entenda as regras de exercício automático. ### Comprar opção limita minha perda? Sim, na compra seca de call ou put a perda máxima é o prêmio pago. Mas perder 100% do prêmio é comum quando a operação não anda a favor ou quando o tempo passa. ### Vender opção é perigoso? Pode ser. Venda coberta tem risco controlado pelo ativo em carteira. Venda descoberta pode ter risco muito alto e exige margem. ## Conclusão Opções da Bolsa Brasileira são ferramentas poderosas, mas exigem precisão. Aprenda primeiro call, put, strike, prêmio, vencimento e break-even. Depois avance para gregas e estratégias. O investidor que respeita tamanho de posição e entende o vencimento já evita boa parte dos erros mais caros. *Este artigo é educacional e não constitui recomendação de investimento. Opções são derivativos e podem gerar perdas relevantes.* # Pagamentos com Criptomoedas no Brasil 2026: O Guia dos Crypto Rails URL: /blog/pagamentos-cripto-brasil-2026-rails-guia.mdx Como usar criptomoedas para pagamentos no dia a dia em 2026. Guia sobre cartões cripto, Binance Pay, Solana Pay e a integração com o Pix. *** searchable: true title: 'Pagamentos com Criptomoedas no Brasil 2026: O Guia dos Crypto Rails' description: 'Como usar criptomoedas para pagamentos no dia a dia em 2026. Guia sobre cartões cripto, Binance Pay, Solana Pay e a integração com o Pix.' date: '2025-12-27' keywords: 'pagamento cripto brasil, cartão binance, solana pay, bitrefill brasil, pagar boleto com bitcoin, crypto rails, visa mastercard cripto' author: 'Equipe brapi.dev' category: 'Tecnologia' subcategory: 'Criptomoedas' readingTime: '14 min' tags: \['Pagamentos', 'Crypto Rails', 'Visa', 'Mastercard', 'Pix', 'Solana Pay'] relatedPosts: \['stablecoins-brasil-usdt-brz-drex-guia-2026', 'carteiras-criptomoedas-guia-seguranca-2026', 'bitcoin-brasil-como-investir-analise'] featured: true expertise: 'Análise das soluções de pagamento cripto-fiat e infraestrutura de liquidação' lastReviewed: '2026-01-18' -------------------------- import { Authors, Author } from '~/components/Authors'; Em 2026, usar Bitcoin ou Stablecoins para comprar um café não é mais ficção científica. A infraestrutura de pagamentos (os chamados **Crypto Rails**) evoluiu massivamente, conectando a liquidez das criptomoedas aos terminais de pagamento tradicionais (Visa/Mastercard) e ao nosso onipresente Pix. Não se trata apenas de "gastar Bitcoin", mas de usar a eficiência das redes blockchain (como Solana ou Lightning Network) para mover valor globalmente de forma instantânea e barata. Neste guia, exploramos como você pode viver 100% "bankless" no Brasil usando as ferramentas de pagamento de 2026. *** ## O Que São "Crypto Rails"? Crypto Rails são a infraestrutura que permite que transações em blockchain sejam aceitas no mundo real. Eles funcionam como "tradutores" instantâneos: 1. **Você paga:** Envia USDT ou BTC da sua carteira. 2. **O Rail converte:** Vende a cripto por Fiat (Reais/Dólares) em milissegundos. 3. **O lojista recebe:** O valor cai na conta dele em moeda local, sem volatilidade. ### Por que usar? * **Globalização:** Seu dinheiro (USDC/BTC) funciona em qualquer lugar do mundo, sem trocar de câmbio. * **Privacidade:** Menor exposição de dados bancários tradicionais (em alguns casos). * **Rendimento:** Mantenha seu dinheiro rendendo em DeFi até o segundo exato do gasto. *** ## Principais Soluções no Brasil ### 1. Cartões Cripto (Visa/Mastercard) A forma mais fácil de gastar cripto. Você carrega o saldo, e passa o cartão no débito/crédito. * **Binance Card:** Integração direta com saldo da exchange. Conversão na hora da compra. * **Crypto.com Card:** Famoso pelos cashbacks (agora mais modestos, mas ainda existentes) e benefícios como Spotify/Netflix. * **Cartões Nacionais (Ripio, MB, Foxbit):** Oferecem cashback em BTC (Crypto-back) de até 1-5% em compras. ### 2. Solana Pay (Pagamentos Diretos) A rede Solana, por ser extremamente rápida e barata, tornou-se a favorita para pagamentos diretos (P2P e P2B). * **Como funciona:** O lojista gera um QR Code. Você escaneia com a Phantom Wallet e aprova. * **Vantagem:** Taxa quase zero para ambas as partes (sem os 3-5% das maquininhas de cartão). * **Integração Shopify:** Lojas virtuais aceitam USDC nativo via Solana Pay. ### 3. Bitrefill e Gift Cards Uma das formas mais antigas e privadas. Você usa Bitcoin (Lightning) ou outras criptos para comprar créditos de: * iFood, Uber, Uber Eats. * Steam, PlayStation, Xbox. * Amazon, Carrefour. * Recarga de Celular. ### 4. Pagamento de Boletos e Pix Plataformas como **Bitybank, SmartPay e PagueComBitcoin** permitem pagar qualquer boleto ou fazer um Pix usando seu saldo cripto. * **Destaque:** Integração **USDT -> Pix**. Você envia USDT e o destinatário recebe Pix em segundos. Essencial para nômades digitais e freelancers que recebem do exterior. *** ## O Papel da Lightning Network (Bitcoin) Em 2026, a **Lightning Network** finalmente atingiu maturidade de UX (Experiência do Usuário). Carteiras como **Wallet of Satoshi, Strike e Blink** tornaram o uso do Bitcoin para micropagamentos (comprar um pão de queijo) viável. * **Velocidade:** Instantânea. * **Custo:** Fração de centavo. * **Adoção:** El Salvador e Lugano (Suíça) lideraram, mas hubs no Brasil (como Jericoacoara e São Paulo) aceitam amplamente. *** ## Desafios e Cuidados 1. **Evento Tributável:** No Brasil, **pagar com cripto = vender cripto**. Se você comprou BTC a R$ 100k e gastou quando estava a R$ 500k, você teve ganho de capital. * *Alívio:* Vendas (gastos) totais abaixo de R$ 35.000/mês são isentas de IR sobre o ganho. 2. **Taxas de Conversão (Spread):** Cartões cripto costumam cobrar um spread na conversão (0.5% a 2%). Compare com os benefícios (cashback). 3. **Volatilidade:** Se você mantém seu saldo em Bitcoin para pagar contas do mês, uma queda de 10% no mercado reduz seu poder de compra instantaneamente. **Dica:** Mantenha o "caixa do mês" em Stablecoins (USDC/USDT). *** ## O Futuro: Super Apps Web3 A tendência para o final da década é a fusão total. Apps como **Telegram (via TON Wallet)** e **WhatsApp (testes com stablecoins)** querem que enviar dinheiro seja tão fácil quanto enviar um emoji. No Brasil, o **DREX** promete automatizar pagamentos condicionais (Smart Payments), tornando contratos de aluguel e serviços "auto-pagáveis". *** ## Conclusão Viver de cripto no Brasil em 2026 é totalmente possível. Com um cartão cripto na carteira e um app de pagamentos no celular, você não precisa mais de um banco tradicional para o dia a dia. A liberdade financeira agora inclui a liberdade de escolher *como* e *com o que* pagar. *** ## Recursos Adicionais * **[Stablecoins: O Dinheiro do Futuro](/blog/stablecoins-brasil-usdt-brz-drex-guia-2026)** * **[Solana e Velocidade](/blog/solana-sol-guia-completo-brasil-2026)** * **[Bitcoin como Moeda](/blog/bitcoin-brasil-como-investir-analise)** *Disclaimer: Gastos com cripto podem gerar obrigações fiscais. Consulte um contador.* # Payout e Dividend Yield: Como Identificar Dividendos Sustentáveis em 2026 URL: /blog/payout-dividend-yield-sustentabilidade-2026.mdx Cuidado com o Dividend Yield alto! Aprenda a analisar o Payout Ratio para saber se os dividendos da sua carteira correm risco de corte em 2026. *** searchable: true title: 'Payout e Dividend Yield: Como Identificar Dividendos Sustentáveis em 2026' description: 'Cuidado com o Dividend Yield alto! Aprenda a analisar o Payout Ratio para saber se os dividendos da sua carteira correm risco de corte em 2026.' date: '2025-12-26' keywords: 'payout ratio, dividend yield 2026, dividendos sustentaveis, armadilha de dividendos, dividend trap, taee11 payout, petr4 payout' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Dividendos' readingTime: '10 min' tags: \['Dividendos', 'Payout', 'Yield', 'Sustentabilidade', 'Renda Passiva'] relatedPosts: \['fluxo-de-caixa-livre-vs-lucro-contabil-2026', 'melhores-acoes-setor-eletrico-2026-dividendos-taee11-trpl4', 'melhores-acoes-pagadoras-dividendos-2026'] featured: false expertise: 'Análise de sustentabilidade de proventos para investidores de renda.' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; Você abre o *screener* e vê uma ação pagando **20% de Dividend Yield**. Seus olhos brilham. Você compra. No ano seguinte, o dividendo cai para 2%. A ação despenca 30%. Você perdeu dinheiro. Bem-vindo à **Dividend Trap** (Armadilha de Dividendos). Em 2026, vamos te ensinar a não cair nela olhando uma métrica simples: o **Payout Ratio**. *** ## O que é Payout Ratio? É a porcentagem do lucro líquido que a empresa distribui aos acionistas. **Payout = Dividendo Pagos / Lucro Líquido** ### Interpretando o Payout em 2026 * **Payout Saudável (25% a 70%):** A empresa paga bons dividendos e retém parte do lucro para reinvestir e crescer. É o equilíbrio ideal. (Ex: **Bancos**, **Seguradoras**). * **Payout Alto (> 90%):** A empresa não cresce mais. Ela distribui tudo o que ganha. Ótimo para renda imediata, péssimo para crescimento futuro. (Ex: **Taesa**). * **Payout Insustentável (> 100%):** A empresa distribuiu mais do que lucrou. * **Como?** Ela usou caixa acumulado de anos anteriores ou, pior, tomou dívida para pagar dividendo. * **O Risco:** Isso não dura para sempre. O corte de dividendos é iminente. *** ## Dividend Yield: O Retrovisor O Dividend Yield mostra quanto a empresa pagou nos **últimos 12 meses** dividido pelo preço **atual**. * Se a ação cai 50%, o Yield dobra matematicamente (mesmo que o dividendo seja o mesmo). * Se a empresa pagou um dividendo "Não Recorrente" (vendeu uma fábrica, ganhou uma causa judicial), o Yield explode, mas isso não vai se repetir ano que vem. **Regra de Ouro:** Nunca compre uma ação só pelo Yield passado. Projete o Yield futuro baseando-se no Payout e na expectativa de lucro. *** ## Estudo de Caso: Petrobras 2022-2026 Em 2022, a Petrobras pagou yields estratosféricos (acima de 50% em alguns momentos). O Payout estava alto e o preço do petróleo também. Quem comprou achando que receberia 50% ao ano *para sempre* se frustrou quando o petróleo caiu ou a política de retenção mudou. Ainda é um ótimo dividendo? Sim. Mas não é 50%. *** ## Calculando Payout com Python Verifique se suas ações estão "pagando demais". ```typescript const response = await fetch( 'https://brapi.dev/api/quote/TAEE11?modules=defaultKeyStatistics,financialData÷nds=true', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const { results } = await response.json() const stats = results[0].defaultKeyStatistics ?? {} const lastDividend = results[0].dividendsData?.cashDividends?.[0]?.rate ?? 0 const earningsPerShare = results[0].earningsPerShare ?? stats.earningsPerShare // Payout = (Dividendo por Ação / Lucro por Ação) * 100 ``` ### Interpretação do Payout | Payout | Interpretação | | ---------- | -------------------------------------------- | | > 100% | ALERTA: Pagando mais que lucra. Sustentável? | | 80% - 100% | Atenção: Payout alto. Empresa madura | | \< 80% | Payout saudável | *** ## Conclusão Em 2026, busque a **Consistência**. Uma empresa que paga 6% ao ano, todo ano, e cresce esse pagamento acima da inflação (Dividend Growth), vai te deixar rico. A empresa que paga 20% em um ano e 0% no outro vai te dar úlcera. Olhe o Payout. Se for maior que 100%, fuja ou investigue muito bem o porquê. *** ## Leia Mais * **[Tutorial Dashboard de Dividendos](/blog/dashboard-dividendos-python-streamlit-brapi-tutorial)** * **[Renda Fixa ou Dividendos?](/blog/renda-fixa-vs-renda-variavel-2026)** # Planejamento financeiro pessoal que funciona no mês real URL: /blog/planejamento-financeiro-pessoal-guia-completo-2026.mdx Um método simples para organizar o dinheiro, escolher prioridades, montar a reserva e investir sem depender de uma planilha perfeita. *** searchable: true title: 'Planejamento financeiro pessoal que funciona no mês real' description: 'Um método simples para organizar o dinheiro, escolher prioridades, montar a reserva e investir sem depender de uma planilha perfeita.' date: '2026-01-01' keywords: 'planejamento financeiro pessoal, como organizar financas, orcamento pessoal, metas financeiras, controle financeiro, organizar dinheiro, planilha financeira, educacao financeira' author: 'Alisson Leal' category: 'Educação Financeira' subcategory: 'Planejamento' readingTime: '9 min' tags: \['Planejamento Financeiro', 'Orçamento', 'Metas Financeiras', 'Educação Financeira', 'Finanças Pessoais'] relatedPosts: \['como-sair-das-dividas-comecar-investir-guia-2026', 'reserva-de-emergencia-guia-completo-2026', 'como-comecar-investir-do-zero-guia-iniciantes-2026', 'alocacao-de-ativos-por-idade-carteira-ideal-2026'] featured: true expertise: 'Educação financeira, orçamento e primeiros investimentos' lastReviewed: '2026-06-23' faqSchema: * question: 'Quanto da renda devo guardar?' answer: 'Não existe um percentual universal. Comece com um valor que caiba no orçamento e aumente quando renda, dívidas ou despesas mudarem.' * question: 'A regra 50-30-20 funciona para todo mundo?' answer: 'Não. Ela é uma referência para observar o orçamento. Famílias com moradia cara, renda baixa ou dependentes podem precisar de outra divisão.' * question: 'Com que frequência devo revisar o planejamento?' answer: 'Faça uma revisão curta todo mês e uma revisão maior quando renda, família, trabalho ou objetivos mudarem.' *** import { Authors, Author } from '~/components/Authors'; Planejamento financeiro não é prever os próximos vinte anos. É decidir o que o dinheiro deste mês precisa fazer. Uma planilha detalhada pode ajudar, mas não salva um orçamento que ignora despesas irregulares, dívidas e a vida que você realmente leva. ## Comece nesta ordem ## 1. Olhe o fluxo antes do patrimônio Patrimônio líquido é útil: ```text patrimônio líquido = tudo que você tem menos tudo que deve ``` Mas o primeiro problema costuma estar no fluxo mensal. Uma pessoa pode ter carro e imóvel e ainda ficar sem dinheiro antes do fim do mês. Revise os últimos três meses e agrupe: | Grupo | Exemplos | | ---------- | -------------------------------------------------------- | | Essencial | Moradia, alimentação, saúde, transporte e contas básicas | | Flexível | Lazer, compras, assinaturas e refeições fora | | Financeiro | Dívidas, reserva, metas e investimentos | | Irregular | Seguro, manutenção, matrícula, impostos e presentes | Despesas irregulares não são imprevistos. Se acontecem todo ano, divida o valor por doze e reserve mensalmente. ## 2. Use percentuais como diagnóstico A regra 50-30-20 separa 50% para necessidades, 30% para desejos e 20% para o futuro. Ela é uma referência, não um teste de disciplina. Se a moradia consome 55% da renda, fingir que o limite é 50% não resolve. A pergunta passa a ser outra: existe margem para renegociar, mudar, aumentar renda ou reduzir outro grupo? Um bom orçamento mostra restrições. Ele não precisa parecer equilibrado. ## 3. Defina um piso e um teto Em vez de controlar cada café, defina: * um piso para reserva, dívidas ou metas; * um teto para gastos flexíveis; * provisões para despesas anuais; * uma pequena margem para erro. Exemplo com renda líquida de R$ 5.000: | Destino | Valor | | ------------------ | ----------------: | | Gastos essenciais | R$ 3.200 | | Gastos flexíveis | até R$ 900 | | Dívidas ou reserva | pelo menos R$ 600 | | Despesas anuais | R$ 200 | | Margem | R$ 100 | O valor certo é o que fecha no extrato, não o que parece bonito em uma regra. ## 4. Resolva a fragilidade principal Escolha uma prioridade para os próximos três meses. Pode ser: * sair do rotativo do cartão; * juntar a primeira reserva; * organizar uma despesa anual; * reduzir um custo fixo; * recuperar renda perdida. Tentar quitar dívidas, montar reserva, viajar e investir em ações ao mesmo tempo costuma espalhar pouco dinheiro entre objetivos demais. Se há dívidas caras, leia [como sair das dívidas](/blog/como-sair-das-dividas-comecar-investir-guia-2026). Se o orçamento já está estável, avance para a reserva. ## 5. Monte a reserva por etapas Você não precisa esperar juntar seis meses de despesas para sentir algum efeito. Divida a meta: 1. valor para uma emergência comum; 2. um mês de gastos essenciais; 3. três meses; 4. o número final adequado à estabilidade da renda. Quem trabalha por conta própria, sustenta outras pessoas ou teria recolocação lenta tende a precisar de mais. Quem divide despesas e tem renda previsível pode começar com menos. A reserva pede liquidez e baixo risco. Rentabilidade é secundária. ## 6. Transforme desejos em contas "Quero viajar" não orienta o orçamento. "Preciso de R$ 9.000 em quinze meses" orienta. ```text aporte aproximado = valor que falta dividido pelos meses ``` Depois inclua uma margem para inflação e custos esquecidos. Para metas de curto prazo, prefira uma estimativa conservadora de rendimento. O plano não deve depender de a bolsa subir no momento certo. | Prazo | Prioridade | | ----------------- | ---------------------------------------- | | Até dois anos | Preservação e liquidez | | Dois a cinco anos | Vencimento compatível e baixo risco | | Longo prazo | Diversificação e tolerância a oscilações | ## 7. Automatize poucas coisas Automatize o que não exige decisão: * transferência para a reserva logo após a renda entrar; * provisão mensal de contas anuais; * pagamento mínimo obrigatório das dívidas; * aporte recorrente de longo prazo. Não automatize uma quantia que deixa a conta negativa no fim do mês. Revise primeiro. ## 8. Faça uma reunião mensal de vinte minutos Uma revisão útil responde: 1. O mês fechou positivo ou negativo? 2. Qual categoria saiu do esperado? 3. Foi um caso isolado ou uma mudança permanente? 4. A prioridade dos próximos três meses continua correta? 5. O valor automatizado ainda cabe? Não refaça a planilha inteira. Ajuste apenas o que mudou. ## Sinais de que o plano está complexo demais * você precisa registrar toda compra no mesmo minuto; * existem mais categorias do que despesas; * uma semana ruim faz você abandonar o mês; * a meta depende de retorno otimista; * você acompanha investimentos, mas não sabe o custo da casa; * o plano não reserva dinheiro para diversão. O planejamento precisa sobreviver a um mês imperfeito. ## Para fazer hoje * [ ] Revise três meses de extratos. * [ ] Separe essencial, flexível, financeiro e irregular. * [ ] Escolha uma prioridade para noventa dias. * [ ] Defina um piso mensal para ela. * [ ] Programe uma revisão daqui a um mês. Quando o fluxo estiver estável, siga para [como começar a investir do zero](/blog/como-comecar-investir-do-zero-guia-iniciantes-2026) e [alocação de ativos](/blog/alocacao-de-ativos-por-idade-carteira-ideal-2026). *Conteúdo educacional. Não é recomendação financeira individual.* # Tutorial: Planilha de Ações Automática no Google Sheets com Apps Script URL: /blog/planilha-google-sheets-cotacoes-automaticas-apps-script.mdx Aprenda a conectar o Google Sheets à API da brapi.dev para ter cotações, P/L e Dividend Yield atualizados automaticamente na sua planilha. *** searchable: true title: 'Tutorial: Planilha de Ações Automática no Google Sheets com Apps Script' description: 'Aprenda a conectar o Google Sheets à API da brapi.dev para ter cotações, P/L e Dividend Yield atualizados automaticamente na sua planilha.' date: '2026-01-02' keywords: 'google sheets ações, apps script api, planilha investimentos automatica, brapi google sheets, cotação excel online, importjson google sheets' author: 'Equipe brapi.dev' category: 'Desenvolvimento' subcategory: 'Planilhas' readingTime: '10 min' tags: \['Google Sheets', 'Apps Script', 'Excel', 'Tutorial', 'Produtividade'] relatedPosts: \['bot-telegram-cotacoes-acoes-python-tutorial', 'dashboard-dividendos-python-streamlit-brapi-tutorial', 'excel-cotacoes-b3-power-query-vba'] featured: false expertise: 'Tutorial para transformar sua planilha manual em um sistema automático.' lastReviewed: '2026-02-01' -------------------------- import { Authors, Author } from '~/components/Authors'; Você ainda atualiza sua planilha de investimentos manualmente? Ou usa o `GOOGLEFINANCE()` que tem atraso de 20 minutos e falha com FIIs e BDRs constantemente? Neste tutorial, vamos criar uma função personalizada `=BRAPI("PETR4")` no Google Sheets que busca o preço em tempo real (sem delay), além de indicadores fundamentalistas, usando a API da **brapi.dev**. *** ## O Segredo: Google Apps Script O Google Sheets tem uma linguagem de programação embutida chamada Apps Script (baseada em JavaScript). Vamos usá-la para conectar na API. ### Passo 1: Abrindo o Editor 1. Abra sua planilha no Google Sheets. 2. No menu, vá em **Extensões** > **Apps Script**. ### Passo 2: O Código Mágico Apague o código que estiver lá e cole este: ```javascript /** * Busca dados de uma ação na API da brapi.dev * * @param {string} ticker O código da ação (ex: "PETR4"). * @param {string} atributo O dado desejado: "price", "change", "pl", "dy", "sector". * @return O valor do dado solicitado. * @customfunction */ function BRAPI(ticker, atributo) { if (!ticker) return "Ticker vazio"; // SEU TOKEN AQUI (Pegue em https://brapi.dev) var token = "SEU_TOKEN_AQUI"; // Cache para evitar chamar a API repetidamente para o mesmo ticker na mesma execução var cache = CacheService.getScriptCache(); var cacheKey = ticker + "_" + atributo; var cached = cache.get(cacheKey); if (cached != null) { return isNaN(cached) ? cached : parseFloat(cached); } var url = "https://brapi.dev/api/quote/" + ticker + "?token=" + token + "&modules=defaultKeyStatistics,financialData"; try { var response = UrlFetchApp.fetch(url); var json = JSON.parse(response.getContentText()); var stock = json.results[0]; var valor = ""; // Mapeamento de atributos switch(atributo.toLowerCase()) { case "price": valor = stock.regularMarketPrice; break; case "change": valor = stock.regularMarketChangePercent; break; case "pl": valor = stock.defaultKeyStatistics?.trailingPE; break; case "dy": valor = stock.defaultKeyStatistics?.dividendYield; break; case "pvp": valor = stock.defaultKeyStatistics?.priceToBook; break; case "sector": valor = stock.sector; break; default: return "Atributo inválido. Use: price, change, pl, dy, pvp, sector"; } // Salva no cache por 10 minutos (600 segundos) para economizar requisições cache.put(cacheKey, String(valor), 600); return valor; } catch (e) { return "Erro: " + e.message; } } ``` ### Passo 3: Salvando 1. Clique no ícone de disquete (Salvar). 2. Dê um nome ao projeto (ex: "BrapiAPI"). *** ## Passo 4: Usando na Planilha Volte para a planilha e digite em qualquer célula: * Para ver o preço: `=BRAPI("WEGE3"; "price")` * Para ver o P/L: `=BRAPI("WEGE3"; "pl")` * Para ver o Dividend Yield: `=BRAPI("TAEE11"; "dy")` Pronto! Agora você tem dados profissionais direto no seu Excel online. *** ## Vantagens sobre o GOOGLEFINANCE 1. **FIIs e BDRs:** A brapi funciona perfeitamente para todos os ativos da bolsa brasileira, onde o Google Finance costuma falhar. 2. **Fundamentos:** O Google não entrega P/L, P/VP ou Dividend Yield. Com esse script, você tem tudo isso. 3. **Tempo Real:** Dados atualizados, essenciais para *Day Trade* ou *Swing Trade*. *** ## Dica Pro: Atualização em Massa Se você tem uma lista longa de ativos (A2:A20), evite chamar a API linha por linha, pois pode ficar lento. O ideal é adaptar o script para receber um intervalo (`=BRAPI(A2:A20)`) e fazer uma única chamada à API pedindo múltiplos tickers separados por vírgula. A API da brapi suporta isso! Mas, para começar, a função simples acima já vai revolucionar sua organização financeira. *** ## Leia Mais * **[Tutorial de Python e Telegram](/blog/bot-telegram-cotacoes-acoes-python-tutorial)** * **[Comparativo de APIs: Brapi vs Yahoo Finance](/blog/brapi-vs-yahoo-finance-api-comparativo-completo)** # Polygon (POL) em 2026: O Guia Completo (De MATIC para POL) URL: /blog/polygon-pol-matic-guia-completo-2026.mdx Tudo sobre a Polygon em 2026: A migração de MATIC para POL, a arquitetura AggLayer, Polygon CDK e o futuro das ZK-Rollups. Vale a pena investir? *** searchable: true title: 'Polygon (POL) em 2026: O Guia Completo (De MATIC para POL)' description: 'Tudo sobre a Polygon em 2026: A migração de MATIC para POL, a arquitetura AggLayer, Polygon CDK e o futuro das ZK-Rollups. Vale a pena investir?' date: '2026-01-01' keywords: 'polygon pol, matic para pol, polygon 2.0, agglayer, polygon cdk, zk-evm, comprar polygon brasil' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Criptomoedas' readingTime: '15 min' tags: \['Polygon', 'POL', 'Layer 2', 'Ethereum', 'ZK-Rollups', 'Web3'] relatedPosts: \['ethereum-eth-guia-completo-brasil-2026', 'rwa-real-world-assets-tokenizacao-guia-2026', 'defi-financas-descentralizadas-guia-iniciantes-2026'] featured: true expertise: 'Análise técnica da evolução da Polygon 2.0 e seu novo token POL' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; A **Polygon** sempre foi uma das soluções de escalabilidade mais populares do mercado cripto. Mas se você ficou fora do mercado por um tempo, pode estar confuso: **Onde está o MATIC? O que é POL? O que é AggLayer?** Em 2026, a Polygon não é mais apenas uma "sidechain" do Ethereum. Ela se transformou em uma rede de cadeias ZK (Zero-Knowledge) interconectadas, com um novo token nativo: o **POL**. Neste guia, explicamos a transformação da Polygon 2.0, por que grandes marcas (Starbucks, Nike, Reddit) continuam escolhendo a rede, e se o novo token POL tem potencial de investimento. *** ## De MATIC para POL: A Migração A mudança mais visível para os investidores foi a substituição do token **MATIC** pelo **POL**. ### Por que mudar? O MATIC era um token excelente para pagar taxas (gas) e segurança (staking) na rede Polygon PoS original. Porém, a visão da Polygon expandiu para uma "rede de redes". O **POL** é um token hiper-produtivo de "terceira geração" (depois de BTC e ETH). * **Segurança Compartilhada:** Validadores podem fazer staking de POL para validar **múltiplas cadeias** ao mesmo tempo (não apenas a PoS). * **Inflação Controlada:** Emissão anual para recompensar validadores e financiar o ecossistema (Community Treasury). * **Utility:** Usado para taxas, governança e recompensas em todo o ecossistema Polygon (CDK Chains). > **Para o investidor:** Se você tinha MATIC na rede Polygon, a conversão foi automática. Se tinha na rede Ethereum, precisou migrar via contrato inteligente. Em 2026, POL é o padrão. *** ## A Tecnologia: AggLayer e Polygon CDK Aqui está o "pulo do gato" da Polygon para 2026. Em vez de construir apenas uma blockchain rápida, eles construíram ferramentas para **qualquer um criar sua própria blockchain**, mas todas conectadas como se fossem uma só. ### 1. AggLayer (Aggregation Layer) O problema das Blockchains é a fragmentação. Liquidez no Ethereum não acessa liquidez na Solana facilmente. A **AggLayer** unifica a liquidez. Ela permite que cadeias conectadas compartilhem estado e liquidez instantaneamente e com segurança criptográfica (ZK proofs). * **Experiência do Usuário:** Você usa um dApp na "Chain A" e compra um NFT na "Chain B" com um único clique, sem saber que trocou de rede. Parece a internet normal. ### 2. Polygon CDK (Chain Development Kit) É um kit de desenvolvimento (como um WordPress para blockchains). Empresas podem lançar suas próprias cadeias "Layer 2" personalizadas no Ethereum, alimentadas pela tecnologia ZK da Polygon. * **Quem usa?** OKX (X1 Chain), Immutable (Gaming), Astar, Canto, Palm Network. Todas essas redes usam tecnologia Polygon e podem contribuir valor para o token POL. ### 3. ZK-EVM (Zero-Knowledge Ethereum Virtual Machine) A Polygon foi pioneira em lançar uma solução ZK totalmente compatível com o Ethereum. Isso oferece a segurança matemática das provas de conhecimento zero com a facilidade de desenvolvimento do Ethereum. *** ## O Ecossistema Polygon em 2026 A Polygon continua sendo a "Rei das Parcerias" no mundo corporativo (Web2 -> Web3). ### Grandes Marcas (Adorção Enterprise) Por ser barata, rápida e ecológica, a Polygon é a escolha padrão para programas de fidelidade e NFTs de massa. * **Nike (.SWOOSH):** Plataforma de colecionáveis digitais. * **Reddit Avatars:** Milhões de carteiras criadas por usuários comuns. * **Starbucks Odyssey:** Programa de fidelidade (encerrado/migrado, mas foi pioneiro). * **Lufthansa:** Uptrip app. ### DeFi e Gaming * **Polymarket:** O maior mercado de previsões do mundo (que explodiu nas eleições de 2024) roda na Polygon. * **Jogos:** Parceria com Immutable zkEVM traz centenas de jogos. * **DeFi:** Aave, Uniswap e Quickswap mantêm bilhões em liquidez na rede PoS e zkEVM. *** ## Polygon vs Concorrência (Layer 2 Wars) Em 2026, a briga das Layer 2 (L2) é intensa. | Característica | Polygon (AggLayer) | Optimism (Superchain) | Arbitrum (Orbit) | Base (Coinbase) | | -------------- | ------------------------------- | ------------------------------ | -------------------- | ----------------------- | | **Tecnologia** | ZK-Rollups (Mais rápido/seguro) | Optimistic (Mais barato hoje) | Optimistic | Optimistic | | **Visão** | Unificar liquidez (AggLayer) | Rede de L2s (OP Stack) | L3s personalizáveis | Onboarding via Exchange | | **Token** | **POL** (Staking, Validação) | **OP** (Governança) | **ARB** (Governança) | Sem token | | **Destaque** | Tecnologia ZK superior | Stack muito adotado (Base usa) | Líder em TVL DeFi | Integração Coinbase | **Vantagem da Polygon:** O token POL tem **utilidade real** de staking e segurança. Tokens como ARB e OP são puramente de governança (voto), o que muitas vezes frustra investidores que buscam captura de valor. *** ## Como Comprar e Usar Polygon no Brasil ### Comprando POL Você encontra o token POL (antigo MATIC) em todas as grandes corretoras brasileiras: * Mercado Bitcoin, Foxbit, NovaDAX, Binance. * **Par Padrão:** POL/BRL ou MATIC/BRL (algumas exchanges mantiveram o nome antigo no par por costume). ```typescript // Cotação do Polygon (POL/MATIC) em tempo real const response = await fetch('https://brapi.dev/api/v2/crypto?coin=MATIC¤cy=BRL') const { coins } = await response.json() // coins[0] contém: regularMarketPrice, regularMarketChangePercent, etc. ``` > **Nota:** A API pode listar como MATIC ou POL dependendo da atualização do ticker. ### Usando a Rede (Taxas Baratas) Para interagir com DeFi na Polygon: 1. Compre POL na exchange. 2. Saque via rede **Polygon (PoS)** para sua MetaMask/Rabby. 3. As taxas são pagas em POL e custam centavos (ex: R$ 0,05 por transação). *** ## Vale a Pena Investir em POL em 2026? ### Tese Altista (Bull Case) * **Tecnologia ZK Vence:** Se os ZK-Rollups provarem ser superiores aos Optimistic Rollups (como a teoria diz), a Polygon está melhor posicionada. * **AggLayer Funciona:** Se a AggLayer conseguir unificar a liquidez de centenas de cadeias, o POL será o ativo de segurança subjacente de um ecossistema gigante. * **Tokenomics:** O modelo do POL captura mais valor que os concorrentes L2. ### Tese Baixista (Bear Case) * **Concorrência OP Stack:** O "Superchain" da Optimism (usado pela Base da Coinbase) ganhou muita tração. Se desenvolvedores preferirem OP Stack, Polygon perde relevância. * **Fragmentação:** Ter "muitas cadeias" (PoS, zkEVM, CDK chains) pode confundir usuários e desenvolvedores. * **Preço do Token:** Historicamente, tokens L2 sofrem com desbloqueios e falta de "uso" direto para o preço subir, embora o POL tente resolver isso. *** ## Conclusão A Polygon em 2026 é uma aposta na **infraestrutura ZK** e na **interoperabilidade**. Deixou de ser apenas uma opção barata ao Ethereum para ser um hub tecnológico robusto. Para o investidor brasileiro, o POL oferece uma exposição a Layer 2 com um tokenomics mais sólido que a média do mercado, mas enfrenta concorrentes de peso como Solana (L1) e Base (L2). *** ## Recursos Adicionais * **[Ethereum e o Futuro das L2s](/blog/ethereum-eth-guia-completo-brasil-2026)** * **[RWA: A Próxima Fronteira](/blog/rwa-real-world-assets-tokenizacao-guia-2026)** * **[Carteiras para Guardar POL](/blog/carteiras-criptomoedas-guia-seguranca-2026)** *Disclaimer: Investir em criptoativos envolve alto risco. Este conteúdo é educacional.* # Preço Ajustado de Ações: Dividendos, Splits e Retorno na B3 URL: /blog/preco-ajustado-acoes-dividendos-splits-b3.mdx Entenda a diferença entre close e adjustedClose, evite contar dividendos duas vezes e trate splits, grupamentos e mudanças de ticker em séries da B3. *** searchable: true title: 'Preço Ajustado de Ações: Dividendos, Splits e Retorno na B3' description: 'Entenda a diferença entre close e adjustedClose, evite contar dividendos duas vezes e trate splits, grupamentos e mudanças de ticker em séries da B3.' date: '2026-07-17' keywords: 'preço ajustado ações, adjusted close b3, ajustar cotação dividendos python, split ações histórico, retorno total ações brasileiras' author: 'Alisson Leal' category: 'Educação e dados de mercado' subcategory: 'Séries históricas' readingTime: '8 min' tags: \['Preço Ajustado', 'Dividendos', 'Splits', 'B3', 'Python', 'Backtesting'] relatedPosts: \['dados-historicos-b3-python-pandas-api', 'eventos-corporativos-splits-grupamentos-subscricoes-bonificacoes', 'api-dividendos-acoes-fiis-brasil-como-consultar-2026'] featured: false expertise: 'Tratamento de séries temporais e eventos corporativos da B3' lastReviewed: '2026-07-17' -------------------------- import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; O preço de fechamento mostra quanto o ativo terminou valendo no pregão. O preço ajustado altera a série passada para tornar períodos separados por proventos ou eventos corporativos mais comparáveis. Na resposta histórica da brapi, os campos são `close` e `adjustedClose`: ```bash curl "https://brapi.dev/api/v2/stocks/historical?symbols=PETR4&range=1y&interval=1d&sortOrder=asc" ``` Escolher o campo errado pode criar um salto artificial ou contar um dividendo duas vezes. ## Close e adjustedClose Use `close` quando você precisa do preço observado na data. Exemplos: marcar uma ordem antiga, conferir uma nota ou reproduzir o valor exibido naquele pregão. Use `adjustedClose` quando você quer calcular uma série de retorno comparável e a metodologia do ajuste atende ao estudo. | Objetivo | Campo inicial | | ------------------------------------ | -------------------------------- | | Mostrar preço negociado no dia | `close` | | Gráfico histórico de preço observado | `close` | | Retorno entre períodos com eventos | `adjustedClose` | | Fluxo de caixa de dividendos | `close` mais eventos separados | | Auditoria de um provento | `close` e endpoint de dividendos | Se a série ajustada já incorpora o efeito dos proventos, adicionar os mesmos dividendos ao retorno pode inflar o resultado. Declare a metodologia usada e teste a série em datas com eventos conhecidos. ## Por que um dividendo mexe no preço Quando uma ação passa a negociar sem direito a um provento, o caixa que será distribuído deixa de fazer parte do valor econômico da empresa. O preço pode abrir mais baixo sem que isso represente uma perda equivalente para o acionista. O investidor ficou com dois componentes: * a ação negociada ex-dividendo; * o valor a receber na data de pagamento. Uma série de `close` mostra a queda no preço. Uma série ajustada procura manter a comparação entre o período anterior e o posterior ao evento. ## Splits e grupamentos Em um desdobramento, cada ação é dividida em várias. O preço unitário cai na mesma proporção, mas a quantidade do investidor aumenta. Em um grupamento, várias ações viram uma. O preço unitário sobe e a quantidade diminui. Sem ajuste, esses eventos parecem ganhos ou perdas enormes em um gráfico. Para entender subscrições, bonificações e outros eventos, consulte [eventos corporativos na B3](/blog/eventos-corporativos-splits-grupamentos-subscricoes-bonificacoes). ## Comparar as duas séries com Python ```python import os import requests import pandas as pd token = os.getenv("BRAPI_TOKEN") headers = {"Authorization": f"Bearer {token}"} if token else {} response = requests.get( "https://brapi.dev/api/v2/stocks/historical", params={ "symbols": "PETR4", "range": "5y", "interval": "1d", "sortOrder": "asc", }, headers=headers, timeout=30, ) response.raise_for_status() prices = response.json()["results"][0]["data"]["historicalDataPrice"] df = pd.DataFrame(prices) df["return_close"] = df["close"].pct_change() df["return_adjusted"] = df["adjustedClose"].pct_change() differences = df.loc[ (df["return_close"] - df["return_adjusted"]).abs() > 0.01, ["date", "close", "adjustedClose", "return_close", "return_adjusted"], ] print(differences.tail(20)) ``` O limite de 1% no exemplo serve apenas para encontrar datas que merecem investigação. Ele não prova que houve um evento corporativo. ## Conferir dividendos e JCP Para ações, consulte os eventos em uma rota separada: ```bash curl "https://brapi.dev/api/v2/stocks/dividends?symbols=PETR4&startDate=2024-01-01&sortOrder=asc" ``` A resposta separa dividendos em dinheiro, dividendos em ações e subscrições. Guarde pelo menos: * data de aprovação; * data com direito ao provento; * data de pagamento; * valor ou taxa do evento. FIIs usam `/api/v2/fii/dividends`, pois os rendimentos têm fonte e semântica próprias. ## Mudança de ticker Uma troca de código pode fragmentar a série se o sistema tratar o ticker novo como outro ativo. A API v2 resolve renomes conhecidos e devolve `requestedSymbol`, `symbol` e `changed`. Antes de classificar um ticker antigo como inexistente, use: ```bash curl "https://brapi.dev/api/v2/tickers/resolve?symbols=VVAR3" ``` Salve o ticker informado e o canônico. Isso ajuda a explicar por que uma carteira importada passou a usar outro símbolo. ## Checklist para backtesting Antes de confiar no retorno calculado: 1. escolha `close` ou `adjustedClose` de forma explícita; 2. confira datas com grandes diferenças entre as séries; 3. valide dividendos no endpoint de eventos; 4. resolva mudanças de ticker; 5. preserve campos nulos; 6. documente se o retorno inclui fluxo de caixa separado. O código para baixar e exportar a série está em [dados históricos da B3 com Python e pandas](/blog/dados-historicos-b3-python-pandas-api). # Preço Teto de Ação: Como Calcular com Bazin, Graham e Gordon URL: /blog/preco-teto-acao-como-calcular.mdx Aprenda a calcular preço teto de ação com dividendos, fórmula de Graham, modelo de Gordon e múltiplos. Veja fórmulas, exemplos e código com a brapi.dev. *** searchable: true title: 'Preço Teto de Ação: Como Calcular com Bazin, Graham e Gordon' description: 'Aprenda a calcular preço teto de ação com dividendos, fórmula de Graham, modelo de Gordon e múltiplos. Veja fórmulas, exemplos e código com a brapi.dev.' date: '2026-01-01' keywords: 'preço teto ação, preço justo ação, como calcular preço teto, método Bazin, fórmula Graham, modelo de Gordon, valuation ações, margem de segurança' author: 'Equipe brapi.dev' category: 'Análise Fundamentalista' subcategory: 'Valuation' readingTime: '13 min' tags: \['Preço Teto', 'Valuation', 'Análise Fundamentalista', 'Método Bazin', 'Graham'] relatedPosts: \['entendendo-indicador-preco-lucro-pl-analise-fundamentalista', 'roe-retorno-sobre-patrimonio-como-analisar', 'value-investing-como-encontrar-acoes-baratas', 'dividendos-como-construir-renda-passiva', 'margem-de-seguranca-benjamin-graham'] featured: true expertise: 'Especialistas em valuation e análise fundamentalista de ações brasileiras' lastReviewed: '2026-04-23' faqSchema: * question: 'O que é preço teto de uma ação?' answer: 'Preço teto é o preço máximo que um investidor aceita pagar por uma ação considerando retorno esperado, risco e margem de segurança. É uma estimativa, não uma garantia.' * question: 'Qual é o melhor método para calcular preço teto?' answer: 'Depende da empresa. Bazin e Gordon funcionam melhor para pagadoras de dividendos; Graham é mais útil para empresas de valor; múltiplos são bons para comparar empresas do mesmo setor.' * question: 'Preço atual abaixo do preço teto é compra automática?' answer: 'Não. Preço abaixo do modelo indica que vale investigar melhor. Antes de comprar, analise qualidade, dívida, governança, setor, ciclo econômico e risco de queda nos lucros.' *** import { Authors, Author } from '~/components/Authors'; Uma das perguntas mais importantes na análise fundamentalista é: **quanto posso pagar por essa ação sem depender de otimismo demais?** O preço teto tenta responder isso. Ele transforma lucro, dividendos, patrimônio e retorno exigido em uma referência de preço. Preço teto não é previsão. É uma régua. Ele ajuda a evitar compras por impulso e a exigir margem de segurança quando as premissas são incertas. ## Resumo Direto | Método | Melhor uso | Principal cuidado | | --------- | ---------------------------------------- | ---------------------------- | | Bazin | Ações pagadoras de dividendos | Dividendos podem cair | | Graham | Empresas de valor com lucro e patrimônio | Não funciona bem para growth | | Gordon | Dividendos crescentes e previsíveis | Muito sensível a premissas | | Múltiplos | Comparação setorial | Pode repetir erro do mercado | Use mais de um método. Se todos apontam para preço parecido, a análise fica mais robusta. Se cada método gera um valor muito diferente, o risco da estimativa é maior. ## O Que É Preço Teto Preço teto é o valor máximo que você aceitaria pagar para atingir um retorno mínimo desejado. A lógica é simples: ```text Preço atual abaixo do preço teto = vale investigar Preço atual acima do preço teto = margem de segurança baixa ``` Isso não significa compra ou venda automática. Uma ação pode estar barata porque o lucro vai cair, porque a governança piorou ou porque o setor está entrando em ciclo ruim. B[Lucro, dividendos e patrimônio] B --> C[Modelo de valuation] C --> D[Preço teto estimado] D --> E[Comparar com preço atual] E --> F[Analisar margem de segurança] `} /> ## Método Bazin: Preço Teto por Dividendos O método Bazin é popular no Brasil porque usa dividendos. A fórmula calcula qual preço entregaria um dividend yield mínimo. ```text Preço teto = Dividendo anual por ação / Yield mínimo desejado ``` Exemplo: ```text Dividendo anual: R$ 3,00 Yield mínimo desejado: 6% Preço teto = 3,00 / 0,06 = R$ 50,00 ``` Se a ação negocia a R$ 40, ela está abaixo do preço teto desse modelo. Se negocia a R$ 60, está acima. A conclusão correta é "investigar", não "comprar automaticamente". ### Quando Usar Bazin Bazin funciona melhor em empresas maduras, lucrativas e com histórico razoável de distribuição. Ele costuma fazer sentido em utilities, bancos, seguradoras e algumas empresas de infraestrutura. Evite usar Bazin sozinho quando o dividendo recente veio de evento extraordinário, venda de ativo, commodity em pico de ciclo ou payout insustentável. ## Fórmula de Graham A fórmula clássica de Graham cruza lucro por ação (LPA) e valor patrimonial por ação (VPA): ```text Preço justo Graham = √(22,5 × LPA × VPA) ``` O fator 22,5 vem da combinação de P/L máximo de 15 e P/VP máximo de 1,5, dentro da lógica conservadora de Benjamin Graham. Exemplo: ```text LPA = R$ 4,00 VPA = R$ 20,00 Preço justo = √(22,5 × 4 × 20) = R$ 42,43 ``` Graham é útil para empresas com lucro positivo e patrimônio relevante. Ele tende a subestimar empresas de crescimento, software, marcas fortes e negócios asset-light. ## Modelo de Gordon O modelo de Gordon, ou Dividend Discount Model, estima o valor presente de dividendos futuros que crescem a uma taxa constante. ```text Preço justo = D1 / (r - g) ``` Onde: | Variável | Significado | | -------- | ----------------------------------- | | D1 | Dividendo esperado no próximo ano | | r | Retorno exigido | | g | Crescimento esperado dos dividendos | Exemplo: ```text D1 = R$ 3,15 r = 12% g = 5% Preço justo = 3,15 / (0,12 - 0,05) = R$ 45,00 ``` O modelo só faz sentido quando `r` é maior que `g`. Pequenas mudanças nessas premissas alteram muito o resultado, então use Gordon com conservadorismo. ## Preço Teto por Múltiplos Outro caminho é definir múltiplos máximos aceitáveis para cada setor. ```text Preço teto por P/L = LPA × P/L máximo Preço teto por P/VP = VPA × P/VP máximo ``` Para bancos, P/VP costuma ser relevante. Para empresas cíclicas, P/L de um único ano pode enganar. Para utilities, múltiplos devem ser comparados com regulação, dívida e estabilidade de fluxo. | Tipo de empresa | Múltiplo útil | Cuidado | | --------------- | ---------------------- | -------------------------------- | | Bancos | P/VP e ROE | Qualidade da carteira de crédito | | Utilities | EV/EBITDA, DY e dívida | Revisão tarifária e CAPEX | | Commodities | EV/EBITDA normalizado | Ciclo de preço da commodity | | Varejo | P/L e margem | Juros, crédito e competição | ## Como Calcular com a brapi.dev Você pode consultar dados fundamentalistas e montar sua própria planilha ou script: ```typescript const response = await fetch( 'https://brapi.dev/api/quote/ITUB4?modules=defaultKeyStatistics,financialData÷nds=true', { headers: { Authorization: 'Bearer SEU_TOKEN' } }, ); const { results } = await response.json(); const acao = results[0]; const stats = acao.defaultKeyStatistics ?? {}; const preco = acao.regularMarketPrice; const lpa = acao.earningsPerShare ?? stats.earningsPerShare ?? stats.trailingEps; const vpa = stats.bookValue; const dividendYield = stats.dividendYield ?? 0; const graham = Math.sqrt(22.5 * lpa * vpa); const dividendoAnual = preco * dividendYield; const bazin = dividendoAnual / 0.06; console.log({ preco, graham, bazin }); ``` O ideal é salvar as premissas junto com o cálculo. Assim você consegue revisar depois se o erro veio do modelo, dos dados ou de uma hipótese otimista. ## Exemplo Comparativo Imagine uma empresa com os seguintes dados: | Dado | Valor | | --------------------- | ------- | | Preço atual | R$ 32 | | LPA | R$ 4 | | VPA | R$ 20 | | Dividendo anual | R$ 2,40 | | Yield mínimo desejado | 6% | | Método | Preço teto estimado | Leitura | | --------- | ------------------- | ---------------------------- | | Bazin | R$ 40,00 | Abaixo do teto de dividendos | | Graham | R$ 42,43 | Abaixo do valor pelo modelo | | P/L 10x | R$ 40,00 | Abaixo do múltiplo máximo | | P/VP 1,5x | R$ 30,00 | Acima do teto patrimonial | O resultado é misto. Três métodos sugerem margem, um método sugere cautela. Essa divergência pede análise qualitativa: crescimento, dívida, setor, governança e estabilidade dos lucros. ## Margem de Segurança Margem de segurança é a distância entre o preço teto estimado e o preço atual. ```text Margem = (Preço teto / Preço atual) - 1 ``` | Margem | Leitura prudente | | ------------ | ---------------------------------------- | | Acima de 30% | Boa folga, se as premissas forem sólidas | | 15% a 30% | Margem razoável | | 0% a 15% | Pouca folga para erro | | Abaixo de 0% | Preço acima do modelo | Quanto mais incerta a empresa, maior deve ser a margem exigida. Empresas cíclicas, alavancadas ou com governança fraca precisam de desconto maior. ## Qual Método Usar | Situação | Caminho recomendado | | ---------------------- | ----------------------------------------- | | Empresa de dividendos | Bazin + Gordon + payout | | Banco | P/VP + ROE + qualidade de crédito | | Empresa cíclica | Múltiplos normalizados | | Empresa de crescimento | DCF ou cenários, não Graham puro | | Utility regulada | Dividendos + dívida + retorno regulatório | O erro mais comum é escolher o método que dá o maior preço justo. Faça o contrário: comece pelo método mais conservador e só aumente a confiança se a análise qualitativa sustentar. ## Perguntas Frequentes ### Método Bazin ainda funciona? Funciona como filtro para empresas pagadoras de dividendos, mas não deve ser usado sozinho. Dividendos passados podem não se repetir. ### Fórmula de Graham serve para WEGE3 ou empresas de crescimento? Geralmente não. Empresas de crescimento costumam negociar com múltiplos maiores porque o mercado precifica expansão futura. Graham tende a ser conservador demais nesses casos. ### Preço teto muda com o tempo? Sim. Lucros, dividendos, dívida, juros, inflação e risco mudam. Recalcule sempre que houver resultado trimestral, evento relevante ou mudança estrutural na empresa. ## Conclusão Preço teto é uma ferramenta de disciplina. Ele não prevê o mercado, mas obriga você a explicitar premissas e comparar preço com valor. Use Bazin, Graham, Gordon e múltiplos como lentes diferentes, não como verdades absolutas. A [API brapi.dev](/docs) fornece dados de cotações, dividendos e indicadores para automatizar esse processo e revisar suas premissas com frequência. *Este artigo tem fins educacionais. Cálculos de preço teto são estimativas e não constituem recomendação de compra ou venda.* # Previdência Privada PGBL vs VGBL: Vale a Pena em 2026? Guia Completo URL: /blog/previdencia-privada-pgbl-vgbl-vale-a-pena-2026.mdx Entenda as diferenças entre PGBL e VGBL, tributação regressiva vs progressiva, quando vale a pena e as novas regras 2026/2026. Simulador e calculadora inclusos. *** searchable: true title: 'Previdência Privada PGBL vs VGBL: Vale a Pena em 2026? Guia Completo' description: 'Entenda as diferenças entre PGBL e VGBL, tributação regressiva vs progressiva, quando vale a pena e as novas regras 2026/2026. Simulador e calculadora inclusos.' date: '2026-01-01' keywords: 'previdencia privada, pgbl vs vgbl, previdencia privada vale a pena, vgbl ou pgbl, tributacao previdencia privada, tabela regressiva, tabela progressiva, aposentadoria, renda passiva, planejamento sucessorio, 2026' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Previdência' readingTime: '18 min' tags: \['Previdência Privada', 'PGBL', 'VGBL', 'Aposentadoria', 'Planejamento Financeiro', 'Tributação'] relatedPosts: \['carteira-previdenciaria-aposentadoria-2026', 'tesouro-direto-guia-completo-2026-como-investir', 'como-comecar-investir-do-zero-guia-iniciantes-2026', 'reserva-de-emergencia-guia-completo-2026', 'planejamento-financeiro-pessoal-guia-completo-2026'] featured: true expertise: 'Guia desenvolvido por especialistas em planejamento financeiro e previdenciário' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; A previdência privada é um dos produtos financeiros mais controversos do mercado brasileiro. Enquanto alguns especialistas a recomendam como peça fundamental do planejamento de aposentadoria, outros alertam para as **altas taxas** e **baixa rentabilidade** de muitos planos. Em 2026, com as novas regras tributárias e a diversificação de opções, entender quando a previdência privada vale a pena tornou-se ainda mais importante. Neste guia completo, você vai entender as diferenças entre **PGBL e VGBL**, como funciona a tributação, quando cada tipo é mais vantajoso, e como comparar com outras alternativas de investimento para aposentadoria. ## O Que é Previdência Privada? A previdência privada é um tipo de investimento de longo prazo voltado para a **acumulação de recursos** para aposentadoria ou outros objetivos futuros. Diferente da previdência pública (INSS), é oferecida por instituições financeiras privadas e possui características específicas de tributação e resgate. ### Características Principais | Característica | Descrição | | ----------------- | ------------------------------------------------- | | **Objetivo** | Acumulação de longo prazo para aposentadoria | | **Garantia** | Não possui cobertura do FGC | | **Tributação** | Regime especial (regressivo ou progressivo) | | **Portabilidade** | Pode transferir entre instituições sem tributação | | **Sucessão** | Não entra em inventário (vantagem sucessória) | | **Dedução IR** | Apenas no PGBL (até 12% da renda bruta) | ## PGBL vs VGBL: Qual a Diferença? A principal diferença entre PGBL e VGBL está na **tributação** e no **benefício fiscal**. ### PGBL (Plano Gerador de Benefício Livre) O PGBL permite **deduzir as contribuições** da base de cálculo do Imposto de Renda, desde que você: * Faça declaração completa do IR * Contribua para o INSS ou regime próprio * Respeite o limite de 12% da renda bruta tributável anual **Importante:** No resgate, o IR incide sobre o **valor total** (contribuições + rendimentos). ### VGBL (Vida Gerador de Benefício Livre) O VGBL **não permite dedução** das contribuições no IR, mas no resgate o imposto incide apenas sobre os **rendimentos**, não sobre o valor investido. É indicado para quem: * Faz declaração simplificada do IR * Já utiliza o limite de 12% do PGBL * Não é contribuinte do INSS ### Tabela Comparativa PGBL vs VGBL | Aspecto | PGBL | VGBL | | ------------------------- | ---------------------- | --------------------------------------- | | **Dedução no IR** | Até 12% da renda bruta | Não | | **Base do IR no resgate** | Valor total | Apenas rendimentos | | **Declaração IR** | Completa (obrigatório) | Simplificada ou completa | | **Contribuição INSS** | Obrigatória | Não obrigatória | | **Melhor para** | CLT com renda alta | Autônomos, profissionais liberais, MEIs | ## Tributação: Tabela Regressiva vs Progressiva Uma das decisões mais importantes ao contratar previdência privada é escolher o **regime de tributação**. ### Tabela Regressiva (Definitiva) A alíquota diminui conforme o tempo de permanência no plano: | Tempo de Acumulação | Alíquota IR | | ------------------- | ----------- | | Até 2 anos | 35% | | 2 a 4 anos | 30% | | 4 a 6 anos | 25% | | 6 a 8 anos | 20% | | 8 a 10 anos | 15% | | Acima de 10 anos | **10%** | **Vantagem:** Após 10 anos, a alíquota de 10% é a mais baixa do mercado para investimentos. **Desvantagem:** É definitiva - não pode ser alterada depois. ### Tabela Progressiva (Compensável) Segue a tabela do Imposto de Renda Pessoa Física: | Base de Cálculo Mensal (2026) | Alíquota | Parcela a Deduzir | | ----------------------------- | -------- | ----------------- | | Até R$ 2.259,20 | Isento | - | | R$ 2.259,21 a R$ 2.826,65 | 7,5% | R$ 169,44 | | R$ 2.826,66 a R$ 3.751,05 | 15% | R$ 381,44 | | R$ 3.751,06 a R$ 4.664,68 | 22,5% | R$ 662,77 | | Acima de R$ 4.664,68 | 27,5% | R$ 896,00 | **Vantagem:** Pode compensar na declaração anual se tiver outras deduções. **Desvantagem:** Alíquotas maiores para quem tem renda alta no resgate. ### Nova Regra 2026/2026: Escolha da Tributação no Resgate A partir de 2024, uma mudança importante foi implementada: **você pode escolher o regime de tributação no momento do resgate**, não mais na contratação. Isso oferece mais flexibilidade para planejar a estratégia fiscal ideal. ## Simulador: PGBL vs Tesouro Direto Vamos comparar a previdência privada com o Tesouro IPCA+ para entender quando cada opção é mais vantajosa: ```typescript // Selic + IPCA acumulado 12 meses em uma única chamada via /api/v2/macro const response = await fetch( 'https://brapi.dev/api/v2/macro/latest?symbols=selic,ipca12m', { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } }, ) const { results } = await response.json() const selic = results.find((r) => r.series.slug === 'selic')?.latest.value const ipca = results.find((r) => r.series.slug === 'ipca12m')?.latest.value ``` **Simulação: PGBL vs VGBL vs Tesouro IPCA+ (R$ 1.000/mês por 20 anos)** | Parâmetro | Valor | | ----------------- | ------------------- | | Aporte mensal | R$ 1.000 | | Período | 20 anos (240 meses) | | Renda bruta anual | R$ 120.000 | | Taxa Selic | 13,75% a.a. | | IPCA | 4,5% a.a. | **Comparativo de Resultados:** | Opção | Saldo Bruto | Alíquota IR | IR Devido | **Saldo Líquido** | Retorno | | ----------------- | ----------- | ----------- | --------- | ----------------- | ------- | | **PGBL** | R$ 892.450 | 10% | R$ 89.245 | **R$ 803.205** | +234% | | **VGBL** | R$ 748.320 | 10% | R$ 50.832 | **R$ 697.488** | +190% | | **Tesouro IPCA+** | R$ 782.150 | 15% | R$ 69.323 | **R$ 712.827** | +197% | > **Vencedor:** PGBL para quem declara IR completo e tem renda alta. A economia fiscal de \~R$ 33.000/ano reinvestida faz diferença significativa no longo prazo. **Tabela Regressiva de IR (Previdência):** | Prazo | Alíquota | | -------------------- | -------- | | Até 2 anos | 35% | | 2-4 anos | 30% | | 4-6 anos | 25% | | 6-8 anos | 20% | | 8-10 anos | 15% | | **Acima de 10 anos** | **10%** | ## Quando a Previdência Privada Vale a Pena? ### Cenários Favoráveis ao PGBL 1. **Alta renda tributável**: Se você está na alíquota de 27,5% do IR, a economia fiscal é significativa 2. **Declaração completa**: Obrigatório para aproveitar o benefício 3. **Horizonte longo**: Mínimo 10 anos para alcançar alíquota de 10% 4. **Plano com taxas baixas**: Taxa de administração abaixo de 1% a.a. 5. **Planejamento sucessório**: Não entra em inventário ### Cenários Favoráveis ao VGBL 1. **Declaração simplificada**: Não aproveita dedução do PGBL 2. **Já usa limite do PGBL**: Complementar com VGBL 3. **Planejamento sucessório**: Mesmo benefício do PGBL 4. **Autônomos sem INSS**: Não precisa contribuir para regime público ### Quando NÃO Vale a Pena | Situação | Por quê evitar | | --------------------------- | ------------------------------------------------ | | **Taxas altas** | Taxa de administração > 1,5% a.a. corrói retorno | | **Prazo curto** | Menos de 10 anos = alíquotas altas (até 35%) | | **Renda baixa** | Pouco benefício fiscal no PGBL | | **Fundos ruins** | Muitos planos rendem menos que Tesouro Selic | | **Necessidade de liquidez** | Resgate antecipado tem penalidades | ## Taxas: O Que Observar ### Taxa de Administração É a principal taxa e a mais impactante no longo prazo: | Faixa | Classificação | Impacto em 20 anos\* | | ------------------ | ------------- | -------------------- | | Até 0,5% a.a. | Excelente | -R$ 15.000 | | 0,5% a 1,0% a.a. | Boa | -R$ 35.000 | | 1,0% a 1,5% a.a. | Aceitável | -R$ 55.000 | | 1,5% a 2,0% a.a. | Ruim | -R$ 80.000 | | Acima de 2,0% a.a. | Péssima | -R$ 110.000+ | \*Considerando aporte de R$ 1.000/mês ### Taxa de Carregamento Cobrada na entrada (cada aporte) ou saída (resgate): * **Entrada**: Evite planos com carregamento > 0% * **Saída**: Geralmente decresce com o tempo ### Taxa de Performance Alguns planos cobram sobre rentabilidade acima de benchmark. Verifique se é justa. ## Calculadora: Economia Fiscal do PGBL **Economia Fiscal do PGBL:** | Renda Anual | Aporte Anual | Limite 12% | Economia IR | Retorno Imediato | | ----------- | ------------ | ---------- | ----------- | ---------------- | | R$ 60.000 | R$ 7.200 | R$ 7.200 | R$ 1.980 | 27,5% | | R$ 120.000 | R$ 14.400 | R$ 14.400 | R$ 3.960 | 27,5% | | R$ 200.000 | R$ 24.000 | R$ 24.000 | R$ 6.600 | 27,5% | | R$ 120.000 | R$ 20.000 | R$ 14.400 | R$ 3.960 | 19,8%\* | > \*Aporte de R$ 20.000 excede o limite de 12% (R$ 14.400). Apenas R$ 14.400 é dedutível, os R$ 5.600 excedentes não geram benefício fiscal. **Fórmula:** * **Limite de dedução:** Renda Bruta × 12% * **Economia IR:** min(Aporte, Limite) × 27,5% * **Retorno imediato:** Economia IR ÷ Aporte ## Vantagens da Previdência Privada ### 1. Benefício Fiscal (PGBL) A dedução de até 12% da renda bruta gera economia imediata de até 27,5% sobre esse valor. **Exemplo prático:** * Renda anual: R$ 150.000 * Limite dedução: R$ 18.000 (12%) * Economia IR: R$ 4.950 (27,5%) * Retorno imediato: **27,5%** ### 2. Tributação Regressiva Após 10 anos, pagar apenas 10% de IR é a menor alíquota do mercado financeiro brasileiro. ### 3. Planejamento Sucessório * Não entra em inventário * Beneficiários recebem rapidamente * Economia com custos de inventário (pode chegar a 10% do patrimônio) ### 4. Portabilidade Pode transferir entre instituições sem pagar IR, buscando: * Melhores taxas * Melhores fundos * Melhor atendimento ### 5. Ausência de Come-Cotas Diferente dos fundos de investimento tradicionais, a previdência não sofre antecipação de IR semestral. ## Desvantagens da Previdência Privada ### 1. Ausência de Garantia (FGC) Previdência privada NÃO tem cobertura do Fundo Garantidor de Créditos. Em caso de falência da instituição, o investidor pode perder o capital. ### 2. Taxas Elevadas Muitos planos antigos têm taxas de administração superiores a 2% a.a., corroendo significativamente o retorno. ### 3. Rentabilidade Medíocre Muitos fundos de previdência rendem menos que a Selic, especialmente os mais conservadores de grandes bancos. ### 4. Baixa Liquidez Resgates podem demorar até 60 dias para serem processados, dependendo do plano. ### 5. Tributação Alta no Curto Prazo Se resgatar antes de 10 anos, as alíquotas são muito superiores às de outros investimentos de renda fixa. ## Comparativo: Previdência vs Alternativas **Comparativo: R$ 1.000/mês por 20 anos** | Opção | Taxa Bruta | Taxa Adm | IR Final | Base IR | Saldo Líquido | | ------------------- | ---------- | -------- | -------- | ----------- | ------------- | | **PGBL** | 10% a.a. | 0,8% | 10% | Total | R$ 697.500 | | **Tesouro IPCA+** | 10,5% a.a. | 0,25% | 15% | Rendimentos | R$ 712.800 | | **ETF BOVA11** | 12% a.a. | 0,30% | 15% | Rendimentos | R$ 842.300 | | **FIIs (carteira)** | 10% a.a. | 0% | 0%\* | - | R$ 765.400 | > \*Dividendos de FIIs são isentos para pessoa física. **Ranking por Saldo Líquido:** 1. 🥇 **ETF BOVA11** - R$ 842.300 (+251%) 2. 🥈 **FIIs** - R$ 765.400 (+219%) 3. 🥉 **Tesouro IPCA+** - R$ 712.800 (+197%) 4. **PGBL** - R$ 697.500 (+190%) > **Nota:** O PGBL sobe no ranking quando consideramos a economia fiscal reinvestida (para renda alta) e o planejamento sucessório (não entra em inventário). ## Melhores Planos de Previdência 2026 ### Critérios de Avaliação | Critério | Peso | O que avaliar | | --------------------------- | ---- | ---------------------------- | | Taxa de administração | 40% | Quanto menor, melhor | | Rentabilidade histórica | 25% | Comparar com benchmark | | Diversificação | 15% | Opções de fundos disponíveis | | Solidez da instituição | 10% | Rating e tempo de mercado | | Atendimento e portabilidade | 10% | Facilidade de gestão | ### Planos Recomendados por Perfil **Conservador (Renda Fixa):** * Taxa máxima: 0,5% a.a. * Benchmark: CDI ou IMA-B * Composição: Tesouro Selic, IPCA+, crédito privado AAA **Moderado (Balanceado):** * Taxa máxima: 0,8% a.a. * Composição: 70% RF + 30% RV * Benchmark: CDI + 2% a.a. **Arrojado (Renda Variável):** * Taxa máxima: 1,0% a.a. * Composição: até 70% RV * Benchmark: IPCA + 6% a.a. ## Checklist: Antes de Contratar ### Análise Pessoal * [ ] Qual sua faixa de tributação do IR? * [ ] Você faz declaração completa ou simplificada? * [ ] Contribui para INSS ou regime próprio? * [ ] Qual seu horizonte de investimento? * [ ] Precisa de liquidez no médio prazo? * [ ] Tem interesse em planejamento sucessório? ### Análise do Plano * [ ] Taxa de administração é inferior a 1% a.a.? * [ ] Taxa de carregamento é zero? * [ ] Histórico de rentabilidade é consistente? * [ ] Há opções de fundos diversificados? * [ ] Portabilidade é facilitada? * [ ] Instituição é sólida e bem avaliada? ### Comparação com Alternativas * [ ] Simulou com Tesouro Direto? * [ ] Considerou ETFs e ações? * [ ] Avaliou FIIs para renda passiva? * [ ] Calculou impacto das taxas no longo prazo? ## Perguntas Frequentes (FAQ) ### Posso ter PGBL e VGBL ao mesmo tempo? Sim! É comum usar o PGBL até o limite de 12% da renda bruta e complementar com VGBL para valores adicionais. ### O que acontece se eu precisar resgatar antes de 10 anos? Você pagará IR conforme a tabela regressiva. Se resgatar em 5 anos, por exemplo, a alíquota será de 25% sobre o valor (PGBL) ou rendimentos (VGBL). ### Posso fazer portabilidade para outro banco? Sim, a portabilidade é gratuita e não gera tributação. Você pode transferir para qualquer instituição que ofereça previdência privada. ### Previdência privada entra em inventário? Não. Essa é uma das principais vantagens para planejamento sucessório. Os beneficiários indicados recebem diretamente, sem necessidade de inventário. ### Qual a diferença entre previdência aberta e fechada? * **Aberta**: Qualquer pessoa pode contratar (bancos e seguradoras) * **Fechada**: Restrita a funcionários de empresas ou associações (fundos de pensão) ### Vale a pena resgatar previdência antiga com taxas altas? Depende do tempo de contribuição. Se já está há mais de 10 anos, pode ser melhor fazer portabilidade para um plano com taxas menores do que resgatar e pagar IR. ## Conclusão A previdência privada pode ser uma excelente ferramenta de planejamento financeiro **quando usada corretamente**: **PGBL vale a pena quando:** * Você está na alíquota de 22,5% ou 27,5% do IR * Faz declaração completa * Tem horizonte superior a 10 anos * Encontra plano com taxa inferior a 1% a.a. **VGBL vale a pena quando:** * Já usa o limite de 12% do PGBL * Faz declaração simplificada * Busca planejamento sucessório * Não contribui para INSS **Evite previdência quando:** * Taxas são superiores a 1,5% a.a. * Horizonte é inferior a 10 anos * Precisa de liquidez * Encontra alternativas melhores Para tomar a melhor decisão, use os simuladores apresentados neste artigo e compare com outras opções como Tesouro Direto, ETFs e FIIs. A [API da brapi.dev](https://brapi.dev) oferece dados em tempo real da Selic e IPCA para suas simulações personalizadas. *** *Disclaimer: Este conteúdo é educacional e não constitui recomendação de investimento. Consulte um profissional antes de tomar decisões financeiras.* # Psicologia do Investidor: 7 Vieses Cognitivos que Te Fazem Perder Dinheiro URL: /blog/psicologia-investidor-vieses-cognitivos-2026.mdx Descubra como sua mente te sabota nos investimentos. Aprenda a evitar o Efeito Manada, Aversão à Perda, Viés de Confirmação e outros gatilhos mentais em 2026. *** searchable: true title: 'Psicologia do Investidor: 7 Vieses Cognitivos que Te Fazem Perder Dinheiro' description: 'Descubra como sua mente te sabota nos investimentos. Aprenda a evitar o Efeito Manada, Aversão à Perda, Viés de Confirmação e outros gatilhos mentais em 2026.' date: '2025-12-28' keywords: 'psicologia financeira, vieses cognitivos investimentos, aversão a perda, efeito manada bolsa, finanças comportamentais, mindset investidor' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Psicologia' readingTime: '14 min' tags: \['Psicologia Financeira', 'Finanças Comportamentais', 'Mindset', 'Estratégia'] relatedPosts: \['onde-investir-2026-guia-completo-melhores-investimentos', 'renda-fixa-vs-renda-variavel-2026'] featured: false expertise: 'Baseado em estudos de Finanças Comportamentais (Kahneman & Tversky)' lastReviewed: '2026-01-28' -------------------------- import { Authors, Author } from '~/components/Authors'; Você já vendeu uma ação no fundo porque "tudo estava caindo" e se arrependeu depois? Ou comprou algo só porque "todo mundo estava ganhando dinheiro"? Não se culpe. Seu cérebro foi programado para sobreviver na savana, não para operar na Bolsa de Valores. Esses erros sistemáticos de julgamento são chamados de **Vieses Cognitivos**. Em 2026, com o excesso de informação e notificações, controlar a mente é mais importante que controlar a planilha. Conheça os 7 inimigos invisíveis do seu patrimônio. *** ## 1. Aversão à Perda (Loss Aversion) **O que é:** A dor de perder R$ 1.000 é duas vezes maior do que a alegria de ganhar R$ 1.000. **Como te sabota:** Você segura uma ação ruim que caiu 50% ("só perco se vender") esperando ela empatar, mas vende uma ação boa que subiu 10% rápido demais para "garantir o lucro". **Antídoto:** Defina Stop Loss e objetivos de saída *antes* de entrar na operação. ## 2. Efeito Manada (Herd Behavior) **O que é:** Fazer o que a maioria está fazendo para se sentir seguro. **Como te sabota:** Comprar Bitcoin no topo histórico porque "o vizinho comprou" ou vender tudo no pânico de uma crise. O mercado financeiro é contraintuitivo: a manada geralmente chega atrasada. **Antídoto:** Tenha uma estratégia própria. Se todos estão eufóricos, tenha cautela (Warren Buffett). ## 3. Viés de Confirmação (Confirmation Bias) **O que é:** Buscar apenas informações que confirmam o que você já acredita. **Como te sabota:** Você ama a empresa X. Você só lê notícias boas sobre ela e ignora os analistas que apontam riscos de falência. **Antídoto:** Ativamente procure a opinião contrária. Pergunte: "Por que eu posso estar errado?". ## 4. Ancoragem (Anchoring) **O que é:** Ficar preso a um número inicial irrelevante. **Como te sabota:** "Essa ação custava R$ 50, agora custa R$ 30. Está barata!". Não necessariamente. Se os fundamentos pioraram, R$ 30 pode ser caro. O preço passado (âncora) não dita o valor futuro. **Antídoto:** Avalie o negócio hoje (Valuation), esqueça o preço de tela de ontem. ## 5. Falácia do Custo Irrecuperável (Sunk Cost) **O que é:** Continuar investindo em algo ruim só porque já gastou muito tempo/dinheiro nele. **Como te sabota:** "Já perdi 80%, não vale a pena vender agora". Vale sim, se você pegar o restante e colocar em algo que vai render. O dinheiro perdido, perdido está. **Antídoto:** Zere a posição mentalmente. "Se eu tivesse esse dinheiro em caixa hoje, compraria essa mesma ação?". Se a resposta for não, venda. ## 6. Viés de Recência (Recency Bias) **O que é:** Achar que o que aconteceu recentemente vai continuar acontecendo para sempre. **Como te sabota:** A bolsa subiu 2 anos seguidos -> "Vai subir para sempre". A renda fixa pagou 14% -> "Nunca mais vou para a bolsa". O mercado é cíclico; a recência nos cega para a mudança de ciclo. **Antídoto:** Olhe gráficos de longo prazo (10, 20 anos) para ver os ciclos completos. ## 7. Excesso de Confiança (Overconfidence) **O que é:** Achar que você sabe mais que o mercado. **Como te sabota:** Girar a carteira demais (Day Trade) achando que consegue prever topos e fundos. Estudos mostram que investidores que operam muito têm retornos menores que os passivos. **Antídoto:** Humildade. A maioria dos gestores profissionais não bate o índice. O simples (feijão com arroz) funciona. *** ## Conclusão Investir é 20% técnica e 80% comportamento. Conhecer esses vieses não te torna imune, mas te dá um "alerta" quando seu cérebro está prestes a cometer um erro caro. Em 2026, respire fundo antes de clicar em "Comprar" ou "Vender". Pergunte-se: "É análise racional ou é viés?". # Rebalanceamento de Carteira: Como e Quando Fazer em 2026 URL: /blog/rebalanceamento-carteira-como-quando-fazer-2026.mdx Aprenda a rebalancear sua carteira de investimentos. Entenda as estratégias, frequência ideal e veja exemplos práticos com calculadora. *** searchable: true title: 'Rebalanceamento de Carteira: Como e Quando Fazer em 2026' description: 'Aprenda a rebalancear sua carteira de investimentos. Entenda as estratégias, frequência ideal e veja exemplos práticos com calculadora.' date: '2026-01-01' keywords: 'rebalanceamento de carteira, como rebalancear investimentos, quando rebalancear carteira, rebalanceamento automático, ajuste de portfólio, 2026' author: 'Equipe brapi.dev' category: 'Estratégias' subcategory: 'Gestão' readingTime: '14 min' tags: \['Rebalanceamento', 'Carteira', 'Estratégias', 'Gestão de Portfólio'] relatedPosts: \['alocacao-de-ativos-por-idade-carteira-ideal-2026', 'carteira-de-acoes-como-montar-diversificar', 'dollar-cost-averaging-estrategia-aporte-mensal', 'guia-bogleheads-brasil-investimento-passivo-etfs', 'planejamento-financeiro-pessoal-guia-completo-2026'] featured: false expertise: 'Guia baseado em práticas de gestão de portfólio e teoria moderna de investimentos' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; Você definiu sua alocação ideal: 60% renda variável, 40% renda fixa. Passou um ano, o mercado subiu, e agora sua carteira está 75% em renda variável. O que fazer? A resposta é **rebalancear** - uma prática simples que a maioria dos investidores ignora, mas que pode fazer grande diferença nos resultados de longo prazo. Neste guia, você vai aprender exatamente o que é rebalanceamento, quando fazer, e como executar na prática. *** ## O Que É Rebalanceamento de Carteira? **Rebalanceamento** é o processo de ajustar sua carteira de volta à alocação original definida na sua estratégia. ### Por Que a Carteira "Desbalanceia"? Os ativos variam em ritmos diferentes. Se ações sobem mais que renda fixa, a proporção muda: | Momento | Ações | Renda Fixa | Total | | -------------- | --------------- | --------------- | ---------- | | **Início** | R$ 60.000 (60%) | R$ 40.000 (40%) | R$ 100.000 | | **Após 1 ano** | R$ 84.000 (68%) | R$ 44.000 (32%) | R$ 128.000 | Sem rebalancear, você está assumindo mais risco do que planejou. ### O Que o Rebalanceamento Faz? Vender parte do que subiu (ações) e comprar o que ficou para trás (renda fixa): | Ação | Antes | Depois | | ------------- | --------- | ------------- | | Vender ações | R$ 84.000 | R$ 76.800 | | Comprar RF | R$ 44.000 | R$ 51.200 | | **Proporção** | 68%/32% | **60%/40%** ✓ | *** ## Por Que Rebalancear? ### 1. Controle de Risco A razão mais importante. Sem rebalancear, sua carteira pode ficar muito mais arriscada do que você planejou. **Exemplo real**: Quem não rebalanceou em 2007 tinha carteira muito pesada em ações quando veio a crise de 2008. ### 2. "Comprar Barato, Vender Caro" Automático Rebalancear força você a vender o que subiu e comprar o que caiu - exatamente o que todo investidor deveria fazer, mas poucos conseguem emocionalmente. ### 3. Disciplina Remove a emoção da decisão. Você segue regras, não manchetes. ### 4. Mantém a Estratégia Intacta Sua alocação foi definida por uma razão. Rebalancear mantém essa lógica funcionando. *** ## Estratégias de Rebalanceamento ### 1. Rebalanceamento por Tempo (Calendar Rebalancing) Rebalancear em datas fixas, independentemente do mercado. | Frequência | Prós | Contras | | ---------- | --------------------------- | ----------------------------- | | Mensal | Mantém alocação precisa | Custos de transação altos | | Trimestral | Equilíbrio custo/precisão | Pode ser excessivo | | Semestral | Boa frequência para maioria | - | | Anual | Menor custo | Pode permitir desvios grandes | **Recomendação**: Para a maioria, **semestral ou anual** é suficiente. ### 2. Rebalanceamento por Bandas (Threshold Rebalancing) Rebalancear quando o desvio da alocação alvo ultrapassar um limite. ``` Se desvio > X%, então rebalancear ``` **Bandas comuns:** | Banda | Quando usar | | ----- | ------------------------------ | | ±3% | Muito conservador, mais custos | | ±5% | Equilíbrio (mais comum) | | ±10% | Menos custo, mais risco | **Exemplo com banda de 5%:** * Alvo: 60% ações * Banda: 55% a 65% * Se ações passarem de 65% ou caírem abaixo de 55% → rebalancear ### 3. Rebalanceamento com Aportes Em vez de vender/comprar, usar os aportes mensais para corrigir a alocação. **Vantagens:** * Sem custos de venda * Sem imposto sobre ganho de capital * Mantém crescimento do patrimônio **Como funciona:** **Exemplo de aporte direcionado para rebalanceamento:** | Situação Atual | Valor | % Atual | % Alvo | Aporte Sugerido | | -------------- | --------- | ------- | ------ | --------------- | | Ações | R$ 65.000 | 57% | 50% | R$ 0 | | FIIs | R$ 15.000 | 13% | 20% | R$ 2.000 | | Renda Fixa | R$ 35.000 | 30% | 30% | R$ 0 | > Com um aporte de R$ 2.000, direcionar 100% para FIIs para aproximar da alocação alvo. ### 4. Híbrido: Tempo + Bandas A estratégia mais completa: * Verificar mensalmente * Rebalancear apenas se desvio > 5% * Rebalanceamento forçado anual (mesmo sem desvio grande) *** ## Calculadora de Rebalanceamento ```typescript // Buscar cotações atuais para calcular valores const response = await fetch( 'https://brapi.dev/api/quote/BOVA11,PETR4,XPLG11,HGLG11', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const { results } = await response.json() // results[]: symbol, regularMarketPrice ``` **Exemplo de análise de rebalanceamento (Patrimônio: R$ 120.000):** | Classe | Valor Atual | % Atual | % Alvo | Desvio | Status | | ------ | ----------- | ------- | ------ | ------ | ------- | | Ações | R$ 55.000 | 45,8% | 40% | +5,8% | Ajustar | | FIIs | R$ 25.000 | 20,8% | 20% | +0,8% | OK | | RF | R$ 40.000 | 33,4% | 40% | -6,6% | Ajustar | **Ações de rebalanceamento:** * Ações: Não aportar (acima do alvo) * RF: Comprar R$ 8.000 (para atingir 40%) *** ## Quando NÃO Rebalancear Rebalancear nem sempre é a melhor opção: ### 1. Custos Superam Benefícios Se os custos de transação (corretagem, spread) forem maiores que o benefício do rebalanceamento. **Regra prática**: Só rebalancear se o ajuste for > R$ 1.000 por classe. ### 2. Implicações Fiscais Vender ativos com lucro gera imposto: * Ações: 15% sobre lucro (se vendas > R$ 20.000/mês) * FIIs: 20% sobre lucro (sem isenção) **Solução**: Preferir rebalancear com aportes ou usar vendas dentro da isenção. ### 3. Mercado em Crise Extrema Durante crashes extremos, rebalancear pode significar comprar ativos em queda livre. Use seu julgamento. ### 4. Desvio Pequeno Se o desvio é 2% e sua banda é 5%, não há necessidade de agir. *** ## Rebalanceamento na Prática: Passo a Passo ### Passo 1: Definir Alocação Alvo ``` Exemplo: - Ações Brasil: 30% - FIIs: 20% - Internacional: 10% - Renda Fixa: 40% ``` ### Passo 2: Definir Bandas ``` Banda: ±5% Ações Brasil: 25% a 35% FIIs: 15% a 25% Internacional: 5% a 15% Renda Fixa: 35% a 45% ``` ### Passo 3: Definir Frequência de Verificação ``` Verificar: Mensalmente (todo dia 1º) Rebalancear: Apenas se fora da banda Forçar: Anualmente (todo janeiro) ``` ### Passo 4: Executar **Exemplo de instruções de rebalanceamento (Patrimônio: R$ 100.000):** | Classe | Atual | % Atual | % Alvo | Ação | | ------------- | --------- | ------- | ------ | -------------------------------- | | Ações Brasil | R$ 45.000 | 45% | 30% | Não aportar (excesso: R$ 15.000) | | FIIs | R$ 18.000 | 18% | 20% | Comprar R$ 2.000 | | Internacional | R$ 7.000 | 7% | 10% | Comprar R$ 3.000 | | RF | R$ 30.000 | 30% | 40% | Comprar R$ 10.000 | **Sugestões por classe:** * **Ações Brasil**: Não aportar até normalizar * **FIIs**: IFIX11 ou FIIs defasados * **Internacional**: IVVB11 ou ETFs internacionais * **RF**: Tesouro Selic ou CDB liquidez diária *** ## Estratégias Avançadas ### Rebalanceamento por Cotas (Tax-Loss Harvesting) Vender ativos com prejuízo para compensar ganhos futuros: 1. Identificar ativos com prejuízo 2. Vender e registrar o prejuízo 3. Comprar ativo similar (não idêntico) 4. Usar prejuízo para compensar ganhos futuros ### Rebalanceamento Parcial Em vez de voltar exatamente ao alvo, voltar apenas até a borda da banda: ``` Alvo: 60% Banda: 55-65% Atual: 70% Rebalanceamento total: Voltar para 60% Rebalanceamento parcial: Voltar para 65% ``` Reduz custos de transação. ### Rebalanceamento por Camadas Diferentes regras para diferentes classes: ``` Ações: Banda de 7% (mais volátil, tolerar mais) FIIs: Banda de 5% RF: Banda de 3% (menos volátil) ``` *** ## Acompanhamento com brapi.dev Monitore sua carteira e identifique necessidade de rebalanceamento: ```typescript // Buscar cotações dos ativos de renda variável const response = await fetch( 'https://brapi.dev/api/quote/BOVA11,IVVB11,XPLG11', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const { results } = await response.json() // results[]: symbol, regularMarketPrice, regularMarketChangePercent ``` **Exemplo de monitoramento de carteira:** | Ativo | Preço | Variação | Valor | | ------------- | --------- | -------- | ------------- | | BOVA11 | R$ 125,00 | +1,2% | R$ 10.000 | | IVVB11 | R$ 280,00 | -0,5% | R$ 11.200 | | XPLG11 | R$ 105,00 | +0,8% | R$ 10.500 | | Tesouro Selic | - | - | R$ 25.000 | | **Total** | | | **R$ 56.700** | **Análise por classe (Banda: ±5%):** | Classe | Valor | Atual | Alvo | Status | | ------------- | --------- | ----- | ---- | -------- | | Ações | R$ 10.000 | 17,6% | 35% | Aumentar | | Internacional | R$ 11.200 | 19,8% | 15% | Reduzir | | FIIs | R$ 10.500 | 18,5% | 20% | OK | | RF | R$ 25.000 | 44,1% | 30% | Reduzir | *** ## Erros Comuns no Rebalanceamento ### ❌ Erro 1: Rebalancear Demais Rebalancear toda semana gera custos desnecessários e pode até prejudicar retornos. ### ❌ Erro 2: Nunca Rebalancear O oposto também é ruim. Sua carteira pode ficar completamente diferente do planejado. ### ❌ Erro 3: Ignorar Custos Fiscais Vender com lucro gera imposto. Considere isso antes de rebalancear vendendo. ### ❌ Erro 4: Rebalancear com Base em Emoção "O mercado caiu, vou vender tudo!" - isso não é rebalanceamento, é pânico. ### ❌ Erro 5: Não Ter Alocação Definida Sem saber sua alocação alvo, não tem como rebalancear. *** ## Checklist de Rebalanceamento ### Configuração Inicial * [ ] Defini minha alocação alvo por classe * [ ] Estabeleci bandas de tolerância (±5% recomendado) * [ ] Defini frequência de verificação (mensal) * [ ] Configurei alertas/lembretes ### Verificação Periódica * [ ] Calculei valor atual de cada classe * [ ] Comparei com alocação alvo * [ ] Verifiquei se está dentro das bandas * [ ] Decidi se precisa rebalancear ### Execução * [ ] Avaliei custos de transação * [ ] Considerei implicações fiscais * [ ] Decidi método (vender/comprar ou aportes) * [ ] Executei as operações * [ ] Registrei o rebalanceamento *** ## Conclusão O rebalanceamento é uma das práticas mais simples e efetivas para investidores de longo prazo. Ele mantém seu risco controlado e força você a comprar barato e vender caro. **Resumo:** 1. **Defina sua alocação** e bandas de tolerância 2. **Verifique mensalmente** se está dentro das bandas 3. **Rebalanceie quando necessário** (preferência: com aportes) 4. **Considere custos** antes de vender 5. **Siga o plano**, não as emoções Lembre-se: consistência é mais importante que perfeição. Rebalancear uma vez por ano é infinitamente melhor que nunca rebalancear. *** ## Próximos Passos Continue aprendendo sobre gestão de carteira: * [Alocação de Ativos por Idade](/blog/alocacao-de-ativos-por-idade-carteira-ideal-2026) * [Carteira de Ações: Como Montar e Diversificar](/blog/carteira-de-acoes-como-montar-diversificar) * [Dollar Cost Averaging: Estratégia de Aportes](/blog/dollar-cost-averaging-estrategia-aporte-mensal) * [Guia Bogleheads Brasil](/blog/guia-bogleheads-brasil-investimento-passivo-etfs) *** ## Perguntas Frequentes ### Qual a melhor frequência para rebalancear? Para a maioria dos investidores, verificar mensalmente e rebalancear apenas quando ultrapassar a banda de 5% é ideal. Forçar um rebalanceamento anual garante que a carteira não desvia muito. ### Devo vender ou apenas direcionar aportes? Prefira direcionar aportes sempre que possível. Evita custos de venda e impostos. Só venda se a carteira estiver muito desbalanceada e os aportes não forem suficientes. ### Rebalancear durante uma crise é uma boa ideia? Sim, desde que você siga sua estratégia. Rebalancear em crises significa comprar ativos em baixa - exatamente o que deveria fazer. O difícil é ter disciplina emocional. ### Preciso rebalancear ações individuais ou só classes? Foque primeiro em rebalancear classes (ações, FIIs, RF). Rebalancear dentro de uma classe (entre ações individuais) é secundário e mais complexo. ### E se minha alocação alvo mudar? Sua alocação deve mudar gradualmente com a idade. Quando ajustar o alvo, aproveite o próximo rebalanceamento para fazer a transição suavemente. # Relatórios CVM de FIIs: Como Analisar Composição Patrimonial via API (2026) URL: /blog/relatorios-cvm-fii-composicao-patrimonial-vacancia-api.mdx Aprenda a extrair e analisar relatórios gerenciais mensais de FIIs enviados à CVM via API. CRI, LCI, imóveis, taxas, rentabilidade e passivos automatizados. *** searchable: true title: 'Relatórios CVM de FIIs: Como Analisar Composição Patrimonial via API (2026)' description: 'Aprenda a extrair e analisar relatórios gerenciais mensais de FIIs enviados à CVM via API. CRI, LCI, imóveis, taxas, rentabilidade e passivos automatizados.' date: '2026-05-09' keywords: 'relatorios cvm fii, composicao patrimonial fii, cri lci fii, taxa administracao fii, relatorio gerencial fundo imobiliario, api cvm fii, vacancia fii, brapi reports' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Fundos Imobiliários' readingTime: '20 min' tags: \['Python', 'FIIs', 'CVM', 'Análise Fundamentalista', 'Relatórios', 'API', 'Tutorial', 'CRI', 'LCI'] relatedPosts: \['fundos-imobiliarios-fiis-guia-completo-iniciantes', 'fii-screener-python-filtrar-fundos-imobiliarios-pvp-dy', 'fiis-de-papel-vs-tijolo-comparativo-2026', 'api-fiis-brasil-indicadores-carteira-relatorios-dividendos'] featured: true expertise: 'Análise quantitativa de relatórios regulatórios de fundos imobiliários' lastReviewed: '2026-05-09' -------------------------- import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > A informação mais importante sobre um FII está no **relatório gerencial mensal enviado à CVM** — e quase ninguém lê. Neste artigo você vai aprender a extrair, parsear e analisar esses relatórios via API, com Python, transformando 100 páginas de PDF em métricas quantitativas que cabem numa planilha. *** ## Por Que os Relatórios CVM Importam Todo FII listado na bolsa brasileira é obrigado a publicar mensalmente um **relatório gerencial** na CVM, com: * Composição patrimonial detalhada (caixa, CRI, LCI, imóveis, fundos, recebíveis) * Taxa de administração e amortização * Rentabilidade da cota e do patrimônio * Dividend yield mensal calculado * Passivos (distribuições a pagar, obrigações imobiliárias) * Versionamento (relatórios retificados) Esses dados existem porque a CVM exige — mas tradicionalmente eles vivem dentro de **PDFs longos e mal estruturados**, o que afasta o investidor médio. A boa notícia: a [brapi importa esses relatórios automaticamente](/docs/fiis/relatorios) e expõe via JSON em [`/api/v2/fii/reports`](/docs/fiis/relatorios). Você sai do "ler PDF" para um DataFrame em Python em \~10 linhas. Este artigo cobre exclusivamente o endpoint `/api/v2/fii/reports`. Para cotações, indicadores ou dividendos, veja a [documentação completa](/docs/fiis). *** ## O Que Vem na Resposta Vamos olhar primeiro a estrutura do dado: ```bash curl "https://brapi.dev/api/v2/fii/reports?symbols=HGLG11&limit=2&sortBy=referenceDate&sortOrder=desc" ``` Resposta abreviada: ```jsonc { "reports": [ { "symbol": "HGLG11", "name": "CSHG Logística FII", "cnpj": "11.728.688/0001-47", "administratorName": "Credit Suisse Hedging-Griffo Cor. de Valores S.A.", "administratorCnpj": "61.809.182/0001-30", "referenceDate": "2025-03-31", "version": 1, // -- Patrimônio agregado -- "totalAssets": 10147254000.00, // Total de ativos (R$) "equity": 9232380000.00, // Patrimônio líquido (R$) "sharesOutstanding": 53850000, // Cotas emitidas "navPerShare": 171.48, // VP por cota (R$) // -- Custos e rentabilidade -- "adminFeeRate": 0.006, // Taxa de admin (% a.a.) "monthlyReturn": -0.0032, // Retorno mensal da cota (%) "monthlyPatrimonialReturn": 0.0089, // Retorno mensal patrimonial (%) "monthlyDividendYield": 0.0072, // DY mensal (%) "amortizationRate": 0.0, // Amortização (%) "totalInvestors": 488272, // Cotistas // -- Composição do ativo -- "cash": 452100000.00, // Caixa (R$) "governmentBonds": 0.0, // Títulos públicos (R$) "privateBonds": 0.0, // Títulos privados (R$) "fixedIncomeFunds": 0.0, // Fundos de renda fixa (R$) "totalInvested": 9695154000.00, // Total investido (R$) "realEstateAssets": 8754300000.00, // Imóveis (R$) "cri": 0.0, // CRI (R$) "lci": 0.0, // LCI (R$) "fiiHoldings": 312000000.00, // Cotas de outros FIIs (R$) "receivables": 98500000.00, // Recebíveis (R$) "rentalReceivables": 28354000.00, // Aluguéis a receber (R$) // -- Passivo -- "distributionsPayable": 116730000.00, "adminFeesPayable": 4892000.00, "realEstateObligations": 412300000.00, "totalLiabilities": 914874000.00 } ], "pagination": { /* ... */ }, "requestedAt": "2026-05-09T14:00:00.000Z" } ``` Cada campo dá uma métrica que tradicionalmente exige horas lendo PDF. Vamos transformá-los em ferramentas analíticas. *** ## O Que Vamos Construir Um pipeline Python que: 1. Puxa os últimos 12 meses de relatórios para uma carteira de FIIs 2. Calcula **composição patrimonial percentual** (% em CRI vs imóveis vs caixa) 3. Detecta **mudanças relevantes** entre meses (movimentação de portfólio) 4. Compara **taxa de administração** com a mediana do segmento 5. Identifica **inconsistências** (ex.: rentabilidade da cota muito diferente da patrimonial) 6. Exporta um **dossiê comparativo** para Excel *** ## Pré-requisitos ```bash mkdir fii-reports && cd fii-reports python -m venv .venv && source .venv/bin/activate pip install requests pandas openpyxl matplotlib export BRAPI_TOKEN="seu_token_pro" ``` *** ## Passo 1: Cliente Mínimo ```python title="brapi_reports.py" import os import requests from datetime import date, timedelta BASE = "https://brapi.dev/api/v2/fii" TOKEN = os.getenv("BRAPI_TOKEN", "") HEADERS = {"Authorization": f"Bearer {TOKEN}"} if TOKEN else {} def fetch_reports( symbols: list[str], start_date: str | None = None, end_date: str | None = None, all_versions: bool = False, ) -> list[dict]: """Busca relatórios CVM para uma lista de FIIs. A API aceita até 20 símbolos por request e pagina internamente. Por padrão retorna a versão mais recente de cada referenceDate. """ params = { "symbols": ",".join(symbols), "sortBy": "referenceDate", "sortOrder": "desc", "limit": 50, } if start_date: params["startDate"] = start_date if end_date: params["endDate"] = end_date if all_versions: params["allVersions"] = "true" reports: list[dict] = [] page = 1 while True: params["page"] = page resp = requests.get(f"{BASE}/reports", params=params, headers=HEADERS, timeout=30) resp.raise_for_status() data = resp.json() reports.extend(data.get("reports", [])) pagination = data.get("pagination", {}) if not pagination.get("hasNextPage"): break page += 1 return reports def last_n_months(n: int = 12) -> tuple[str, str]: """Retorna (startDate, endDate) cobrindo os últimos N meses.""" today = date.today() end = today.isoformat() # ~30 dias por mês start = (today - timedelta(days=n * 31)).isoformat() return start, end ``` *** ## Passo 2: Composição Patrimonial Percentual Uma das primeiras coisas a fazer com um relatório é entender **onde o dinheiro está**: ```python title="composition.py" import pandas as pd from brapi_reports import fetch_reports, last_n_months # Campos do ativo que somam o patrimônio investido ASSET_BUCKETS = { "Imóveis": "realEstateAssets", "CRI": "cri", "LCI": "lci", "Cotas de FIIs": "fiiHoldings", "Caixa": "cash", "Títulos Públicos": "governmentBonds", "Títulos Privados": "privateBonds", "Fundos RF": "fixedIncomeFunds", "Recebíveis": "receivables", "Aluguéis a receber": "rentalReceivables", } def composition_pct(report: dict) -> dict[str, float]: """Calcula % de cada bucket sobre o total de ativos.""" total = report.get("totalAssets") or 0 if total == 0: return {label: 0.0 for label in ASSET_BUCKETS} return { label: ((report.get(field) or 0) / total) * 100 for label, field in ASSET_BUCKETS.items() } def composition_dataframe(symbols: list[str]) -> pd.DataFrame: """DataFrame com a composição mais recente de cada FII.""" start, end = last_n_months(2) reports = fetch_reports(symbols, start_date=start, end_date=end) # Pega o relatório mais recente de cada symbol latest: dict[str, dict] = {} for r in reports: sym = r["symbol"] if sym not in latest or r["referenceDate"] > latest[sym]["referenceDate"]: latest[sym] = r rows = [] for sym, report in latest.items(): row = {"symbol": sym, "referenceDate": report["referenceDate"]} row.update(composition_pct(report)) rows.append(row) return pd.DataFrame(rows).set_index("symbol") ``` Uso: ```python df = composition_dataframe(["HGLG11", "MXRF11", "KNRI11", "BTLG11", "VISC11"]) print(df.round(1)) ``` Saída esperada: ``` referenceDate Imóveis CRI LCI Cotas de FIIs Caixa ... symbol HGLG11 2025-03-31 86.3 0.0 0.0 3.1 4.5 ... MXRF11 2025-03-31 0.0 78.4 2.1 5.3 8.2 ... KNRI11 2025-03-31 74.5 8.2 0.0 12.0 2.8 ... BTLG11 2025-03-31 82.1 0.0 0.0 0.0 7.5 ... VISC11 2025-03-31 91.8 0.0 0.0 0.0 1.5 ... ``` Olhando as linhas, em 5 segundos você sabe: * **HGLG11** e **VISC11** são tijolo puro (>85% imóveis) * **MXRF11** é papel puro (>78% em CRI) * **KNRI11** é híbrido (74% imóveis + 8% CRI + 12% cotas) *** ## Passo 3: Detectando Mudanças no Portfólio Um FII de tijolo que de repente aumenta caixa em 30% pode estar: * Vendendo um imóvel (positivo? negativo?) * Captando dinheiro novo (próxima emissão?) * Acumulando para uma aquisição Vamos detectar essas movimentações: ```python title="changes.py" import pandas as pd from brapi_reports import fetch_reports, last_n_months from composition import ASSET_BUCKETS, composition_pct def detect_composition_changes( symbol: str, threshold_pp: float = 5.0 ) -> pd.DataFrame: """Mostra mudanças mês-a-mês acima de threshold_pp pontos percentuais. Útil para identificar movimentações relevantes (ex.: venda de imóvel, aumento de caixa, aquisição de CRI novo). """ start, end = last_n_months(12) reports = fetch_reports([symbol], start_date=start, end_date=end) reports.sort(key=lambda r: r["referenceDate"]) rows = [] for r in reports: row = {"referenceDate": r["referenceDate"]} row.update(composition_pct(r)) rows.append(row) df = pd.DataFrame(rows).set_index("referenceDate") # Diferença mês-a-mês em pontos percentuais diff = df.diff() # Pega só meses com mudanças relevantes em algum bucket significant = diff.abs().max(axis=1) >= threshold_pp return diff[significant].round(2) # Uso print("Mudanças relevantes em HGLG11 (últimos 12 meses):") print(detect_composition_changes("HGLG11", threshold_pp=3.0)) ``` Saída exemplo: ``` Imóveis CRI LCI Cotas de FIIs Caixa ... referenceDate 2024-09-30 -3.5 0.0 0.0 0.0 +3.2 <- venda de imóvel? 2024-12-31 +4.1 0.0 0.0 -3.8 -0.5 2025-02-28 -0.2 0.0 0.0 0.0 -2.8 ``` Cada linha vira **uma pergunta** que você pode levar para a leitura qualitativa do relatório completo. Mais eficiente do que ler todos os meses. *** ## Passo 4: Taxa de Administração vs Mediana do Segmento A taxa de administração é o **maior dreno silencioso** de retorno de longo prazo. Vamos comparar a taxa de cada FII com a mediana do segmento: ```python title="fees.py" import pandas as pd from brapi_reports import fetch_reports, last_n_months def admin_fee_benchmark(symbols: list[str]) -> pd.DataFrame: """Compara taxa de admin com a mediana do conjunto.""" start, end = last_n_months(2) reports = fetch_reports(symbols, start_date=start, end_date=end) # Mais recente por symbol latest = {} for r in reports: sym = r["symbol"] if sym not in latest or r["referenceDate"] > latest[sym]["referenceDate"]: latest[sym] = r df = pd.DataFrame([ { "symbol": sym, "adminFeeRate": (r.get("adminFeeRate") or 0) * 100, "equity_bn": (r.get("equity") or 0) / 1_000_000_000, } for sym, r in latest.items() ]).set_index("symbol") median = df["adminFeeRate"].median() df["vs_median_bps"] = (df["adminFeeRate"] - median) * 100 # em bps return df.sort_values("adminFeeRate") ``` Uso: ```python fees = admin_fee_benchmark([ "HGLG11", "BTLG11", "XPLG11", "LVBI11", "BRCO11" # FIIs de logística grandes ]) print(fees.round(2)) ``` Saída exemplo: ``` adminFeeRate equity_bn vs_median_bps symbol BTLG11 0.55 4.8 -25.0 <- mais barato HGLG11 0.60 9.2 -20.0 XPLG11 0.80 3.5 0.0 <- mediana LVBI11 0.95 2.1 +15.0 BRCO11 1.10 1.8 +30.0 <- mais caro ``` Em logística, **20 bps a menos por ano** é diferença material em 10 anos de carteira. *** ## Passo 5: Sanity Check — Cota vs Patrimônio Um sinal que poucos investidores olham: **a rentabilidade da cota vs a rentabilidade patrimonial**. * `monthlyReturn`: rentabilidade da cota negociada na bolsa. * `monthlyPatrimonialReturn`: rentabilidade do patrimônio efetivo (ativos – passivos). Quando os dois divergem muito, há **descolamento entre preço e fundamentos**: ```python title="divergence.py" import pandas as pd from brapi_reports import fetch_reports, last_n_months def cota_vs_patrimonial(symbol: str) -> pd.DataFrame: start, end = last_n_months(12) reports = fetch_reports([symbol], start_date=start, end_date=end) reports.sort(key=lambda r: r["referenceDate"]) rows = [ { "referenceDate": r["referenceDate"], "cota_pct": (r.get("monthlyReturn") or 0) * 100, "patrimonial_pct": (r.get("monthlyPatrimonialReturn") or 0) * 100, "spread_pp": ((r.get("monthlyReturn") or 0) - (r.get("monthlyPatrimonialReturn") or 0)) * 100, } for r in reports ] return pd.DataFrame(rows).set_index("referenceDate").round(2) print(cota_vs_patrimonial("HGLG11")) ``` Saída exemplo: ``` cota_pct patrimonial_pct spread_pp referenceDate 2024-06-30 1.2 0.9 +0.3 2024-07-31 -2.5 0.8 -3.3 <- cota caiu mas patrimônio cresceu 2024-08-31 -1.8 0.7 -2.5 <- mesma direção 2024-09-30 3.1 0.6 +2.5 <- recuperação ... ``` **Spreads negativos persistentes** (cota cai enquanto patrimônio cresce) podem indicar: * Janela de oportunidade (mercado pessimista temporariamente) * Mudança estrutural (saída de cotistas grandes, mudança de gestão) * Risco oculto que o mercado precificou antes do reporte Combine com a leitura qualitativa do relatório para distinguir. *** ## Passo 6: Dossiê Excel Comparativo Vamos juntar tudo num arquivo Excel que você pode usar como **dossiê mensal**: ```python title="dossier.py" import pandas as pd from brapi_reports import fetch_reports, last_n_months from composition import composition_dataframe, ASSET_BUCKETS from fees import admin_fee_benchmark def build_dossier(symbols: list[str], output_path: str = "fii_dossier.xlsx") -> None: start, end = last_n_months(12) reports = fetch_reports(symbols, start_date=start, end_date=end) df_reports = pd.DataFrame(reports) composition = composition_dataframe(symbols) fees = admin_fee_benchmark(symbols) # Resumo executivo latest_by_symbol = ( df_reports.sort_values("referenceDate") .groupby("symbol") .tail(1) .set_index("symbol") ) summary = pd.DataFrame({ "Última referência": latest_by_symbol["referenceDate"], "Patrimônio (R$ bi)": latest_by_symbol["equity"] / 1e9, "VP/Cota (R$)": latest_by_symbol["navPerShare"], "Taxa Admin (% a.a.)": latest_by_symbol["adminFeeRate"] * 100, "DY mensal (%)": latest_by_symbol["monthlyDividendYield"] * 100, "Cotistas": latest_by_symbol["totalInvestors"], }).round(2) with pd.ExcelWriter(output_path, engine="openpyxl") as writer: summary.to_excel(writer, sheet_name="Resumo") composition.round(1).to_excel(writer, sheet_name="Composição (%)") fees.round(2).to_excel(writer, sheet_name="Taxas vs Mediana") df_reports.to_excel(writer, sheet_name="Raw - 12 meses", index=False) print(f"Dossiê salvo em {output_path}") # Exemplo de uso if __name__ == "__main__": build_dossier( symbols=["HGLG11", "BTLG11", "XPLG11", "LVBI11", "BRCO11", "VRTA11"], output_path="dossier_logistica_2026-05.xlsx", ) ``` Resultado: um Excel com 4 abas, pronto para enviar pro time, ou só pra você abrir 1x por mês e tirar conclusões. *** ## Casos de Uso Avançados ### A) Filtragem por Composição Mínima Quer apenas FIIs híbridos com **pelo menos 60% em imóveis** e **menos de 10% em CRI**? ```python def filter_by_composition( candidates: list[str], min_real_estate_pct: float = 60.0, max_cri_pct: float = 10.0, ) -> list[str]: df = composition_dataframe(candidates) mask = (df["Imóveis"] >= min_real_estate_pct) & (df["CRI"] <= max_cri_pct) return df.index[mask].tolist() ``` Combine com o [screener](/blog/fii-screener-python-filtrar-fundos-imobiliarios-pvp-dy) para refinar duas vezes: primeiro filtros quantitativos no `indicators`, depois filtros estruturais no `reports`. ### B) Detecção de Versionamento (Relatórios Retificados) Use `allVersions=true` para capturar relatórios retificados — sinal de que o FII teve algum erro relevante na primeira versão: ```python reports = fetch_reports(["HGLG11"], all_versions=True) # Agrupa por (symbol, referenceDate) e conta versões from collections import defaultdict versions = defaultdict(list) for r in reports: key = (r["symbol"], r["referenceDate"]) versions[key].append(r["version"]) retificacoes = {k: v for k, v in versions.items() if max(v) > 1} print(f"Retificações detectadas: {len(retificacoes)}") ``` ### C) Histórico de Cotistas Crescimento ou retração de `totalInvestors` é um indicador de "popularidade" — útil em conjunto com indicadores fundamentais: ```python def evolution_investors(symbol: str) -> pd.DataFrame: start, end = last_n_months(24) reports = fetch_reports([symbol], start_date=start, end_date=end) reports.sort(key=lambda r: r["referenceDate"]) return pd.DataFrame([ { "referenceDate": r["referenceDate"], "investors": r.get("totalInvestors") or 0, "growth_mom_pct": None, # preenchido abaixo } for r in reports ]) ``` *** ## Limitações Importantes Os relatórios CVM não trazem dados de **vacância física** explícita, nem rent roll por inquilino. Esses dados quando existem estão em PDFs complementares enviados pelos administradores. Para análise qualitativa profunda de FIIs de tijolo, complemente com leitura dos relatórios em PDF. O campo `monthlyDividendYield` é o DY mensal calculado sobre o NAV por cota, não sobre o preço de mercado. Para DY sobre preço, use [`/api/v2/fii/indicators`](/docs/fiis/indicadores) que retorna `dividendYield12m` e `dividendYield1m` calculados sobre o preço de fechamento. *** ## Conclusão Os relatórios CVM são a **melhor fonte primária** sobre um FII — e historicamente eram inacessíveis a quem não tinha tempo para ler PDFs todo mês. Com o endpoint `/api/v2/fii/reports` e \~200 linhas de Python, você passa a ter: * Dossiê mensal automatizado para cada FII da carteira * Detecção de mudanças relevantes na composição patrimonial * Benchmark de taxas vs mediana do segmento * Identificação de descolamento cota-patrimônio A diferença entre um investidor de FII passivo e um investidor que **sabe o que tem na carteira** é exatamente isso: três horas de Python por mês. > **Próximos passos:** se você ainda não construiu um screener para descobrir candidatos antes da análise CVM, veja o [tutorial de FII Screener com Python](/blog/fii-screener-python-filtrar-fundos-imobiliarios-pvp-dy). Para um overview do mercado, comece pelo [guia completo de FIIs](/blog/fundos-imobiliarios-fiis-guia-completo-iniciantes). *Disclaimer: este artigo é educacional e não constitui recomendação de investimento. Leia sempre o regulamento e prospecto de cada fundo antes de investir.* # Renda Fixa vs Renda Variável em 2026: Guia Completo de Comparação URL: /blog/renda-fixa-vs-renda-variavel-2026.mdx Entenda a diferença entre renda fixa e renda variável, quando investir em cada uma, como montar uma carteira equilibrada e qual é melhor para seu perfil *** searchable: true title: 'Renda Fixa vs Renda Variável em 2026: Guia Completo de Comparação' description: 'Entenda a diferença entre renda fixa e renda variável, quando investir em cada uma, como montar uma carteira equilibrada e qual é melhor para seu perfil' date: '2026-01-01' keywords: 'renda fixa vs renda variavel 2026, diferenca renda fixa renda variavel, investir renda fixa, investir renda variavel, carteira investimentos, CDB acoes, tesouro direto bolsa, como investir 2026' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Estratégia' readingTime: '22 min' tags: \['Renda Fixa', 'Renda Variável', 'Estratégia', 'Carteira', 'Diversificação', 'Iniciantes'] relatedPosts: \['tesouro-direto-guia-completo-2026-como-investir', 'o-que-e-cdi-guia-completo-2026', 'cdb-vs-tesouro-direto-comparativo-2026', 'lci-lca-guia-completo-investimentos-isentos-ir-2026', 'como-investir-com-pouco-dinheiro-2026'] featured: true expertise: 'Alocação de ativos e estratégia de investimentos' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; > Você sabe a diferença entre renda fixa e renda variável? Qual é melhor para você? Este guia explica as características de cada classe, quando usar cada uma e como equilibrar sua carteira. *** ## Renda Fixa vs Renda Variável: Resumo Rápido | Característica | Renda Fixa | Renda Variável | | --------------------- | -------------------- | ------------------------ | | **Previsibilidade** | Alta | Baixa | | **Risco** | Baixo a Médio | Médio a Alto | | **Retorno potencial** | Limitado | Ilimitado | | **Exemplos** | CDB, Tesouro, LCI | Ações, FIIs, ETFs | | **Ideal para** | Reserva, curto prazo | Longo prazo, crescimento | | **Volatilidade** | Baixa | Alta | *** ## O Que É Renda Fixa? **Renda Fixa** são investimentos onde você sabe (ou pode calcular) quanto vai receber no final. ``` Você empresta dinheiro → Recebe juros de volta Empréstimo para: - Governo → Tesouro Direto - Bancos → CDB, LCI, LCA - Empresas → Debêntures ``` ### Tipos de Renda Fixa | Tipo | O que é | Rentabilidade | Risco | | --------------------- | --------------------------- | --------------------- | -------- | | **Tesouro Selic** | Título do governo | Selic | Soberano | | **Tesouro IPCA+** | Título do governo | IPCA + taxa | Soberano | | **Tesouro Prefixado** | Título do governo | Taxa fixa | Soberano | | **CDB** | Título de banco | % do CDI ou taxa fixa | Crédito | | **LCI/LCA** | Título de banco (isento IR) | % do CDI | Crédito | | **Debêntures** | Título de empresa | CDI+ ou IPCA+ | Crédito | | **CRI/CRA** | Securitização (isento IR) | CDI+ ou IPCA+ | Crédito | ### Vantagens da Renda Fixa **Principais benefícios:** | Vantagem | Descrição | | ----------------- | --------------------------------------- | | ✓ Previsibilidade | Você sabe quanto vai receber | | ✓ Baixo Risco | Protegido por FGC ou governo | | ✓ Liquidez | Tesouro Selic e CDB líquido disponíveis | | ✓ Diversificação | Complementa renda variável | | ✓ Juros Compostos | Rendimento sobre rendimento | | ✓ Acessível | Investir a partir de R$ 30 | ### Desvantagens da Renda Fixa * **Retorno limitado**: Não supera muito a inflação * **IR regressivo**: Come parte do lucro * **Risco de inflação**: Se inflação disparar, perde poder de compra * **Custo de oportunidade**: Pode perder altas da bolsa *** ## O Que É Renda Variável? **Renda Variável** são investimentos onde você não sabe quanto vai receber - pode ganhar muito ou perder. ``` Você compra parte de ativos → Valor varia conforme mercado Exemplos: - Ações → Parte de empresas - FIIs → Parte de imóveis - ETFs → Cestas de ativos - BDRs → Ações estrangeiras ``` ### Tipos de Renda Variável | Tipo | O que é | Potencial Retorno | Risco | | ---------------- | ----------------------------- | ----------------- | ---------- | | **Ações** | Parte de empresas | Alto | Alto | | **FIIs** | Fundos imobiliários | Médio-Alto | Médio | | **ETFs** | Fundos de índice | Médio | Médio | | **BDRs** | Recibos de ações estrangeiras | Alto | Alto | | **Criptomoedas** | Moedas digitais | Muito Alto | Muito Alto | | **Derivativos** | Contratos (opções, futuros) | Ilimitado | Altíssimo | ### Vantagens da Renda Variável **Principais benefícios:** | Vantagem | Descrição | | ------------------- | ----------------------------------- | | ✓ Alto Potencial | Possibilidade de ganhos expressivos | | ✓ Proteção Inflação | Empresas repassam inflação | | ✓ Dividendos | Renda passiva (ações e FIIs) | | ✓ Isenção IR FIIs | Dividendos de FIIs são isentos | | ✓ Liquidez | Comprar/vender a qualquer momento | | ✓ Sócio de Empresas | Participação nos lucros | ### Desvantagens da Renda Variável * **Volatilidade alta**: Pode perder 50%+ em crises * **Imprevisibilidade**: Não sabe quanto vai ganhar * **Exige estudo**: Precisa analisar empresas * **Fator emocional**: Medo e ganância atrapalham * **Sem garantia FGC**: Pode perder tudo se empresa quebrar *** ## Comparativo Detalhado ### Rendimento Histórico **Comparativo de rendimentos acumulados (dados aproximados):** | Período | CDI | Ibovespa | FIIs (IFIX) | Dólar | IPCA | | ------- | ----- | -------- | ----------- | ------ | ----- | | 10 anos | 89,5% | 142,3% | 98,7% | 156,2% | 75,8% | | 5 anos | 41,2% | 28,5% | 15,2% | 52,3% | 35,1% | | 1 ano | 10,8% | -10,5% | -5,2% | 27,3% | 4,5% | **Observações:** * CDI é mais consistente, menos volatilidade * Ibovespa pode superar no longo prazo, mas com grandes oscilações * FIIs oferecem renda mensal + valorização * Resultados passados não garantem futuro ### Simulação de Carteiras **Simulação: R$ 100.000 por 10 anos (cenário moderado)** *Premissas: 10% a.a. renda fixa, 12% a.a. renda variável* | Carteira | Valor Final | Retorno Total | | ------------------------------ | ----------- | ------------- | | Conservadora (80% RF / 20% RV) | R$ 271.379 | 171,4% | | Moderada (60% RF / 40% RV) | R$ 283.942 | 183,9% | | Arrojada (30% RF / 70% RV) | R$ 303.351 | 203,4% | | 100% Renda Fixa | R$ 259.374 | 159,4% | | 100% Renda Variável | R$ 310.585 | 210,6% | ⚠️ *Simulação simplificada. Não considera volatilidade real, custos ou impostos.* *** ## Quando Usar Cada Uma? ### Renda Fixa É Melhor Para: | Situação | Por quê | | ------------------------- | ---------------------------------- | | **Reserva de emergência** | Precisa de liquidez e segurança | | **Objetivos \< 2 anos** | Não há tempo para recuperar perdas | | **Perfil conservador** | Não tolera ver patrimônio cair | | **Juros altos** | CDI a 13%+ é atrativo | | **Aposentados** | Precisam de previsibilidade | ### Renda Variável É Melhor Para: | Situação | Por quê | | ---------------------------- | ------------------------- | | **Objetivos > 5 anos** | Tempo dilui volatilidade | | **Construção de patrimônio** | Potencial de crescimento | | **Renda passiva** | Dividendos e aluguéis | | **Proteção inflação** | Empresas reajustam preços | | **Juros baixos** | RF perde para inflação | ### Tabela de Decisão **Sugestão de alocação baseada em perfil:** #### Jovem Investidor (25 anos, tolerância alta, prazo 30 anos) | Classe | Alocação | | ------------------------- | -------- | | **Renda Fixa** | 25% | | - Tesouro Selic (reserva) | 10% | | - Tesouro IPCA+ | 15% | | **Renda Variável** | 75% | | - Ações Brasil | 38% | | - FIIs | 22% | | - ETFs/Internacional | 15% | #### Investidor Meia-Idade (45 anos, tolerância média, prazo 15 anos) | Classe | Alocação | | ------------------------- | -------- | | **Renda Fixa** | 45% | | - Tesouro Selic (reserva) | 10% | | - Tesouro IPCA+ | 20% | | - CDB/LCI/LCA | 15% | | **Renda Variável** | 55% | | - Ações Brasil | 28% | | - FIIs | 16% | | - ETFs/Internacional | 11% | #### Próximo da Aposentadoria (60 anos, tolerância baixa, prazo 5 anos) | Classe | Alocação | | ------------------------- | -------- | | **Renda Fixa** | 80% | | - Tesouro Selic (reserva) | 10% | | - Tesouro IPCA+ | 50% | | - CDB/LCI/LCA | 20% | | **Renda Variável** | 20% | | - Ações dividendos | 10% | | - FIIs | 6% | | - ETFs | 4% | ⚠️ *PRIMEIRO monte reserva de emergência em renda fixa antes de investir em renda variável!* *** ## Montando uma Carteira Equilibrada ### Modelo de Alocação por Idade | Idade | Renda Fixa | Renda Variável | Justificativa | | ----- | ---------- | -------------- | ---------------------------------- | | 20-30 | 20-30% | 70-80% | Muito tempo para recuperar | | 30-40 | 30-40% | 60-70% | Ainda tem horizonte longo | | 40-50 | 40-50% | 50-60% | Equilibrar crescimento e segurança | | 50-60 | 50-60% | 40-50% | Reduzir risco gradualmente | | 60+ | 60-80% | 20-40% | Priorizar preservação | ### Exemplo de Carteira Diversificada #### Carteira Conservadora (R$ 50.000) | Classe | Ativo | % | Valor | | ------------ | ------------------- | -------- | ------------- | | **RF (80%)** | Tesouro Selic | 30% | R$ 15.000 | | | Tesouro IPCA+ | 30% | R$ 15.000 | | | CDB 110% CDI | 20% | R$ 10.000 | | **RV (20%)** | ETF BOVA11 | 10% | R$ 5.000 | | | FIIs diversificados | 10% | R$ 5.000 | | **Total** | - | **100%** | **R$ 50.000** | #### Carteira Moderada (R$ 100.000) | Classe | Ativo | % | Valor | | ------------ | ----------------- | -------- | -------------- | | **RF (50%)** | Tesouro Selic | 15% | R$ 15.000 | | | Tesouro IPCA+ | 20% | R$ 20.000 | | | CDB/LCI | 15% | R$ 15.000 | | **RV (50%)** | Ações Blue Chips | 20% | R$ 20.000 | | | FIIs | 15% | R$ 15.000 | | | ETF Internacional | 15% | R$ 15.000 | | **Total** | - | **100%** | **R$ 100.000** | #### Carteira Arrojada (R$ 200.000) | Classe | Ativo | % | Valor | | ------------ | ----------------------- | -------- | -------------- | | **RF (30%)** | Tesouro Selic (reserva) | 10% | R$ 20.000 | | | Tesouro IPCA+ | 20% | R$ 40.000 | | **RV (70%)** | Ações Growth | 30% | R$ 60.000 | | | Ações Dividendos | 15% | R$ 30.000 | | | FIIs | 15% | R$ 30.000 | | | ETF Internacional | 10% | R$ 20.000 | | **Total** | - | **100%** | **R$ 200.000** | *** ## Consultando Dados em Tempo Real ### Renda Fixa (Selic/CDI) ```typescript // Selic + IPCA em uma única requisição via /api/v2/macro/latest const response = await fetch( 'https://brapi.dev/api/v2/macro/latest?symbols=selic,ipca12m', { headers: { Authorization: `Bearer ${process.env.BRAPI_TOKEN}` } } ); const { results } = await response.json(); const selic = results.find((r) => r.series.slug === 'selic')?.latest.value; const ipca = results.find((r) => r.series.slug === 'ipca12m')?.latest.value; // Juro real ≈ ((1 + selic/100) / (1 + ipca/100) - 1) * 100 ``` **Rendimentos estimados (com Selic a 13,75%):** | Investimento | Rendimento Líquido (12m) | | ----------------------- | ------------------------ | | Poupança | \~9,6% | | CDB 100% CDI (líquido) | \~10,9% | | LCI 90% CDI | \~12,3% | | Tesouro Selic (líquido) | \~11,0% | | Tesouro IPCA+ | \~IPCA + 6,5% | ### Renda Variável (Ações) ```typescript // Consultar principais ações da bolsa const tickers = 'PETR4,VALE3,ITUB4,BBDC4,ABEV3,WEGE3,RENT3,BBAS3'; const response = await fetch( `https://brapi.dev/api/quote/${tickers}`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); ``` **Exemplo de cotações (principais ações brasileiras):** | Ticker | Nome | Preço | Var. Dia | Var. Ano | | ------ | --------------- | -------- | -------- | -------- | | PETR4 | Petrobras PN | R$ 36,50 | +1,2% | +25,3% | | VALE3 | Vale ON | R$ 68,20 | -0,8% | -12,5% | | ITUB4 | Itaú PN | R$ 32,40 | +0,5% | +18,7% | | BBDC4 | Bradesco PN | R$ 14,80 | +0,3% | -5,2% | | ABEV3 | Ambev ON | R$ 12,30 | -0,2% | +8,4% | | WEGE3 | WEG ON | R$ 42,50 | +1,8% | +35,2% | | RENT3 | Localiza ON | R$ 52,70 | +0,9% | +15,3% | | BBAS3 | Banco Brasil ON | R$ 28,90 | +0,4% | +22,1% | *** ## Estratégias de Balanceamento ### Rebalanceamento Periódico **Exemplo: Carteira atual R$ 100.000 com novo aporte de R$ 10.000** | Classe | Valor Atual | % Atual | Alvo | Desvio | Ação | | -------------- | ----------- | ------- | ---- | ------- | ---------------- | | Renda Fixa | R$ 60.000 | 60% | 50% | +10% ⚠️ | Vender R$ 5.000 | | Renda Variável | R$ 40.000 | 40% | 50% | -10% ⚠️ | Comprar R$ 5.000 | **Com novo aporte de R$ 10.000:** | Classe | Valor Ideal | Diferença | Sugestão | | -------------- | ----------- | ---------- | ---------------- | | Renda Fixa | R$ 55.000 | -R$ 5.000 | Não aportar | | Renda Variável | R$ 55.000 | +R$ 15.000 | Alocar R$ 10.000 | 💡 *Dica: Use os aportes para rebalancear em vez de vender posições (evita IR).* ### Quando Rebalancear | Método | Quando | Vantagem | | -------------- | --------------------- | --------------------- | | **Temporal** | A cada 6-12 meses | Simples, disciplinado | | **Por Desvio** | Quando desviar >5-10% | Mais eficiente | | **Por Aporte** | A cada novo aporte | Não precisa vender | *** ## Cenários de Mercado ### CDI Alto (Como Agora: 13%+) **Vantagens do cenário:** * ✅ Renda fixa muito atrativa * ✅ Rendimento real positivo (acima da inflação) * ✅ Menor risco para mesma rentabilidade **Considerações:** * ⚠️ Ações podem estar "baratas" (oportunidade) * ⚠️ Juros tendem a cair (lock in taxas prefixadas) * ⚠️ Empresas endividadas sofrem mais **Sugestão de alocação:** * Aumentar exposição a Tesouro IPCA+ e Prefixado * Manter ações de empresas sólidas e baixo endividamento * FIIs de tijolo podem estar descontados ### CDI Baixo (Cenário Futuro Possível) **Vantagens do cenário:** * ✅ Renda variável tende a subir * ✅ Empresas se financiam mais barato * ✅ FIIs ficam mais atrativos **Considerações:** * ⚠️ Renda fixa perde para inflação * ⚠️ Momento de aumentar exposição a ações * ⚠️ Cuidado com euforia do mercado **Sugestão de alocação:** * Manter apenas reserva de emergência em RF * Aumentar ações, FIIs, ETFs * Considerar exposição internacional *** ## Erros Comuns ### Na Renda Fixa | Erro | Problema | Solução | | ----------------------- | --------------------- | ----------------------- | | Deixar tudo na poupança | Perde para CDI | Migrar para CDB/Tesouro | | Não diversificar bancos | Risco de crédito | Respeitar limite FGC | | Ignorar liquidez | Precisar vender antes | Escalonar vencimentos | | Não considerar IR | Calcular errado | Sempre calcular líquido | ### Na Renda Variável | Erro | Problema | Solução | | ------------------------- | ---------------------- | ---------------------------- | | Concentrar em 1-2 ações | Risco altíssimo | Diversificar (10+ ações) | | Vender no pânico | Realizar prejuízo | Ter estratégia definida | | Não reinvestir dividendos | Perder juros compostos | Reinvestir automaticamente | | Ignorar taxas | Corroer rentabilidade | Escolher corretora taxa zero | *** ## Checklist: Equilibrando Sua Carteira ### Antes de Investir | Item | ✓ | | ------------------------------------------ | - | | Tenho reserva de emergência em renda fixa? | ☐ | | Sei meu prazo para cada objetivo? | ☐ | | Conheço minha tolerância a risco? | ☐ | | Defini minha alocação alvo (RF/RV)? | ☐ | ### Ao Investir | Item | ✓ | | -------------------------------------------- | - | | Diversifiquei dentro de cada classe? | ☐ | | Respeitei limite FGC (R$ 250k por banco)? | ☐ | | Escolhi ações de qualidade para longo prazo? | ☐ | | Configurei reinvestimento de dividendos? | ☐ | ### Periodicamente | Item | ✓ | | ----------------------------------- | - | | Rebalanceio a cada 6-12 meses? | ☐ | | Acompanho sem obsessão (mensal)? | ☐ | | Ajusto alocação conforme idade? | ☐ | | Aproveito aportes para rebalancear? | ☐ | *** ## Conclusão ### Resumo Final | Situação | Recomendação | | ---------------------------- | ------------------ | | **Reserva de emergência** | 100% Renda Fixa | | **Curto prazo (\< 2 anos)** | 80-100% Renda Fixa | | **Médio prazo (2-5 anos)** | 50-70% Renda Fixa | | **Longo prazo (> 5 anos)** | 30-50% Renda Fixa | | **Aposentadoria (30+ anos)** | 20-40% Renda Fixa | ### Próximos Passos 1. **Defina seu perfil** de investidor 2. **Monte reserva de emergência** em Tesouro Selic ou CDB líquido 3. **Estabeleça alocação alvo** baseada em idade e objetivos 4. **Use a brapi.dev** para acompanhar seus investimentos 5. **Rebalanceie periodicamente** para manter proporções *** ## Leia Também * [O Que É CDI: Guia Completo 2026](/blog/o-que-e-cdi-guia-completo-2026) * [O Que São Ações: Guia para Iniciantes 2026](/blog/o-que-sao-acoes-guia-iniciantes-2026) * [Tesouro Direto: Guia Completo 2026](/blog/tesouro-direto-guia-completo-2026-como-investir) * [Como Investir com Pouco Dinheiro 2026](/blog/como-investir-com-pouco-dinheiro-2026) *** **Aviso Legal:** Este conteúdo é educacional e não constitui recomendação de investimento. Rentabilidade passada não garante rentabilidade futura. Consulte um profissional antes de investir. # Reserva de Emergência: Quanto Guardar e Onde Deixar URL: /blog/reserva-de-emergencia-guia-completo-2026.mdx Calcule sua reserva de emergência com base nos gastos essenciais e escolha onde guardar o dinheiro com segurança, liquidez e baixa oscilação. *** searchable: true title: 'Reserva de Emergência: Quanto Guardar e Onde Deixar' description: 'Calcule sua reserva de emergência com base nos gastos essenciais e escolha onde guardar o dinheiro com segurança, liquidez e baixa oscilação.' date: '2026-01-01' keywords: 'reserva de emergência quanto guardar, onde investir reserva emergência, calcular reserva emergência, tesouro selic reserva, cdb liquidez diária' author: 'Alisson Leal' category: 'Finanças Pessoais' subcategory: 'Reserva de emergência' readingTime: '7 min' tags: \['Reserva de Emergência', 'Liquidez', 'Tesouro Selic', 'CDB', 'Finanças Pessoais'] relatedPosts: \['como-comecar-investir-do-zero-guia-iniciantes-2026', 'como-sair-das-dividas-comecar-investir-guia-2026', 'cdb-vs-tesouro-direto-comparativo-2026'] featured: false expertise: 'Educação financeira aplicada a decisões de liquidez e risco' lastReviewed: '2026-07-17' -------------------------- import { Author, Authors } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; Reserva de emergência é dinheiro separado para despesas urgentes e perda de renda. Ela deve priorizar acesso rápido, baixo risco e pouca oscilação. Retorno vem depois. Uma referência comum é guardar de três a doze meses dos gastos essenciais. O número adequado depende da estabilidade da renda, das pessoas que dependem de você e da facilidade de reduzir despesas. ## Como calcular Some apenas os gastos que precisariam continuar durante uma emergência: * moradia; * alimentação; * saúde; * transporte; * contas básicas; * seguros; * parcelas obrigatórias; * despesas de dependentes. Depois multiplique pelo número de meses escolhido. ```text reserva = gastos essenciais mensais x meses de proteção ``` Se os gastos essenciais são R$ 4.000 e a meta é seis meses: ```text R$ 4.000 x 6 = R$ 24.000 ``` ## Quantos meses guardar Três meses podem ser um primeiro marco para quem tem renda estável, boa rede de apoio e poucas obrigações. Seis meses dão mais tempo para lidar com desemprego ou uma despesa relevante. Nove a doze meses podem fazer sentido para autônomos, pessoas com renda variável, dependentes ou pouca previsibilidade profissional. Essas faixas não são lei. Uma pessoa com doença crônica ou trabalho sazonal pode precisar de uma margem diferente. Não espere juntar seis meses de despesas para considerar que a reserva existe. Defina marcos menores, como R$ 1.000, um mês e três meses, e continue aportando. ## Onde guardar O produto precisa atender a três critérios: 1. baixa probabilidade de perda nominal; 2. liquidez compatível com uma urgência; 3. regras simples de resgate. Alternativas comuns incluem Tesouro Selic, CDB com liquidez diária e conta remunerada com cobertura e regras adequadas ao seu caso. Confira horário de resgate, prazo de liquidação, carência, tributação, garantia e risco da instituição. "Liquidez diária" não significa necessariamente dinheiro disponível a qualquer hora do dia. ## Tesouro Selic O Tesouro Selic tem risco soberano e liquidez oferecida pelo programa, mas o resgate segue dias e horários de funcionamento. O preço também pode variar um pouco antes do vencimento. Consulte as regras e taxas atuais no site oficial do Tesouro Direto antes de aplicar. ## CDB com liquidez diária Um CDB é uma dívida do banco. Verifique se existe carência, quando o resgate cai na conta e se o produto se enquadra nas regras vigentes do FGC. Não concentre uma reserva grande em uma instituição apenas porque a taxa parece melhor. Acesso e diversificação institucional podem importar mais. ## O que evitar Uma reserva não combina bem com ativos que podem cair quando você precisa vender: * ações; * FIIs; * criptomoedas; * títulos longos sujeitos a marcação a mercado; * produtos com carência; * crédito privado de baixa liquidez. Esses ativos podem ter lugar em outros objetivos. O problema é depender deles para pagar uma urgência amanhã. ## Quando usar a reserva Use para eventos necessários, urgentes e não planejados. Exemplos incluem perda de renda, despesa médica, reparo indispensável ou viagem familiar emergencial. Uma promoção, férias previsíveis ou troca de celular não são emergências. Crie uma meta separada para despesas planejadas. Depois de usar o dinheiro, ajuste temporariamente os aportes para reconstruir a reserva. ## Se você ainda tem dívidas Uma pequena reserva evita recorrer ao cartão por qualquer imprevisto. Depois desse colchão inicial, compare o custo da dívida com o benefício de ampliar a reserva. Dívidas caras costumam crescer mais rápido do que investimentos conservadores. O passo a passo está em [como sair das dívidas e começar a investir](/blog/como-sair-das-dividas-comecar-investir-guia-2026). ## Revisar a meta Recalcule quando houver mudança de renda, moradia, dependentes, saúde ou despesas fixas. Uma revisão anual também evita trabalhar com um custo de vida antigo. A reserva está pronta quando o valor, a liquidez e o local onde está guardada fazem sentido para a emergência que você quer suportar. # ROE (Retorno sobre Patrimônio) 2026: Guia Completo para Análise de Ações URL: /blog/roe-retorno-sobre-patrimonio-como-analisar.mdx Aprenda a usar o ROE para avaliar empresas. Entenda o que é Retorno sobre Patrimônio, como calcular, interpretar e identificar empresas lucrativas ✓ *** searchable: true title: 'ROE (Retorno sobre Patrimônio) 2026: Guia Completo para Análise de Ações' description: 'Aprenda a usar o ROE para avaliar empresas. Entenda o que é Retorno sobre Patrimônio, como calcular, interpretar e identificar empresas lucrativas ✓' date: '2026-01-01' keywords: 'ROE, retorno sobre patrimônio, ROE ações, como analisar ROE, rentabilidade empresa, indicadores fundamentalistas, análise fundamentalista 2026' author: 'Equipe brapi.dev' category: 'Análise Fundamentalista' subcategory: 'Indicadores' readingTime: '18 min' tags: \['ROE', 'Rentabilidade', 'Análise Fundamentalista', 'Indicadores', 'Ações'] relatedPosts: \['entendendo-indicador-preco-lucro-pl-analise-fundamentalista', 'value-investing-como-encontrar-acoes-baratas', 'indicador-ev-ebitda-como-analisar', 'indicador-peg-ratio-como-usar', 'dividend-yield-dy-como-calcular-usar-analise-acoes-dividendos'] featured: true expertise: 'Especialistas em análise de rentabilidade e indicadores fundamentalistas' lastReviewed: 2026-01-03 ------------------------ O **ROE (Return on Equity)** ou **Retorno sobre Patrimônio Líquido** é um dos indicadores mais importantes da análise fundamentalista. Ele responde uma pergunta essencial: **"Quanto a empresa gera de lucro com o dinheiro dos acionistas?"** Warren Buffett considera o ROE um dos indicadores mais importantes para selecionar empresas. Neste guia, você vai aprender tudo sobre como usar o ROE para encontrar empresas excepcionais. ## O Que é ROE? O **ROE (Return on Equity)** mede a capacidade da empresa de gerar lucro a partir do patrimônio líquido dos acionistas. ### Fórmula do ROE ``` ROE = (Lucro Líquido / Patrimônio Líquido) × 100 Onde: - Lucro Líquido = Lucro final da empresa (após impostos) - Patrimônio Líquido = Capital investido pelos acionistas + Lucros retidos ``` ### Exemplo Prático ``` Empresa ABC: - Lucro Líquido: R$ 500 milhões - Patrimônio Líquido: R$ 2,5 bilhões ROE = (500 / 2.500) × 100 = 20% Interpretação: A empresa gera R$ 0,20 de lucro para cada R$ 1,00 investido pelos acionistas. ``` ## Por Que o ROE é Importante? ### O Poder do ROE Alto ``` ┌─────────────────────────────────────────────────────────────┐ │ IMPACTO DO ROE NO LONGO PRAZO │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Empresa A: ROE 10% Empresa B: ROE 25% │ │ Patrimônio: R$ 100 Patrimônio: R$ 100 │ │ │ │ Após 10 anos (reinvestindo 100% dos lucros): │ │ │ │ Empresa A: R$ 259 Empresa B: R$ 931 │ │ (cresceu 2,6x) (cresceu 9,3x) │ │ │ │ A diferença: 3,6x mais valor gerado! │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### ROE e Crescimento Uma empresa com ROE alto pode crescer mais rápido porque: 1. **Gera mais lucro** por real investido 2. **Reinveste lucros** de forma mais eficiente 3. **Precisa de menos capital externo** para crescer 4. **Cria mais valor** para os acionistas ## Como Interpretar o ROE ### Referências por Faixa | ROE | Classificação | Interpretação | | ------------- | ------------- | -------------------------------------------------- | | **\< 5%** | Muito baixo | Abaixo da renda fixa, questione o investimento | | **5% - 10%** | Baixo | Empresa com dificuldades ou setor de baixo retorno | | **10% - 15%** | Moderado | Média do mercado brasileiro | | **15% - 20%** | Bom | Empresa eficiente | | **20% - 30%** | Excelente | Empresa de alta qualidade | | **> 30%** | Excepcional | Verificar sustentabilidade e alavancagem | ### Cuidado com ROE Extremo ``` ⚠️ ROE MUITO ALTO (> 40%) - INVESTIGUE: 1. Alta alavancagem? → Patrimônio baixo infla ROE 2. Lucro não-recorrente? → Venda de ativos, ganhos únicos 3. Patrimônio negativo? → ROE não faz sentido 4. Manipulação contábil? → Ajustes agressivos ✅ ROE SUSTENTÁVEL: - Consistente ao longo dos anos - Sem alavancagem excessiva - Baseado em operações recorrentes ``` ## Calculando ROE com brapi.dev Veja como calcular e analisar o ROE usando a [API brapi.dev](https://brapi.dev): **Consulta de dados fundamentalistas:** ```typescript const tickers = ['WEGE3', 'ITUB4', 'PETR4', 'VALE3', 'MGLU3', 'RENT3', 'RADL3']; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(',')}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); ``` ### Análise de ROE - Principais Ações Brasileiras | Ticker | Empresa | ROE | Status | Dív/PL | Margem Líq | | ------ | -------------- | ------ | ------------ | ------ | ---------- | | WEGE3 | WEG S.A. | 28,5% | 🌟 Excelente | 0,25 | 18,2% | | ITUB4 | Itaú Unibanco | 18,2% | ✅ Bom | 2,50 | 22,5% | | RENT3 | Localiza | 19,5% | ✅ Bom | 1,80 | 12,3% | | RADL3 | Raia Drogasil | 16,8% | ✅ Bom | 0,45 | 4,2% | | PETR4 | Petrobras | 25,2% | 🌟 Excelente | 0,65 | 28,5% | | VALE3 | Vale | 22,8% | 🌟 Excelente | 0,35 | 32,1% | | MGLU3 | Magazine Luiza | -12,5% | ❌ Negativo | 2,50 | -2,5% | ### Classificação do ROE | ROE | Classificação | Status | | ------ | ----------------------- | ------ | | \< 5% | Muito Baixo | ❌ | | 5-10% | Baixo | ⚠️ | | 10-15% | Moderado | ✓ | | 15-20% | Bom | ✅ | | 20-30% | Excelente | 🌟 | | > 30% | Excepcional (verificar) | 🔍 | > **Alerta:** ROE > 25% com Dív/PL > 2 pode estar inflado por alta alavancagem. ### Comparando ROE por Setor **Setor Bancos** (ROE médio: 17,5%) | Ticker | ROE | Preço | P/L | | ------ | ----- | -------- | --- | | ITUB4 | 18,5% | R$ 32,50 | 8,2 | | BBDC4 | 14,2% | R$ 12,80 | 6,5 | | BBAS3 | 20,8% | R$ 28,40 | 4,8 | | SANB11 | 12,5% | R$ 25,60 | 7,2 | **Setor Energia** (ROE médio: 14,2%) | Ticker | ROE | Preço | P/L | | ------ | ----- | -------- | ---- | | EQTL3 | 18,2% | R$ 32,10 | 12,5 | | TAEE11 | 22,5% | R$ 35,80 | 8,2 | | CMIG4 | 15,8% | R$ 12,40 | 5,8 | | ELET3 | 12,1% | R$ 42,50 | 9,5 | **Setor Tecnologia** (ROE médio: 24,5%) | Ticker | ROE | Preço | P/L | | ------ | ----- | -------- | ---- | | WEGE3 | 28,5% | R$ 52,30 | 32,5 | | TOTS3 | 22,1% | R$ 28,40 | 18,2 | | LWSA3 | 15,2% | R$ 4,50 | -8,5 | > **Dica:** Compare o ROE de uma empresa sempre com seus pares do mesmo setor. ### Screener por ROE **Critérios de filtro:** * ROE mínimo: 15% * Dívida/PL máximo: 1,5 **Resultado do screener:** | Ticker | Empresa | ROE | Dív/PL | P/L | DY | | ------ | ------------- | ----- | ------ | ---- | ---- | | WEGE3 | WEG S.A. | 28,5% | 0,25 | 32,5 | 1,2% | | PRIO3 | PRIO | 35,2% | 0,45 | 5,8 | 0,0% | | TAEE11 | Taesa | 22,5% | 1,20 | 8,2 | 8,5% | | EQTL3 | Equatorial | 18,2% | 1,35 | 12,5 | 2,8% | | RENT3 | Localiza | 19,5% | 1,45 | 15,8 | 2,2% | | RADL3 | Raia Drogasil | 16,8% | 0,45 | 42,5 | 0,8% | > **Nota:** Ações com ROE alto e endividamento baixo tendem a ser negócios mais seguros e sustentáveis. ## Fórmula DuPont: Desmembrando o ROE A **Fórmula DuPont** decompõe o ROE em três componentes, revelando a origem da rentabilidade. ### DuPont de 3 Fatores ``` ROE = Margem Líquida × Giro do Ativo × Alavancagem Onde: - Margem Líquida = Lucro Líquido / Receita (eficiência operacional) - Giro do Ativo = Receita / Ativo Total (uso de ativos) - Alavancagem = Ativo Total / Patrimônio Líquido (uso de dívida) ``` ### Análise DuPont **Decomposição DuPont de empresas brasileiras:** | Empresa | ROE | Margem Líq | Giro Ativo | Alavancagem | | ------- | ------ | ---------- | ---------- | ----------- | | WEGE3 | 28,5% | 18,2% | 1,05x | 1,50x | | ITUB4 | 18,2% | 22,5% | 0,08x | 10,2x | | PETR4 | 25,2% | 28,5% | 0,55x | 1,60x | | MGLU3 | -12,5% | -2,5% | 1,85x | 2,70x | **Interpretação dos componentes:** | Componente | Alto | Adequado | Baixo | | -------------- | ---------------------- | -------- | ------------ | | Margem Líquida | > 15% (poder de preço) | 8-15% | \< 8% | | Giro do Ativo | > 1,5x (eficiência) | 0,8-1,5x | \< 0,8x | | Alavancagem | \< 2x (conservador) | 2-4x | > 4x (risco) | **Análise por empresa:** * **WEGE3:** ✅ Alta margem + ✅ Giro adequado + ✅ Baixa alavancagem → ROE sustentável * **ITUB4:** ✅ Alta margem + ⚠️ Baixo giro + ❌ Alta alavancagem → Normal para bancos * **PETR4:** ✅ Alta margem + ✓ Giro moderado + ✅ Baixa alavancagem → ROE sólido * **MGLU3:** ❌ Margem negativa + ✅ Alto giro + ⚠️ Alavancagem moderada → Problema estrutural ### Padrões DuPont por Modelo de Negócio | Modelo de Negócio | Margem | Giro | Alavancagem | Exemplo | | ----------------- | -------- | -------- | ----------- | -------------------------- | | **Luxo/Premium** | Alta | Baixo | Baixa | Joalherias, marcas premium | | **Varejo Volume** | Baixa | Alto | Moderada | Supermercados, atacarejos | | **Bancos** | Moderada | Baixo | Muito Alta | Bancos, seguradoras | | **Indústria** | Moderada | Moderado | Moderada | Manufatura geral | | **Tecnologia** | Alta | Alto | Baixa | Software, SaaS | ## ROE vs ROIC: Qual Usar? ### Diferença Fundamental ``` ROE = Lucro Líquido / Patrimônio Líquido → Retorno para o ACIONISTA → Considera dívida (alavancagem) ROIC = NOPAT / Capital Investido → Retorno para TODOS os provedores de capital → Exclui efeito da dívida (mais "puro") Onde: - NOPAT = Lucro Operacional × (1 - Alíquota IR) - Capital Investido = Patrimônio Líquido + Dívida Líquida ``` ### Quando Usar Cada Um | Situação | Use ROE | Use ROIC | | ----------------------------------- | ------- | -------- | | Comparar empresas similares | ✅ | ✅ | | Empresas com dívida muito diferente | ❌ | ✅ | | Avaliar eficiência de capital | ✓ | ✅ | | Ver retorno para acionista | ✅ | ❌ | | Empresas muito alavancadas | ❌ | ✅ | ### Calculando ROIC **Comparativo ROE vs ROIC:** | Ticker | ROE | ROA | ROIC (aprox) | D/E | Análise | | ------ | ----- | ----- | ------------ | ---- | ------------------------ | | WEGE3 | 28,5% | 19,2% | 20,8% | 0,25 | Baixa alavancagem | | ITUB4 | 18,2% | 1,8% | 2,9% | 2,50 | Benefício da alavancagem | | RENT3 | 19,5% | 5,2% | 7,8% | 1,80 | Alavancagem moderada | **Fórmula ROIC simplificada:** ROIC ≈ ROA × (1 + D/E × (1 - taxa IR)) Onde taxa IR ≈ 34% no Brasil **Interpretação:** * **ROIC \< ROE:** Empresa se beneficia da alavancagem financeira * **ROIC ≈ ROE:** Opera com baixa ou nenhuma alavancagem * Prefira empresas com ROIC > WACC (custo de capital) ## ROE Histórico: Consistência é Chave Um ROE alto em um único ano não significa muito. A **consistência** é o que importa. ### Analisando ROE Histórico **Consistência do ROE ao longo dos anos (dados ilustrativos):** | Ticker | ROE Médio | Mín | Máx | Anos > 15% | Tendência 3a | Consistência | | ------ | --------- | ------ | ----- | ---------- | ------------ | ------------------------- | | WEGE3 | 27,8% | 25,2% | 30,1% | 6/6 | +4,9% | 🌟 Muito Consistente | | ITUB4 | 17,7% | 16,8% | 18,5% | 6/6 | -0,6% | ✅ Consistente | | MGLU3 | 8,2% | -25,3% | 35,2% | 3/6 | -40,5% | ❌ Muito Variável | | VALE3 | 26,6% | 12,5% | 45,2% | 5/6 | +2,7% | ⚠️ Moderadamente Variável | **Classificação de consistência:** | Coef. Variação | ROE Mínimo | Classificação | | -------------- | ---------- | ------------------------- | | \< 15% | ≥ 12% | 🌟 Muito Consistente | | \< 25% | ≥ 8% | ✅ Consistente | | \< 40% | Qualquer | ⚠️ Moderadamente Variável | | ≥ 40% | Qualquer | ❌ Muito Variável | > **Insight:** Empresas com ROE consistentemente alto por 5+ anos geralmente possuem vantagens competitivas duráveis (moats). ``` ## ROE por Setor: Referências Brasileiras Cada setor tem características de ROE diferentes. ### Médias por Setor (Brasil) | Setor | ROE Típico | Observação | |-------|------------|------------| | **Bancos** | 15-22% | Alta alavancagem natural | | **Seguradoras** | 15-25% | Float de prêmios | | **Energia Elétrica** | 10-18% | Regulado, estável | | **Saneamento** | 8-15% | Regulado, ativos pesados | | **Varejo** | 8-20% | Alta variabilidade | | **Tecnologia** | 15-35% | Asset-light, alto retorno | | **Commodities** | 10-25% | Muito cíclico | | **Construção** | 8-15% | Cíclico, capital intensivo | | **Saúde** | 12-20% | Defensivo | **Comparativo ROE vs Média do Setor:** | Ticker | Setor | ROE Empresa | ROE Setor | Diferença | Avaliação | |--------|-------|-------------|-----------|-----------|-----------| | WEGE3 | Industrials | 28,5% | 15,0% | +13,5% | 🌟 Muito acima | | ITUB4 | Financial | 18,2% | 18,0% | +0,2% | ✓ Alinhado | | PETR4 | Energy | 25,2% | 18,0% | +7,2% | ✅ Acima | | MGLU3 | Consumer Cyclical | -12,5% | 12,0% | -24,5% | ❌ Muito abaixo | | RADL3 | Healthcare | 16,8% | 16,0% | +0,8% | ✓ Alinhado | **ROE médio por setor (referência Brasil):** | Setor | ROE Médio | |-------|-----------| | Financial Services | 18% | | Technology | 22% | | Energy | 18% | | Healthcare | 16% | | Industrials | 15% | | Consumer Defensive | 14% | | Consumer Cyclical | 12% | | Utilities | 12% | | Communication | 12% | | Real Estate | 10% | ``` ## ROE e Valuation: Combinação Poderosa ### ROE Alto + P/L Baixo = Oportunidade? **Critérios de busca:** * ROE > 15% * P/L entre 5 e 15 **Oportunidades encontradas (Score = ROE / P/L):** | Ticker | Empresa | ROE | P/L | DY | Score | | ------ | --------------- | ----- | ---- | ----- | ----- | | BBAS3 | Banco do Brasil | 20,8% | 4,8 | 8,5% | 4,33 | | PRIO3 | PRIO | 35,2% | 5,8 | 0,0% | 6,07 | | TAEE11 | Taesa | 22,5% | 8,2 | 8,5% | 2,74 | | PETR4 | Petrobras | 25,2% | 5,2 | 12,5% | 4,85 | | CMIG4 | Cemig | 15,8% | 5,8 | 6,2% | 2,72 | | VIVT3 | Vivo | 16,5% | 12,5 | 4,8% | 1,32 | > **Interpretação do Score:** Quanto maior o score (ROE/P/L), mais "barata" está a qualidade da empresa. Score > 2 geralmente indica oportunidade interessante. ``` ### Fórmula de Graham Modificada com ROE **Fórmula de Graham:** Preço Justo = √(22,5 × LPA × VPA) **Ajuste por ROE:** Fator = 1 + (ROE - 15%) / 100 Empresas com ROE acima de 15% justificam prêmio; abaixo, desconto. **Valuation com ROE:** | Ticker | Preço Atual | ROE | Preço Graham | Preço Ajustado | Margem Segurança | |--------|-------------|-----|--------------|----------------|------------------| | ITUB4 | R$ 32,50 | 18,2% | R$ 38,20 | R$ 39,42 | +17,5% | | BBAS3 | R$ 28,40 | 20,8% | R$ 35,80 | R$ 37,87 | +26,1% | | WEGE3 | R$ 52,30 | 28,5% | R$ 48,50 | R$ 55,05 | -7,3% | | TAEE11 | R$ 35,80 | 22,5% | R$ 42,20 | R$ 45,37 | +17,9% | **Interpretação:** - **Margem positiva:** Ação pode estar subvalorizada - **Margem negativa:** Ação pode estar sobrevalorizada (ou ROE alto justifica prêmio) ## Erros Comuns na Análise de ROE ### ❌ Erros a Evitar ``` ┌─────────────────────────────────────────────────────────────┐ │ ERROS COMUNS NA ANÁLISE DE ROE │ ├─────────────────────────────────────────────────────────────┤ │ │ │ 1. ❌ Ignorar a alavancagem │ │ → ROE alto por dívida excessiva é arriscado │ │ │ │ 2. ❌ Comparar setores diferentes │ │ → Bancos têm ROE diferente de varejo │ │ │ │ 3. ❌ Olhar apenas um período │ │ → ROE pode variar muito entre anos │ │ │ │ 4. ❌ Ignorar patrimônio negativo │ │ → ROE não faz sentido se PL for negativo │ │ │ │ 5. ❌ Não ajustar por itens não-recorrentes │ │ → Venda de ativos pode inflar ROE temporariamente │ │ │ │ 6. ❌ Esquecer da qualidade do lucro │ │ → Lucro contábil ≠ geração de caixa │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ## Conclusão O **ROE** é fundamental para identificar empresas de qualidade: 1. **ROE > 15%** geralmente indica empresa eficiente 2. **Consistência** é mais importante que ROE alto em um ano 3. **Use a análise DuPont** para entender a fonte do ROE 4. **Compare com o setor** - cada setor tem ROE típico diferente 5. **Cuidado com alta alavancagem** inflando o ROE 6. **Combine com P/L** para encontrar oportunidades A [API brapi.dev](https://brapi.dev) fornece todos os dados necessários para calcular e analisar o ROE de forma automatizada. ## Próximos Passos 1. 📖 Aprenda sobre o [indicador P/L](/blog/entendendo-indicador-preco-lucro-pl-analise-fundamentalista) 2. 📊 Descubra [como calcular o Preço Teto](/blog/preco-teto-acao-como-calcular) 3. 🎯 Entenda [Value Investing](/blog/value-investing-como-encontrar-acoes-baratas) 4. 🚀 Crie sua conta na [brapi.dev](https://brapi.dev) e comece a analisar ações --- *Disclaimer: Este artigo tem fins educacionais. Investimentos em ações envolvem riscos. Consulte um assessor de investimentos antes de tomar decisões financeiras.* ``` # ROIC vs ROE: A Batalha da Eficiência em 2026 URL: /blog/roic-roe-analise-fundamentalista-2026.mdx Entenda a diferença entre ROIC e ROE e por que o Retorno sobre Capital Investido é a métrica mais importante para 2026. *** searchable: true title: 'ROIC vs ROE: A Batalha da Eficiência em 2026' description: 'Entenda a diferença entre ROIC e ROE e por que o Retorno sobre Capital Investido é a métrica mais importante para 2026.' date: '2025-12-26' keywords: 'roic vs roe, analise fundamentalista 2026, eficiencia operacional, wege3 roic, rentabilidade empresas, custo de capital' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Análise Fundamentalista' readingTime: '10 min' tags: \['ROIC', 'ROE', 'Eficiência', 'Fundamentalista', 'Indicadores'] relatedPosts: \['wege3-analise-crescimento-2026', 'entendendo-indicador-preco-lucro-pl-analise-fundamentalista', 'como-calcular-o-roic-usando-a-api-da-brapi'] featured: false expertise: 'Guia técnico sobre indicadores de rentabilidade para investidores exigentes.' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; Em 2026, com o custo de capital (juros) ainda exigindo atenção, investir em empresas ineficientes é um "pecado capital". Para separar as empresas que destroem valor das que criam riqueza, você precisa dominar duas siglas: **ROE** e **ROIC**. Muitos investidores olham apenas para o ROE. Mas será que ele conta a história toda? Neste artigo, vamos explicar por que o **ROIC** é o verdadeiro rei da eficiência. *** ## O que é ROE (Return on Equity)? O **Retorno sobre o Patrimônio Líquido** mede quanto lucro a empresa gera para cada real que o acionista (você) investiu. **ROE = Lucro Líquido / Patrimônio Líquido** * **O que indica:** A rentabilidade do acionista. * **A Pegadinha:** O ROE pode ser "turbinado" artificialmente com dívida. Se uma empresa toma muito empréstimo (aumenta o passivo) e reduz o patrimônio líquido (recomprando ações, por exemplo), o ROE sobe, mesmo que a operação não tenha melhorado. * **Exemplo:** Bancos adoram ROE. É a métrica padrão para eles (vide **ITUB4** e **BBAS3**). ## O que é ROIC (Return on Invested Capital)? O **Retorno sobre o Capital Investido** mede quanto dinheiro a empresa gera (operacionalmente) em relação a **todo** o capital investido no negócio (seja dinheiro dos sócios ou de dívida bancária). **ROIC = NOPAT (Lucro Operacional - Impostos) / (Capital Próprio + Dívida Onerosa)** * **O que indica:** A qualidade da operação da empresa, independente de como ela é financiada. * **A Verdade:** O ROIC mostra se a "máquina" da empresa é boa. Se o ROIC for maior que o custo da dívida e o custo de capital, a empresa cria valor. Se for menor, ela destrói valor, mesmo que dê lucro contábil. * **Exemplo:** Indústrias e Varejo (**WEGE3**, **LREN3**) devem ser analisadas pelo ROIC. *** ## ROE vs ROIC: Qual usar em 2026? No cenário de 2026: 1. **Use ROE para:** Bancos, Seguradoras e empresas Asset Light (poucos ativos físicos). 2. **Use ROIC para:** Indústria, Varejo, Utilities, Agro e qualquer empresa que precise de máquinas, fábricas ou estoques. ### A Regra de Ouro (Spread de Valor) O que importa não é o número absoluto, mas a diferença (**Spread**) entre o ROIC e o WACC (Custo Médio Ponderado de Capital). * **ROIC (15%) > WACC (12%):** A empresa cria valor. O preço da ação tende a subir no longo prazo. * **ROIC (10%) \< WACC (12%):** A empresa destrói valor. Quanto mais ela cresce, mais pobre o acionista fica. *** ## Como Calcular com Python e brapi Não confie apenas nos sites. Calcule você mesmo. ```typescript const response = await fetch( 'https://brapi.dev/api/quote/WEGE3?modules=defaultKeyStatistics,financialData', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const { results } = await response.json() const { returnOnEquity, returnOnAssets } = results[0].financialData ?? {} ``` ### Interpretação do ROIC | ROIC | Interpretação | | -------- | ------------------------------------------- | | > 15% | Empresa de Alta Qualidade (Quality) | | 8% - 15% | Aceitável - avaliar tendência | | \< 8% | Alerta: A empresa cobre o custo de capital? | *** ## Conclusão Em 2026, ignore empresas alavancadas com ROIC baixo. Procure as "campeãs de eficiência" — empresas como **WEG**, **Prio** e **Raia Drogasil** — que historicamente mantêm um ROIC alto consistentemente. São essas que sobrevivem a qualquer crise. *** ## Leia Mais * **[WEG: A Campeã de ROIC](/blog/wege3-analise-crescimento-2026)** * **[Entendendo Valuation](/blog/valuation-dcf-multiplos-guia-completo-2026)** # RWA (Real World Assets): A Revolução da Tokenização de Ativos em 2026 URL: /blog/rwa-real-world-assets-tokenizacao-guia-2026.mdx Entenda RWAs (Real World Assets): tokenização de imóveis, títulos públicos e crédito privado transformando o mercado ✓ *** searchable: true title: 'RWA (Real World Assets): A Revolução da Tokenização de Ativos em 2026' description: 'Entenda RWAs (Real World Assets): tokenização de imóveis, títulos públicos e crédito privado transformando o mercado ✓' date: '2026-01-02' keywords: 'rwa cripto, real world assets, tokenização de ativos, rwa blackrock, tokenização imóveis brasil, ondo finance, centrifuge' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Criptomoedas' readingTime: '18 min' tags: \['RWA', 'Tokenização', 'Investimentos', 'BlackRock', 'DeFi', 'Mercado Financeiro'] relatedPosts: \['defi-financas-descentralizadas-guia-iniciantes-2026', 'stablecoins-brasil-usdt-brz-drex-guia-2026', 'ethereum-eth-guia-completo-brasil-2026'] featured: true expertise: 'Análise profunda sobre a convergência entre mercado financeiro tradicional e blockchain' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; Se 2021 foi o ano dos NFTs e 2024 o ano do Bitcoin institucional (ETFs), **2026 e 2026 são, indiscutivelmente, os anos dos RWAs (Real World Assets)**. RWA, ou **Ativos do Mundo Real**, refere-se à tokenização de ativos tangíveis e intangíveis tradicionais — como imóveis, títulos do tesouro, crédito privado, commodities e até obras de arte — colocando-os na blockchain. Não é apenas uma tendência cripto; é a aposta de trilhões de dólares de gigantes como **BlackRock, Franklin Templeton e Citi**. Neste guia, você entenderá o que são RWAs, por que eles são o "Santo Graal" da integração institucional e como você pode investir nessa tese. *** ## O Que São RWAs (Real World Assets)? RWAs são tokens digitais em uma blockchain (geralmente Ethereum, Polygon ou Avalanche) que representam a propriedade ou direitos sobre um ativo fora da cadeia (off-chain). ### A Ponte entre TradFi e DeFi ``` ┌─────────────────────────────────────────────────────────────────┐ │ A CONVERGÊNCIA (RWA) │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ MUNDO TRADICIONAL (TradFi) BLOCKCHAIN (DeFi) │ │ ┌─────────────────────┐ ┌─────────────────────┐ │ │ │ 🏢 Imóveis │ │ ⛓️ Liquidez Global │ │ │ │ 📜 Títulos Públicos │ RWA │ 🕒 Negociação 24/7 │ │ │ │ 💰 Crédito Privado │ ───────▶ │ 🧩 Fracionamento │ │ │ │ 🌽 Commodities │ │ 🤖 Automação │ │ │ └─────────────────────┘ └─────────────────────┘ │ │ │ │ Benefícios: │ │ • Eficiência Operacional (menos intermediários) │ │ • Transparência e Rastreabilidade │ │ • Acesso Democratizado (fração de ativos caros) │ │ • Liquidez Instantânea (potencialmente) │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` ### Por Que Agora? 1. **Juros Altos (High Yield):** Com as taxas de juros globais elevadas nos últimos anos, o DeFi (que oferecia yields insustentáveis) perdeu atratividade. Investidores cripto começaram a demandar o rendimento "seguro" dos títulos do Tesouro Americano (T-Bills) on-chain. 2. **Entrada Institucional:** Grandes bancos perceberam que a infraestrutura blockchain é mais eficiente que os sistemas legados de liquidar transações (T+2 vs T+0). 3. **Clareza Regulatória:** Sandbox regulatórios (como o do Banco Central do Brasil) permitiram testes seguros. *** ## Principais Setores de RWA ### 1. Títulos do Tesouro (Treasuries) É o maior setor de RWA atualmente. Protocolos tokenizam dívida governamental de curto prazo dos EUA. * **Como funciona:** Você deposita Stablecoins (USDC/USDT) e recebe um token que rende juros atrelados à taxa do Fed. * **Principais Players:** BlackRock (Fundo BUIDL), Franklin Templeton (FOBXX), Ondo Finance (OUSG), OpenEden. ### 2. Crédito Privado Empréstimos para empresas do mundo real usando liquidez cripto. * **Exemplo:** Uma fintech no Brasil precisa de capital para emprestar a PMEs. Ela toma empréstimo em USDC via protocolo DeFi (como Centrifuge ou Goldfinch) pagando juros aos investidores cripto. * **Vantagem:** Retornos geralmente maiores que títulos públicos (10-15% a.a. em dólar), mas com maior risco de inadimplência. ### 3. Imóveis (Real Estate) Fracionamento de propriedades. Em vez de comprar um apartamento de R$ 1 milhão, você compra 1 token de R$ 100 que representa 0,01% do imóvel e recebe aluguéis proporcionais. * **No Brasil:** Plataformas como **Netspaces** e iniciativas em Sandbox da CVM já exploram isso. * **Globalmente:** RealT (imóveis nos EUA). ### 4. Commodities e Outros * **Ouro:** Paxos Gold (PAXG) e Tether Gold (XAUT) são RWAs clássicos. Cada token é lastreado por uma onça de ouro em cofre. * **Créditos de Carbono:** Tokenização para tornar o mercado de compensação mais transparente (Toucan, KlimaDAO). *** ## O Efeito BlackRock (BUIDL) Em 2024, a BlackRock (maior gestora de ativos do mundo) lançou seu fundo tokenizado na rede Ethereum, o **BUIDL**. > *"Acredito que a próxima geração para os mercados, a próxima geração para os títulos, será a tokenização dos títulos."* — **Larry Fink, CEO da BlackRock**. Isso validou a tese para todo o mercado. Não é mais "dinheiro de internet", é a infraestrutura do futuro mercado de capitais. *** ## Principais Protocolos e Tokens RWA para 2026 Se você quer exposição a essa tese, estes são os principais projetos de infraestrutura e emissão: | Protocolo | Ticker | Foco Principal | Blockchain | | ---------------- | ------ | ------------------------------------ | ------------------------- | | **Ondo Finance** | ONDO | Títulos do Tesouro EUA, Yield | Ethereum, Solana, Mantle | | **Centrifuge** | CFG | Infraestrutura para Crédito Privado | Polkadot (Parachain), Eth | | **Chainlink** | LINK | Interoperabilidade (CCIP) e Oráculos | Multi-chain | | **MakerDAO** | MKR | DAI Stablecoin lastreada em RWA | Ethereum | | **Avalanche** | AVAX | Blockchain focada em Subnets RWA | Layer 1 | | **Pendle** | PENDLE | Trading de Yield (incluindo RWA) | Ethereum, Arbitrum | | **Goldfinch** | GFI | Crédito para Mercados Emergentes | Ethereum | ### Destaque: Chainlink (CCIP) Para que RWAs funcionem, os bancos precisam falar com as blockchains. O **CCIP (Cross-Chain Interoperability Protocol)** da Chainlink é a "internet dos contratos", conectando o sistema Swift bancário às redes blockchain. É uma peça fundamental de infraestrutura. *** ## RWA no Brasil: O Drex e o Sandbox O Brasil está na vanguarda global dos RWAs, impulsionado pelo Banco Central. ### Drex (Real Digital) O **Drex** não é apenas uma criptomoeda, é uma plataforma de liquidação de ativos tokenizados. * **Objetivo:** Permitir a troca simultânea (DvP - Delivery versus Payment) de ativos. Ex: Você transfere o Drex (dinheiro) e recebe o token do carro ou imóvel no mesmo segundo, sem cartório intermediário (smart contracts). ### CVM e Sandbox A Comissão de Valores Mobiliários (CVM) tem aprovado diversas iniciativas de tokenização de recebíveis, precatórios e cotas de consórcio. Empresas como **Liqi, Vórtx e MB (Mercado Bitcoin)** são ativas nesse setor. **Simulação: Rendimento de Token RWA (T-Bills americanos)** | Parâmetro | Valor | | --------------- | ------------------ | | Investimento | $1.000 USDC | | Taxa APY | 5,0% a.a. | | Período | 5 anos | | **Saldo Final** | **$1.276,28 USDC** | | **Lucro** | **$276,28 USDC** | **Fórmula de juros compostos:** ``` Montante = Principal × (1 + Taxa)^Período Montante = $1.000 × (1,05)^5 = $1.276,28 ``` > **Vantagem RWA:** Diferente da Renda Fixa tradicional, a liquidez em RWA pode ser 24/7 em mercados secundários DeFi. *** ## Riscos dos RWAs Nem tudo são flores. RWAs introduzem riscos que não existem no DeFi puro (on-chain): 1. **Risco de Custódia Física:** Se o ouro sumir do cofre ou o prédio pegar fogo, o token vale zero? É necessária auditoria e seguro off-chain. 2. **Risco Regulatório:** Se a SEC ou CVM decidir que o token é ilegal, a emissora pode congelar os ativos (recurso de "blacklist" nos contratos). 3. **Risco de Contraparte:** Você depende da empresa (ex: Circle, BlackRock, Ondo) honrar o resgate. Não é "trustless" como o Bitcoin. 4. **KYC/AML:** A maioria dos protocolos RWA sérios exige Identificação (Know Your Customer), o que remove o anonimato do DeFi. *** ## Como Investir em RWA em 2026? 1. **Tokens de Governança:** Comprar tokens dos protocolos que facilitam RWAs (ex: ONDO, CFG, LINK, MKR). Você aposta no crescimento da plataforma. 2. **Ativos Tokenizados (Investidor Qualificado):** Em muitas jurisdições, comprar o token do título do tesouro direto exige ser investidor qualificado/profissional. 3. **Plataformas Brasileiras:** Corretoras locais (MB, Liqi) oferecem tokens de renda fixa (consórcios, precatórios) acessíveis ao varejo, com isenção de IR para vendas até R$ 35k (regra geral cripto). *** ## Conclusão RWAs representam a fase adulta do mercado cripto. É onde a tecnologia blockchain deixa de ser um cassino especulativo e se torna a infraestrutura global de valores. Para 2026, espera-se que trilhões de dólares migrem para trilhos on-chain. Para o investidor, é uma oportunidade de diversificar: ter a segurança de ativos reais com a eficiência e liquidez da tecnologia cripto. *** ## Recursos Adicionais * **[DeFi para Iniciantes](/blog/defi-financas-descentralizadas-guia-iniciantes-2026)** * **[Stablecoins e Drex](/blog/stablecoins-brasil-usdt-brz-drex-guia-2026)** * **[Chainlink e Oráculos (Em Breve)](/blog/chainlink-ccip-guia-completo)** *Disclaimer: Investimentos em criptoativos e tokens envolvem riscos. RWAs dependem de emissores centralizados. Faça sua própria pesquisa.* # O que é Selic e CDI: Guia Definitivo para Iniciantes (2026) URL: /blog/selic-cdi-guia-iniciantes-2026.mdx Entenda de uma vez por todas o que é Taxa Selic, CDI e como eles afetam seu dinheiro. Aprenda a calcular rendimentos de 100% do CDI em 2026. *** searchable: true title: 'O que é Selic e CDI: Guia Definitivo para Iniciantes (2026)' description: 'Entenda de uma vez por todas o que é Taxa Selic, CDI e como eles afetam seu dinheiro. Aprenda a calcular rendimentos de 100% do CDI em 2026.' date: '2025-12-25' keywords: 'o que é selic, o que é cdi, rendimento 100% cdi hoje, selic vs cdi, taxa selic 2026, quanto rende 1000 reais no cdi' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Renda Fixa' readingTime: '8 min' tags: \['Selic', 'CDI', 'Renda Fixa', 'Investimentos', 'Iniciantes'] relatedPosts: \['reserva-de-emergencia-guia-completo-2026', 'onde-investir-2026-guia-completo-melhores-investimentos', 'como-calcular-rendimento-investimentos-guia-completo-2026'] featured: false expertise: 'Conceitos básicos de macroeconomia e renda fixa explicados de forma simples' lastReviewed: '2026-02-08' -------------------------- import { Authors, Author } from '~/components/Authors'; Você abre o app do banco e vê: *"Rende 100% do CDI"*. Liga a TV e ouve: *"Copom mantém a Selic em X%"*. Se você não sabe o que essas siglas significam, você está investindo no escuro. Em 2026, entender Selic e CDI é o básico para não deixar dinheiro na mesa. Vamos traduzir o "economês". *** ## 1. O que é a Taxa Selic? A Selic é a **Taxa Básica de Juros** da economia brasileira. Ela é a "mãe de todas as taxas". * **Quem define?** O Banco Central (Copom), a cada 45 dias. * **Para que serve?** Para controlar a inflação. * **Inflação alta?** O BC **sobe** a Selic para frear o consumo. (Crédito fica caro, pessoas compram menos). * **Economia parada?** O BC **baixa** a Selic para estimular. (Crédito barato, pessoas compram mais). * **Onde investir?** No **Tesouro Selic**. Ele paga exatamente a variação dessa taxa. *** ## 2. O que é o CDI? CDI significa **Certificado de Depósito Interbancário**. É a taxa de juros que os bancos cobram para emprestar dinheiro **uns para os outros**. * **Por que existe?** Por regra do Banco Central, nenhum banco pode fechar o dia com caixa negativo. Se o Banco A teve mais saques que depósitos hoje, ele pega dinheiro emprestado com o Banco B para fechar o caixa. * **Quanto vale?** O CDI anda de mãos dadas com a Selic. Historicamente, o CDI é **0,10 ponto percentual abaixo da Selic Meta**. * Exemplo: Se a Selic Meta é **10,75%**, o CDI será aproximadamente **10,65%**. > **Resumo:** Selic é juros do Governo. CDI é juros dos Bancos. Na prática, para você investidor, são quase iguais. *** ## Quanto rende "100% do CDI"? Quando um CDB ou conta digital diz que rende "100% do CDI", significa que ele paga integralmente essa taxa. ### Calculadora Rápida (Exemplo 2026) Suponha que o CDI esteja em **10,0% ao ano**. * **100% do CDI:** Rende 10,0% a.a. * **110% do CDI:** Rende 11,0% a.a. (10 \* 1,10). * **Poupança:** Rende \~6,17% a.a. + TR (bem menos que o CDI). ### Imposto de Renda Lembre-se que CDBs têm IR regressivo sobre o lucro: * Até 6 meses: 22,5% * 6 meses a 1 ano: 20% * 1 a 2 anos: 17,5% * Acima de 2 anos: 15% Mesmo descontando o IR, um investimento de **100% do CDI** quase sempre ganha da Poupança. *** ## Conclusão Não tenha medo das siglas. * **Selic** = Taxa do país. * **CDI** = Taxa do seu investimento no banco. Em 2026, fuja de qualquer investimento de renda fixa que pague **menos que 100% do CDI** (exceto se for isento de IR como LCI/LCA, onde 85-90% do CDI pode valer a pena). Isso é o mínimo que seu dinheiro merece. # Setor de Seguros em 2026: BBSE3, CXSE3 ou PSSA3? URL: /blog/setor-seguros-bbse3-cxse3-pssa3-analise-2026.mdx Seguradoras são a melhor defesa para sua carteira em 2026? Comparativo entre BB Seguridade, Caixa Seguridade e Porto Seguro. *** searchable: true title: 'Setor de Seguros em 2026: BBSE3, CXSE3 ou PSSA3?' description: 'Seguradoras são a melhor defesa para sua carteira em 2026? Comparativo entre BB Seguridade, Caixa Seguridade e Porto Seguro.' date: '2025-12-31' keywords: 'setor de seguros 2026, bbse3 dividendos, cxse3 vale a pena, pssa3 crescimento, porto seguro, caixa seguridade, ações defensivas' author: 'Equipe brapi.dev' category: 'Ações' subcategory: 'Setores' readingTime: '13 min' tags: \['Seguros', 'BBSE3', 'CXSE3', 'PSSA3', 'Dividendos', 'Defensivas'] relatedPosts: \['onde-investir-2026-guia-completo-melhores-investimentos', 'melhores-acoes-setor-eletrico-2026-dividendos-taee11-trpl4', 'acoes-bancos-analise-setorial-2026'] featured: false expertise: 'Análise comparativa das principais seguradoras listadas na bolsa brasileira para renda e proteção.' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; Se existe um setor que dorme tranquilo enquanto o mercado pega fogo, é o de **Seguros**. As seguradoras ganham dinheiro de duas formas: 1. **Resultado Operacional:** A diferença entre os prêmios recebidos e os sinistros pagos. 2. **Resultado Financeiro:** O dinheiro dos prêmios fica investido (o "float") rendendo juros até que (talvez) um sinistro ocorra. Em um Brasil de juros estruturalmente altos (mesmo com quedas pontuais da Selic), as seguradoras são máquinas de imprimir dinheiro. Para 2026, analisamos as três principais: **BB Seguridade (BBSE3)**, **Caixa Seguridade (CXSE3)** e **Porto (PSSA3)**. *** ## 1. BB Seguridade (BBSE3): A Rainha do Agro Braço de seguros do Banco do Brasil. * **Onde ganha dinheiro:** Fortíssima em seguro rural (Agro), prestamista e vida. * **Vantagem Competitiva:** Usa o balcão do Banco do Brasil (maior financiador do agro) para vender seguros com custo de aquisição (CAC) quase zero. * **Cenário 2026:** Se o Agro vai bem, BBSE3 vai bem. O risco é o clima (El Niño), que pode aumentar sinistros rurais. * **Perfil:** Vaca Leiteira (Cash Cow). Dividendos gordos e previsíveis. ## 2. Caixa Seguridade (CXSE3): A Rainha do Habitacional Braço de seguros da Caixa Econômica Federal. * **Onde ganha dinheiro:** Seguro habitacional (obrigatório em financiamentos) e prestamista. * **Vantagem Competitiva:** A Caixa domina o mercado imobiliário brasileiro. Contratos de longuíssimo prazo (quem financia casa por 30 anos paga seguro por 30 anos). * **Cenário 2026:** Beneficiada direta do "Minha Casa Minha Vida" e novos ciclos imobiliários. Sinistralidade baixíssima no habitacional. * **Perfil:** Crescimento contratado + Dividendos. Uma das teses mais seguras da bolsa. ## 3. Porto (PSSA3): A Diversificada Antiga Porto Seguro. * **Onde ganha dinheiro:** Auto (carro) é o carro-chefe, mas cresceu muito em Saúde, Serviços e Banco (Cartões). * **Vantagem Competitiva:** Marca premium. O cliente Porto paga mais caro pelo serviço e fidelidade. O "float" é gerido de forma agressiva e competente. * **Cenário 2026:** A Porto depende mais da economia real (venda de carros, emprego) do que do balcão de um banco estatal. Se o preço dos carros cai, o prêmio cai, mas a frota segurada pode aumentar. * **Perfil:** Crescimento com Qualidade. Paga menos dividendos que as estatais, mas reinveste para crescer. *** ## Comparativo Direto | Indicador | BB Seguridade (BBSE3) | Caixa Seguridade (CXSE3) | Porto (PSSA3) | | :-------------------- | :-------------------------- | :-------------------------- | :------------------------------- | | **Canal de Venda** | Banco do Brasil (Exclusivo) | Caixa (Exclusivo) | Corretores Independentes | | **Foco Principal** | Rural / Vida | Habitacional | Automóvel / Saúde | | **Dependência Juros** | Alta (Resultado Financeiro) | Alta | Média | | **Dividend Yield** | Alto (8-10%+) | Alto (8-10%+) | Médio/Baixo (4-6%) | | **Governança** | Privada (Holding) + Estatal | Privada (Holding) + Estatal | Privada (Controle Familiar/Itaú) | *** ## O Impacto da Selic em 2026 * **Selic Alta:** Bom para todas, pois o dinheiro em caixa rende mais (Resultado Financeiro bombeado). * **Selic em Queda (Cenário Base 2026):** O resultado financeiro diminui. Porém, a economia aquece, vendem-se mais carros e casas, e contrata-se mais seguro (Resultado Operacional melhora). * **PSSA3** tende a se beneficiar mais da queda de juros (ciclo econômico). * **BBSE3 e CXSE3** são mais defensivas, mas podem ver o lucro crescer menos se o financeiro cair muito. *** ## Análise com Python: Dividend Yield Histórico Seguradoras são famosas pela consistência. ### Yield Estimado 2026 (Projeção de Mercado) | Ticker | Yield Estimado | Observação | | ------ | -------------- | --------------------------------------- | | BBSE3 | 9,5% | O Agro não para | | CXSE3 | 9,0% | A habitação é constante | | PSSA3 | 5,5% | Foco em crescimento e recompra de ações | > **Nota:** PSSA3 historicamente bonifica ações (dá ações de graça). Isso não aparece no Yield, mas gera valor absurdo no longo prazo. *** ## Conclusão: Qual a Melhor Apólice para sua Carteira? * Quer **renda imediata** e gosta do setor Agro? Vá de **BBSE3**. * Quer **previsibilidade extrema** atrelada ao setor imobiliário? Vá de **CXSE3**. * Quer uma empresa de mercado, com marca forte e potencial de **crescimento** além dos bancos estatais? Vá de **PSSA3**. Para uma carteira 2026 bem balanceada, ter uma seguradora (especialmente BBSE3 ou CXSE3) funciona como um "zagueiro": garante que, mesmo se o ataque falhar, a defesa segura o zero a zero e ainda paga bicho (dividendos). *** ## Leia Mais * **[Bancos: ITUB4 e BBAS3](/blog/acoes-bancos-analise-setorial-2026)** * **[Renda Fixa 2026](/blog/onde-investir-2026-guia-completo-melhores-investimentos)** # Small Caps Brasil 2026: Como Investir em Empresas Menores com Alto Potencial URL: /blog/small-caps-brasil-como-investir-empresas-menores.mdx Descubra como investir em Small Caps brasileiras. Guia completo com análise, melhores ações, riscos e estratégias para encontrar as próximas grandes empresas ✓ *** searchable: true title: 'Small Caps Brasil 2026: Como Investir em Empresas Menores com Alto Potencial' description: 'Descubra como investir em Small Caps brasileiras. Guia completo com análise, melhores ações, riscos e estratégias para encontrar as próximas grandes empresas ✓' date: '2026-01-01' keywords: 'small caps, small caps brasil, ações small caps, empresas menores bolsa, investir small caps, SMLL, mid caps, micro caps, 2026' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Ações' readingTime: '22 min' tags: \['Small Caps', 'Ações', 'Investimentos', 'Bolsa Brasileira', 'Análise Fundamentalista'] relatedPosts: \['value-investing-como-encontrar-acoes-baratas', 'como-investir-em-acoes-guia-completo-iniciantes', 'dividendos-como-construir-renda-passiva', 'small-caps-brasil-como-investir-empresas-menores'] featured: true expertise: 'Especialistas em análise de empresas de menor capitalização no mercado brasileiro' lastReviewed: 2026-01-03 ------------------------ import { Callout } from 'fumadocs-ui/components/callout'; Enquanto a maioria dos investidores foca em gigantes como Petrobras e Vale, existe um universo de **Small Caps** que pode oferecer retornos extraordinários. Empresas como Magazine Luiza, Localiza e WEG já foram Small Caps antes de se tornarem gigantes da bolsa. Neste guia completo, você vai aprender **como identificar, analisar e investir em Small Caps** brasileiras com potencial de valorização. ## O Que São Small Caps? **Small Caps** são empresas de **pequena capitalização de mercado** (Market Cap), geralmente entre **R$ 300 milhões e R$ 5 bilhões**. Elas representam negócios em crescimento, ainda não tão grandes quanto as Blue Chips. ### Classificação por Capitalização | Categoria | Market Cap | Exemplos | | -------------- | ------------------- | ----------------------- | | **Mega Caps** | > R$ 100 bilhões | PETR4, VALE3, ITUB4 | | **Large Caps** | R$ 20-100 bilhões | WEGE3, BBDC4, RENT3 | | **Mid Caps** | R$ 5-20 bilhões | RADL3, PRIO3, CSAN3 | | **Small Caps** | R$ 300M - 5 bilhões | POSI3, MDIA3, AERI3 | | **Micro Caps** | \< R$ 300 milhões | Empresas muito pequenas | ### Índice Small Cap (SMLL) O **SMLL** é o índice da bolsa brasileira que acompanha as empresas de menor capitalização. Ele serve como benchmark para avaliar o desempenho das Small Caps. ``` Composição do SMLL: - Empresas não incluídas no IBOV - Critérios de liquidez específicos - Rebalanceamento quadrimestral ``` ## Por Que Investir em Small Caps? ### ✅ Vantagens | Vantagem | Descrição | | ---------------------------- | ------------------------------------------- | | **Potencial de Crescimento** | Podem multiplicar de valor várias vezes | | **Menos Cobertura** | Oportunidades que grandes fundos não veem | | **Aquisições** | Podem ser compradas por empresas maiores | | **Mercados de Nicho** | Líderes em segmentos específicos | | **Valorização Rápida** | Crescimento percentual maior que large caps | ### ❌ Riscos | Risco | Descrição | | -------------------- | -------------------------------------- | | **Volatilidade** | Oscilações de preço mais intensas | | **Liquidez Baixa** | Difícil comprar/vender grandes volumes | | **Menos Informação** | Menor cobertura de analistas | | **Risco de Negócio** | Empresas mais vulneráveis a crises | | **Governança** | Pode ser menos robusta que large caps | ### Histórico de Sucesso Algumas das maiores empresas da bolsa já foram Small Caps: | Empresa | Antes | Hoje | Valorização | | ------------------ | ----------------- | --------------- | ----------- | | **Magazine Luiza** | Small Cap 2015 | R$ 30+ bilhões | +5.000%+ | | **WEG** | Small Cap anos 90 | R$ 150+ bilhões | +10.000%+ | | **Localiza** | Small Cap 2005 | R$ 50+ bilhões | +3.000%+ | | **Raia Drogasil** | Mid Cap 2010 | R$ 40+ bilhões | +1.500%+ | ## Como Analisar Small Caps ### Framework de Análise ``` ┌─────────────────────────────────────────────────────────────┐ │ FRAMEWORK DE ANÁLISE - SMALL CAPS │ ├─────────────────────────────────────────────────────────────┤ │ │ │ 1. QUALITATIVA │ │ ├── Modelo de negócio │ │ ├── Vantagens competitivas │ │ ├── Qualidade da gestão │ │ └── Potencial de crescimento │ │ │ │ 2. QUANTITATIVA │ │ ├── Crescimento de receita │ │ ├── Margens e lucratividade │ │ ├── Endividamento │ │ └── Valuation (P/L, EV/EBITDA) │ │ │ │ 3. TÉCNICA │ │ ├── Liquidez diária │ │ ├── Free float │ │ └── Tendência de preço │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Indicadores Essenciais #### 1. Crescimento de Receita (CAGR) Small Caps devem crescer **acima da média do mercado**. **Fórmula:** CAGR = ((Valor Final ÷ Valor Inicial)^(1/anos) - 1) × 100 **Exemplo:** Receita cresceu de R$ 100M para R$ 320M em 4 anos * CAGR = ((320/100)^(1/4) - 1) × 100 = **33,7%** **Interpretação do CAGR para Small Caps:** | CAGR | Interpretação | | ------ | ---------------------------------------- | | > 20% | Crescimento acelerado (excelente) | | 10-20% | Crescimento sólido | | \< 10% | Crescimento lento (risco para Small Cap) | #### 2. Margem EBITDA Indica eficiência operacional e poder de precificação. **Fórmulas:** * Margem EBITDA = (EBITDA ÷ Receita) × 100 * Margem Líquida = (Lucro Líquido ÷ Receita) × 100 **Interpretação da Margem EBITDA:** | Margem EBITDA | Qualidade | | ------------- | -------------------------------------- | | > 20% | Alta - excelente poder de precificação | | 10-20% | Média - margem competitiva | | \< 10% | Baixa - margens apertadas | #### 3. Dívida Líquida / EBITDA Small Caps endividadas são mais arriscadas. **Fórmula:** Dívida/EBITDA = Dívida Líquida ÷ EBITDA **Interpretação:** | Dívida/EBITDA | Risco | Status | | ------------- | ---------- | ------------------------ | | \< 1x | Baixo | Empresa pouco alavancada | | 1-2,5x | Moderado | Alavancagem aceitável | | 2,5-4x | Alto | Alavancagem elevada | | > 4x | Muito Alto | Alavancagem perigosa | Small Caps com Dívida/EBITDA > 3x são muito arriscadas em cenários de alta de juros. #### 4. ROE e ROIC Retorno sobre capital investido - fundamental para Small Caps em crescimento. **Fórmulas:** * ROE = (Lucro Líquido ÷ Patrimônio Líquido) × 100 * ROIC = (Lucro Líquido ÷ Capital Investido) × 100 **Interpretação:** | ROE | Qualidade | | ------ | --------- | | > 20% | Excelente | | 15-20% | Bom | | \< 15% | Regular | | ROIC | Qualidade | | ------ | --------- | | > 15% | Excelente | | 10-15% | Bom | | \< 10% | Regular | ## Analisando Small Caps com brapi.dev Use a [API brapi.dev](https://brapi.dev) para analisar Small Caps automaticamente: ```typescript // Buscar dados de uma Small Cap const response = await fetch( "https://brapi.dev/api/quote/POSI3?modules=defaultKeyStatistics,financialData", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); const stock = data.results[0]; // Verificar se é Small Cap (Market Cap entre 300M e 5B) const marketCap = stock.marketCap; const isSmallCap = marketCap >= 300_000_000 && marketCap <= 5_000_000_000; // Indicadores disponíveis: // - priceEarnings (P/L) // - priceToBook (P/VP) // - returnOnEquity (ROE) // - dividendYield (DY) // - regularMarketVolume (Volume diário) ``` **Potenciais Small Caps para análise:** | Ticker | Setor | Descrição | | ------ | ---------- | ------------------- | | POSI3 | Tecnologia | Positivo Tecnologia | | MDIA3 | Alimentos | M. Dias Branco | | INTB3 | Tecnologia | Intelbras | | LWSA3 | Tecnologia | Locaweb | | PETZ3 | Varejo | Petz | ### Screener Avançado de Small Caps Para encontrar Small Caps de qualidade, aplique os seguintes filtros: **Critérios de Qualidade:** | Critério | Valor Mínimo/Máximo | | ------------- | ------------------- | | Market Cap | R$ 300M - R$ 5B | | ROE | > 10% | | P/L | > 0 e \< 20 | | Volume diário | > R$ 500.000 | **Sistema de Pontuação:** | Indicador | Pontuação Máxima | Critério | | -------------------- | ---------------- | -------------------------- | | ROE > 20% | 20 pts | Alta eficiência | | P/L entre 5-12 | 20 pts | Valuation atrativo | | EV/EBITDA \< 8 | 20 pts | Barato vs geração de caixa | | Margem Líquida > 10% | 20 pts | Boa rentabilidade | | DY > 3% | 20 pts | Retorno ao acionista | ```typescript // Analisar múltiplas Small Caps const tickers = "POSI3,MDIA3,INTB3,LWSA3,PETZ3"; const response = await fetch( `https://brapi.dev/api/quote/${tickers}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); // Filtrar apenas Small Caps e calcular score const smallCaps = data.results.filter(stock => { const mc = stock.marketCap; return mc >= 300_000_000 && mc <= 5_000_000_000; }); ``` ### Comparação de Crescimento Para comparar Small Caps, busque dados históricos e calcule o retorno total: ```typescript // Buscar histórico de 5 anos const response = await fetch( "https://brapi.dev/api/quote/POSI3?range=5y&interval=1mo&modules=defaultKeyStatistics,financialData", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); const historical = data.results[0].historicalDataPrice; // Calcular retorno const precoInicial = historical[0].close; const precoAtual = historical[historical.length - 1].close; const retornoTotal = ((precoAtual / precoInicial) - 1) * 100; const cagr = (Math.pow(precoAtual / precoInicial, 1/5) - 1) * 100; ``` ## Estratégias para Investir em Small Caps ### 1. Estratégia Growth at Reasonable Price (GARP) Busca Small Caps em crescimento, mas com valuation razoável. **Conceito:** Usar o PEG Ratio (P/L dividido pelo crescimento esperado) **Critérios GARP:** | Indicador | Critério | | --------- | --------------------------------------- | | PEG Ratio | \< 1,5 (idealmente \< 1) | | P/L | > 0 | | ROE | > 10% (usado como proxy de crescimento) | **Interpretação do PEG:** | PEG | Atratividade | | ----- | ------------------------------------- | | \< 1 | Alta - crescimento supera o valuation | | 1-1,5 | Média - preço justo | | > 1,5 | Baixa - pode estar cara | **Fórmula:** PEG = P/L ÷ Taxa de Crescimento (%) Um PEG de 1,0 significa que o P/L da empresa é igual à sua taxa de crescimento - considerado "preço justo" por investidores GARP. ### 2. Estratégia Turnaround Identifica Small Caps que estão se recuperando de momentos difíceis. **Sinais de Turnaround:** | Indicador | Critério | O que indica | | ----------------------- | ---------- | ------------------------------- | | P/VP | \< 1,0 | Negociando abaixo do patrimônio | | Distância da mínima 52s | \< 30% | Ainda perto do fundo | | Dívida/EBITDA | Melhorando | Reestruturação funcionando | **Classificação de Potencial:** | P/VP | Potencial | | ------- | ------------------------- | | \< 0,7 | Alto - forte desconto | | 0,7-1,0 | Médio - desconto moderado | | > 1,0 | Não é turnaround clássico | Turnarounds são arriscados. Muitas empresas baratas estão baratas por bons motivos. Faça due diligence completa antes de investir. ### 3. Estratégia de Nicho de Mercado Foca em Small Caps líderes em segmentos específicos. **Líderes de Nicho - Small Caps:** | Nicho | Ticker | Posição de Mercado | | ---------------------- | ------ | ---------------------------------- | | Tecnologia Educacional | POSI3 | Líder em computadores educacionais | | Segurança Eletrônica | INTB3 | Líder em câmeras e alarmes | | Biscoitos e Massas | MDIA3 | Líder regional (Nordeste) | | Pet Shops | PETZ3 | Maior rede de pet shops | | Hospedagem Web | LWSA3 | Líder em cloud para PMEs | Líderes de nicho têm vantagens competitivas defensáveis: marca forte, economia de escala no segmento e conhecimento especializado. ## Montando uma Carteira de Small Caps ### Regras de Alocação ``` ┌─────────────────────────────────────────────────────────────┐ │ REGRAS DE ALOCAÇÃO - SMALL CAPS │ ├─────────────────────────────────────────────────────────────┤ │ │ │ 1. DIVERSIFICAÇÃO │ │ ├── Mínimo 8-12 Small Caps na carteira │ │ ├── Máximo 5-8% por posição individual │ │ └── Diversifique por setores │ │ │ │ 2. LIQUIDEZ │ │ ├── Volume diário > R$ 500k (ideal > R$ 1M) │ │ └── Free float > 25% │ │ │ │ 3. PROPORÇÃO NA CARTEIRA TOTAL │ │ ├── Conservador: 5-10% em Small Caps │ │ ├── Moderado: 15-25% em Small Caps │ │ └── Arrojado: 30-40% em Small Caps │ │ │ │ 4. REBALANCEAMENTO │ │ ├── Trimestral ou semestral │ │ └── Realize lucros quando posição >10% │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Exemplo de Carteira Small Cap **Carteira Diversificada - R$ 50.000:** | Ticker | Setor | Peso | Valor | | ----------- | ---------- | ---- | -------- | | POSI3 | Tecnologia | 10% | R$ 5.000 | | INTB3 | Tecnologia | 10% | R$ 5.000 | | LWSA3 | Tecnologia | 8% | R$ 4.000 | | MDIA3 | Consumo | 10% | R$ 5.000 | | PETZ3 | Consumo | 8% | R$ 4.000 | | AERI3 | Indústria | 8% | R$ 4.000 | | CASH3 | Financeiro | 8% | R$ 4.000 | | CURY3 | Construção | 10% | R$ 5.000 | | EVEN3 | Construção | 8% | R$ 4.000 | | BLAU3 | Saúde | 10% | R$ 5.000 | | **Reserva** | Caixa | 10% | R$ 5.000 | **Diversificação por setor:** * Tecnologia: 28% * Consumo: 18% * Construção: 18% * Saúde: 10% * Outros: 16% * Reserva: 10% ## Riscos e Como Mitigá-los ### Risco de Liquidez **Como avaliar:** Compare o tamanho da sua posição com o volume diário negociado. **Fórmula:** Dias para sair = Valor da Posição ÷ (Volume Diário × 10%) *(Considera impactar no máximo 10% do volume diário)* **Classificação de Risco:** | Dias para Sair | Risco | Status | | -------------- | -------- | ------------------------------- | | ≤ 1 dia | Baixo | Pode sair rapidamente | | 2-5 dias | Moderado | Precisa de planejamento | | > 5 dias | Alto | Difícil sair sem impactar preço | **Exemplo:** Posição de R$ 50.000 em ação com volume de R$ 500.000/dia * Dias para sair = 50.000 ÷ (500.000 × 0,10) = **1 dia** (Risco Baixo) ### Risco de Concentração **Regra:** Nenhum setor deve representar mais de 30% da carteira. **Checklist de Diversificação:** * [ ] Máximo 30% por setor * [ ] Mínimo 5 setores diferentes * [ ] Nenhuma posição individual > 10% * [ ] Correlação baixa entre posições ## SMLL vs Ibovespa: Desempenho Histórico ### Comparação de Retornos **SMLL vs Ibovespa - Retornos Anuais:** | Ano | SMLL | IBOV | Diferença | | ---- | ------ | ------ | --------- | | 2019 | +49,7% | +31,6% | +18,1% | | 2020 | +0,5% | +2,9% | -2,4% | | 2021 | -16,2% | -11,9% | -4,3% | | 2022 | -0,8% | +4,7% | -5,5% | | 2023 | +17,1% | +22,3% | -5,2% | | 2024 | -6,5% | -10,4% | +3,9% | **Conclusão:** Small Caps tendem a ter melhor desempenho em mercados de alta (2019), mas sofrem mais em crises. A diversificação entre Large e Small Caps é recomendada. ## Quando Vender Small Caps ### Sinais de Venda ``` ┌─────────────────────────────────────────────────────────────┐ │ SINAIS DE VENDA - SMALL CAPS │ ├─────────────────────────────────────────────────────────────┤ │ │ │ VENDA OBRIGATÓRIA: │ │ ❌ Fraude contábil ou problemas de governança │ │ ❌ Perda permanente de vantagem competitiva │ │ ❌ Deterioração estrutural do setor │ │ │ │ CONSIDERE VENDER: │ │ ⚠️ Valuation muito esticado (P/L > 30 sem justificativa) │ │ ⚠️ Crescimento desacelerando significativamente │ │ ⚠️ Endividamento aumentando perigosamente │ │ ⚠️ Gestão vendendo ações massivamente │ │ │ │ REALIZE LUCROS PARCIAIS: │ │ 💰 Ação valorizou > 100% em 12 meses │ │ 💰 Posição passou de 10% da carteira │ │ 💰 Empresa virou Mid/Large Cap │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Monitoramento Automático Monitore sua carteira de Small Caps para identificar alertas: **Alertas a Observar:** | Alerta | Critério | Ação | | ------------------- | --------------- | --------------------------- | | P/L muito alto | > 30 | Considerar realizar lucros | | Endividamento alto | D/E > 2 | Avaliar riscos | | Perto da mínima 52s | \< 5% da mínima | Revisar tese | | Perto da máxima 52s | > 95% da máxima | Considerar realizar parcial | ```typescript // Monitorar carteira via brapi.dev const portfolio = ["POSI3", "INTB3", "MDIA3", "LWSA3", "PETZ3"]; const tickers = portfolio.join(","); const response = await fetch( `https://brapi.dev/api/quote/${tickers}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const data = await response.json(); // Verificar alertas para cada ação data.results.forEach(stock => { if (stock.priceEarnings > 30) console.log(`${stock.symbol}: P/L alto`); if ((stock.financialData?.debtToEquity ?? 0) > 2) { console.log(`${stock.symbol}: Endividamento alto`); } }); ``` ## Conclusão Investir em **Small Caps** pode ser altamente lucrativo, mas exige: 1. **Análise profunda** de cada empresa 2. **Diversificação adequada** (8-12 posições) 3. **Paciência** para esperar o crescimento 4. **Monitoramento constante** dos fundamentos 5. **Disciplina** para vender quando necessário As Small Caps são onde os **grandes retornos** são encontrados, mas também onde os **maiores riscos** estão. Use as ferramentas da [brapi.dev](https://brapi.dev) para analisar dados fundamentalistas e tomar decisões informadas. ## Próximos Passos 1. 📖 Aprenda [Value Investing](/blog/value-investing-como-encontrar-acoes-baratas) para encontrar Small Caps subvalorizadas 2. 📊 Entenda [como usar o indicador P/L](/blog/entendendo-indicador-preco-lucro-pl-analise-fundamentalista) na análise 3. 🎯 Descubra como [montar uma carteira diversificada](/blog/carteira-de-acoes-como-montar-diversificar) 4. 🚀 Crie sua conta na [brapi.dev](https://brapi.dev) e comece a analisar Small Caps *** *Disclaimer: Este artigo tem fins educacionais. Small Caps são investimentos de maior risco. Consulte um assessor de investimentos antes de tomar decisões financeiras.* # Small Caps Promissoras para 2026: Alto Risco, Alto Retorno URL: /blog/small-caps-promissoras-2026-analise.mdx Em busca das "multibaggers" de 2026. Análise de small caps promissoras como PRIO3, INTB3 e outras joias escondidas da bolsa. *** searchable: true title: 'Small Caps Promissoras para 2026: Alto Risco, Alto Retorno' description: 'Em busca das "multibaggers" de 2026. Análise de small caps promissoras como PRIO3, INTB3 e outras joias escondidas da bolsa.' date: '2025-12-31' keywords: 'small caps 2026, melhores small caps, prio3, intb3, intelbras, petrorio, ações de crescimento, small caps promissoras' author: 'Equipe brapi.dev' category: 'Ações' subcategory: 'Small Caps' readingTime: '16 min' tags: \['Small Caps', 'Crescimento', 'Risco', 'PRIO3', 'INTB3', 'Multibaggers'] relatedPosts: \['onde-investir-2026-guia-completo-melhores-investimentos', 'wege3-analise-crescimento-2026', 'varejo-ecommerce-mglu3-lren3-meli34-analise-2026'] featured: false expertise: 'Garimpando empresas com potencial de valorização exponencial fora do radar do Ibovespa.' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; Enquanto todo mundo olha para Vale, Petrobras e Itaú, é nas **Small Caps** (empresas de menor capitalização de mercado) que moram as maiores oportunidades de multiplicação de capital da bolsa. A lógica é matemática: é muito mais fácil uma empresa que vale R$ 2 bilhões dobrar de tamanho (para R$ 4 bi) do que uma que vale R$ 400 bilhões (como a Petrobras) fazer o mesmo. Para 2026, com a perspectiva de queda de juros (o principal catalisador das Small Caps), selecionamos algumas empresas que combinam crescimento, boa gestão e potencial explosivo. *** ## O Que Define uma Boa Small Cap? Não basta ser pequena; tem que ser boa. Procuramos: 1. **Crescimento de Receita:** A empresa está vendendo mais ano após ano? 2. **Mercado Endereçável (TAM):** Ela tem espaço para crescer ou o mercado está saturado? 3. **Alavancagem Controlada:** Dívida alta com juros altos mata Small Caps. 4. **Liquidez:** Mínima para entrar e sair sem mover o preço. *** ## As Apostas para 2026 ### 1. Prio (PRIO3): A "Junior Oil" que virou Gente Grande A Prio (antiga PetroRio) é o maior case de sucesso recente da bolsa. Ela compra campos maduros de petróleo e revitaliza a produção com eficiência brutal. * **Tese 2026:** A empresa continua aumentando produção (Campo de Wahoo, Frade). Seu custo de extração (lifting cost) é um dos menores do mundo, competindo com a Petrobras. Mesmo que o petróleo caia, a Prio gera caixa. * **Risco:** Execução nos novos campos e preço do Brent. * **Veredito:** Já não é tão "small" assim, mas ainda tem um perfil de crescimento (Growth) agressivo. ### 2. Intelbras (INTB3): Tecnologia e Segurança A Intelbras é onipresente: câmeras de segurança, porteiros eletrônicos, roteadores e energia solar. * **Tese 2026:** Liderança absoluta em seus nichos, capilaridade de distribuição monstruosa (vende em qualquer lojinha de bairro) e dividendos crescentes. A aposta em energia solar e 5G pode destravar nova avenida de crescimento. * **Risco:** Concorrência chinesa e dependência de importação de componentes. * **Veredito:** Uma empresa sólida, com ROIC alto, crescendo acima do PIB. ### 3. Cury (CURY3) ou Direcional (DIRR3): Construção Baixa Renda Construtoras focadas no "Minha Casa Minha Vida" (ou programa equivalente vigente). * **Tese 2026:** Déficit habitacional no Brasil é enorme. Essas empresas operam como "fábricas de prédios", com repasse rápido de inflação e subsídio governamental garantido. Têm pago dividendos gordos. * **Risco:** Aumento custo de construção (INCC) acima da inflação e mudanças nas regras do programa governamental. * **Veredito:** Excelentes geradoras de caixa e menos voláteis que construtoras de média/alta renda. ### 4. 3R Petroleum (RRRP3) ou PetroReconcavo (RECV3) As outras "juniors" do petróleo. Após consolidações no setor (fique atento a fusões, como a fusão 3R + Enauta), essas empresas buscam replicar o sucesso da Prio em terra (onshore) ou mar. * **Tese:** Aumento de produção e redução de custos (synergies). * **Risco:** Execução. Revitalizar campos velhos é difícil e caro. *** ## Como Montar uma Carteira de Small Caps Investir em Small Caps é arriscado. A volatilidade é extrema. 1. **Diversifique:** Nunca coloque tudo em uma só. Tenha uma cesta com 5 a 10 nomes. Se uma "micar" (cair 50%), a outra que "explodir" (subir 300%) compensa. 2. **Tamanho da Posição:** Não aloque mais do que 20-30% da sua carteira de ações em Small Caps, a menos que você tenha estômago de aço. 3. **Paciência:** O mercado pode ignorar uma boa Small Cap por anos até "descobri-la". O horizonte é de 3 a 5 anos. *** ## Screening de Small Caps Vamos usar a API para encontrar outras candidatas baseadas em critérios fundamentalistas. ```typescript const response = await fetch( 'https://brapi.dev/api/quote/list?sortBy=change&limit=20', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Filtre por Market Cap para identificar Small Caps ``` **Critérios para Radar de Small Caps:** | Critério | Valor Alvo | Por quê | | --------------------- | -------------------- | -------------------- | | Market Cap | R$ 500 Mi - R$ 10 Bi | Define Small Cap | | Dívida Líq./EBITDA | \< 2,5x | Saúde financeira | | CAGR Receita (5 anos) | > 15% | Crescimento | | ROIC | > 15% | Qualidade do negócio | > **Dica:** Small Caps exigem acompanhamento trimestral mais próximo que Blue Chips. *** ## Conclusão As Small Caps são o "tempero" que pode mudar o patamar da sua carteira em 2026. Empresas como **PRIO3** e **INTB3** já provaram sua qualidade, mas o mercado está cheio de outras oportunidades (microcaps) esperando para serem destravadas pela queda dos juros. Estude os cases, diversifique e, principalmente, acompanhe os resultados trimestrais de perto. Em Small Caps, o olho do dono engorda o gado. *** ## Leia Mais * **[WEG (WEGE3): A Large Cap de Crescimento](/blog/wege3-analise-crescimento-2026)** * **[Agronegócio: SLCE3 e AGRO3](/blog/agronegocio-bolsa-slce3-agro3-analise-2026)** # Solana (SOL) em 2026: Guia Completo para Investir no Brasil URL: /blog/solana-sol-guia-completo-brasil-2026.mdx Tudo sobre Solana: como comprar SOL no Brasil, DeFi, NFTs, memecoins, staking e análise. Comparativo SOL vs ETH e perspectivas para 2026. *** searchable: true title: 'Solana (SOL) em 2026: Guia Completo para Investir no Brasil' description: 'Tudo sobre Solana: como comprar SOL no Brasil, DeFi, NFTs, memecoins, staking e análise. Comparativo SOL vs ETH e perspectivas para 2026.' date: '2026-01-01' keywords: 'solana brasil, sol como comprar, staking solana, solana defi, phantom wallet, solana nft, raydium, jupiter solana, memecoin solana, sol vs eth, 2026' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Criptomoedas' readingTime: '20 min' tags: \['Solana', 'Criptomoedas', 'DeFi', 'NFTs', 'Memecoins', 'Staking'] relatedPosts: \['bitcoin-brasil-como-investir-analise', 'ethereum-eth-guia-completo-brasil-2026', 'etfs-criptomoedas-b3-hash11-bith11-guia-2026', 'stablecoins-brasil-usdt-brz-drex-guia-2026', 'como-declarar-criptomoedas-imposto-renda-2026'] featured: true expertise: 'Análise técnica e fundamentalista do ecossistema Solana com foco no mercado brasileiro' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; A **Solana** emergiu como a principal alternativa ao Ethereum, oferecendo transações ultra-rápidas por frações de centavo. Em 2026, foi palco da explosão de memecoins e consolidou-se como a blockchain preferida para NFTs e aplicações de alta frequência. Este guia completo explora o ecossistema Solana, como investir no Brasil e as perspectivas para 2026. ## Sumário 1. [O que é Solana?](#o-que-e-solana) 2. [Solana vs Ethereum: Comparativo](#solana-vs-ethereum) 3. [Ecossistema Solana](#ecossistema-solana) 4. [DeFi na Solana](#defi-solana) 5. [NFTs e Memecoins](#nfts-memecoins) 6. [Staking de SOL](#staking-sol) 7. [Como Comprar SOL no Brasil](#como-comprar-sol-brasil) 8. [Carteiras para Solana](#carteiras-solana) 9. [Análise e Projeções 2026](#analise-projecoes) 10. [Riscos e Considerações](#riscos-consideracoes) *** ## O que é Solana? Solana é uma blockchain de alta performance criada por Anatoly Yakovenko em 2020. Seu diferencial é a velocidade: processa até **65.000 transações por segundo (TPS)** com taxas de frações de centavo. ### Solana em Números (2026) | Métrica | Valor | | -------------- | -------------------------------------- | | Criação | 2020 (Anatoly Yakovenko) | | Market Cap | \~$120 bilhões | | Ranking | #5 (atrás de BTC, ETH, USDT, XRP) | | TPS | \~65.000 (teórico) / \~5.000 (prático) | | Taxa média | $0.00025 | | Tempo de bloco | \~400ms | | Validadores | 2.000+ | | TVL DeFi | \~$12 bilhões | | Staking APY | \~7-8% | ### Tecnologia: Proof of History O diferencial técnico da Solana é o **Proof of History (PoH)**, um mecanismo que cria uma "linha do tempo" verificável de eventos, permitindo que validadores processem transações em paralelo. **Problema tradicional:** Em blockchains normais, validadores precisam concordar sobre a ORDEM das transações, o que exige comunicação intensiva e limita a velocidade. **Solução Solana (PoH):** Cria um "relógio" criptográfico que prova quando cada evento aconteceu, permitindo processar transações em paralelo. **Analogia:** Imagine uma foto com um jornal do dia - prova que a foto foi tirada DEPOIS daquele jornal ser impresso. PoH faz isso criptograficamente para cada transação. | Blockchain | TPS | Tempo de bloco | | ---------- | ------- | -------------- | | Ethereum | \~15 | \~12 segundos | | Solana | \~4.000 | \~0.4 segundos | Solana é \~250x mais rápida em throughput que o Ethereum L1. ### Por que Solana Cresceu Tanto? 1. **Taxas quase zero**: Centenas de transações por centavos 2. **Velocidade**: Confirmação em menos de 1 segundo 3. **UX superior**: Aplicativos respondem instantaneamente 4. **Memecoins**: Pump.fun e outros protocolos de lançamento 5. **NFTs baratos**: Mint por centavos vs $20+ no Ethereum 6. **Investimento institucional**: Jump Trading, Multicoin Capital *** ## Solana vs Ethereum: Comparativo ### Tabela Comparativa | Característica | Solana | Ethereum | | --------------------- | --------------- | ----------------------- | | **TPS** | \~4.000 (real) | \~15 (L1) / 4.000+ (L2) | | **Taxa média** | $0.0003 | $2-10 (L1) / $0.10 (L2) | | **Tempo confirmação** | \~400ms | \~12 segundos | | **Mecanismo** | PoS + PoH | PoS | | **Market Cap** | \~$100B | \~$400B | | **TVL DeFi** | \~$12B | \~$70B | | **Maturidade** | 5 anos | 10 anos | | **Descentralização** | Média | Alta | | **Uptime histórico** | 99.5% (outages) | 99.99% | | **Staking APY** | \~7-8% | \~4% | ### Quando Escolher Cada Um **Escolha Solana para:** * Transações frequentes (trading, gaming) * NFTs (mint barato, coleções grandes) * Memecoins e especulação de curto prazo * Aplicações que exigem baixa latência * Microtransações (pagamentos pequenos) * Experimentar DeFi sem gastar em taxas **Escolha Ethereum para:** * Máxima segurança e descentralização * DeFi institucional (Aave, Maker, Uniswap) * NFTs de alto valor (arte, PFPs premium) * Longo prazo (10+ anos) * Maior ecossistema de desenvolvedores * Interoperabilidade com Layer 2s **Muitos investidores têm ambos:** ETH para exposição principal e staking, SOL para uso ativo e especulação. ### Volatilidade: SOL vs BTC Solana tem **volatilidade \~2x maior** que Bitcoin: | Evento | BTC | SOL | | ---------------- | ----- | ------------------- | | Bull market 2021 | +300% | +11.000% | | Bear market 2022 | -65% | -94% (FTX collapse) | | Recovery 2023 | +155% | +900% | | 2024 | +120% | +200% | | 2026 | +60% | +80% | ⚠️ **SOL é investimento de alto risco/retorno** *** ## Ecossistema Solana ### Principais Categorias | Categoria | Protocolo | Descrição | | -------------- | ---------- | --------------------------- | | **DEXs** | Jupiter | Agregador #1 (melhor preço) | | | Raydium | AMM principal, farms | | | Orca | User-friendly | | | Meteora | Dynamic pools | | **Lending** | Kamino | Lending automatizado | | | Marginfi | Lending com margem | | | Solend | Pioneiro em lending | | | Drift | Perps + lending | | **NFTs** | Magic Eden | Marketplace #1 | | | Tensor | Trading avançado | | | Metaplex | Protocolo de NFTs | | **Memecoins** | Pump.fun | Lançador de memecoins | | | Bonk | Memecoin da comunidade | | | WIF | Dog with hat | | **Gaming** | Star Atlas | MMO espacial | | | Aurory | RPG play-to-earn | | **Pagamentos** | Solana Pay | Pagamentos comerciais | | | Sphere | Checkout cripto | *** ## DeFi na Solana ### Principais Protocolos por TVL (2026) | Protocolo | Categoria | TVL | APY Típico | | --------- | -------------- | ------- | ---------- | | Jito | Liquid Staking | \~$4B | 7-8% | | Kamino | Lending | \~$2.5B | 5-15% | | Raydium | DEX/AMM | \~$1.5B | Variável | | Marinade | Liquid Staking | \~$1.2B | 7% | | Marginfi | Lending | \~$900M | 5-12% | | Jupiter | Agregador | \~$800M | - | ### Como Usar DeFi na Solana **Primeiros passos em DeFi na Solana:** 1. **Instale a carteira Phantom** - phantom.app (extensão de navegador ou app mobile). *Dica: Anote a seed phrase em papel, nunca digital!* 2. **Compre SOL e envie para Phantom** - Binance ou Mercado Bitcoin → Phantom (rede Solana). *Dica: Mantenha 0.1 SOL para taxas* 3. **Acesse Jupiter (jup.ag)** - Agregador que encontra melhor preço para swaps. *Dica: Conecte a carteira Phantom* 4. **Faça seu primeiro swap** - Troque SOL por USDC ou outro token. *Dica: Taxa \~0.0001 SOL (centavos)* 5. **Explore staking líquido** - Jito (jitoSOL) ou Marinade (mSOL). *Dica: Ganhe \~7% a.a. mantendo liquidez* **Riscos DeFi:** Smart contract bugs (raro mas possível), impermanent loss em pools de liquidez, volatilidade extrema em tokens DeFi, rug pulls em protocolos novos. ### Jupiter: O Agregador Essencial **Jupiter** é o hub central de DeFi na Solana. Em vez de ir direto a uma DEX, Jupiter compara preços em todas e executa no melhor: **Exemplo: Trocar 10 SOL por USDC** | Exchange | Resultado | | ----------------------- | --------------- | | Raydium direto | $2,380 USDC | | Orca direto | $2,375 USDC | | **Jupiter (agregador)** | **$2,385 USDC** | Jupiter encontra a melhor rota, que pode incluir: split entre múltiplas DEXs, rotas intermediárias (SOL → wETH → USDC) e arbitragem automática. **Como usar Jupiter:** 1. Acesse [jup.ag](https://jup.ag) 2. Conecte Phantom 3. Selecione SOL → USDC 4. Clique em "Swap" 5. Confirme na carteira *Taxa: ~~0.0001 SOL (~~$0.02)* *** ## NFTs e Memecoins ### NFTs na Solana Solana tornou-se uma das principais blockchains para NFTs devido às taxas baixíssimas: | Operação | Ethereum | Solana | Economia | | ------------------ | -------- | ------- | -------- | | Mint NFT | $20-50 | $0.01 | 99.9% | | Transferir | $5-15 | $0.0001 | 99.99% | | Listar marketplace | $10-30 | $0.001 | 99.99% | **Marketplaces principais:** * **Magic Eden**: Maior volume, interface amigável * **Tensor**: Trading profissional, analytics ### Memecoins: Pump.fun e a Explosão de 2024-2026 Em 2024-2026, a Solana tornou-se o epicentro das memecoins graças ao **Pump.fun**, uma plataforma que permite lançar tokens em minutos: | Memecoin | Descrição | Market Cap | Performance | | --------------- | ----------------------------------- | ------------ | -------------------- | | BONK | Primeiro memecoin de sucesso Solana | \~$3 bilhões | +10.000% em 2023 | | WIF (dogwifhat) | Cachorro com chapéu | \~$2 bilhões | +2.000% em 2024-2026 | | Pump.fun | Plataforma de lançamento | - | +3M tokens lançados | **Memecoins são EXTREMAMENTE arriscados.** 99% falham, 1% explodem. Maioria vai a zero. Só invista o que pode perder 100%. ### Cuidados com Memecoins ⚠️ **Memecoins NÃO são investimentos, são especulação pura:** | Risco | Descrição | | ---------------- | --------------------------------------- | | Rug Pull | Criador abandona projeto com o dinheiro | | Baixa liquidez | Impossível vender sem derrubar preço | | Zero fundamentos | Valor baseado apenas em hype | | Manipulação | Whales controlam o preço | | 99% vão a zero | Estatística real do Pump.fun | **Se for participar:** * Use apenas dinheiro que aceita perder 100% * Diversifique entre várias (se uma der certo, compensa perdas) * Saiba sair (take profit em 2-5x, não espere "lua") * Verifique liquidez antes de entrar *** ## Staking de SOL ### Opções de Staking | Método | APY | Liquidez | Complexidade | | --------------- | ------ | ------------- | ------------ | | Staking nativo | \~7% | Baixa (epoch) | Média | | Jito (jitoSOL) | \~8% | Alta | Baixa | | Marinade (mSOL) | \~7% | Alta | Baixa | | Blaze (bSOL) | \~7.5% | Alta | Baixa | ### Staking Líquido (Recomendado) O staking líquido permite ganhar rendimentos **mantendo liquidez**: **Como funciona o staking líquido:** 1. Você deposita 100 SOL no Jito 2. Recebe 100 jitoSOL (token que representa seu stake) 3. jitoSOL valoriza \~7-8% ao ano vs SOL 4. Pode usar jitoSOL em DeFi (colateral, liquidez) 5. A qualquer momento, troca jitoSOL por SOL | Período | Conversão | | ------------ | --------------------------- | | Janeiro 2026 | 100 SOL → 100 jitoSOL | | Janeiro 2027 | 100 jitoSOL = \~107-108 SOL | **Vantagens vs staking nativo:** * Liquidez imediata (não precisa esperar desbloqueio) * Pode usar em DeFi simultaneamente * Diversificação automática entre validadores * MEV rewards extras (Jito) **Como fazer:** Acesse [jito.network](https://jito.network) ou [marinade.finance](https://marinade.finance), conecte Phantom, deposite SOL e receba jitoSOL ou mSOL. ### Calculadora de Staking ### Exemplo: Rendimento com Staking **Investimento:** 100 SOL (R$ 120.000) | **APY:** 7.5% | Ano | SOL Total | Ganho | Valor (preço constante) | | --- | --------- | ----- | ----------------------- | | 1 | 107.50 | +7.50 | R$ 129.000 | | 2 | 115.56 | +8.06 | R$ 138.675 | | 3 | 124.23 | +8.67 | R$ 149.076 | **Após 3 anos:** +24.23 SOL (\~R$ 29.076 de ganho) | Cenário de valorização | Valor final | | ---------------------- | ----------- | | Preço estável | R$ 149.076 | | +50% no preço | R$ 223.614 | | +100% no preço | R$ 298.152 | | +200% no preço | R$ 447.228 | *Valores assumem preço constante do SOL. Valorização é adicional.* *** ## Como Comprar SOL no Brasil ### Opções Disponíveis | Exchange | Par | Taxa | Depósito | | --------------- | ------- | -------- | ---------- | | Binance | SOL/BRL | 0.1% | PIX grátis | | Mercado Bitcoin | SOL/BRL | 0.3-0.5% | PIX grátis | | Foxbit | SOL/BRL | 0.5% | PIX grátis | | Bitso | SOL/BRL | 0.5% | PIX grátis | ### Passo a Passo **Opção 1: Exchange Brasileira (Mais simples)** 1. Abra conta na Binance ou Mercado Bitcoin 2. Faça verificação de identidade (KYC) 3. Deposite BRL via PIX 4. Compre SOL (ordem de mercado ou limitada) 5. Deixe na exchange OU transfira para Phantom **Opção 2: ETF na bolsa brasileira** * ETF de Solana esperado para 2026 * Investir via home broker normal * Sem preocupação com custódia **Opção 3: Dentro do HASH11** * HASH11 tem \~3% de exposição a SOL * Diversificado com BTC e ETH * Já disponível na bolsa brasileira **Taxas de saque (Exchange → Phantom):** | Exchange | Taxa de saque | | --------------- | ------------------ | | Binance | 0.01 SOL (\~R$ 12) | | Mercado Bitcoin | 0.02 SOL (\~R$ 24) | | Foxbit | 0.01 SOL (\~R$ 12) | **Dica:** Para valores pequenos, deixe na exchange. Para valores grandes (>R$ 5k), use carteira própria. *** ## Carteiras para Solana ### Comparativo de Carteiras | Carteira | Tipo | Plataformas | DeFi | NFTs | | ------------ | ---- | ----------------- | --------------- | ---- | | **Phantom** | Hot | Web, iOS, Android | ✅ | ✅ | | **Solflare** | Hot | Web, Mobile | ✅ | ✅ | | **Backpack** | Hot | Web, Mobile | ✅ | ✅ | | **Ledger** | Cold | Hardware | ✅ (via Phantom) | ✅ | ### Phantom: A Carteira Padrão **Phantom** é a carteira mais usada do ecossistema Solana: **Recursos do Phantom:** * Suporte nativo a SOL e todos os tokens SPL * Visualização de NFTs integrada * Swap integrado (via Jupiter) * Staking nativo * Histórico de transações * Multi-chain (Ethereum, Polygon também) * Mobile + Extensão de navegador **Download:** [phantom.app](https://phantom.app) (Chrome, iOS, Android) **Segurança:** NUNCA compartilhe sua seed phrase. Anote em papel, não digitalmente. Cuidado com sites falsos (sempre phantom.app). Para valores altos, use Ledger + Phantom. ### Configurando Phantom **Como configurar Phantom:** | Passo | Ação | Tempo | | ----- | -------------------------------------------------------------------- | ------ | | 1 | Baixe de [phantom.app](https://phantom.app) (APENAS o site oficial!) | 1 min | | 2 | Clique em "Create new wallet" | 30 seg | | 3 | Anote as 12 palavras (seed phrase) EM PAPEL | 5 min | | 4 | Confirme as palavras na ordem correta | 2 min | | 5 | Defina senha de acesso (diferente da seed!) | 1 min | | 6 | Pronto! Copie seu endereço para receber SOL | 30 seg | **Regras de ouro:** Seed phrase = sua única forma de recuperar fundos. Quem tem a seed, tem as criptos. NUNCA digite seed em sites. NUNCA envie seed para "suporte". Guarde em local seguro (cofre, casa de parentes). *** ## Análise e Projeções 2026 ### Histórico de Preços | Ano | Mínima | Máxima | Observação | | ---------- | ------ | ------ | -------------------------- | | 2020 | $0.50 | $4 | Lançamento | | 2021 | $1.50 | $260 | ATH, bull market | | 2022 | $8 | $140 | FTX collapse (-96% do ATH) | | 2023 | $10 | $120 | Recuperação surpreendente | | 2024 | $80 | $280 | Novo ATH, memecoins | | 2026 | $180 | $350 | Consolidação | | 2026 (jan) | $250 | $320 | - | ### Fatores Bullish (Alta) 🟢 1. **ETF de Solana nos EUA** - Aprovação esperada em 2026 2. **Firedancer** - Novo cliente validador do Jump, muito mais performático 3. **Adoção institucional** - Visa, Shopify, Stripe usando Solana Pay 4. **Mobile** - Saga Phone 2 com ecossistema próprio 5. **Memecoins** - Fluxo contínuo de novos usuários ### Fatores Bearish (Baixa) 🔴 1. **Outages** - Histórico de quedas da rede (melhorou muito) 2. **Centralização** - Críticas sobre concentração de validadores 3. **Concorrência** - Ethereum L2s cada vez mais baratos 4. **Regulação** - SEC pode classificar SOL como security 5. **Dependência de VC** - Muitos tokens em vesting ### Previsões de Analistas 2026 | Fonte | Previsão 2026 | Premissa | | ----------------- | ------------- | ------------------------------ | | Otimista (VanEck) | $600+ | ETF aprovado, adoção em massa | | Moderado | $400-500 | Crescimento orgânico | | Conservador | $250-350 | Status quo | | Pessimista | $100-150 | Bear market, regulação adversa | *** ## Riscos e Considerações ### Riscos Específicos da Solana | Risco | Probabilidade | Impacto | Mitigação | | ----------------------------- | ------------- | ------- | -------------------------- | | Outage da rede | Média | Médio | Rede mais estável em 2026 | | SEC classificar como security | Alta | Alto | Diversifique em BTC/ETH | | Concorrência de L2s | Alta | Médio | SOL tem UX superior | | Hack/exploit | Baixa | Alto | Use carteira hardware | | Vesting de tokens | Certa | Médio | Pressão vendedora esperada | ### Alocação Sugerida | Perfil | % em Cripto | % em SOL (do cripto) | | ------------- | ----------- | -------------------- | | Conservador | 0-5% | 0-10% | | Moderado | 5-15% | 10-20% | | Agressivo | 15-30% | 20-30% | | Cripto-nativo | 30%+ | 15-25% | ### Checklist Antes de Investir * [ ] Entendo que SOL é mais volátil que BTC (\~2x) * [ ] Não estou investindo dinheiro que preciso * [ ] Tenho reserva de emergência em ativos tradicionais * [ ] Sei usar carteira Phantom ou equivalente * [ ] Entendo os riscos de centralização e outages * [ ] Tenho plano de saída (take profit definido) *** ## Conclusão **Solana** consolidou-se como a principal alternativa ao Ethereum, oferecendo velocidade e taxas imbatíveis. Para investidores brasileiros, representa uma oportunidade de exposição a uma blockchain de alta performance com ecossistema vibrante. **Resumo:** * ✅ **Prós**: Rápida, barata, ecossistema ativo, staking 7-8% * ❌ **Contras**: Volátil, histórico de outages, mais centralizada **Próximos passos:** 1. [Entenda o básico de Bitcoin](/blog/bitcoin-brasil-como-investir-analise) 2. [Compare com Ethereum](/blog/ethereum-eth-guia-completo-brasil-2026) 3. [Veja ETFs de cripto na bolsa brasileira](/blog/etfs-criptomoedas-b3-hash11-bith11-guia-2026) 4. [Aprenda sobre DeFi](/blog/defi-financas-descentralizadas-guia-iniciantes-2026) *** *Dados atualizados para janeiro de 2026. Criptomoedas são investimentos de alto risco. Solana tem volatilidade \~2x maior que Bitcoin. Nunca invista mais do que pode perder.* # Stablecoins no Brasil 2026: USDT, USDC, BRZ e DREX Explicados URL: /blog/stablecoins-brasil-usdt-brz-drex-guia-2026.mdx Guia completo sobre stablecoins no Brasil. Como usar USDT, USDC, BRZ, o que é o DREX do Banco Central e como stablecoins revolucionam pagamentos. *** searchable: true title: 'Stablecoins no Brasil 2026: USDT, USDC, BRZ e DREX Explicados' description: 'Guia completo sobre stablecoins no Brasil. Como usar USDT, USDC, BRZ, o que é o DREX do Banco Central e como stablecoins revolucionam pagamentos.' date: '2026-01-01' keywords: 'stablecoin brasil, usdt como comprar, brz token, drex banco central, usdc brasil, tether brasil, stablecoin real, dolar digital cripto, 2026' author: 'Equipe brapi.dev' category: 'Investimentos' subcategory: 'Criptomoedas' readingTime: '18 min' tags: \['Stablecoins', 'USDT', 'USDC', 'BRZ', 'DREX', 'Criptomoedas', 'Pagamentos'] relatedPosts: \['bitcoin-brasil-como-investir-analise', 'ethereum-eth-guia-completo-brasil-2026', 'como-declarar-criptomoedas-imposto-renda-2026', 'solana-sol-guia-completo-brasil-2026', 'altcoins-promissoras-analise-2026'] featured: true expertise: 'Análise do ecossistema de stablecoins com foco em regulamentação brasileira' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; As **stablecoins** são criptomoedas projetadas para manter valor estável, geralmente atreladas a moedas fiduciárias como dólar ou real. Em 2026, elas movimentam mais de **$250 bilhões diariamente** e transformam como brasileiros fazem remessas, protegem patrimônio e acessam o ecossistema cripto. Este guia explica tudo sobre stablecoins no contexto brasileiro, incluindo o **DREX** – a moeda digital do Banco Central. ## Sumário 1. [O que são Stablecoins?](#o-que-sao-stablecoins) 2. [Tipos de Stablecoins](#tipos-stablecoins) 3. [USDT (Tether): A Maior Stablecoin](#usdt-tether) 4. [USDC (Circle): A Mais Regulada](#usdc-circle) 5. [BRZ: A Stablecoin do Real](#brz-stablecoin-real) 6. [DREX: O Real Digital do Banco Central](#drex-real-digital) 7. [Casos de Uso no Brasil](#casos-uso-brasil) 8. [Como Comprar Stablecoins](#como-comprar-stablecoins) 9. [Regulamentação e Tributação](#regulamentacao-tributacao) 10. [Riscos e Considerações](#riscos-consideracoes) *** ## O que são Stablecoins? Stablecoins são **criptomoedas com preço estável**, geralmente mantendo paridade 1:1 com uma moeda fiduciária (dólar, euro, real). Elas combinam os benefícios das criptos (rapidez, disponibilidade 24/7, programabilidade) com a estabilidade das moedas tradicionais. ### Por que Stablecoins Existem? | Problema | Como Stablecoins Resolvem | | ---------------------------- | ---------------------------------- | | Bitcoin varia 10% em um dia | USDT mantém \~$1.00 sempre | | Bancos fecham fim de semana | Stablecoins funcionam 24/7/365 | | Remessa internacional cara | Envio global por centavos | | Difícil precificar em cripto | Preços estáveis em dólar | | Exclusão financeira | Qualquer um com internet pode usar | ### Stablecoins em Números (2026) | Métrica | Valor | | ---------------- | ------------------------ | | Market Cap Total | \~$250 bilhões | | Volume Diário | \~$70-120 bilhões | | Dominância USDT | \~68% | | Dominância USDC | \~22% | | Crescimento 2026 | +50% | | Projeção 2027 | $600 bilhões (MB Report) | **Principais usos no Brasil:** * Remessas internacionais * Proteção cambial * Trading de cripto * Pagamentos internacionais *** ## Tipos de Stablecoins Existem diferentes mecanismos para manter o preço estável: ### 1. Lastreadas em Fiat (Centralizadas) Uma empresa mantém reservas em dólar/real em bancos tradicionais e emite tokens correspondentes. | Stablecoin | Lastro | Emissor | Auditoria | | ---------- | --------------- | ------------- | ---------- | | USDT | USD (+ títulos) | Tether | Trimestral | | USDC | USD (100%) | Circle | Mensal | | BRZ | BRL | Transfero | Mensal | | BUSD | USD | Binance/Paxos | Mensal | **Prós:** Simples, estável, alta liquidez **Contras:** Centralizado, risco de contraparte, pode ser congelado ### 2. Colateralizadas em Cripto (Descentralizadas) Usuários depositam cripto como garantia e emitem stablecoins. Sobre-colateralização protege contra volatilidade. | Stablecoin | Colateral | Protocolo | Colateralização | | ---------- | --------------- | ------------ | --------------- | | DAI | ETH, USDC, etc. | MakerDAO | 150%+ | | LUSD | ETH | Liquity | 110%+ | | FRAX | Híbrido | Frax Finance | Parcial | | crvUSD | Multi-cripto | Curve | 150%+ | **Prós:** Descentralizado, transparente, censura-resistente **Contras:** Complexo, risco de liquidação, capital ineficiente ### 3. Algorítmicas (Experimental) Usam algoritmos e arbitragem para manter o peg, sem lastro real. ⚠️ **ALERTA:** A maioria falhou (UST/Terra em 2022 perdeu $40 bilhões). Evite. ### Comparativo de Stablecoins | Nome | Tipo | Market Cap | Descentralizado | Risco Depeg | | ---- | ----------------- | ---------- | --------------- | ----------- | | USDT | Fiat-backed | $140B | ❌ Não | Baixo | | USDC | Fiat-backed | $45B | ❌ Não | Muito Baixo | | DAI | Crypto-backed | $5B | ✅ Sim | Baixo | | BRZ | Fiat-backed (BRL) | $15M | ❌ Não | Baixo | **Recomendação por caso de uso:** * **Trading/Exchanges:** USDT (maior liquidez) * **Longo prazo/Segurança:** USDC (melhor auditoria) * **DeFi descentralizado:** DAI (censura-resistente) * **Operações em Real:** BRZ (evita exposição cambial) *** ## USDT (Tether): A Maior Stablecoin O **Tether (USDT)** é a stablecoin mais usada do mundo, com market cap de \~$140 bilhões. É a porta de entrada para a maioria dos traders e usuários de cripto. ### Características | Atributo | Valor | | ------------- | ------------------------------------ | | Peg | 1 USDT = 1 USD | | Market Cap | \~$140 bilhões | | Redes | Ethereum, Tron, Solana, Polygon, +15 | | Emissor | Tether Limited (Hong Kong) | | Reservas | USD, T-Bills, empréstimos, BTC | | Volume diário | \~$50 bilhões | ### Composição das Reservas (2026) **💵 Cash & Equivalentes (84%)** * T-Bills (Títulos EUA): 80% * Fundos MMF: 3% * Cash em bancos: 1% **🏢 Outros Investimentos (16%)** * Empréstimos garantidos: 6% * Bitcoin: 4% * Metais preciosos: 3% * Outros: 3% | Métrica | Valor | | ------------------ | -------------- | | Total de Ativos | \~$145 bilhões | | Passivos (USDT) | \~$140 bilhões | | Excesso de Reserva | \~$5 bilhões | ### Controvérsias O USDT enfrentou questionamentos sobre suas reservas: * **2021**: Multa de $41M da CFTC por declarações enganosas * **2022-23**: Melhorou transparência após pressão * **2024-25**: Lucro recorde ($8B+), reservas mais conservadoras ### Onde Usar USDT | Caso de Uso | Plataforma | | --------------- | ------------------------------------- | | Comprar cripto | Binance, Mercado Bitcoin | | Remessas | Transferência direta wallet-to-wallet | | DeFi | Aave, Compound, Uniswap | | Trading | Qualquer exchange | | Salvar em dólar | Carteira própria | *** ## USDC (Circle): A Mais Regulada O **USD Coin (USDC)** é considerado a stablecoin mais transparente e regulada, emitido pela Circle em parceria com a Coinbase. ### Características | Atributo | Valor | | ---------- | ---------------------------------------------- | | Peg | 1 USDC = 1 USD | | Market Cap | \~$45 bilhões | | Redes | Ethereum, Solana, Polygon, Base, Arbitrum, +10 | | Emissor | Circle (EUA) | | Reservas | 100% cash + T-Bills de curto prazo | | Auditoria | Mensal (Grant Thornton) | ### Por que USDC é Considerado Mais Seguro **Vantagens do USDC:** * ✅ Reservas 100% em USD e T-Bills curto prazo * ✅ Auditoria mensal por firma regulada (Big 4) * ✅ Empresa sediada nos EUA (regulação clara) * ✅ Parceria com Coinbase (exchange regulada) * ✅ Usado por instituições financeiras tradicionais * ✅ Relatório de reservas em tempo real **Porém, considere:** * ❌ Pode congelar endereços (já fez isso) * ❌ Menor liquidez que USDT em algumas exchanges * ❌ Março 2023: Depeg temporário (SVB tinha reservas) ### USDC vs USDT: Qual Escolher? | Critério | USDT | USDC | Vencedor | | ----------------- | ---------- | ---------------- | -------- | | Market Cap | $140B | $45B | 🔵 USDT | | Liquidez/Volume | \~$50B/dia | \~$8B/dia | 🔵 USDT | | Transparência | Trimestral | Mensal | 🟢 USDC | | Reservas | Misto | 100% USD/T-Bills | 🟢 USDC | | Regulação | Offshore | EUA | 🟢 USDC | | Redes disponíveis | 20+ | 15+ | 🔵 USDT | | Pares de trading | Mais | Menos | 🔵 USDT | | Uso institucional | Menos | Mais | 🟢 USDC | **Recomendação:** * **Day trading / Alta liquidez:** USDT * **Longo prazo / Segurança:** USDC * **DeFi Ethereum/Base:** USDC (mais integrado) * **Arbitragem / Muitos pares:** USDT * **Instituições / Compliance:** USDC *** ## BRZ: A Stablecoin do Real O **BRZ** é a maior stablecoin pareada ao Real brasileiro, permitindo que brasileiros operem em cripto sem exposição cambial ao dólar. ### Características | Atributo | Valor | | ---------- | -------------------------------------- | | Peg | 1 BRZ = 1 BRL | | Circulação | \~R$ 15 milhões | | Redes | Ethereum, Polygon, Solana, BSC, +16 | | Emissor | Transfero (Brasil) | | Reservas | BRL em instituição autorizada pelo BCB | | Holders | 5.000+ carteiras | ### Casos de Uso do BRZ 1. **Evitar exposição cambial**: Opere em DeFi sem risco de variação USD/BRL 2. **Pagamentos em cripto**: Receba em BRZ, mantenha valor em Real 3. **Remessas**: Envie Real para qualquer carteira no mundo 4. **Arbitragem**: Aproveite diferenças de preço entre exchanges 5. **Proteção**: Em alta do dólar, já está em Real ### Como Usar BRZ #### Exemplo: Receber pagamento internacional em Real **Cenário:** Freelancer brasileiro recebe $1.000 de cliente nos EUA | Método | Taxa Câmbio | Taxas | Valor Recebido | | -------------------- | ------------------------- | ------ | -------------- | | 🏦 Banco tradicional | R$ 5,50 (spread embutido) | \~5% | R$ 5.225,00 | | 🪙 USDT → BRZ | R$ 5,80 (mercado) | \~0,6% | R$ 5.762,81 | **Economia:** R$ 537,81 (10,3% a mais usando stablecoins) **Onde comprar/trocar BRZ:** * Mercado Bitcoin (par BRZ/BRL) * Transfero (emissor oficial) * DEXs: Uniswap, Curve (Polygon, Ethereum) * Foxbit ### Redes Disponíveis para BRZ | Rede | Taxa de Transferência | Velocidade | | -------- | --------------------- | ------------- | | Polygon | \~$0.01 | \~2 segundos | | Solana | \~$0.001 | \~1 segundo | | BSC | \~$0.10 | \~3 segundos | | Ethereum | \~$2-10 | \~15 segundos | | Arbitrum | \~$0.10 | \~2 segundos | | Base | \~$0.01 | \~2 segundos | **Dica:** Use Polygon ou Solana para transferências de BRZ com taxas mínimas. *** ## DREX: O Real Digital do Banco Central O **DREX** (antigo Real Digital) é a **CBDC** (Central Bank Digital Currency) do Brasil, em desenvolvimento pelo Banco Central. Diferente de stablecoins privadas, é moeda emitida diretamente pelo governo. ### O que é DREX? **Definição:** Representação digital do Real (BRL) emitida pelo Banco Central do Brasil em infraestrutura DLT (Distributed Ledger Technology). **DREX NÃO é:** * ❌ Criptomoeda (não é descentralizado) * ❌ Stablecoin (não é emitido por empresa privada) * ❌ Substituto do PIX (são complementares) **DREX É:** * ✅ Moeda legal, emitida pelo BCB * ✅ Programável (smart contracts) * ✅ Tokenizável (ativos financeiros) * ✅ Interoperável com sistema bancário ### Timeline do DREX | Fase | Período | Status | | ------------------ | --------- | --------------- | | Estudos iniciais | 2020-2021 | ✅ Concluído | | Lift Challenge | 2021-2022 | ✅ Concluído | | Piloto Fase 1 | 2023-2024 | ✅ Concluído | | Piloto Fase 2 | 2026 | ✅ Concluído | | Lançamento público | 2026 | 🔄 Em andamento | ### Casos de Uso Planejados 1. **Tokenização de ativos**: Imóveis, veículos, títulos públicos tokenizados 2. **DVP automático**: Delivery vs Payment instantâneo em transações 3. **Pagamentos programáveis**: Contratos inteligentes para pagamentos condicionais 4. **Integração internacional**: CBDCs de outros países (mBridge) 5. **Inclusão financeira**: Acesso via celular sem conta bancária tradicional ### DREX vs Stablecoins Privadas | Característica | DREX | USDT/USDC | BRZ | | ------------------ | ------------------- | --------------------- | ----------------- | | Emissor | Banco Central | Empresas privadas | Transfero | | Regulação | Moeda legal | Varia por país | BCB autorizado | | Privacidade | Controlada pelo BCB | Pseudônimo | Pseudônimo | | Programabilidade | Sim (limitada) | Sim (total) | Sim (total) | | Interoperabilidade | Bancos tradicionais | Cripto nativo | Cripto nativo | | Acesso | Via bancos/fintechs | Qualquer carteira | Qualquer carteira | | Censura | Possível pelo BCB | Possível pelo emissor | Possível | ### Preocupações com DREX | Tema | Preocupação | Resposta do BCB | | ------------------------- | ------------------------------------------------- | -------------------------------------- | | **Privacidade** | BCB terá visibilidade total das transações | Privacidade "proporcional" com camadas | | **Controle** | Possibilidade de congelar ou programar restrições | Funcionalidades de política monetária | | **Exclusão digital** | Idosos e pessoas sem smartphone | Dinheiro físico continuará existindo | | **Segurança cibernética** | Ataques a infraestrutura centralizada | Padrões de segurança bancária | | **Desintermediação** | Impacto em bancos tradicionais | Modelo com intermediários (bancos) | **Conclusão:** DREX e stablecoins privadas (BRZ, USDT) coexistirão. Cada um tem seu caso de uso: * **DREX:** Sistema financeiro regulado, tokenização * **Stablecoins:** Liberdade, DeFi, privacidade *** ## Casos de Uso no Brasil ### 1. Proteção Cambial (Dolarização) Com Real desvalorizando historicamente, muitos brasileiros usam USDT/USDC para manter poder de compra em dólar. #### Simulação: Proteção Cambial com Stablecoins **Investimento inicial:** R$ 50.000 (janeiro 2020) * Cotação USD/BRL 2020: R$ 5,20 * Cotação USD/BRL 2026: R$ 6,00 | Cenário | Estratégia | Valor Final | Ganho | | -------------------- | ------------------- | ------------ | ------------ | | 1️⃣ Poupança | 7% a.a. por 5 anos | R$ 70.127,59 | R$ 20.127,59 | | 2️⃣ USDT (sem yield) | Dolarização simples | R$ 57.692,31 | R$ 7.692,31 | | 3️⃣ USDT + DeFi | 8% a.a. yield | R$ 84.756,89 | R$ 34.756,89 | **Melhor resultado:** USDT + DeFi Yield com R$ 84.756,89 — diferença de +R$ 14.629,30 vs poupança (+20,9%) ### 2. Remessas Internacionais Enviar dinheiro para o exterior via stablecoins é mais rápido e barato que bancos tradicionais. | Método | Taxa | Tempo | Limite | | ----------------- | ------------- | -------- | ---------- | | Banco tradicional | 3-5% + spread | 1-3 dias | Alto | | TransferWise/Wise | 0.5-1.5% | 1-2 dias | Médio | | PIX internacional | 0.5-1% | Minutos | Médio | | Stablecoin (USDT) | \~0.1% | Minutos | Sem limite | ### 3. Freelancers e Nômades Digitais Profissionais que trabalham remotamente para empresas estrangeiras podem receber em USDT e converter para BRL quando precisarem. ### 4. Trading e Arbitragem Stablecoins são usadas como "porto seguro" durante volatilidade e para arbitragem entre exchanges. ### 5. DeFi e Rendimentos Depositar stablecoins em protocolos DeFi pode gerar rendimentos de 5-15% ao ano (com riscos adicionais). *** ## Como Comprar Stablecoins ### No Brasil | Exchange | Stablecoins | Depósito | Taxas | | --------------- | ---------------------- | -------- | -------- | | Binance | USDT, USDC, DAI, FDUSD | PIX | 0.1% | | Mercado Bitcoin | USDT, USDC, BRZ | PIX/TED | 0.3-0.5% | | Foxbit | USDT, BRZ | PIX | 0.5% | | Bitso | USDT, USDC | PIX | 0.5% | ### Passo a Passo #### Tutorial: Comprar USDT no Brasil 1. **Escolha a Exchange** *(5 min)* * Binance (menores taxas) ou Mercado Bitcoin (brasileira) 2. **Faça o Cadastro (KYC)** *(10-30 min)* * Documento, selfie, comprovante de residência 3. **Deposite via PIX** *(Instantâneo)* * Use o QR code gerado pela exchange 4. **Compre USDT** *(Segundos)* * Ordem de mercado (imediata) ou limitada (preço específico) 5. **Decida a Custódia** *(Variável)* * Deixar na exchange OU transferir para carteira própria **Dicas importantes:** * Use sempre ordem limitada para melhores preços * Para valores altos, divida em várias ordens * Se for HODL, transfira para carteira própria * Guarde comprovantes para declaração de IR ### Redes para Transferência Se for transferir stablecoins para carteira própria ou outra exchange, escolha a rede mais barata: | Rede | Taxa Média (USDT) | Velocidade | | ----------------- | ----------------- | ---------- | | TRC-20 (Tron) | \~$1 | \~3 min | | Polygon | \~$0.01 | \~30 seg | | BSC (BNB Chain) | \~$0.10 | \~30 seg | | Arbitrum | \~$0.10 | \~1 min | | Solana | \~$0.01 | \~1 seg | | Ethereum (ERC-20) | \~$2-10 | \~3 min | **⚠️ CUIDADO:** Sempre verifique se a exchange/carteira de destino suporta a rede escolhida! *** ## Regulamentação e Tributação ### Nova Regulação BCB 2026 O Banco Central implementou regras mais rígidas para stablecoins: | Regulação | Descrição | Vigência | | ----------------------- | ---------------------------------------------------- | -------- | | Resolução 519/2026 | Exchanges reportam carteiras de autocustódia | Vigente | | Resolução 520/2026 | Cripto equiparada a câmbio para fins regulatórios | Vigente | | Edital 126 | Segregação patrimonial (ativos clientes vs exchange) | Vigente | | IN RFB 2.291 (DeCripto) | Novas regras de declaração para Receita Federal | Vigente | ### Tributação de Stablecoins Stablecoins são tratadas como **criptoativos** e seguem as mesmas regras de Bitcoin, ETH, etc. #### Tabela de Impostos (Ganho de Capital) | Faixa de Vendas/Lucro | Alíquota | | ------------------------- | ---------- | | Vendas até R$ 35.000/mês | **ISENTO** | | Lucro até R$ 5 milhões | 15% | | Lucro R$ 5-10 milhões | 17,5% | | Lucro R$ 10-30 milhões | 20% | | Lucro acima R$ 30 milhões | 22,5% | **Atenção com stablecoins:** 1. Comprar USDT e vender mais caro = **lucro tributável** 2. Trocar USDT por BTC = **permuta tributável** 3. Receber pagamento em USDT = **renda (IR normal)** 4. Conversão USDT/BRL pode gerar **ganho cambial** #### Declaração Anual * Saldos > R$ 5.000 em cada cripto devem ser declarados * Informar em "Bens e Direitos" (código 89) * GCAP para apurar ganhos mês a mês #### Regras 2026 (DeCripto Vigente) * Declaração mensal obrigatória (não só anual) * Exchanges reportam automaticamente à RFB * Carteiras próprias também devem ser declaradas ### Calculadora de Imposto #### Exemplo: Ganho cambial com USDT | Operação | Valor | | --------------- | -------------------------------- | | Compra | R$ 50.000 (cotação USD: R$ 5,20) | | USDT adquiridos | $9.615,38 | | Venda | R$ 58.000 (cotação USD: R$ 6,10) | | **Lucro** | **R$ 8.000** | **Cálculo do imposto:** Como a venda (R$ 58.000) ultrapassou R$ 35.000/mês: * Base de cálculo: R$ 8.000 * Alíquota: 15% * **Imposto devido: R$ 1.200** Pagar via DARF código 4600 até o último dia útil do mês seguinte à venda. *** ## Riscos e Considerações ### Riscos de Stablecoins | Risco | USDT | USDC | BRZ | DAI | | ----------------------- | ----------- | ----------- | -------- | ----------- | | Depeg (perder paridade) | Baixo | Muito Baixo | Baixo | Médio | | Contraparte (emissor) | Médio | Baixo | Médio | Muito Baixo | | Regulatório | Alto | Médio | Médio | Baixo | | Smart Contract | Muito Baixo | Muito Baixo | Baixo | Médio | | Congelamento | Possível | Possível | Possível | Improvável | ### Eventos de Depeg Históricos | Evento | Data | Impacto | Causa | | ---------------- | -------- | ------------------------------------------------- | ------------------------------- | | 🔴 **UST/Terra** | Mai 2022 | Colapso total (-99,99%), perda de \~$40 bilhões | Design algorítmico falho | | 🟡 **USDC** | Mar 2023 | Depeg temporário para $0,87 (recuperou em 3 dias) | Reservas no Silicon Valley Bank | | 🟡 **USDT** | Vários | Flutuações de 1-3% (temporárias) | FUD sobre reservas | | 🟢 **DAI** | - | Manteve peg em todas as crises | Sobre-colateralização funciona | ### Boas Práticas de Segurança 1. **Diversifique**: Não coloque tudo em uma stablecoin só 2. **Custódia**: Para valores altos, use carteira própria (hardware) 3. **Rede**: Escolha redes seguras (Ethereum > BSC para grandes valores) 4. **Pesquise**: Entenda o lastro antes de usar 5. **Limite**: Não mantenha fortuna em stablecoins - são meio de troca *** ## Conclusão Stablecoins são uma das inovações mais práticas do mundo cripto, oferecendo estabilidade para um ecossistema volátil. Para brasileiros, elas representam: * **Proteção cambial** contra desvalorização do Real * **Remessas baratas** para o exterior * **Acesso a DeFi** e rendimentos em dólar * **Praticidade** para trading e pagamentos **Recomendações por perfil:** | Perfil | Stablecoin Recomendada | | ------------------------- | --------------------------- | | Iniciante conservador | USDC (mais regulada) | | Trader ativo | USDT (maior liquidez) | | Operações em Real | BRZ (sem exposição cambial) | | DeFi avançado | DAI (descentralizada) | | Longo prazo institucional | USDC | **Próximos passos:** 1. [Aprenda sobre ETFs de cripto na bolsa brasileira](/blog/etfs-criptomoedas-b3-hash11-bith11-guia-2026) 2. [Como declarar cripto no Imposto de Renda](/blog/como-declarar-criptomoedas-imposto-renda-2026) 3. [Guia completo de DeFi para iniciantes](/blog/defi-financas-descentralizadas-guia-iniciantes-2026) *** *Dados atualizados para janeiro de 2026. Stablecoins podem perder paridade em eventos extremos. Consulte a [API da brapi.dev](https://brapi.dev) para cotações em tempo real.* # Stock Screener com Python: Como Filtrar Ações Brasileiras com a API brapi URL: /blog/stock-screener-python-brapi-filtrar-acoes.mdx Crie um stock screener em Python usando a API brapi. Filtre ações por P/L, dividend yield, ROE, setor e mais ✓ *** searchable: true title: 'Stock Screener com Python: Como Filtrar Ações Brasileiras com a API brapi' description: 'Crie um stock screener em Python usando a API brapi. Filtre ações por P/L, dividend yield, ROE, setor e mais ✓' date: '2026-01-02' keywords: 'stock screener python, filtro de ações, screener ações brasil, como filtrar ações, stock screener bolsa brasileira, api ações python, filtrar ações por indicadores, 2026' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'Python' readingTime: '18 min' tags: \['Python', 'Stock Screener', 'Filtro de Ações', 'API', 'Bolsa Brasileira', 'Análise Fundamentalista', 'Automação', 'Desenvolvimento'] relatedPosts: \['entendendo-indicador-preco-lucro-pl-analise-fundamentalista', 'payout-dividend-yield-sustentabilidade-2026', 'bot-telegram-cotacoes-acoes-python-tutorial'] featured: true expertise: 'Equipe técnica especializada em APIs financeiras e automação de investimentos' lastReviewed: '2026-01-17' -------------------------- import { Authors, Author } from '~/components/Authors'; > Cansado de analisar ação por ação manualmente? Aprenda a criar seu próprio filtro de ações (stock screener) em Python para encontrar oportunidades de investimento automaticamente. *** ## O Que é um Stock Screener? Um **stock screener** (ou filtro de ações) é uma ferramenta que analisa automaticamente centenas de ações e retorna apenas aquelas que atendem aos seus critérios de investimento. **Por que criar seu próprio screener?** | Problema | Solução com Screener Próprio | | ------------------------------- | ---------------------------- | | Analisar 400+ ações manualmente | Filtrar em segundos | | Screeners pagos caros | Gratuito com brapi | | Critérios limitados | Você define as regras | | Dados desatualizados | Dados em tempo real | | Sem automação | Roda automaticamente | *** ## O Que Vamos Construir Ao final deste tutorial, você terá um screener que: 1. Busca todas as ações brasileiras 2. Obtém dados fundamentalistas de cada uma 3. Filtra por múltiplos critérios (P/L, ROE, Dividend Yield, etc.) 4. Exporta resultados para CSV/Excel 5. Pode rodar automaticamente todo dia ``` 📊 RESULTADO DO SCREENER - 17/01/2026 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Critérios: P/L < 10 | ROE > 15% | DY > 5% | Dívida/PL < 1 ✅ BBAS3 | P/L: 4.2 | ROE: 18.5% | DY: 8.2% | Setor: Bancos ✅ TAEE11 | P/L: 7.8 | ROE: 22.1% | DY: 9.5% | Setor: Energia ✅ CMIN3 | P/L: 5.1 | ROE: 28.3% | DY: 12.1% | Setor: Mineração ✅ BBSE3 | P/L: 8.9 | ROE: 19.7% | DY: 7.8% | Setor: Seguros Total: 4 ações encontradas de 387 analisadas ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` *** ## Pré-requisitos ### 1. Python 3.8+ ```bash python --version # Python 3.11.0 ``` ### 2. Bibliotecas Necessárias ```bash pip install requests pandas ``` ### 3. Token da brapi (Gratuito) 1. Acesse [brapi.dev](https://brapi.dev) 2. Crie uma conta gratuita 3. Copie seu token do dashboard *** ## Passo 1: Estrutura Básica Vamos criar a estrutura do nosso screener: ```python # stock_screener.py import requests import pandas as pd from dataclasses import dataclass from typing import Optional import time @dataclass class ScreenerCriteria: """Critérios de filtragem do screener""" # Valuation max_pl: Optional[float] = None # P/L máximo min_pl: Optional[float] = None # P/L mínimo (evitar negativos) max_pvp: Optional[float] = None # P/VP máximo max_psr: Optional[float] = None # P/Receita máximo # Rentabilidade min_roe: Optional[float] = None # ROE mínimo (%) min_roic: Optional[float] = None # ROIC mínimo (%) min_margem_liquida: Optional[float] = None # Margem líquida mínima (%) # Dividendos min_dividend_yield: Optional[float] = None # DY mínimo (%) # Endividamento max_divida_pl: Optional[float] = None # Dívida/PL máximo # Liquidez min_volume_diario: Optional[float] = None # Volume mínimo diário # Setor setores: Optional[list] = None # Lista de setores permitidos excluir_setores: Optional[list] = None # Setores a excluir class BrapiScreener: """Stock Screener usando a API brapi""" def __init__(self, token: str): self.token = token self.base_url = "https://brapi.dev/api" self.all_stocks = [] self.filtered_stocks = [] def get_all_tickers(self) -> list: """Obtém lista de todas as ações disponíveis""" url = f"{self.base_url}/quote/list" params = {"token": self.token} response = requests.get(url, params=params) data = response.json() # Filtra apenas ações (exclui FIIs, ETFs, BDRs por padrão) stocks = [ item['stock'] for item in data.get('stocks', []) if item.get('type') == 'stock' ] print(f"📋 {len(stocks)} ações encontradas na bolsa brasileira") return stocks def get_stock_data(self, tickers: list, batch_size: int = 20) -> list: """Obtém dados fundamentalistas das ações em lotes""" all_data = [] # Processa em lotes para não sobrecarregar a API for i in range(0, len(tickers), batch_size): batch = tickers[i:i + batch_size] batch_str = ','.join(batch) url = f"{self.base_url}/quote/{batch_str}" params = { "token": self.token, "modules": "defaultKeyStatistics,financialData,summaryProfile" } try: response = requests.get(url, params=params, timeout=30) data = response.json() if 'results' in data: all_data.extend(data['results']) # Progresso progress = min(i + batch_size, len(tickers)) print(f"⏳ Processando: {progress}/{len(tickers)} ações...") # Rate limiting time.sleep(0.5) except Exception as e: print(f"❌ Erro no lote {i}: {e}") continue return all_data def apply_filters(self, stocks: list, criteria: ScreenerCriteria) -> list: """Aplica os filtros definidos nos critérios""" filtered = [] for stock in stocks: if self._matches_criteria(stock, criteria): filtered.append(stock) return filtered def _matches_criteria(self, stock: dict, criteria: ScreenerCriteria) -> bool: """Verifica se uma ação atende aos critérios""" # Extrai dados com valores padrão stats = stock.get('defaultKeyStatistics', {}) financial = stock.get('financialData', {}) profile = stock.get('summaryProfile', {}) pl = stats.get('trailingPE') pvp = stats.get('priceToBook') roe = financial.get('returnOnEquity') roic = financial.get('returnOnAssets') # Aproximação dy = stats.get('dividendYield') margem = financial.get('profitMargins') volume = stock.get('regularMarketVolume') setor = profile.get('sector', '') # Aplica filtros (None = ignorar critério) # P/L if criteria.max_pl is not None: if pl is None or pl <= 0 or pl > criteria.max_pl: return False if criteria.min_pl is not None: if pl is None or pl < criteria.min_pl: return False # P/VP if criteria.max_pvp is not None: if pvp is None or pvp <= 0 or pvp > criteria.max_pvp: return False # ROE if criteria.min_roe is not None: if roe is None or (roe * 100) < criteria.min_roe: return False # Dividend Yield if criteria.min_dividend_yield is not None: if dy is None or (dy * 100) < criteria.min_dividend_yield: return False # Margem Líquida if criteria.min_margem_liquida is not None: if margem is None or (margem * 100) < criteria.min_margem_liquida: return False # Volume if criteria.min_volume_diario is not None: if volume is None or volume < criteria.min_volume_diario: return False # Setores if criteria.setores is not None: if setor not in criteria.setores: return False if criteria.excluir_setores is not None: if setor in criteria.excluir_setores: return False return True def run(self, criteria: ScreenerCriteria) -> pd.DataFrame: """Executa o screener completo""" print("\n🔍 INICIANDO STOCK SCREENER") print("=" * 50) # 1. Busca todas as ações tickers = self.get_all_tickers() # 2. Obtém dados fundamentalistas print("\n📊 Buscando dados fundamentalistas...") stocks_data = self.get_stock_data(tickers) # 3. Aplica filtros print("\n🎯 Aplicando filtros...") filtered = self.apply_filters(stocks_data, criteria) # 4. Converte para DataFrame df = self._to_dataframe(filtered) print(f"\n✅ {len(df)} ações encontradas de {len(stocks_data)} analisadas") return df def _to_dataframe(self, stocks: list) -> pd.DataFrame: """Converte resultados para DataFrame formatado""" rows = [] for stock in stocks: stats = stock.get('defaultKeyStatistics', {}) financial = stock.get('financialData', {}) profile = stock.get('summaryProfile', {}) rows.append({ 'Ticker': stock.get('symbol', ''), 'Nome': stock.get('shortName', ''), 'Preço': stock.get('regularMarketPrice', 0), 'P/L': stats.get('trailingPE', 0), 'P/VP': stats.get('priceToBook', 0), 'ROE (%)': (financial.get('returnOnEquity', 0) or 0) * 100, 'DY (%)': (stats.get('dividendYield', 0) or 0) * 100, 'Margem (%)': (financial.get('profitMargins', 0) or 0) * 100, 'Volume': stock.get('regularMarketVolume', 0), 'Setor': profile.get('sector', ''), }) df = pd.DataFrame(rows) # Ordena por Dividend Yield if not df.empty: df = df.sort_values('DY (%)', ascending=False) return df ``` *** ## Passo 2: Usando o Screener ### Exemplo 1: Value Investing (Graham/Bazin) Critérios clássicos de value investing: ```python # Screener Value Investing if __name__ == "__main__": # Seu token da brapi TOKEN = "SEU_TOKEN_AQUI" # Inicializa o screener screener = BrapiScreener(TOKEN) # Define critérios Value Investing criterios_value = ScreenerCriteria( max_pl=15, # P/L abaixo de 15 min_pl=0, # P/L positivo (lucro) max_pvp=1.5, # P/VP abaixo de 1.5 min_roe=10, # ROE acima de 10% min_dividend_yield=4, # DY acima de 4% ) # Executa resultados = screener.run(criterios_value) # Exibe resultados print("\n📊 AÇÕES VALUE INVESTING") print(resultados.to_string(index=False)) # Salva em CSV resultados.to_csv('acoes_value.csv', index=False) print("\n💾 Resultados salvos em acoes_value.csv") ``` ### Exemplo 2: Dividend Growth (Crescimento de Dividendos) ```python # Screener Dividendos criterios_dividendos = ScreenerCriteria( min_dividend_yield=6, # DY acima de 6% max_pl=12, # P/L razoável min_roe=12, # Empresa rentável min_margem_liquida=10, # Margem saudável ) resultados = screener.run(criterios_dividendos) print("\n💰 MELHORES PAGADORAS DE DIVIDENDOS") print(resultados.to_string(index=False)) ``` ### Exemplo 3: Screener Setorial (Bancos) ```python # Screener Setor Bancário criterios_bancos = ScreenerCriteria( setores=['Financial Services'], max_pl=10, min_roe=12, min_dividend_yield=5, ) resultados = screener.run(criterios_bancos) print("\n🏦 MELHORES BANCOS PARA INVESTIR") print(resultados.to_string(index=False)) ``` ### Exemplo 4: Small Caps Subvalorizadas ```python # Screener Small Caps criterios_small = ScreenerCriteria( max_pl=8, # Muito baratas max_pvp=1.0, # Abaixo do valor patrimonial min_roe=15, # Mas rentáveis min_volume_diario=100000, # Liquidez mínima ) resultados = screener.run(criterios_small) print("\n🔍 SMALL CAPS SUBVALORIZADAS") print(resultados.to_string(index=False)) ``` *** ## Passo 3: Estratégias Avançadas ### Magic Formula (Joel Greenblatt) A Magic Formula combina empresas baratas E de qualidade: ```python class MagicFormulaScreener(BrapiScreener): """Implementação da Magic Formula de Joel Greenblatt""" def run_magic_formula(self, top_n: int = 30) -> pd.DataFrame: """Executa a Magic Formula e retorna as top N ações""" # Busca todas as ações tickers = self.get_all_tickers() stocks_data = self.get_stock_data(tickers) # Calcula rankings rankings = [] for stock in stocks_data: stats = stock.get('defaultKeyStatistics', {}) financial = stock.get('financialData', {}) # Earnings Yield (inverso do P/L) = quanto maior, melhor pl = stats.get('trailingPE') earnings_yield = (1 / pl * 100) if pl and pl > 0 else 0 # Return on Capital = ROE como proxy roc = (financial.get('returnOnEquity') or 0) * 100 if earnings_yield > 0 and roc > 0: rankings.append({ 'symbol': stock.get('symbol'), 'name': stock.get('shortName'), 'price': stock.get('regularMarketPrice'), 'earnings_yield': earnings_yield, 'roc': roc, 'pl': pl, }) df = pd.DataFrame(rankings) if df.empty: return df # Rank por Earnings Yield (maior = melhor = rank menor) df['rank_ey'] = df['earnings_yield'].rank(ascending=False) # Rank por ROC (maior = melhor = rank menor) df['rank_roc'] = df['roc'].rank(ascending=False) # Magic Formula = soma dos ranks (menor = melhor) df['magic_score'] = df['rank_ey'] + df['rank_roc'] # Ordena pelo score df = df.sort_values('magic_score').head(top_n) # Formata saída result = df[['symbol', 'name', 'price', 'pl', 'earnings_yield', 'roc', 'magic_score']] result.columns = ['Ticker', 'Nome', 'Preço', 'P/L', 'Earnings Yield', 'ROC', 'Score'] return result.reset_index(drop=True) # Uso screener = MagicFormulaScreener(TOKEN) magic_portfolio = screener.run_magic_formula(top_n=20) print("\n🎩 MAGIC FORMULA - TOP 20") print(magic_portfolio.to_string(index=False)) ``` ### Piotroski F-Score Indicador de qualidade financeira (0-9 pontos): ```python def calculate_piotroski_score(stock: dict) -> int: """Calcula o F-Score de Piotroski (0-9)""" score = 0 stats = stock.get('defaultKeyStatistics', {}) financial = stock.get('financialData', {}) # 1. ROA positivo roa = financial.get('returnOnAssets', 0) or 0 if roa > 0: score += 1 # 2. Fluxo de caixa operacional positivo ocf = financial.get('operatingCashflow', 0) or 0 if ocf > 0: score += 1 # 3. ROA crescente (precisaria de histórico) # Simplificado: ROA > 5% = bom if roa > 0.05: score += 1 # 4. Qualidade dos lucros (FCO > Lucro) net_income = financial.get('netIncomeToCommon', 0) or 0 if ocf > net_income: score += 1 # 5-9: Precisariam de dados históricos comparativos # Para simplificar, usamos proxies # 5. Dívida reduzindo (Dívida/PL < 1 = bom) debt_equity = financial.get('debtToEquity', 999) or 999 if debt_equity < 100: # < 1 em percentual score += 1 # 6. Liquidez (current ratio > 1) current_ratio = financial.get('currentRatio', 0) or 0 if current_ratio > 1: score += 1 # 7. Sem diluição (simplificado: P/VP < 2) pvp = stats.get('priceToBook', 999) or 999 if pvp < 2: score += 1 # 8. Margem bruta positiva gross_margin = financial.get('grossMargins', 0) or 0 if gross_margin > 0.2: # > 20% score += 1 # 9. Giro do ativo (simplificado: receita > 0) revenue = financial.get('totalRevenue', 0) or 0 if revenue > 0: score += 1 return score # Adiciona ao screener def run_piotroski(self) -> pd.DataFrame: """Screener com Piotroski F-Score""" tickers = self.get_all_tickers() stocks_data = self.get_stock_data(tickers) results = [] for stock in stocks_data: score = calculate_piotroski_score(stock) if score >= 7: # Apenas ações com score alto results.append({ 'Ticker': stock.get('symbol'), 'Nome': stock.get('shortName'), 'Preço': stock.get('regularMarketPrice'), 'F-Score': score, }) df = pd.DataFrame(results) return df.sort_values('F-Score', ascending=False) ``` *** ## Passo 4: Automação e Alertas ### Rodar Diariamente com Cron ```python # screener_diario.py import schedule import time from datetime import datetime def executar_screener(): """Executa o screener e salva resultados""" print(f"\n⏰ Executando screener às {datetime.now()}") screener = BrapiScreener(TOKEN) criterios = ScreenerCriteria( max_pl=12, min_roe=12, min_dividend_yield=5, ) resultados = screener.run(criterios) # Salva com data filename = f"screener_{datetime.now().strftime('%Y%m%d')}.csv" resultados.to_csv(filename, index=False) print(f"💾 Salvo em {filename}") # Envia alerta se encontrar novas oportunidades if len(resultados) > 0: enviar_alerta(resultados) def enviar_alerta(df): """Envia notificação com resultados""" # Implementar: email, Telegram, Discord, etc. print(f"📧 {len(df)} oportunidades encontradas!") # Agenda para rodar às 18:00 (após fechamento do mercado) schedule.every().day.at("18:00").do(executar_screener) print("🤖 Screener automático iniciado...") while True: schedule.run_pending() time.sleep(60) ``` ### Exportar para Excel com Formatação ```python def exportar_excel(df: pd.DataFrame, filename: str): """Exporta para Excel com formatação profissional""" with pd.ExcelWriter(filename, engine='openpyxl') as writer: df.to_excel(writer, sheet_name='Screener', index=False) # Formata a planilha worksheet = writer.sheets['Screener'] # Ajusta largura das colunas for column in worksheet.columns: max_length = max(len(str(cell.value)) for cell in column) worksheet.column_dimensions[column[0].column_letter].width = max_length + 2 print(f"📊 Exportado para {filename}") # Uso exportar_excel(resultados, 'screener_resultado.xlsx') ``` *** ## Exemplos de Saída ### Screener Value Investing ``` 📊 AÇÕES VALUE INVESTING ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Ticker Nome Preço P/L P/VP ROE(%) DY(%) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ BBAS3 BANCO DO BRASIL 52.30 4.2 0.8 18.5 8.2 CMIN3 CSN MINERAÇÃO 5.80 5.1 1.2 28.3 12.1 BBSE3 BB SEGURIDADE 35.40 8.9 1.4 19.7 7.8 TAEE11 TAESA 35.20 7.8 1.3 22.1 9.5 CMIG4 CEMIG 12.50 6.2 0.9 15.2 8.9 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` ### Magic Formula Top 10 ``` 🎩 MAGIC FORMULA - TOP 10 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ # Ticker Nome P/L EY(%) ROC(%) Score ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1 CMIN3 CSN MINERAÇÃO 5.1 19.6 28.3 12 2 BBAS3 BANCO DO BRASIL 4.2 23.8 18.5 15 3 GOAU4 GERDAU MET 6.8 14.7 21.2 18 4 GGBR4 GERDAU 5.9 16.9 19.8 21 5 CSNA3 CSN 4.5 22.2 16.1 24 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` *** ## Código Completo O código completo está disponível para download: ```python # Arquivo: stock_screener_completo.py # GitHub: github.com/brapi-dev/examples/stock-screener # Instalação: # pip install requests pandas openpyxl schedule # Uso: # python stock_screener_completo.py --token SEU_TOKEN --strategy value ``` *** ## Próximos Passos 1. **[Crie sua conta gratuita](https://brapi.dev)** - 15.000 requisições/mês 2. **[Veja a documentação da API](/docs)** - Todos os endpoints disponíveis 3. **[Teste no playground](/playground)** - Experimente antes de programar 4. **[Tutorial de Backtesting](/blog/backtesting-estrategias-brapi)** - Teste suas estratégias *** ## FAQ ### Quantas requisições o screener usa? Depende do número de ações. Para \~400 ações em lotes de 20: * \~20 requisições para dados * Cabe no plano gratuito (15.000/mês) rodando \~25x/mês ### Posso incluir FIIs no screener? Sim! Modifique o filtro em `get_all_tickers()`: ```python if item.get('type') in ['stock', 'fund']: # Inclui FIIs ``` ### Os dados são em tempo real? Depende do seu plano: * Gratuito: 30 min delay * Startup: 15 min delay * Pro: 5 min delay Para screener fundamentalista, isso é mais que suficiente. *** *Automatize sua busca por ações com a brapi.dev. [Comece gratuitamente agora!](https://brapi.dev)* # Stop Loss e Stop Gain: Como Usar Ordens de Stop para Proteger Investimentos URL: /blog/stop-loss-stop-gain-como-usar.mdx Guia completo sobre ordens stop loss e stop gain com estratégias de posicionamento, cálculo de risco e código Python para automatizar alertas ✓ *** searchable: true title: 'Stop Loss e Stop Gain: Como Usar Ordens de Stop para Proteger Investimentos' description: 'Guia completo sobre ordens stop loss e stop gain com estratégias de posicionamento, cálculo de risco e código Python para automatizar alertas ✓' date: '2026-01-01' keywords: 'stop loss, stop gain, ordem stop, gerenciamento de risco, proteção de capital, trading, como usar stop loss, trailing stop' author: 'Equipe brapi.dev' category: 'Estratégias de Investimento' subcategory: 'Gerenciamento de Risco' readingTime: '18 min' tags: \['Stop Loss', 'Stop Gain', 'Gerenciamento de Risco', 'Trading', 'Proteção de Capital'] relatedPosts: \['day-trade-swing-trade-position-trade-2026', 'analise-tecnica-vs-fundamentalista-qual-escolher', 'carteira-de-acoes-como-montar-diversificar', 'como-analisar-acoes-guia-iniciantes-2026'] featured: true expertise: 'Especialistas em gerenciamento de risco e estratégias de trading' lastReviewed: 2026-01-03 ------------------------ ## O Que São Ordens de Stop? Ordens de **stop loss** e **stop gain** são ferramentas essenciais de gerenciamento de risco que automatizam a saída de uma posição quando o preço atinge determinado patamar. ``` ┌─────────────────────────────────────────────────────────────────┐ │ ORDENS DE STOP EXPLICADAS │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ STOP GAIN │ │ (Realização de Lucro) │ │ ▲ │ │ │ +15% │ │ ───────────────────────────────────────── R$ 46,00 │ │ │ │ │ │ │ │ ═══════════════════════════════════════════ R$ 40,00 │ │ PREÇO DE COMPRA │ │ │ │ │ │ │ │ ───────────────────────────────────────── R$ 36,00 │ │ │ -10% │ │ ▼ │ │ STOP LOSS │ │ (Limitação de Perda) │ │ │ └─────────────────────────────────────────────────────────────────┘ ``` ### Stop Loss vs Stop Gain | Característica | Stop Loss | Stop Gain | | ---------------- | ----------------------------- | ---------------------- | | Objetivo | Limitar prejuízos | Garantir lucros | | Acionado quando | Preço CAI até o stop | Preço SOBE até o stop | | Emoção combatida | Esperança (esperar recuperar) | Ganância (querer mais) | | Essencialidade | OBRIGATÓRIO | Opcional/estratégico | ## Por Que Usar Stop Loss é Obrigatório? ### A Matemática da Recuperação Perdas são assimétricas - quanto maior a perda, mais difícil recuperar: ### Matemática da Recuperação | Se você perde | Precisa ganhar para recuperar | | ------------- | ----------------------------- | | -5% | +5,3% | | -10% | +11,1% | | -15% | +17,6% | | -20% | +25,0% | | -25% | +33,3% | | -30% | +42,9% | | -40% | +66,7% | | -50% | +100,0% | | -60% | +150,0% | | -70% | +233,3% | | -80% | +400,0% | | -90% | +900,0% | **Fórmula:** Recuperação necessária = (1 / (1 - perda%)) - 1 > **Conclusão:** Perder 50% exige ganhar 100% para voltar ao zero! É MUITO mais fácil prevenir perdas do que recuperar. ### Controle Emocional ``` CICLO EMOCIONAL SEM STOP LOSS Compra a R$ 40,00 │ ▼ Cai para R$ 38,00 (-5%) "É só uma correção, vai voltar" │ ▼ Cai para R$ 34,00 (-15%) "Agora não posso vender, está muito barato" │ ▼ Cai para R$ 28,00 (-30%) "Vou fazer preço médio!" (ERRO!) │ ▼ Cai para R$ 20,00 (-50%) "Estou preso, não vou realizar prejuízo" │ ▼ Cai para R$ 12,00 (-70%) "Desisti, virou pó mesmo..." │ ▼ Vende no fundo ou empresa quebra COM STOP LOSS A 10%: Compra a R$ 40,00 → Stop em R$ 36,00 Acionado: Perde 10%, preserva 90% do capital Segue para próxima oportunidade! ``` ## Tipos de Ordens de Stop ### 1. Stop Loss Fixo O mais simples - preço fixo de saída: **Fórmula:** Stop Loss = Preço de Entrada × (1 - Percentual / 100) **Exemplo prático:** | Parâmetro | Valor | | --------------------- | ------------ | | Preço de entrada | R$ 40,00 | | Percentual de stop | 10% | | **Stop Loss** | **R$ 36,00** | | Perda máxima por ação | R$ 4,00 | **Percentuais recomendados por perfil:** | Perfil | Stop Loss | Indicado para | | ----------- | --------- | ------------------------------ | | Conservador | 5-7% | Swing trade, blue chips | | Moderado | 8-10% | Posição, ações médias | | Agressivo | 12-15% | Small caps, maior volatilidade | ### 2. Stop Loss Técnico (Suporte) Baseado em níveis técnicos do gráfico: **Fórmula:** Stop = Suporte × (1 - Margem de Segurança) **Exemplo prático:** | Parâmetro | Valor | | -------------------- | ------------ | | Preço de entrada | R$ 40,00 | | Suporte identificado | R$ 37,50 | | Margem de segurança | 2% | | **Stop Loss** | **R$ 36,75** | | Risco percentual | 8,1% | > **Lógica:** Se o preço perder o suporte, a análise técnica estava errada. Sair rápido e reavaliar. ``` STOP TÉCNICO EM SUPORTE │ 42 ──┤ ╭───╮ │ ╭──╯ ╰──╮ 40 ──┤ ENTRADA → ────● ╰─── │ ╱ 38 ──┤ ╭──╯ │ ╭───╯ 36 ──┤ ══════════════════════════════ SUPORTE │ STOP LOSS → ─ ─ ─ ─ ─ ─ ─ ─ (2% abaixo) 34 ──┤ │ └──────────────────────────────── Jan Fev Mar Abr Mai Lógica: Se perder o suporte, a análise estava errada Sair rápido e reavaliar ``` ### 3. Trailing Stop (Stop Móvel) O stop sobe junto com o preço, protegendo lucros: **Funcionamento:** A cada nova máxima, o stop sobe. Nunca desce. **Exemplo de simulação com trailing stop de 8%:** | Dia | Preço | Máximo | Stop Móvel | Status | | --- | -------- | -------- | ---------- | -------------------- | | 1 | R$ 40,00 | R$ 40,00 | R$ 36,80 | Posição aberta | | 2 | R$ 41,00 | R$ 41,00 | R$ 37,72 | Stop sobe | | 3 | R$ 43,00 | R$ 43,00 | R$ 39,56 | Stop sobe | | 4 | R$ 45,00 | R$ 45,00 | R$ 41,40 | Stop sobe | | 5 | R$ 47,00 | R$ 47,00 | R$ 43,24 | Stop sobe (nova máx) | | 6 | R$ 46,00 | R$ 47,00 | R$ 43,24 | Stop mantido | | 7 | R$ 44,00 | R$ 47,00 | R$ 43,24 | Stop mantido | | 8 | R$ 43,00 | R$ 47,00 | R$ 43,24 | **STOP ACIONADO** | **Resultado:** Comprou a R$ 40, vendeu a R$ 43,24 (lucro de 8%). Máximo foi R$ 47, mas protegeu parte do ganho. ``` TRAILING STOP EM AÇÃO Preço Stop Móvel │ 47├─────────────●────────┐ │ ╱ ╲ │ 45├─────────╱ ╲ ├── Stop sobe para R$ 43,24 │ ╱ ╲ │ 43├─────╱ ╲ ├── Stop sobe para R$ 41,40 │ ╱ ╲ │ 41├──╱ ╲──┼── Stop sobe para R$ 39,56 │ ╱ ╲ │ 39├● ╲├── STOP INICIAL R$ 36,80 │ X─── STOP ACIONADO! 37├ │ └──1──2──3──4──5──6──7──8──Dias Resultado: Comprou a R$ 40, vendeu a R$ 43,24 (lucro de 8%) Máximo foi R$ 47, mas protegeu parte do ganho ``` ### 4. Stop Gain (Take Profit) Garante realização de lucros: **Fórmulas:** * Stop Gain = Preço de Entrada × (1 + Alvo% / 100) * Risco/Retorno = Ganho Potencial / Perda Potencial **Exemplo prático:** | Parâmetro | Valor | | ----------------- | ---------------------- | | Preço de entrada | R$ 40,00 | | Alvo (stop gain) | +15% → R$ 46,00 | | Stop loss | -7% → R$ 37,20 | | Ganho potencial | R$ 6,00 | | Perda potencial | R$ 2,80 | | **Risco/Retorno** | **2,14:1 (Favorável)** | **Classificação do setup:** | Risco/Retorno | Avaliação | | ------------- | ------------ | | ≥ 3:1 | Excelente | | ≥ 2:1 | Favorável | | ≥ 1:1 | Neutro | | \< 1:1 | Desfavorável | ``` ## Onde Posicionar o Stop Loss? ### Métodos de Posicionamento **Dados do exemplo:** Entrada R$ 40,00 | Suporte R$ 37,50 | ATR R$ 1,20 | MM20 R$ 38,00 | Método | Stop Loss | Distância | |--------|-----------|-----------| | Percentual fixo 7% | R$ 37,20 | -7,0% | | Percentual fixo 10% | R$ 36,00 | -10,0% | | Suporte - 2% | R$ 36,75 | -8,1% | | ATR × 2 | R$ 37,60 | -6,0% | | ATR × 3 | R$ 36,40 | -9,0% | | Média Móvel 20 - 2% | R$ 37,24 | -6,9% | **Qual escolher?** - **Day trade:** ATR × 1,5 a 2 (mais apertado) - **Swing trade:** Suporte ou ATR × 2-3 - **Position trade:** Média móvel ou percentual fixo maior ``` ### Regra do ATR (Volatilidade) **Consulta de dados históricos:** ```typescript const response = await fetch( `https://brapi.dev/api/quote/PETR4?range=1mo&interval=1d`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); const historico = results[0].historicalDataPrice; ``` **Cálculo do ATR (Average True Range):** O ATR mede a volatilidade média diária. O True Range de cada dia é o maior entre: * Máxima - Mínima do dia * |Máxima - Fechamento anterior| * |Mínima - Fechamento anterior| **ATR(14)** = Média dos últimos 14 True Ranges **Exemplo de stop por ATR:** | Ticker | Preço | ATR(14) | Volatilidade | Stop 2×ATR | Stop 3×ATR | | ------ | -------- | ------- | ------------ | ---------- | ---------- | | PETR4 | R$ 38,50 | R$ 1,20 | 3,1% | R$ 36,10 | R$ 34,90 | | VALE3 | R$ 62,00 | R$ 2,50 | 4,0% | R$ 57,00 | R$ 54,50 | | ITUB4 | R$ 32,00 | R$ 0,80 | 2,5% | R$ 30,40 | R$ 29,60 | > **Dica:** Ações mais voláteis precisam de stops mais largos para não serem acionados por ruído. ```` ## Sistema de Alertas Automatizado **Monitoramento de posições com a brapi:** ```typescript const posicoes = ['PETR4', 'VALE3', 'ITUB4']; const response = await fetch( `https://brapi.dev/api/quote/${posicoes.join(',')}`, { headers: { Authorization: `Bearer ${token}` } } ); const { results } = await response.json(); ```` ### Exemplo de Monitoramento de Stops | Ticker | Entrada | Stop Loss | Stop Gain | Preço Atual | Distância Stop | Status | | ------ | -------- | --------- | --------- | ----------- | -------------- | ---------- | | PETR4 | R$ 38,50 | R$ 35,00 | R$ 45,00 | R$ 37,20 | 6,3% | ⚠️ Próximo | | VALE3 | R$ 62,00 | R$ 56,00 | R$ 72,00 | R$ 65,50 | 16,9% | ✅ Normal | | ITUB4 | R$ 32,00 | R$ 29,00 | R$ 38,00 | R$ 34,80 | 20,0% | ✅ Normal | **Níveis de alerta:** | Status | Condição | Ação | | ---------------- | ----------------- | ---------------------- | | 🚨 STOP ACIONADO | Preço ≤ Stop Loss | Vender imediatamente | | ⚠️ Próximo | Distância \< 3% | Monitorar de perto | | 🎯 GAIN ATINGIDO | Preço ≥ Stop Gain | Realizar ou subir stop | | ✅ Normal | Distância > 3% | Manter posição | ``` ## Relação Risco/Retorno ### Análise de Performance de Operações **Exemplo de histórico de trades:** | Operação | Resultado | |----------|-----------| | Trade 1 | +R$ 150 | | Trade 2 | -R$ 80 | | Trade 3 | +R$ 200 | | Trade 4 | -R$ 70 | | Trade 5 | -R$ 90 | | Trade 6 | +R$ 180 | | Trade 7 | +R$ 120 | | Trade 8 | -R$ 75 | | Trade 9 | +R$ 160 | | Trade 10 | -R$ 85 | **Análise consolidada:** | Métrica | Valor | |---------|-------| | Total de operações | 10 | | Wins | 5 | | Losses | 5 | | Taxa de acerto | 50% | | Ganho médio | R$ 162,00 | | Perda média | R$ 80,00 | | **Risco/Retorno** | **2,03:1** | | **Expectativa por trade** | **+R$ 41,00** | | Sistema lucrativo? | ✅ Sim | **Fórmula da expectativa:** (Taxa Acerto × Ganho Médio) - (Taxa Erro × Perda Média) ``` ``` RISCO/RETORNO E TAXA DE ACERTO Com Risco/Retorno 2:1 (ganho 2x a perda): ├── 40% de acerto = LUCRATIVO ├── 50% de acerto = MUITO LUCRATIVO └── 60% de acerto = EXCELENTE Com Risco/Retorno 1:1 (ganho = perda): ├── 50% de acerto = EMPATE ├── 60% de acerto = LUCRATIVO └── 70% de acerto = MUITO LUCRATIVO Com Risco/Retorno 0.5:1 (ganho metade da perda): ├── 60% de acerto = PREJUÍZO ├── 70% de acerto = EMPATE └── 80% de acerto = POUCO LUCRATIVO CONCLUSÃO: Risco/Retorno mínimo de 2:1 dá margem de erro! ``` ## Erros Comuns com Stop Loss ``` ❌ ERROS QUE DESTROEM CAPITAL 1. NÃO USAR STOP "Vou esperar voltar..." → Prejuízos pequenos viram grandes 2. MOVER O STOP PARA BAIXO "Só mais um pouquinho..." → Anula a proteção 3. STOP MUITO APERTADO "Vou colocar 2% de stop" → Acionado por ruído, não tendência 4. STOP MUITO LARGO "Vou dar espaço de 30%" → Perda grande quando aciona 5. NÃO RESPEITAR O STOP "Mas a empresa é boa..." → Psicológico vence a disciplina 6. STOP EM NÚMERO REDONDO "Stop em R$ 40,00" → Concentração de stops, manipulação ``` ## Conclusão: Disciplina é Tudo ### Regras de Ouro do Stop Loss 1. **Sempre use stop** - Sem exceções 2. **Defina antes de comprar** - Nunca depois 3. **Nunca mova para baixo** - Só para cima (trailing) 4. **Respeite o stop** - Execute sem hesitar 5. **Risco/Retorno mínimo 2:1** - Dá margem de erro 6. **Limite perda por operação** - Máximo 1-2% do capital ### Checklist Antes de Cada Operação ``` □ Defini o stop loss? □ O risco/retorno é favorável (> 2:1)? □ A perda máxima é aceitável? □ Tenho disciplina para executar? □ O stop não está em número redondo? □ O stop respeita níveis técnicos? ``` ## Próximos Passos Para implementar stops corretamente: 1. **Use a brapi.dev** para monitorar preços em tempo real 2. **Calcule ATR** para stops baseados em volatilidade 3. **Automatize alertas** com os códigos Python deste guia 4. **Mantenha um diário** de operações para análise A [brapi.dev](https://brapi.dev) fornece dados em tempo real e históricos para calcular níveis técnicos e configurar seus stops com precisão. *** *Disclaimer: Este conteúdo é educacional. Trading envolve riscos significativos.* # Tesouro Direto 2026: Guia Completo para Investir com Segurança URL: /blog/tesouro-direto-guia-completo-2026-como-investir.mdx Aprenda tudo sobre Tesouro Direto! Tesouro Selic, IPCA+ e Prefixado explicados. Simulador, taxas, rentabilidade e passo a passo para começar a investir hoje *** searchable: true title: 'Tesouro Direto 2026: Guia Completo para Investir com Segurança' description: 'Aprenda tudo sobre Tesouro Direto! Tesouro Selic, IPCA+ e Prefixado explicados. Simulador, taxas, rentabilidade e passo a passo para começar a investir hoje' date: '2026-01-01' keywords: 'tesouro direto 2026, tesouro selic, tesouro ipca, tesouro prefixado, como investir tesouro direto, renda fixa, investimento seguro, taxa selic, titulo publico, rentabilidade tesouro' author: 'Equipe brapi.dev' category: 'Renda Fixa' subcategory: 'Tesouro Direto' readingTime: '28 min' tags: \['Tesouro Direto', 'Renda Fixa', 'Tesouro Selic', 'Tesouro IPCA', 'Investimento Seguro', 'Iniciantes', 'Taxa Selic', 'Inflacao'] relatedPosts: \['cdb-vs-tesouro-direto-comparativo-2026', 'lci-lca-guia-completo-investimentos-isentos-ir-2026', 'o-que-e-cdi-guia-completo-2026', 'renda-fixa-vs-renda-variavel-2026', 'indicadores-economicos-brasil-selic-ipca-igpm-impacto-investimentos'] featured: true expertise: 'Investimentos em renda fixa e títulos públicos brasileiros' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; import { Callout } from 'fumadocs-ui/components/callout'; > O Tesouro Direto é a porta de entrada mais segura para o mundo dos investimentos. Com apenas R$ 30, você pode emprestar dinheiro ao Governo Federal e receber juros garantidos. Aprenda tudo sobre os tipos de títulos, como escolher o melhor para seu objetivo e como começar hoje. *** ## O que é Tesouro Direto? O **Tesouro Direto** é um programa do Governo Federal brasileiro que permite que pessoas físicas comprem títulos públicos pela internet. Quando você investe no Tesouro Direto, está **emprestando dinheiro ao governo**, que em troca paga juros sobre esse empréstimo. ### Por que é Considerado o Investimento Mais Seguro? | Característica | Tesouro Direto | CDB/LCI | Ações | | ----------------------- | ------------------ | ------------------ | ------------- | | **Garantia** | Governo Federal | FGC até R$ 250 mil | Nenhuma | | **Risco de calote** | Praticamente zero | Baixo | Variável | | **Liquidez** | D+1 (dia seguinte) | Varia | Imediata | | **Investimento mínimo** | \~R$ 30 | Varia | Preço da ação | > **Fato**: O Governo Federal é o último ente a dar calote em um país. Antes disso, bancos e empresas quebrariam. Por isso, títulos públicos são considerados "risco zero" em termos de crédito. ### Como Funciona na Prática? **Exemplo simplificado:** | Item | Valor | | -------------------- | ----------------------------- | | Você investe | R$ 1.000 | | Título | Tesouro Selic 2029 | | Taxa | Selic + 0,10% (\~14,25% a.a.) | | Prazo | 5 anos | | Valor bruto final | R$ 1.967,15 | | IR (15% após 2 anos) | R$ 145,07 | | Valor líquido | R$ 1.822,08 | *** ## Tipos de Títulos do Tesouro Direto O Tesouro Direto oferece três categorias principais de títulos, cada uma com características e objetivos diferentes: ### 1. Tesouro Selic (LFT) - O Mais Popular O Tesouro Selic rende de acordo com a **taxa básica de juros** (Selic) definida pelo Banco Central. **Características:** * Rentabilidade: **Selic + pequeno spread** (ex: Selic + 0,10%) * Liquidez: **D+1** (venda a qualquer momento) * Volatilidade: **Mínima** (não sofre marcação a mercado significativa) * Ideal para: **Reserva de emergência** e objetivos de curto prazo **Simulação Tesouro Selic - R$ 10.000 por 12 meses (Selic 14,25%):** | Item | Valor | | --------------------- | ------------ | | Valor inicial | R$ 10.000,00 | | Rendimento bruto | R$ 1.425,00 | | IR (20% - até 1 ano) | R$ 285,00 | | Valor líquido | R$ 11.140,00 | | Rentabilidade líquida | 11,40% | O IR segue tabela regressiva: 22,5% (até 180 dias), 20% (até 360 dias), 17,5% (até 720 dias), 15% (acima de 720 dias). **Quando Usar Tesouro Selic:** * Reserva de emergência (3-12 meses de gastos) * Dinheiro que pode precisar a qualquer momento * Aguardando oportunidades de investimento * Perfil ultra-conservador ### 2. Tesouro IPCA+ (NTN-B) - Proteção Contra Inflação O Tesouro IPCA+ oferece rentabilidade **acima da inflação**, garantindo poder de compra real. **Características:** * Rentabilidade: **IPCA + taxa fixa** (ex: IPCA + 6,50% a.a.) * Liquidez: D+1 (mas pode ter perdas por marcação a mercado) * Volatilidade: **Alta** no curto prazo * Ideal para: **Aposentadoria** e objetivos de longo prazo | Título | Taxa Atual\* | Vencimento | Ideal Para | | ------------------ | ------------ | ---------- | ------------- | | Tesouro IPCA+ 2029 | IPCA + 7,20% | 15/05/2029 | Médio prazo | | Tesouro IPCA+ 2035 | IPCA + 7,05% | 15/05/2035 | Aposentadoria | | Tesouro IPCA+ 2045 | IPCA + 6,85% | 15/05/2045 | Longo prazo | \*Taxas ilustrativas - consulte valores atuais no site do Tesouro Direto **Marcação a Mercado - Entenda o Risco:** **Regra fundamental:** Quando as taxas SOBEM, o preço do título CAI. Quando as taxas DESCEM, o preço do título SOBE. **Exemplo prático - Comprou IPCA+ a 6,5%, taxa subiu para 7,5%:** | Item | Valor | | ----------------------- | ------------ | | Valor investido | R$ 10.000,00 | | Taxa na compra | 6,50% a.a. | | Taxa atual | 7,50% a.a. | | Anos restantes | 10 anos | | Variação no preço | **-8,50%** | | Valor atual (se vender) | R$ 9.150,00 | Se mantiver até o vencimento, você recebe a taxa contratada (6,5% + IPCA) independente das oscilações. > **Regra de Ouro**: Só invista em Tesouro IPCA+ dinheiro que você pode deixar até o vencimento. Se precisar resgatar antes, pode ter prejuízo. **Variações do Tesouro IPCA+:** 1. **Tesouro IPCA+**: Paga tudo no vencimento (acumulação) 2. **Tesouro IPCA+ com Juros Semestrais**: Paga cupons a cada 6 meses * Ideal para quem precisa de renda periódica * Menos eficiente fiscalmente (IR sobre cupons) ### 3. Tesouro Prefixado (LTN) - Taxa Fixa O Tesouro Prefixado oferece uma **taxa fixa de juros** definida no momento da compra. **Características:** * Rentabilidade: **Taxa fixa** (ex: 14,50% a.a.) * Liquidez: D+1 (mas alta volatilidade) * Volatilidade: **Muito alta** no curto prazo * Ideal para: Quando acredita que **juros vão cair** **Comparativo: Quando Prefixado é Bom ou Ruim** | Cenário | Situação | Taxa Contratada | Resultado | | ---------- | ----------------------- | --------------- | -------------------------- | | **Bom** | Selic CAI de 14% → 10% | 14% a.a. | ✅ Ganho! Travou taxa alta | | **Ruim** | Selic SOBE de 14% → 18% | 14% a.a. | ❌ Perda de oportunidade | | **Neutro** | Selic permanece estável | 14% a.a. | ➖ Similar ao Tesouro Selic | | Título | Taxa Atual\* | Vencimento | | --------------------------- | ------------ | ---------- | | Tesouro Prefixado 2027 | 14,80% a.a. | 01/01/2027 | | Tesouro Prefixado 2031 | 14,50% a.a. | 01/01/2031 | | Tesouro Prefixado com Juros | 14,20% a.a. | 01/01/2035 | \*Taxas ilustrativas > **Atenção**: Prefixado é o título mais arriscado do Tesouro Direto. Use apenas se tiver convicção sobre a direção dos juros. *** ## Comparativo: Qual Tesouro Escolher? **Árvore de Decisão - Qual Tesouro Escolher?** | Seu Objetivo | Prazo | Tolerância ao Risco | Recomendação | | --------------------- | --------- | ------------------- | --------------------------------------------- | | Reserva de emergência | Qualquer | Qualquer | **Tesouro Selic** (liquidez sem volatilidade) | | Curto prazo | \< 2 anos | Qualquer | **Tesouro Selic** (evitar marcação a mercado) | | Aposentadoria | ≥ 10 anos | Média/Alta | **Tesouro IPCA+** (proteção contra inflação) | | Especular em juros | Qualquer | Alta | **Tesouro Prefixado** (aposta na queda) | | Sem definição clara | Qualquer | Baixa | **Tesouro Selic ou IPCA+ curto** | Na dúvida, comece pelo Tesouro Selic. É o mais simples, seguro e versátil. ### Tabela Resumo | Característica | Tesouro Selic | Tesouro IPCA+ | Tesouro Prefixado | | ---------------------- | ------------- | -------------------------- | ------------------------ | | **Rentabilidade** | Selic | IPCA + taxa | Taxa fixa | | **Volatilidade** | Muito baixa | Alta | Muito alta | | **Risco de perda** | Quase zero | Médio (resgate antecipado) | Alto | | **Ideal para** | Curto prazo | Longo prazo | Aposta em queda de juros | | **Reserva emergência** | Sim | Não | Não | | **Aposentadoria** | Parcial | Sim | Não recomendado | *** ## Custos e Tributação ### Custos do Tesouro Direto | Custo | Valor | Descrição | | ----------------------------- | ----------------- | -------------------------------- | | **Taxa de custódia da bolsa** | 0,20% a.a. | Cobrada semestralmente | | **Taxa da corretora** | 0% | Maioria das corretoras não cobra | | **IOF** | Tabela regressiva | Apenas nos primeiros 30 dias | > **Isenção de custódia**: Investimentos até R$ 10.000 em Tesouro Selic são isentos da taxa de custódia da bolsa. ### Imposto de Renda - Tabela Regressiva | Prazo | Alíquota IR | | ----------------- | ----------- | | Até 180 dias | 22,5% | | 181 a 360 dias | 20,0% | | 361 a 720 dias | 17,5% | | Acima de 720 dias | 15,0% | **Exemplo: R$ 1.000 de rendimento após 2 anos (730 dias)** | Item | Valor | | ---------------------------- | ------------- | | Rendimento bruto | R$ 1.000,00 | | Alíquota (acima de 720 dias) | 15% | | IR pago | R$ 150,00 | | **Rendimento líquido** | **R$ 850,00** | ### IOF nos Primeiros 30 Dias O IOF incide sobre o rendimento em resgates muito rápidos: | Dias | IOF | Dias | IOF | Dias | IOF | | ---- | --- | ---- | --- | ---- | --- | | 1 | 96% | 11 | 63% | 21 | 30% | | 5 | 83% | 15 | 50% | 25 | 16% | | 10 | 66% | 20 | 33% | 30 | 0% | > **Dica**: Evite resgatar Tesouro Direto nos primeiros 30 dias. O IOF come praticamente todo o rendimento. *** ## Como Começar a Investir no Tesouro Direto ### Passo a Passo Completo #### 1. Abra Conta em uma Corretora Escolha uma corretora que ofereça **taxa zero** para Tesouro Direto: * **Nubank** - App simples, integrado * **XP Investimentos** - Plataforma completa * **Rico** - Interface amigável * **BTG Pactual** - Banco de investimentos * **Clear** - Foco em custo zero #### 2. Cadastro no Tesouro Direto Após abrir conta na corretora, você recebe acesso automático ao Tesouro Direto. A corretora faz o cadastro junto ao Tesouro Nacional. #### 3. Transfira Dinheiro Envie recursos via PIX ou TED para sua conta na corretora. #### 4. Escolha o Título **Guia Rápido por Perfil:** | Perfil | Título Recomendado | Mínimo | Motivo | | ------------------------- | ---------------------------------- | -------- | ------------------------------------ | | **Iniciante** | Tesouro Selic | \~R$ 30 | Seguro, líquido, sem surpresas | | **Aposentadoria** | Tesouro IPCA+ longo prazo | \~R$ 30 | Proteção contra inflação por décadas | | **Reserva de emergência** | Tesouro Selic | \~R$ 100 | Liquidez D+1, sem volatilidade | | **Renda passiva** | Tesouro IPCA+ com Juros Semestrais | \~R$ 30 | Recebe cupons a cada 6 meses | #### 5. Realize a Compra * Acesse a área de Tesouro Direto na corretora * Selecione o título desejado * Informe o valor (mínimo \~R$ 30) * Confirme a operação * Pronto! Título aparece em sua carteira no dia seguinte *** ## Estratégias de Investimento no Tesouro ### 1. Escada de Vencimentos (Laddering) Distribua investimentos em diferentes vencimentos para equilibrar rentabilidade e liquidez: **Exemplo: Escada para Aposentadoria em 20 anos** | Título | Alocação | Prazo | | ------------------ | -------- | -------- | | Tesouro IPCA+ 2029 | 20% | 4 anos | | Tesouro IPCA+ 2035 | 30% | 10 anos | | Tesouro IPCA+ 2045 | 30% | 20 anos | | Tesouro Selic | 20% | Liquidez | **Benefícios da escada:** * Reduz risco de marcação a mercado * Permite rebalanceamento periódico * Mantém liquidez parcial ### 2. Combinação com Renda Variável Para uma carteira diversificada estilo Bogleheads: **Exemplo de Carteira Diversificada (Estilo Bogleheads)** | Classe | Ativo | Alocação | | ------------------------ | ------------------- | -------- | | **Renda Fixa (40%)** | Tesouro IPCA+ 2035 | 25% | | | Tesouro Selic | 15% | | **Renda Variável (60%)** | ETF Global (WRLD11) | 45% | | | ETF Brasil (BOVA11) | 15% | ### 3. Reserva de Emergência 100% em Tesouro Selic **Reserva de Emergência Ideal:** | Item | Recomendação | | ----------------- | ------------------------- | | **Valor** | 6 meses de gastos mensais | | **Onde investir** | Tesouro Selic | **Por que Tesouro Selic para reserva?** * Liquidez D+1 * Rende mais que poupança * Sem volatilidade * Garantia do Governo Federal * Isenção de custódia até R$ 10.000 **Alternativas equivalentes:** CDB 100% CDI com liquidez diária, Fundo DI taxa zero *** ## Tesouro Direto vs Outras Opções de Renda Fixa ### Tesouro Direto vs Poupança | Aspecto | Tesouro Selic | Poupança | | ------------------------- | --------------- | ------------------ | | **Rentabilidade** | \~14% a.a.\* | \~6% a.a.\* | | **Segurança** | Governo Federal | FGC até R$ 250 mil | | **Liquidez** | D+1 | Imediata | | **IR** | 15-22,5% | Isento | | **Rentabilidade líquida** | \~11-12% a.a.\* | \~6% a.a.\* | \*Valores aproximados com Selic a 14,25% > **Conclusão**: Mesmo com IR, Tesouro Selic rende quase o **dobro** da poupança. ### Tesouro Direto vs CDB | Aspecto | Tesouro Direto | CDB | | ----------------- | --------------- | ----------------------- | | **Garantia** | Governo Federal | FGC até R$ 250 mil | | **Rentabilidade** | Selic ou IPCA+ | % do CDI | | **Liquidez** | D+1 sempre | Varia (D+0 a anos) | | **Mínimo** | \~R$ 30 | Varia (R$ 1 a R$ 1.000) | **Quando preferir CDB:** * CDBs pagando 110%+ do CDI * Prazo definido que você pode cumprir * Valor abaixo de R$ 250 mil (cobertura FGC) ### Tesouro Direto vs LCI/LCA | Aspecto | Tesouro IPCA+ | LCI/LCA | | ----------------- | ------------- | ------------------ | | **IR** | 15-22,5% | Isento | | **Garantia** | Governo | FGC até R$ 250 mil | | **Liquidez** | D+1 | Geralmente travada | | **Rentabilidade** | IPCA + \~7% | \~90-95% CDI | **Quando preferir LCI/LCA:** * Taxas acima de 95% CDI * Pode deixar travado pelo prazo * Valor até R$ 250 mil *** ## Monitorando Taxas com brapi.dev A [API brapi.dev](/docs) oferece dados econômicos essenciais para acompanhar seus investimentos em Tesouro Direto: ### Consultando a Taxa Selic ```typescript // Consultar taxa Selic atual via brapi.dev (/api/v2/macro) const response = await fetch( "https://brapi.dev/api/v2/macro/latest?symbols=selic", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); // results[0].latest.value contém a taxa Selic atual (ex: 14.5) ``` ### Consultando Inflação (IPCA acumulado 12m) ```typescript // Consultar IPCA acumulado 12 meses via brapi.dev (/api/v2/macro) const response = await fetch( "https://brapi.dev/api/v2/macro/latest?symbols=ipca12m", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); // results[0].latest.value contém o IPCA acumulado 12 meses (ex: 4.14) ``` ### Calculadora de Rentabilidade Real A rentabilidade real desconta a inflação do rendimento nominal: **Fórmula:** `(1 + taxa_nominal) / (1 + inflação) - 1` **Exemplo: Tesouro Selic a 14,25% com IPCA de 4%:** | Item | Valor | | ---------------------- | --------- | | Taxa nominal | 14,25% | | Inflação (IPCA) | 4,00% | | **Rentabilidade real** | **9,86%** | Rentabilidade real é o que realmente importa - quanto seu dinheiro cresceu acima da inflação. *** ## Simulador de Investimento **Exemplo: R$ 1.000 inicial + R$ 500/mês por 10 anos (Selic 14,25% a.a.)** | Item | Valor | | ----------------------- | ----------------- | | Investimento inicial | R$ 1.000,00 | | Aporte mensal | R$ 500,00 | | Prazo | 10 anos | | **Total investido** | **R$ 61.000,00** | | Patrimônio bruto | R$ 132.847,52 | | Ganho bruto | R$ 71.847,52 | | IR estimado (15%) | R$ 10.777,13 | | **Patrimônio líquido** | **R$ 122.070,39** | | **Rentabilidade total** | **100,11%** | **Evolução Anual:** | Ano | Patrimônio Bruto | | --- | ---------------- | | 1 | R$ 7.825,41 | | 2 | R$ 15.617,58 | | 3 | R$ 24.505,71 | | 4 | R$ 34.640,02 | | 5 | R$ 46.194,24 | | 6 | R$ 59.368,76 | | 7 | R$ 74.394,17 | | 8 | R$ 91.534,20 | | 9 | R$ 111.090,06 | | 10 | R$ 132.847,52 | Use a [Calculadora FIRE](/calculadoras/fire) para simular cenários personalizados. *** ## Perguntas Frequentes (FAQ) ### Quanto rende R$ 1.000 no Tesouro Direto? Com Selic a 14,25% ao ano: * **1 ano**: \~R$ 1.114 líquido (após IR de 20%) * **2 anos**: \~R$ 1.243 líquido (após IR de 15%) * **5 anos**: \~R$ 1.822 líquido (após IR de 15%) ### Tesouro Direto é melhor que poupança? **Sim, significativamente**. O Tesouro Selic rende aproximadamente o dobro da poupança, mesmo considerando o IR. ### Posso perder dinheiro no Tesouro Direto? * **Tesouro Selic**: Praticamente impossível perder * **Tesouro IPCA+ e Prefixado**: Pode ter perdas se vender antes do vencimento em momentos desfavoráveis ### Qual o valor mínimo para investir? Aproximadamente **R$ 30**, dependendo do título e cotação do dia. ### O que acontece se o governo não pagar? Historicamente, nenhum país quebra sem antes haver colapso de todo o sistema financeiro (bancos, empresas). É o investimento de menor risco possível em reais. ### Como declarar Tesouro Direto no IR? O informe de rendimentos é fornecido pela corretora. Basta declarar: * **Bens e Direitos**: Código 45 (Aplicação de renda fixa) * **Rendimentos**: Aba "Rendimentos Sujeitos à Tributação Exclusiva" *** ## Checklist: Começando no Tesouro Direto ### Preparação * [ ] Definir objetivo (reserva, aposentadoria, curto prazo) * [ ] Calcular valor disponível para investir * [ ] Escolher corretora com taxa zero ### Execução * [ ] Abrir conta na corretora * [ ] Transferir recursos * [ ] Escolher título adequado ao objetivo * [ ] Realizar primeira compra * [ ] Configurar aportes automáticos (opcional) ### Manutenção * [ ] Acompanhar rendimentos mensalmente * [ ] Reinvestir vencimentos * [ ] Reavaliar alocação anualmente * [ ] Guardar informes para declaração de IR *** ## Conclusão O Tesouro Direto é a **base ideal** para qualquer carteira de investimentos: 1. **Iniciantes**: Comece com Tesouro Selic para aprender 2. **Reserva de emergência**: 100% Tesouro Selic 3. **Aposentadoria**: Tesouro IPCA+ de longo prazo 4. **Diversificação**: Combine com ações e ETFs A segurança do Governo Federal, liquidez D+1 e rentabilidade superior à poupança fazem do Tesouro Direto uma **escolha óbvia** para a parcela de renda fixa do seu portfólio. ### Próximos Passos * **[Guia Bogleheads Brasil](/blog/guia-bogleheads-brasil-investimento-passivo-etfs)** - Estratégia completa de investimento passivo * **[Indicadores Econômicos Brasil](/blog/indicadores-economicos-brasil-selic-ipca-igpm-impacto-investimentos)** - Entenda Selic, IPCA e impactos * **[API brapi.dev - Dados Econômicos](/docs)** - Acesse taxas em tempo real * **[Calculadora FIRE](/calculadoras/fire)** - Simule sua independência financeira *** **Disclaimer:** Este conteúdo é educacional e não constitui recomendação de investimento. Taxas e rentabilidades são ilustrativas e podem variar. Consulte sempre o site oficial do Tesouro Direto para informações atualizadas. # Vale (VALE3) e Petrobras (PETR4): Análise de Commodities para 2026 URL: /blog/vale3-petr4-commodities-analise-2026.mdx Vale a pena investir em Vale e Petrobras em 2026? Análise completa de VALE3 e PETR4, riscos políticos, dividendos e cenário da China. *** searchable: true title: 'Vale (VALE3) e Petrobras (PETR4): Análise de Commodities para 2026' description: 'Vale a pena investir em Vale e Petrobras em 2026? Análise completa de VALE3 e PETR4, riscos políticos, dividendos e cenário da China.' date: '2026-01-02' keywords: 'vale3 analise 2026, petr4 dividendos 2026, vale ou petrobras, commodities 2026, china minério de ferro, petróleo brent 2026' author: 'Equipe brapi.dev' category: 'Ações' subcategory: 'Commodities' readingTime: '15 min' tags: \['Commodities', 'VALE3', 'PETR4', 'Dividendos', 'China', 'Petróleo'] relatedPosts: \['onde-investir-2026-guia-completo-melhores-investimentos', 'melhores-acoes-setor-eletrico-2026-dividendos-taee11-trpl4'] featured: false expertise: 'Análise cíclica e geopolítica das maiores empresas de commodities da bolsa brasileira.' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; As "gigantes" da Bolsa brasileira, **Vale (VALE3)** e **Petrobras (PETR4)**, representam uma parcela enorme do Ibovespa e da carteira de muitos investidores. Ambas são empresas de classe mundial, geradoras de caixa absurdas e pagadoras de dividendos históricos. Mas, por serem **cíclicas**, investir nelas exige timing e estômago. Para 2026, o cenário é complexo: desaceleração da China, transição energética e riscos políticos locais. Vamos dissecar o que esperar dessas duas potências. *** ## Vale (VALE3): O Dragão Chinês e o Minério A Vale é uma das maiores mineradoras do mundo e sua sorte está intimamente ligada à economia da China, maior consumidora global de minério de ferro. ### Cenário 2026 para VALE3 1. **China em Transição:** A China não cresce mais a "taxas chinesas" (10% ao ano). O setor imobiliário chinês (grande consumidor de aço) esfriou. Isso pressiona o preço do minério de ferro para baixo ou para a estabilidade. 2. **Qualidade do Minério:** O diferencial da Vale é a qualidade do seu minério (Carajás), que é mais puro e exige menos energia para ser processado, sendo "mais verde". Isso garante um prêmio sobre o preço de mercado. 3. **Metais de Transição:** A Vale separou sua unidade de metais básicos (Cobre e Níquel), essenciais para carros elétricos (EVs). Em 2026, espera-se que essa divisão comece a destravar mais valor. ### Dividendos VALE3 A Vale tem uma política de dividendos clara baseada na geração de caixa. Se o minério ficar acima de US$ 100/ton, os pagamentos tendem a ser robustos. Se cair para US$ 80-90, os dividendos minguam. É uma ação para monitorar o preço da commodity. *** ## Petrobras (PETR4): Petróleo, Pré-Sal e Política A Petrobras é, indiscutivelmente, uma das petrolíferas mais eficientes do mundo na exploração em águas profundas (Pré-Sal). Seu custo de extração (lifting cost) é baixo, o que a torna lucrativa mesmo com o petróleo em queda. ### Cenário 2026 para PETR4 1. **Preço do Brent:** O petróleo continua sendo a matriz energética dominante, mas a transição energética avança. A OPEP+ tenta segurar os preços cortando produção, enquanto EUA e Brasil aumentam. Um Brent entre US$ 70 e US$ 90 é o "sweet spot" para a Petrobras. 2. **Risco Político:** Sendo uma estatal de economia mista, a Petrobras está sempre sujeita a interferências (preços dos combustíveis, investimentos questionáveis, retenção de dividendos). Em 2026 (ano eleitoral), a volatilidade tende a aumentar drasticamente. 3. **Investimentos em Renováveis:** A empresa está voltando a investir em eólica offshore e biocombustíveis. O mercado vigia se esses investimentos terão retorno (ROI) adequado ou se destruirão valor do acionista. ### Dividendos PETR4 A Petrobras foi a maior pagadora de dividendos do mundo em alguns momentos recentes. Para 2026, a expectativa é de pagamentos menores que os recordes passados, mas ainda muito atrativos (frequentemente acima de 2 dígitos), desde que o governo não altere drasticamente a política de distribuição. *** ## VALE3 vs PETR4: Qual Escolher? | Característica | Vale (VALE3) | Petrobras (PETR4) | | :-------------------- | :------------------------------------- | :---------------------------------------- | | **Driver Principal** | Minério de Ferro / China | Petróleo Brent / Governo | | **Risco Principal** | Desaceleração Chinesa | Interferência Política | | **Governança** | Corporation (Sem controlador definido) | Estatal (Governo Federal controla) | | **Perfil de Retorno** | Cíclico + Dividendos | Dividendos Explosivos + Volatilidade | | **Proteção Dólar** | Alta (Receita em Dólar) | Alta (Preço segue paridade internacional) | *** ## Análise: Correlação com o Dólar Empresas exportadoras como Vale e Petrobras tendem a se beneficiar da alta do dólar. Vamos verificar isso (exemplo conceitual): **Como analisar a correlação:** ```typescript // Buscar histórico das ações e do dólar const response = await fetch( 'https://brapi.dev/api/quote/VALE3,PETR4?range=1y&interval=1d', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Compare com dados de câmbio para calcular correlação ``` **Dinâmica Dólar x Commodities:** | Cenário | Commodity (USD) | Dólar (BRL) | Receita (BRL) | | ------------ | --------------- | ----------- | ------------------------ | | Crise Global | ⬇️ Cai | ⬆️ Sobe | ➡️ Compensa parcialmente | | Boom China | ⬆️ Sobe | ➡️ Estável | ⬆️ Sobe muito | | Recessão BR | ➡️ Estável | ⬆️ Sobe | ⬆️ Sobe (efeito câmbio) | **Projeção Simplificada PETR4 2026:** | Dado | Valor | | ---------------------------- | ----------- | | Preço Base | R$ 38,00 | | DPA Projetado | R$ 4,50 | | **Dividend Yield Projetado** | **\~11,8%** | > **Insight:** A alta do câmbio pode compensar parcialmente quedas nos preços das commodities em dólar. *** ## Conclusão: Ter ou Não Ter? Para 2026, a recomendação para o investidor moderado/arrojado é ter **exposição a Commodities**, mas com cautela no tamanho da posição. * **Diversificação:** Não tenha mais de 15-20% da sua carteira de ações concentrada apenas nessas duas empresas. O risco cíclico é alto. * **Oportunidade:** Ambas negociam a múltiplos muito baixos (P/L historicamente barato) se comparadas a pares internacionais. Isso oferece uma "margem de segurança". * **Estratégia:** Compre nos momentos de pessimismo (ex: "China vai quebrar", "Governo vai intervir na Petrobras") e segure para os dividendos. Se você busca paz de espírito total, talvez prefira o [Setor Elétrico](/blog/melhores-acoes-setor-eletrico-2026-dividendos-taee11-trpl4). Se busca potencial de retorno alto e aceita volatilidade, VALE3 e PETR4 são obrigatórias na carteira. *** ## Leia Mais * **[Setor Elétrico 2026: TAEE11 e TRPL4](/blog/melhores-acoes-setor-eletrico-2026-dividendos-taee11-trpl4)** * **[Small Caps Promissoras](/blog/small-caps-promissoras-2026-analise)** # Valuation em 2026: Quanto Vale uma Ação? URL: /blog/valuation-dcf-multiplos-guia-completo-2026.mdx Aprenda a calcular o valor justo de uma ação em 2026. Entenda as diferenças entre Múltiplos (P/L, EV/EBITDA) e Fluxo de Caixa Descontado (DCF). *** searchable: true title: 'Valuation em 2026: Quanto Vale uma Ação?' description: 'Aprenda a calcular o valor justo de uma ação em 2026. Entenda as diferenças entre Múltiplos (P/L, EV/EBITDA) e Fluxo de Caixa Descontado (DCF).' date: '2025-12-30' keywords: 'valuation 2026, dcf vs multiplos, preço justo ações, ev ebitda, calcular valuation, valuation petrobras, valuation weg' author: 'Equipe brapi.dev' category: 'Educação Financeira' subcategory: 'Valuation' readingTime: '15 min' tags: \['Valuation', 'P/L', 'EV/EBITDA', 'DCF', 'Preço Justo'] relatedPosts: \['roic-roe-analise-fundamentalista-2026', 'entendendo-indicador-preco-lucro-pl-analise-fundamentalista', 'fluxo-de-caixa-descontado-valuation'] featured: false expertise: 'Guia prático para encontrar o preço justo de ativos no cenário econômico de 2026.' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; "Preço é o que você paga. Valor é o que você leva." — Warren Buffett. Em 2026, com a volatilidade do mercado, essa frase nunca foi tão atual. Comprar uma ação boa (**WEGE3**, **RADL3**) é ótimo, mas pagar caro demais por ela pode transformar um excelente negócio em um péssimo investimento. Neste guia, vamos desmistificar o **Valuation** (avaliação de empresas) e mostrar como você pode estimar o preço justo de um ativo. *** ## Método 1: Múltiplos de Mercado (O "Comparativo") É a forma mais rápida e comum. Você compara a empresa com seus pares ou com seu próprio histórico. ### 1. P/L (Preço sobre Lucro) Quantos anos o lucro da empresa pagaria o seu investimento? * **Baixo (ex: P/L 4x):** Empresa descontada ou com risco alto (Estatais, Commodities). Ex: **Petrobras**, **Banco do Brasil**. * **Alto (ex: P/L 30x):** Empresa de alto crescimento ou qualidade extrema. O mercado aceita pagar caro porque espera lucros maiores no futuro. Ex: **WEG**, **Mercado Livre**. ### 2. EV/EBITDA (Valor da Firma sobre Geração de Caixa) Considera a dívida da empresa (EV = Valor de Mercado + Dívida Líquida). É melhor para comparar empresas com estruturas de capital diferentes. * **Uso:** Essencial para indústrias, varejo e empresas intensivas em capital (**Vale**, **Suzano**). ### A Armadilha dos Múltiplos em 2026 Cuidado com o "Value Trap" (Armadilha de Valor). Uma empresa pode ter P/L 3x porque o mercado acha que o lucro dela vai despencar ano que vem. Múltiplo baixo não é garantia de pechincha. *** ## Método 2: Fluxo de Caixa Descontado (DCF) (O "Científico") É o método favorito dos analistas profissionais e bancos de investimento. **A Lógica:** Uma empresa vale a soma de todo o dinheiro que ela vai gerar no futuro, trazido para o valor de hoje (valor presente) descontado por uma taxa de juros (risco). 1. **Projetar o Fluxo de Caixa:** Quanto a empresa vai lucrar em 2027, 2028, 2029...? 2. **Definir a Taxa de Desconto (WACC):** Quanto de retorno eu exijo para correr esse risco? Em 2026, com a Selic no patamar atual, essa taxa é alta. 3. **Trazer a Valor Presente:** R$ 100,00 em 2030 valem menos que R$ 100,00 hoje. ### O Impacto dos Juros no DCF Se os juros sobem, o "desconto" aumenta e o valor justo da empresa cai drasticamente. Por isso, ações de crescimento (Tech) sofrem tanto quando a Selic ou os Juros dos EUA sobem. *** ## Exemplo Prático: Valuation Relativo Vamos comparar o P/L de Bancos para ver quem está "barato". ```typescript const response = await fetch( 'https://brapi.dev/api/quote/ITUB4,BBAS3,BBDC4,SANB11?modules=defaultKeyStatistics,financialData', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Compare data.results[i].priceEarnings ou defaultKeyStatistics.trailingPE ``` **Batalha de Valuation: Bancos (Exemplo 2026)** | Banco | Preço | P/L | P/VP | Análise | | ------ | -------- | ---- | ---- | --------------------- | | BBAS3 | R$ 32,00 | 4,5x | 0,90 | Mais barato | | SANB11 | R$ 28,00 | 8,2x | 1,05 | Intermediário | | BBDC4 | R$ 14,50 | 9,1x | 1,10 | Intermediário | | ITUB4 | R$ 35,00 | 9,8x | 1,60 | Mais caro (Qualidade) | > **Insight:** BBAS3 negocia mais barato, mas ITUB4 tem prêmio por qualidade e consistência. *** ## Conclusão * **Curto Prazo:** O mercado vota (Múltiplos e Fluxo de notícias movem o preço). * **Longo Prazo:** O mercado pesa (Geração de Caixa real define o valor). Em 2026, prefira pagar um preço justo por uma empresa excelente (Buffett) do que um preço barato por uma empresa medíocre (Graham). Use o **EV/EBITDA** para comparar indústrias e o **P/L** para bancos. E lembre-se: Valuation é arte, não ciência exata. *** ## Leia Mais * **[Alavancagem Financeira: O Risco Oculto](/blog/divida-liquida-ebitda-alavancagem-analise-2026)** * **[Dividendos: Payout e Sustentabilidade](/blog/payout-dividend-yield-sustentabilidade-2026)** # Value Investing 2026: Como Encontrar Ações Baratas e Subvalorizadas URL: /blog/value-investing-como-encontrar-acoes-baratas.mdx Guia completo de Value Investing ✓ Aprenda a encontrar ações baratas como Warren Buffett. Indicadores, screeners, margem de segurança e análise de valor. *** searchable: true title: 'Value Investing 2026: Como Encontrar Ações Baratas e Subvalorizadas' description: 'Guia completo de Value Investing ✓ Aprenda a encontrar ações baratas como Warren Buffett. Indicadores, screeners, margem de segurança e análise de valor.' date: '2026-01-01' keywords: 'value investing 2026, ações baratas, como encontrar ações subvalorizadas, Warren Buffett estratégia, margem de segurança, P/L baixo, investimento em valor, Graham, análise de valor' author: 'Equipe brapi.dev' category: 'Estratégias' subcategory: 'Análise de Valor' readingTime: '22 min' tags: \['Value Investing', 'Ações Baratas', 'Warren Buffett', 'Benjamin Graham', 'Análise Fundamentalista', 'P/L', 'P/VP'] relatedPosts: \['buy-and-hold-estrategia-investimento-longo-prazo', 'dividendos-como-construir-renda-passiva', 'acoes-growth-vs-value-brasil', 'formula-graham-como-calcular-preco-justo-acoes-value-investing', 'entendendo-indicador-preco-lucro-pl-analise-fundamentalista'] featured: true expertise: 'Especialistas em análise fundamentalista e estratégias de investimento em valor comprovadas.' lastReviewed: 2026-01-03 ------------------------ import { Callout } from 'fumadocs-ui/components/callout'; ## O que é Value Investing **Value Investing** (investimento em valor) é uma estratégia que busca comprar ações de empresas negociadas abaixo do seu valor intrínseco - ou seja, ações "baratas" em relação aos seus fundamentos. A filosofia foi criada por **Benjamin Graham** (professor de Warren Buffett) nos anos 1930 e refinada por seus discípulos, gerando os maiores retornos da história do mercado. ### A Ideia Central > "Preço é o que você paga. Valor é o que você recebe." - Warren Buffett O mercado frequentemente precifica ações incorretamente no curto prazo. O value investor aproveita essas distorções para comprar empresas sólidas por preços baixos e esperar o mercado reconhecer o valor real. ### Os Grandes Value Investors | Investidor | Retorno Anualizado | Período | Filosofia | | --------------- | ------------------ | -------- | -------------------------------- | | Warren Buffett | \~20% a.a. | 60+ anos | Qualidade + Valor | | Benjamin Graham | \~15% a.a. | 30+ anos | Valor puro (quantitativo) | | Peter Lynch | 29% a.a. | 13 anos | Growth at Reasonable Price | | Seth Klarman | \~20% a.a. | 30+ anos | Deep Value + Margem de segurança | | Joel Greenblatt | 40% a.a. | 20 anos | Magic Formula | | Luiz Barsi | \~25% a.a. | 50+ anos | Dividendos + Valor | *** ## Os Pilares do Value Investing ### 1. Margem de Segurança O conceito mais importante: só compre quando o preço está **significativamente abaixo** do valor intrínseco. **Exemplo de cálculo:** | Item | Valor | | ------------------------- | ------------------ | | Preço atual | R$ 35,00 | | Valor intrínseco estimado | R$ 50,00 | | **Margem de segurança** | **30%** | | Avaliação | ✅ Excelente margem | **Referência de margem:** * ≥ 30%: ✅ Excelente - comprar * 15-30%: ⚠️ Aceitável - analisar mais * \< 15%: ❌ Insuficiente - esperar queda **Regra de Graham:** Busque margem de segurança de pelo menos **30%** antes de comprar. ### 2. Círculo de Competência Invista apenas em negócios que você **entende profundamente**: **Dentro do círculo (investir):** * ✅ Negócio que você entende * ✅ Setor que você conhece * ✅ Produto que você usa * ✅ Vantagem competitiva clara **Fora do círculo (evitar):** * ❌ Biotecnologia complexa * ❌ Empresas em países desconhecidos * ❌ Setores muito técnicos * ❌ Modelos de negócio confusos ### 3. Pensamento de Longo Prazo Value investing requer paciência. O mercado pode demorar **anos** para reconhecer o valor. ### 4. Independência de Pensamento Ir contra a manada é essencial. As melhores oportunidades surgem quando todos estão vendendo. *** ## Indicadores Fundamentais para Value Investing ### Indicadores de Valuation ```typescript // Analisar valuation de uma ação via brapi.dev const response = await fetch( "https://brapi.dev/api/quote/ITUB4?modules=defaultKeyStatistics,financialData", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); const acao = results[0]; const stats = acao.defaultKeyStatistics ?? {}; const financials = acao.financialData ?? {}; // Indicadores principais const indicadores = { "P/L": acao.priceEarnings ?? stats.trailingPE, "P/VP": stats.priceToBook, "EV/EBITDA": stats.enterpriseToEbitda, "Dividend Yield": stats.dividendYield }; ``` ### Tabela de Referência - Indicadores de Valor | Indicador | O que significa | Barato | Caro | | ------------- | ------------------------- | ------ | ----- | | **P/L** | Preço ÷ Lucro por ação | \< 10 | > 20 | | **P/VP** | Preço ÷ Valor Patrimonial | \< 1.5 | > 3 | | **EV/EBITDA** | Valor da empresa ÷ EBITDA | \< 6 | > 12 | | **P/Receita** | Preço ÷ Receita | \< 1 | > 3 | | **DY** | Dividendos ÷ Preço | > 6% | \< 2% | ### Indicadores de Qualidade ```typescript // Analisar qualidade de uma empresa via brapi.dev const response = await fetch( "https://brapi.dev/api/quote/WEGE3?modules=defaultKeyStatistics,financialData", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); const acao = results[0]; const financials = acao.financialData ?? {}; // Indicadores de qualidade const qualidade = { "ROE": financials.returnOnEquity, // Retorno sobre PL "ROA": financials.returnOnAssets, // Retorno sobre Ativos "Margem Líquida": financials.profitMargins, "Dívida/PL": financials.debtToEquity }; ``` ### Tabela de Referência - Qualidade | Indicador | O que significa | Bom | Ruim | | ------------------ | -------------------------- | ----- | ----- | | **ROE** | Lucro ÷ Patrimônio Líquido | > 15% | \< 8% | | **ROA** | Lucro ÷ Ativos Totais | > 8% | \< 3% | | **Margem Líquida** | Lucro ÷ Receita | > 10% | \< 5% | | **Dívida/PL** | Dívida ÷ Patrimônio | \< 1 | > 2 | | **Dívida/EBITDA** | Dívida ÷ EBITDA | \< 2 | > 4 | *** ## Screener de Value Investing ### Critérios de Benjamin Graham (Investidor Defensivo) **Critérios do screener:** * P/L ≤ 15 * P/VP ≤ 1,5 * P/L × P/VP ≤ 22,5 (Graham Number) * Dividend Yield ≥ 2% * Dívida/PL ≤ 1,0 * ROE ≥ 10% ```typescript // Screener Graham via brapi.dev const response = await fetch( "https://brapi.dev/api/quote/list?type=stock&limit=100", { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { stocks } = await response.json(); // Para cada ação, verificar critérios Graham const aprovadas = []; for (const stock of stocks) { const detailRes = await fetch( `https://brapi.dev/api/quote/${stock.stock}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await detailRes.json(); const acao = results[0]; const pl = acao.priceEarnings; const pvp = acao.defaultKeyStatistics?.priceToBook; if (pl > 0 && pl <= 15 && pvp > 0 && pvp <= 1.5 && pl * pvp <= 22.5) { aprovadas.push({ ticker: acao.symbol, pl, pvp, graham: pl * pvp }); } } ``` O "Graham Number" (P/L × P/VP ≤ 22,5) combina duas métricas para garantir que a ação seja barata tanto em relação ao lucro quanto ao patrimônio. ### Magic Formula de Joel Greenblatt Combina empresas baratas (Earnings Yield) com empresas boas (Return on Capital): **Como funciona:** 1. **Earnings Yield** = 1/P/L (quanto maior, mais barata) 2. **ROIC** = Return on Invested Capital (quanto maior, melhor qualidade) 3. Ranqueia todas as ações por EY e ROIC 4. Soma os ranks e ordena (menor = melhor) ```typescript // Magic Formula via brapi.dev const tickers = ["ITUB4", "WEGE3", "VALE3", "BBAS3", "EGIE3"]; const response = await fetch( `https://brapi.dev/api/quote/${tickers.join(",")}?modules=defaultKeyStatistics,financialData`, { headers: { Authorization: "Bearer SEU_TOKEN" } } ); const { results } = await response.json(); const ranking = results .filter(a => a.priceEarnings > 0 && a.financialData?.returnOnEquity > 0) .map(a => ({ ticker: a.symbol, earningsYield: (1 / a.priceEarnings) * 100, roe: (a.financialData?.returnOnEquity ?? 0) * 100 })); // Rankear e somar posições ``` A Magic Formula busca o "melhor dos dois mundos": empresas que são **baratas** (alto Earnings Yield) **e** de **alta qualidade** (alto ROIC). *** ## Calculando o Valor Intrínseco ### Método do Fluxo de Caixa Descontado (DCF) **Exemplo: Empresa com lucro de R$ 5 bilhões** | Premissa | Valor | | ------------------------ | ------------ | | Lucro atual | R$ 5 bilhões | | Crescimento (10 anos) | 8% a.a. | | Taxa de desconto (WACC) | 12% | | Crescimento perpetuidade | 3% | | Ações emitidas | 5 bilhões | **Cálculo simplificado:** | Etapa | Valor | | --------------------------------- | -------------------- | | Soma fluxos descontados (10 anos) | R$ 42,3 bilhões | | Valor terminal descontado | R$ 65,8 bilhões | | **Valor da empresa** | **R$ 108,1 bilhões** | | **Valor intrínseco/ação** | **R$ 21,62** | | Preço com margem 30% | R$ 15,13 | **Regra:** Se a ação está abaixo de R$ 15,13, há margem de segurança de 30% para comprar. ### Graham Number Fórmula simplificada de Benjamin Graham: **Fórmula:** Graham Number = √(22,5 × LPA × VPA) **Exemplo:** | Item | Valor | | --------------------- | ------------ | | LPA (Lucro/Ação) | R$ 5,50 | | VPA (Patrimônio/Ação) | R$ 28,00 | | **Graham Number** | **R$ 55,68** | Cálculo: √(22,5 × 5,50 × 28,00) = √3.465 = R$ 55,68 O Graham Number representa o **preço máximo** a pagar pela ação segundo os critérios de Graham. ### Múltiplo de Lucros (Regra de Peter Lynch) **Regra:** P/L justo = taxa de crescimento esperada Empresa crescendo 15% a.a. → P/L justo de 15 (PEG = 1) **Exemplo:** | Item | Valor | | -------------------- | ------------ | | LPA | R$ 4,00 | | Crescimento esperado | 12% a.a. | | P/L justo (PEG = 1) | 12 | | **Valor intrínseco** | **R$ 48,00** | Cálculo: R$ 4,00 × 12 = R$ 48,00 *** ## Checklist de Value Investing **Para cada ação candidata, verifique:** ### Valuation * ✅ P/L \< 15 (ideal) * ✅ P/VP \< 1,5 (ideal) * ✅ Graham (P/L × P/VP) \< 22,5 ### Qualidade * ✅ ROE > 15% * ✅ Margem líquida estável * ✅ Dívida/PL \< 1 ### Dividendos * ✅ Dividend Yield > 4% (ideal) * ✅ Payout sustentável ### Resultado * **≥ 80% critérios:** 🟢 Forte candidata * **60-80% critérios:** 🟡 Análise mais profunda * **\< 60% critérios:** 🔴 Não atende valor *** ## Armadilhas de Valor (Value Traps) ### O que são Value Traps? Ações que parecem baratas, mas estão baratas por um bom motivo. O "valor" nunca se materializa. ### Como Identificar Value Traps **Sinais de alerta:** | Sinal | Por que é perigoso | | ------------------------- | ----------------------------------------------------- | | ROE \< 8% | Empresa pode estar em declínio | | Margem líquida \< 5% | Pouca rentabilidade | | Perto da mínima de 52 sem | Verificar motivo da queda | | Setor em declínio | Problema estrutural, não cíclico | | ROE caindo há anos | Empresa perdendo eficiência | | Dívida crescente | Pode quebrar antes de se recuperar | | Gestão vendendo ações | Insiders sabem algo que você não sabe | | Dividendo insustentável | DY alto por queda de preço, não aumento de dividendos | **Verificação manual necessária:** * [ ] A empresa tem vantagem competitiva durável? * [ ] Os lucros estão estáveis ou crescendo? * [ ] A dívida está sob controle? * [ ] O setor tem futuro promissor? * [ ] A gestão é competente e honesta? Nem tudo que é barato é bom. Algumas ações estão baratas porque merecem estar baratas. *** ## Portfólio Value Investing ### Exemplo de Carteira Value **Carteira diversificada com critérios de valor:** | Ticker | Setor | Peso | Critério | | ------ | ----------- | ---- | ------------------------- | | BBAS3 | Bancos | 12% | P/L baixo historicamente | | ITUB4 | Bancos | 10% | Qualidade + valor | | EGIE3 | Utilities | 10% | Previsível, dividendos | | TAEE11 | Utilities | 10% | Alto DY, estável | | CPLE6 | Utilities | 8% | Desconto vs setor | | BBSE3 | Seguros | 10% | ROE alto, desconto | | VALE3 | Commodities | 10% | Comprar na baixa do ciclo | | GGBR4 | Siderurgia | 8% | Cíclica, baixo P/L | | ABEV3 | Consumo | 10% | Marca forte, estável | | WEGE3 | Industrial | 12% | Qualidade premium | **Critério de entrada:** Comprar quando P/L abaixo da média histórica ### Quando Comprar e Vender **COMPRAR quando:** * P/L abaixo da média de 5 anos * P/VP abaixo de 1.5 (ou média histórica) * Dividend Yield acima da média * Margem de segurança > 25% * Fundamentos intactos apesar da queda * Mercado em pânico (medo generalizado) **VENDER quando:** * Tese de investimento quebrou * Fundamentos deterioraram permanentemente * Valuation ficou esticado (P/L > 20) * Encontrou oportunidade muito melhor * Posição ficou grande demais (> 15% carteira) * Empresa cortou dividendos por problemas estruturais **NÃO VENDER quando:** * Preço caiu (sem mudança de fundamentos) * Mercado está em baixa * Notícias ruins de curto prazo * Medo ou ansiedade * Lucro de curto prazo (IR reduz retorno) *** ## Perguntas Frequentes sobre Value Investing ### Value Investing ainda funciona? **Sim**, mas requer paciência. Growth stocks dominaram 2010-2021, mas value teve forte recuperação em 2022-2024. Ciclos alternam. ### Quanto tempo esperar o valor se realizar? Em média, **2-5 anos**. Algumas oportunidades se concretizam em meses, outras levam uma década. ### Posso fazer value investing com pouco dinheiro? **Sim!** Comece com ETFs de valor (DIVO11) ou ações fracionadas. O importante é a disciplina e o método. ### Qual a diferença entre Value e Growth? * **Value**: Compra empresas estabelecidas abaixo do valor justo * **Growth**: Compra empresas de alto crescimento, mesmo caras Warren Buffett hoje combina os dois: **"Quality at a Reasonable Price"**. *** ## Conclusão Value Investing é uma das estratégias mais comprovadas para construção de riqueza no longo prazo. Baseada em princípios sólidos de análise e disciplina, ela permite que investidores comuns superem o mercado comprando ótimas empresas a preços justos. **Pontos-chave:** * Busque margem de segurança de pelo menos 25-30% * Invista dentro do seu círculo de competência * Use indicadores como P/L, P/VP, ROE e Dividend Yield * Cuidado com value traps - nem tudo que é barato é bom * Tenha paciência - resultados levam anos * Combine valor com qualidade Para automatizar seus screeners e análises de valor, use a [API da brapi.dev](https://brapi.dev) e construa suas próprias ferramentas de stock picking. *** ## Recursos Adicionais * [Documentação da API brapi.dev](/docs) * [Buy and Hold - Estratégia Complementar](/blog/buy-and-hold-estrategia-investimento-longo-prazo) * [Análise Fundamentalista](/blog/analise-fundamentalista-o-que-e) * [Como investir em ações](/blog/como-investir-em-acoes-guia-completo-iniciantes) # Varejo e E-commerce em 2026: MGLU3, LREN3 ou MELI34? URL: /blog/varejo-ecommerce-mglu3-lren3-meli34-analise-2026.mdx Análise do setor de varejo e e-commerce para 2026. Quem sobreviveu à crise? Magalu, Lojas Renner ou Mercado Livre? Impacto dos juros e consumo. *** searchable: true title: 'Varejo e E-commerce em 2026: MGLU3, LREN3 ou MELI34?' description: 'Análise do setor de varejo e e-commerce para 2026. Quem sobreviveu à crise? Magalu, Lojas Renner ou Mercado Livre? Impacto dos juros e consumo.' date: '2026-01-01' keywords: 'varejo 2026, ecommerce brasil 2026, mglu3 vale a pena, lren3 analise, meli34 bdr, magazine luiza, lojas renner, mercado livre' author: 'Equipe brapi.dev' category: 'Ações' subcategory: 'Setores' readingTime: '14 min' tags: \['Varejo', 'E-commerce', 'MGLU3', 'LREN3', 'MELI34', 'Juros', 'Consumo'] relatedPosts: \['onde-investir-2026-guia-completo-melhores-investimentos', 'small-caps-promissoras-2026-analise'] featured: false expertise: 'Análise de sobrevivência e crescimento no competitivo setor de varejo brasileiro.' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; O setor de varejo brasileiro viveu um verdadeiro "apocalipse" nos últimos anos, com juros altos dizimando margens, recuperações judiciais (o fantasma da Americanas ainda assombra) e a concorrência feroz dos *cross-borders* chineses. Porém, 2026 traz um novo horizonte. Com a estabilização ou queda da Selic e o aumento da renda real da população, o varejo pode ser a grande "fênix" da Bolsa. Mas nem todas as empresas sobreviverão ou prosperarão. É preciso separar o joio do trigo. Nesta análise, focamos em três gigantes com perfis diferentes: **Magazine Luiza (MGLU3)**, **Lojas Renner (LREN3)** e **Mercado Livre (MELI34)**. *** ## O Fator Macro: Juros e Crédito Varejo é, essencialmente, venda a crédito. * **Juros Altos:** Encarecem a dívida das empresas (despesa financeira come o lucro) e diminuem o poder de compra do consumidor (parcela não cabe no bolso). * **Juros Baixos (Cenário Otimista 2026):** Alavancagem operacional na veia. As despesas financeiras caem e as vendas sobem. É o cenário dos sonhos para MGLU3 e LREN3. *** ## 1. Magazine Luiza (MGLU3): A Luta pela Volta por Cima A Magalu foi do céu ao inferno. De "queridinha da bolsa" a uma queda de mais de 90%. * **Tese 2026:** A Magalu sobreviveu. Ajustou custos, focou em rentabilidade ao invés de crescimento a qualquer custo e monetizou seu marketplace. * **Pontos Fortes:** Omnichannel (lojas físicas + digital) muito bem integrado, marca forte e logística eficiente (Malha Luiza). * **Risco:** Concorrência brutal (Amazon, Mercado Livre). Margens ainda muito apertadas. Depende drasticamente da queda da Selic para voltar a dar lucros consistentes e robustos. * **Perfil:** Aposta de alto risco e alto retorno (Turnaround). ## 2. Lojas Renner (LREN3): A "Best in Class" do Vestuário A Renner sempre foi vista como o "relógio suíço" do varejo de moda: execução perfeita e crescimento constante. * **Tese 2026:** Recuperação das vendas em mesmas lojas (SSS) e melhoria na Realize (braço financeiro que sofreu com inadimplência). A Renner está se adaptando à moda rápida digital para combater a Shein. * **Pontos Fortes:** Gestão premium, caixa líquido (ou dívida muito baixa), marca forte e ecossistema de moda. * **Risco:** Mudança estrutural no consumo de moda (fast fashion chinês) e dificuldade de repassar preços. * **Perfil:** Qualidade (Quality). É a aposta mais segura dentro do varejo físico. ## 3. Mercado Livre (MELI34): O "Rei" da América Latina Embora seja uma empresa argentina listada na Nasdaq (aqui acessada via BDR MELI34), o Brasil é seu maior mercado. * **Tese 2026:** O Mercado Livre já ganhou a guerra do e-commerce. Sua logística é imbatível (entregas no mesmo dia) e o Mercado Pago virou um banco digital gigantesco. * **Pontos Fortes:** O "fosso" (moat) logístico é intransponível para a maioria. Crescimento de receitas continua na casa de dois dígitos altos. Dominância de mercado. * **Risco:** Valuation. A empresa é excelente, mas o preço é "caro" (múltiplos altos). Risco regulatório e competição com Amazon. * **Perfil:** Crescimento Secular (Growth). A melhor empresa do setor, mas exige pagar um prêmio por isso. *** ## Comparativo: E-commerce vs Varejo Físico A fronteira entre físico e digital acabou (Figital), mas as dinâmicas financeiras mudam. | Indicador | MGLU3 (Híbrido) | LREN3 (Físico/Moda) | MELI34 (Digital/Fintech) | | :------------------------ | :--------------------- | :---------------------------------- | :--------------------------------- | | **Sensibilidade a Juros** | Extrema | Alta | Média/Baixa (Tem braço financeiro) | | **Margens** | Baixas (Varejo Eletro) | Médias (Moda tem margem bruta alta) | Altas (Serviços + Take rate) | | **Concorrência** | Amazon, Casas Bahia | C\&A, Riachuelo, Shein | Amazon, Shopee, Bancos | | **Dívida** | Ponto de Atenção | Controlada/Caixa Líquido | Controlada | *** ## Análise Técnica Simplificada Podemos usar a API da brapi.dev para verificar a volatilidade recente, um indicador de risco importante para o setor. ```typescript const response = await fetch( 'https://brapi.dev/api/quote/MGLU3,LREN3,MELI34?range=1y&interval=1d', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() // Calcule a volatilidade usando data.results[i].historicalDataPrice ``` **Volatilidade Anualizada (Estimada):** | Ticker | Volatilidade | Interpretação | | ------ | ------------ | ---------------------------- | | MGLU3 | \~65% | Altíssima - Montanha Russa | | LREN3 | \~35% | Média/Alta - Típica de Bolsa | | MELI34 | \~40% | Alta - Típica de Tech Growth | > **Atenção:** Alta volatilidade significa maior risco, mas também maior potencial de retorno. *** ## Conclusão: Quem colocar no carrinho em 2026? * **Para o Conservador:** Fique longe do varejo ou tenha uma exposição mínima via **LREN3** (Lojas Renner), que tem balanço sólido para aguentar desaforo. * **Para o Arrojado (Turnaround):** **MGLU3** (Magazine Luiza) é a aposta de que os juros vão cair e o consumo vai explodir. Se der certo, o *upside* é gigante. Se der errado, a ação anda de lado. * **Para o Investidor de Longo Prazo (Growth):** **MELI34** (Mercado Livre). É a empresa que será dona do comércio e dos pagamentos na América Latina na próxima década. Compre nos recuos de preço. O varejo é cíclico. Em 2026, estamos (esperamos) na parte de recuperação do ciclo. Aproveite, mas não esqueça o cinto de segurança. *** ## Leia Mais * **[Análise Setor Bancário: ITUB4 vs BBAS3](/blog/acoes-bancos-analise-setorial-2026)** * **[Commodities: VALE3 e PETR4](/blog/vale3-petr4-commodities-analise-2026)** # WEG (WEGE3): A Fábrica de Milionários Continua em 2026? URL: /blog/wege3-analise-crescimento-2026.mdx Análise completa da WEG (WEGE3) para 2026. Entenda por que ela é considerada a melhor empresa da bolsa, seus múltiplos e perspectivas de crescimento. *** searchable: true title: 'WEG (WEGE3): A Fábrica de Milionários Continua em 2026?' description: 'Análise completa da WEG (WEGE3) para 2026. Entenda por que ela é considerada a melhor empresa da bolsa, seus múltiplos e perspectivas de crescimento.' date: '2026-01-02' keywords: 'wege3 analise 2026, weg vale a pena, weg dividendos, fabrica de milionarios, industria 4.0, internacionalização weg, wege3 preço alvo' author: 'Equipe brapi.dev' category: 'Ações' subcategory: 'Indústria' readingTime: '12 min' tags: \['WEG', 'WEGE3', 'Crescimento', 'Indústria', 'Internacionalização', 'Quality'] relatedPosts: \['onde-investir-2026-guia-completo-melhores-investimentos', 'melhores-acoes-setor-eletrico-2026-dividendos-taee11-trpl4', 'small-caps-promissoras-2026-analise'] featured: true expertise: 'Deep dive na tese de investimento da empresa industrial mais bem-sucedida do Brasil.' lastReviewed: 2026-01-03 ------------------------ import { Authors, Author } from '~/components/Authors'; Se existe uma unanimidade na bolsa brasileira, ela se chama **WEG (WEGE3)**. A empresa de Jaraguá do Sul (SC) é frequentemente citada como a "melhor empresa da bolsa" e ganhou o apelido de "fábrica de milionários" por ter multiplicado o capital de seus acionistas de longo prazo de forma exponencial nas últimas décadas. Mas rentabilidade passada não garante rentabilidade futura. A pergunta para 2026 é: **a WEG ainda tem espaço para crescer ou ficou cara demais?** *** ## O Segredo da WEG: Cultura e Execução A WEG não faz nada "revolucionário" como criar um iPhone ou um algoritmo de busca. Ela faz motores elétricos, transformadores, tintas industriais e componentes de automação. Coisas "chatas", mas essenciais. O segredo está na **execução**: 1. **Verticalização:** A WEG faz quase tudo internamente, controlando custos e qualidade. 2. **Internacionalização:** Mais de 50% da receita vem do exterior. Ela ganha em Dólar/Euro e gasta em Real, o que cria um *hedge* natural e margens robustas. 3. **Inovação Incremental:** A WEG investe pesado em P\&D para criar produtos mais eficientes energeticamente, algo vital no mundo ESG de 2026. *** ## Avenidas de Crescimento para 2026 Para justificar seu *valuation* (sempre esticado), a WEG precisa continuar crescendo. De onde virá esse crescimento? ### 1. Energias Renováveis e Transição Energética O mundo precisa de energia limpa. A WEG fornece aerogeradores (eólica), painéis e inversores (solar) e transformadores para conectar tudo isso à rede. A demanda por esses equipamentos segue aquecida globalmente. ### 2. Mobilidade Elétrica (Powertrain) A WEG não faz carros, mas faz o que move os carros elétricos (motores e inversores) e a infraestrutura de recarga (estações de carregamento). Em 2026, com a frota elétrica crescendo no Brasil e no mundo, essa divisão ganha relevância. ### 3. Eficiência Energética Industrial Indústrias querem gastar menos luz. Trocar um motor velho por um WEG novo se paga em poucos meses. Essa demanda é constante e resiliente a crises. ### 4. Aquisições (M\&A) A WEG tem caixa líquido e uma equipe de M\&A afiada. Ela compra empresas menores (tecnologia, IA industrial, sensores) para complementar seu portfólio sem fazer loucuras financeiras. *** ## O Elefante na Sala: Valuation (Preço) A principal crítica à WEGE3 é que ela é "cara". * **P/L (Preço/Lucro):** Historicamente negocia acima de 30x ou 40x lucros. * **P/VP (Preço/Valor Patrimonial):** Também muito acima da média de mercado (5x a 10x). **A visão do investidor de WEG:** Você paga caro por qualidade. A WEG cresce seus lucros a 15-20% ao ano consistentemente. Um P/L de 30x hoje vira um P/L de 15x em poucos anos se o lucro dobrar, e a cotação tende a acompanhar. **Risco 2026:** Se a WEG parar de crescer ou "apenas" crescer pouco (ex: 5% ao ano), o mercado vai punir a ação severamente, derrubando seus múltiplos (o tal *derating*). *** ## Comparativo com Pares Globais A WEG não se compara com empresas brasileiras, mas com gigantes globais como Siemens, ABB e Schneider Electric. E, incrivelmente, a WEG costuma ter margens e retorno sobre capital investido (ROIC) **superiores** a essas gigantes. **Análise de WEGE3:** ```typescript const response = await fetch( 'https://brapi.dev/api/quote/WEGE3?modules=defaultKeyStatistics,financialData', { headers: { 'Authorization': 'Bearer SEU_TOKEN' } } ) const data = await response.json() const stock = data.results[0] // stock.defaultKeyStatistics e stock.financialData → dados fundamentalistas ``` **Indicadores-Chave WEGE3:** | Indicador | Valor Típico | Por que Importa | | -------------- | ------------ | -------------------------------------- | | P/L | 25-35x | Alto, mas justificado pelo crescimento | | ROIC | 20-25% | Excelente alocação de capital | | Margem Líquida | 15-18% | Superior à média global | | ROE | 20-25% | Rentabilidade consistente | > **💡 Interpretação:** Um ROIC alto (>15-20%) indica que a empresa aloca capital magistralmente. É isso que sustenta o crescimento composto no longo prazo. *** ## Conclusão: Comprar ou Esperar? **WEGE3** é aquela ação que você "compra e esquece" (Buy and Hold). * Se você não tem: Comece montando posição aos poucos. Não tente acertar o "fundo". * Se você já tem: Provavelmente é uma das maiores alegrias da sua carteira. Mantenha. Para 2026, a WEG continua sendo uma fortaleza. Em um Brasil volátil, ter uma empresa global, dolarizada e bem gerida é um seguro de vida para o patrimônio. Pode não multiplicar por 10x rápido como uma Small Cap, mas dificilmente vai te dar sustos. *** ## Leia Mais * **[Small Caps Promissoras: Onde estão as "Novas WEGs"?](/blog/small-caps-promissoras-2026-analise)** * **[Varejo e E-commerce: MGLU3 e LREN3](/blog/varejo-ecommerce-mglu3-lren3-meli34-analise-2026)** # Cotações da Bolsa Brasileira no WordPress: Shortcode Personalizado 2025 URL: /blog/wordpress-cotacoes-b3-shortcode-personalizado.mdx Aprenda a criar um shortcode WordPress para exibir cotações automáticas da bolsa brasileira em posts e páginas. Integração completa com cache e função personalizada. *** searchable: true title: 'Cotações da Bolsa Brasileira no WordPress: Shortcode Personalizado 2025' description: 'Aprenda a criar um shortcode WordPress para exibir cotações automáticas da bolsa brasileira em posts e páginas. Integração completa com cache e função personalizada.' date: '2025-10-12' keywords: 'wordpress cotações, shortcode bolsa brasileira, wordpress api, cotações wordpress, brapi wordpress, plugin cotações' author: 'Equipe brapi.dev' category: 'Tutoriais e Integrações' subcategory: 'CMS e Plataformas' readingTime: '6 min' tags: \['WordPress', 'PHP', 'Shortcode', 'CMS', 'Integração'] relatedPosts: \['integracao-google-sheets-cotacoes-b3-tutorial-completo', 'api-b3-python-requests-guia-pratico'] featured: false expertise: 'Desenvolvimento WordPress - 6+ anos' lastReviewed: '2025-10-12' howToTools: \['WordPress 5.0+', 'Acesso ao functions.php', 'Conta brapi.dev'] howToSteps: * name: 'Obtenha seu token da API' text: 'Crie uma conta gratuita em brapi.dev e copie seu token no painel de usuário.' * name: 'Acesse o functions.php' text: 'No painel WordPress, vá em Aparência > Editor de Tema e abra o arquivo functions.php.' * name: 'Adicione o código do shortcode' text: 'Cole a função PHP que registra o shortcode \[brapi\_cotacao] usando wp\_remote\_get() para chamar a API.' * name: 'Configure o cache' text: 'Use set\_transient() para armazenar cotações por 15 minutos e evitar requisições excessivas.' * name: 'Use o shortcode' text: 'Em qualquer post ou página, insira \[brapi\_cotacao ticker="PETR4"] para exibir a cotação.' *** import { Author, Authors } from '~/components/Authors'; > Crie um shortcode personalizado para exibir cotações automáticas de ações, ETFs e FIIs em seu site WordPress. ## Por Que Integrar Cotações no WordPress? Sites financeiros, blogs de investimentos e portais de notícias precisam exibir cotações atualizadas. Com a brapi.dev, você pode: * Exibir cotações em posts e páginas * Atualizar automaticamente os preços * Usar cache para performance * Criar widgets personalizados ## Implementação Básica Adicione este código ao `functions.php` do seu tema ou em um plugin personalizado: ```php 10, 'headers' => ['Authorization' => "Bearer {$token}"], ]); if (is_wp_error($response)) { return 'Erro ao buscar dados'; } $body = wp_remote_retrieve_body($response); $data = json_decode($body, true); if (isset($data['results'][0]['regularMarketPrice'])) { $price = $data['results'][0]['regularMarketPrice']; set_transient($transient_key, $price, 60); return $price; } return 'Cotação indisponível'; } function brapi_stock_price_shortcode($atts) { $atts = shortcode_atts([ 'ticker' => 'PETR4', ], $atts); $price = brapi_get_stock_price($atts['ticker']); if (is_numeric($price)) { return 'R$ ' . number_format($price, 2, ',', '.'); } return $price; } add_shortcode('brapi_cotacao', 'brapi_stock_price_shortcode'); ?> ``` ## Uso no WordPress ### Em Posts e Páginas ``` [brapi_cotacao ticker="PETR4"] ``` ### Múltiplos Ativos ``` Petrobras: [brapi_cotacao ticker="PETR4"] Vale: [brapi_cotacao ticker="VALE3"] Itaú: [brapi_cotacao ticker="ITUB4"] ``` ### Em Templates PHP ```php ``` ## Versão Avançada com Formatação ```php 'PETR4', 'show_change' => 'true', 'show_name' => 'true', ], $atts); $ticker = $atts['ticker']; $transient_key = 'brapi_full_' . $ticker; $cached = get_transient($transient_key); if ($cached !== false) { return $cached; } $token = get_option('brapi_token'); $url = "https://brapi.dev/api/quote/{$ticker}"; $response = wp_remote_get($url, [ 'timeout' => 10, 'headers' => ['Authorization' => "Bearer {$token}"], ]); if (is_wp_error($response)) { return '
Erro ao carregar cotação
'; } $body = wp_remote_retrieve_body($response); $data = json_decode($body, true); if (!isset($data['results'][0])) { return '
Cotação não encontrada
'; } $quote = $data['results'][0]; $html = '
'; if ($atts['show_name'] === 'true') { $html .= '
' . esc_html($quote['shortName']) . '
'; } $html .= '
' . esc_html($quote['symbol']) . '
'; $html .= '
R$ ' . number_format($quote['regularMarketPrice'], 2, ',', '.') . '
'; if ($atts['show_change'] === 'true') { $change_class = $quote['regularMarketChangePercent'] > 0 ? 'positive' : 'negative'; $change_sign = $quote['regularMarketChangePercent'] > 0 ? '+' : ''; $html .= '
'; $html .= $change_sign . number_format($quote['regularMarketChangePercent'], 2, ',', '.') . '%'; $html .= '
'; } $html .= '
'; set_transient($transient_key, $html, 60); return $html; } add_shortcode('brapi_widget', 'brapi_stock_widget_shortcode'); // Adicionar CSS function brapi_enqueue_styles() { wp_add_inline_style('wp-block-library', ' .brapi-stock-widget { padding: 15px; border: 1px solid #ddd; border-radius: 8px; margin: 10px 0; max-width: 300px; } .brapi-name { font-size: 14px; color: #666; } .brapi-ticker { font-weight: bold; font-size: 18px; } .brapi-price { font-size: 24px; font-weight: bold; margin: 10px 0; } .brapi-change { font-size: 16px; font-weight: 600; } .brapi-change.positive { color: #10b981; } .brapi-change.negative { color: #ef4444; } '); } add_action('wp_enqueue_scripts', 'brapi_enqueue_styles'); ?> ``` ### Uso do Widget Avançado ``` [brapi_widget ticker="PETR4" show_change="true" show_name="true"] ``` ## Bloco Gutenberg ```php 'brapi-block', 'render_callback' => 'brapi_render_block' ]); } add_action('init', 'brapi_register_block'); function brapi_render_block($attributes) { $ticker = $attributes['ticker'] ?? 'PETR4'; return brapi_stock_widget_shortcode(['ticker' => $ticker]); } ?> ``` ## Página de Configurações ```php

Token salvo com sucesso!

'; } $token = get_option('brapi_token', ''); ?>

Configurações brapi.dev

Obtenha seu token em brapi.dev

``` ## Boas Práticas ### 1. Use Cache ```php set_transient($cache_key, $data, 60); // Cache de 60 segundos ``` ### 2. Valide Dados ```php $ticker = sanitize_text_field($atts['ticker']); ``` ### 3. Trate Erros ```php if (is_wp_error($response)) { error_log('brapi Error: ' . $response->get_error_message()); return 'Erro temporário'; } ``` ## Próximos Passos * [Veja exemplos em PHP](/docs/examples/php) * [Integre com outras plataformas](/docs/examples) * [Explore a documentação](/docs) ## Conclusão Com poucos minutos você pode adicionar cotações automáticas da bolsa brasileira em qualquer site WordPress. Use shortcodes para flexibilidade e cache para performance! # A API fornece acesso às logos das empresas brasileiras listadas em bolsa? URL: /faq/a-api-fornece-acesso-as-logos-das-empresas-listadas-na-b3.mdx undefined *** title: "A API fornece acesso às logos das empresas brasileiras listadas em bolsa?" categories: * data\_coverage * plans *** Sim, **todos os planos da brapi (Gratuito, Startup e Pro) incluem acesso às logos oficiais das empresas brasileiras listadas em bolsa**. Este recurso está disponível sem custo adicional e permite que você melhore significativamente a experiência visual dos seus usuários. ## Características das logos As imagens são fornecidas com as seguintes características: * **Formato otimizado para web**: arquivos leves que carregam rapidamente * **Alta qualidade**: resolução adequada para diferentes tamanhos de exibição * **Padronização**: todas as logos seguem um padrão visual consistente * **Atualização automática**: quando uma empresa atualiza sua identidade visual, a brapi reflete a mudança ## Como acessar as logos Para obter a logo de uma empresa, basta incluir o parâmetro correspondente na sua requisição ao endpoint de cotações. A resposta incluirá a URL da logo que você pode usar diretamente na sua aplicação. ```bash GET /api/quote/PETR4 # Resposta inclui campo "logourl" com a URL da imagem ``` ## Casos de uso comuns As logos são especialmente úteis para: * **Dashboards de investimentos**: exibir visualmente a carteira do usuário * **Aplicativos de análise**: facilitar identificação rápida de ativos * **Plataformas de trading**: melhorar a interface com elementos visuais * **Relatórios e apresentações**: criar materiais mais profissionais * **Watchlists**: permitir reconhecimento instantâneo das empresas monitoradas ## Vantagens para desenvolvedores Ao usar as logos fornecidas pela brapi, você: 1. **Economiza tempo**: não precisa buscar e manter um banco de imagens próprio 2. **Evita problemas legais**: as logos são fornecidas para uso em contexto financeiro 3. **Garante consistência**: todas as imagens têm qualidade e formato padronizados 4. **Mantém atualização**: não precisa se preocupar quando empresas mudam suas logos Este recurso está incluído em todos os planos, então mesmo usuários do plano gratuito podem criar aplicações visualmente atraentes com as logos das empresas brasileiras. # A Brapi oferece planos personalizados para grandes volumes? URL: /faq/a-brapi-oferece-planos-personalizados-para-grandes-volumes-ou-necessidades-especificas.mdx Conheça as opções de planos Enterprise da brapi para empresas com grandes volumes de requisições ou necessidades específicas de dados financeiros. *** author: 'Alisson Leal' title: 'A Brapi oferece planos personalizados para grandes volumes?' description: 'Conheça as opções de planos Enterprise da brapi para empresas com grandes volumes de requisições ou necessidades específicas de dados financeiros.' categories: * plans\_advanced * plans *** **Sim!** Para empresas com demandas que excedem nossos planos padrão, oferecemos soluções Enterprise personalizadas. ## Planos Padrão Nossos planos atuais atendem a maioria dos casos de uso: | Plano | Requisições/mês | Ideal Para | | -------- | --------------- | ---------------------------- | | Gratuito | 15.000 | Testes e projetos pessoais | | Startup | 150.000 | Apps em crescimento | | Pro | 500.000 | Uso intensivo e profissional | ## Quando Considerar Enterprise O plano Enterprise é indicado quando você precisa de: ### Volume Elevado * Mais de 500.000 requisições/mês * Picos de tráfego previsíveis * Múltiplas aplicações consumindo a API ### Recursos Específicos * SLA garantido com tempo de resposta * Endpoint dedicado * Suporte técnico prioritário * Consultoria de integração ### Requisitos Corporativos * Contrato formal * Faturamento personalizado * Nota fiscal com CNPJ * Termos de uso específicos ## O Que Oferecemos no Enterprise | Recurso | Pro | Enterprise | | ----------- | ------------- | -------------- | | Requisições | 500k/mês | Personalizado | | SLA | Best effort | Garantido | | Suporte | Prioritário | Dedicado | | Contrato | Termos padrão | Personalizado | | Faturamento | Cartão | Boleto/TED/PIX | | Consultoria | ❌ | ✅ | ## Como Solicitar 1. **Entre em contato** através do [formulário](/contact) ou email [contato@brapi.dev](mailto:contato@brapi.dev) 2. **Descreva sua necessidade:** volume esperado, casos de uso, requisitos 3. **Receba uma proposta** personalizada em até 48 horas 4. **Negocie termos** que atendam ambas as partes 5. **Inicie a integração** com suporte dedicado ## Informações Úteis para Sua Solicitação Ao entrar em contato, inclua: * Volume estimado de requisições/mês * Tipo de aplicação (fintech, corporativo, etc.) * Dados específicos que precisa * Requisitos de SLA * Timeline de implementação ## Empresas que Usam Enterprise * Fintechs em escala * Corretoras e distribuidoras * Plataformas de análise * Empresas de tecnologia financeira ## Ainda em Dúvida? Se não tem certeza se precisa do Enterprise, comece com o **plano Pro**. Você pode migrar para Enterprise quando sua demanda crescer. [Entrar em contato para Enterprise →](/contact) [Ver planos padrão →](/pricing) # A brapi tem dados de FIIs? URL: /faq/a-brapi-tem-dados-de-fundos-imobiliarios-fiis-tao-detalhados-quanto-os-de-acoes.mdx Sim. A brapi oferece indicadores, imóveis, composição de portfólio, relatórios CVM, dividendos e histórico de preços em endpoints de FIIs. *** author: "Alisson Leal" title: "A brapi tem dados de FIIs?" description: "Sim. A brapi oferece indicadores, imóveis, composição de portfólio, relatórios CVM, dividendos e histórico de preços em endpoints de FIIs." categories: * fiis * data\_coverage *** **Sim — e em vários aspectos a cobertura de FIIs é tão profunda quanto a de ações.** Com a família de endpoints `/api/v2/fii/*` (lançada como produto dedicado, separado do `/api/quote/`), a brapi entrega indicadores fundamentalistas, relatórios gerenciais da CVM, histórico de rendimentos e cotações OHLCV diárias. ## Endpoints dedicados a FIIs | Endpoint | O que entrega | | ------------------------------------ | ---------------------------------------------------------------------- | | `GET /api/v2/fii/list` | Listagem com filtros por segmento, gestão e setor | | `GET /api/v2/fii/indicators` | P/VP, DY 12m e 1m, retorno mensal, patrimônio, cotistas, administrador | | `GET /api/v2/fii/indicators/history` | Evolução mensal dos indicadores acima | | `GET /api/v2/fii/historical` | OHLCV diário (open, high, low, close, volume) | | `GET /api/v2/fii/properties` | Imóveis físicos, área e vacância por trimestre | | `GET /api/v2/fii/portfolio` | Composição normalizada do portfólio por trimestre | | `GET /api/v2/fii/reports` | Relatórios mensais enviados à CVM | | `GET /api/v2/fii/dividends` | Histórico de rendimentos e amortizações | Documentação completa em [`/docs/fiis`](/docs/fiis). ## O que está disponível para cada FII | Dado | Disponibilidade | Endpoint | | -------------------------------------------------- | --------------- | ---------------------------------- | | Cotações com o delay do plano | ✅ | `/api/quote/HGLG11` | | Histórico OHLCV diário | ✅ | `/api/v2/fii/historical` | | Histórico de dividendos/rendimentos | ✅ | `/api/v2/fii/dividends` | | Dividend Yield 12m e 1m | ✅ | `/api/v2/fii/indicators` | | P/VP (Preço/Valor Patrimonial) | ✅ | `/api/v2/fii/indicators` | | Valor Patrimonial por Cota (NAV) | ✅ | `/api/v2/fii/indicators` | | Patrimônio líquido e ativos totais | ✅ | `/api/v2/fii/indicators` | | Número de cotistas | ✅ | `/api/v2/fii/indicators` | | Cotas em circulação | ✅ | `/api/v2/fii/indicators` | | Composição patrimonial (CRI, LCI, imóveis, fundos) | ✅ | `/api/v2/fii/reports` | | Taxa de administração | ✅ | `/api/v2/fii/reports` | | Retorno patrimonial mensal | ✅ | `/api/v2/fii/reports` | | Passivos e obrigações | ✅ | `/api/v2/fii/reports` | | Administrador (nome, CNPJ, contato) | ✅ | `/api/v2/fii/list` e `/indicators` | | Filtro por segmento (papel/tijolo/híbrido/fof) | ✅ | `/api/v2/fii/list` | | Filtro por setor (Logística, Shoppings, Lajes...) | ✅ | `/api/v2/fii/list` | ## Exemplo de Requisição Indicadores fundamentalistas de um FII: ```bash curl "https://brapi.dev/api/v2/fii/indicators?symbols=HGLG11" ``` Resposta: ```json { "fiis": [ { "symbol": "HGLG11", "asOfDate": "2025-03-31", "price": 156.05, "navPerShare": 171.48, "priceToNav": 0.91, "dividendYield12m": 0.0843, "dividendYield1m": 0.0072, "monthlyReturn": -0.0032, "totalInvestors": 488272, "sharesOutstanding": 53850000, "equity": 9232380000.0, "totalAssets": 10147254000.0, "segmentType": "tijolo", "segmentoAtuacao": "Logística", "adminName": "Credit Suisse Hedging-Griffo Cor. de Valores S.A.", "managerName": "CSHG Logística Fundo de Invest. Imob." } ] } ``` ## Relatórios da CVM completos Diferente do `/api/quote/`, que entrega cotação básica, o endpoint `/api/v2/fii/reports` traz a composição patrimonial detalhada do relatório gerencial mensal enviado à CVM: * **Imóveis físicos**, CRI, LCI, cotas de FIIs, recebíveis, caixa * **Rentabilidade mensal** patrimonial e da cota * **Dividend Yield** mensal * **Taxa de administração** e amortização * **Passivos** (distribuições a pagar, obrigações imobiliárias) ## Acesso por plano | Plano | Cotações básicas (`/api/quote/`) | Endpoints `/api/v2/fii/*` | | ------------------- | -------------------------------- | ------------------------- | | Sandbox (sem token) | ✅ | ✅ Apenas MXRF11 e HGLG11 | | Free | ✅ | ❌ | | Startup | ✅ | ❌ | | **Pro** | ✅ | ✅ **Todos os FIIs** | Para testar antes de assinar, use o sandbox com **MXRF11** ou **HGLG11** sem precisar de token. ## FIIs cobertos A base reúne mais de **1.500 instrumentos de FIIs cadastrados**, incluindo os fundos mais negociados do mercado brasileiro: * **Logística:** HGLG11, BTLG11, XPLG11, LVBI11 * **Shoppings:** XPML11, VISC11, HGBS11 * **Lajes Corporativas:** HGRE11, RCRB11, BRCR11 * **Papel/CRI:** MXRF11, KNCR11, IRDM11, KNIP11 * **Híbridos / FoF:** BCFF11, KNRI11, RBRF11 ## Comece agora * [Documentação dos endpoints `/api/v2/fii/*`](/docs/fiis) * [Guia para iniciantes em FIIs](/blog/fundos-imobiliarios-fiis-guia-completo-iniciantes) * [FIIs de Papel vs Tijolo: comparativo 2026](/blog/fiis-de-papel-vs-tijolo-comparativo-2026) # A API da brapi é grátis mesmo? URL: /faq/api-e-gratis-mesmo.mdx Sim. O plano Gratuito inclui 15.000 requisições por mês. PETR4, MGLU3, VALE3 e ITUB4 também podem ser testadas sem token e sem limite. *** author: "Alisson Leal" title: "A API da brapi é grátis mesmo?" description: "Sim. O plano Gratuito inclui 15.000 requisições por mês. PETR4, MGLU3, VALE3 e ITUB4 também podem ser testadas sem token e sem limite." categories: * getting\_started * plans priority: true *** **Sim. Você pode usar a API da brapi gratuitamente.** Há duas formas de começar: consultar as quatro ações de teste sem token ou criar uma conta no plano Gratuito para acessar outros ativos dentro dos limites do plano. ## Teste sem token PETR4, MGLU3, VALE3 e ITUB4 têm acesso irrestrito para testes. Uma primeira chamada funciona direto no terminal: ```bash curl "https://brapi.dev/api/quote/PETR4" ``` Esses quatro tickers não exigem autenticação. Se você misturar uma ação de teste com outro ticker na mesma requisição, será necessário enviar um token. ## O que inclui o plano Gratuito? | Recurso | Plano Gratuito | | ---------------------- | -------------------------- | | Preço | R$ 0 | | Requisições | 15.000 por mês | | Tickers por requisição | 1 | | Delay de cotações | Aproximadamente 30 minutos | | Histórico | Até 3 meses | | Dividendos | Não incluídos | O plano é adequado para aprender a API, validar uma integração e manter projetos pessoais que não dependem de dados recentes ou históricos longos. ## Quando preciso de um plano pago? O **Startup** amplia o limite para 150.000 requisições mensais, aceita até 10 tickers por chamada, reduz o delay para cerca de 15 minutos e inclui dividendos. O **Pro** oferece 500.000 requisições mensais, até 20 tickers por chamada, delay de aproximadamente 5 minutos, histórico completo e acesso aos endpoints dedicados de FIIs. Os preços atuais e as opções de cobrança anual estão na [página de planos](/pricing). Para escolher, considere principalmente volume, quantidade de tickers por chamada, recência dos dados e profundidade histórica. ## Próximo passo * [Criar uma conta gratuita](/dashboard) * [Consultar a documentação](/docs) * [Comparar todos os planos](/pricing) # Qual plano da brapi usar para fins comerciais? URL: /faq/api-para-fins-comerciais.mdx Startup atende integrações menores; Pro amplia volume, histórico e cobertura. Compare os requisitos do seu produto antes de escolher. *** author: "Alisson Leal" title: "Qual plano da brapi usar para fins comerciais?" description: "Startup atende integrações menores; Pro amplia volume, histórico e cobertura. Compare os requisitos do seu produto antes de escolher." categories: * commercial\_use * plans *** Para uso comercial, o **Startup** costuma atender integrações menores e o **Pro** atende produtos que precisam de mais volume, histórico completo ou endpoints dedicados de FIIs. | Recurso | Startup | Pro | | --------------------------- | --------: | -------: | | Requisições mensais | 150.000 | 500.000 | | Tickers por chamada | 10 | 20 | | Delay de ações | \~15 min | \~5 min | | Histórico | Até 1 ano | Completo | | Endpoints dedicados de FIIs | Não | Sim | Antes de decidir, estime as chamadas mensais, confirme a cobertura do endpoint e defina qual atraso é aceitável na interface. Os preços atuais estão em [/pricing](/pricing). Para regras de uso, atribuição e casos que possam envolver redistribuição de dados, consulte [uso em apps e empresas](/faq/posso-usar-a-brapi-para-construir-um-app-comercial-ou-para-minha-empresa) e os [termos](/legal/terms). # Como buscar o Ibovespa (IBOV) pela API? URL: /faq/buscar-ibov.mdx Use o símbolo ^BVSP no endpoint de cotações para consultar valor, variação e histórico do Ibovespa pela API da brapi. *** author: "Alisson Leal" title: "Como buscar o Ibovespa (IBOV) pela API?" description: "Use o símbolo ^BVSP no endpoint de cotações para consultar valor, variação e histórico do Ibovespa pela API da brapi." categories: * data\_coverage * getting\_started *** Use o símbolo **`^BVSP`** no endpoint de cotações. Ele representa o Ibovespa na API da brapi. ## Cotação atual do Ibovespa ```bash curl "https://brapi.dev/api/quote/%5EBVSP" ``` O acento circunflexo pode ser enviado como `^BVSP` ou codificado como `%5EBVSP`. A resposta usa o mesmo envelope das cotações de ações, com campos como preço, variação e horário de mercado. ## Histórico do índice Adicione `range` e `interval` para pedir uma série histórica: ```bash curl "https://brapi.dev/api/quote/%5EBVSP?range=1y&interval=1d" ``` Esse exemplo retorna observações diárias do último ano, respeitando a cobertura e os limites do seu plano. ## Outros índices disponíveis Consulte `GET /api/available` para descobrir símbolos disponíveis e seus metadados. Para detalhes dos parâmetros e do formato de resposta, veja a [documentação do endpoint de cotação](/docs/acoes/cotacao). # Como as requisições da API são contabilizadas? URL: /faq/como-a-api-e-calculada.mdx Cada chamada HTTP conta como uma requisição, mesmo quando inclui vários tickers. Veja os limites de ativos por chamada e como estimar o consumo. *** author: "Alisson Leal" title: "Como as requisições da API são contabilizadas?" description: "Cada chamada HTTP conta como uma requisição, mesmo quando inclui vários tickers. Veja os limites de ativos por chamada e como estimar o consumo." categories: * plans * getting\_started *** **Cada chamada HTTP concluída pela API conta como uma requisição.** Quando o plano aceita vários tickers na mesma chamada, consultar 10 ações juntas continua consumindo uma requisição, não dez. ```bash # Uma requisição com três tickers curl "https://brapi.dev/api/quote/PETR4,VALE3,ITUB4" ``` ## Quantos tickers cabem em uma chamada? | Plano | Requisições por mês | Tickers por chamada | | -------- | ------------------: | ------------------: | | Gratuito | 15.000 | 1 | | Startup | 150.000 | 10 | | Pro | 500.000 | 20 | A capacidade teórica de consultar muitos ativos depende de agrupar tickers, mas não deve ser tratada como garantia de cobertura: cada endpoint pode ter limites próprios, paginação e regras de acesso. ## Exemplo de cálculo Se seu backend atualiza uma carteira uma vez a cada 15 minutos, durante 12 horas por dia: ```text 4 chamadas/hora × 12 horas/dia × 30 dias = 1.440 requisições/mês ``` Agrupe os tickers permitidos, use cache e não faça polling mais frequente que a recência necessária. O [dashboard](/dashboard) mostra o consumo do ciclo atual. Veja a [tabela completa de limites](/faq/quais-as-limitacoes) e a [comparação de planos](/pricing). # Como a Brapi me ajuda a economizar tempo e recursos? URL: /faq/como-a-brapi-me-ajuda-a-economizar-tempo-e-recursos.mdx Descubra como a brapi automatiza a coleta de dados financeiros e economiza centenas de horas de desenvolvimento. Foque em analisar, não em coletar. *** author: 'Alisson Leal' title: 'Como a Brapi me ajuda a economizar tempo e recursos?' description: 'Descubra como a brapi automatiza a coleta de dados financeiros e economiza centenas de horas de desenvolvimento. Foque em analisar, não em coletar.' categories: * benefits priority: true *** A brapi elimina a complexidade de coletar, processar e manter dados financeiros atualizados, permitindo que você foque no que realmente importa: **analisar e construir**. ## O Que Você Evita Fazer ### Sem a brapi, você precisaria: | Tarefa | Tempo Estimado | Complexidade | | --------------------------------- | -------------- | ------------ | | Criar scrapers de dados | 40-80 horas | Alta | | Processar PDFs da CVM | 20-40 horas | Muito alta | | Parsear dados de múltiplas fontes | 30-50 horas | Alta | | Manter infraestrutura | Contínuo | Média | | Atualizar quando fontes mudam | Contínuo | Alta | | Tratar inconsistências | 10-20 horas | Média | **Total estimado:** 100-200+ horas iniciais + manutenção contínua ### Com a brapi: * **Uma chamada de API** retorna dados prontos para uso * **Zero manutenção** de scrapers e parsers * **Dados já tratados** e padronizados * **Atualizações automáticas** sem intervenção ## Economia Real ### Para Desenvolvedores Individuais * **Tempo economizado:** 100+ horas * **Valor do tempo:** R$ 10.000+ (considerando R$ 100/hora) * **Custo do Pro:** R$ 139,99/mês * **ROI:** Positivo no primeiro mês ### Para Empresas * **Redução de escopo:** Não precisa de desenvolvedor dedicado a dados * **Time to market:** Semanas em vez de meses * **Manutenção:** Zero custo com atualização de fontes * **Confiabilidade:** Dados validados e consistentes ## O Que Você Ganha ### Foco no Core Business Em vez de gastar energia coletando dados, você pode: * Desenvolver features que agregam valor * Melhorar a experiência do usuário * Escalar sua aplicação * Analisar dados em vez de coletá-los ### Dados de Qualidade * **Padronizados:** Formato consistente para todas as empresas * **Validados:** Processo de verificação de qualidade * **Completos:** Cotações, fundamentos, dividendos, histórico * **Atualizados:** Frequência de minutos a horas ## Exemplo Prático **Sem brapi:** ```python # Semanas de trabalho scraper = CriarScraper() parser = CriarParser() db = ConfigurarBanco() scheduler = AgendarAtualizacoes() # + manutenção contínua ``` **Com brapi:** ```python # 5 minutos de trabalho response = requests.get("https://brapi.dev/api/quote/PETR4") dados = response.json() ``` ## Quem Mais se Beneficia * **Startups:** Validar ideias rapidamente sem infraestrutura * **Freelancers:** Entregar projetos mais rápido * **Empresas:** Reduzir custo de desenvolvimento * **Investidores:** Acessar dados sem programação complexa * **Estudantes:** Focar no aprendizado, não na coleta [Começar a economizar tempo →](/pricing) # Como entrar em contato com a equipe da brapi? URL: /faq/como-entrar-em-contato.mdx Entre em contato com a equipe da brapi para informações, dúvidas e novidades. Siga-nos no LinkedIn para atualizações, networking e suporte direto. Ou envie um email para contato@brapi.dev para respostas rápidas dentro de 24 horas úteis. *** author: 'Alisson Leal' title: 'Como entrar em contato com a equipe da brapi?' description: 'Entre em contato com a equipe da brapi para informações, dúvidas e novidades. Siga-nos no LinkedIn para atualizações, networking e suporte direto. Ou envie um email para [contato@brapi.dev](mailto:contato@brapi.dev) para respostas rápidas dentro de 24 horas úteis.' toc: false ---------- Se você deseja entrar em contato com a equipe da brapi para obter informações, tirar dúvidas ou acompanhar as últimas novidades sobre o nosso projeto, você pode fazer isso de maneira simples. Veja como: ## Perguntas ou Dúvidas? Se você tiver alguma pergunta ou dúvida sobre a API da brapi, não hesite em entrar em contato conosco. Estamos aqui para ajudar! ## Opções de Contato ### Siga-nos no LinkedIn A maneira mais fácil de se manter atualizado sobre as últimas novidades, atualizações e anúncios importantes relacionados à brapi é seguindo nossa página oficial no [LinkedIn](https://www.linkedin.com/company/brapi.dev). Nossa presença no LinkedIn é uma fonte confiável de informações relevantes. #### Benefícios de Seguir-nos no LinkedIn Ao seguir a brapi no LinkedIn, você terá acesso a uma série de benefícios: * **Atualizações Regulares:** Compartilhamos regularmente informações sobre melhorias na API, lançamento de novos recursos e outros anúncios importantes. Isso garante que você esteja sempre atualizado sobre o que está acontecendo com a brapi. * **Comunicação Direta:** O LinkedIn oferece uma maneira conveniente de se comunicar diretamente conosco. Você pode enviar mensagens, fazer perguntas e interagir conosco por meio dessa plataforma. * **Networking:** Além de receber informações, você também pode fazer networking com outros profissionais e empresas que compartilham interesse na brapi e em dados financeiros. * **Apoio e Suporte:** Se você tiver dúvidas ou precisar de suporte, o LinkedIn é um canal onde podemos ajudar a esclarecer suas consultas. Portanto, não perca a oportunidade de se conectar conosco no [LinkedIn](https://www.linkedin.com/company/brapi.dev) e ficar por dentro de tudo o que está acontecendo com a brapi. Esperamos vê-lo por lá! ### Mande um Email * **Endereço:** [contato@brapi.dev](mailto:contato@brapi.dev) * **Resposta Rápida:** Normalmente, respondemos aos emails dentro de 7 dias úteis. # Como funciona o cancelamento da assinatura? URL: /faq/como-funciona-o-cancelamento-da-assinatura.mdx Saiba como cancelar sua assinatura na brapi de forma simples e sem burocracia. Entenda o que acontece após o cancelamento e como reativar quando quiser. *** author: 'Alisson Leal' title: 'Como funciona o cancelamento da assinatura?' description: 'Saiba como cancelar sua assinatura na brapi de forma simples e sem burocracia. Entenda o que acontece após o cancelamento e como reativar quando quiser.' categories: * plan\_management *** Na brapi, acreditamos em flexibilidade total. Você pode cancelar sua assinatura a qualquer momento, sem multas ou taxas adicionais. ## Como Cancelar 1. Acesse sua [Dashboard](/dashboard) 2. Clique em **Gerenciar Assinatura** 3. Selecione a opção **Cancelar Assinatura** 4. Confirme o cancelamento O processo é imediato e 100% online, sem necessidade de contato com suporte. ## O Que Acontece Após o Cancelamento * **Acesso mantido:** Você continua com todos os benefícios do seu plano até o final do período já pago * **Dados preservados:** Suas configurações e histórico de uso são mantidos * **Chave de API:** Continua funcionando até o fim do ciclo de faturamento * **Sem cobranças futuras:** Nenhum valor adicional será debitado ## Exemplo Prático Se você assinou o plano Pro no dia 15 de janeiro e cancelar no dia 20 de janeiro, terá acesso completo ao plano Pro até o dia 15 de fevereiro (30 dias após a assinatura). ## Reativação Mudou de ideia? Você pode reativar sua assinatura a qualquer momento: * Acesse a [página de planos](/pricing) * Escolha o plano desejado * O acesso é liberado imediatamente após a confirmação do pagamento ## Política de Reembolso Oferecemos reembolso proporcional em casos específicos. Consulte nossa [política de reembolso](/faq/voces-oferecem-politica-de-reembolso) para mais detalhes. Tem dúvidas sobre o cancelamento? [Entre em contato](/contact) que teremos prazer em ajudar. # Como consultar dividendos e JCP pela API da brapi? URL: /faq/como-os-dados-de-dividendos-dos-planos-pagos-me-ajudam.mdx Os planos pagos incluem dados de proventos com valor por ação, data-com e data de pagamento para análises de renda e histórico. *** author: "Alisson Leal" title: "Como consultar dividendos e JCP pela API da brapi?" description: "Os planos pagos incluem dados de proventos com valor por ação, data-com e data de pagamento para análises de renda e histórico." categories: * dividends * plans\_advanced priority: true *** Os planos **Startup e Pro** incluem dados de proventos de ações. Eles permitem montar históricos de dividendos e JCP, calcular valores recebidos por uma carteira e exibir datas importantes no seu produto. ## Campos principais | Campo | Significado | | --------------- | ------------------------------------- | | `rate` | Valor do provento por ação | | `lastDatePrior` | Data-com, último dia para ter direito | | `paymentDate` | Data de pagamento, quando informada | | `approvedOn` | Data de aprovação, quando informada | | `label` | Tipo ou descrição do provento | Os nomes acima refletem a resposta da API. Nem todo evento terá todas as datas preenchidas, então a integração deve tratar valores nulos. ## Exemplo Peça o módulo de dividendos no endpoint de cotação: ```bash curl -H "Authorization: Bearer SEU_TOKEN" \ "https://brapi.dev/api/quote/PETR4?dividends=true" ``` A resposta inclui `dividendsData.cashDividends`, além de outras categorias de eventos quando disponíveis. ## Casos de uso * consolidar proventos recebidos por uma carteira; * comparar histórico de pagamentos entre empresas; * criar calendário de data-com e pagamento; * calcular dividend yield com uma metodologia explícita; * exibir alertas de eventos corporativos. Histórico não é previsão. Empresas podem reduzir, suspender ou alterar pagamentos. Para consultar a estrutura completa, veja a [documentação de ações](/docs/acoes). # Como realizar um upgrade ou downgrade de plano? URL: /faq/como-trocar-de-plano.mdx Saiba como realizar um upgrade ou downgrade de plano na brapi. Acesse a sua Dashboard, siga o guia passo a passo e escolha o plano certo para atender às necessidades do seu projeto. Após a troca de plano, tenha acesso imediato aos novos recursos e limites. Conte com o suporte da brapi para uma ótima experiência com nossa API. *** author: 'Alisson Leal' title: 'Como realizar um upgrade ou downgrade de plano?' description: 'Saiba como realizar um upgrade ou downgrade de plano na brapi. Acesse a sua Dashboard, siga o guia passo a passo e escolha o plano certo para atender às necessidades do seu projeto. Após a troca de plano, tenha acesso imediato aos novos recursos e limites. Conte com o suporte da brapi para uma ótima experiência com nossa API.' --------------------------- ### Passo a Passo para Trocar de Plano A brapi oferece flexibilidade quando se trata de escolher o plano que melhor atende às suas necessidades. Se você deseja fazer um upgrade para um plano com mais recursos ou realizar um downgrade para um plano mais básico, siga este guia simples: 1. Acesse a sua [Dashboard](https://brapi.dev/dashboard). 2. Clique na opção **Editar Plano**. 3. Ou, você também pode acessar diretamente a página de planos clicando [aqui](https://brapi.dev/api/create-billing-portal-link). 4. Ou, na [página de planos](https://brapi.dev/pricing), selecione o novo plano desejado. ### Escolhendo o Plano Certo Ao escolher um novo plano, leve em consideração as necessidades do seu projeto. Se você precisa de mais requisições, ações por requisição ou recursos adicionais, um plano superior pode ser a escolha certa. Por outro lado, se suas necessidades forem mais básicas, um plano mais econômico pode ser adequado. ### Acompanhando as Mudanças Após fazer a troca de plano, você terá acesso imediato aos recursos e limites do novo plano selecionado. Certifique-se de monitorar seu uso da API e ajustar seu plano conforme necessário para evitar surpresas relacionadas a limites de requisições. A brapi está aqui para fornecer suporte e flexibilidade em suas escolhas de plano. Se você tiver dúvidas ou precisar de assistência, não hesite em [entrar em contato conosco](https://brapi.dev/contact). Estamos aqui para ajudar a garantir que você tenha a melhor experiência possível com a API da brapi. # É fácil integrar a API da Brapi como desenvolvedor? URL: /faq/e-facil-integrar-a-api-da-brapi-como-desenvolvedor.mdx Descubra como é simples integrar a API da brapi. REST API intuitiva com exemplos em JavaScript, Python, PHP e outras linguagens. *** author: 'Alisson Leal' title: 'É fácil integrar a API da Brapi como desenvolvedor?' description: 'Descubra como é simples integrar a API da brapi. REST API intuitiva com exemplos em JavaScript, Python, PHP e outras linguagens.' categories: * dev\_integration priority: true *** **Muito fácil!** A brapi foi projetada para desenvolvedores, com foco em simplicidade e boa documentação. ## Primeiros Passos ### 1. Obtenha sua Chave 1. [Crie uma conta](/dashboard) gratuitamente 2. Acesse sua Dashboard 3. Copie seu token de API ### 2. Faça sua Primeira Requisição ```bash curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/PETR4" ``` Pronto! Você já está recebendo dados. ## Exemplos por Linguagem ### JavaScript / Node.js ```javascript const response = await fetch("https://brapi.dev/api/quote/PETR4", { headers: { Authorization: "Bearer SEU_TOKEN" }, }); const data = await response.json(); console.log(data.results[0].regularMarketPrice); ``` ### Python ```python import requests response = requests.get( "https://brapi.dev/api/quote/PETR4", headers={"Authorization": "Bearer SEU_TOKEN"}, ) data = response.json() print(data["results"][0]["regularMarketPrice"]) ``` ### PHP ```php $context = stream_context_create([ 'http' => ['header' => "Authorization: Bearer SEU_TOKEN\r\n"], ]); $response = file_get_contents( "https://brapi.dev/api/quote/PETR4", false, $context ); $data = json_decode($response, true); echo $data["results"][0]["regularMarketPrice"]; ``` ## Por Que É Tão Simples ### API REST Padrão * **Requisições GET:** Sem complexidade de autenticação OAuth * **JSON puro:** Formato universal, fácil de parsear * **URLs intuitivas:** `/api/quote/PETR4` é autoexplicativo ### Documentação Completa Nossa [documentação](/docs) inclui: * Referência completa de endpoints * Exemplos de código prontos * Playground interativo * Schemas de resposta ## Tempo de Integração | Tipo de Projeto | Tempo Estimado | | ------------------- | -------------- | | Script simples | 5-15 minutos | | App básico | 1-2 horas | | Integração completa | 1-2 dias | ## Recursos para Desenvolvedores ### Documentação Interativa * Teste endpoints direto no navegador * Veja respostas em tempo real * Copie exemplos de código ### Suporte * [FAQ técnico](/faq) para dúvidas comuns * Documentação detalhada de cada parâmetro * Suporte prioritário para planos pagos ## Dicas para Começar 1. **Comece pelo plano gratuito:** Teste a integração sem custo 2. **Use o Playground:** Experimente antes de codificar 3. **Leia os exemplos:** Acelere sua implementação 4. **Trate erros:** Implemente retry para falhas de rede ## Integrações Populares A brapi funciona bem com: * **Planilhas:** Google Sheets, Excel * **Dashboards:** Grafana, Metabase * **Apps:** React, Vue, Flutter * **Automação:** n8n, Zapier, Make [Acessar documentação →](/docs) [Começar gratuitamente →](/dashboard) # Como posso acessar a documentação da API? URL: /faq/existe-alguma-documentacao.mdx Acesse a completa Documentação da API da brapi para informações detalhadas sobre como usar nossa API de maneira eficaz. Saiba tudo sobre endpoints, parâmetros, respostas e obtenha exemplos práticos de uso. Aproveite o acesso fácil e direto para explorar todos os recursos que nossa API oferece. *** author: 'Alisson Leal' title: 'Como posso acessar a documentação da API?' description: 'Acesse a completa Documentação da API da brapi para informações detalhadas sobre como usar nossa API de maneira eficaz. Saiba tudo sobre endpoints, parâmetros, respostas e obtenha exemplos práticos de uso. Aproveite o acesso fácil e direto para explorar todos os recursos que nossa API oferece.' ---------------------------------------------------------------------- Se você está interessado em utilizar a API da brapi e deseja obter informações detalhadas sobre como fazê-lo, temos uma solução simples para você. Acesse nossa completa [Documentação da API da brapi](https://brapi.dev/docs). ## O que Você Encontrará na Documentação? Nossa documentação abrangente oferece tudo o que você precisa para começar a usar a API da brapi de maneira eficaz: ### Detalhes dos Endpoints A documentação inclui informações detalhadas sobre os endpoints disponíveis na API. Isso permite que você saiba exatamente como acessar os dados que precisa. ### Parâmetros das Solicitações Descubra quais parâmetros são suportados em suas solicitações para personalizar os resultados da API de acordo com suas necessidades. ### Respostas Retornadas Entenda as respostas retornadas pela API para interpretar os dados e utilizá-los em seu projeto. ### Exemplos de Uso Oferecemos exemplos práticos de uso da API para ajudar você a começar rapidamente. ## Acesso Fácil e Conveniente O acesso à nossa documentação é simples e direto. Basta clicar no link a seguir e você estará a caminho de utilizar a API da brapi com confiança: [Documentação da API da brapi](https://brapi.dev/docs) Utilize nossa documentação para explorar todos os recursos e possibilidades que nossa API oferece. Estamos aqui para ajudar você a aproveitar ao máximo nossos serviços. # Quais são as fontes de dados utilizadas pela brapi? URL: /faq/fonte-de-dados.mdx Descubra as fontes de dados utilizadas pela brapi para fornecer informações sobre ações, índices, empresas e cotações. Trabalhamos com dados públicos e fontes institucionais para entregar informações consistentes e atualizadas. *** author: 'Alisson Leal' title: 'Quais são as fontes de dados utilizadas pela brapi?' description: 'Descubra as fontes de dados utilizadas pela brapi para fornecer informações sobre ações, índices, empresas e cotações. Trabalhamos com dados públicos e fontes institucionais para entregar informações consistentes e atualizadas.' ---------------------------------------------------------------------------- ## Fontes de Dados A brapi utiliza dados públicos, bases institucionais e fontes abertas para construir sua camada de dados do mercado financeiro brasileiro. Entre as principais fontes e referências utilizadas estão: * **CVM (Comissão de Valores Mobiliários):** documentos societários, demonstrativos, informes e eventos corporativos. * **Banco Central do Brasil:** séries econômicas, PTAX e indicadores monetários. * **Dados públicos de mercado:** listagem de ativos, metadados e informações de negociação publicamente disponíveis. * **Fontes abertas e bases públicas complementares:** usadas para enriquecer e validar conjuntos específicos de dados. ## Como tratamos esses dados A brapi consolida, normaliza e valida essas informações para oferecer uma API consistente, com formato previsível e pronta para uso em aplicações e análises. Nosso foco é priorizar dados públicos e fontes confiáveis, reduzindo dependências frágeis e melhorando a estabilidade da plataforma ao longo do tempo. # Há desconto para assinatura anual dos planos pagos? URL: /faq/ha-desconto-para-assinatura-anual-dos-planos-pagos.mdx Economize até 2 meses com a assinatura anual dos planos Startup e Pro da brapi. Veja como funciona o desconto e qual plano escolher. *** author: 'Alisson Leal' title: 'Há desconto para assinatura anual dos planos pagos?' description: 'Economize até 2 meses com a assinatura anual dos planos Startup e Pro da brapi. Veja como funciona o desconto e qual plano escolher.' categories: * plans * plan\_management priority: true *** **Sim!** Ao optar pela assinatura anual dos planos Startup ou Pro, você recebe um desconto significativo, equivalente a **2 meses grátis**. ## Economia com Plano Anual | Plano | Mensal | Anual | Economia | | ------- | ------------- | --------------- | ----------------------- | | Startup | R$ 119,99/mês | R$ 1.199,90/ano | **R$ 239,98** (2 meses) | | Pro | R$ 139,99/mês | R$ 1.399,90/ano | **R$ 279,98** (2 meses) | ## Vantagens do Plano Anual ### 1. Economia Financeira * **\~17% de desconto** comparado ao pagamento mensal * Previsibilidade no orçamento * Proteção contra reajustes durante o período ### 2. Continuidade Garantida * Acesso ininterrupto por 12 meses * Sem preocupação com renovação mensal * Ideal para projetos de longo prazo ### 3. Compromisso com Qualidade * Demonstra confiança no serviço * Permite planejamento de features de longo prazo * Melhor experiência geral ## Para Quem é Recomendado O plano anual é ideal para: * **Empresas:** Orçamento previsível e sem renovações mensais * **Desenvolvedores profissionais:** Projetos de longo prazo * **Investidores sérios:** Uso contínuo e consistente * **Startups:** Otimização de custos operacionais ## Como Assinar o Plano Anual 1. Acesse a [página de planos](/pricing) 2. Selecione o plano desejado (Startup ou Pro) 3. Escolha a opção **Anual** antes de finalizar 4. Complete o pagamento ## Posso Mudar de Mensal para Anual? Sim! Se você já é assinante mensal: 1. Acesse sua [Dashboard](/dashboard) 2. Clique em **Gerenciar Assinatura** 3. Selecione a opção de migrar para anual 4. O valor proporcional será calculado automaticamente ## Cancelamento do Plano Anual Mesmo no plano anual, você pode cancelar a qualquer momento. Porém: * O reembolso é **proporcional** ao período não utilizado * Consulte nossa [política de reembolso](/faq/voces-oferecem-politica-de-reembolso) [Ver planos anuais →](/pricing) # FAQ - Perguntas Frequentes URL: /faq.mdx Encontre respostas para as perguntas mais comuns sobre a API da brapi. Aprenda como usar nossa API para obter dados financeiros, implementar autenticação e otimizar suas consultas. *** searchable: false title: 'FAQ - Perguntas Frequentes' description: 'Encontre respostas para as perguntas mais comuns sobre a API da brapi. Aprenda como usar nossa API para obter dados financeiros, implementar autenticação e otimizar suas consultas.' ---------------------------------------- # FAQ - Perguntas Frequentes O mercado financeiro brasileiro está em constante movimento, e ter acesso a dados financeiros atualizados é essencial para tomar decisões informadas nos mercados globais. É por isso que a API da brapi se tornou uma ferramenta indispensável para desenvolvedores e empresas que buscam integrar dados financeiros em suas aplicações. ## Como começar? Para começar a usar a API da brapi, você pode fazer uma requisição simples para obter informações sobre uma ação específica. Por exemplo, para obter dados da Petrobras (PETR4), você pode usar: ```bash curl https://brapi.dev/api/quote/PETR4 ``` Esta requisição retornará informações básicas sobre a ação, incluindo preço atual, variação e volume. ## Posso usar a API gratuitamente? Sim! A API da brapi oferece um plano gratuito que permite até 15.000 requisições por mês. Este plano é ideal para desenvolvedores que estão começando ou para projetos de menor escala. ## Ações de teste com acesso irrestrito Para facilitar o desenvolvimento e teste da API, disponibilizamos **4 ações com acesso completo e irrestrito**: * **PETR4** (Petrobras PN) * **MGLU3** (Magazine Luiza ON) * **VALE3** (Vale ON) * **ITUB4** (Itaú Unibanco PN) ### Vantagens das ações de teste: ✅ **Sem necessidade de autenticação** - Não precisa de token ou chave de API\ ✅ **Sem limites de requisições** - Pode fazer quantas requisições quiser\ ✅ **Acesso a todos os módulos** - Dados fundamentalistas, históricos, dividendos\ ✅ **Todos os intervalos e períodos** - 1m, 5m, 1h, 1d, 1y, etc.\ ✅ **Dados em tempo real** - Informações sempre atualizadas ### Exemplos de uso: ```bash # Cotação simples da Petrobras (sem token) curl https://brapi.dev/api/quote/PETR4 # Dados históricos completos (sem token) curl https://brapi.dev/api/quote/VALE3?range=1y&interval=1d # Todas as 4 ações com módulos avançados (sem token) curl "https://brapi.dev/api/quote/PETR4,MGLU3,VALE3,ITUB4?modules=summaryProfile,balanceSheetHistory,defaultKeyStatistics÷nds=true" ``` **⚠️ Importante:** Se você misturar ações de teste com outras ações na mesma requisição, a autenticação será obrigatória. **Exemplo que requer autenticação:** ```bash # Mistura PETR4 (teste) com BBAS3 (requer token) curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/PETR4,BBAS3" ``` ## Quais dados estão disponíveis? A API oferece uma ampla gama de dados financeiros, incluindo: * Cotações de ações, FIIs e BDRs * Dados históricos de preços * Informações sobre dividendos * Dados fundamentalistas (balanços, DREs) * Indicadores financeiros * Dados de criptomoedas * Taxas de câmbio * Índices econômicos ## Como obter dados históricos? Para obter dados históricos, você pode usar os parâmetros `range` e `interval`. Por exemplo: ```bash curl https://brapi.dev/api/quote/PETR4?range=1y&interval=1d ``` Isso retornará dados diários do último ano para a Petrobras. ## Como funciona a autenticação? Para planos pagos, você receberá uma chave de API que deve ser incluída no cabeçalho `Authorization` das suas requisições: ```bash curl -H "Authorization: Bearer sua-chave-api" https://brapi.dev/api/quote/PETR4 ``` ## Há limites de requisições? Sim, os limites variam por plano: * **Gratuito**: 15.000 requisições/mês, 1 ação por requisição * **Startup**: 150.000 requisições/mês, 10 ações por requisição * **Pro**: 500.000 requisições/mês, 20 ações por requisição ## Como monitorar meu uso? Você pode acompanhar seu uso através do [dashboard](https://brapi.dev/dashboard), onde encontrará gráficos detalhados sobre suas requisições e limites. ## A API suporta WebSockets? Atualmente, a API funciona através de requisições HTTP REST. Para dados atualizados, recomendamos fazer requisições periódicas conforme sua necessidade. ## Como reportar problemas? Se encontrar algum problema ou tiver sugestões, você pode: * Enviar um email para [contato@brapi.dev](mailto:contato@brapi.dev) ## Documentação adicional Para informações mais detalhadas, consulte nossa [documentação completa](/docs) que inclui exemplos de código, referências de API e guias de implementação. # Posso Verificar Carteiras de Investimentos Usando a API? URL: /faq/integracao-com-a-b3.mdx Entenda como nossa API pode fornecer informações detalhadas sobre ações, fundos imobiliários (FII) e ativos financeiros do mercado brasileiro. Embora não ofereça integração direta para verificar carteiras específicas, ela complementa suas análises e fornece insights valiosos para seus investimentos. Consulte sua corretora para informações detalhadas sobre carteiras individuais. *** author: 'Alisson Leal' title: 'Posso Verificar Carteiras de Investimentos Usando a API?' description: 'Entenda como nossa API pode fornecer informações detalhadas sobre ações, fundos imobiliários (FII) e ativos financeiros do mercado brasileiro. Embora não ofereça integração direta para verificar carteiras específicas, ela complementa suas análises e fornece insights valiosos para seus investimentos. Consulte sua corretora para informações detalhadas sobre carteiras individuais.' ----------------------- Entendemos a importância de acompanhar seus investimentos e, embora nossa API ofereça informações atualizadas sobre ações, fundos imobiliários (FII) e outros ativos financeiros brasileiros, é importante notar que ela não oferece integração direta para verificar carteiras de investimentos específicas. No entanto, nossos endpoints fornecem dados detalhados sobre ativos financeiros, o que pode ser valioso para acompanhar e analisar seu portfólio pessoal. Você pode utilizar essas informações para obter uma visão abrangente do mercado financeiro e tomar decisões informadas sobre seus investimentos. Lembramos que a verificação de carteiras específicas pode envolver sistemas mais complexos e informações detalhadas sobre cada investimento. Portanto, recomendamos que você consulte sua corretora ou utilize ferramentas específicas de gestão de investimentos para esse fim. Nossa API é uma fonte confiável de dados financeiros que pode complementar suas análises e oferecer insights valiosos para seus investimentos, mesmo que não forneça acesso direto às carteiras individuais. # Meus dados de pagamento e minha chave de API estão seguros? URL: /faq/meus-dados-de-pagamento-e-minha-chave-de-api-estao-seguros.mdx Conheça as medidas de segurança da brapi para proteger seus dados de pagamento e sua chave de API. Criptografia, Stripe e boas práticas. *** author: 'Alisson Leal' title: 'Meus dados de pagamento e minha chave de API estão seguros?' description: 'Conheça as medidas de segurança da brapi para proteger seus dados de pagamento e sua chave de API. Criptografia, Stripe e boas práticas.' categories: * security * plans * dev\_integration *** **Absolutamente!** A segurança é prioridade máxima na brapi. Implementamos múltiplas camadas de proteção para seus dados. ## Segurança dos Pagamentos ### Processamento via Stripe Utilizamos o **Stripe**, líder mundial em pagamentos online: * **Certificação PCI-DSS Nível 1:** Mais alto padrão de segurança * **Criptografia end-to-end:** Dados protegidos em trânsito * **Tokenização:** Seus dados de cartão nunca chegam aos nossos servidores * **3D Secure:** Camada extra de autenticação quando disponível ### O Que a Brapi NÃO Armazena * Número do cartão de crédito * CVV/CVC * Data de validade * Dados bancários Apenas mantemos um token seguro do Stripe para processar renovações. ## Segurança da Chave de API ### Sua Responsabilidade A chave de API é como uma senha. Proteja-a: | ✅ Fazer | ❌ Evitar | | ---------------------------- | ------------------------- | | Usar variáveis de ambiente | Commitar no Git | | Restringir acesso no backend | Expor no frontend | | Regenerar se comprometida | Compartilhar publicamente | | Usar em conexões HTTPS | Enviar por mensagem | ### Boas Práticas de Integração ```bash # Variável de ambiente (recomendado) export BRAPI_TOKEN="seu_token_aqui" ``` ```python # No código import os token = os.environ.get("BRAPI_TOKEN") ``` ### Se Sua Chave For Comprometida 1. Acesse sua [Dashboard](/dashboard) 2. Clique em **Regenerar Token** 3. Atualize a chave em todas as suas aplicações 4. A chave antiga é invalidada imediatamente ## Infraestrutura Segura ### Proteção de Dados * **HTTPS obrigatório:** Toda comunicação é criptografada * **Servidores seguros:** Infraestrutura em nuvem com proteções avançadas * **Monitoramento:** Detecção de acessos suspeitos * **Backups:** Dados protegidos contra perda ### Conformidade * **LGPD:** Seguimos a Lei Geral de Proteção de Dados * **Termos claros:** [Política de privacidade](/legal/privacy) transparente * **Direito ao esquecimento:** Você pode solicitar exclusão de dados ## Dúvidas sobre Segurança Encontrou uma vulnerabilidade? [Entre em contato](/contact) imediatamente. Levamos reports de segurança muito a sério. [Ver política de privacidade →](/legal/privacy) # O histórico de cotações (OHLCV) do plano Pro é muito melhor? URL: /faq/o-historico-de-cotacoes-ohlcv-do-plano-pro-e-muito-melhor.mdx Entenda as diferenças no histórico de cotações OHLCV entre os planos da brapi e por que o Pro é essencial para backtests e análises avançadas. *** author: 'Alisson Leal' title: 'O histórico de cotações (OHLCV) do plano Pro é muito melhor?' description: 'Entenda as diferenças no histórico de cotações OHLCV entre os planos da brapi e por que o Pro é essencial para backtests e análises avançadas.' categories: * historical * plans\_advanced priority: true *** **Sim!** O plano Pro oferece o histórico mais completo, com mais de 10 anos de dados OHLCV (Open, High, Low, Close, Volume), essencial para análises avançadas. ## O Que é OHLCV? OHLCV representa os 5 dados fundamentais de cada período: | Sigla | Significado | Uso | | -------------- | ------------------- | ------------------------- | | **O** (Open) | Preço de abertura | Gaps de abertura | | **H** (High) | Preço máximo | Resistências | | **L** (Low) | Preço mínimo | Suportes | | **C** (Close) | Preço de fechamento | Análise técnica | | **V** (Volume) | Volume negociado | Confirmação de movimentos | ## Comparação de Histórico por Plano | Plano | Histórico Disponível | Casos de Uso | | -------- | -------------------- | ----------------------- | | Gratuito | 3 meses | Testes básicos | | Startup | 1 ano | Análises de médio prazo | | **Pro** | **10+ anos** | Backtests completos | ## Por Que 10+ Anos Fazem Diferença? ### 1. Backtesting de Estratégias Testar estratégias de investimento requer dados que cubram diferentes cenários: * **Crises:** 2008, 2015, 2020 (COVID) * **Bull markets:** Períodos de alta prolongada * **Eventos específicos:** Eleições, mudanças regulatórias ### 2. Análise de Ciclos Mercados funcionam em ciclos. Com 10+ anos você pode: * Identificar padrões sazonais * Analisar comportamento em diferentes cenários econômicos * Validar estratégias em múltiplos ciclos ### 3. Machine Learning Modelos de ML precisam de grandes volumes de dados para: * Treinamento adequado * Validação robusta * Generalização para diferentes condições ## Exemplo de Uso ```bash # Histórico completo para backtest GET /api/quote/PETR4?interval=1d&range=max # Retorna dados desde o IPO ou início do registro ``` ## Quem Precisa do Histórico Completo? * **Quant traders:** Desenvolvimento de algoritmos * **Analistas técnicos:** Identificação de padrões de longo prazo * **Desenvolvedores:** Apps de análise e simulação * **Pesquisadores:** Estudos acadêmicos e de mercado * **Investidores de longo prazo:** Análise de performance histórica ## Qualidade dos Dados Todos os dados OHLCV são: * **Ajustados por proventos:** Refletem splits e dividendos * **Validados:** Passam por processo de verificação * **Consistentes:** Formato padronizado para fácil integração [Acessar histórico completo com o Pro →](/pricing) # O plano gratuito tem limitações importantes? URL: /faq/o-plano-gratuito-tem-limitacoes-importantes.mdx Entenda as limitações do plano gratuito da brapi e descubra quando é hora de fazer upgrade para os planos Startup ou Pro. *** author: 'Alisson Leal' title: 'O plano gratuito tem limitações importantes?' description: 'Entenda as limitações do plano gratuito da brapi e descubra quando é hora de fazer upgrade para os planos Startup ou Pro.' categories: * plans priority: true *** Sim. O plano gratuito é excelente para testes e projetos pessoais, mas possui limitações que podem impactar usos mais avançados. ## Principais Limitações do Plano Gratuito | Recurso | Gratuito | Startup | Pro | | ---------------------- | -------- | -------- | -------- | | Requisições/mês | 15.000 | 150.000 | 500.000 | | Ações por requisição | 1 | 10 | 20 | | Histórico de dados | 3 meses | 1 ano | Completo | | Atraso dos dados | \~30 min | \~15 min | \~5 min | | Dados de dividendos | ❌ | ✅ | ✅ | | Dados fundamentalistas | Básico | Completo | Completo | | Suporte prioritário | ❌ | ✅ | ✅ | ## Quando o Plano Gratuito é Suficiente * **Testes iniciais:** Validar a integração antes de escalar * **Projetos pessoais:** Acompanhamento básico de carteira * **Estudos:** Aprendizado sobre APIs financeiras * **Prototipagem:** Desenvolver MVPs e provas de conceito ## Quando Fazer Upgrade Considere migrar para **Startup** ou **Pro** quando: * Precisar de dados históricos além de 3 meses * Necessitar de informações sobre dividendos * Desenvolver apps comerciais ou com tráfego * Precisar de dados com menor atraso * Querer consultar múltiplas ações em uma requisição ## Recomendação Para **análises profundas**, **apps comerciais** ou **decisões de investimento**, os planos pagos são essenciais. O [plano Startup](/pricing) oferece o melhor custo-benefício para a maioria dos casos, enquanto o [plano Pro](/pricing) é ideal para uso intensivo. [Comparar todos os planos →](/pricing) # Além do BVSP, vocês disponibilizam outros índices financeiros? URL: /faq/outros-indices.mdx Descubra os índices financeiros disponibilizados pela nossa API, além do BVSP. Acesse informações detalhadas sobre diversos índices financeiros que abrangem diferentes setores e segmentos do mercado. Tome decisões informadas com base em uma ampla variedade de dados financeiros. *** author: 'Alisson Leal' title: 'Além do BVSP, vocês disponibilizam outros índices financeiros?' description: 'Descubra os índices financeiros disponibilizados pela nossa API, além do BVSP. Acesse informações detalhadas sobre diversos índices financeiros que abrangem diferentes setores e segmentos do mercado. Tome decisões informadas com base em uma ampla variedade de dados financeiros.' toc: false ---------- Estamos comprometidos em fornecer uma ampla gama de informações financeiras para atender às suas necessidades. Além do índice IBovespa (^BVSP), nossa API oferece acesso a diversos outros índices financeiros. Aqui estão os detalhes: ## Índices Disponíveis Você pode explorar os seguintes links para obter informações detalhadas sobre os índices financeiros que disponibilizamos: * [Índices Disponíveis](https://brapi.dev/api/available): Este endpoint apresenta uma lista completa dos índices financeiros e ações disponíveis para consulta. Esses índices fornecem insights abrangentes sobre diferentes aspectos do mercado financeiro, permitindo que você acompanhe o desempenho de vários setores e segmentos. Dessa forma, você pode tomar decisões informadas e estratégicas com base em uma ampla variedade de dados financeiros. # Por que escolher o plano Pro em vez do Gratuito ou Startup? URL: /faq/por-que-escolher-o-plano-pro-em-vez-do-gratuito-ou-startup.mdx Compare os planos da brapi e descubra por que o Pro é a melhor opção para análises profissionais, apps financeiros e uso intensivo. *** author: 'Alisson Leal' title: 'Por que escolher o plano Pro em vez do Gratuito ou Startup?' description: 'Compare os planos da brapi e descubra por que o Pro é a melhor opção para análises profissionais, apps financeiros e uso intensivo.' categories: * plans\_advanced * plans priority: true *** O plano **Pro** é nossa solução completa, ideal para quem leva dados financeiros a sério. Veja por que é a escolha de profissionais e empresas. ## Comparativo Completo | Recurso | Gratuito | Startup | **Pro** | | ------------------------- | -------- | -------- | -------------- | | Requisições/mês | 15.000 | 150.000 | **500.000** | | Ações por requisição | 1 | 10 | **20** | | Atraso dos dados | \~30 min | \~15 min | **\~5 min** | | Histórico OHLCV | 3 meses | 1 ano | **10+ anos** | | Dados de dividendos | ❌ | ✅ | ✅ | | Fundamentalistas | Básico | Completo | **Completo** | | BP, DRE, DFC, DVA | ❌ | ✅ | ✅ | | Histórico fundamentalista | - | 1 ano | **Desde 2009** | | Suporte prioritário | ❌ | ✅ | **✅ Premium** | ## Vantagens Exclusivas do Pro ### 1. Histórico Completo (10+ Anos) Essencial para: * **Backtesting:** Testar estratégias em diferentes cenários de mercado * **Análise de ciclos:** Entender comportamento em crises e altas * **Machine Learning:** Treinar modelos com dados suficientes ### 2. Dados Fundamentalistas Desde 2009 Acesso a demonstrativos trimestrais e anuais: * Balanço Patrimonial (BP) * Demonstração de Resultados (DRE) * Fluxo de Caixa (DFC) * Demonstração de Valor Adicionado (DVA) ### 3. Menor Atraso (\~5 min) Para quem precisa de dados próximos ao tempo real: * Acompanhar oportunidades de compra * Monitorar stops e alertas * Reagir a movimentos de mercado ### 4. Maior Volume de Requisições 500.000 requisições/mês permitem: * Apps com tráfego significativo * Múltiplas aplicações * Análises em larga escala ## Quem Deve Escolher o Pro ### Profissionais * Analistas de investimento * Gestores de carteira * Traders ativos ### Empresas * Fintechs e startups * Plataformas de análise * Assessorias de investimento ### Desenvolvedores * Apps financeiros comerciais * Ferramentas de backtesting * Dashboards profissionais ## Investimento vs Retorno **R$ 139,99/mês** é menos que: * Uma consultoria financeira * Assinatura de plataformas premium * Horas de trabalho coletando dados manualmente Para quem toma decisões baseadas em dados, o Pro se paga rapidamente com melhores análises e decisões de investimento. ## E Se o Startup For Suficiente? O Startup (R$ 119,99/mês) é excelente se você: * Precisa de até 1 ano de histórico * Tem volume moderado de requisições * Não necessita de dados fundamentalistas desde 2009 Você pode começar no Startup e fazer upgrade para Pro quando precisar. [Começar com o Pro →](/pricing) # Posso usar a brapi em um app comercial ou na minha empresa? URL: /faq/posso-usar-a-brapi-para-construir-um-app-comercial-ou-para-minha-empresa.mdx Sim. A brapi pode ser integrada a produtos e sistemas internos, respeitando os termos de uso, os limites do plano e a recência dos dados. *** author: "Alisson Leal" title: "Posso usar a brapi em um app comercial ou na minha empresa?" description: "Sim. A brapi pode ser integrada a produtos e sistemas internos, respeitando os termos de uso, os limites do plano e a recência dos dados." categories: * commercial\_use * plans\_advanced priority: true *** **Sim. A API pode ser usada em aplicações comerciais e sistemas internos**, desde que o projeto respeite os [termos de uso](/legal/terms), os limites do plano e as restrições aplicáveis às fontes de dados. ## Antes de colocar em produção Verifique quatro pontos: 1. **Volume:** quantas chamadas e quantos tickers o produto usa por mês. 2. **Recência:** os planos públicos têm delay; nenhum deles é tick-by-tick. 3. **Cobertura:** confirme os campos e o histórico do endpoint necessário. 4. **Exibição:** mostre horário, moeda e contexto do dado ao usuário. ## Qual plano escolher? | Cenário | Ponto de partida | | ------------------------------------------ | ---------------------------- | | Protótipo sem receita | Gratuito, dentro dos limites | | MVP ou sistema interno | Startup | | Produto com mais volume, histórico ou FIIs | Pro | | Necessidade acima de 500.000 chamadas/mês | Fale com a equipe | O plano deve ser escolhido pelos requisitos do produto, não apenas pelo número de usuários. Um dashboard com polling frequente pode consumir mais que um app maior com cache bem configurado. ## O que a brapi não substitui A API entrega dados para consulta e análise. Ela não executa ordens e os planos públicos não devem ser descritos como feed em tempo real. Produtos regulados, automação de negociação ou redistribuição de dados podem exigir validação jurídica e licenças adicionais do seu lado. * [Comparar planos](/pricing) * [Ler a documentação](/docs) * [Falar sobre um caso específico](/contact) # Posso usar minha chave de API em mais de um projeto? URL: /faq/posso-usar-minha-chave-de-api-de-um-plano-pago-em-mais-de-um-projeto-ou-aplicacao.mdx Entenda as regras de uso da chave de API da brapi em múltiplos projetos e aplicações. Uma chave, vários projetos, respeitando o limite do plano. *** author: 'Alisson Leal' title: 'Posso usar minha chave de API em mais de um projeto?' description: 'Entenda as regras de uso da chave de API da brapi em múltiplos projetos e aplicações. Uma chave, vários projetos, respeitando o limite do plano.' categories: * dev\_integration * plans * plan\_management *** **Sim!** Sua chave de API é vinculada à sua conta e pode ser usada em quantos projetos você precisar. ## Como Funciona ### Uma Chave, Múltiplos Projetos * A chave é associada à sua **conta**, não ao projeto * Use a mesma chave em diferentes aplicações * O limite de requisições é **compartilhado** entre todos os projetos ### Exemplo Prático Se você tem o plano Pro (500.000 req/mês) e usa em: | Projeto | Requisições/mês | | ----------------- | --------------- | | App mobile | 200.000 | | Dashboard web | 150.000 | | Script de análise | 50.000 | | **Total** | **400.000** ✅ | Tudo dentro do limite, tudo funcionando normalmente. ## Boas Práticas ### Monitoramento de Uso Acompanhe o consumo de cada projeto: * Acesse sua [Dashboard](/dashboard) para ver uso total * Implemente logs internos para identificar consumo por projeto * Configure alertas quando atingir percentuais do limite ### Quando Considerar Múltiplas Chaves Para organizações maiores, pode fazer sentido ter contas separadas: * **Ambientes diferentes:** Produção vs desenvolvimento * **Times distintos:** Cada time com sua conta * **Clientes separados:** Se você revende acesso ## Segurança com Múltiplos Projetos ### Recomendações | Ambiente | Recomendação | | --------------- | --------------------------------------- | | Desenvolvimento | Use variáveis de ambiente locais | | Produção | Secrets manager ou env vars do servidor | | CI/CD | Variáveis de ambiente do pipeline | ### Evite * Commitar a chave no Git * Usar a mesma chave em projetos de terceiros * Compartilhar a chave com pessoas fora da organização ## Limites e Restrições ### O Que Pode * ✅ Usar em múltiplos projetos próprios * ✅ Usar em backend e scripts * ✅ Usar em diferentes linguagens * ✅ Usar em produção e desenvolvimento ### O Que Não Pode * ❌ Revender acesso sem acordo comercial * ❌ Compartilhar publicamente a chave * ❌ Usar para fins que violem os termos ## Precisa de Mais Capacidade? Se seus projetos juntos excedem o limite do plano: 1. **Upgrade de plano:** Pro oferece 500.000 req/mês 2. **Plano Enterprise:** Para volumes ainda maiores 3. **Múltiplas contas:** Para separação organizacional [Ver planos →](/pricing) # Quais são os limites da API da brapi? URL: /faq/quais-as-limitacoes.mdx Compare os limites mensais, tickers por requisição, histórico e delay dos planos Gratuito, Startup e Pro da API da brapi. *** author: "Alisson Leal" title: "Quais são os limites da API da brapi?" description: "Compare os limites mensais, tickers por requisição, histórico e delay dos planos Gratuito, Startup e Pro da API da brapi." categories: * plans priority: true *** **A brapi aplica limites mensais e limites de tickers por requisição.** Eles variam conforme o plano e ajudam a dimensionar o volume do seu projeto. | Plano | Requisições por mês | Tickers por chamada | Histórico | Delay de ações | | -------- | ------------------: | ------------------: | ----------- | -------------: | | Gratuito | 15.000 | 1 | Até 3 meses | \~30 min | | Startup | 150.000 | 10 | Até 1 ano | \~15 min | | Pro | 500.000 | 20 | Completo | \~5 min | Os endpoints também podem ter regras próprias, como máximo de símbolos, paginação ou acesso condicionado a uma funcionalidade do plano. Confira a documentação do endpoint antes de implementar uma chamada em produção. ## Como estimar o consumo mensal Uma tela que consulta 10 vezes por hora, durante 12 horas por dia e 30 dias, consome aproximadamente **3.600 requisições por mês**: ```text 10 chamadas/hora × 12 horas/dia × 30 dias = 3.600 chamadas ``` Consultar vários tickers na mesma requisição, quando o plano permite, costuma ser mais eficiente do que fazer uma chamada por ativo. ## Como acompanhar o uso O [dashboard](/dashboard) mostra o consumo e o limite do plano. Trate respostas de limite na aplicação, use cache quando fizer sentido e evite repetir chamadas se o dado ainda está dentro do delay contratado. Veja os recursos e preços atuais na [comparação de planos](/pricing). # Quais formas de pagamento são aceitas para os planos? URL: /faq/quais-formas-de-pagamento-sao-aceitas-para-os-planos.mdx Conheça as formas de pagamento aceitas pela brapi para assinaturas mensais e anuais. Pagamentos seguros via Stripe com as principais bandeiras de cartão. *** author: 'Alisson Leal' title: 'Quais formas de pagamento são aceitas para os planos?' description: 'Conheça as formas de pagamento aceitas pela brapi para assinaturas mensais e anuais. Pagamentos seguros via Stripe com as principais bandeiras de cartão.' categories: * plans * plan\_management *** A brapi utiliza o **Stripe** como processador de pagamentos, garantindo segurança e praticidade nas transações. ## Cartões de Crédito Aceitamos as principais bandeiras: * **Visa** * **Mastercard** * **American Express** * **Elo** * **Hipercard** ## Tipos de Cobrança ### Assinatura Mensal * Cobrança automática todo mês * Renovação automática até cancelamento * Flexibilidade para cancelar a qualquer momento ### Assinatura Anual * **Desconto de 2 meses** comparado ao plano mensal * Cobrança única anual * Melhor custo-benefício para uso contínuo ## Segurança dos Pagamentos Seus dados estão protegidos: * **Stripe:** Certificação PCI-DSS nível 1 (mais alto) * **Criptografia:** Todas as transações são criptografadas * **Dados não armazenados:** A brapi não armazena dados do seu cartão ## Outras Formas de Pagamento Para situações específicas, podemos avaliar alternativas: * **Boleto bancário:** Disponível para planos anuais ou Enterprise * **Transferência bancária:** Para contratos corporativos * **PIX:** Em avaliação para implementação futura Entre em [contato conosco](/contact) para discutir opções personalizadas. ## Notas Fiscais Emitimos nota fiscal para todos os pagamentos. A nota é enviada automaticamente para o email cadastrado após a confirmação do pagamento. ## Dúvidas sobre Cobrança * **Cobrança não reconhecida?** [Entre em contato](/contact) imediatamente * **Precisa de reembolso?** Consulte nossa [política de reembolso](/faq/voces-oferecem-politica-de-reembolso) * **Erro no pagamento?** Verifique o limite do cartão ou tente outra bandeira [Ver planos e preços →](/pricing) # Quais são os timeframes disponíveis na API? URL: /faq/quais-sao-os-timeframes-disponiveis.mdx Conheça todos os intervalos de tempo (timeframes) disponíveis na API da brapi para dados históricos de ações, desde minutos até meses. *** author: 'Alisson Leal' title: 'Quais são os timeframes disponíveis na API?' description: 'Conheça todos os intervalos de tempo (timeframes) disponíveis na API da brapi para dados históricos de ações, desde minutos até meses.' categories: * data\_updates * plans *** A brapi oferece diversos intervalos de tempo (timeframes) para dados históricos, permitindo análises desde day trading até investimentos de longo prazo. ## Timeframes Intraday (Curto Prazo) Para histórico de **até 7 dias**, disponibilizamos: | Intervalo | Código | Uso Típico | | ---------- | ------ | --------------------------- | | 1 minuto | `1m` | Scalping, análise tick | | 2 minutos | `2m` | Trading de alta frequência | | 5 minutos | `5m` | Day trading | | 15 minutos | `15m` | Swing trading intraday | | 30 minutos | `30m` | Análise de tendência diária | | 60 minutos | `60m` | Visão geral do dia | | 90 minutos | `90m` | Análise de sessões | | 1 hora | `1h` | Equivalente a 60m | ## Timeframes de Médio Prazo Para histórico de **até 10 anos**: | Intervalo | Código | Uso Típico | | --------- | ------ | ----------------------------- | | 1 dia | `1d` | Análise diária, swing trading | | 5 dias | `5d` | Visão semanal | | 1 semana | `1wk` | Análise semanal | ## Timeframes de Longo Prazo Para **histórico completo** (mais de 10 anos): | Intervalo | Código | Uso Típico | | --------- | ------ | -------------------------- | | 1 mês | `1mo` | Análise mensal, tendências | | 3 meses | `3mo` | Análise trimestral | ## Exemplo de Uso ```bash # Dados diários dos últimos 6 meses GET /api/quote/PETR4?interval=1d&range=6mo # Dados de 5 minutos do último dia GET /api/quote/PETR4?interval=5m&range=1d # Dados mensais históricos completos GET /api/quote/PETR4?interval=1mo&range=max ``` ## Disponibilidade por Plano | Plano | Histórico Máximo | | -------- | ------------------- | | Gratuito | 3 meses | | Startup | 1 ano | | Pro | Completo (10+ anos) | ## Dica de Otimização Para análises de longo prazo, use intervalos maiores (`1d`, `1wk`, `1mo`) para reduzir o volume de dados e acelerar suas requisições. [Ver documentação completa →](/docs) # Qual é o delay dos dados em cada plano da brapi? URL: /faq/qual-a-diferenca-real-no-atraso-delay-dos-dados-entre-os-planos.mdx As cotações têm delay aproximado de 30 minutos no Gratuito, 15 minutos no Startup e 5 minutos no Pro. Veja qual faixa atende ao seu produto. *** author: "Alisson Leal" title: "Qual é o delay dos dados em cada plano da brapi?" description: "As cotações têm delay aproximado de 30 minutos no Gratuito, 15 minutos no Startup e 5 minutos no Pro. Veja qual faixa atende ao seu produto." categories: * plans * data\_updates priority: true *** O delay aproximado das cotações é de **30 minutos no Gratuito, 15 minutos no Startup e 5 minutos no Pro**. Esses valores indicam a recência esperada do dado, não uma frequência fixa de atualização do seu aplicativo. | Plano | Delay de ações | Uso compatível | | -------- | -------------: | -------------------------------------------------- | | Gratuito | \~30 minutos | Estudos, protótipos e carteiras sem urgência | | Startup | \~15 minutos | Produtos que aceitam cotações com atraso | | Pro | \~5 minutos | Monitoramento mais frequente, ainda sem tempo real | Criptomoedas e moedas podem ter políticas de atualização diferentes. Consulte a página do endpoint usado antes de definir a frequência das suas chamadas. ## O que o delay muda na prática? Se uma cotação tem delay de 15 minutos, o preço retornado pode refletir o mercado de aproximadamente 15 minutos atrás. Atualizar sua tela a cada segundo não elimina esse atraso e apenas consome mais requisições. Para escolher um plano, pergunte: 1. Qual é a defasagem máxima aceitável na interface? 2. Quantos usuários e ativos serão atualizados? 3. O produto deixa claro o horário da cotação? 4. Uma decisão automatizada depende desse preço? ## A brapi oferece dados em tempo real? Os planos públicos da brapi **não oferecem feed tick-by-tick nem execução de ordens**. O Pro reduz o delay para cerca de 5 minutos, mas isso não equivale a tempo real. Sistemas de trading, roteamento de ordens ou decisões sensíveis a segundos exigem uma fonte licenciada e infraestrutura apropriada. ## Como implementar corretamente * Mostre o horário do dado ao usuário. * Ajuste o polling ao delay do plano e ao limite mensal. * Trate mercado fechado e ausência temporária de atualização. * Evite descrever uma cotação atrasada como “tempo real”. Veja também [os limites de cada plano](/faq/quais-as-limitacoes) e a [página de preços](/pricing). # Com que frequência os dados da brapi são atualizados? URL: /faq/qual-a-frequencia.mdx Cotações de ações têm atualização aproximada de 30 minutos no Gratuito, 15 minutos no Startup e 5 minutos no Pro. *** author: "Alisson Leal" title: "Com que frequência os dados da brapi são atualizados?" description: "Cotações de ações têm atualização aproximada de 30 minutos no Gratuito, 15 minutos no Startup e 5 minutos no Pro." categories: * data\_updates * plans *** Para cotações de ações, a recência esperada depende do plano: | Plano | Atualização aproximada | | -------- | ---------------------: | | Gratuito | 30 minutos | | Startup | 15 minutos | | Pro | 5 minutos | Criptomoedas e moedas podem seguir frequências diferentes: cerca de 60 minutos no Gratuito, 30 minutos no Startup e 5 minutos no Pro. ## Atualização do dado não é frequência de chamada Fazer polling a cada segundo não torna a cotação mais recente. Ajuste a frequência das requisições ao delay do plano, ao limite mensal e à necessidade da interface. Sempre mostre ao usuário o horário retornado pela API. Dados fundamentalistas e informes são atualizados conforme novas publicações das fontes oficiais são processadas, portanto não seguem o mesmo ciclo das cotações. Para entender a diferença entre dado atrasado e tempo real, consulte [qual é o delay de cada plano](/faq/qual-a-diferenca-real-no-atraso-delay-dos-dados-entre-os-planos). # Qual a vantagem real dos dados fundamentalistas nos planos pagos? URL: /faq/qual-a-vantagem-real-dos-dados-fundamentalistas-nos-planos-pagos.mdx Descubra os dados fundamentalistas disponíveis nos planos pagos da brapi: balanços, DREs, fluxos de caixa e indicadores financeiros completos. *** author: 'Alisson Leal' title: 'Qual a vantagem real dos dados fundamentalistas nos planos pagos?' description: 'Descubra os dados fundamentalistas disponíveis nos planos pagos da brapi: balanços, DREs, fluxos de caixa e indicadores financeiros completos.' categories: * fundamentals * plans\_advanced priority: true *** Os planos pagos da brapi oferecem acesso a **demonstrativos financeiros completos**, essenciais para análises profundas de empresas brasileiras. ## O Que Está Incluído ### Demonstrativos Financeiros | Demonstrativo | Descrição | Frequência | | ---------------------------- | -------------------------------- | ---------------- | | **Balanço Patrimonial (BP)** | Ativos, passivos e patrimônio | Trimestral/Anual | | **DRE** | Receitas, custos e lucros | Trimestral/Anual | | **Fluxo de Caixa (DFC)** | Entradas e saídas de caixa | Trimestral/Anual | | **DVA** | Demonstração de Valor Adicionado | Trimestral/Anual | ### Indicadores Financeiros Calculados automaticamente a partir dos demonstrativos: * **Valuation:** P/L, P/VP, EV/EBITDA * **Rentabilidade:** ROE, ROA, ROIC * **Margens:** Bruta, EBITDA, Líquida * **Endividamento:** Dívida/EBITDA, Dívida/PL * **Liquidez:** Corrente, Seca, Imediata ## Comparação entre Planos | Dados | Gratuito | Startup | Pro | | ------------------- | -------- | -------- | -------- | | Cotações básicas | ✅ | ✅ | ✅ | | Indicadores simples | Alguns | Completo | Completo | | Balanço Patrimonial | ❌ | ✅ | ✅ | | DRE | ❌ | ✅ | ✅ | | Fluxo de Caixa | ❌ | ✅ | ✅ | | Histórico de dados | 3 meses | 1 ano | 10+ anos | ## Casos de Uso ### Para Value Investors * Identificar empresas subvalorizadas * Analisar margem de segurança * Comparar múltiplos entre empresas ### Para Analistas * Projetar resultados futuros * Criar modelos de valuation (DCF, etc.) * Monitorar evolução trimestral ### Para Desenvolvedores * Construir screeners de ações * Criar dashboards de análise * Automatizar relatórios financeiros ## Exemplo de Dados Retornados ```json { "balanceSheet": { "totalAssets": 500000000000, "totalLiabilities": 300000000000, "shareholdersEquity": 200000000000 }, "incomeStatement": { "totalRevenue": 150000000000, "netIncome": 25000000000, "ebitda": 40000000000 }, "keyStatistics": { "priceToEarnings": 8.5, "priceToBook": 1.2, "returnOnEquity": 0.18 } } ``` ## Por Que É Diferencial * **Dados padronizados:** Formato consistente para todas as empresas * **Histórico longo:** Análise de tendências ao longo dos anos * **Atualização automática:** Novos dados assim que divulgados à CVM * **API única:** Tudo em uma única chamada, sem múltiplas integrações [Acessar dados fundamentalistas →](/pricing) # Saiba mais sobre o projeto e utilize a API em sua aplicação URL: /faq/quero-utilizar.mdx Descubra mais sobre o projeto brapi e como você pode incorporar nossa API em sua aplicação. Oferecemos fácil integração para acesso a dados financeiros atualizados, permitindo o desenvolvimento de soluções relacionadas ao mercado financeiro. Saiba como começar registrando-se em nosso site e obtenha suas credenciais de acesso na Dashboard. *** author: 'Alisson Leal' title: 'Saiba mais sobre o projeto e utilize a API em sua aplicação' description: 'Descubra mais sobre o projeto brapi e como você pode incorporar nossa API em sua aplicação. Oferecemos fácil integração para acesso a dados financeiros atualizados, permitindo o desenvolvimento de soluções relacionadas ao mercado financeiro. Saiba como começar registrando-se em nosso site e obtenha suas credenciais de acesso na Dashboard.' ------------------------------------ ## Sobre o Projeto O projeto brapi oferece uma API de fácil integração que fornece acesso a dados financeiros atualizados. Isso possibilita o desenvolvimento de soluções relacionadas ao mercado financeiro, como aplicativos de acompanhamento de portfólio, sistemas de análise de dados e muito mais. ## Como Começar 1. **Registro:** Para começar, registre-se em nosso site. 2. **Credenciais de Acesso:** Após o registro, você pode obter suas credenciais de acesso na [Dashboard](https://brapi.dev/dashboard). Com a API da brapi, você pode transformar suas ideias em realidade e oferecer recursos financeiros aos seus clientes ou usuários. # Se eu mudar de plano no meio do ciclo, como funciona a cobrança? URL: /faq/se-eu-mudar-de-plano-no-meio-do-ciclo-como-funciona-a-cobranca.mdx Entenda como funciona a cobrança proporcional ao fazer upgrade ou downgrade de plano na brapi. Processo transparente e sem surpresas. *** author: 'Alisson Leal' title: 'Se eu mudar de plano no meio do ciclo, como funciona a cobrança?' description: 'Entenda como funciona a cobrança proporcional ao fazer upgrade ou downgrade de plano na brapi. Processo transparente e sem surpresas.' categories: * plan\_management *** A brapi oferece flexibilidade total para mudanças de plano, com cobrança justa e transparente. ## Upgrade (Subir de Plano) Ao fazer upgrade (ex: Startup → Pro): ### Como Funciona 1. **Acesso imediato:** Novos benefícios disponíveis instantaneamente 2. **Cobrança imediata e proporcional:** O Stripe cobra na hora apenas a diferença pelo tempo restante do ciclo atual 3. **Mesmo dia de renovação:** A data de cobrança não muda; o próximo ciclo continua no mesmo dia em que sua assinatura já renovava ### Exemplo Prático * Você assinou Startup (R$ 119,99) no dia 1 * No dia 15, decide fazer upgrade para Pro (R$ 139,99) * **Cobrança imediata:** Aproximadamente R$ 10,00 pela diferença proporcional dos 15 dias restantes * **Próxima cobrança:** R$ 139,99 no dia 1 do próximo mês, mantendo a mesma data de renovação ## Downgrade (Descer de Plano) Ao fazer downgrade (ex: Pro → Startup): ### Como Funciona 1. **Benefícios mantidos:** Você continua com o plano atual até o fim do ciclo 2. **Mudança agendada:** O novo plano entra em vigor no próximo ciclo 3. **Sem cobrança adicional:** Nenhum valor extra é debitado ### Exemplo Prático * Você tem o Pro (R$ 139,99) com renovação no dia 1 * No dia 15, solicita downgrade para Startup * **Até dia 30:** Mantém todos os benefícios do Pro * **A partir do dia 1:** Plano Startup ativo, cobrança de R$ 119,99 ## Mudança de Mensal para Anual Se você quiser migrar de cobrança mensal para anual: 1. O Stripe calcula o crédito proporcional do período mensal não utilizado 2. Você paga imediatamente a diferença para iniciar o plano anual 3. A nova renovação passa a seguir o ciclo anual a partir da data da mudança ## Como Fazer a Mudança 1. Acesse sua [Dashboard](/dashboard) 2. Clique em **Gerenciar Assinatura** 3. Selecione **Mudar Plano** 4. Escolha o novo plano 5. Confirme a alteração ## Perguntas Frequentes ### Perco dados ao fazer downgrade? Não. Seus dados de uso histórico são mantidos. Porém, você perde acesso a recursos exclusivos do plano anterior (ex: histórico completo, dividendos). ### Posso voltar ao plano anterior? Sim, a qualquer momento. Basta fazer um novo upgrade. ### E se eu cancelar no meio do ciclo? Você mantém acesso até o fim do período pago, sem cobrança adicional. [Gerenciar meu plano →](/dashboard) # Sou investidor individual. O plano Pro serve para mim? URL: /faq/sou-investidor-individual-o-plano-pro-serve-para-mim.mdx Descubra como o plano Pro da brapi pode ajudar investidores individuais com análises fundamentalistas, acompanhamento de dividendos e estratégias de investimento. *** author: 'Alisson Leal' title: 'Sou investidor individual. O plano Pro serve para mim?' description: 'Descubra como o plano Pro da brapi pode ajudar investidores individuais com análises fundamentalistas, acompanhamento de dividendos e estratégias de investimento.' categories: * user\_profile * plans\_advanced *** **Sim, absolutamente!** O plano Pro é altamente recomendado para investidores individuais que levam seus investimentos a sério. ## Por Que Investidores Individuais Escolhem o Pro ### Análise Fundamentalista Completa Acesse dados detalhados de empresas brasileiras: * **Balanços patrimoniais** completos * **DRE** (Demonstração de Resultados) * **Indicadores financeiros:** P/L, P/VP, ROE, ROA, margens * **Histórico de resultados** para análise de tendências ### Acompanhamento de Dividendos Essencial para estratégias de renda passiva: * Histórico completo de proventos * Dividend Yield calculado * Datas de pagamento e ex-dividendos * Projeções baseadas em histórico ### Dados em Tempo Quase Real Com atraso de apenas \~5 minutos, você pode: * Acompanhar oportunidades de compra * Monitorar stop loss * Reagir a movimentos do mercado ## Casos de Uso para Investidores Individuais 1. **Carteira de dividendos:** Análise de dividend yield e consistência 2. **Value investing:** Identificar ações subvalorizadas com indicadores 3. **Planilhas pessoais:** Automatizar atualização de preços e dados 4. **Backtesting:** Testar estratégias com histórico completo 5. **Rebalanceamento:** Acompanhar alocação em tempo real ## Comparação: Gratuito vs Pro para Investidores | Necessidade | Gratuito | Pro | | -------------------------- | ----------------- | ---------------- | | Cotações diárias | ✅ (30 min atraso) | ✅ (5 min atraso) | | Análise fundamentalista | Básico | Completo | | Dividendos históricos | ❌ | ✅ | | Múltiplas ações por vez | 1 | 20 | | Histórico para backtesting | 3 meses | Completo | ## Vale o Investimento? Por **R$ 139,99/mês**, você tem acesso a dados que plataformas profissionais cobram muito mais. Se você investe mais de R$ 10.000 e toma decisões baseadas em dados, o Pro se paga facilmente com melhores decisões de investimento. [Começar com o Pro →](/pricing) # O que acontece quando atinjo o limite de requisições? URL: /faq/tem-algum-limite.mdx Ao atingir a cota mensal do plano, novas chamadas podem ser bloqueadas. Aprenda a acompanhar o uso, reduzir consumo e escolher um limite maior. *** author: "Alisson Leal" title: "O que acontece quando atinjo o limite de requisições?" description: "Ao atingir a cota mensal do plano, novas chamadas podem ser bloqueadas. Aprenda a acompanhar o uso, reduzir consumo e escolher um limite maior." categories: * plans *** Quando a cota mensal do plano é atingida, **novas requisições podem ser recusadas até a renovação do ciclo ou a mudança de plano**. Sua aplicação deve tratar esse caso em vez de repetir a chamada indefinidamente. ## Como evitar interrupções * Acompanhe o consumo no [dashboard](/dashboard). * Use cache de acordo com a recência necessária. * Agrupe tickers na mesma chamada quando seu plano permitir. * Evite polling mais frequente que o delay dos dados. * Configure alertas internos antes de chegar ao limite. Os limites atuais são 15.000 requisições mensais no Gratuito, 150.000 no Startup e 500.000 no Pro. Veja também a [tabela completa de limites](/faq/quais-as-limitacoes). Se o uso cresce de forma previsível, compare os planos em [/pricing](/pricing). Para volumes fora dessas faixas, [entre em contato](/contact). # Vocês oferecem política de reembolso? URL: /faq/voces-oferecem-politica-de-reembolso.mdx Conheça a política de reembolso da brapi. Reembolso integral em até 7 dias para novos assinantes, sem perguntas. Transparência e confiança. *** author: 'Alisson Leal' title: 'Vocês oferecem política de reembolso?' description: 'Conheça a política de reembolso da brapi. Reembolso integral em até 7 dias para novos assinantes, sem perguntas. Transparência e confiança.' categories: * plan\_management * plans *** **Sim!** A brapi oferece uma política de reembolso justa e transparente para garantir sua satisfação. ## Garantia de 7 Dias Para **novos assinantes**, oferecemos: * **Reembolso integral** em até 7 dias após a primeira assinatura * **Sem necessidade de justificativa** * **Processo simples** via contato direto ### Como Funciona 1. Assine qualquer plano pago (Startup ou Pro) 2. Teste a API por até 7 dias 3. Se não estiver satisfeito, solicite o reembolso 4. Receba 100% do valor de volta ## Como Solicitar Reembolso 1. [Entre em contato](/contact) em até 7 dias após a assinatura 2. Informe seu email cadastrado 3. Confirme a solicitação de reembolso 4. Receba o estorno em até 5 dias úteis ## O Que Acontece Após o Reembolso * Seu plano é alterado para o **gratuito** * Você mantém acesso à API com as limitações do plano gratuito * Seu histórico de uso é preservado * Pode assinar novamente quando quiser ## Reembolso Proporcional (Após 7 Dias) Após o período de garantia, avaliamos casos específicos: * **Problemas técnicos:** Se a API ficou indisponível por período significativo * **Cobrança indevida:** Em caso de erro no processamento * **Planos anuais:** Reembolso proporcional ao período não utilizado ## Casos Não Cobertos Não oferecemos reembolso automático para: * Solicitações após 7 dias da assinatura (avaliação caso a caso) * Uso indevido ou violação dos termos * Mudança de necessidades após uso extensivo ## Nosso Compromisso Queremos que você tenha confiança ao assinar. A garantia de 7 dias existe para que você possa: * Testar a integração no seu projeto * Validar a qualidade dos dados * Confirmar que atende suas necessidades Se algo não funcionar como esperado, estamos aqui para resolver. ## Dúvidas sobre Reembolso [Entre em contato](/contact) e responderemos em até 24 horas úteis. [Ver planos →](/pricing) # Vocês oferecem suporte técnico? URL: /faq/voces-oferecem-suporte-tecnico.mdx Conheça as opções de suporte técnico disponíveis na brapi. Acesse documentação completa, exemplos de código e suporte prioritário para assinantes dos planos pagos. *** author: 'Alisson Leal' title: 'Vocês oferecem suporte técnico?' description: 'Conheça as opções de suporte técnico disponíveis na brapi. Acesse documentação completa, exemplos de código e suporte prioritário para assinantes dos planos pagos.' categories: * tech\_support *** Sim! A brapi oferece diferentes níveis de suporte técnico de acordo com o plano escolhido. ## Suporte para Todos os Usuários Independente do plano, todos os usuários têm acesso a: * **Documentação completa:** Guias detalhados de integração e referência da API em [brapi.dev/docs](/docs) * **Exemplos de código:** Implementações prontas em Python, JavaScript, PHP e outras linguagens * **FAQ abrangente:** Respostas para as dúvidas mais comuns * **Status da API:** Monitoramento em tempo real da disponibilidade dos serviços ## Suporte Prioritário (Planos Pagos) Assinantes dos planos **Startup** e **Pro** contam com benefícios adicionais: * **Tempo de resposta reduzido:** Suas dúvidas são priorizadas na fila de atendimento * **Suporte por email:** Canal direto para questões técnicas específicas * **Auxílio na integração:** Orientação para implementar a API no seu projeto ## Suporte Premium (Plano Pro) O plano **Pro** oferece o nível mais alto de suporte: * **Canais de atendimento diretos:** Acesso a meios de comunicação mais ágeis * **Consultoria técnica:** Ajuda para otimizar suas requisições e uso da API * **Prioridade máxima:** Suas solicitações são tratadas com urgência ## Como Entrar em Contato Para suporte técnico, utilize nosso [formulário de contato](/contact) ou acesse a [documentação](/docs) para resolver dúvidas comuns rapidamente. # Política de Cookies da brapi.dev URL: /legal/cookie-policy.mdx Entenda como a brapi.dev utiliza cookies para garantir o funcionamento da plataforma, melhorar sua experiência e realizar análises. Gerencie suas preferências de forma simples e transparente. *** title: 'Política de Cookies da brapi.dev' description: 'Entenda como a brapi.dev utiliza cookies para garantir o funcionamento da plataforma, melhorar sua experiência e realizar análises. Gerencie suas preferências de forma simples e transparente.' ---------------------------------------------- # Política de Cookies da brapi.dev **Última atualização: 07 de junho 2025** Esta política explica o que são cookies, como os utilizamos na plataforma **brapi.dev** e quais são suas opções para gerenciá-los. ## 1. O que são Cookies? Cookies são pequenos arquivos de texto que um site armazena no seu computador ou dispositivo móvel quando você o visita. Eles são amplamente utilizados para fazer os sites funcionarem de forma mais eficiente, bem como para fornecer informações aos proprietários do site. Eles nos permitem, por exemplo, lembrar de suas preferências, manter sua sessão ativa e entender como você interage com nossa plataforma. ## 2. Como Utilizamos os Cookies? Utilizamos cookies por vários motivos importantes. Eles podem ser classificados nas seguintes categorias: ### a) Cookies Essenciais (Estritamente Necessários) Estes cookies são indispensáveis para o funcionamento da nossa plataforma. Sem eles, serviços como o login na sua conta ou o processamento de pagamentos não funcionariam. * **Cookies de Autenticação:** Usamos estes cookies para manter sua sessão ativa após o login. Isso evita que você precise digitar sua senha em cada nova página que visita no seu dashboard. * **Cookies de Segurança:** Ajudam a proteger sua conta e nossa plataforma contra atividades maliciosas e acessos não autorizados. Por serem essenciais, **não é possível desativar estes cookies** sem comprometer funcionalidades críticas do site. ### b) Cookies de Desempenho e Análise (Analytics) Estes cookies nos ajudam a entender como os visitantes interagem com a **brapi.dev**. Eles coletam informações de forma anônima e agregada. * **Google Analytics:** Utilizamos esta ferramenta para coletar dados como quais páginas são mais visitadas, quanto tempo os usuários passam no site e como chegaram até nós. Essas informações nos ajudam a melhorar continuamente a experiência do usuário e a produzir conteúdo relevante. As informações coletadas por estes cookies não identificam você pessoalmente. ### c) Cookies de Funcionalidade Estes cookies são usados para lembrar de escolhas que você fez no passado, como suas preferências de tema (claro/escuro) ou outras configurações de personalização. O objetivo é proporcionar uma experiência mais pessoal e conveniente. ## 3. Cookies de Terceiros Além dos nossos próprios cookies, também utilizamos cookies de parceiros confiáveis, como o **Google Analytics**, para as finalidades de análise descritas acima. Não temos controle sobre como esses terceiros utilizam seus cookies, mas selecionamos apenas parceiros que demonstram compromisso com a privacidade e segurança. ## 4. Como Gerenciar e Desativar Cookies? Você tem total controle sobre os cookies não essenciais. A maioria dos navegadores permite que você gerencie cookies através de suas configurações. Você pode: * Ver quais cookies estão ativos e excluí-los individualmente. * Bloquear cookies de terceiros. * Bloquear cookies de sites específicos. * Bloquear todos os cookies. * Excluir todos os cookies ao fechar o navegador. **Atenção:** Se você optar por bloquear todos os cookies (incluindo os essenciais), você poderá não conseguir acessar todas as partes do nosso site, e funcionalidades como o login deixarão de funcionar. Para mais informações sobre como gerenciar cookies, consulte a seção de ajuda do seu navegador: * [Google Chrome](https://support.google.com/chrome/answer/95647) * [Mozilla Firefox](https://support.mozilla.org/pt-BR/kb/ative-e-desative-os-cookies-que-os-sites-usam) * [Microsoft Edge](https://support.microsoft.com/pt-br/windows/excluir-e-gerenciar-cookies-168dab11-0753-043d-7c16-ede5947fc64d) * [Safari](https://support.apple.com/pt-br/guide/safari/sfri11471/mac) ## 5. Mais Informações Esperamos que esta política tenha esclarecido como utilizamos cookies. Nosso objetivo é usar essa tecnologia para melhorar sua experiência, mantendo sempre o respeito à sua privacidade. Se você tiver qualquer dúvida, entre em contato conosco através do e-mail **[contato@brapi.dev](mailto:contato@brapi.dev)**. # Documentos Legais URL: /legal.mdx Documentos legais da brapi.dev, incluindo termos de uso, política de privacidade e política de cookies. Mantenha-se informado sobre nossos compromissos legais e de privacidade. *** searchable: false title: 'Documentos Legais' description: 'Documentos legais da brapi.dev, incluindo termos de uso, política de privacidade e política de cookies. Mantenha-se informado sobre nossos compromissos legais e de privacidade.' -------------------------------------- # Documentos Legais Bem-vindo à seção de documentos legais da brapi.dev. Aqui você encontrará todas as informações importantes sobre nossos termos, políticas e compromissos legais. ## Documentos Disponíveis ### [Termos de Uso](/legal/terms-of-use) Condições gerais para uso da plataforma, API e dados financeiros oferecidos pela brapi.dev. ### [Política de Privacidade](/legal/privacy-policy) Como coletamos, utilizamos, armazenamos e protegemos suas informações pessoais. ### [Política de Cookies](/legal/cookie-policy) Informações sobre como utilizamos cookies e tecnologias similares em nosso site. ## Compromisso com a Transparência Na brapi.dev, acreditamos na transparência e no respeito aos direitos dos nossos usuários. Nossos documentos legais são elaborados de forma clara e acessível, garantindo que você entenda exatamente como funciona nossa plataforma e quais são seus direitos e responsabilidades. ## Atualizações Todos os documentos legais são revisados periodicamente e atualizados conforme necessário. Recomendamos que você verifique esta seção regularmente para se manter informado sobre quaisquer alterações. ## Dúvidas? Se você tiver alguma dúvida sobre nossos documentos legais ou precisar de esclarecimentos, entre em contato conosco através do nosso [formulário de contato](/contact) ou envie um e-mail para [contato@brapi.dev](mailto:contato@brapi.dev). # Política de Privacidade da brapi.dev URL: /legal/privacy-policy.mdx Entenda como a brapi.dev coleta, utiliza, armazena e protege seus dados pessoais, em conformidade com a LGPD. Sua privacidade é nossa prioridade. *** title: 'Política de Privacidade da brapi.dev' description: 'Entenda como a brapi.dev coleta, utiliza, armazena e protege seus dados pessoais, em conformidade com a LGPD. Sua privacidade é nossa prioridade.' -------------------------------------------------------------------------- # Política de Privacidade da brapi.dev **Última atualização: 07 de junho 2025** A sua privacidade é uma prioridade para a **brapi.dev**. Esta Política de Privacidade explica como coletamos, usamos, armazenamos e protegemos suas informações pessoais quando você utiliza nossos Serviços, que incluem o site (brapi.dev), a API e a plataforma como um todo. Nosso compromisso é ser transparente e proteger seus dados, em conformidade com a Lei Geral de Proteção de Dados (LGPD - Lei nº 13.709/2018) e outras regulamentações aplicáveis. ## 1. Quais Dados Coletamos? Coletamos apenas as informações estritamente necessárias para fornecer e melhorar nossos Serviços. Os dados coletados podem ser divididos em duas categorias: **a) Informações que Você nos Fornece Diretamente:** * **Dados de Cadastro:** Ao criar uma conta, solicitamos seu nome e endereço de e-mail. * **Dados de Pagamento:** Ao assinar um plano pago, nosso provedor de pagamentos (ex: Stripe) coleta as informações necessárias para processar a transação, como dados do cartão de crédito. A **brapi.dev não armazena os dados completos do seu cartão de crédito**. **b) Informações Coletadas Automaticamente:** * **Dados de Uso da API:** Registramos informações sobre como você utiliza nossa API, como as chaves de API utilizadas, os endpoints acessados, o volume de requisições e eventuais erros. Esses dados são essenciais para monitorar a performance, garantir a segurança e fazer a cobrança correta dos planos. * **Dados de Navegação (Cookies):** Utilizamos cookies e tecnologias similares para melhorar sua experiência em nosso site, entender como ele é utilizado e personalizar o conteúdo. Você pode gerenciar suas preferências de cookies através das configurações do seu navegador. ## 2. Como Usamos Seus Dados? Utilizamos suas informações para as seguintes finalidades: * **Fornecer e Gerenciar os Serviços:** Criar sua conta, gerar sua chave de API, processar pagamentos e garantir o funcionamento da plataforma. * **Comunicação:** Enviar e-mails importantes sobre sua conta, como avisos de faturamento, atualizações dos Termos de Uso ou alterações significativas nos Serviços. * **Segurança e Monitoramento:** Proteger nossa plataforma contra fraudes, abusos e atividades maliciosas. * **Melhora Contínua:** Analisar dados de uso de forma agregada e anônima para entender como nossos Serviços são utilizados e como podemos melhorá-los. ## 3. Com Quem Compartilhamos Seus Dados? A **brapi.dev não vende, aluga ou compartilha suas informações de identificação pessoal com terceiros**, exceto nas seguintes situações: * **Provedores de Serviço:** Compartilhamos informações com empresas que nos auxiliam a operar, como provedores de pagamento (para processar suas assinaturas) e serviços de infraestrutura em nuvem (para hospedar nossa plataforma). Esses provedores só têm acesso aos dados necessários para realizar suas funções e são contratualmente obrigados a protegê-los. * **Obrigação Legal:** Podemos divulgar suas informações se formos obrigados por lei, intimação ou outro processo legal, ou para proteger nossos direitos e a segurança de nossos usuários. ## 4. Seus Direitos como Titular dos Dados (LGPD) De acordo com a LGPD, você tem o direito de: * **Confirmar** a existência de tratamento dos seus dados. * **Acessar** seus dados. * **Corrigir** dados incompletos, inexatos ou desatualizados. * **Solicitar a anonimização, bloqueio ou eliminação** de dados desnecessários ou tratados em desconformidade com a lei. * **Solicitar a portabilidade** dos seus dados a outro fornecedor de serviço. * **Revogar o consentimento**, quando aplicável. Para exercer seus direitos, entre em contato conosco através do e-mail **[contato@brapi.dev](mailto:contato@brapi.dev)**. ## 5. Segurança dos Dados Implementamos medidas de segurança técnicas e organizacionais para proteger seus dados contra perda, roubo e acesso, uso ou modificação não autorizados. Isso inclui o uso de criptografia (HTTPS), controle de acesso rigoroso e outras práticas padrão do setor. ## 6. Retenção de Dados Manteremos suas informações pessoais apenas pelo tempo necessário para cumprir as finalidades para as quais foram coletadas, incluindo obrigações legais, contábeis ou de relatórios. Após esse período, seus dados serão excluídos de forma segura ou anonimizados. ## 7. Links para Sites Externos Nosso site pode conter links para outros sites que não são operados por nós. Não temos controle sobre o conteúdo e as práticas desses sites e não podemos nos responsabilizar por suas respectivas políticas de privacidade. ## 8. Alterações a Esta Política Podemos atualizar nossa Política de Privacidade periodicamente. Notificaremos você sobre quaisquer alterações publicando a nova política nesta página e, se as alterações forem significativas, poderemos fornecer um aviso mais proeminente (como um e-mail). ## 9. Contato Se você tiver alguma dúvida sobre esta Política de Privacidade ou sobre como lidamos com seus dados, entre em contato conosco: **E-mail:** [contato@brapi.dev](mailto:contato@brapi.dev) # Termos de Uso da brapi.dev URL: /legal/terms-of-use.mdx Condições de uso da plataforma, API e dados financeiros oferecidos pela brapi.dev. Leia atentamente antes de utilizar nossos serviços. *** title: 'Termos de Uso da brapi.dev' description: 'Condições de uso da plataforma, API e dados financeiros oferecidos pela brapi.dev. Leia atentamente antes de utilizar nossos serviços.' --------------------------------------------------------------- # Termos de Uso da brapi.dev **Última atualização: 07 de junho 2025** Bem-vindo à **brapi.dev**! Estes Termos de Uso ("Termos") governam seu acesso e uso da nossa plataforma, incluindo o site (brapi.dev), a Interface de Programação de Aplicações ("API"), a documentação e todos os dados e informações fornecidos ("Serviços"). Ao criar uma conta, acessar ou utilizar nossos Serviços, você concorda em cumprir estes Termos e todas as leis e regulamentos aplicáveis. Se você não concordar com qualquer parte destes Termos, você não está autorizado a utilizar os Serviços. ## 1. Definições Principais * **"Plataforma"** ou **"brapi.dev"**: Refere-se ao site, à API e a toda a infraestrutura que compõe os nossos Serviços. * **"Usuário"**, **"você"**: Refere-se a qualquer indivíduo ou entidade que acessa ou utiliza a Plataforma. * **"Dados"**: Refere-se a todas as informações financeiras, cotações, históricos, fundamentos e outros materiais disponibilizados através da nossa API. ## 2. Uso da API e Licença A **brapi.dev** concede a você uma licença limitada, não exclusiva, intransferível e revogável para acessar e usar nossa API e os Dados, estritamente de acordo com estes Termos e com os limites do seu plano de assinatura (Gratuito, Startup ou Pro). Sob esta licença, você **não pode**: 1. **Revender, redistribuir ou sublicenciar** os Dados ou o acesso à API para terceiros. 2. Criar um serviço de proxy, "espelho" ou qualquer forma de wrapper em torno da nossa API com o intuito de oferecer um serviço concorrente ou de acesso público. 3. Tentar descompilar, desmontar ou fazer engenharia reversa de qualquer software ou componente da nossa infraestrutura. 4. Remover ou alterar quaisquer avisos de direitos autorais, marcas registradas ou outras notações de propriedade dos nossos Serviços. 5. Utilizar a API ou os Dados para qualquer finalidade ilegal ou que viole os direitos de terceiros. 6. Exceder os limites de requisições, profundidade de dados ou outras restrições estabelecidas pelo seu plano de assinatura. A violação de qualquer uma dessas restrições resultará na rescisão automática e imediata da sua licença e conta, sem prejuízo de outras medidas legais cabíveis. ## 3. Contas de Usuário e Segurança Para acessar a maioria dos nossos Serviços, você precisará criar uma conta e obter uma chave de API (token). Você concorda em: * Fornecer informações verdadeiras, precisas e completas durante o registro. * Manter a confidencialidade da sua senha e da sua chave de API. * Ser o único responsável por todas as atividades que ocorram em sua conta. Nunca compartilhe sua chave de API publicamente ou a exponha no código do lado do cliente (frontend). A **brapi.dev** não se responsabiliza por perdas ou danos decorrentes do seu descumprimento desta obrigação de segurança. ## 4. Isenção de Responsabilidade e Uso dos Dados 1. Os Serviços e os Dados são fornecidos **"como estão" ("as is")**. A **brapi.dev** não oferece garantias, expressas ou implícitas, sobre a precisão, completude, confiabilidade ou adequação dos Dados para um fim específico. Embora nos esforcemos para obter informações de fontes confiáveis, não garantimos que os Dados estarão livres de erros ou interrupções. 2. **IMPORTANTE:** Os Dados e informações fornecidos pela **brapi.dev** têm propósito exclusivamente **informativo e educacional** e **NÃO CONSTITUEM ACONSELHAMENTO FINANCEIRO, DE INVESTIMENTO, JURÍDICO OU DE QUALQUER OUTRA NATUREZA**. Você é o único responsável por suas próprias decisões de investimento e por qualquer uso que faça dos Dados. ## 5. Limitação de Responsabilidade Em nenhuma hipótese a **brapi.dev**, seus diretores ou fornecedores serão responsáveis por quaisquer danos (incluindo, sem limitação, danos por perda de dados, perda de lucro ou interrupção de negócios) decorrentes do uso ou da incapacidade de usar os nossos Serviços, mesmo que tenhamos sido avisados da possibilidade de tais danos. ## 6. Modificações nos Termos Reservamo-nos o direito de modificar estes Termos a qualquer momento, a nosso exclusivo critério. A versão mais recente estará sempre disponível em nosso site. É sua responsabilidade revisar estes Termos periodicamente. O uso contínuo da Plataforma após a publicação de quaisquer alterações constitui sua aceitação dos novos Termos. ## 7. Lei Aplicável e Foro Estes Termos e Condições são regidos e interpretados de acordo com as leis da **República Federativa do Brasil**. Você concorda em se submeter à jurisdição exclusiva dos tribunais do foro da Comarca de **Brasília, DF, Brasil**, renunciando a qualquer outro, por mais privilegiado que seja, para resolver quaisquer disputas decorrentes destes Termos.