Como criar uma Flex Query da Interactive Brokers, passo a passo

O que é uma Activity Flex Query (e por que não serve qualquer relatório)

A IBKR oferece vários tipos de Flex Query. Para um diário de trading completo você precisa da Activity Flex Query, não da Trade Confirmation Flex Query: esta última só traz execuções, sem saldo da conta nem movimentações de caixa, então não basta para calcular o resultado, os dividendos ou o valor da sua carteira dia a dia. Ao criar a consulta, ative estas seções:

• Trades (os trades em si)
• Cash Transactions (dividendos, juros, comissões)
• Open Positions (sua carteira atual)
• Net Asset Value (NAV) in Base (o valor da conta dia a dia)
• Cash Report e Mark-to-Market (para bater o saldo com a corretora)

Passo 1 — Crie a consulta no Client Portal

1. 1

   Entre em Flex Queries

   No Client Portal, vá a Performance & Reports → Flex Queries (ou Menu → Reporting → Flex Queries se você usa o menu lateral).
2. 2

   Crie uma nova Activity Flex Query

   Clique no ícone + ao lado de “Activity Flex Query” e dê um nome a ela — por exemplo, “Tortuga”.
3. 3

   Marque as seções acima

   Em Sections, selecione Trades, Cash Transactions, Open Positions, NAV in Base, Cash Report e Mark-to-Market. Ao abrir cada uma, marque todos os campos disponíveis — quanto mais campos você incluir, menor o risco de faltar algo mais adiante.
4. 4

   Escolha um período amplo e o formato XML

   Na configuração de entrega, use um período longo (Year to Date ou um intervalo personalizado desde que você começou a operar) se quiser trazer histórico, e o formato XML. Clique em Continue e depois em Create.

Passo 2 — Ative o token do Flex Web Service

1. 1

   Procure a configuração do Flex Web Service

   Na mesma tela de Flex Queries há uma seção Flex Web Service Configuration. Marque a caixa de status e clique em Save.
2. 2

   Copie o token

   A IBKR gera um Current Token: é uma senha de uso exclusivo que vai para o Tortuga, nunca o seu usuário nem a sua senha da IBKR. Você pode escolher quanto tempo ele dura, entre 6 horas e 1 ano — escolha a duração longa para não ter de gerá-lo de novo toda semana.
3. 3

   Anote também o Query ID

   Ele aparece ao lado do nome da consulta que você criou, na lista de Flex Queries. Você precisa dos dois valores: o ID da consulta e o token.

Se você administra várias contas vinculadas sob uma conta master, o token só aparece na master — mas a consulta pode trazer dados das contas que você incluir ao criá-la.

Passo 3 — Conecte-a ao Tortuga

1. 1

   Abra Importar trades

   Na sua conta do Tortuga, vá a Importar trades e escolha Interactive Brokers → Flex Query.
2. 2

   Cole o ID da consulta e o token Flex

   Os mesmos dois valores do passo anterior.
3. 3

   Sincronize

   O Tortuga traz automaticamente seus trades, dividendos e NAV, e com isso alimenta o diário de trades, o calendário de resultados e o acompanhamento de dividendos — você pode repetir a sincronização quando quiser, sem precisar criar a consulta de novo.

Se a sincronização falhar

• Token inválido ou expirado: volte a Flex Queries no Client Portal e gere um novo.
• Consulta mal configurada: confira se as seções do Passo 1 continuam marcadas — às vezes uma edição posterior desmarca alguma sem querer.
• Sincronizações demais seguidas: a IBKR limita a frequência de pedidos ao Flex Web Service; espere alguns minutos e tente de novo.

Continue lendo

• Como controlar a estratégia wheel: prêmios, exercícios e preço médioA wheel se explica em cinco minutos e sai do controle em três meses. O que anotar em cada volta para saber se você está ganhando de verdade.
• Acompanhar dividendos da Interactive Brokers: recebido e projetadoO extrato da corretora diz quanto você já recebeu. Não diz quanto vai receber, nem quanto já entra sem vender nada se você somar juros e prêmios.