# B3 - Boletim Diário - Negócios Consolidados do Pregão (`serj_henrique/b3-boletim-diario-negocios-consolidados-do-pregao`) Actor Extraia os dados de Negócios Consolidados do Pregão de bolsa publicados no Boletim Diário da B3. Obtenha dados estruturados sobre preços, volumes, ofertas e ajustes de ações, opções e futuros negociados. - **URL**: https://apify.com/serj\_henrique/b3-boletim-diario-negocios-consolidados-do-pregao.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.10 / 1,000 results 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 - Renda Variável - Resumo de Ações - Negócios Consolidados do Pregão Extraia os dados de Negócios Consolidados do Pregão de bolsa 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 preços, volumes, ofertas e ajustes de opções e futuros negociados. ![B3 Boletim Diário - Renda Variável - Resumo de Ações - Negócios Consolidados do Pregão](https://github.com/Serjii/apify-readme-images/blob/main/b3_boletim_diario_negocios_consolidados_pregao.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 > Resumo de Ações > Negócios Consolidados do Pregão**, e extrai todas as linhas da tabela publicada pela B3 para cada data solicitada. - Extrai **negócios consolidados de bolsa** para qualquer data de referência (últimos 20 dias) - Obtém dados granulares por instrumento: preços, volumes, oscilações, ajustes e ofertas - Retorna resumo completo das operações: quantidade de negócios, contratos negociados e volume financeiro - 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 instrumento financeiro com todas as métricas de negociação publicadas pela B3: | Campo | Descrição | |---|---| | **Instrumento Financeiro** | Código que identifica um instrumento negociado ou registrado em bolsa de valores. | | **Código ISIN** | International Securities Identification Number – padronização internacional na codificação de títulos financeiros. | | **Segmento** | Nome do segmento de negociação. | | **Preço de Abertura** | Preço da primeira negociação do dia. | | **Preço Mínimo** | Menor preço negociado durante o dia. | | **Preço Máximo** | Maior preço negociado durante o dia. | | **Preço Médio** | Preço médio ponderado das negociações do dia. | | **Preço de Fechamento** | Preço da última negociação do dia. | | **Oscilação** | Variação percentual do preço de fechamento em relação ao dia anterior. | | **Ajuste** | Ajuste financeiro do contrato. | | **Ajuste de Referência** | Valor de referência para cálculo do ajuste. | | **Ajuste do Dia Anterior** | Ajuste financeiro do dia anterior. | | **Preço de Referência** | Preço de referência calculado pela B3. | | **Variação** | Variação percentual do preço de referência em relação ao dia anterior. | | **Valor do Ajuste por Contrato** | Valor em reais do ajuste financeiro por contrato. | | **Última Oferta de Compra** | Melhor preço de compra ofertado no pregão. | | **Última Oferta de Venda** | Melhor preço de venda ofertado no pregão. | | **Quantidade de Negócios** | Número total de operações realizadas. | | **Quantidade de Contratos** | Quantidade total de contratos negociados. | | **Volume Financeiro** | Valor total em reais das negociações do dia. | ### Por que usar este Ator? A tabela de negócios consolidados do pregão é essencial para quem opera ou monitora o mercado de derivativos da B3. Este Ator automatiza a extração e estruturação desses dados para: - **Análise de liquidez** - Acompanhe o volume financeiro e quantidade de contratos negociados para avaliar a liquidez de cada instrumento - **Monitoramento de preços** - Obtenha preços de abertura, fechamento, mínimo, máximo e médio para análise técnica e de mercado - **Research quantitativo** - Alimente modelos com séries temporais de preços, oscilações e volumes de negociação - **Due diligence para fundos** - Verifique a atividade de negociação de instrumentos específicos para análise de risco e compliance - **Ajustes financeiros** - Acompanhe ajustes e preços de referência essenciais para cálculo de mark-to-market de portfolios - **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 os seguintes parâmetros 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. - **Filtro por Instrumento (`filterInstrument`)**: *(Opcional)* Permite filtrar os resultados por um ou mais instrumentos financeiros. Aceita uma lista de códigos de instrumento (ex: `["SLCEA18", "BGIM26"]`). Se não informado ou vazio, o Actor retorna os dados de todos os instrumentos disponíveis na data de referência. #### Exemplo de uso do filtro Se você deseja extrair apenas os dados de negócios de instrumentos específicos, utilize o campo `filterInstrument`. O campo suporta múltiplos valores, retornando os dados de qualquer instrumento que corresponda a pelo menos um dos códigos informados (lógica OR). **Exemplo de configuração de entrada (JSON):** ```json { "referenceDate": "2024-01-15", "filterInstrument": ["SLCEA18", "BGIM26", "IBOVJ209"] } ```` Neste exemplo, o Actor buscará negócios consolidados apenas para os instrumentos SLCEA18, BGIM26 e IBOVJ209 referentes ao dia 15 de janeiro de 2024. **Dica:** O uso do filtro reduz o volume de dados processados e exportados, podendo acelerar a execução e diminuir o consumo de Compute Units, caso você não necessite dos dados de todos os instrumentos. #### 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 negociação. #### Exemplo de saída (JSON) ```json { "instrumentoFinanceiro": "SLCEB18", "codigoIsin": "BRSLCE3B04D5", "segmento": "EQUITY CALL", "precoDeAbertura": 0.8, "precoMinimo": 0.75, "precoMaximo": 0.8, "precoMedio": 0.75, "precoDeFechamento": 0.75, "oscilacao": 11.94, "ajuste": null, "ajusteDeReferencia": null, "ajusteDoDiaAnterior": null, "precoDeReferencia": 0.66, "variacao": null, "valorDoAjustePorContrato": null, "ultimaOfertaDeCompra": 0.7, "ultimaOfertaDeVenda": null, "quantidadeDeNegocios": 3, "quantidadeDeContratos": 1000, "volumeFinanceiro": 755.0 } ``` 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 negócios consolidados sem precisar executar manualmente - **Combine com outros Ators** do projeto para extrair dados complementares do Boletim Diário da B3, como posições em aberto ou relatórios de derivativos de moeda - **Filtros no dataset**: Use os filtros da aba Output no Apify Console para filtrar por instrumento, segmento ou data - **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. ##### Por que algumas colunas têm valor nulo? Para instrumentos que não foram negociados no pregão do dia, os campos de preço, volume e ofertas ficam nulos (`null`). O instrumento aparece na tabela porque existe na B3, mas não houve atividade de negociação naquela data. Instrumentos sem negociação são incluídos no dataset com campos de referência preenchidos (preço de referência, ajuste de referência, etc.). ##### 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 ## `referenceDate` (type: `string`): Data que identifica as informações do arquivo. No site Boletim Diário da B3 equivale ao campo 'Data Inicial'. ## `filterInstrument` (type: `array`): Filtro por instrumento financeiro. Exemplo: SLCEA18, BGIM26, PETRA18 ## 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-negocios-consolidados-do-pregao").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-negocios-consolidados-do-pregao").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-negocios-consolidados-do-pregao --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=serj_henrique/b3-boletim-diario-negocios-consolidados-do-pregao", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "B3 - Boletim Diário - Negócios Consolidados do Pregão", "description": "Extraia os dados de Negócios Consolidados do Pregão de bolsa publicados no Boletim Diário da B3. Obtenha dados estruturados sobre preços, volumes, ofertas e ajustes de ações, opções e futuros negociados.", "version": "0.0", "x-build-id": "FIm5cP0zGuKR2KtAp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/serj_henrique~b3-boletim-diario-negocios-consolidados-do-pregao/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-serj_henrique-b3-boletim-diario-negocios-consolidados-do-pregao", "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-negocios-consolidados-do-pregao/runs": { "post": { "operationId": "runs-sync-serj_henrique-b3-boletim-diario-negocios-consolidados-do-pregao", "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-negocios-consolidados-do-pregao/run-sync": { "post": { "operationId": "run-sync-serj_henrique-b3-boletim-diario-negocios-consolidados-do-pregao", "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": { "referenceDate": { "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'." }, "filterInstrument": { "title": "Filtro por Instrumento", "type": "array", "description": "Filtro por instrumento financeiro. Exemplo: SLCEA18, BGIM26, PETRA18", "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```