Messaggi di errore API

Gli errori di autorizzazione negata vengono restituiti quando il client API tenta di eseguire un'attività con una chiave API che non dispone dell'autorizzazione appropriata. Se ad esempio un client API tenta di recuperare il saldo dell'account utilizzando una chiave API configurata per consentire l'accesso al trading, ma non l'accesso alla gestione dell'account, viene restituito l'errore Autorizzazione negata. È possibile verificare le API key e le relative impostazioni (come le autorizzazioni) tramite la scheda Impostazioni -> API della gestione dell'account. Devi assicurarti che le chiavi API utilizzate dalle applicazioni di terze parti dispongano di tutte le impostazioni e le autorizzazioni richieste dalle applicazioni.

Questo errore viene restituito quando la API key utilizzata per la chiamata è scaduta o disabilitata. Verifica la API key nella scheda Impostazioni -> API della gestione dell'account oppure generane una nuova e aggiorna l'applicazione.

È possibile estrarre l'elenco completo delle coppie di asset dalla chiamata pubblica AssetPairs e cercare il nome della coppia come voce delle intestazioni JSON o mediante il parametro "altname": https://api.kraken.com/0/public/AssetPairs

Questo errore viene restituito quando un metodo viene chiamato senza i parametri richiesti. Ad esempio, se si chiama il metodo QueryOrders senza specificare un ID di transazione (parametro txid) valido, viene restituito l'errore Argomenti non validi. Se invece si chiama un metodo aggiungendo parametri non necessari, l'errore Argomenti non validi non viene restituito, perché i parametri non necessari vengono semplicemente ignorati.

Gli errori di firma non valida si verificano quando l'API key o l'API secret sono scritti in modo errato nel programma o perché i dati POST utilizzati nell'autenticazione non corrispondono ai dati POST inviati all'API. Come riferimento aggiuntivo, di seguito è riportato un esempio di codice Python per implementare l'algoritmo di firma API. La chiave pubblica API appropriata deve essere copiata e incollata dalla gestione dell'account, mentre il metodo API e i dati POST devono essere aggiornati in modo appropriato. Il valore dell'output può essere utilizzato direttamente come valore dell'intestazione HTTP API-Sign. #!/usr/bin/env python

# Import required Python libraries
import time
import base64
import hashlib
import hmac

# Decode API private key from base64 format displayed in account management
api_secret = base64.b64decode("nmlrD83t1J+yVWKUBx9vD6j26C5zhC11tFfXpN+Ww+8oOVuGgse5AeADcvl95jYaD+UAi3D5CrVfFr8GfQ7zhA==")

# Variables (API method, nonce, and POST data)
api_path = "/0/private/TradeBalance"
api_nonce = str(int(time.time()*1000))
api_post = "nonce=" + api_nonce + "&asset=xxbt"

# Cryptographic hash algorithms
api_sha256 = hashlib.sha256(api_nonce + api_post).digest()
api_hmac = hmac.new(api_secret, api_path + api_sha256, hashlib.sha512)

# Encode signature into base64 format used in API-Sign value
api_signature = base64.b64encode(api_hmac.digest())

# API authentication signature for use in API-Sign HTTP header
print(api_signature)Il valore SHA256 viene calcolato utilizzando il valore nonce stesso e i dati POST per il metodo API, mentre i dati POST sono costituiti sempre dalle coppie nome/valore dei parametri del metodo nonce (di nuovo) e dell'API. Di seguito è riportato un esempio dei dati da passare a SHA256 per il metodo TradeBalance:SHA256 = SHA256 of "1541933977000nonce=1541933977000&asset=xxbt"Il valore della stringa passato a SHA256 non deve contenere alcun valore Null (\0) aggiuntivo e non deve essere codificato come base64 o esadecimale (ossia il valore della stringa deve essere una stringa di testo normale). Il percorso URI è l'intero URL del metodo API, senza il prefisso "https://api.kraken.com". Ad esempio, il percorso URI del metodo TradeBalance è la stringa "/0/private/TradeBalance" senza alcun valore Null aggiuntivo. Il valore HMAC SHA512 viene calcolato utilizzando il percorso URI e il digest SHA256 calcolato in precedenza, con la chiave privata API decodificata in formato base64 come chiave HMAC. Di seguito è riportato un esempio dei dati da passare ad HMAC: HMAC SHA512 con la chiave privata decodificata in formato base64 = HMAC di "/0/private/TradeBalanceSHA256" Le uniche due intestazioni HTTP personalizzate richieste sono API-Key e API-Sign. L'intestazione API-Key è una copia esatta della chiave API pubblica della gestione degli account. L'intestazione API-Sign è il digest HMAC SHA512 codificato in formato base64.

Puoi trovare ulteriori informazioni su questo errore qui:https://support.kraken.com/hc/en-us/articles/360001148063E ulteriori informazioni su Nonce e Finestra Nonce qui:https://support.kraken.com/hc/en-us/articles/360000906023https://support.kraken.com/hc/en-us/articles/360001148023

Gli errori di sessione non valida vengono restituiti tramite la WebSocket API quando si tenta di sottoscrivere un feed autenticato (privato) utilizzando un token di autenticazione che non è più valido (ad esempio, perché è già scaduto).

La soluzione consiste semplicemente nel richiedere un nuovo token di autenticazione tramite l'endpoint GetWebSocketsToken della REST API e utilizzare il nuovo token per tutte le richieste di sottoscrizione autenticate (private) successive.

Un errore di richiesta non valida indica che c'è qualcosa di errato nella richiesta HTTP sottostante (non nella successiva richiesta API), come URL non corrispondenti tra REST/WebSocket, o che i dati POST HTTP non sono stati inclusi correttamente:

% curl --data "" https://api.kraken.com/0/private/GetWebSocketsToken

{"error":["EAPI:Bad request"]}

Questo errore viene restituito quando l'endpoint chiamato non è un endpoint valido.

È stato superato il limite di velocità dell'API.

Mentre l'aggiunta e l'annullamento degli ordini non vengono conteggiati rispetto ai limiti del nostro contatore API standard, queste operazioni dispongono di un contatore di aggiunta e annullamento degli ordini dedicato. Con questo contatore, più tempo gli ordini rimangono nel registro ordini, più i clienti hanno la possibilità di aggiungerli o annullarli.

I messaggi di Blocco temporaneo possono essere generati quando si verificano troppe chiamate API non riuscite o troppi errori nonce non validi in un breve periodo di tempo o vengono rilevate firme non valide. Anche se l'errore viene restituito da queste chiamate, tale errore viene conteggiato in base ai limiti dell'API e potrebbe causare un blocco temporaneo.

I blocchi temporanei durano circa 15 minuti. Se ricevi un errore di blocco temporaneo, attendi 15 minuti prima di inviare nuove richieste all'API. Se vengono generati più errori di nonce non valido, aumenta la finestra nonce per cercare di ridurre la frequenza di tali errori. Prova a ridurre anche la frequenza delle chiamate API private.

L'apertura di nuove spot position con margine è stata temporaneamente sospesa per la manutenzione del motore di trading. La funzionalità sarà presto disponibile e potrai seguire gli aggiornamenti su status.kraken.com.

L'errore potrebbe anche essere dovuto al fatto che le posizioni spot con margine non sono attualmente disponibili per i clienti che risiedono in determinati Paesi.

Su Kraken non è possibile aprire una posizione long e short per la stessa coppia.

Se desideri aprire una posizione long e short per la stessa valuta, scegli coppie di trading diverse con valuta corrispondente alla valuta base o alla valuta quotata. Esempio: short XBT/USD, long XBT/EUR.

Questo errore si verifica quando vengono superati i limiti di prestito di margine per il livello di verifica corrente. I limiti di tolleranza dei margini per ciascuna valuta variano in base al livello di verifica corrente.

Disponiamo di fondi limitati per l'estensione dei margini. Il messaggio "Margine insufficiente" indica che al momento non sono disponibili fondi nel margin pool applicabile. La situazione può cambiare in qualsiasi momento. L'ordine potrebbe essere effettuato correttamente solo pochi secondi o minuti dopo, ma gli ordini per volumi elevati e quelli effettuati nei periodi con volumi elevati potrebbero richiedere più tempo. Ci scusiamo per l'inconveniente.

Questo errore si verifica quando non ci sono margini liberi sufficienti per aprire una nuova posizione sull'account o se il tentativo corrente di aprire una posizione comporterebbe una riduzione del margine libero dell'account al di sotto del 100%.

Non disponi dei fondi necessari per effettuare l'ordine. Controlla le tue posizioni aperte e gli ordini per le voci che potrebbero bloccare i tuoi fondi.

Non è stato raggiunto il volume minimo dell'ordine per l'asset in questione.

È stato superato il numero massimo di ordini aperti disponibili per l'account.

Questo limite si basa sul livello di verifica. Chiudi alcuni ordini aperti o verifica il tuo account a un livello superiore.

Se sei un cliente retail statunitense e ricevi l'errore EOrder:Reduce only:Non-ECP quando effettui ordini a leva tramite API o WebSocket, significa che il tuo ordine viene instradato attraverso la coppia di trading sbagliata.

Il trading a margine retail statunitense è elaborato tramite Bitnomial Exchange, che richiede un formato di coppia diverso. Invece di usare il nome della coppia standard (ad esempio, BTC/USD), devi aggiungere :BTNL alla coppia (ad esempio, BTC/USD:BTNL). Questo si applica a tutti gli endpoint degli ordini, inclusi REST API e WebSocket.

Come risolverlo

Aggiorna la tua richiesta di ordine per usare il formato di coppia :BTNL. Ad esempio, invece di BTC/USD usa BTC/USD:BTNL, e invece di XBT/USD usa XBT/USD:BTNL.

Per vedere l'elenco completo delle coppie disponibili per il trading a margine retail statunitense, effettua la seguente chiamata API pubblica: https://api.kraken.com/0/public/AssetPairs?execution_venue=bitnomial_exchange

Nota: se il tuo ordine supera validate=true ma fallisce quando inviato dal vivo, questo è previsto – la convalida controlla solo la formattazione dell'ordine e non verifica l'instradamento dell'account. Il formato di coppia :BTNL è richiesto affinché l'ordine effettivo venga elaborato.

È stato superato il numero massimo di posizioni aperte disponibili per l'account.

Questo limite si basa sul livello di verifica. Ti invitiamo a chiudere o liquidare alcune o tutte le posizioni aperte, oppure a verificare il tuo account a un livello superiore.

È stato effettuato un tentativo di modifica di un ordine esistente (aperto), ma le modifiche non sono state apportate correttamente. Possibili ragioni sono fondi insufficienti per il nuovo ordine, situazioni di esecuzione parziale e alcuni ordini con leva.

Il nuovo volume è inferiore al volume già eseguito/evaso.

Il volume dell'ordine ha superato il limite di dimensione della posizione con margine della coppia per il trading.

Il volume visualizzato non raggiunge il volume minimo dell'ordine.

Il volume visualizzato deve essere inferiore al volume dell'ordine.

Gli ordini iceberg non sono compatibili con altri tipi di ordini oltre ai limit order.

Ogni criptovaluta può avere al massimo 5 indirizzi di deposito nuovi (non utilizzati), dopodiché qualsiasi tentativo di crearne un sesto restituirà un errore.

Questo errore viene restituito ogni volta che gli endpoint di versamento vengono chiamati con un parametro "metodo" non valido o mancante. 

Il parametro di input "key" non corrisponde alla descrizione dell'indirizzo impostata nella gestione dell'account (tramite Versamenti -> Prelievo).

Gli importi minimi di prelievo variano in base alla valuta e qualsiasi tentativo di prelievo al di sotto del limite minimo restituisce questo errore.

Si tratta di un errore generico che indica che una richiesta di versamento non può essere completata (ad esempio, viene visualizzato quando i clienti di determinate località tentano di effettuare richieste di staking on chain).

Il prelievo richiesto non può essere completato, perché l'indirizzo di destinazione non riporta le informazioni necessarie sul beneficiario/destinatario (ciò vale solo per determinati prelievi da conti canadesi).

Gli errori di servizio che si verificano dovrebbero essere solo temporanei. Se le richieste non riescono, prova a inviarle di nuovo. Provvederemo a monitorare i problemi e aggiorneremo la nostra pagina:

https://status.kraken.com/

I problemi di degrado delle API possono determinare problemi per Kraken, che si manifestano come messaggi di servizio non disponibile e interruzioni del sito.

Questo problema indica una possibile compromissione della sicurezza del tuo account. Modifica la password e l'autenticazione a due fattori, quindi contatta il nostro centro di assistenza.

Questo errore si verifica quando un flag o un parametro di input viene disattivato temporaneamente o definitivamente. L'errore dovrebbe essere dovuto a uno degli input passati. Contatta l'assistenza inviando un log con tutte le informazioni utilizzate per la chiamata che ha generato l'errore.

Gli errori 5xx e 10xx non vengono generati dall'API, ma dal server Web di Cloudflare.

Gli errori delle API vengono sempre restituiti in formato JSON, ad esempio "ERROR":[“ErrorType:ErrorMessage”]; pertanto, ogni volta che ricevi un errore in un formato diverso (ad esempio, un codice di stato HTTP 520, 504, 502, 1020 e così via), puoi tentare di risolvere il problema ripetendo la chiamata all'API subito dopo, sperando che abbia esito positivo.