Guida

Come collegare il tuo conto IBKR

BrokerLab legge i tuoi dati dai report Flex Query di Interactive Brokers. Ti servono due cose: una Flex Query di attività (dice a IBKR quali dati mandare) e un token del Flex Web Service (permette a BrokerLab di scaricare il report ogni notte). Ci vogliono circa 10 minuti, una volta sola.

Il token è di sola lettura: con esso si possono solo scaricare report. Nessuno può fare ordini, prelievi o modifiche al conto. BrokerLab lo conserva cifrato.

1. Crea la Flex Query di attività

Accedi al Portale clienti IBKR (Client Portal) dal computer.
Apri Performance e report → Flex Queries.
Nel riquadro Activity Flex Query premi + per crearne una nuova. Dalle un nome, ad esempio BrokerLab.
Nelle Sezioni attiva quelle elencate qui sotto. Per ognuna IBKR apre una finestra con i campi: premi Seleziona tutto e salva.

Sezioni obbligatorie

Sezione nel Portale IBKR	Nel report	Opzioni da scegliere
Trades	`Trades`	Execution e Closed Lots. Tra i campi, assicurati che ci sia Open/Close Indicator: serve a riconoscere aperture, chiusure e roll.
Option Exercises, Assignments and Expirations	`OptionEAE`
Cash Transactions	`CashTransactions`	livello Detail, tutti i tipi (dividendi, ritenute, interessi, commissioni…)
Transfers	`Transfers`
Corporate Actions	`CorporateActions`
Open Positions	`OpenPositions`	livello Summary
Financial Instrument Information	`SecuritiesInfo`
Conversion Rates	`ConversionRates`

Sezioni consigliate

Non sono indispensabili, ma rendono più complete le analisi e i controlli con i numeri di IBKR:

Net Asset Value (NAV) in Base: il grafico del valore del conto giorno per giorno;
Realized and Unrealized Performance Summary in Base: il controllo del P/L realizzato con quello calcolato da IBKR;
Statement of Funds, Prior Period Positions, Month & Year to Date Performance Summary;
Open Dividend Accruals e Change in Dividend Accruals: i dividendi in arrivo;
Commission Details, Interest Accruals, Change in Position Value.

Impostazioni di consegna e generali

In fondo alla pagina della query imposta così (sono importanti: con formati diversi le date non vengono lette):

Formato	XML
Periodo	Last 365 Calendar Days (ultimi 365 giorni)
Formato data	yyyyMMdd
Formato ora	HHmmss
Separatore data/ora	; (punto e virgola)
Profitti e perdite	predefinito
Includi operazioni annullate	No

Salva la query. Nell'elenco delle Activity Flex Query compare il suo Query ID, un numero di 6–7 cifre: annotalo.

2. Attiva il Flex Web Service e crea il token

Nella stessa pagina Flex Queries apri Flex Web Service Configuration (l'icona dell'ingranaggio).
Attiva il servizio e genera un token. Scegli la durata più lunga possibile (fino a un anno) e annota la data di scadenza: BrokerLab ti avviserà quando si avvicina.
Se IBKR propone una restrizione per indirizzo IP, lasciala vuota, oppure scrivi a you@example.com per avere l'indirizzo del server da autorizzare.
Copia il token (una stringa lunga di cifre).

3. Inseriscili in BrokerLab

In BrokerLab apri Collegamento conto.
Incolla token e Query ID, inserisci la scadenza del token e scegli quanti anni di storico scaricare.
Premi Collega e scarica lo storico. La pagina mostra l'avanzamento; di solito bastano pochi minuti (IBKR impone una pausa tra un anno e l'altro).

Da quel momento BrokerLab scarica i nuovi dati ogni notte. Non devi fare altro.

Se qualcosa non torna

«Il token Flex non è valido» o «è scaduto»: generane uno nuovo (punto 2) e incollalo in Collegamento conto.
«Il Query ID non è valido»: controlla di aver copiato l'ID di una Activity Flex Query, non di una Trade Confirmation.
Nei «Controlli con IBKR» compare «mancano: …»: aggiungi alla query le sezioni indicate. Il giorno dopo il report sarà completo.
Il risultato realizzato è 0: IBKR calcola il P/L solo dopo la chiusura della giornata. Aspetta l'aggiornamento notturno.
Per qualsiasi altra cosa usa Invia un commento nel menu o scrivi a you@example.com.

I nomi delle voci nel Portale IBKR possono cambiare leggermente nel tempo o con la lingua scelta.