Guida per estrarre lo storico delle transazioni dall’exchange CoinEx
Se usi CoinEx e devi esportare il tuo storico per consegnarlo al tuo tecnico di colvence e calcolare le imposte sulle criptovalute, questa guida ti spiega che cosa scaricare e come farlo.
Copriamo due metodi: il download manuale dei file CSV e il collegamento tramite un’API in sola lettura.
Importante: per una revisione fiscale completa l’ideale è consegnare sia i CSV sia l’API in sola lettura. Il CSV porta lo storico esportato da CoinEx, l’API aiuta a verificare dati e saldi.
Perché ti serve lo storico di CoinEx
Per calcolare correttamente plusvalenze e minusvalenze della dichiarazione occorre ricostruire tutte le operazioni:
- la data di ogni acquisto, vendita, conversione o scambio
- la quantità di criptovalute ricevuta e ceduta
- il valore di mercato al momento dell’operazione
- le commissioni pagate
- depositi, prelievi e trasferimenti tra conti
CoinEx opera come exchange internazionale. Se ci detieni criptovalute, conviene esaminarlo come exchange estero ai fini del Modelo 721, soprattutto se il valore complessivo sugli exchange esteri supera i 50.000 € al 31 dicembre.
File necessari
Per un’estrazione completa in stile Koinly devi scaricare da CoinEx questi file:
| File | Percorso in CoinEx | Quando serve |
|---|---|---|
| Deposit Records | Assets > Spot > Deposit Records | Sempre |
| Withdrawal Records | Assets > Spot > Withdrawal Records | Sempre |
| Spot history | Assets > History > Spot Trades | Se hai comprato o venduto sullo spot |
| Margin history | Assets > History > Margin | Se hai usato il margin trading |
| Futures history | Assets > History > Futures | Se hai usato i futures |
Importante: l’intervallo di date deve coprire tutto il tuo storico su CoinEx, non solo l’anno da dichiarare. Se manca un anno precedente, il calcolo FIFO può risultare incompleto.
CoinEx offre anche un’esportazione fiscale generale da Assets > History > Export Data, che genera uno ZIP con CSV di Spot, Margine, Futures e Conto finanziario. Può tornare utile come supporto, ma per la riconciliazione fiscale conviene scaricare anche i file specifici di depositi, prelievi e operazioni.
Metodo 1: esportazione CSV
Passo 1: accedere a CoinEx
- Apri il browser e vai su coinex.com
- Accedi con il tuo account
- Completa la verifica di sicurezza se CoinEx la richiede
Passo 2: esportare i depositi
- In alto a destra seleziona «Assets»
- Nel menu laterale sinistro, dentro Overview, apri Spot
- Seleziona «Deposit Records»
- Scegli un intervallo di date che copra tutto il tuo storico su CoinEx
- Clicca su «Export» e salva il file
Passo 3: esportare i prelievi
Ripeti lo stesso procedimento per i prelievi:
- Vai su Assets > Spot
- Apri «Withdrawal Records»
- Seleziona lo stesso intervallo di date completo
- Clicca su «Export»
- Salva il file senza aprirlo né modificarlo
Passo 4: esportare lo storico spot
- In alto a destra apri «Assets»
- Nel menu a tendina seleziona «History»
- CoinEx ti porta allo storico. Di norma per impostazione predefinita ti trovi nella sezione Spot Trades
- Seleziona un intervallo di date che copra tutto il tuo storico
- Clicca su «Export»
- Salva il CSV generato
Passo 5: esportare margin e futures se li hai usati
Se hai operato con margine o futures, lo storico spot da solo non basta.
- Da Assets > History usa il menu laterale sinistro
- Cambia il tipo di storico in Margin o Margin History
- Seleziona l’intervallo completo ed esporta il file
- Ripeti il procedimento per Futures o Futures History
Nota: se non hai mai usato margine o futures, non serve generare file vuoti. Se non sei sicuro, controlla entrambe le sezioni per eventuali movimenti datati.
Passo 6: esportazione fiscale generale di CoinEx
Come verifica aggiuntiva, CoinEx consente di esportare dati fiscali da Assets > History > Export Data.
In quella schermata puoi selezionare:
- Time Range: tutto il tuo storico
- Account Type: tutti i conti disponibili
- Asset Type: tutti gli asset
- Esportare il file
Quando CoinEx completa l’esportazione, ricevi un avviso via e-mail e un messaggio dentro la piattaforma. Scarica lo ZIP e invialo insieme ai CSV precedenti se il tuo tecnico lo richiede.
Importante: non aprire né modificare i CSV prima di inviarceli. Aprirli con Excel può alterare date, decimali o simboli.
Limiti da tenere presenti
| Limite | Dettaglio |
|---|---|
| Registri disponibili | CoinEx conserva fino alle 50.000 voci più recenti nello storico esportabile |
| Esportazioni mensili | massimo 6 esportazioni per mese solare |
| Validità del link | Il link di download è valido per 7 giorni |
| File necessari | Depositi, prelievi, spot, margin e futures vanno scaricati separatamente se hai usato quelle sezioni |
| Esportazione fiscale generale | Lo ZIP ufficiale di CoinEx separa Spot, Margine, Futures e Conto finanziario |
| Conti senza attività | Possono generare CSV vuoti |
| CoinSet / LP | Le operazioni CoinSet o di liquidità possono richiedere una ricostruzione manuale se il file non riporta il numero di quote |
Pianifica le esportazioni prima di richiederle, soprattutto se hai molti anni di attività o moltissime operazioni.
Metodo 2: collegamento tramite API
L’API in sola lettura consente di consultare informazioni di conto e operazioni senza concedere permessi per operare o prelevare fondi.
Passo 1: aprire API Management
- Accedi a coinex.com
- In alto a destra seleziona «Account» o l’icona del tuo profilo
- Nel menu a tendina apri «API Management»
Passo 2: creare una nuova API
- Clicca su «Create API»
- Assegna un nome riconoscibile, per esempio «colvence»
- Inserisci il tuo codice TOTP o il codice di verifica richiesto da CoinEx
- Conferma la creazione
Sicurezza: non attivare permessi di trading né di prelievo. Per una revisione fiscale ci serve solo la lettura.
Passo 3: copiare le chiavi
Quando CoinEx crea l’API, copia in modo sicuro:
- API Key o Access ID
- API Secret o Secret Key
Invia queste credenziali al tuo tecnico di colvence tramite il canale sicuro che ti indicherà.
Nota: le chiavi API appena create possono impiegare qualche minuto per diventare attive. Se compare un errore subito dopo la creazione, attendi e riprova.
Limiti dell’API di CoinEx
L’API non sempre restituisce tutto lo storico fiscale. Secondo le limitazioni che Koinly indica per CoinEx, alcune operazioni possono non essere importate perché CoinEx non le fornisce via API:
- instant swap
- airdrop
- commissioni da referral
Se hai avuto uno di questi movimenti, avvisa il tuo tecnico perché li aggiunga a mano con la documentazione disponibile.
Schermate dei saldi
Oltre al CSV e all’API può servire inviare le schermate dei saldi se hai fondi distribuiti su più conti o sottoconti:
- Conto Spot
- Conto di Margine
- Conto Futures
- Conto finanziario / Earn
- AMM o altre sezioni con saldo
- Sottoconti, se li usi
Scatta schermate in cui si vedano chiaramente importi, valute e data. Serve a verificare il patrimonio, i saldi di chiusura ed eventuali obblighi legati al Modelo 721.
Domande frequenti
CoinEx consente di esportare tutto lo storico?
CoinEx permette di esportare da diverse sezioni, ma la sua esportazione fiscale generale indica un limite di 50.000 voci più recenti. Se il tuo account supera quel volume, avvisa il tuo tecnico per valutare esportazioni per sezioni, intervalli parziali o l’assistenza di CoinEx.
Quante volte posso esportare i dati?
CoinEx consente fino a 6 esportazioni per mese solare. Esaurito il limite, dovrai attendere il mese successivo.
Quanto dura il link di download?
Il link di download dura 7 giorni. Scarica lo ZIP appena ricevi l’avviso di CoinEx.
Mi serve il CSV o l’API?
Quando è possibile, consegna entrambi. Il CSV conserva l’esportazione ufficiale così come scaricata, l’API permette di confrontare le informazioni in automatico.
Quali file non possono mancare?
Come minimo scarica Deposit Records, Withdrawal Records e lo storico spot. Se hai usato margine o futures, aggiungi anche Margin history e Futures history.
Un’API in sola lettura può muovere fondi?
No. Un’API configurata in sola lettura permette di consultare i dati, ma non di operare né di prelevare criptovalute.
Che succede con instant swap, airdrop o referral?
Koinly segnala che l’API di CoinEx non fornisce instant swap, airdrop né commissioni da referral. Se hai avuto quei movimenti, andranno aggiunti a mano con estratti, schermate o registri interni.
Che faccio se ho operazioni CoinSet o di liquidità?
Se il file non riporta il numero di quote, quelle operazioni possono non importarsi correttamente e vanno ricostruite a mano. Inviaci qualsiasi schermata o estratto aggiuntivo di CoinEx perché possiamo esaminarlo.
CoinEx è un exchange estero ai fini del Modelo 721?
In pratica CoinEx va esaminato come exchange estero. Se al 31 dicembre superi i 50.000 € complessivi su exchange esteri, verifica se sei tenuto a presentare il Modelo 721.
Riepilogo
| Passo | Azione |
|---|---|
| 1 | Vai su coinex.com e accedi |
| 2 | Apri Assets > Spot > Deposit Records ed esporta tutto lo storico |
| 3 | Ripeti in Assets > Spot > Withdrawal Records |
| 4 | Vai su Assets > History ed esporta lo storico spot |
| 5 | Se hai usato margine o futures, esporta anche Margin history e Futures history |
| 6 | In alternativa, scarica lo ZIP fiscale da History > Export Data |
| 7 | Crea un’API in sola lettura da Account > API Management se il tuo tecnico la richiede |
| 8 | Invia CSV, API e schermate dei saldi senza modificare i file |
Ti serve aiuto con lo storico di CoinEx?
Da colvence ti aiutiamo a ottenere il tuo storico di CoinEx — ti guidiamo passo passo se ti blocchi —, lo elaboriamo, calcoliamo tutte le plusvalenze e minusvalenze con il metodo FIFO e prepariamo la tua dichiarazione.
Contattaci e ci pensiamo noi.
Víctor Lázaro
Consulente fiscale, colvence.com
