Novos módulos na brapi: Balanços Patrimoniais, Demonstrativos de Resultados, Principais Estatísticas e muito mais!
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!
20 de novembro, 2023 por Alisson Leal
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 (opens in a new tab)
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)
- Balanço Patrimonial Histórico (balanceSheetHistory)
- Principais Estatísticas da Empresa (defaultKeyStatistics)
- Demonstrativo de Resultados Histórico (incomeStatementHistory)
- 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:
GET https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN&modules=summaryProfileExemplo:
{
"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
- Exemplo de requisição:
GET https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN&modules=balanceSheetHistoryPara obter dados trimestrais, basta utilizar o módulo balanceSheetHistoryQuarterly:
GET https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN&modules=balanceSheetHistoryQuarterlyExemplo:
{
...
"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:
GET https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN&modules=defaultKeyStatisticsExemplo:
{
...
"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:
GET https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN&modules=incomeStatementHistoryExemplo:
{
...
"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:
GET https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN&modules=financialDataExemplo:
{
"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!