Partnr
    Fundamentals API

    API de Dados Fundamentalistas da B3

    Acesse os dados fundamentalistas de todas as empresas listadas na B3. Balanços, DRE, DFC, 160+ indicadores financeiros, histórico de dividendos desde 2015 e transações de insiders (Resolução CVM 44). Extraídos direto da fonte oficial, CVM e B3, e disponíveis via API REST com link para o documento da CVM em cada resposta.

    Ver documentação
    </>
    GET /v2/companies/PETR4/reports// Requisiçãocurl -X GET \"https://data.partnr.ai/v2/companies/PETR4/reports" \-H "Authorization: Bearer TOKEN"// Resposta{  "data": [    {      "NET_REVENUE": 123144000000,      "EBITDA": 62016000000,      "NET_INCOME": 35331000000    }  ]}
    GET https://data.partnr.ai/v2/companies/PETR4/reports
200 OK
{"data":[{"period":"2024-12-31","NET_REVENUE":123144000000,"EBITDA":62016000000,"NET_INCOME":35331000000,"source":"CVM/DFP","asReported":true}]}

    Demonstrativos disponíveis

    Demonstrativos das empresas listadas na B3, direto da CVM

    A API de dados fundamentalistas entrega os demonstrativos que as companhias abertas publicam na CVM, com histórico desde 2010.

    • Balanço Patrimonial (BPA e BPP)

      Ativos, passivos e patrimônio líquido da empresa

      Na API
      BALANCE_SHEET

    • Demonstração do Resultado

      Receitas, custos, despesas e lucro

      Na API
      INCOME_STATEMENT

    • Demonstração do Fluxo de Caixa

      Entradas e saídas de caixa, pelo método que a empresa publicou (direto ou indireto)

      Na API
      CASH_FLOW_STATEMENT

    • Demonstração do Valor Adicionado

      Riqueza gerada pela empresa e como foi distribuída

      Na API
      VALUE_ADDED_STATEMENT

    Dados brutos e padronizados

    A API entrega os demonstrativos em dois formatos: o bruto, como a empresa publicou na CVM, e o padronizado, com os mesmos campos para todas as empresas. Os dois formatos retornam o link para o documento original na CVM.

    Comparação entre os demonstrativos brutos e padronizados da API de dados fundamentalistas
    CritérioBrutoPadronizado
    EndpointGET/companies/[companyIdentifier]/raw-reportsGET/companies/[companyIdentifier]/reports
    EstruturaIgual à publicada na CVM, com os códigos e nomes de conta originaisModelo único de contas, igual para todas as empresas e períodos
    Nomes dos camposPodem variar entre empresas e ao longo do tempoNão mudam: cada conta tem o mesmo ID em qualquer companhia
    DemonstrativosBPA, BPP, DRE, DRA, DFC (método direto e indireto) e DVABalanço (BPA e BPP), DRE, DFC (métodos direto e indireto) e DVA
    PeríodosOs do documento original: trimestre e acumulado do ano no ITR, ano na DFPTrimestral, anual, acumulado do ano e últimos 12 meses
    Uso indicadoAuditoria, conciliação e comparação entre versões de um documentoSéries históricas, comparação entre empresas e cálculos automatizados

    Dados direto da CVM e da B3, sem intermediários.

    Todas as informações são coletadas automaticamente das fontes oficiais, CVM e B3, com links diretos para os documentos originais em cada requisição. Uptime de 99,9% e atualização no momento da publicação com time-to-market de 15 minutos.

    160+ indicadores fundamentalistas padronizados

    Mais de 160 indicadores calculados com fórmulas padronizadas e auditáveis: P/L, P/VP, EV/EBITDA, ROE, ROIC, Margem Líquida, Margem Bruta, Dividend Yield, Payout e dezenas de outros indicadores de valuation, rentabilidade e eficiência. Todos com histórico de variação e comparação setorial.

    Ver lista de indicadoresSolicitar chave de teste

    Indicadores Fundamentalistas

    P/L
    6,31
    P/VP
    1,67
    LPA
    8,54
    ROE
    26,49%
    ROIC
    19,82%
    DY
    17,09%
    EV/EBITDA
    4,71x
    Margem Líq.
    22,23%
    M. EBITDA
    46,23%

    Dividendos e eventos corporativos históricos

    A API inclui histórico completo de proventos desde 2015: dividendos, JCPs, bonificações, desdobramentos e grupamentos. Ideal para análise de dividend yield histórico, cálculo de retorno total e construção de séries de proventos por ativo.

    Ver documentaçãoSolicitar chave de teste
    Logo Petrobras
    Petrobras
    PETR4 · Proventos 2025
    Dividend Yield · 12M
    17,09%
    Dividendo
    R$ 1,3147
    Pgto. 20/11/2025
    JCP
    R$ 0,7235
    Pgto. 15/08/2025
    Payout
    68,4%
    Últimos 12M
    Eventos 2025
    12
    Histórico desde 2015
    Dado exclusivo

    Transações de insiders via API

    Acesse dados estruturados de transações internas de executivos e controladores com base na Resolução CVM 44. A API de insiders da Partnr é a única solução no Brasil que entrega esses dados via API REST padronizada, com histórico por ativo, tipo de transação, quantidade e preço declarado.

    AçãoTipoQtdPreçoData
    PETR4Venda6.440R$ 10,6415 de out.
    PETR4Compra4.976R$ 10,5612 de out.
    VALE3Venda4.326R$ 68,2027 de set.
    ITUB4Compra410R$ 37,0116 de set.
    BBDC4Compra142R$ 23,5510 de set.
    WEGE3Venda980R$ 39,8009 de set.
    SUZB3Compra2.200R$ 56,7023 de ago.
    BBAS3Venda600R$ 28,1012 de ago.

    Endpoints da API de dados fundamentalistas

    A API de dados fundamentalistas tem 12 endpoints, que cobrem cadastro, demonstrativos, indicadores, proventos, eventos corporativos, insiders e documentos.

    Ver documentação completaSolicitar chave teste

    Exemplo de requisição

    RequisiçãocURL
    curl -X GET \
  "https://data.partnr.ai/v2/companies/PETR4/reports?section=INCOME_STATEMENT&frequency=QUARTERLY&aggregation=CONSOLIDATED&reference_date=2026-06-30&latest_by_reference_date=true" \
  -H "Authorization: Bearer SEU_TOKEN"
    RequisiçãoPython
    import requests

url = "https://data.partnr.ai/v2/companies/PETR4/reports"
headers = {"Authorization": "Bearer SEU_TOKEN"}
params = {"section": "INCOME_STATEMENT", "frequency": "QUARTERLY", "aggregation": "CONSOLIDATED", "reference_date": "2026-06-30", "latest_by_reference_date": True}

response = requests.get(url, headers=headers, params=params)
print(response.json())
    RespostaJSON
    [
  {
    "section": "INCOME_STATEMENT",
    "reference_date": "2026-06-30T00:00:00.000Z",
    "data": {
      "NET_REVENUE": 169530000000,
      "NET_INCOME": 52495000000,
      "...": "..."
    },
    "sources": [
      {
        "visualization_url": "https://www.rad.cvm.gov.br/ENET/frmGerenciaPaginaFRE.aspx?NumeroSequencialDocumento=160282&CodigoTipoInstituicao=1",
        "published_at": "2026-08-06T22:51:00.000Z",
        "retrieved_at": "2026-08-07T00:08:10.684Z"
      }
    ]
  }
]
    Ver documentação de demonstrativosSolicitar chave teste

    Compromisso com a transparência e qualidade da informação.

    Apenas fontes oficiais

    Todas as informações são coletadas de forma automatizada diretamente de fontes oficiais e autenticadas através de um rigoroso processo de compliance.

    Auditável

    Requests contam com referências diretas para os dados na fonte oficial e fórmulas utilizadas para o cálculo dos indicadores.

    Atualização diária

    Dados atualizados diariamente com uptime de 99,9%. API REST em formato JSON, sem limite de requisições, com documentação detalhada e suporte dedicado.

    Integração via REST e compatibilidade com IA

    API REST com SDKs em Python e JavaScript e teste gratuito de 7 dias.

    response.json200 OK
    GET data.partnr.ai/v2/stocks/PETR4/quotes
    {
    "ticker": "PETR4",
    "date": "2025-02-05T22:00:00.000Z",
    "open_price": 32.16,
    "close_price": 32.00,
    "highest_price": 32.18,
    "lowest_price": 31.90,
    "volume": 757726088,
    "currency": "BRL"
    }

    API REST

    Integração direta com endpoints padronizados e respostas estruturadas em JSON

    Solicitar chave de teste
    @connect
    Search agents...
    ✦ChatGPT
    Agent
    ◈Cursor
    Agent
    ⬡Copilot
    Agent
    ✳Claude
    Agent
    ◉Gemini
    Agent

    Integração com IA (MCP)

    Conecte os dados a modelos de linguagem e agentes para automação e análise

    Solicitar chave de teste
    Próximo passo

    Agende uma demonstração!

    Responda o formulário ao lado e receba um escopo personalizado para o seu caso de uso.

    Retorno em até 24h
    Trial gratuito para validação
    Proposta alinhada ao escopo
    Apoio técnico na implementação
    Perguntas frequentes

    Perguntas Frequentes sobre a API de Dados Fundamentalistas

    A API de Dados Fundamentalistas da Partnr disponibiliza informações contábeis, financeiras e cadastrais das empresas listadas na B3. A solução transforma dados publicados pela CVM e pela B3 em respostas estruturadas e padronizadas, prontas para uso em plataformas de investimentos, análises de ações, screeners, dashboards, relatórios e aplicações de inteligência artificial.

    A API de Dados Fundamentalistas da Partnr oferece acesso completo aos dados contábeis e financeiros das empresas listadas na B3, incluindo:

    • Balanço patrimonial (BPA e BPP), DRE, DFC, DVA e FRE;
    • 160+ indicadores financeiros;
    • Dados cadastrais, setoriais, de riscos e qualitativos advindos do FRE;
    • Histórico de eventos corporativos e proventos (dividendos e JCPs);
    • Histórico de número de ações;
    • Para preços e volumes, use a API de cotações da B3.
    • Dados de transações internas (Resolução CVM 44).

    A API cobre todas as companhias brasileiras listadas na B3 e seus respectivos tickers, incluindo diferentes classes de ações, como ordinárias, preferenciais e units. A Partnr também oferece cobertura completa para BDRs Patrocinados. Para BDRs Não Patrocinados, a cobertura é limitada às informações disponíveis nas fontes brasileiras, como proventos e eventos corporativos.

    Os dados fundamentalistas são atualizados no momento em que surgem novas informações de determinada companhia, com um time-to-market de 15 minutos.

    A Partnr disponibiliza demonstrativos financeiros históricos desde 2010, incluindo informações trimestrais e anuais publicadas pelas companhias. O histórico permite construir séries de receitas, lucros, margens, endividamento, patrimônio e outros dados contábeis ao longo do tempo.

    A API disponibiliza mais de 160 indicadores fundamentalistas, entre eles P/L, P/VP, EV/EBITDA, ROE, ROIC, Margem Líquida, Payout, Dividend Yield e Margem Bruta. Todos os cálculos seguem fórmulas padronizadas e auditáveis. Veja a lista de indicadores fundamentalistas.

    Sim. A API disponibiliza histórico de dividendos, juros sobre capital próprio, restituições, amortizações e outros proventos em dinheiro. Os registros podem incluir ticker, tipo de evento, valor declarado, data de aprovação, data-com, data de pagamento e referência ao documento oficial.

    Sim. A API permite consultar eventos corporativos em ações, como desdobramentos, grupamentos, bonificações, cisões e outras alterações societárias. Esses dados podem ser utilizados para ajustar carteiras, manter séries históricas consistentes e automatizar o tratamento de eventos que alteram a quantidade ou a estrutura dos ativos.

    Sim. A Partnr estrutura os dados de transações e posições informadas por administradores, controladores e outros insiders conforme a Resolução CVM 44. É possível consultar informações como período do relatório, tipo de movimentação, quantidade negociada e preço declarado, de acordo com o conteúdo publicado pela companhia.

    Os dados brutos preservam a estrutura em que as informações foram originalmente publicadas pela CVM, o que é útil para auditorias, conciliações e comparação entre versões de documentos.

    Já os dados padronizados utilizam campos e identificadores consistentes entre empresas e períodos. Essa padronização facilita comparações, construção de séries históricas, cálculos automatizados e integração com produtos financeiros. A API da Partnr permite acessar os dois formatos.

    Todas as informações são extraídas diretamente das fontes oficiais, CVM e B3. O processo de coleta é automatizado e todas as requests contam com links diretos para a fonte dos dados, garantindo a precisão e integridade dos dados.

    A documentação está disponível no portal de desenvolvedores da Partnr — developers.partnr.ai/empresas. Lá estão disponíveis endpoints, autenticação e exemplos de uso. Também é possível acessar a documentação pelo botão "Ver documentação" no início da página.

    Para solicitar acesso, chave de teste ou uma proposta comercial, preencha o formulário da página com as informações do seu caso de uso. A equipe da Partnr entrará em contato em até 24 horas para entender a necessidade, orientar a integração e indicar o melhor formato de contratação.

    Ecossistema

    Amplie sua cobertura com o ecossistema Partnr

    Expanda para outras camadas de dados financeiros brasileiros — tudo no mesmo provedor, mesma integração, mesma qualidade.

    API de Cotações e Market Data B3

    Cotações, histórico desde 1984, dados ajustados e snapshots do mercado à vista da B3.

    ATIVOS2.100+
    DESDE1984
    DATA POINTS500M+
    Explorar a API de cotações da B3Ver documentação

    API de Fundos

    Dados estruturados de FIIs, FI-Infra, Fiagros e FIDCs — carteiras, proventos e indicadores.

    FUNDOS620+
    DESDE2016
    DATA POINTS118M+
    Explorar a API de FIIsVer documentação

    API de ETFs

    Composição de carteira, métricas de performance e dados de mercado para ETFs listados na B3.

    ETFs220+
    DESDE2016
    DATA POINTS36M+
    Explorar a API de ETFsVer documentação

    API Macroeconômica

    Séries históricas do Banco Central, IBGE e Tesouro — Selic, IPCA, câmbio e mais.

    SÉRIES500+
    DESDE1960
    DATA POINTS200M+
    Explorar a API de dados macroeconômicosVer documentação