Administradores de Carteira: Informação Cadastral¶
Resumo¶
Cadastro dos administradores de carteira de valores mobiliários registrados na CVM: pessoas físicas e jurídicas, com diretores, responsáveis e sócios.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | cvm/adm-cart-cad |
| Órgão | Comissão de Valores Mobiliários (CVM) |
| Página oficial | https://dados.cvm.gov.br/dataset/adm_cart-cad |
| Licença | Open Data Commons Open Database License (ODbL), conforme o portal de dados abertos da CVM: https://dados.cvm.gov.br/dataset/adm_cart-cad |
| Periodicidade | diária (a CVM atualiza os arquivos todos os dias) |
| Cobertura | 2026-11 a em-curso |
| Unidade (uma linha) | um registro de administrador de carteira, diretor, responsável ou sócio (conforme a tabela) |
| Granularidade | espacial: nacional (sem recorte geográfico); temporal: retrato do dia (cadastro vigente, sem histórico) |
| Formato bruto | CSV com ponto e vírgula, em arquivo CSV ou ZIP (um CSV por tabela dentro do ZIP) no espelho público da CVM |
| Estado no lake | convertido |
| Partições | — |
| Chave | — |
| Colunas | 30 |
| Unidades de medida | CEP: código ou número de identificação (sem unidade); DDD: código ou número de identificação (sem unidade); TEL: código ou número de identificação (sem unidade); VL_PATRIM_LIQ: moeda (ver ESCALA_MOEDA, quando houver; senão R$) |
| Dados pessoais | LOGRADOURO (endereço, telefone, e-mail ou CPF (pode ser de pessoa jurídica)); CEP (endereço, telefone, e-mail ou CPF (pode ser de pessoa jurídica)); DDD (endereço, telefone, e-mail ou CPF (pode ser de pessoa jurídica)); EMAIL (endereço, telefone, e-mail ou CPF (pode ser de pessoa jurídica)) |
| Eras | nenhuma |
| Revisado em | 2026-11-15 |
| Versão do fetcher | 0.4.0 |
Origem e coleta¶
- Fonte: Portal de Dados Abertos da CVM (https://dados.cvm.gov.br/dataset/adm_cart-cad). Os arquivos ficam no espelho público
https://dados.cvm.gov.br/dados/ADM_CART/CAD/DADOS/. - O catálogo do fetcher lista 1 arquivo(s): de
cad_adm_cart.zipacad_adm_cart.zip. Em 2026-11-15 conferimos 5 arquivos Parquet convertidos de 1 arquivo(s) de origem (amostra: primeiro, intermediários e os dois últimos). - No bruto, o arquivo fica em
adm-cart-cad/<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: um registro de administrador de carteira, diretor, responsável ou sócio (conforme a tabela).
- Este dataset reúne 5 tabelas (um CSV por tabela em cada ZIP), gravadas como arquivos Parquet separados no mesmo dataset; o nome do arquivo no lake é
<zip>__<csv>.parquet:
| Tabela (nome do CSV sem o ano) | Colunas | Linhas no maior arquivo convertido | Chave candidata (única no maior arquivo) |
|---|---|---|---|
cad_adm_cart_diretor |
3 | 1.755 | não determinada |
cad_adm_cart_pf |
7 | 6.880 | não determinada |
cad_adm_cart_pj |
24 | 3.073 | CNPJ, DT_REG |
cad_adm_cart_resp |
3 | 6.776 | não determinada |
cad_adm_cart_socios |
2 | 8.120 | não determinada |
- Não há uma chave única comum às tabelas: cada tabela tem a sua (coluna acima). Os arquivos de uma mesma competência ligam-se por identificador do documento ou do fundo (veja as colunas de cada tabela).
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.
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
CNPJ |
CNPJ |
texto | Cadastro Nacional de Pessoas Jurídicas (só em: cad_adm_cart_diretor, cad_adm_cart_pj, cad_adm_cart_resp, cad_adm_cart_socios) |
— | todo |
DIRETOR |
DIRETOR |
texto | Nome do Diretor Responsável (só em: cad_adm_cart_diretor) |
— | todo |
DIRETOR_DEFAULT |
DIRETOR_DEFAULT |
texto | Indica se o diretor é padrão (só em: cad_adm_cart_diretor) |
S/N | todo |
ADMIN |
ADMIN |
texto | Nome do Administrador (só em: cad_adm_cart_pf) |
— | todo |
DT_REG |
DT_REG |
texto | Data de registro (só em: cad_adm_cart_pf, cad_adm_cart_pj) |
— | todo |
DT_CANCEL |
DT_CANCEL |
texto | Data de cancelamento (só em: cad_adm_cart_pf, cad_adm_cart_pj) |
— | todo |
MOTIVO_CANCEL |
MOTIVO_CANCEL |
texto | Motivo de cancelamento (só em: cad_adm_cart_pf, cad_adm_cart_pj) |
— | todo |
SIT |
SIT |
texto | Situação (só em: cad_adm_cart_pf, cad_adm_cart_pj) |
— | todo |
DT_INI_SIT |
DT_INI_SIT |
texto | Data início da situação (só em: cad_adm_cart_pf, cad_adm_cart_pj) |
— | todo |
CATEG_REG |
CATEG_REG |
texto | Categoria do registro (só em: cad_adm_cart_pf, cad_adm_cart_pj) |
— | todo |
DENOM_SOCIAL |
DENOM_SOCIAL |
texto | Denominação Social (só em: cad_adm_cart_pj) |
— | todo |
DENOM_COMERC |
DENOM_COMERC |
texto | Denominação Comercial (só em: cad_adm_cart_pj) |
— | todo |
SUBCATEG_REG |
SUBCATEG_REG |
texto | Subcategoria do registro (só em: cad_adm_cart_pj) |
— | todo |
CONTROLE_ACIONARIO |
CONTROLE_ACIONARIO |
texto | Controle Acionário (só em: cad_adm_cart_pj) |
— | todo |
TP_ENDER |
TP_ENDER |
texto | Tipo de endereço (só em: cad_adm_cart_pj) |
— | todo |
LOGRADOURO |
LOGRADOURO |
texto | Logradouro (só em: cad_adm_cart_pj) |
— | todo |
COMPL |
COMPL |
texto | Complemento de endereço (só em: cad_adm_cart_pj) |
— | todo |
BAIRRO |
BAIRRO |
texto | Bairro (só em: cad_adm_cart_pj) |
— | todo |
MUN |
MUN |
texto | Nome do município (só em: cad_adm_cart_pj) |
— | todo |
UF |
UF |
texto | Unidade da Federação (só em: cad_adm_cart_pj) |
— | todo |
CEP |
CEP |
inteiro | CEP (só em: cad_adm_cart_pj) |
código ou número de identificação (sem unidade) | todo |
DDD |
DDD |
inteiro | Código DDD (só em: cad_adm_cart_pj) |
código ou número de identificação (sem unidade) | todo |
TEL |
TEL |
inteiro | Telefone (só em: cad_adm_cart_pj) |
código ou número de identificação (sem unidade) | todo |
VL_PATRIM_LIQ |
VL_PATRIM_LIQ |
decimal | Valor do patrimônio líquido (só em: cad_adm_cart_pj) |
moeda (ver ESCALA_MOEDA, quando houver; senão R$) | todo |
DT_PATRIM_LIQ |
DT_PATRIM_LIQ |
texto | Data do patrimônio líquido (só em: cad_adm_cart_pj) |
— | todo |
EMAIL |
EMAIL |
texto | Endereço de e-mail (só em: cad_adm_cart_pj) |
— | todo |
SITE_ADMIN |
SITE_ADMIN |
texto | Site do administrador (só em: cad_adm_cart_pj) |
— | todo |
RESP |
RESP |
texto | Nome do Responsável (só em: cad_adm_cart_resp) |
— | todo |
TP_RESP |
TP_RESP |
texto | Tipo de responsável (só em: cad_adm_cart_resp) |
— | todo |
SOCIOS |
SOCIOS |
texto | Domínio : (só em: cad_adm_cart_socios) |
— | todo |
No lake¶
- Dataset
cvm/adm-cart-cad, sem partição; 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 (
..._AAAAou..._AAAA-MM); arquivos cujo nome traz o mês sem hífen (..._AAAAMM) ficam sem partiçãoano/mes.
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.
- Dados de contato e identificação. Há colunas de endereço, telefone, e-mail ou CPF (
LOGRADOURO, ...); parte pode ser de pessoa física. O fetcher e o lake preservam o que a fonte publica. - CEP, DDD e telefones viram número. O conversor infere o tipo de cada CSV e lê
CEP,DDD,TELcomo inteiro, o que descarta zeros à esquerda (CEP de 8 dígitos começado por zero, por exemplo); reconstrua o texto comlpadquando precisar do código.
Exemplos¶
Linhas por arquivo de origem (tabela) no dataset.
import duckdb
duckdb.sql("""
SELECT filename, count(*) AS linhas
FROM read_parquet('lake/cvm/adm-cart-cad/**/*.parquet', hive_partitioning = true, union_by_name = true, filename = true)
GROUP BY 1
ORDER BY 1
""").show()
Referências¶
- Conjunto no portal de dados abertos da CVM: https://dados.cvm.gov.br/dataset/adm_cart-cad
- Dados e dicionário (
META): https://dados.cvm.gov.br/dados/ADM_CART/CAD/