Gov CVM
Objetivo
O conector CVM integra a plataforma Fluid ao Portal de Dados Abertos da Comissão de Valores Mobiliários (CVM), permitindo obter o Informe Diário e o cadastro dos fundos de investimento registrados na CVM.
É direcionado a gestoras, administradoras, consultorias e equipes de dados que precisam acompanhar cota, patrimônio líquido, captações, resgates e número de cotistas dos fundos, ou manter uma base cadastral de fundos atualizada.
O portal publica arquivos estáticos (ZIP, CSV e TXT), sem API versionada. Por isso, a referência de versão é o próprio conjunto de dados publicado pela CVM.
Documentação oficial dos dados:
Requisitos (criando conexão)
A conexão não pede credenciais: os dados do portal da CVM são públicos e não exigem autenticação.
Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
URL do Portal de Dados Abertos | string (oculto) | Não | Endereço do portal. Já vem preenchido com https://dados.cvm.gov.br e não aparece no formulário. |
Autenticação:
Nenhuma. As requisições são enviadas sem token, chave de API ou login.
Observações:
- Basta criar a conexão e salvar; não há campos para preencher.
- Uma única conexão atende todos os recursos do conector.
- Se o portal da CVM mudar de endereço, a URL base é ajustada no próprio conector, sem alterar os fluxos.
Configurando um fluxo
- Método: todas as operações são GET (somente leitura).
- Formato de retorno: arquivos ZIP, CSV ou TXT, conforme a operação. Os ZIPs do Informe Diário contêm um único CSV.
- Formato do CSV: colunas separadas por ponto e vírgula (;), datas em AAAA-MM-DD e decimais com ponto.
- Parâmetros: competência (Ano e Mês) no informe mensal e ano no histórico anual. As demais operações não têm parâmetros.
- Competência: aceita 202610, 2026-10 ou 10/2026; o conector converte para AAAAMM.
- Tamanho: o informe de um mês tem cerca de 7 MB compactado e 33 MB descompactado. Considere o tempo de download e o processamento no fluxo.
O arquivo de um mês é atualizado pela CVM ao longo do mês, conforme os fundos entregam seus informes. Para manter os dados em dia, baixe novamente a competência corrente.
Recursos e operações
As operações ficam organizadas em três níveis: Módulo, Recurso e Operação. Hoje o conector tem o módulo Fundos de Investimento, com dois recursos.
Informe Diário de Fundos
Dados diários de cada fundo e classe: valor total da carteira, valor da cota, patrimônio líquido, captações, resgates e número de cotistas.
Operação | Campos | Arquivo retornado | Descrição |
|---|---|---|---|
Obter Informe Diário do Mês | Competência (Ano e Mês), obrigatório | inf_diario_fi_AAAAMM.zip | Informe de um mês, disponível a partir de janeiro de 2021. |
Obter Histórico Anual do Informe Diário | Ano, obrigatório | HIST/inf_diario_fi_AAAA.zip | Informes consolidados por ano, de 2000 a 2020. |
Consultar Dicionário de Dados | Nenhum | meta_inf_diario_fi.txt | Descrição de cada coluna do informe. |
Colunas do CSV: TP_FUNDO_CLASSE, CNPJ_FUNDO_CLASSE, ID_SUBCLASSE, DT_COMPTC, VL_TOTAL, VL_QUOTA, VL_PATRIM_LIQ, CAPTC_DIA, RESG_DIA e NR_COTST.
Cadastro de Fundos
Dados cadastrais dos fundos e classes registrados na CVM.
Operação | Campos | Arquivo retornado | Descrição |
|---|---|---|---|
Baixar Cadastro Atual de Fundos (CSV) | Nenhum | cad_fi.csv | Cadastro vigente dos fundos. |
Baixar Histórico do Cadastro (ZIP) | Nenhum | cad_fi_hist.zip | Histórico das alterações cadastrais. |
Baixar Registro de Fundos e Classes (ZIP) | Nenhum | registro_fundo_classe.zip | Registro de fundos, classes e subclasses. |
Na prática
Exemplos de uso
- Atualizar cotas diariamente: um scheduler baixa o informe da competência corrente, filtra os CNPJs da carteira e grava cota e patrimônio líquido no sistema de destino.
- Carga histórica: baixe os anos de 2000 a 2020 pelo histórico anual e os meses a partir de 2021 pelo informe mensal.
- Enriquecer cadastro: cruze o CNPJ_FUNDO_CLASSE do informe com o cadastro atual para trazer nome, situação e administrador do fundo.
Boas práticas
- Use a operação Consultar Dicionário de Dados para confirmar o significado de cada coluna.
- Filtre os registros pelo CNPJ dentro do fluxo para trabalhar só com os fundos de interesse.
- Agende a execução fora do horário comercial, pelo tamanho dos arquivos.
Disparando o fluxo
- Modos de execução: manual, evento externo ou agendamento (scheduler).
- Validação: sucesso indicado por HTTP 200. HTTP 404 indica arquivo inexistente, por exemplo uma competência ainda não publicada ou um ano fora do intervalo.
- Testes recomendados:
- Consultar Dicionário de Dados, para validar a comunicação com o portal.
- Obter Informe Diário do Mês com a competência atual, para confirmar o download do ZIP.
Conclusão
O conector CVM traz para os fluxos da Fluid o Informe Diário e o cadastro dos fundos de investimento, direto do Portal de Dados Abertos da CVM.
Como os dados são públicos, a conexão não exige autenticação. Novos módulos do portal, como Companhias Abertas, podem ser adicionados ao lado de Fundos de Investimento sem alterar os fluxos existentes.