# B3 - Boletim Diário - Participação dos Investidores (`serj_henrique/b3-boletim-diario-participacao-dos-investidores`) Actor 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. - **URL**: https://apify.com/serj\_henrique/b3-boletim-diario-participacao-dos-investidores.md - **Developed by:** [Sergio Henrique](https://apify.com/serj_henrique) (community) - **Categories:** Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.05 / actor start This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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](https://www.b3.com.br/pt_br/market-data-e-indices/servicos-de-dados/market-data/consultas/boletim-diario/boletim-diario-do-mercado). Obtenha dados estruturados sobre a contribuição de cada perfil de investidor no volume total de negociações da bolsa. ![B3 - Boletim Diário - Participação dos Investidores](https://github.com/Serjii/apify-readme-images/blob/main/b3_boletim_diario_participacao_investidores.png?raw=true) ### O que este Ator faz? Este Ator acessa o [Boletim Diário da B3](https://www.b3.com.br/pt_br/market-data-e-indices/servicos-de-dados/market-data/consultas/boletim-diario/boletim-diario-do-mercado) 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) ```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. # Actor input Schema ## `reference_date` (type: `string`): Data que identifica as informações do arquivo. No site Boletim Diário da B3 equivale ao campo 'Data Inicial'. ## Actor input object example ```json {} ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("serj_henrique/b3-boletim-diario-participacao-dos-investidores").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("serj_henrique/b3-boletim-diario-participacao-dos-investidores").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call serj_henrique/b3-boletim-diario-participacao-dos-investidores --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=serj_henrique/b3-boletim-diario-participacao-dos-investidores", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "B3 - Boletim Diário - Participação dos Investidores", "description": "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.", "version": "0.0", "x-build-id": "isMM6MqpeCfGluvM5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/serj_henrique~b3-boletim-diario-participacao-dos-investidores/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-serj_henrique-b3-boletim-diario-participacao-dos-investidores", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/serj_henrique~b3-boletim-diario-participacao-dos-investidores/runs": { "post": { "operationId": "runs-sync-serj_henrique-b3-boletim-diario-participacao-dos-investidores", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/serj_henrique~b3-boletim-diario-participacao-dos-investidores/run-sync": { "post": { "operationId": "run-sync-serj_henrique-b3-boletim-diario-participacao-dos-investidores", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "reference_date": { "title": "Data de Referência", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Data que identifica as informações do arquivo. No site Boletim Diário da B3 equivale ao campo 'Data Inicial'." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```