--- title: brapi.dev financial market API description: Brazilian financial market data API for agents and developers. canonical: https://brapi.dev/ last-updated: 2026-08-21 --- # 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 (brapi.dev)** 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.