Interactive Brokers: conectar pelas Flex Queries

Planos Trader, Pro e Fleet.

A Interactive Brokers não dá a outros aplicativos acesso de leitura ao vivo, mas publica seus extratos pelo seu Flex Web Service: um token e as Flex Queries que você cria no Client Portal. O TakeJournal os pede sozinho, só para leitura: ações, opções sobre ações, futuros e opções sobre futuros, com suas comissões, vencimentos, exercícios e atribuições, e os depósitos e saques. Ele nunca envia uma ordem e não pode.

No Client Portal

1. Performance & Reports → Flex Queries. Crie uma Trade Confirmation Flex Query: a seção Trade Confirmation com Executions marcado e todos os campos selecionados, o formato XML, o período Today. Salve-a e anote o seu Query ID.
2. Opcional, para o histórico e o dinheiro movimentado: uma Activity Flex Query com as seções Trades (Executions, todos os campos), Cash Transactions, Corporate Actions e Account Information, o formato XML, o período Last 365 Calendar Days. Anote também o seu Query ID.
3. Na mesma página, Flex Web Service Configuration: ative o serviço e gere um token. Escolha a validade mais longa que a IB oferece (até um ano) e deixe a restrição de IP vazia: o servidor do TakeJournal pergunta do seu próprio endereço.

Adicionar a conexão

Conexões → Adicionar conexão, tipo Interactive Brokers (Flex Web Service):

• Token do Flex Web Service — o token do passo 3. Ele é guardado criptografado e usado só para leitura; exclua a conexão e ele vai junto.
• ID da Trade Confirmation Query — o ID do passo 1.
• ID da Activity Query — o ID do passo 2, ou vazio.

As contas chegam com a primeira sincronização, com o apelido que você deu a elas na IB e na moeda base da IB.

A sincronização

A IB diz que o seu Flex Web Service não é para ser consultado a cada minuto, e os seus extratos não são ao vivo: uma execução aparece no extrato Trade Confirmation de 5 a 10 minutos depois do fill, e o extrato Activity é atualizado uma vez por dia após o fechamento. Por isso a sincronização automática (no Fleet, enquanto o TakeJournal está aberto) pergunta a cada 30 minutos nos dias úteis das 9:00 às 17:30 no horário de Nova York, uma vez depois disso, e uma vez por dia no fim de semana; a Activity Query no máximo uma vez a cada 20 horas. Sincronizar agora no painel ou na página Conexões pergunta na hora.

Uma importação de um arquivo de Flex Query e a conexão conhecem as mesmas execuções pelos IDs de execução da IB, então um arquivo de operações mais antigas nunca duplica o que a sincronização trouxe.

As Corporate Actions do extrato Activity trazem os desdobramentos, mudanças de símbolo e dividendos em ações de uma ação (desdobramentos); os outros eventos corporativos, uma fusão ou um spin-off, não contam.

Quando a IB recusa, o cartão da conexão diz por quê e o que fazer: um token expirado (crie um novo e informe-o na conexão), um token limitado a outros endereços IP, uma query que não é do token, ou um extrato que a IB ainda não terminou (a próxima sincronização o lê).

Com a seção Open Positions (todos os campos) na consulta Activity, a sincronização que a lê compara as posições que ela lista com as suas execuções, então um fechamento que falta no histórico é encontrado (Um fechamento faltando); uma diferença de ações que nenhum fechamento faltando explica (ações transferidas de outra corretora) não gera aviso.

Relacionados

Interactive Brokers: importar uma Flex Query · Relatórios de importação · Corretoras e importações