Novos Módulos na brapi: Fluxo de Caixa, DVA e Mais Detalhes Trimestrais

Amplie sua análise financeira com os novos módulos de Fluxo de Caixa, Demonstração do Valor Adicionado (DVA) e históricos trimestrais detalhados na API da brapi.

Neste artigo

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.

Publicado em 01 de junho, 2025

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

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)

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!