Metodologia

O pipeline é mensal

A fonte é mensal — o Informe Diário de um mês só sai no mês seguinte —, então o pipeline acompanha essa cadência: um workflow do GitHub Actions roda no dia 8 de cada mês, às 07h30 UTC. Ele sonda a CVM, baixa o que houver de novo, reprocessa em incremental, abre todos os arquivos gerados com o mesmo leitor que o app usa e só então publica. Sem competência nova, o diff é vazio e nada é publicado.

Os conjuntos, na origem

• Cadastro de fundos e classes (ICVM 175)
• Informe Diário dos fundos de investimento
• Composição e Diversificação das Carteiras (CDA)
• Fundos estruturados — Medidas (FIDC, FII, FIP, FIAGRO)
• CDI — série 12 do SGS/BCB

As quatro métricas proprietárias

São o que separa um observatório de um painel de totais: quatro razões entre números públicos que respondem a "esta casa está ganhando ou perdendo a disputa?". As quatro são calculadas em um lugar do código e reaproveitadas por todos os módulos que as exibem — o mesmo CNPJ mostra o mesmo P1 no M1, no M2 e no M3.

P1 · Momentum Competitivo

Share de captação bruta 12m menos share de AUM ex-FIC: acima de zero, a casa capta acima do próprio tamanho. (maior é melhor)

P2 · Taxa de Resgate

Resgates de 12 meses sobre o AUM ex-FIC médio do período — a sangria relativa do estoque. (menor é melhor — a cor segue isto, não o sinal)

P3 · Captação Líquida Relativa

Captação líquida de 12 meses sobre o AUM ex-FIC médio do período — crescimento orgânico normalizado pelo tamanho. (maior é melhor)

P4 · Prêmio sobre o CDI Ponderado (12m)

Mediana ponderada por PL do %CDI dos ÚLTIMOS 12 MESES das classes elegíveis da gestora, menos 100 — o que a casa entregou acima do CDI, no último ano, no que tem de relevante. (maior é melhor)

P1 usa captação bruta, não líquida. Captação líquida pode ser negativa, e participação negativa sobre um total de sinais mistos não é fatia de mercado. P2 e P3 dividem pelo AUM ex-FIC médio dos 12 meses, não pela posição inicial: a posição inicial premia quem encolheu. P4 é prêmio, não share — é a mediana ponderada por PL do %CDI 12m das classes elegíveis, menos 100, e por isso vem em pontos percentuais.

Os outros indicadores

AUM ex-FIC (o padrão do app)

Soma do PL das classes que não são FIC/espelho. É o padrão porque somar o PL de todas as classes conta duas vezes o mesmo dinheiro: o feeder investe no master, e os dois têm PL.

PL bruto (com FIC)

Soma do PL de todas as classes, inclusive as que investem em cotas. Existe como métrica alternativa e nunca é o padrão de um ranking.

Captação líquida

Captação menos resgates no período. Pode ser negativa — e quando é, o sinal aparece.

Retorno acumulado

Composição dos retornos mensais de cota de fim de mês: ∏(1 + rₘ) − 1. Nunca soma de retornos.

Volatilidade 12m anualizada

Desvio-padrão dos 12 retornos mensais, multiplicado por √12.

%CDI

(1 + retorno) ÷ (1 + CDI) × 100 na mesma janela. Não é retorno ÷ CDI: com juros compostos as duas fórmulas divergem, e a razão simples infla quem rendeu pouco.

Drawdown 36m

Maior queda percentual do pico até o vale seguinte na série de cota dos últimos 36 meses. Sai negativo ou zero.

CR5 / CR10 e HHI

Participação somada das 5 e das 10 maiores gestoras por AUM ex-FIC; HHI é a soma dos quadrados das participações em pontos percentuais (escala 0–10.000). As faixas de referência exibidas são as do DOJ/FTC.

Elegibilidade de performance

Uma classe entra nas telas de retorno se tiver PL ≥ R$ 100,0 mi, ao menos 100 cotistas, não for exclusiva, tiver ao menos 12 meses de cota e não tiver evento de cota anômalo (retorno mensal com módulo acima de 50%). Os critérios aparecem na tela do M4, com a contagem do que ficou de fora.

Materialidade

Gestoras com AUM ex-FIC na última competência abaixo de R$ 100,0 mi não entram em ranking — a razão de duas quantias minúsculas produz percentuais espetaculares e sem significado. No M6, o corte análogo é exposição por emissor abaixo de R$ 50,0 mi.

Convenções

• Competência é o mês da posição, no formato AAAAMM, derivada da data do documento. O app não tem grão diário: o diário existe dentro do ETL e sai dele agregado.
• Janela de 12 meses é sempre fechada e termina na última competência disponível.
• Estoque × fluxo. PL, cotistas e nº de classes são posição de fim de mês e nunca são acumulados. Captação, resgate e captação líquida são fluxo e podem ser somados na janela. O seletor de janela só aparece onde faz sentido.
• Sinal de menos é o U+2212 (−), não o hífen. Um zero arredondado sai sem sinal: −0,04% imprime 0,0%, sem cor de queda.
• Travessão (—) é ausência de número, nunca zero. Divisor nulo ou janela sem meses na série produzem travessão, não R$ 0.
• p.p. é ponto percentual: diferença entre dois percentuais. Usado em P1, P4 e em toda variação de participação.
• Valores em reais correntes, sem deflacionamento e sem conversão de moeda. Formatação em pt-BR.
• "Demais" é uma categoria de verdade, não um resto de corte: ela nunca é omitida de um gráfico, porque sem ela a soma das partes deixa de ser o total.

Os dois relógios

O app tem duas datas de referência distintas, e nenhuma tela finge que são a mesma:

• Relógio do Informe Diário — PL, captação, cotistas, cota. Defasagem de dias. É o relógio de M1, M2, M3, M4, M7 e M8.
• Relógio do CDA — composição de carteira e exposição por emissor. Defasagem de ~3 meses, mais posições confidenciais. É o relógio de M5 e M6, que exibem a própria competência e a cobertura no cabeçalho, em vez da data do Informe.

Os três grupos, e o que o app alcança de cada um

O Mapa do Mercado mostra a soma dos três com a aritmética aberta e a dupla contagem medida.

Fora do perímetro

• Carteiras administradas — só a ANBIMA publica o agregado, e o portal dela proíbe coleta automatizada. Entra por arquivo manual com fonte e data declaradas; sem o arquivo, o M9 exibe "não capturado" com o motivo, e nunca zero.
• Perfil Mensal e Balancete da CVM — trazem taxas, rentabilidade declarada e contas patrimoniais. Ficam para a v2.
• Previdência fechada (EFPC / PREVIC) — outro regulador, outro conjunto de dados. É o objeto do observatório irmão.
• Corretagem e negociação em bolsa — o app olha para quem gere recursos, não para quem intermedia ordens.
• Fundos offshore — fora do registro da CVM.

A sobreposição com o Observatório da Previdência Privada é proposital. Um mesmo real pode aparecer nos dois: aqui pela lente da gestora que o administra, lá pela lente do produto previdenciário que o distribui. São duas perguntas diferentes sobre o mesmo dinheiro, e somar os dois apps produziria um número sem sentido.

As limitações declaradas

• AUM ex-FIC é aproximação. A flag de FIC do cadastro não elimina toda cadeia fundo-de-fundo — um fundo que investe em cotas sem estar marcado como FIC continua contado duas vezes. O manifesto registra quanto PL a flag captura.
• O CDA tem posições temporariamente confidenciais e defasagem de ~3 meses. A cobertura exibida em M5 e M6 diz quanto do PL do mercado o retrato alcança.
• Volatilidade de retornos mensais anualizada (×√12) subestima a de retornos diários. É o que o grão mensal permite; o número é comparável entre classes, não com uma vol diária de outra fonte.
• Performance sem ajuste a risco além de volatilidade e drawdown. Não há Sharpe, alfa, nem atribuição. Nada aqui é recomendação de investimento.
• Valores nominais, sem deflacionamento. Uma série de dez anos em reais correntes cresce também por inflação.
• Revisão retroativa. Reenvios de Informe Diário e liberações de confidencialidade do CDA mudam números já publicados.
• A fonte tem registros errados, e o app não os esconde. O CDA de mar/2024 declara R$ 368 trilhões de PL para um único fundo — mais que o PIB mundial. O ETL trata a cobertura como razão por classe, limitada a 100% por construção, então um registro assim não contamina o indicador; e o manifesto conta, competência a competência, quantas classes têm PL no CDA acima do PL do Informe Diário. Essa contagem existe para que a inconsistência seja visível, não para escondê-la.
• Classes sem gestor identificado no cadastro entram nos totais de mercado sob a chave SEM_GESTOR e ficam fora dos rankings — um ranking com uma linha chamada "não identificado" no meio não é ranking de gestora. O manifesto diz quanto isso pesa.