Fundos de Investimento: Documentos: Balancete¶
Resumo¶
Balancetes mensais dos fundos de investimento: o saldo de cada conta do plano contábil do fundo (plano COFI), no fim de cada mês.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | cvm/fi-balancete |
| Órgão | Comissão de Valores Mobiliários (CVM) |
| Página oficial | https://dados.cvm.gov.br/dataset/fi-doc-balancete |
| Licença | Open Data Commons Open Database License (ODbL), conforme o portal de dados abertos da CVM: https://dados.cvm.gov.br/dataset/fi-doc-balancete |
| Periodicidade | mensal (um arquivo por mês); o portal declara atualização semanal (os arquivos de 2026-09 e 2026-10 foram regravados em 2026-11-14) |
| Cobertura | 2015-01 a em-curso |
| Unidade (uma linha) | o saldo de uma conta contábil de um fundo (ou classe) em um mês |
| Granularidade | espacial: nacional (sem recorte geográfico); temporal: mensal (último dia do mês, DT_COMPTC) |
| Formato bruto | ZIP com um CSV por tabela (ponto e vírgula), um arquivo por período, no espelho público da CVM |
| Estado no lake | convertido |
| Partições | ano, mes |
| Chave | CNPJ_FUNDO_CLASSE, CD_CONTA_BALCTE |
| Colunas | 7 |
| Unidades de medida | VL_SALDO_BALCTE: moeda (R$) |
| Dados pessoais | nenhum |
| Eras | 2023-11: CNPJ_FUNDO vira CNPJ_FUNDO_CLASSE e entra TP_FUNDO_CLASSE (adaptação à Resolução CVM 175) |
| Revisado em | 2026-11-16 |
| Versão do fetcher | 0.4.0 |
Origem e coleta¶
- Fonte: Portal de Dados Abertos da CVM (https://dados.cvm.gov.br/dataset/fi-doc-balancete). Os arquivos ficam no espelho público
https://dados.cvm.gov.br/dados/FI/DOC/BALANCETE/DADOS/. - O catálogo do fetcher lista 143 arquivo(s): de
balancete_fi_201501.zipabalancete_fi_202611.zip. - Em 2026-11-16 conferimos 3 arquivos Parquet convertidos de 3 arquivo(s) de origem (amostra: 2015-01, 2020-12, 2026-10).
- No bruto, o arquivo fica em
fi-balancete/<arquivo>@AAAAMMDD.<csv|zip>; o carimbo é a data da coleta, e a CVM reenvia os arquivos do ano ou mês corrente todos os dias. - O dicionário de dados (arquivos
METAda CVM, em.../META/) não é baixado pelo fetcher; as descrições da seção Variáveis vêm dele, conferidas contra os cabeçalhos dos arquivos.
Conteúdo¶
- Unidade de análise: o saldo de uma conta contábil de um fundo (ou classe) em um mês.
- Particionado por
anoemes; o catálogo cobre 2015-01 a 2026-11, e conferimos as amostras 2015-01, 2020-12, 2026-10. - O arquivo de 2026-10 tem 1.954.887 linhas, 374 contas distintas (
CD_CONTA_BALCTE) e um únicoDT_COMPTC(2026-10-31); o plano de contas (PLANO_CONTA_BALCTE) é o COFI. A chaveCNPJ_FUNDO_CLASSE+CD_CONTA_BALCTE(em 2015-01 e 2020-12,CNPJ_FUNDO+CD_CONTA_BALCTE) é única nos três arquivos amostrados. - O portal disponibiliza os balancetes dos últimos doze meses com atualização semanal, e o histórico desde 2015-01 em arquivos que não são mais atualizados.
- Uma tabela, com 7 colunas; o maior arquivo convertido tem 1.954.887 linhas. Chave candidata (única no arquivo mais recente convertido):
CNPJ_FUNDO_CLASSE,CD_CONTA_BALCTE.
Variáveis¶
Descrições do dicionário de dados (arquivos META) da CVM. Os nomes de coluna são os do arquivo, sem normalização. Colunas que não existem em todas as tabelas dizem em quais tabelas aparecem. A coluna Período mostra os períodos das amostras convertidas em que a coluna aparece (todo = em todos os arquivos das tabelas em que existe).
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
CNPJ_FUNDO |
CNPJ_FUNDO |
texto | CNPJ do fundo/classe (nome da coluna nos arquivos anteriores à adaptação à Resolução CVM 175; depois, CNPJ_FUNDO_CLASSE) |
— | 2015-01 a 2020-12 |
DT_COMPTC |
DT_COMPTC |
texto | Data de competência do documento | — | todo |
PLANO_CONTA_BALCTE |
PLANO_CONTA_BALCTE |
texto | Plano contábil utilizado no balancete | — | todo |
CD_CONTA_BALCTE |
CD_CONTA_BALCTE |
inteiro | Código da conta | código ou número de identificação (sem unidade) | todo |
VL_SALDO_BALCTE |
VL_SALDO_BALCTE |
decimal | Saldo da conta | moeda (R$) | todo |
TP_FUNDO_CLASSE |
TP_FUNDO_CLASSE |
texto | Tipo de fundo/classe | — | 2026-10 |
CNPJ_FUNDO_CLASSE |
CNPJ_FUNDO_CLASSE |
texto | CNPJ do fundo/classe | — | 2026-10 |
ano |
— (partição) | inteiro | Ano do arquivo de origem | — | todo |
mes |
— (partição) | inteiro | Mês do arquivo de origem | — | todo |
No lake¶
- Dataset
cvm/fi-balancete, particionado porano,mes; um arquivo Parquet por CSV (membro do ZIP). - O conversor lê o CSV (separador
;, UTF-8 e, se falhar, ISO-8859-1), mantém os nomes de coluna do arquivo, deixa CNPJ, ISIN e códigos CVM como texto e infere os demais tipos (número ou texto): datas ficam como textoAAAA-MM-DD. - Linhas com
;dentro de um campo de texto sem aspas (que a CVM publica em alguns arquivos) são reparadas sem descartar a linha. - A partição vem do nome do arquivo (
..._AAAA-MM, com hífen, como o fetcher grava o bruto).
Cuidados de uso¶
- A CVM reenvia os arquivos todo dia. Os arquivos do ano ou mês corrente mudam entre atualizações (reapresentações, correções e novos documentos); reconverta antes de fechar um período.
- Troca de coluna de identificação. Até 2023-10 o CNPJ está em
CNPJ_FUNDOe o arquivo não temTP_FUNDO_CLASSE; desde 2023-11 o CNPJ está emCNPJ_FUNDO_CLASSE. Ao ler vários meses comunion_by_name, coalesça as duas colunas. - O saldo não traz descrição da conta. O arquivo traz só o código (
CD_CONTA_BALCTE) e o plano; a descrição de cada conta está no plano COFI, fora do dataset. - Saldos com sinal.
VL_SALDO_BALCTEé negativo em cerca de 19% das linhas (377.113 de 1.954.887 em 2026-10); o sinal segue a natureza da conta no plano, então confira o código antes de somar contas.
Exemplos¶
Saldo por conta de uma classe em um mês.
import duckdb
duckdb.sql("""
SELECT CD_CONTA_BALCTE, VL_SALDO_BALCTE
FROM read_parquet('lake/cvm/fi-balancete/ano=2026/mes=10/*.parquet')
WHERE CNPJ_FUNDO_CLASSE = '00.017.024/0001-53'
ORDER BY CD_CONTA_BALCTE
""").show()
Referências¶
- Conjunto no portal de dados abertos da CVM: https://dados.cvm.gov.br/dataset/fi-doc-balancete
- Dados e dicionário (
META): https://dados.cvm.gov.br/dados/FI/DOC/BALANCETE/