# B3 - Boletim Diário - Derivativos - Posições em Aberto (`serj_henrique/b3-boletim-diario-derivativos-posicoes-em-aberto`) Actor Extraia os dados de Posições em Aberto de derivativos de bolsa publicados no Boletim Diário da B3. Obtenha dados estruturados sobre opções, open interest, distribuição de posições entre tomadores e doadores, e muito mais. - **URL**: https://apify.com/serj\_henrique/b3-boletim-diario-derivativos-posicoes-em-aberto.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 - Derivativos - Posições em Aberto Extraia os dados de Posições em Aberto de derivativos 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 opções, open interest, distribuição de posições entre tomadores e doadores, e muito mais. ![B3 Boletim Diário - Derivativos - Posições em Aberto](./img/posicoes-em-aberto.png) ### 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 **Derivativos > Derivativos de Bolsa > Posições em Aberto**, e extrai todas as linhas da tabela publicada pela B3 para cada data solicitada. - Extrai **posições em aberto de derivativos de bolsa** para qualquer data de referência (últimos 20 dias) - Obtém dados granulares por instrumento - Retorna a distribuição de posições entre **tomadores e doadores**, posições bloqueadas, e contratos travados - 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 posição publicadas pela B3: | Campo | Descrição | |---|---| | **Instrumento Financeiro** | Nome do derivativo (ex: PINO, WIN, DOL) | | **Código ISIN** | Identificador internacional do ativo subjacente | | **Ativo** | Ativo subjacente do derivativo | | **Código de Expiração** | Código que identifica o vencimento do contrato | | **Segmento** | Segmento de negociação (ex: Futuros) | | **Contratos em Aberto** | Open interest total do instrumento | | **Variação de Contratos em Aberto** | Variação do open interest em relação ao dia anterior | | **Identificador da Distribuição** | Identificador do tomador ou doador | | **Quantidade Coberta** | Quantidade de contratos cobertos por hedge | | **Total de Posições Bloqueadas** | Posições em conta de bloqueio | | **Quantidade Descoberta** | Quantidade de contratos sem cobertura de hedge | | **Total de Posições** | Volume total de posições do participante | | **Quantidade de Tomadores** | Número de tomadores para aquela distribuição | | **Quantidade de Doadores** | Número de doadores para aquela distribuição | | **Quantidade Atual** | Posição atual do participante | | **Contratos Travados** | Contratos com travamento de posição | | **Contratos Baixados por Transferência** | Contratos baixados via operação de transferência | | **Preço a Termo** | Preço do contrato futuro | ### Por que usar este Ator? A tabela de posições em aberto é um dos dados mais importantes para quem opera ou monitora o mercado de derivativos da B3. Este Ator automatiza a extração e estruturação desses dados para: - **Monitoramento de open interest** - Acompanhe o volume de contratos em aberto e suas variações dia a dia, um indicador-chave de liquidez e interesse do mercado - **Análise de distribuição de posições** - Identifique a concentração de posições entre tomadores e doadores, essencial para entender o perfil de participantes do mercado - **Research quantitativo** - Alimente modelos quantitativos com séries temporais de posições, hedge e travamento de contratos - **Due diligence para fundos de investimento** - Verifique exposições e concentrações de posições em derivativos para análise de risco - **Relatórios regulatórios** - Gere relatórios automatizados com dados oficiais da B3 para compliance e governança - **Scheduling automático** - Configure o Ator para rodar diariamente no Apify e manter uma base de dados histórica atualizada ### Como usar O Ator é simples de usar, mesmo sem experiência técnica. Siga estes passos: 1. Crie uma conta gratuita no Apify 2. Abra este Ator 3. Selecione a **data de referência** desejada (ou deixe em branco para usar o último dia útil automaticamente) 4. Clique em **"Start"** e aguarde a extração 5. Visualize os dados na aba **Output**, ou exporte em JSON, CSV, Excel ou HTML ### Entrada (Input) O Ator possui um único parâmetro de entrada: | Parâmetro | Tipo | Descrição | |---|---|---| | **Data de Referência** | Data | Data que identifica as informações extraídas. No site do Boletim Diário da B3, equivale ao campo "Data Inicial". O padrão é o último dia útil. A data deve ser um dia útil e estar dentro dos últimos 20 dias. | #### Exemplo de entrada (JSON) ```json { "referenceDate": "2026-06-25" } ```` #### 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 posição. #### Exemplo de saída (JSON) ```json { "instrumentoFinanceiro": "BGIM26", "codigoIsin": "BRBMEFBGI7N0", "ativo": "BGI", "codigoDeExpiracao": "M26", "segmento": "AGRIBUSINESS", "contratosEmAberto": 125430, "variacaoDeContratosEmAberto": -2340, "identificadorDaDistribuicao": "tomador", "quantidadeCoberta": 1200, "totalDePosicoesBloqueadas": 450, "quantidadeDescoberta": 3200, "totalDePosicoes": 8500, "quantidadeDeTomadores": 15, "quantidadeDeDoadores": 0, "quantidadeAtual": 8500, "contratosTravados": 300, "contratosBaixadosPorTransferencia": 0, "precoATermo": 142500.50 } ``` 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 posições em aberto sem precisar executar manualmente - **Combine com outros Ators** do projeto para extrair dados complementares do Boletim Diário da B3, como relatórios de derivativos de moeda ou de produtos agropecuários - **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. ##### 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. ##### Posso integrar este Ator com outras ferramentas? Sim! Você pode integrar com quase qualquer serviço ou aplicação. O Apify oferece integrações com **Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive** e [muitos outros](https://apify.com/integrations). Também você pode usar [webhooks](https://docs.apify.com/integrations/webhooks) para executar uma ação sempre que o Ator termine uma execução com sucesso, como enviar os dados para um Google Sheet ou notificar no Slack. ##### Posso usar o Apify API com este Ator? Sim. A API do Apify dá acesso programático à plataforma. A API é organizada em torno de endpoints REST que permitem gerenciar, agendar e executar Ators. Para acessar a API usando Node.js, use o pacote [apify-client](https://www.npmjs.com/package/apify-client). Para Python, use o pacote [apify-client](https://pypi.org/project/apify-client/). Veja a [documentação da API Apify](https://docs.apify.com/api/v2) para mais detalhes. ### Feedback Estamos sempre trabalhando para melhorar o Ator. Se você tem alguma sugestão, encontrou um bug ou deseja uma nova funcionalidade, por favor crie um issue na aba [Issues](https://apify.com/YOUR_USERNAME/b3-derivativos-posicoes-em-aberto/issues). Se precisa de uma solução personalizada ou integração com sistemas específicos, entre em contato através da aba [Discussions](https://apify.com/YOUR_USERNAME/b3-derivativos-posicoes-em-aberto/discussions). # 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-derivativos-posicoes-em-aberto").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-derivativos-posicoes-em-aberto").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-derivativos-posicoes-em-aberto --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=serj_henrique/b3-boletim-diario-derivativos-posicoes-em-aberto", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "B3 - Boletim Diário - Derivativos - Posições em Aberto", "description": "Extraia os dados de Posições em Aberto de derivativos de bolsa publicados no Boletim Diário da B3. Obtenha dados estruturados sobre opções, open interest, distribuição de posições entre tomadores e doadores, e muito mais.", "version": "0.0", "x-build-id": "GPI55U8Ra0VXCArdH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/serj_henrique~b3-boletim-diario-derivativos-posicoes-em-aberto/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-serj_henrique-b3-boletim-diario-derivativos-posicoes-em-aberto", "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-derivativos-posicoes-em-aberto/runs": { "post": { "operationId": "runs-sync-serj_henrique-b3-boletim-diario-derivativos-posicoes-em-aberto", "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-derivativos-posicoes-em-aberto/run-sync": { "post": { "operationId": "run-sync-serj_henrique-b3-boletim-diario-derivativos-posicoes-em-aberto", "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 } } } } } } } } } } ```