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. Obtenha dados estruturados sobre opções, open interest, distribuição de posições entre tomadores e doadores, e muito mais.

O que este Ator faz?

Este Ator acessa o Boletim Diário da B3 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)

{
  "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)

{
  "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.

Também você pode usar 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. Para Python, use o pacote apify-client. Veja a documentação da API Apify 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.

Se precisa de uma solução personalizada ou integração com sistemas específicos, entre em contato através da aba Discussions.