Configurar Interactive Brokers | SingularityTrader Lernpfad
2.1
🚀 2 · Primeiros passos

🔶 Configurar Interactive Brokers

Flex Query e sincronização automática

Neste Capítulo

1 Visão Geral 2 O que é um Flex Query? 3 Passo 1: Criar Flex Query no IBKR 4 Passo 2: Configurar Flex Query 5 Passo 3: Selecionar Seções do Relatório 6 Passo 4: Salvar Consulta 7 Passo 5: Gerar Flex Token 8 Passo 6: Exportação XML para Todos os Anos 9 Passo 7: Importação XML do Histórico 10 Passo 8: Configurar no Singularity Trader 11 Sincronização Automática 12 Reintento automático em erros temporários 13 Alternativa: importação manual de XML 14 Dados importados da IBKR 15 📥 Dados do TradingLogbook? Traga suas tags. 16 Solução de problemas 17 Recarregar trades históricos faltantes (⚠️ badge nas posições)

1. Visão Geral

O Interactive Brokers (IBKR) oferece a integração mais abrangente.

✅ Processo:
1. Criar Flex Query
2. Baixar e importar o Flex Query como XML para cada ano
3. Obter atualizações via Flex Sync
⚠️ Importante:
O Flex Sync só recupera atualizações dos últimos dias. A importação XML constrói o histórico completo. Sem histórico completo, o sistema não pode avaliar adequadamente os trades (ex.: estratégias de opções, campanhas, ganhos forex).

2. O que é um Flex Query?

Um Flex Query é um relatório personalizável do Interactive Brokers. Você define uma vez quais dados quer exportar, depois pode recuperar este relatório a qualquer momento - manual ou automaticamente.

Benefícios:
• Todos os trades, dividendos, posições em um relatório
• Sincronização automática possível
• Dados dos últimos 365 dias disponíveis
• Sem entrada manual de dados necessária

Guia Passo a Passo

1

Passo 1: Criar Flex Query no IBKR

1. Fazer login no IBKR:
Vá para interactivebrokers.com e faça login em sua conta.

2. Abrir Flex Queries:
Navegue até: Desempenho e Relatórios → Flex Queries

3. Criar novo Activity Flex Query:
Clique no símbolo âž• ao lado de "Activity Flex Query Viewer" → "Criar"
2

Passo 2: Configurar Flex Query

Nome da Consulta: ex.: "SingularityTrader"

Configuração de Entrega:
• Período de Data: Últimos 365 dias corridos
• Formato de Data: yyyyMMdd
• Formato de Hora: HHMMSS
• Incluir registros de cabeçalho e rodapé: Não

Configuração Geral:
• Formato: XML
• Incluir Trades Cancelados: Não
3

Passo 3: Selecionar Seções do Relatório

Ative todas as seguintes seções no Flex Query:

• Juros Acumulados
• Transações em Dinheiro
• Encargos CFD
• Relatório de Caixa
• Transferências de Trades de Entrada/Saída
• Detalhes de P&L Forex
• Informações do Instrumento Financeiro
• Ações Corporativas
• Informações da Conta
• Valor Patrimonial Líquido (NAV) na Moeda Base
• Posições Abertas
• Acumulações de Dividendos Abertas
• Exercícios, Atribuições e Expirações de Opções
• Posições do Período Anterior
• Demonstração de Fundos
• Trades
• Taxas de Transação
• Transferências
• Mudança nas Acumulações de Dividendos

⚠️ Importante: Para cada seção, selecione todos os campos disponíveis ("Selecionar Tudo").
4

Passo 4: Salvar Consulta

Clique em "Continuar" e depois em "Criar".

Após a criação, você verá sua consulta na lista. Anote o ID da Consulta - você precisará dele em breve.
5

Passo 5: Gerar Flex Token

Para recuperação automática, você precisa de um token:

1. Abrir Seção de Token:
Na área de Flex Queries: Clique no símbolo ⚙️ à direita (Gerenciar Tokens)

2. Criar Novo Token:
Clique em "Gerar Novo Token"

3. Copiar Token:
O token é exibido apenas uma vez! Copie-o imediatamente e guarde-o em segurança.

⚠️ Importante: O token é válido por 1 ano. Você deve gerar um novo após a expiração.
6

Passo 6: Exportação XML para Todos os Anos

Exporte o Flex Query como XML para cada ano do seu histórico de trading:

1. Abrir Flex Query:
No IBKR: Desempenho e Relatórios → Flex Queries

2. Ajustar Intervalo de Datas:
Edite a consulta e defina o intervalo de datas para um ano civil (ex.: 01/01/2023 - 31/12/2023)

3. Executar Consulta:
Clique em "Executar" e baixe o arquivo XML

4. Repetir para Cada Ano:
Repita os passos 2-3 para todos os anos em que negociou no IBKR (ex.: 2021, 2022, 2023, 2024).
7

Passo 7: Importação XML do Histórico

Importe todos os arquivos XML baixados no Singularity Trader:

1. Abrir Seção de Importação:
Vá para Contas → Sua Conta IBKR → Configuração → "Enviar XML"

2. Ano Mais Antigo Primeiro:
Comece com o arquivo XML mais antigo (ex.: 2021) e avance cronologicamente

3. Importar Todos os Anos:
Importe todos os arquivos XML sequencialmente até o ano atual

⚠️ Importante: Este passo é essencial! Sem histórico completo, estratégias de opções, campanhas de trades e ganhos forex não podem ser calculados corretamente.
8

Passo 8: Configurar no Singularity Trader

1. Abrir Configuração da Conta:
Vá para Contas → Sua Conta IBKR → Configuração

2. Inserir Dados do Flex Query:
• ID do Flex Query: O número da consulta do IBKR
• Flex Token: O token gerado

3. Salvar e Testar:
Clique em "Salvar" e depois em "Sincronizar Agora" para testar.
✨

Sincronização Automática

Após a configuração bem-sucedida, seus trades são sincronizados automaticamente todos os dias. Você não precisa fazer mais nada!

O que acontece durante a sincronização:
• Novos trades são importados
• Posições são atualizadas
• Dividendos são registrados
• Estratégias de opções são reconhecidas
• Ganhos forex são calculados (FIFO)

Você sempre pode sincronizar manualmente a qualquer momento se quiser os dados mais recentes imediatamente.

12. Reintento automático em erros temporários

As consultas IBKR Flex podem falhar pontualmente por vários motivos (p. ex. erro temporário do servidor da IBKR, timeout de rede, query em processamento). O Singularity Trader possui uma fila de reintento automática:

• Se uma sincronização falhar, ela é repetida automaticamente até 3 vezes (com intervalo exponencial).
• Somente quando todas as tentativas falham aparece uma entrada CRITICAL no log do sistema e uma notificação.
• Problemas temporários geralmente se resolvem sozinhos, sem que você precise intervir.

Você pode ver o estado atual de sincronização na seção Contas — verde = último sucesso, amarelo = reintento em andamento, vermelho = falhou após 3 tentativas.

13. Alternativa: importação manual de XML

Se não desejar sincronização automática, você pode exportar a Flex Query manualmente:

1. Na IBKR: Flex Queries → "Run" ao lado da sua query
2. Baixar: Salvar o arquivo XML
3. Enviar: Em Singularity Trader → Contas → Configuração → "Enviar XML"

Este método também é necessário para dados históricos (> 365 dias), pois o Flex Sync só alcança 1 ano atrás.

14. Dados importados da IBKR

Totalmente suportado:
• Trades de ações (compra/venda)
• Trades de opções com Greeks
• Futuros e Forex
• Dividendos (bruto, líquido, imposto retido na fonte)
• Juros (crédito/débito)
• Exercícios e atribuições de opções
• Splits de ações e fusões
• Statement of Funds para FIFO cambial

Reconhecido automaticamente:
• Estratégias de opções (Spreads, Iron Condors, etc.)
• Covered Calls / Cash-Secured Puts
• Campanhas de trading
• Ganhos cambiais conforme § 23 EStG

15. 📥 Dados do TradingLogbook? Traga suas tags.

📥 Você vem do TradingLogbook?

Você pode transferir suas estratégias tagueadas para os trades já importados — símbolo + data de abertura são suficientes. Pronto em 3 minutos.

Para a migração em 3 passos

⚠️ Solução de problemas

"Token expirado":
Gere um novo token na IBKR e insira-o na configuração.

"Query não encontrada":
Verifique se o ID da query está correto e se a query está ativa.

"Sem dados":
Certifique-se de que todas as seções necessárias estejam ativadas na query.

"Erro ao importar":
Verifique o log de importação para detalhes. Causa frequente: campos ausentes na query.

⚠️ Recarregar trades históricos faltantes (⚠️ badge nas posições)

O problema:
No painel ou nas listas de posições aparece um símbolo ⚠️ ao lado do nome da conta em uma posição. O tooltip exibe "Dados de trades ausentes — Nenhuma transação foi importada para esta posição. Por isso a estratégia não pode ser reconhecida automaticamente."

A causa:
A posição em si é conhecida via snapshot do portfólio da IBKR, mas os trades de abertura estão antes do dia de trading mais antigo importado até agora. Isso é típico em LEAPS (opções de longo prazo) abertas meses ou anos antes do primeiro Flex Sync.

✅ A solução:
A partir da Flex Query existente, iniciar pontualmente uma exportação ad-hoc com intervalo de datas histórico, baixar como XML e enviar via importação XML. Não é necessário criar uma nova Flex Query!
Passo a passo:
1. Iniciar a exportação histórica na IBKR
• Localizar a Flex Query existente → clicar em Run
• Alterar o período para Custom Date Range
• De: tão atrás quanto necessário (p. ex. 01/01/2024)
• Até: um dia antes do trade mais antigo já importado
• Formato: XML → confirmar Run

2. Baixar o arquivo XML e salvar localmente

3. Enviar no Singularity Trader
• Contas → Conta IBKR → "Configurar IBKR" → XML Import

4. O que acontece durante a importação
• Apenas novos trades são importados (sem duplicatas)
• Estratégias, campanhas e Trade-Cycles são recalculados

5. Verificar o resultado
• Recarregar o painel — o badge ⚠️ deve ter desaparecido

Se o ⚠️ persistir: Os trades de abertura estão ainda mais atrás → iniciar outro run com uma data de início anterior.
Até onde chegou neste capítulo?
📖 Por ler 📚 Em progresso ✅ Concluído
🎓 Iniciar quiz 🔒 Entrar zum E-Learning → 🚶 Continuar a ler 2.2 · Configurar Trade Republic ▶
← Capítulo Anterior 2. Primeiros passos 📋 Índice Próximo Capítulo 2.2. Configurar Trade Republic →