Come usare la nostra API per le tasse

Ultimo aggiornamento: 31 mar 2025

Un'Interfaccia di Programmazione delle Applicazioni è un modo per diversi servizi (exchange e servizi fiscali in questo caso) 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 tuo conto, la cronologia delle transazioni, ecc.) le cose si complicano, perché queste informazioni sono protette dal tuo nome utente/password/2FA (che non dovresti mai condividere con nessuno).

L'utilizzo di un'API per connettere la tua piattaforma fiscale al tuo conto Kraken è un modo efficiente per consentire l'accesso ai dati del tuo conto senza condividere le tue informazioni di accesso.

Per connettere la tua piattaforma fiscale al tuo conto Kraken, devi concedere alla piattaforma fiscale l'accesso alle informazioni del tuo conto tramite una chiave API.

Non vuoi che terze parti conoscano il tuo nome utente/password/2FA, e non vuoi nemmeno che effettuino scambi o prelievi dal tuo conto, quindi viene utilizzata una chiave API con le autorizzazioni appropriate.

Le autorizzazioni che concedi alla chiave API stabiliranno i limiti di ciò che l'altra piattaforma può vedere e fare sul tuo conto.

In generale, le autorizzazioni necessarie per un software fiscale per calcolare le tue plusvalenze/minusvalenze 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 tuo conto e le transazioni nella cronologia del tuo conto, ma non consentono loro di apportare modifiche al tuo conto (nessun nuovo scambio e nessuna nuova transazione di finanziamento).

Vediamo come appare su Kraken PRO:

Kraken PRO

Per sapere come creare un'API su Kraken, consulta le informazioni di seguito.

Fondi:

Interroga : 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: consente alla chiave API di visualizzare gli ordini chiusi e le transazioni sul conto (questo viene utilizzato per aiutare a determinare profitto/perdita).

Dati:

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

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

Per maggiori informazioni su come connettere il tuo conto Kraken a Koinly, visita:

Inizia selezionando il tuo paese di residenza

1

Successivamente, clicca su Aggiungi Wallet e seleziona Kraken

2

Per utilizzare il metodo di 'Sincronizzazione automatica' dell'API, inserisci la tua chiave pubblica e privata ottenute da Kraken.com e clicca su Aggiungi Kraken.

3

3

4

Per caricare manualmente il tuo file CSV, riformatta i tuoi dati utilizzando la guida CSV di CoinTracker e caricali nel modello CSV di CoinTracker.

Una volta completato, trascina e rilascia il modello CSV di CoinTracker compilato nell'area di caricamento designata.

5

Se hai bisogno di ulteriore assistenza, consulta la guida passo passo di CoinTracker di seguito.

Dalla pagina principale imposta le tue impostazioni di base

1

Fai clic su passaggio successivo, seguito da 'vedi più opzioni'

2

Seleziona Kraken dall'elenco di wallet/exchange

4

5

Copia e incolla le tue chiavi pubbliche e private di Kraken nei campi Chiave API e Chiave segreta e fai clic su "Connetti Exchange"

4

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

Select Exchange/Wallet

Scorri verso il basso fino a 'Crea un nuovo lavoro Kraken automatico' e incolla la Chiave API e la tua Chiave Privata API (segreta), quindi fai clic su 'Salva questo lavoro Kraken'

Input Public/Private Keys

Per caricare manualmente il tuo file CSV, fai clic sulla 'scheda di importazione CSV', quindi trascina e rilascia il tuo file CSV e fai clic su 'Continua a importare'.

Manually Upload CSV file

Infine, fai clic su 'Avvia importazione'

Manually upload CSV file

Successfully uploaded CSV file

Se hai bisogno di ulteriore assistenza, consulta la guida passo passo di CoinTracking qui sotto:

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

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

Blockpit

Successivamente, seleziona Kraken quando ti viene chiesto di selezionare un Wallet.

È visibilmente elencato sotto le integrazioni più popolari.

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

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

Blockpit

Blockpit 3

Copia la tua chiave API e la tua chiave privata API dal tuo account Kraken e incollale nei campi corrispondenti sul sito web di Blockpit e clicca su Continua.

Blockpit 3

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

Blockpit 4

I saldi del tuo account Kraken (e Kraken Futures) verranno mostrati sotto Integrazioni nella Dashboard, dove potrai sincronizzare i dati in qualsiasi momento, o farli sincronizzare automaticamente ogni 24 ore con una licenza Blockpit attiva.

Se hai bisogno di ulteriore assistenza, consulta 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 si presenta questo errore, assicurati innanzitutto di copiare correttamente le chiavi private e pubbliche. Se lo stai facendo e ricevi ancora l'errore di chiave non valida, crea una nuova chiave con le autorizzazioni corrette e prova 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 tuo account e caricandola manualmente sul sito di terze parti. Per sapere come esportare manualmente la cronologia del tuo account, clicca 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 registro dell'account. Alcune piattaforme di terze parti non sono in grado di interpretare correttamente le voci di acquisto/vendita nel registro dell'account. In questo caso, esporta manualmente la cronologia del tuo account e carica il file sulla piattaforma di terze parti che stai utilizzando.

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

    La cronologia completa del tuo account è composta da due parti, ovvero il tuo registro (Ledger) e le tue operazioni (Trades). Per prima cosa, impariamo un po' le differenze tra i due.

    Ora che abbiamo una buona comprensione delle differenze tra il registro (Ledger) del tuo account e la cronologia delle operazioni (Trades), diamo un'occhiata a come interpretare ciascuno di essi.

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

    Finché un sito/applicazione di terze parti richiede le tue chiavi API private di Kraken, possono esserci potenziali problemi di sicurezza, ma finché crei una chiave API specifica con autorizzazioni minime, ad esempio solo per leggere il tuo saldo e/o il registro, non c'è alcun rischio per i tuoi fondi o la sicurezza in generale. Per questo motivo, è consigliabile concedere autorizzazioni di sola lettura e creare una chiave API specifica con tali autorizzazioni da condividere con il tuo software di terze parti fidato.


Hai ancora bisogno di aiuto?