Flex Query IBKR: come scaricarlo dal Client Portal (guida 2026)

Il Flex Query è il report più completo che Interactive Brokers ti permette di scaricare. Contiene tutte le operazioni, i saldi, i dividendi e le corporate actions del tuo conto — ed è il file di partenza indispensabile per fare la dichiarazione fiscale italiana.

In questa guida ti mostro esattamente come configurarlo e scaricarlo, passo per passo.

Cos'è il Flex Query e perché serve

Il Flex Query (o "Activity Flex Query") è un sistema di report personalizzabili di IBKR. A differenza degli Account Statement standard, il Flex Query ti permette di scegliere esattamente quali dati includere, in quale formato, e per quale periodo.

Per la dichiarazione dei redditi italiana ti serve un Flex Query che includa:

Trade Confirmations — tutte le operazioni di acquisto e vendita con prezzi
Dividends — tutti i dividendi ricevuti con ritenute alla fonte
Cash Transactions — movimenti di cassa (interessi, commissioni, ecc.)
Open Positions — posizioni aperte al 31 dicembre
NAV (Net Asset Value) — valore netto del conto giornaliero o di fine periodo
Corporate Actions — split, spin-off, merger che influenzano i lotti

Accesso al Client Portal IBKR

Step 1: Vai su clientportal.ibkr.com

Accedi al Client Portal con le tue credenziali IBKR. Se usi l'autenticazione a due fattori (consigliato), tieni a portata il tuo dispositivo.

Step 2: Performance & Reports

Nel menu principale, vai su:

Menu → Performance & Reports → Flex Queries

In alternativa, dalla barra di ricerca digita "Flex Query".

Step 3: Activity Flex Query

Nella pagina Flex Queries, trovi due tipi principali:

Activity Flex Query — per operazioni, dividendi, posizioni (quello che ci serve)
Trade Confirmation Flex Query — solo per le singole conferme di eseguito

Clicca su "+ Create" accanto ad "Activity Flex Query".

Configurazione del Flex Query per la dichiarazione italiana

Questa è la parte critica. Devi selezionare esattamente le sezioni giuste.

Nome e periodo

Query Name: es. "Dichiarazione IT 2025"
Period: seleziona "Annual" → "Last Calendar Year" (oppure imposta manualmente 01/01/2025 – 31/12/2025)
Date Format: yyyyMMdd (consigliato per compatibilità)
Time Format: HHmmss

Sezioni da abilitare

Trades (operazioni):

✅ Abilitare sezione "Trades"
Seleziona: TradeID, Symbol, SecurityID, DateTime, Quantity, TradePrice, IBCommission, NetCash, AssetCategory, CurrencyPrimary, Exchange, Buy/Sell, TradeMoney, Proceeds, Cost

Dividends:

✅ Abilitare sezione "Dividends"
Seleziona: Symbol, Date, Amount, GrossRate, TaxRate, Net

Cash Transactions:

✅ Abilitare sezione "Cash Transactions"
Seleziona: CurrencyPrimary, DateTime, Amount, Type, Description

Open Positions:

✅ Abilitare sezione "Open Positions"
Seleziona: Symbol, Quantity, CostBasisMoney, MarkPrice, PositionValue, CurrencyPrimary, AssetCategory

Net Asset Value:

✅ Abilitare sezione "Net Asset Value" o "Cash Report"
Seleziona: EndingValue, StartingValue per currency

Corporate Actions:

✅ Abilitare sezione "Corporate Actions"
Seleziona: Symbol, Date, Type, Quantity, Proceeds, Value

Formato output

Format: XML (preferibile per parsing automatico) o CSV
Encoding: UTF-8
Include Header/Footer: Sì

Scarica il Flex Query

Dopo aver configurato e salvato il Flex Query:

Step 1: Torna alla pagina Flex Queries

Vedrai il tuo nuovo query nella lista "Activity Flex Queries".

Step 2: Esegui il query

Clicca sull'icona di download (▶) accanto al nome del query. IBKR elaborerà il report — per conti con molte operazioni può richiedere 1-2 minuti.

Step 3: Scarica il file

Una volta pronto, apparirà un pulsante download. Salva il file .xml (o .csv) in una posizione sicura sul tuo computer.

Il file avrà un nome tipo: U1234567_20250101_20251231.xml

Formato XML vs CSV: quale usare?

Aspetto	XML	CSV
Struttura	Gerarchica con tag	Tabellare a colonne
Leggibilità umana	Difficile	Facile con Excel
Parsing automatico	Ottimo (QuadroRW usa XML)	Buono
Dimensione file	Maggiore	Minore
Completezza dati	Alta (include attributi)	Media

Consiglio: usa XML se stai usando QuadroRW o altri tool automatici. Usa CSV se vuoi aprirlo in Excel per verifiche manuali.

Verifica il file scaricato

Prima di caricare il file su qualsiasi tool, apri il CSV in Excel (o l'XML in un browser) e verifica:

Che ci siano tutte le operazioni — controlla il numero di righe nella sezione Trades
Che il periodo sia corretto — deve coprire 1° gennaio – 31 dicembre dell'anno dichiarato
Che i simboli siano leggibili — nessun carattere strano o troncamento
Che ci siano i dividendi — sezione Dividends con importi e ritenute
Che ci siano le posizioni aperte — sezione OpenPositions con i saldi al 31/12

Problemi comuni e soluzioni

"Il Flex Query non include le operazioni dei primi giorni dell'anno"

Verifica che il periodo sia impostato su "Last Calendar Year" e non "Last 365 Days" (che partirebbe da oggi -365 giorni, non dal 1° gennaio).

"Le corporate actions non compaiono"

Assicurati di aver abilitato la sezione "Corporate Actions" nella configurazione. Se hai avuto split o merger, questa sezione è critica per il calcolo corretto dei lotti LIFO.

"I dividendi mostrano importo 0"

Questo può accadere se IBKR ha reinvestito i dividendi automaticamente (DRIP). In quel caso, controlla la sezione "Cash Transactions" dove troverai i movimenti relativi.

"Il file XML è vuoto o troppo piccolo"

IBKR limita le dimensioni dei Flex Query per account con moltissime operazioni. Prova a dividere in query semestrali (01/01 – 30/06 e 01/07 – 31/12) e poi unisci i dati.

Dove caricare il Flex Query

Una volta scaricato, puoi usare il Flex Query con:

QuadroRW (pre-lancio maggio 2026) — carica il file XML, ottieni i quadri RW, RT e RM precompilati
Foglio di calcolo manuale — se vuoi fare tutto a mano, il CSV è la base di partenza
Commercialista — la maggior parte dei commercialisti specializzati in conti esteri accetta i Flex Query come documentazione

Flex Query per anni precedenti

Se hai bisogno di ricostruire le dichiarazioni degli anni precedenti (o verificare il riporto delle minusvalenze), puoi scaricare Flex Query per qualsiasi anno passato.

IBKR conserva lo storico delle operazioni per 7 anni. Per scaricarlo:

Crea un nuovo Flex Query
Imposta il periodo manualmente: es. 01/01/2022 – 31/12/2022
Esegui e scarica normalmente

Automazione con Activity Flex API

Per chi vuole automatizzare il download del Flex Query senza accedere ogni volta al Client Portal, IBKR offre le Activity Flex Queries API:

Genera un Flex Token dal Client Portal (Settings → Flex Web Service Token)
Salva l'ID numerico del tuo Flex Query configurato
Usa l'endpoint HTTP per scaricare programmaticamente il report

QuadroRW utilizza questa API per offrire il download automatico direttamente dall'interfaccia — niente più download manuali.

FAQ: Flex Query IBKR

Il Flex Query va conservato dopo la dichiarazione? Sì. Come tutta la documentazione fiscale, va conservato per almeno 5 anni (termine ordinario di accertamento dell'AdE).

Devo scaricare un Flex Query separato per ogni anno? Sì. Ogni dichiarazione riguarda un anno fiscale specifico, quindi serve un Flex Query per ogni anno.

Il Flex Query è diverso dall'Account Statement? Sì. L'Account Statement è un report predefinito di IBKR. Il Flex Query è completamente personalizzabile e include dati non presenti nell'Account Statement standard.

Posso usare l'Account Statement invece del Flex Query? Tecnicamente sì, ma il Flex Query è molto più strutturato e completo per la dichiarazione italiana. L'Account Statement in formato PDF è difficile da processare automaticamente.

Automatizza tutto con QuadroRW

Non vuoi più fare questi calcoli a mano? QuadroRW genera i fac-simile precompilati partendo dal tuo Flex Query. Pre-lancio 2026 a €29.

Iscriviti alla waitlist →