Come usare la nostra API per le tasse

Ultimo aggiornamento: 31 marzo 2025

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:

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.

  • 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.


Hai bisogno di ulteriore assistenza?