Pular para o conteúdo principal
Cole no ChatGPT/Claude e peça para resumir/gerar SDK.

Fundos Listados

O módulo de Fundos Listados reúne endpoints para consultar informações de fundos negociados em bolsa, como FIIs, ETFs, FI-Infra, Fiagros, FIDCs e FIPs. Aqui você encontra dados cadastrais, relatórios financeiros, indicadores (fundamentalistas e de preço), proventos, eventos corporativos, número de cotistas, composição do portfólio e histórico de cotas.

Endpoints do módulo​

Tipos de fundos cobertos​

  • FIIs (Fundos Imobiliários)
    Fundos focados em ativos imobiliários (tijolo) ou crédito (papel/CRIs), com distribuição recorrente de rendimentos. Muito usados para geração de renda e exposição a segmentos imobiliários.

  • ETFs (Exchange Traded Funds)
    Fundos que replicam um índice (ações, renda fixa, commodities etc.) e são negociados em bolsa como uma ação. Geralmente têm alta liquidez e estrutura simples para exposição diversificada.

  • FI-Infra (Fundos de Infraestrutura)
    Fundos voltados a projetos e debêntures incentivadas de infraestrutura, com regras específicas e, em alguns casos, benefícios tributários conforme a estrutura do produto.

  • Fiagros (Fundos do Agronegócio)
    Fundos ligados ao agronegócio, frequentemente com exposição a crédito (ex.: CRA) e ativos relacionados ao setor, também com regras e estruturas típicas do segmento.

  • FIDCs (Fundos de Investimento em Direitos Creditórios)
    Fundos que investem majoritariamente em direitos creditórios (recebíveis), como duplicatas, financiamentos e recebíveis de cartão. As cotas listadas em bolsa dão exposição a crédito estruturado.

  • FIPs (Fundos de Investimento em Participações)
    Fundos que investem em participações societárias de companhias (private equity), geralmente com teses de longo prazo. Alguns FIPs possuem cotas negociadas em bolsa.

Identificadores: ticker, symbol e padrão de tickers​

Você pode consultar um fundo usando symbol ou ticker como identificador.

Na B3, a maior parte dos fundos listados (especialmente FIIs e muitos Fiagros) seguem o padrão de ticker terminando em 11 (ex.: HGLG11, KNRI11). Esse sufixo é um padrão comum do mercado para cotas de fundos negociadas em bolsa.

Variações de ticker (subscrições e eventos)​

Em alguns eventos de mercado, podem existir tickers temporários relacionados ao fundo, por exemplo:

  • Direitos de subscrição / recibos (durante ofertas, emissões e exercícios)
  • Classes/séries específicas (dependendo da estrutura do produto)
  • Códigos negociáveis durante eventos que não representam a cota “principal” do fundo

Essas variações podem aparecer com sufixos diferentes e normalmente são válidas por um período específico.

Recomendação: se seu caso de uso for acompanhar o “ativo principal” (a cota do fundo), prefira o ticker padrão do fundo (geralmente o que termina em 11) e trate variações como instrumentos eventuais do ciclo de oferta.

Casos de uso comuns​

  • Renda e distribuição: acompanhar proventos e histórico de distribuição.
  • Monitoramento de eventos: emissões, subscrições e mudanças relevantes.
  • Indicadores e comparações: ranking e triagem de fundos por métricas.
  • Análise fundamentalista: relatórios financeiros (ativo, passivo, resultado e distribuições) e composição do portfólio.
  • Base de cotistas e cotas emitidas: evolução do número de cotistas e histórico do total de cotas.
  • Dashboards e relatórios: construir telas e relatórios com dados padronizados.

Próximos passos​

  • Consulte os endpoints e recursos disponíveis em: Fundos Listados (rotas desta seção)
  • Se você já tem um ticker em mãos, comece pelo endpoint de detalhe do fundo e, em seguida, explore relatórios financeiros, indicadores, proventos e composição do portfólio.

Perguntas frequentes

Use o endpoint de Relatórios financeiros (/traded-funds/{fundIdentifier}/reports) com filtros como section (ASSETS, INCOME_STATEMENT etc.) e report_type (como MONTHLY_REPORT). Para evitar versões duplicadas do mesmo período, use latest_by_reference_date=true.
Indicadores fundamentalistas (/ratios) trazem as séries de indicadores do fundo agrupadas por ID e frequência. Indicadores de preço (/ratios/valuation) trazem os indicadores de valuation, como a relação entre preço de mercado e valor patrimonial da cota.
Use Número de cotistas (/unitholders) para a evolução da base de cotistas reportada nos informes oficiais, e Histórico de cotas (/units-history) para a série temporal do número total de cotas emitidas.