Dados da CVM: como acessar via portal, Python, API e MCP

A melhor forma de acessar dados da CVM depende do seu caso de uso, e o ponto de partida é diferente do que a maioria imagina. Diferente do market data da B3, que envolve contrato, vendor e licenciamento, quase tudo o que a CVM produz é dado aberto, oficial e gratuito. A decisão real é uma só: você quer o dado bruto de graça e tem tempo para tratá-lo, ou prefere pagar por ele já estruturado e pronto para usar.

Aqui aparece a confusão mais comum. Muita gente procura por uma API da CVM esperando endpoints que devolvem cotações e balanços em JSON, e sai com mais dúvida do que resposta. A CVM oferece uma API, só que não é o tipo de API que a maioria imagina.

Neste guia você vai entender o que a CVM realmente disponibiliza, o que significa "dados da CVM", quais as limitações do dado bruto e quais são os caminhos reais para consumir esses dados de forma programática, incluindo Python, API de terceiros e servidor MCP, além de como escolher a rota certa para o seu caso.

O que significa "dados da CVM"

Antes de escolher a ferramenta, separe o que você precisa, porque a base da CVM é enorme e você quase nunca precisa dela inteira. Ela se organiza em dois grandes blocos: companhias abertas e fundos de investimento.

Dados de companhias abertas

O núcleo são as demonstrações financeiras: a DFP (Demonstrações Financeiras Padronizadas), anual, e a ITR (Informações Trimestrais). Junto vêm o FRE (Formulário de Referência), o FCA (Formulário Cadastral), o IPE (informações periódicas e eventuais, onde ficam fatos relevantes, atas e comunicados), os programas de recompra e os valores mobiliários negociados e detidos por administradores, que formam a base de insiders da Resolução CVM 44 (a antiga ICVM 358).

Dados de fundos de investimento

Ali estão o cadastro, o Informe Diário (patrimônio líquido, valor da cota, captações, resgates e número de cotistas), a CDA (composição e diversificação da carteira), a lâmina, o perfil mensal e as demonstrações. Cobre FIIs, FIDCs, FIPs, FIAgros e demais estruturados. Some a isso o cadastro de participantes: corretoras, assessores, auditores e consultores.

A CVM tem indicadores fundamentalistas?

Não diretamente, e aqui mora uma confusão frequente. A CVM entrega os dados contábeis: receita, lucro líquido, patrimônio líquido, ativo, passivo, dívida e fluxo de caixa. Ela não entrega o indicador já calculado.

Para calcular a maioria dos indicadores, muitas vezes são necessários dados que estão em outras fontes. O P/L é o exemplo clássico: usa o lucro líquido como base, mas depende do preço de mercado da ação, que é distribuído pela B3. Por isso existem empresas que agregam essas informações e calculam os indicadores financeiros, distribuindo via API ou MCP. Falaremos delas mais adiante.

Dados da CVM são iguais a dados da B3?

Não, e essa distinção evita erros. A CVM é a fonte regulatória de informações sobre companhias, fundos e participantes do mercado de capitais. A B3 é a bolsa, mais associada a dados de negociação, instrumentos listados, cotações e market data.

Afinal, a CVM tem uma API?

Sim, mas é uma API de catálogo, não uma API de consulta de dados.

O Portal de Dados Abertos da CVM roda sobre o CKAN, a mesma plataforma de vários portais de dados abertos do governo. Isso significa que existe uma API programática para listar e descrever os conjuntos de dados publicados. Você consegue, por requisição, obter a relação de datasets disponíveis e os metadados de cada um, incluindo os links dos arquivos.

O que essa API não faz é entregar o dado em si de forma consultável. Não há como pedir "as cotas do fundo X no mês Y" e receber as linhas filtradas em JSON. O CKAN tem métodos de consulta estruturada (datastore_search e datastore_search_sql), mas no caso da CVM essa camada é limitada, e o caminho prático continua sendo baixar os arquivos. Na prática, a API devolve os metadados e os endereços dos arquivos, e o dado propriamente dito vem em arquivos CSV, quase sempre compactados em ZIP, que você baixa e processa por conta própria.

Traduzindo: quando alguém pergunta "existe uma API da CVM?", a resposta honesta é que existe uma API de catálogo e download, não uma API que responde "os fundamentos da PETR4" por endpoint. Se é isso que você quer, o caminho é uma API de terceiros.

O que é o Portal de Dados Abertos da CVM e o que ele entrega

O Portal de Dados Abertos da CVM é o canal oficial de publicação de informações públicas da autarquia. Ele é integrado ao Portal Brasileiro de Dados Abertos, dentro da política de transparência ativa prevista na Lei de Acesso à Informação.

O acervo é amplo. Cobre dados cadastrais e documentos de companhias abertas, fundos de investimento, intermediários, securitizadoras e outros participantes regulados. Estão lá desde formulários de referência e demonstrações financeiras padronizadas de companhias até informes diários e carteiras de fundos.

O ponto central é o formato. Tudo é entregue como arquivo, organizado por conjunto de dados e por período. Um informe diário de fundos, por exemplo, é publicado em arquivos mensais compactados. Boa parte dos conjuntos é atualizada com frequência, alguns diariamente, mas a unidade de entrega continua sendo o arquivo, não a linha consultável.

A licença é generosa: os dados são um serviço público gratuito para qualquer pessoa física ou jurídica, com a única obrigação de citar a fonte.

Quais as limitações do dado bruto?

Depender apenas dos arquivos do portal funciona para análise pontual, mas cria atrito assim que você precisa de escala, atualização recorrente ou integração com um produto. Os principais pontos de limitação:

• Você baixa o arquivo inteiro, não um recorte específico. Sem uma camada de consulta habilitada, não existe filtro por requisição. Para responder uma pergunta específica, você traz o CSV completo do período e filtra localmente.
• O histórico é particionado. Séries longas costumam estar distribuídas em múltiplos arquivos por ano ou por mês, às vezes em diretórios distintos e com regras de compactação diferentes. Montar uma série contínua exige juntar e normalizar esses pedaços.
• O layout muda. Campos são adicionados, renomeados ou reorganizados ao longo do tempo, acompanhando mudanças regulatórias. Um pipeline que lê esses arquivos precisa de manutenção sempre que a estrutura é alterada.
• Não há garantia de serviço. Os termos de uso declaram que os dados são fornecidos no estado em que se encontram, sem garantia de fornecimento contínuo nem de entrega tempestiva, e preveem que o portal pode limitar acessos simultâneos e requisições automatizadas.

De modo geral, o portal cumpre muito bem o papel de transparência ativa, funcionando como um repositório público de arquivos, e não como uma camada de dados pronta para alimentar sistemas. Para um desenvolvedor experiente, tratar tudo isso pode ser viável. Para uma empresa, esse tratamento costuma demandar tempo e dedicação constante do time técnico, e é por isso que existem empresas especializadas na extração, tratamento e distribuição desses dados.

Como acessar os dados da CVM na prática

Existem basicamente cinco caminhos para consumir dados da CVM. Escolher entre eles depende do seu objetivo.

1. Download manual dos arquivos no Portal de Dados Abertos. É o caminho para uma análise única ou exploração inicial. Direto, mas não escala e não automatiza nada.
2. Script sobre os arquivos. Você automatiza o download, descompacta o ZIP e lê o CSV com uma biblioteca de dados. Dá controle total sobre a fonte oficial e é o método que a maioria dos tutoriais ensina. O custo aparece na manutenção: tratar mudanças de layout, lidar com o histórico particionado e cuidar da atualização.
3. API de catálogo do CKAN da CVM. Útil para descobrir e listar datasets de forma programática, por exemplo para automatizar a checagem de quais conjuntos existem e onde estão os arquivos. Não resolve a consulta ao dado em si.
4. API de dados de terceiros. Provedores que já processam os arquivos da CVM e expõem endpoints REST que devolvem o dado estruturado em JSON, com autenticação e filtros. Elimina a etapa de baixar e parsear arquivos.
5. Servidor MCP de terceiros. Expõe esses mesmos dados pelo Model Context Protocol, para que agentes de IA consultem o mercado brasileiro em linguagem natural, sem código de integração.

Os três primeiros caminhos trabalham diretamente sobre a fonte oficial. Os dois últimos delegam o trabalho de estruturação a um provedor. Vale lembrar ainda que os documentos originais entregues pelas companhias (fatos relevantes, FRE, atas e comunicados) ficam acessíveis pelo sistema RAD CVM e pelo IPE, úteis quando você precisa do documento em si, não do dado tabulado.

Como acessar dados da CVM em Python

Dá para acessar dados da CVM em Python baixando os arquivos do portal oficial, lendo os CSVs, descompactando as bases e tratando os dados localmente. O padrão sobre a fonte oficial é sempre o mesmo: baixar o arquivo do período, descompactar e ler o CSV. Com pandas, isso costuma caber em poucas linhas, já que a biblioteca lida com o ZIP diretamente.

import pandas as pd

# Informe diário de fundos, arquivo mensal compactado

url = "https://dados.cvm.gov.br/dados/FI/DOC/INF_DIARIO/DADOS/inf_diario_fi_202507.zip"

df = pd.read_csv(url, sep=";", compression="zip", encoding="latin-1")

print(df.head())

Esse padrão funciona, mas repare no que ele exige de você ao longo do tempo. O nome do arquivo segue uma convenção de período que muda a cada mês. O separador e a codificação precisam bater com o padrão do conjunto. E, para uma série histórica, você repete o processo para cada período e concatena os resultados, tratando eventuais diferenças de layout entre anos.

O caminho alternativo é consumir uma API de dados que já fez esse trabalho. Em vez de baixar e parsear arquivos, você faz uma requisição autenticada e recebe o recorte estruturado:

import requests

resp = requests.get(

"https://api.exemplo-provedor.com/fundos/informe-diario",

params={"cnpj": "00.000.000/0001-00", "inicio": "2025-07-01", "fim": "2025-07-31"},

headers={"Authorization": "Bearer SUA_CHAVE"},

)

dados = resp.json()

A diferença não é de linguagem, é de responsabilidade. No primeiro caso, você mantém o pipeline sobre a fonte bruta. No segundo, você terceiriza a coleta, o parse e a normalização, e trabalha direto com o dado consultável.

Python é uma boa opção quando você quer estudar os dados, está construindo um protótipo, tem equipe técnica e aceita manter o código de coleta. Deixa de bastar quando o projeto exige atualização recorrente, alta confiabilidade, múltiplos usuários, logs, governança ou integração com agentes de IA.

Quando usar uma API de terceiros

Use uma API de terceiros quando quer o dado já normalizado, com indicadores calculados, mapeado para ticker, e não quer manter ETL. É a rota certa para produto, dashboard, fintech e análise ágil. Você paga para não lidar com as particularidades de extração da fonte e para não se preocupar com eventuais mudanças de schema.

Os principais provedores brasileiros são:

• Brapi: expõe balanços e fundamentos básicos por módulos.
• Bolsai: aposta em profundidade, com 27 indicadores calculados em base TTM e as contas da CVM em bruto disponíveis, útil para painel fundamentalista longo.
• Dados de Mercado: combina CVM, BACEN, Anbima e B3.
• Partnr: entrega fundamentos com mais de 150 indicadores, fundos com visão de look-through e a base de insiders da Resolução CVM 44 já estruturada.
• Mais Retorno: forte em carteira e classificação, especialmente para análise de fundos.

O critério de escolha deve ser cobertura, confiabilidade da fonte e adequação ao seu caso, não apenas preço.

Existe um servidor MCP para dados da CVM?

Oficial, não. A CVM não oferece servidor MCP. Eles são oferecidos por provedores privados que estruturam esses dados e os expõem pelo protocolo.

MCP, ou Model Context Protocol, é um padrão aberto criado pela Anthropic em novembro de 2024 para padronizar como agentes de IA acessam dados e ferramentas externas. Ele funciona como uma espécie de conector universal entre modelos e fontes de dados. Em dezembro de 2025, o protocolo foi doado à Agentic AI Foundation, sob a Linux Foundation, o que reforçou sua governança neutra.

Na prática, com um MCP você não escreve código de integração. Você pluga o servidor no seu cliente de IA e o agente consulta a fonte estruturada. O agente recebe um pedido como "faça a triagem das companhias de um setor e destaque quem teve queda de margem", entende a pergunta, escolhe a ferramenta, consulta o dado estruturado e monta a resposta.

Como o protocolo dá ao agente acesso a dados e ações externas, escolher provedores confiáveis e bem configurados importa. Análises de segurança de 2025 já apontaram riscos em servidores mal implementados. Não é motivo para evitar MCP, é motivo para selecionar a fonte com critério.

Para entender o protocolo por dentro, veja: O que é MCP (Model Context Protocol)? Guia completo.

Portal, Python, API ou MCP: qual caminho escolher

Cada rota resolve um problema diferente. A CVM é sempre a fonte oficial; as demais são camadas que tornam o dado mais utilizável, cada uma cobrando um preço em esforço ou em dinheiro. A tabela abaixo resume o que cada uma entrega.

Traduzindo para a decisão, por perfil de uso:

A regra prática é direta. Se o objetivo é uma análise isolada, o arquivo resolve. Se é um pipeline sob seu controle e você aceita mantê-lo, o script sobre CSV serve. Se o dado precisa alimentar um produto ou aplicação com o mínimo de atrito, uma API estruturada faz mais sentido. E se o consumo é feito por um agente de IA, o MCP é a rota nativa.

Erros comuns ao acessar dados da CVM

• Achar que o dado aberto já vem pronto para análise. O dado aberto é a matéria-prima. Para análise, muitas vezes é preciso limpar, padronizar, cruzar e transformar os arquivos, com atenção ao período (um número trimestral, anual ou acumulado leva a conclusões diferentes).
• Confundir documento regulatório com indicador pronto. A CVM disponibiliza documentos e dados oficiais. Indicadores como ROE, P/L e P/VP exigem cálculo, contexto e, muitas vezes, preço de mercado.
• Tratar fundos e companhias como a mesma coisa. Fundos e companhias abertas têm estruturas, documentos e bases diferentes, e o tratamento de dados também muda.
• Usar dado bruto em um agente de IA sem camada de validação. Conectar um agente diretamente a arquivos crus pode gerar respostas confusas, incompletas ou difíceis de auditar. Agentes precisam de dados bem estruturados.

Quando faz sentido usar uma camada de dados pronta

O ponto de virada costuma ser o mesmo para times diferentes: o momento em que manter a coleta sobre os arquivos brutos passa a custar mais do que o problema que ela resolve. Quando o dado precisa estar sempre atualizado, normalizado e disponível por requisição, terceirizar a camada de coleta libera o time para trabalhar na análise, não na infraestrutura de ingestão.

É nesse recorte que provedores de dados estruturados entram. A Partnr, por exemplo, processa dados oficiais da CVM, da B3, do Banco Central e do IBGE e os expõe por API REST e por servidor MCP, cobrindo dados fundamentalistas de empresas listadas, cotações históricas, indicadores macroeconômicos com histórico longo, dividendos, transações de insiders e notícias de mercado. O valor não está em substituir a fonte oficial, e sim em eliminar a etapa de baixar, descompactar, parsear e normalizar arquivo por arquivo.

Para obter indicadores prontos, o caminho é a página de dados fundamentalistas. Para conectar agentes de IA a dados financeiros via MCP, o caminho é o servidor MCP da Partnr.

Essa categoria já tem concorrência no Brasil, com mais de um provedor oferecendo API e MCP sobre dados do mercado. O critério de escolha deve ser sempre cobertura, confiabilidade da fonte e adequação ao seu caso.

Conclusão

Existe dado da CVM, e ele é aberto, gratuito e oficial. Esse é o ponto de partida mais importante. Mas a CVM tem uma API de catálogo, não uma API de dados: o Portal de Dados Abertos entrega arquivos públicos e um índice programático do acervo, excelente para transparência e suficiente para análises pontuais, mas sem o dado consultável, filtrado e pronto para produção que muitos times esperam.

A partir daí, o caminho depende do objetivo. Para exploração, o arquivo basta. Para um pipeline próprio, o script sobre os CSV funciona, ao custo de manutenção. Para alimentar produtos, aplicações ou agentes de IA sem carregar essa manutenção, uma API estruturada ou um servidor MCP de um provedor confiável resolve o atrito. O caminho honesto é esse: fonte oficial primeiro, estruturação depois, IA por último. O primeiro passo é decidir em qual desses cenários você está, porque é essa decisão, e não a busca por uma API que não existe no formato imaginado, que define a rota certa.