Interactive Brokers

Interactive Brokers

Conecte o Interactive Brokers uma única vez e o Tradeways importa suas execuções automaticamente. Não há nada para instalar e seu computador não precisa estar ligado: o Tradeways baixa de forma agendada os relatórios Flex que você configurou no Interactive Brokers.

A conexão é somente leitura. Um token do Flex Web Service só consegue baixar os relatórios Flex que você configurou. Ele não pode enviar ordens nem movimentar dinheiro.

A configuração leva cerca de dez minutos. Você cria três itens no Interactive Brokers e os cola no Tradeways:

Tudo isso fica no Interactive Brokers, em Performance & Reports → Flex Queries. As imagens abaixo vêm do app para celular do Interactive Brokers, onde essa página se chama Trade Reports. O Portal do Cliente no desktop mostra os mesmos campos.

Para trazer o histórico anterior à conexão, ou para importar sem um token, veja Importação de arquivos do Interactive Brokers.

Configurar o Interactive Brokers

1. Ative o Flex Web Service e crie um token

Abra Flex Queries e selecione o ícone de engrenagem ao lado de Flex Web Service Configuration.

1. Ative Flex Web Service Status.
2. Deixe Valid for IP Address vazio. O Tradeways não se conecta a partir de um endereço fixo, então um token restrito a um endereço IP é recusado.
3. Selecione Generate New Token e escolha por quanto tempo ele fica válido. O prazo mais longo evita que você precise substituí-lo logo.

Copie o token. Gerar outro token depois invalida este; quando isso acontecer, substitua as credenciais no Tradeways.

2. Crie as duas Flex Queries

Na página Flex Queries, cada tipo de query tem o próprio botão +.

Activity Flex Query (1). No portal em alemão, ela se chama Kontoumsatz-Flex-Query.

1. Dê um nome a ela, por exemplo Tradeways.
2. Adicione a seção Trades. Escolha Executions como nível de detalhe e selecione todos os campos.
3. Adicione a seção Open Positions. Escolha Summary como nível de detalhe e selecione todos os campos.
4. Defina o formato como XML. O período não importa: o Tradeways define as datas em cada solicitação.
5. Defina a configuração geral como no passo 3 e salve.

Trade Confirmation Flex Query (2). No portal em alemão, ela se chama Handelsbestätigungs-Flex-Query.

1. Dê um nome a ela, por exemplo Tradeways.
2. Adicione a seção Trade Confirmation. Escolha Execution como nível de detalhe e selecione todos os campos.
3. Defina o formato como XML.
4. Defina a configuração geral como no passo 3 e salve.

Cada query pode incluir várias contas do Interactive Brokers. Você não precisa de uma query por conta; o Tradeways pergunta para onde cada conta vai quando a vê pela primeira vez.

3. Defina a configuração geral nas duas queries

As duas queries têm um bloco General Configuration. Defina os mesmos quatro valores em cada uma.

1. Date Format: yyyyMMdd.
2. Time Format: HHmmss TimeZone. Esta é a configuração mais fácil de passar batida. Sem ela, os horários das execuções ficam sem fuso horário, e o Tradeways não importa um relatório cujos horários precisaria adivinhar.
3. Date/Time Separator: ; (semi-colon).
4. Include Offsetting Trade/Cancel Pairs?: Yes. Assim, uma execução cancelada pelo Interactive Brokers também é removida do seu Diário.

Deixe Profit and Loss em Default. As outras opções podem ficar como estão.

4. Copie os dois IDs de query

Abra cada query. O Query ID aparece no topo dos detalhes.

Os dois IDs de query precisam ser diferentes. O token é bem mais longo que um ID de query, o que facilita distinguir os três valores.

Conectar no Tradeways

1. Vá em Configurações → Integrações e encontre Interactive Brokers.
2. Selecione Conectar a Interactive Brokers.
3. Cole o token em Token do Flex Web Service, o ID da query Activity em ID da query Activity e o ID da query Trade Confirmation em ID da query Trade Confirmation. Selecione Conectar.
4. O Tradeways verifica o token e as duas queries. O Interactive Brokers pode levar alguns minutos para gerar os relatórios. Você pode fechar a janela; o status é atualizado em Configurações.
5. Quando os relatórios contiverem contas do Interactive Brokers, associe cada uma a uma conta própria do Tradeways ou escolha Não importar. Nada é importado de uma conta até que ela seja mapeada.

O token é armazenado criptografado e nunca é exibido de novo. Os números das contas do Interactive Brokers aparecem mascarados.

Depois que a primeira sincronização importar algo, uma conta mapeada mantém o destino. Você pode excluí-la e incluí-la de novo depois, mas só na mesma conta do Tradeways. Mudá-la importaria o mesmo histórico para uma segunda conta.

Como a sincronização funciona

A sincronização automática não é um feed em tempo real. O Interactive Brokers publica os relatórios Flex com atraso, e o Tradeways os lê de forma agendada:

• Novas execuções: a query Trade Confirmation é verificada a cada 15 minutos, aproximadamente. Espere ver os novos fills no seu Diário em cerca de 10 a 20 minutos.
• Correções e posições abertas: a query Activity é verificada uma vez por dia. Ela traz execuções tardias, comissões corrigidas e os preços de fechamento do dia das posições abertas.
• Primeira sincronização: cobre os últimos 365 dias corridos. O histórico mais antigo vem de uma importação de arquivo.

Selecione Sincronizar agora para solicitar uma verificação antecipada. As solicitações são limitadas a uma a cada 15 minutos.

As execuções são identificadas pelo ID de execução do Interactive Brokers. Um fill que já está no seu Diário, vindo de um relatório anterior ou de uma importação de arquivo, não é importado duas vezes. Um trade que você exclui continua excluído quando um relatório posterior traz os fills dele de novo.

O que é importado

• Execuções de ações e ETFs, e execuções de Forex CASH que o Interactive Brokers marca como de abertura ou de fechamento. Outras classes de ativos são contadas como não compatíveis e ignoradas.
• Execuções parciais, reversões de posição e comissões como informadas pelo Interactive Brokers, incluindo reembolsos de comissão.
• Cancelamentos: uma execução cancelada é removida do trade ao qual pertencia.
• P&L em aberto das posições de ações e ETFs, a partir do preço de fechamento diário (MarkPrice) do relatório Activity. Não é uma cotação ao vivo.

As métricas de excursão e outras análises baseadas em preço aparecem apenas para instrumentos com histórico de preços compatível. Os outros trades são importados sem elas; o Tradeways não as estima.

Lacunas de histórico

Uma execução de fechamento precisa da execução de abertura. Quando a execução de abertura é anterior ao período sincronizado e não está no seu Diário, o Tradeways ignora a execução de fechamento e a conta como uma lacuna de histórico. Ele não cria uma execução de abertura substituta. Para fechar a lacuna, importe um arquivo que cubra as duas execuções na mesma conta.

Status e contagens

Cada conexão em Configurações mostra seu status, a última verificação, a última verificação bem-sucedida e a próxima verificação agendada, no seu fuso horário.

As contagens descrevem o último relatório: execuções importadas, ignoradas como duplicadas, removidas por cancelamento, ignoradas por não serem compatíveis e ignoradas como lacunas de histórico. Como o relatório Activity diário se sobrepõe aos dias anteriores, a maioria das execuções dele conta como duplicada. Isso é esperado.

Solução de problemas

Depois de corrigir o token ou uma query no Interactive Brokers, selecione Substituir credenciais para verificar de novo. Quando uma conta de destino estiver indisponível, selecione Mapear contas. Desconectar interrompe todas as verificações e exclui o token; os trades já importados permanecem nas suas contas.