Skip to content

FIDC Tabela X.1 — Número de cotistas por classe/série

Stable ID: cvm.fundos.fidc_inf_mensal/tab_x_1

Contexto semântico

Nome: FIDC Tabela X.1 — Número de cotistas por classe/série

O que contém: Número de cotistas de cada classe/série do FIDC.

Por que consultar: Use para analisar a distribuição da base de investidores entre classes e séries.

Escopo e limitações: A unidade é classe/série quando presente; não agregue classes sem preservar essa dimensão.

Aliases e nomes oficiais: Tabela X.1, tab_X_1, tab_x_1

Evidências:

  • catalogo/cvm.yml — fidc_inf_mensal/tab_x_1
  • https://dados.cvm.gov.br/dataset/fidc-doc-inf_mensal
  • https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/META/meta_inf_mensal_fidc_txt.zip

Comece aqui: guia de acesso aos dados

Readiness (label, not a promise): declared:tolerada/tolerada_com_residuo/verificada · materialized:none · queryable:unknown

Declared (catalog YAML)

field value
dataset fidc_inf_mensal
parte corrente layout zip_multi_tabela
parte corrente vigencia ate=(unknown — not declared anywhere), de=202501
chave (parte corrente) tp_fundo_classe, cnpj_fundo_classe, dt_comptc, tab_x_classe_serie, id_subclasse
chave_status (parte corrente, declared) tolerada
max_linhas_excedentes (parte corrente) 5
politica_dedup_silver (parte corrente) keep_first
source URL (parte corrente) https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/DADOS/inf_mensal_fidc_{aaaamm}.zip
parte historico_2013_2018 layout zip_multi_tabela
parte historico_2013_2018 vigencia ate=201812, de=(unknown — not declared anywhere)
chave (parte historico_2013_2018) cnpj_fundo, dt_comptc, tab_x_classe_serie
chave_status (parte historico_2013_2018, declared) tolerada_com_residuo
max_linhas_excedentes (parte historico_2013_2018) 15
max_grupos_residuais (parte historico_2013_2018) 5
politica_dedup_silver (parte historico_2013_2018) keep_first
source URL (parte historico_2013_2018) https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/DADOS/HIST/inf_mensal_fidc_{aaaa}.zip
parte historico_2019_2020 layout zip_multi_tabela
parte historico_2019_2020 vigencia ate=202010, de=201901
chave (parte historico_2019_2020) cnpj_fundo, dt_comptc, tab_x_classe_serie
chave_status (parte historico_2019_2020, declared) tolerada_com_residuo
max_linhas_excedentes (parte historico_2019_2020) 15
max_grupos_residuais (parte historico_2019_2020) 5
politica_dedup_silver (parte historico_2019_2020) keep_first
source URL (parte historico_2019_2020) https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/DADOS/HIST/inf_mensal_fidc_{aaaa}.zip
parte historico_2020_2022 layout zip_multi_tabela
parte historico_2020_2022 vigencia ate=202212, de=202011
chave (parte historico_2020_2022) cnpj_fundo, dt_comptc, tab_x_classe_serie
chave_status (parte historico_2020_2022, declared) tolerada_com_residuo
max_linhas_excedentes (parte historico_2020_2022) 15
max_grupos_residuais (parte historico_2020_2022) 5
politica_dedup_silver (parte historico_2020_2022) keep_first
source URL (parte historico_2020_2022) https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/DADOS/HIST/inf_mensal_fidc_{aaaa}.zip
parte historico_2023_2024_early layout zip_multi_tabela
parte historico_2023_2024_early vigencia ate=202309, de=202301
chave (parte historico_2023_2024_early) cnpj_fundo, dt_comptc, tab_x_classe_serie
chave_status (parte historico_2023_2024_early, declared) verificada
source URL (parte historico_2023_2024_early) https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/DADOS/HIST/inf_mensal_fidc_{aaaa}.zip
parte historico_2023_2024 layout zip_multi_tabela
parte historico_2023_2024 vigencia ate=202412, de=202310
chave (parte historico_2023_2024) tp_fundo_classe, cnpj_fundo_classe, dt_comptc, tab_x_classe_serie, id_subclasse
chave_status (parte historico_2023_2024, declared) tolerada_com_residuo
max_linhas_excedentes (parte historico_2023_2024) 100
max_grupos_residuais (parte historico_2023_2024) 50
politica_dedup_silver (parte historico_2023_2024) keep_first
source URL (parte historico_2023_2024) https://dados.cvm.gov.br/dados/FIDC/DOC/INF_MENSAL/DADOS/HIST/inf_mensal_fidc_{aaaa}.zip

Divergent declarations: this table name is declared in more than one parte with differing chave/status — inspect each parte above.

Operator notes (verbatim from the catalog comments)

parte corrente

# id_subclasse ~49% NULL (5,420/11,067 em 202603, a mesma razao nas
# outras competencias) - whitelisted no gate de null-rate. Probe:
# excess_rows = 0.
# TOLERADA (re-medido 2026-09-08, zip atual 202509 no servidor):
# 3 excess (3 grupos byte-identicos). Demais meses 0. Cap 5.

parte historico_2013_2018

# TOLERADA_COM_RESIDUO (72 competencias): excess exato max 5/mes
# (201608), grupos residuais max 2/mes (201403, TAB_X_NR_COTST diverge).

parte historico_2023_2024

# TOLERADA_COM_RESIDUO (sweep completo 202310-202412, 15 meses):
# maximos em 202310 = 114 excess totais, 63 excess exatos e 46
# grupos residuais; os residuais variam somente TAB_X_NR_COTST.
# Caps 100/50. De 202406 em diante todos fecharam em 0.

Observed runs (from meta/runs manifests)

Last good run:

field value
timestamp 20260922T104932
outcome written
exit_code 0
rows_written 109791
source_sha256
manifest_path C:\Users\plini\Repos\ciano-lake\data\meta\runs\fidc_inf_mensal\20260922T104932.json
competencia (scoped) 202401

Latest failed attempt (kept distinct from the last good run):

field value
timestamp 20260922T030138
outcome error
exit_code 1
error tab_x_4: Quality check failed: [PASS] row_count: 25,339 rows (validates > 0)
[PASS] null_rate_tp_fundo_classe: tp_fundo_classe: 0/25,339 null/empty (0.00%)
[PASS] null_rate_cnpj_fundo_classe: cnpj_fundo_classe: 0/25,339 null/empty (0.00%)
[PASS] null_rate_dt_comptc: dt_comptc: 0/25,339 null/empty (0.00%)
[PASS] null_rate_tab_x_tp_oper: tab_x_tp_oper: 0/25,339 null/empty (0.00%)
[PASS] null_rate_tab_x_classe_serie: tab_x_classe_serie: 0/25,339 null/empty (0.00%)
[FAIL] uniqueness: chave_status 'tolerada_com_residuo' mas excess_rows (grupos exatos) 151 excede o cap max_linhas_excedentes=150 [tp_fundo_classe, cnpj_fundo_classe, dt_comptc, tab_x_tp_oper, tab_x_classe_serie] (25,339 total, 25,187 distinct)
manifest_path C:\Users\plini\Repos\ciano-lake\data\meta\runs\fidc_inf_mensal\20260922T030138.json
competencia (scoped) 202401

Observed residuals (tolerada_com_residuo evidence)

(none observed — either the table has no residual tolerance, or the coverage inventory has not run; absence is not proof of absence)

Materialized (coverage inventory, per environment)

(no coverage inventory available — run tools/coverage_inventory.py collect and pass the JSONL to the publisher; without it nothing is claimed about what physically exists)

Postgres-queryable

(unknown — publication state is a publisher fact, filled at publication time; it is never inferred from materialization)