Guida

Come si usa CryptoTax, cosa danno davvero le API degli exchange e come leggere il report. Dieci minuti, poi non serve più.

1. Il percorso in sei passi

Wallet — crea un wallet per ogni piattaforma o wallet personale. Non mescolare due exchange nello stesso wallet: il quadro RW si compila per intermediario e il controllo dei saldi è per wallet.
Importa via API — API key di sola lettura (mai trading, mai prelievi). L'import gira sul server: puoi cambiare pagina e tornare, vedrai fase e avanzamento.
Completa con l'estratto — dove l'API non arriva (tabella sotto) scarica l'estratto dal sito e caricalo da Importa → Import CSV. Le righe già presenti vengono riconosciute e saltate.
Indirizzi propri — i prelievi verso i tuoi wallet non sono vendite: registra gli indirizzi in Wallet → Indirizzi dei miei wallet esterni.
Rendiconti — se hai il rendiconto al 31/12 dell'intermediario, inseriscilo in Wallet → Valori di fine anno: è il valore del quadro RW.
Report — genera, leggi gli avvisi, scarica il PDF e i quadri RW/RT precompilati (anche in CSV) per il commercialista: nel 730 corrispondono ai quadri W e T. L'anno in corso non è un report ma una situazione provvisoria: niente quadri né bollo finché non è chiuso.
Se vendessi oggi — il portafoglio ai prezzi correnti con il costo fiscale dei lotti aperti: simula vendite in euro e vedi imponibile e imposta dell'anno prima e dopo; "Proponi tax-loss harvesting" sceglie le posizioni in perdita che azzerano l'imponibile. Nulla viene salvato.
Il mio commercialista — condividi i dati con il tuo professionista inserendo l'email con cui si è registrato: dal suo Portale studio vede wallet, report e quadri in sola lettura, rigenera il report e scarica PDF e CSV; non importa né modifica nulla. Revochi quando vuoi.

2. Cosa dà l'API di ogni exchange, e cosa no

Le API sono comode ma nessuna restituisce tutto. Questo è quello che abbiamo verificato confrontando gli import con gli estratti ufficiali.

Exchange	L'API dà	L'API non dà → carica l'estratto
Binance	ordini spot dal 2/9/2022 (account migrati a Binance Italy), Convert, depositi, prelievi, acquisti con carta, P2P, distribuzioni Earn dal 2023	ordini spot prima del 2/9/2022, premi staking/Earn prima del 2023, conversione briciole in BNB, pagamenti Binance Pay/Card. Estratto: Wallet → Transaction History → Export Transaction Records, un anno per file (profilo "Binance — Cronologia transazioni")
Bybit	esecuzioni spot, derivati chiusi, depositi/prelievi degli ultimi 24 mesi	tutto ciò che è più vecchio di 24 mesi e gli acquisti con carta (One-Click Buy): CSV dal sito con il profilo Generico
Bitget	spot, Convert, depositi/prelievi degli ultimi mesi; futures solo con il permesso Futures sulla chiave	il periodo precedente: CSV dal sito
Kraken	ledger completo: ordini, acquisti istantanei, depositi, prelievi, staking/Earn, margin	di regola nulla; l'estratto History → Export → Ledgers è identico all'API e serve solo come controllo (profilo "Kraken — Ledgers")
Coinbase	acquisti, vendite, invii, ricezioni, premi	Convert e Advanced Trade a volte mancano: Statements → Transaction history CSV (profilo "Coinbase — Transaction history"), stessi identificativi dell'API
Young Platform	trade per coppia, depositi e prelievi fiat e cripto, premi staking e promo (API v4 di consultazione: chiave da pro.youngplatform.com con Key ID, Public key e Private key)	i passaggi verso Earn, staking, Moneybox e Term sono interni e non compaiono; connettore non ancora verificato su un account reale
Gemini	trade di tutti i simboli, depositi/prelievi, interessi dello staking (chiave con ruolo Auditor)	Gemini Earn (ante 2023) non passa dall'API: estratto CSV; connettore non ancora verificato su un account reale
HTX (Huobi)	depositi e prelievi completi; trade solo degli ultimi 120 giorni e solo per le coppie delle valute in saldo o movimentate	tutto il resto dei trade: estratto ordini dal sito, profilo Generico
OKX, KuCoin, Gate.io, MEXC, Crypto.com Exchange, Bitfinex, Bitstamp, Bitpanda, Bitvavo	vedi il suggerimento sotto la scelta dell'exchange nella pagina Importa	acquisti con carta e prodotti Earn quasi sempre mancano: CSV dal sito con il profilo Generico
Wallet e blockchain	Bitcoin (indirizzo, xpub/ypub/zpub con tutti gli indirizzi derivati), Litecoin, Dogecoin, Dash, Bitcoin Cash, Bitcoin SV, Tron (TRX e USDT/USDC TRC-20), Solana (SOL, token SPL, swap DEX come permute), XRP Ledger, TON (Toncoin e jetton), Cosmos Hub, Osmosis, Injective, Celestia, Akash e Sei nativo (trasferimenti, IBC, premi di staking come redditi, deleghe interne, swap come permute), Cardano (da addr1… o stake1…: tutto il wallet, token nativi, premi per epoca), Algorand (ALGO, ASA, swap dei DEX come permute), Hedera (HBAR, token HTS, premi di staking), NEAR (nome.near: trasferimenti, token, premi dai saldi; chiave NearBlocks), Polkadot (solo trasferimenti DOT), Ethereum e 30 catene EVM (Polygon, Arbitrum One e Nova, Base, Optimism, BNB Chain e opBNB, Avalanche, Gnosis, zkSync, Scroll, Linea, Blast, Mantle, Manta, Xai, Beam, Sonic, Celo, Sei, XDC, Berachain, Unichain, Abstract, HyperEVM, Monad, World Chain, ApeChain, Fraxtal, Taiko): trasferimenti, token, commissioni. 16 catene leggibili senza chiave (Blockscout/Routescan), le altre con la chiave gratuita Etherscan (Etherscan:ApiKey); BNB Chain solo da estratto CSV (Etherscan la serve a pagamento)	NFT e posizioni DeFi compaiono come trasferimenti dei token; DEX interno di XRP Ledger non letto; Cronos e Moonbeam senza explorer gratuito al momento; posizioni LP/DeFi Cosmos e NFT non normalizzati; premi di staking Polkadot (estratto CSV dei rewards di Subscan/Nova) e Zcash: profilo Generico
App Crypto.com, Nexo	—	solo estratto, riconosciuto in automatico: app Crypto.com Accounts → Transaction history → Export (acquisti, scambi, Earn, cashback carta, prelievi); Nexo Transactions → Export (depositi, interessi, scambi, cashback)
Senza API né estratto riconosciuto (Revolut, eToro…)	—	CSV con il profilo Generico (modello da compilare)

Dopo ogni sincronizzazione il software ripete il limite specifico di quell'exchange nell'avviso finale. Con qualunque estratto riconosciuto (Binance, Kraken, Coinbase, Crypto.com App, Nexo) puoi verificare la completezza senza importare: carica il file con la spunta "Solo verifica completezza" e ottieni, mese per mese, cosa manca al wallet rispetto all'estratto ufficiale. Importandolo, le righe già presenti (stesso tipo, asset, importo e orario) vengono saltate: API ed estratto si integrano senza doppioni.

3. Come leggere gli avvisi del report

Plusvalenze probabilmente fittizie: Hai venduto cripto che nei dati importati non risultano mai comprate. Per legge il costo non documentato è zero e l'intera vendita diventa plusvalenza. Quasi sempre manca dello storico: recupera l'estratto del periodo indicato. Per leggere intanto il resto del quadro puoi scegliere l'opzione "neutralizza" nel report, sapendo che non è dichiarabile.
Storico incompleto / saldo negativo: Un asset scende sotto zero in un wallet: da quella data mancano acquisti o depositi. La data indicata è il punto da cui recuperare i dati.
Prelievi verso indirizzi non riconosciuti: Il software li tratta come cessioni. Se sono tuoi wallet, registra l'indirizzo e rigenera.
Controvalori stimati: Quando l'exchange non dà il valore in euro, viene stimato dai prezzi storici (gamba EUR o stablecoin al cambio del giorno, altrimenti prezzo di chiusura). Non è il prezzo di esecuzione: le certificazioni degli intermediari possono differire di poco.

4. Le opzioni di calcolo e la normativa italiana

Le scelte preimpostate seguono l'art. 67 c. 1 lett. c-sexies e l'art. 68 c. 9-bis TUIR e la Circolare 30/E/2023. Sono modificabili nel report; ogni opzione spiega la lettura alternativa.

LIFO — la legge considera ceduti per primi gli asset acquisiti più di recente (art. 67 c. 1-bis).
Portafoglio intero — i lotti si consumano sull'insieme dei wallet, come per il contribuente.
Permute non realizzative — lo scambio tra cripto con eguali caratteristiche e funzioni non è tassato; lo è lo scambio con e-money token.
E-money token: solo emittenti autorizzati MiCA — USDC ed EURC dal 1/7/2024; USDT, BUSD, DAI restano cripto e le permute con essi non sono realizzative. Attenzione: Binance Italy e altri intermediari certificano in modo più prudente (qualunque stablecoin in valuta) e il report divergerà dalla certificazione. Puoi allinearti alla certificazione con l'opzione "tutte le stablecoin".
Commissioni non deducibili — Circolare 30/E §3.1: proventi e costi lordi. La commissione pagata in cripto esce comunque dal saldo.
Cessioni senza acquisto tracciato a costo zero — art. 68 c. 9-bis: costo non documentato = zero.
Soglia 2.000 € (2023-2024), 26% fino al 2025 e 33% dal 2026 sono applicati in automatico per anno.
Derivati (futures, perpetual) — lett. c-quater, compartimento separato: le perdite non compensano le plusvalenze da cessione.

5. Domande frequenti

Ho sbagliato il nome di un wallet: Wallet → matita accanto al nome → Salva. Il nome non incide sul calcolo.
Ho importato un exchange nel wallet sbagliato: Wallet → "Svuota transazioni" sul wallet sbagliato, poi reimporta scegliendo quello giusto. Le sincronizzazioni successive sono incrementali.
Quanto dura un import?: Da pochi secondi a 10-15 minuti (Binance con storico completo: l'API va interrogata coppia per coppia). La prima volta soltanto; poi è incrementale.
Le API key sono al sicuro?: Usa chiavi di sola lettura. Non vengono salvate: restano in memoria sul server solo per la durata dell'import, poi vanno reinserite alla sincronizzazione successiva.
Il report vale come dichiarazione?: No: è una bozza calcolata secondo le opzioni scelte, da far verificare a un commercialista. In beta i PDF portano il watermark BETA.