2.17

🌉 IBKR Live Bridge

Greeks, IV e bid/ask em tempo real no straderz.com

Neste Capítulo

1 O que é a IBKR Live Bridge? 2 Como funciona 3 Requisitos 4 Instalação 5 Emparelhar com o straderz.com 6 Multi-Conta: Pessoal, Empresa, Fundação em Paralelo 7 Subscrição de dados de mercado & cotações com atraso 8 Operação 9 Resolução de Problemas

1. O que é a IBKR Live Bridge?

Com a IBKR Live Bridge, pode ver as suas opções abertas e dados de carteira com Greeks, Implied Volatility, Bid/Ask e P&L em tempo real diretamente no straderz.com — como complemento à sincronização diária via Flex Query.

O que vê no Live Cockpit:
  • Greeks ao vivo (Δ, Γ, Θ, V) para cada posição de opções aberta
  • Implied Volatility e Bid/Ask em tempo real
  • Portfolio Δ e Θ agregados em todas as posições — visível imediatamente quando o book fica demasiado long ou short
  • Saldo da conta e margem ao vivo
  • Cadeias de opções a pedido para análise what-if
Complementa — não substitui.
A Bridge funciona em paralelo com a sincronização Flex Query noturna. O Flex continua a ser a fonte de verdade para o histórico de negociações oficial (impostos, deteção de estratégias, campanhas). A Bridge fornece o caminho em tempo real para a gestão ativa de opções.
✨

Como funciona

A Live Bridge é uma pequena aplicação local no seu PC que comunica com o seu TWS ou IB Gateway em execução via a API IBKR e envia snapshots encriptados para o straderz.com. O seu login IBKR fica inteiramente na sua máquina — não recebemos nem a sua password nem os seus códigos 2FA.

[O seu PC]                                       [straderz.com]                              [Você no browser]
TWS / IB Gateway
    ↓ ib_insync TCP
[Live Bridge] ──── HTTPS POST ────►  [Servidor] ◄──── HTTPS GET ──── [Live Cockpit]
    │                                    │
    └─ lê posições,                      └─ armazena snapshots,
       Greeks, IV, Bid/Ask                   entrega-os ao seu browser
Fluxo de dados resumido:
  • Só leitura, sem negociação — a Bridge não coloca ordens. Envia apenas posições, Greeks, IV, Bid/Ask e saldo da conta.
  • Isolado por utilizador — cada snapshot está vinculado à sua conta via token OAuth; outros utilizadores nunca o veem.
  • Latência ~2 segundos do tick IBKR até à exibição no cockpit.
  • Push HTTPS com bearer token, polling ETag-based pelo browser para carga mínima de dados.

3. Requisitos

  • Windows 10 ou 11 — versão para Mac em preparação (ver nota abaixo)
  • Conta IBKR com TWS (Trader Workstation) ou IB Gateway em execução
  • API IBKR ativada — no TWS em Configuração → API → Definições, ativar "Enable ActiveX and Socket Clients"
  • Conta sTraderZ.com (gratuita ou Premium)
  • Opcional: subscrição de dados de mercado IBKR para dados ao vivo — ver "Subscrição de dados de mercado & cotações com atraso"
⏳ Versão Mac
A Bridge funciona atualmente apenas no Windows. Uma versão para Mac está em preparação — até lá, os utilizadores de Mac continuam a usar a sincronização Flex Query como caminho principal de dados.

Guia Passo a Passo

1

Instalação

1. Transferir a Bridge:
Transfira a Bridge a partir da página de downloads ou diretamente nas definições da Live Bridge.

2. Iniciar a Bridge:
Faça duplo clique em straderz-bridge.exe. Não abre nenhuma janela — a Bridge corre em segundo plano. O ícone da Bridge aparece na bandeja do sistema (canto inferior direito, junto ao relógio).

3. Executar TWS ou IB Gateway em paralelo:
Inicie o seu software IBKR habitual e inicie sessão. A Bridge deteta automaticamente o gateway em execução e liga-se a ele.
2

Emparelhar com o straderz.com

1. Iniciar o emparelhamento no straderz.com:
Vá a Contas → Live Bridge e clique em "Ligar ao straderz.com".

2. Diálogo de autorização no browser:
Abre-se uma página de confirmação com o nome da sua conta. Clique em "Ligar" — o fluxo OAuth é executado com PKCE, pelo que a Bridge nunca vê a sua password.

3. Verificar o estado na bandeja:
Clique no ícone da Bridge na bandeja. O estado deve mostrar ✅ ligado.

4. Primeiros dados no cockpit:
Mude para o Live Cockpit. Ao fim de alguns segundos as suas posições abertas aparecem com Greeks e IV ao vivo.

6. Multi-Conta: Pessoal, Empresa, Fundação em Paralelo

Se gerir várias contas IBKR — p. ex. conta pessoal + depósito empresarial + veículo de fundação — pode trazê-las todas para o cockpit ao vivo ao mesmo tempo.

Configuração:
Inicie múltiplas instâncias do IB Gateway em paralelo, cada uma na sua própria porta (p. ex. :7497 para pessoal, :7498 para empresa, :7499 para fundação). A Bridge deteta automaticamente todos os gateways e etiqueta cada posição com a conta correspondente.

No cockpit pode alternar entre contas ou ver uma vista agregada de todas as contas.

💡 Dica: A documentação oficial IBKR descreve a configuração de gateway paralelo em "IB Gateway User Guide → Running Multiple Instances". Use um login IBKR separado (subconta) para cada instância.
✨

Subscrição de dados de mercado & cotações com atraso

A Bridge utiliza a sua subscrição de dados de mercado IBKR existente — não é necessária uma segunda subscrição no straderz.com. Se pagar pelo "US Securities Snapshot and Futures Value Bundle" ou semelhante no IBKR, esses dados ao vivo fluem automaticamente para o cockpit.

Sem subscrição IBKR: A Bridge entrega apenas cotações com atraso de 15 minutos. Importante saber: isto aplica-se também à exibição no seu TWS. Sem subscrição, o IBKR fundamentalmente só entrega cotações com atraso, independentemente do frontend (TWS, Bridge, app móvel, outras apps de trading). A Bridge não altera isto.

Com subscrição IBKR: Dados ao vivo no TWS E no straderz.com simultaneamente. Vê os mesmos valores em tempo real que tem no TWS.

Recomendação para trading ativo de opções:
Pelo menos o "US Securities Snapshot and Futures Value Bundle" ou um pacote de dados de opções específico. Detalhes e preços atuais no Portal do Cliente IBKR em Definições → Definições de Utilizador → Subscrições de Dados de Mercado.

8. Operação

  • Execute a Bridge em segundo plano — ícone na bandeja, baixo uso de RAM, sem interface necessária.
  • Atualizações automáticas — a Bridge verifica novas versões no arranque. Se estiver disponível uma atualização, aparece um aviso no menu da bandeja.
  • Parar a Bridge — clique com o botão direito no ícone da bandeja → "Sair". O cockpit mostra então o último estado conhecido com o marcador "desatualizado".
  • Revogar ligação — em Contas → Live Bridge, clique em "Desligar". O token é imediatamente revogado no servidor e já não pode ser usado para snapshots.
  • Nota sobre 2FA (importante): Ative a "Extended Session" do IBKR, caso contrário terá de iniciar sessão no TWS a cada ~24 horas — e a Bridge fica inativa entretanto. Instruções na Gestão de Conta IBKR em Definições → Definições de Conta → Secure Login System.

⚠️ Resolução de Problemas

A bandeja mostra "Offline" ou "Sem ligação":
O TWS ou IB Gateway não está em execução, ou o socket da API não está ativado. Verifique os requisitos da secção 3.

"Emparelhamento falhou":
O token foi revogado ou expirou. Solução: nas definições da Live Bridge, clique em "Ligar ao straderz.com" e emparelhe novamente.

O cockpit mostra apenas cotações com atraso:
Sem subscrição de dados de mercado IBKR (ver "Subscrição de dados de mercado & cotações com atraso"). Com subscrição, os dados ao vivo são passados automaticamente.

"Atualizações não aparecem":
Verifique o estado da Bridge na bandeja. Se "ligado" é mostrado mas não chegam atualizações: reinicie o TWS ou IB Gateway — a ligação TCP pode ter ficado suspensa devido a alterações de rede (p. ex. WiFi/LAN).

A Bridge bloqueia ou congela:
Saia da Bridge na bandeja e reinicie-a. Em caso de bloqueios repetidos: está instalada a versão mais recente? Transfira a versão mais recente na página de downloads.

Ainda não tem conta IBKR configurada?
A Live Bridge requer que já tenha ligado a conta IBKR via Flex Query (para o histórico de negociações). → Capítulo 2.1 — Configurar IBKR Flex Query
← Capítulo Anterior 2.16. Plugin Stream Deck 📋 Índice Próximo Capítulo 3. Fundamentos da bolsa →