B3 Boletim Diário - Participação dos Investidores

Extraia os dados de Participação dos Investidores do Boletim Diário da B3 publicados no Boletim Diário da B3. Obtenha dados estruturados sobre a contribuição de cada perfil de investidor no volume total de negociações da bolsa.

O que este Ator faz?

Este Ator acessa o Boletim Diário da B3 diretamente, no caminho Renda Variável > Indicadores e Informativos > Participação dos Investidores, e extrai todas as linhas da tabela de participação dos investidores no volume de negociações para cada data solicitada.

• Extrai contribuição de diferentes perfis de investidores no volume total de negociações da B3 para qualquer data de referência (últimos 20 dias)
• Obtém dados de compras e vendas por perfil, incluindo volumes em R$ mil e participação percentual
• Segmenta investidores por tipo: Institucionais, Instituições Financeiras, Investidor Estrangeiro, Investidores Individuais e Outros
• Exporte os dados em JSON, CSV, Excel, HTML ou XML via console do Apify ou SDKs (Python, Node.js)

A data de referência padrão é o último dia útil, então basta iniciar o Ator sem configurar nada para obter os dados mais recentes disponíveis.

Quais dados posso extrair?

Cada linha do dataset representa um perfil de investidor com todas as métricas de volume publicadas pela B3:

Campo	Descrição
Tipos de Investidores	Perfil do investidor (Institucionais, Instituições Financeiras, Investidor Estrangeiro, Investidores Individuais, Outros)
Compras (R$ mil)	Volume de compras em milhares de reais por tipo de investidor
Participação Compras (%)	Participação do investidor no volume total de compras
Vendas (R$ mil)	Volume de vendas em milhares de reais por tipo de investidor
Participação Vendas (%)	Participação do investidor no volume total de vendas

Por que usar este Ator?

A tabela de volume por investidores é um dos dados mais importantes para entender a estrutura e o comportamento do mercado brasileiro. Este Ator automatiza a extração e estruturação desses dados para:

• Análise de perfil de investidores - Entenda a participação relativa de investidores institucionais, estrangeiros e individuais no mercado, essencial para análises de estrutura de mercado
• Monitoramento de fluxo de capital - Acompanhe a evolução dos volumes de compra e venda por tipo de investidor, identificando tendências de entrada ou saída de capital
• Research quantitativo - Alimente modelos quantitativos com séries temporais de volume por investidor, participações percentuais e correlações entre perfis
• Due diligence para fundos de investimento - Verifique o perfil de liquidez e a participação relativa de diferentes tipos de investidor para análise de risco e oportunidades
• Relatórios de governança e compliance - Gere relatórios automatizados com dados oficiais da B3 para demonstrar transparência e conformidade
• Scheduling automático - Configure o Ator para rodar diariamente no Apify e manter uma base de dados histórica atualizada

Como usar

O Actor aceita o seguinte parâmetro de entrada:

• Data de Referência (referenceDate): Data que identifica as informações do arquivo. No site Boletim Diário da B3, equivale ao campo 'Data Inicial'. O formato deve ser AAAA-MM-DD (ex: 2024-01-15). Se não informada, o Actor utiliza automaticamente o último dia útil. A data deve ser um dia útil válido, não pode ser futura e não pode ser mais antiga que 20 dias.

Observações sobre a data de referência

• Se deixar em branco ou null, o Ator usará automaticamente o último dia útil antes da data atual
• A data não pode estar no futuro
• A data não pode ser anterior a 20 dias atrás
• Datas que não são dias úteis (sábados, domingos, feriados) não possuem dados disponíveis

Saída (Output)

Os resultados são salvos no dataset do Ator, acessível na aba Storage. Cada registro do dataset representa uma linha da tabela oficial da B3 com todos os campos de volume por investidor.

Exemplo de saída (JSON)

{
  "tiposDeInvestidores": "INVESTIDOR ESTRANGEIRO",
  "compras": 344768599,
  "participacaoCompras": 28.87,
  "vendas": 352856259,
  "participacaoVendas": 29.55
}

Você pode baixar o dataset em vários formatos: JSON, JSONL, CSV, Excel, HTML ou XML.

Dicas e opções avançadas

• Execução diária automatizada: Configure um Schedule no Apify para rodar o Ator todos os dias úteis automaticamente. Assim você acumula uma série temporal completa de volume por investidores sem precisar executar manualmente
• Combine com outros Atores do projeto para extrair dados complementares do Boletim Diário da B3, como posições em aberto de derivativos ou outros relatórios
• Filtros no dataset: Use os filtros da aba Output no Apify Console para filtrar por tipo de investidor
• Exportação em CSV/Excel: Ideal para análises no Excel, Power BI, ou ferramentas de BI

Perguntas Frequentes (FAQ)

Por que algumas datas não retornam dados?

O Boletim Diário da B3 publica dados apenas para dias úteis. Se a data de referência for um sábado, domingo ou feriado nacional, não há dados disponíveis e o Ator falhará com uma mensagem de erro. Tente usar a data do dia útil mais próximo.

O Ator funciona para dados antigos?

Sim, mas a data de referência deve estar dentro dos últimos 20 dias. Esta é uma limitação da API da B3, que não disponibiliza dados mais antigos através desta interface. Para séries históricas completas, é necessário acumular execuções diárias ao longo do tempo usando scheduling.

É legal extrair estes dados?

Sim. Os dados do Boletim Diário da B3 são informações públicas publicadas pela própria bolsa de valores. A B3 incentiva o acesso automatizado a esses dados para transparência do mercado. Não há restrições de uso para estes dados públicos.