📊 CVM Fundos de Investimento

API completa de fundos de investimento brasileiros (FI, FII, ETF) com dados oficiais da CVM, enriquecidos com tickers da B3.

🇺🇸 English version below ⬇️

---

🇧🇷 Visão Geral

Acesso unificado a 130.000+ fundos brasileiros — cadastro, cotas diárias, composição de carteira, ranking por PL/captação/rentabilidade e busca por gestor/administrador. Dados sempre frescos, baixados direto da CVM a cada execução.

O que tem:

• ✅ 130k+ fundos cadastrados (RCVM 175 + legado)
• ✅ FI, FII, ETF, FIDC, FIP, FIAGRO — todos os tipos
• ✅ Tickers B3 automáticos pra FIIs (HGLG11, KNRI11, MXRF11...)
• ✅ Histórico desde 2020 — cotas, PL, captação, cotistas
• ✅ Composição de carteira (CDA) — 8 blocos de ativos
• ✅ Ranking nacional por patrimônio, captação, rentabilidade
• ✅ Sem autenticação na CVM, dados 100% públicos

Casos de uso:

• 📈 Plataformas de investimento (mostrar info de fundos)
• 📊 Dashboards de análise (ranking, comparação)
• 🔍 Compliance/KYC (verificar gestor/administrador)
• 📰 Reportagens financeiras (top fundos por categoria)
• 🤖 Automação de relatórios mensais

---

---

🚀 Modos de Operação

O actor tem 5 modos, escolhidos via parâmetro mode:

1️⃣ search_funds — Busca de fundos no cadastro

Busca por nome, ticker, CNPJ, tipo, classe, situação ou administrador.

{
  "mode": "search_funds",
  "name_contains": "VERDE",
  "fund_type": "FI",
  "situation": "EM FUNCIONAMENTO NORMAL",
  "limit": 50
}

Resposta (exemplo simplificado):

[
  {
    "cnpj": "44803273000140",
    "cnpj_formatted": "44.803.273/0001-40",
    "name": "ACCESS VERDE FIE PREVIDÊNCIA FUNDO DE INVESTIMENTO MULTIMERCADO",
    "fund_type": "FI",
    "situation": "EM FUNCIONAMENTO NORMAL",
    "registration_date": "2022-05-03",
    "manager_name": "BTG PACTUAL GESTÃO E CONSULTORIA",
    "administrator_name": "BTG PACTUAL SERVIÇOS FINANCEIROS S/A DTVM"
  }
]

2️⃣ fund_daily — Informe diário (cota, PL, captação)

Histórico diário de um fundo (FI/ETF) ou mensal (FII).

{
  "mode": "fund_daily",
  "cnpj": "07.096.546/0001-37",
  "from_date": "2024-01-01",
  "to_date": "2024-12-31"
}

Resposta:

[
  {
    "cnpj": "07096546000137",
    "date": "2024-01-02",
    "share_value": 53.842966,
    "net_worth": 194934474.96,
    "subscription": 266530.75,
    "redemption": 7958900.78,
    "shareholders_count": 253,
    "fund_name": "ITAÚ CAIXA AÇÕES FUNDO DE INVESTIMENTO FINANCEIRO"
  }
]

3️⃣ fund_portfolio — Composição de carteira (CDA)

Lista todos os ativos da carteira de um fundo num mês de referência.

{
  "mode": "fund_portfolio",
  "cnpj": "07.096.546/0001-37",
  "month": "2024-09"
}

Resposta:

[
  {
    "cnpj": "07096546000137",
    "asset_type": "Investimentos diversos",
    "market_value": 25527984.76,
    "pct_of_portfolio": 10.59,
    "due_date": "2026-08-15",
    "block_number": 1,
    "reference_month": "2024-09"
  }
]

4️⃣ ranking — Top fundos por métrica

Ranking nacional por patrimônio líquido, captação líquida, rentabilidade ou número de cotistas.

{
  "mode": "ranking",
  "ranking_metric": "patrimonio_liquido",
  "ranking_period": "2024-12_2024-12",
  "fund_type": "FI",
  "limit": 10
}

Resposta:

[
  {
    "rank": 1,
    "cnpj": "07593972000186",
    "name": "BRASILPREV TOP TPF FUNDO DE INVESTIMENTO FINANCEIRO RENDA FIXA",
    "net_worth": 206564420627.40,
    "metric": "patrimonio_liquido",
    "last_date": "2024-12-31"
  }
]

Métricas suportadas: patrimonio_liquido | captacao_liquida | rentabilidade | n_cotistas

5️⃣ manager_funds — Fundos de um gestor/administrador

Lista todos os fundos de um gestor ou administrador (busca por CNPJ).

{
  "mode": "manager_funds",
  "manager_cnpj": "59.281.253/0001-23",
  "fund_type": "FI",
  "limit": 100
}

Resposta: lista de fundos com mesmo formato do search_funds.

---

📋 Parâmetros completos

Parâmetro	Tipo	Default	Descrição
mode	string	search_funds	Modo de operação (5 valores)
cnpj	string	—	CNPJ do fundo (com ou sem formatação)
manager_cnpj	string	—	CNPJ do gestor/administrador
name_contains	string	—	Filtro por nome ou ticker (HGLG, KNRI, etc)
fund_type	string	ALL	FI, FII, ETF ou ALL
class_anbima	string	—	Filtro por classe ANBIMA/CVM
situation	string	EM FUNCIONAMENTO NORMAL	Situação do fundo
from_date	string	—	Data inicial (YYYY-MM-DD)
to_date	string	hoje	Data final (YYYY-MM-DD)
month	string	últimos 3m	Mês de referência (YYYY-MM)
ranking_metric	string	patrimonio_liquido	Métrica do ranking
ranking_period	string	últimos 12m	Período (YYYY-MM_YYYY-MM)
limit	integer	10000	Máx. records (até 100000)

---

🔧 Como rodar

Via Apify Console

1. Cole o JSON de input no editor
2. Clique em "Start"
3. Resultado disponível no Dataset

Via API

curl -X POST \
  "https://api.apify.com/v2/acts/jenko_systems~cvm-fundos-investimento/run-sync-get-dataset-items?token=SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "search_funds",
    "name_contains": "HGLG",
    "fund_type": "FII",
    "limit": 10
  }'

Via Apify SDK (Python)

from apify_client import ApifyClient

client = ApifyClient("SEU_TOKEN")

run = client.actor("jenko_systems/cvm-fundos-investimento").call(run_input={
    "mode": "ranking",
    "ranking_metric": "patrimonio_liquido",
    "fund_type": "FI",
    "limit": 50
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

---

⚠️ Notas importantes

• Tickers FII: cobertura ~94% dos FIIs ativos. Em casos raros (fundo trocou de gestor) o ticker pode estar associado ao nome anterior. Use CNPJ pra busca infalível.
• Histórico: dados disponíveis desde 2020-01-01. Anos anteriores não são suportados.
• Composição (CDA): defasagem regulatória de ~3 meses. Pra mês corrente, dado pode não estar disponível.
• CDA de FII: ainda não implementada. Use fund_daily pra dados mensais de FII.
• Tempo de resposta: 30-90s típico (download de arquivos grandes da CVM). Cache interno acelera execuções subsequentes.

---

📚 Fontes de dados

• CVM Dados Abertos — https://dados.cvm.gov.br/dataset/fi-cad
• Resolução CVM 175 — cadastro novo (registro_fundo.csv)
• Cadastro legado — fundos não adaptados RCVM 175
• fiis.com.br — mapeamento ticker B3 ↔ FII

---

---

🇺🇸 English Version

Overview

Unified API for 130,000+ Brazilian investment funds (FI = open-ended funds, FII = real estate funds, ETF) with official data from CVM (Brazilian SEC equivalent), enriched with B3 (Brazilian stock exchange) tickers.

What you get:

• ✅ 130k+ funds registered (post-2024 RCVM 175 + legacy)
• ✅ FI, FII, ETF, FIDC, FIP, FIAGRO — all fund types
• ✅ B3 tickers auto-matched for FIIs (HGLG11, KNRI11, MXRF11...)
• ✅ History since 2020 — share value, NAV, inflows, holders count
• ✅ Portfolio composition (CDA) — 8 asset blocks
• ✅ National rankings by NAV, inflows, returns
• ✅ No authentication — CVM data is fully public

5 Operation Modes

Mode	Description
search_funds	Search by name, ticker, CNPJ, type, class
fund_daily	Daily report (share value, NAV, flows, holders)
fund_portfolio	Asset composition (CDA) for a reference month
ranking	Top funds by metric (NAV, inflows, returns, holders)
manager_funds	All funds managed/administered by a given CNPJ

Quick Example (cURL)

curl -X POST \
  "https://api.apify.com/v2/acts/jenko_systems~cvm-fundos-investimento/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "search_funds",
    "name_contains": "HGLG",
    "fund_type": "FII"
  }'

Important Notes

• FII tickers: ~94% coverage. Rare cases of fund manager change may misassociate ticker. Use CNPJ for reliable lookups.
• History: data available since 2020-01-01. Earlier years not supported.
• Portfolio (CDA): ~3 months regulatory delay. Current month data may not be available.
• FII portfolio: not implemented yet. Use fund_daily for FII monthly data.

Data Sources

• CVM Open Data Portal — https://dados.cvm.gov.br/dataset/fi-cad
• B3 Listed Funds (via fiis.com.br) — for FII ticker mapping

---

Built with 🇧🇷 by Jenko Systems — affordable, unauthenticated APIs for Brazilian public data.