📊 CVM Fundos de Investimento — Brazilian Investment Funds API

Fundos de investimento brasileiros com dados oficiais da CVM, baixados a cada execução: cadastro (Resolução CVM 175), cota diária, PL, captação e cotistas, carteira completa, FIIs com ticker e dividend yield, e rankings.

🇺🇸 English version below

---

🇧🇷 Português

O que tem

• ~37 mil classes de fundos no cadastro RCVM 175 (FI, FII, ETF, FIDC, FIP, FIAGRO), com gestor, administrador, classe ANBIMA, público-alvo e PL. Fundos cancelados desde 1994 com situation: "ALL" ou "CANCELADA".
• Cota diária de FIs desde 2021: cota, PL, captação, resgate, cotistas e variação diária. Classes com subclasses vêm com uma linha por subclasse (subclass_id).
• Informe mensal de FII: cota patrimonial, PL, cotistas, rentabilidade, dividend yield, amortização e taxa de administração, com ticker B3 (vem do ISIN oficial).
• Carteira (CDA): todas as posições do fundo (títulos públicos, ações, cotas de fundos, crédito privado, exterior...), com % do PL.
• Rankings de FI (PL, captação, rentabilidade, cotistas) e FII (PL, rentabilidade, DY, cotistas).

Modos

{ "mode": "search_funds", "name_contains": "verde", "fund_type": "FI" }
{ "mode": "search_funds", "name_contains": "HGLG11" }
{ "mode": "fund_daily", "cnpj": "07.455.507/0001-89", "from_date": "2026-01-01" }
{ "mode": "fund_daily", "cnpj": "97.521.225/0001-25", "from_date": "2025-01-01" }
{ "mode": "fund_portfolio", "cnpj": "07.455.507/0001-89" }
{ "mode": "ranking", "ranking_metric": "rentabilidade", "class_anbima": "Ações", "investor_type": "Público Geral" }
{ "mode": "ranking", "fund_type": "FII", "ranking_metric": "dividend_yield" }
{ "mode": "manager_funds", "manager_cnpj": "19.749.539/0001-76" }

Detalhes importantes

• CNPJ da classe × do fundo: desde a RCVM 175, quem reporta é a classe. Pode passar qualquer um dos dois; o actor resolve.
• Prazos da CVM: a cota diária sai com poucos dias de atraso. A carteira (CDA) sai com cerca de 1 a 3 meses de atraso e pode omitir posições confidenciais (aparecem como "Aplicações confidenciais"). Por padrão, o actor busca o mês mais recente que tenha o fundo.
• Ranking:
  • Por padrão ignora fundos com PL abaixo de R$ 10 milhões (min_net_worth).
  • A rentabilidade compara a cota do 1º dia útil do período com a do último dia. Fundos que não existiam no início ficam de fora, e variações absurdas (acima de 1000%) são descartadas.
  • O ranking de PL pode trazer pares master/feeder (o mesmo dinheiro em dois CNPJs). Use exclude_exclusive e investor_type pra filtrar.
• Sem resultado = sem cobrança: a run falha com a explicação no log em vez de devolver um dataset vazio.

---

🇺🇸 English

Official CVM (Brazil's SEC) fund data, fetched live on every run:

• Registry of ~37k fund classes (Resolution 175).
• Daily NAV per share, AUM, flows and investor count for mutual funds since 2021.
• Monthly REIT (FII) reports with B3 ticker, dividend yield and returns.
• Full portfolio holdings (CDA).
• Rankings by AUM, net flows, returns, investor count and dividend yield.

The modes and examples are listed above. Pass either the class or the fund CNPJ. Runs with no results fail with an explanation instead of charging for an empty dataset.

Source: CVM Open Data.