Relatórios financeiros

GET

/traded-funds/[fundIdentifier]/reports

Retorna dados de relatórios financeiros padronizados de um fundo listado (FII, FIAGRO, FIDC, ETFs e ETFs de renda fixa): ativo, passivo, demonstração de resultado, despesas operacionais e distribuições. Os dados são extraídos de documentos oficiais (informes FNET/CVM) e já vêm prontos para análise histórica.

Quando usar

• Montar telas de detalhe do fundo com a evolução do patrimônio (ativo e passivo)
• Construir dashboards e séries históricas de receitas, despesas e distribuições
• Analisar a eficiência operacional do fundo (ex.: despesas vs. resultado)
• Automatizar a ingestão incremental de relatórios usando publish_date ou retrieval_date como "cursor"

Parâmetros de requisição

Parâmetro	Local	Descrição	Obrigatório
[fundIdentifier]	URL	Identificador do fundo: ticker (ex.: HGLG11), symbol (ex.: HGLG) ou company_id numérico.	Obrigatório
section	Query	Filtra pela seção do relatório (ver valores aceitos abaixo).	Opcional
fund_type	Query	Filtra pelo tipo de fundo (ver valores aceitos abaixo).	Opcional
report_type	Query	Filtra pelo tipo de relatório (ver valores aceitos abaixo).	Opcional
reference_date	Query	ISO 8601. Filtra pela data de referência (corresponde ao dia inteiro informado).	Opcional
publish_date	Query	ISO 8601. Retorna apenas documentos publicados após a data informada.	Opcional
retrieval_date	Query	ISO 8601. Retorna apenas documentos coletados após a data informada.	Opcional
latest_by_reference_date	Query	Booleano. Se true, mantém apenas o documento publicado mais recentemente por reference_date.	Opcional
limit	Query	Quantidade de resultados a retornar. Mín.: 1, máx.: 500. Padrão: 50.	Opcional
offset	Query	Quantidade de resultados a pular (paginação). Mín.: 0. Padrão: 0.	Opcional

Boas práticas

• Use latest_by_reference_date=true para evitar versões duplicadas do mesmo período quando o fundo republica um documento.
• Para ingestão incremental, use publish_date ou retrieval_date como "cursor": ambos retornam apenas documentos posteriores à data informada.
• Combine section e report_type para recortes precisos (ex.: section=ASSETS com report_type=MONTHLY_REPORT).

Valores aceitos

Seções (section)

• ASSETS: composição do ativo do fundo
• LIABILITIES: composição do passivo (obrigações) do fundo
• INCOME_STATEMENT: demonstração de resultado do período
• OPERATING_EXPENSES: despesas operacionais do fundo
• DISTRIBUTIONS: distribuições de rendimentos aos cotistas

Tipos de fundo (fund_type)

• FII: fundo de investimento imobiliário
• FIAGRO: fundo de investimento nas cadeias produtivas agroindustriais
• FIDC: fundo de investimento em direitos creditórios
• ETFs: fundo de índice (renda variável)
• ETFs_RF: fundo de índice de renda fixa

Tipos de relatório (report_type)

• DAILY_REPORT: informe diário
• MONTHLY_REPORT: informe mensal
• QUARTERLY_REPORT: informe trimestral
• ANNUAL_REPORT: informe anual
• TRIAL_BALANCE: balancete
• CDA: composição e diversificação das aplicações

Resposta

Código	Descrição
200	Retorna os relatórios financeiros do fundo.
400	Parâmetros ausentes ou inválidos.
401	Não autorizado.
404	Fundo não encontrado.

Formato da resposta

A resposta é uma lista de objetos com os campos abaixo:

Campo	Tipo	Descrição
section	string	Seção do relatório (ASSETS, LIABILITIES, INCOME_STATEMENT, OPERATING_EXPENSES, DISTRIBUTIONS).
fund_type	string	Tipo do fundo (FII, FIAGRO, FIDC, ETFs, ETFs_RF).
report_type	string	Tipo do relatório (DAILY_REPORT, MONTHLY_REPORT, QUARTERLY_REPORT, ANNUAL_REPORT, TRIAL_BALANCE, CDA).
reference_date	string (ISO 8601)	Data de referência do período reportado.
publish_date	string (ISO 8601)	Data de publicação do documento na fonte.
retrieval_date	string (ISO 8601)	Data/hora de coleta do documento pela Partnr.
data	object	Dados padronizados da seção do relatório. As chaves exatas variam conforme a seção e o tipo de fundo.
sources	array	Lista de fontes oficiais usadas para compor o item.

Estrutura de sources[]

Campo	Tipo	Descrição
visualization_url	string	URL para visualização do documento original na FNET.
download_url	string | null	URL para download do documento original (quando disponível).
published_at	string (ISO 8601)	Data de publicação do documento na fonte.
retrieved_at	string (ISO 8601)	Data/hora em que a Partnr coletou o documento.
name	string	Nome do documento (ex.: Monthly Report).

Exemplo

[
  {
    "section": "ASSETS",
    "fund_type": "FII",
    "report_type": "MONTHLY_REPORT",
    "reference_date": "2024-01-31T00:00:00.000Z",
    "publish_date": "2024-02-15T00:00:00.000Z",
    "retrieval_date": "2024-02-16T10:00:00.000Z",
    "data": {
      "...": "..."
    },
    "sources": [
      {
        "visualization_url": "https://fnet.bmfbovespa.com.br/fnet/publico/exibirDocumento?id=512345&cvm=true",
        "download_url": null,
        "published_at": "2024-02-15T00:00:00.000Z",
        "retrieved_at": "2024-02-16T10:00:00.000Z",
        "name": "Monthly Report"
      }
    ]
  },
  {
    "section": "INCOME_STATEMENT",
    "fund_type": "FII",
    "report_type": "MONTHLY_REPORT",
    "reference_date": "2024-01-31T00:00:00.000Z",
    "publish_date": "2024-02-15T00:00:00.000Z",
    "retrieval_date": "2024-02-16T10:00:00.000Z",
    "data": {
      "...": "..."
    },
    "sources": [
      {
        "visualization_url": "https://fnet.bmfbovespa.com.br/fnet/publico/exibirDocumento?id=512345&cvm=true",
        "download_url": null,
        "published_at": "2024-02-15T00:00:00.000Z",
        "retrieved_at": "2024-02-16T10:00:00.000Z",
        "name": "Monthly Report"
      }
    ]
  }
]