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:
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 do Valor Adicionado Histórico (valueAddedHistory)
- Dados Financeiros Históricos Trimestrais (financialDataHistoryQuarterly)
- 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:
GET https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN&modules=cashflowHistory
Para obter dados trimestrais, basta utilizar o módulo
cashflowHistoryQuarterly
:
GET https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN&modules=cashflowHistoryQuarterly
Exemplo (dados simplificados):
{
"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:
GET https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN&modules=valueAddedHistory
Para obter dados trimestrais, basta utilizar o módulo
valueAddedHistoryQuarterly
:
GET https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN&modules=valueAddedHistoryQuarterly
Exemplo (dados simplificados):
{
"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:
GET https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN&modules=financialDataHistoryQuarterly
Exemplo (dados simplificados):
{
"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:
GET https://brapi.dev/api/quote/PETR4?token=SEU_TOKEN&modules=defaultKeyStatisticsHistoryQuarterly
Exemplo (dados simplificados):
{
"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!