Come usare la nostra API per le tasse

Ultimo aggiornamento: 4 novembre 2026

Tax platforms can connect to your Kraken account using an API key. This lets them import your balances, trade history, and ledger history to help you calculate your crypto taxes, without you sharing your login details. This guide explains what an API is, how to choose the right permissions, and how to connect popular tax platforms.

Un'Application Programming Interface è un modo per diversi servizi (in questo caso, exchange e servizi fiscali) di interagire tra loro.

A volte i servizi possono comunicare liberamente utilizzando dati disponibili pubblicamente tramite API; tuttavia, quando si tratta di interrogare le informazioni necessarie per le tasse (come i saldi del Suo conto, la cronologia delle transazioni, ecc.), le cose si complicano, perché queste informazioni sono protette dal Suo nome utente/password/2FA (che Lei non dovrebbe mai condividere con nessuno).

L'utilizzo di un'API per collegare la Sua piattaforma fiscale al Suo conto Kraken è un modo efficiente per consentire l'accesso ai dati del Suo conto senza condividere le Sue informazioni di accesso.

Per collegare la Sua piattaforma fiscale al Suo conto Kraken, deve concedere alla piattaforma fiscale l'accesso alle Sue informazioni del conto tramite una chiave API.

Lei non vuole che terze parti conoscano il Suo nome utente/password/2FA, e non vuole nemmeno che facciano trading o prelevino dal Suo conto, quindi viene utilizzata una chiave API con le autorizzazioni appropriate.

Le autorizzazioni che Lei concede alla chiave API stabiliranno i limiti su ciò che l'altra piattaforma può vedere e fare sul Suo conto.

In generale, le autorizzazioni necessarie a un software fiscale per calcolare i Suoi guadagni/perdite di capitale sono le seguenti:

Interroga fondi, Interroga ordini chiusi & transazioni (opzionale per alcuni exchange), Interroga voci di registro ed Esporta dati.

Queste sono note come autorizzazioni di sola lettura, il che significa che consentono all'altra piattaforma di vedere i fondi nel Suo conto e le transazioni nella cronologia del Suo conto, ma non consentono loro di apportare modifiche al Suo conto (nessuna nuova transazione e nessuna nuova operazione di finanziamento).

Vediamo come appare su Kraken PRO:

Kraken PRO

Per sapere come creare un'API su Kraken, consulti di seguito.

Fondi:

Interroga: ciò consente alla chiave API di visualizzare il saldo del conto e i registri di finanziamento (depositi e prelievi storici) sul conto.

Ordini e transazioni:

Interroga ordini chiusi & transazioni: ciò consente alla chiave API di vedere gli ordini chiusi e le transazioni sul conto (questo viene utilizzato per aiutare a determinare profitto/perdita).

Dati:

Interroga voci di registro: ciò consente alla chiave API di visualizzare il registro del conto, che è un registro di tutte le transazioni di trading/finanziamento passate.

Esporta dati: ciò consente alla chiave API di esportare tutti i dati sopra menzionati, inclusa la cronologia del Suo trading e del registro del conto (solitamente in formato CSV).

Per maggiori informazioni su come collegare il Suo conto Kraken a Koinly, visiti:

Inizi selezionando il Suo paese di residenza

1

Successivamente, clicchi su Aggiungi Wallet e selezioni Kraken

2

Per utilizzare il metodo API 'Sincronizzazione automatica', inserisca la Sua chiave pubblica e privata acquisita da Kraken.com e clicchi su Aggiungi Kraken.

3

3

4

Per caricare manualmente il Suo file CSV, riformatti i Suoi dati utilizzando la guida CSV di CoinTracker e li carichi nel modello CSV di CoinTracker.

Una volta completato questo passaggio, proceda a trascinare e rilasciare il modello CSV di CoinTracker completato nell'area di caricamento designata.

5

Se ha bisogno di ulteriore assistenza, consulti la guida passo-passo di CoinTracker di seguito.

Dalla pagina principale imposti le Sue impostazioni di base

1

Clicchi su passaggio successivo, seguito da 'vedi più opzioni'

2

Selezioni Kraken dall'elenco di wallet/exchange

4

5

Copi e incolli le Sue chiavi pubblica e privata di Kraken nei campi Chiave API e Chiave segreta e clicchi su "Connetti Exchange"

4

Dalla pagina principale, selezioni 'Inserisci Coin' e cerchi e selezioni Kraken (da non confondere con Kraken Futures)

Select Exchange/Wallet

Scorra verso il basso fino a 'Crea un nuovo lavoro Kraken automatico' e incolli la chiave API e la Sua chiave privata API (segreta), quindi clicchi su 'Salva questo lavoro Kraken'

Input Public/Private Keys

Per caricare manualmente il Suo file CSV, clicchi sulla scheda 'Importa CSV', quindi proceda a trascinare e rilasciare il Suo file CSV e clicchi su 'Continua a importare'.

Manually Upload CSV file

Infine, clicchi su 'Avvia importazione'

Manually upload CSV file

Successfully uploaded CSV file

Se ha bisogno di ulteriore assistenza, consulti la guida passo-passo di CoinTracking di seguito:

Per una guida completa su come caricare i dati di Kraken in Crypto Tax Calculator (CTC), visiti il nostro articolo di supporto: Collegamento a Crypto Tax Calculator

Dalla pagina della dashboard, selezioni il pulsante + Integrazione in alto a destra:

Blockpit

Successivamente, selezioni Kraken quando Le viene chiesto di selezionare un Wallet.

È visibilmente elencato tra le integrazioni più popolari.

Successivamente, selezioni Kraken (per i dati API Spot) o Kraken Futures (per i dati Futures).

*Si prega di notare che le API Key di Kraken Futures sono separate e distinte dalle API Key di Kraken SPOT e non possono essere utilizzate in modo intercambiabile*

Blockpit

Blockpit 3

Copi Lei la Sua API Key e la Sua API Private Key dal Suo account Kraken e le incolli nei campi corrispondenti sul sito web di Blockpit, quindi clicchi su Continua.

Blockpit 3

Dopo aver cliccato su 'Continua', inizierà il processo di sincronizzazione dei saldi del Suo account e della cronologia delle transazioni. Questo può richiedere alcuni secondi o minuti a seconda della lunghezza della cronologia del Suo account.

Blockpit 4

I Suoi saldi Kraken (e Kraken Futures) saranno mostrati sotto Integrazioni nella Dashboard, dove Lei potrà sincronizzare i dati in qualsiasi momento, o farli sincronizzare automaticamente ogni 24 ore con una licenza Blockpit attiva.

Se Le serve ulteriore assistenza, consulti la guida passo-passo di Blockpit qui sotto.

Recap is a crypto tax calculator for UK taxpayers and their accountants. It calculates your Capital Gains Tax using HMRC’s same day, 30-day and Section 104 matching rules, and produces the figures you need for your Self Assessment return.

When you create your Kraken API key for Recap, select Query (funds), Query open orders & trades, Query closed orders & trades, Query ledger entries and Export data.

From the Accounts page, select the Add account button at the top right.

Recap Accounts page with the Add account button at the top right

Next, select Connect to Exchange API and click Next.

Recap Connect to Exchange API option

Select Kraken (for spot data) or Kraken Futures (for futures data) and click Next, then give the account a name and click Next again.

Please note that Kraken Futures API keys are separate and distinct from Kraken Spot API keys and cannot be used interchangeably.

Recap exchange selection with Kraken and Kraken Futures options

Copy your API Key and your API Private Key from your Kraken account, paste them into the API Key and API Secret fields, and click Next.

Recap will then import your Kraken history, including staking and Earn rewards, and keep it in sync. This can take a few minutes, depending on how long your account history is. Once it has finished, open Tax in Recap to see your capital gains and income for each UK tax year, and download your HMRC reports.

If you need further assistance, please take a look at the Recap step by step guide below.

  • •

    Ricevo un errore di chiave non valida quando aggiungo la mia chiave pubblica e privata a un software di terze parti.

    Se Le viene presentato questo errore, si assicuri innanzitutto di copiare correttamente le chiavi private e pubbliche. Se lo sta facendo e riceve ancora l'errore di chiave non valida, crei una nuova chiave con le autorizzazioni corrette e provi ad aggiungerla di nuovo.

  • •

    I miei saldi Earn/Staked non vengono visualizzati.

    Alcuni software fiscali di terze parti non sono in grado di importare correttamente i saldi dei nostri asset in staking tramite API. Questo può essere solitamente risolto esportando la cronologia del Suo account e caricandola manualmente sul sito di terze parti. Per sapere come esportare manualmente la cronologia del Suo account, clicchi qui sotto.

  • •

    Alcune delle mie transazioni mancano.

    Le funzioni di acquisto/vendita istantanea non vengono registrate nella cronologia delle operazioni dell'account, tuttavia possono essere visualizzate nel Ledger dell'account. Alcune piattaforme di terze parti non sono in grado di interpretare correttamente le voci di acquisto/vendita nel Ledger dell'account. In questo caso, esporti manualmente la cronologia del Suo account e carichi il file sulla piattaforma di terze parti che sta utilizzando.

  • •

    Ho scaricato manualmente la cronologia del mio account ma non capisco cosa significano i simboli.

    La Sua cronologia completa dell'account è composta da due parti, ovvero il Suo Ledger e le Sue Trades. Per prima cosa, impariamo un po' le differenze tra i due.

    Ora che abbiamo una buona comprensione delle differenze tra il Suo Ledger dell'account e la cronologia delle Trades, diamo un'occhiata a come interpretare ciascuno di essi.

  • •

    È sicuro fornire le mie API key a un software di terze parti?

    Finché un sito/applicazione di terze parti richiede le Sue API key private di Kraken, possono esserci potenziali problemi di sicurezza, ma finché Lei crea una API key specifica con autorizzazioni minime, ad esempio solo per leggere il Suo saldo e/o il Ledger, non c'è alcun rischio per i Suoi fondi o per la sicurezza in generale. Per questo motivo è consigliabile concedere autorizzazioni di sola lettura e creare una API key specifica con tali autorizzazioni da condividere con il Suo software di terze parti di fiducia.