2.17

🌉 IBKR Live Bridge

Greeks in tempo reale, IV e bid/ask in straderz.com

1. Cos'è il IBKR Live Bridge?

Con il IBKR Live Bridge vedi le tue opzioni aperte e i dati del portafoglio con Greeks in tempo reale, Volatilità Implicita, Bid/Ask e P&L direttamente in straderz.com — come complemento alla sincronizzazione giornaliera tramite Flex Query.

Cosa vedi nel Live Cockpit:
  • Greeks in tempo reale (Δ, Γ, Θ, V) per ogni posizione opzione aperta
  • Volatilità Implicita e Bid/Ask in tempo reale
  • Δ e Θ del portafoglio aggregati su tutte le posizioni — immediatamente visibili quando il book diventa troppo lungo o troppo corto
  • Saldo account e margine in tempo reale
  • Catene di opzioni su richiesta per analisi what-if
Complementa — non sostituisce.
Il Bridge funziona in parallelo alla sincronizzazione notturna tramite Flex Query. Flex rimane la fonte di verità per lo storico ufficiale dei trade (tasse, rilevamento strategie, campagne). Il Bridge fornisce il percorso in tempo reale per la gestione attiva delle opzioni.

Come funziona

Il Live Bridge è una piccola applicazione locale sul tuo PC che comunica con il tuo TWS in esecuzione o IB Gateway tramite l'API IBKR e invia snapshot cifrati a straderz.com. Il tuo login IBKR rimane interamente sul tuo dispositivo — non riceviamo né la tua password né i tuoi codici 2FA.

' . "[Il tuo PC]                                       [straderz.com]                                  [Tu nel browser]\nTWS / IB Gateway\n    ↓ ib_insync TCP\n[Live Bridge] ──── HTTPS POST ────►  [Server] ◄──── HTTPS GET ──── [Live Cockpit]\n    │                                    │\n    └─ legge posizioni,                  └─ memorizza snapshot,\n       Greeks, IV, Bid/Ask                   li consegna al tuo browser" . '
Flusso dei dati in breve:
  • Sola lettura, nessun trading — il Bridge non piazza ordini. Invia solo posizioni, Greeks, IV, Bid/Ask, saldo account.
  • Isolato per utente — ogni snapshot è associato al tuo account tramite token OAuth; gli altri utenti non lo vedono mai.
  • Latenza ~2 secondi dal tick IBKR alla visualizzazione nel cockpit.
  • Push HTTPS con bearer token, polling browser basato su ETag per un carico dati minimo.

3. Requisiti

  • Windows 10 o 11 — Mac in preparazione (vedi nota sotto)
  • Account IBKR con TWS (Trader Workstation) o IB Gateway in esecuzione
  • API IBKR abilitata — in TWS sotto Configurazione → API → Impostazioni, abilita "Abilita client ActiveX e Socket"
  • Account sTraderZ.com (gratuito o Premium)
  • Opzionale: abbonamento dati di mercato IBKR per dati in tempo reale — vedi "Abbonamento dati di mercato e quotazioni ritardate"
⏳ Versione Mac
Il Bridge attualmente funziona solo su Windows. Una versione Mac è in preparazione — nel frattempo, gli utenti Mac continuano a utilizzare la sincronizzazione Flex Query come percorso dati principale.

Guida passo dopo passo

1

Installazione

1. Scarica il Bridge:
Scarica il Bridge dalla pagina di download o direttamente dalle impostazioni Live Bridge.

2. Avvia il Bridge:
Fai doppio clic su straderz-bridge.exe. Non si apre alcuna finestra — il Bridge viene eseguito in background. L'icona del Bridge appare nella barra delle applicazioni (in basso a destra vicino all'orologio).

3. Esegui TWS o IB Gateway in parallelo:
Avvia il tuo solito software IBKR e accedi. Il Bridge rileva automaticamente il gateway in esecuzione e si connette ad esso.
2

Associa a straderz.com

1. Avvia l'associazione in straderz.com:
Vai su Account → Live Bridge e clicca "Connetti a straderz.com".

2. Dialogo di autorizzazione nel browser:
Si apre una pagina di conferma con il nome del tuo account. Clicca "Connetti" — il flusso OAuth viene eseguito con PKCE, quindi il Bridge non vede mai la tua password.

3. Controlla lo stato nella barra delle applicazioni:
Clicca sull'icona del Bridge nella barra delle applicazioni. Lo stato dovrebbe mostrare ✅ connesso.

4. Primi dati nel cockpit:
Passa al Live Cockpit. In pochi secondi appariranno le tue posizioni aperte con Greeks e IV in tempo reale.

6. Multi-Account: Personale, Aziendale, Fondazione in parallelo

Se gestisci più account IBKR — es. account personale + deposito aziendale + veicolo fondazione — puoi portarli tutti nel cockpit in tempo reale simultaneamente.

Configurazione:
Avvia più istanze di IB Gateway in parallelo, ciascuna sulla propria porta (es. :7497 per personale, :7498 per azienda, :7499 per fondazione). Il Bridge rileva automaticamente tutti i gateway e contrassegna ogni posizione con il suo account corrispondente.

Nel cockpit puoi poi passare da un account all'altro o visualizzare una vista aggregata di tutti gli account.

💡 Suggerimento: La documentazione ufficiale IBKR descrive la configurazione con gateway paralleli sotto "IB Gateway User Guide → Running Multiple Instances". Usa un login IBKR separato (sottoaccount) per ogni istanza.

Abbonamento dati di mercato e quotazioni ritardate

Il Bridge utilizza il tuo abbonamento dati di mercato IBKR esistente — non è necessario un secondo abbonamento su straderz.com. Se paghi per "US Securities Snapshot and Futures Value Bundle" o simile su IBKR, quei dati in tempo reale confluiscono automaticamente nel cockpit.

Senza abbonamento IBKR: Il Bridge fornisce solo quotazioni con ritardo di 15 minuti. Importante sapere: questo vale anche per la visualizzazione in TWS. Senza abbonamento, IBKR fornisce fondamentalmente solo quotazioni ritardate, indipendentemente dal frontend (TWS, Bridge, app mobile, altre app di trading). Il Bridge non cambia questo.

Con abbonamento IBKR: Dati in tempo reale in TWS E straderz.com simultaneamente. Vedi gli stessi valori in tempo reale che hai in TWS.

Raccomandazione per il trading attivo di opzioni:
Almeno il "US Securities Snapshot and Futures Value Bundle" o un pacchetto dati opzioni specifico. Dettagli e prezzi attuali nel Client Portal IBKR sotto Impostazioni → Impostazioni utente → Abbonamenti dati di mercato.

8. Operatività

  • Esegui il Bridge in background — icona nella barra delle applicazioni, basso utilizzo RAM, nessuna interfaccia necessaria.
  • Aggiornamenti automatici — il Bridge verifica la presenza di nuove versioni all'avvio. Se è disponibile un aggiornamento, viene visualizzato un avviso nel menu della barra delle applicazioni.
  • Arresta il Bridge — fai clic destro sull'icona nella barra delle applicazioni → "Esci". Il cockpit mostra quindi l'ultimo stato noto con indicatore "non aggiornato".
  • Revoca la connessione — in Account → Live Bridge, clicca "Disconnetti". Il token viene immediatamente revocato lato server e non può più essere utilizzato per snapshot.
  • Nota 2FA (importante): Abilita IBKR "Sessione estesa", altrimenti devi accedere nuovamente a TWS ogni ~24 ore — e il Bridge rimane inattivo nel frattempo. Istruzioni in IBKR Account Management sotto Impostazioni → Impostazioni account → Sistema di login sicuro.

⚠️ Risoluzione dei problemi

La barra delle applicazioni mostra "Offline" o "Nessuna connessione":
TWS o IB Gateway non è in esecuzione, oppure il socket API non è abilitato. Verifica i requisiti della sezione 3.

"Associazione fallita":
Il token è stato revocato o è scaduto. Soluzione: nelle impostazioni Live Bridge, clicca "Connetti a straderz.com" e associa di nuovo.

Il cockpit mostra solo quotazioni ritardate:
Nessun abbonamento dati di mercato IBKR (vedi "Abbonamento dati di mercato e quotazioni ritardate"). Con un abbonamento, i dati in tempo reale vengono trasmessi automaticamente.

"Gli aggiornamenti non arrivano":
Controlla lo stato nella barra delle applicazioni del Bridge. Se viene mostrato "connesso" ma non arrivano aggiornamenti: riavvia TWS o IB Gateway — la connessione TCP potrebbe bloccarsi a causa di modifiche di rete (es. WiFi/LAN).

Il Bridge si arresta in modo anomalo o si blocca:
Esci dal Bridge dalla barra delle applicazioni, riavvialo. In caso di crash ripetuti: è installata l'ultima versione? Scarica l'ultima versione dalla pagina di download.

Nessun account IBKR configurato?
Il Live Bridge richiede che tu abbia già connesso l'account IBKR tramite Flex Query (per lo storico dei trade). → Capitolo 2.1 — Configurare IBKR Flex Query