Chybové zprávy API

Chyby „Permission denied“ jsou vráceny, když se klient API pokouší o úkol, ke kterému klíč API nemá oprávnění. Například pokud se klient API pokusil získat zůstatek účtu pomocí klíče API, který byl nakonfigurován tak, aby umožňoval přístup k obchodování, ale nikoli k správě účtu, pak by byla vrácena chyba „permission denied“. Své klíče API a jejich nastavení (například oprávnění) si můžete prohlédnout v záložce Nastavení -> API ve správě účtu. Museli byste se ujistit, že klíče API používané vašimi aplikacemi třetích stran mají všechna nastavení a oprávnění, která vaše aplikace vyžadují.

Tato chyba je vrácena, když je klíč API použitý pro volání buď vypršelý, nebo deaktivovaný. Zkontrolujte prosím klíč API v záložce Nastavení -> API ve správě účtu nebo vygenerujte nový a aktualizujte svou aplikaci.

Kompletní seznam našich aktivních párů si můžete stáhnout z veřejného volání AssetPairs a hledat název páru jako položku Json hlaviček nebo podle parametru "altname": https://api.kraken.com/0/public/AssetPairs

Tato chyba je vrácena, když je metoda volána bez požadovaných parametrů. Například volání metody QueryOrders bez zadání platného parametru ID transakce (txid) by způsobilo vrácení chyby neplatných argumentů. Volání metody s nepotřebnými parametry by stále nevrátilo chybu neplatných argumentů, protože nepotřebné parametry by byly jednoduše ignorovány.

Chyby neplatného podpisu nastanou, pokud je váš klíč API nebo tajný klíč API nesprávně zapsán ve vašem programu, nebo proto, že data POST použitá při ověřování a data POST odeslaná do API se neshodují.Pro další referenci je níže uveden příklad kódu Python pro implementaci algoritmu podpisu API. Příslušný veřejný klíč API by měl být zkopírován a vložen ze správy účtu a metoda API a data POST by měly být odpovídajícím způsobem aktualizovány. Výstupní hodnota může být použita přímo jako hodnota pro hlavičku 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)SHA256 se vypočítá pomocí samotné hodnoty nonce a dat POST pro metodu API a data POST se skládají z párů název/hodnota pro nonce (znovu) a parametry metody API. Příklad dat, která by měla být předána SHA256 pro metodu TradeBalance, by byl následující:SHA256 = SHA256 z "1541933977000nonce=1541933977000&asset=xxbt"Řetězcová hodnota, která je předána SHA256, by neměla obsahovat žádné další nulové (\0) hodnoty a řetězcová hodnota by neměla být kódována jako base64 nebo hex (tj. řetězcová hodnota by měla být prostý textový řetězec).Cesta URI je celá URL adresa metody API kromě předpony "https://api.kraken.com", takže cesta URI metody TradeBalance (například) by byla řetězcová hodnota "/0/private/TradeBalance" bez jakýchkoli dalších nulových hodnot.HMAC SHA512 se vypočítá pomocí cesty URI a dříve vypočítaného SHA256 digestu, s base64 dekódovaným soukromým klíčem API jako klíčem HMAC. Příklad dat, která by měla být předána HMAC, by byl následující:HMAC SHA512 pomocí base64 dekódovaného soukromého klíče = HMAC z "/0/private/TradeBalanceSHA256"Hlavičky HTTP API-Key a API-Sign jsou jediné dvě požadované vlastní hlavičky HTTP. Hlavička API-Key je přesná duplikace veřejného klíče API ze správy účtu. Hlavička API-Sign je HMAC SHA512 digest kódovaný pomocí base64.

Více informací o této chybě naleznete zde:https://support.kraken.com/hc/en-us/articles/360001148063A více o Nonce a Nonce Window zde:https://support.kraken.com/hc/en-us/articles/360000906023https://support.kraken.com/hc/en-us/articles/360001148023

Chyby neplatné relace jsou vráceny prostřednictvím WebSocket API, když je učiněn pokus o přihlášení k ověřenému (privátnímu) kanálu pomocí ověřovacího tokenu, který již není platný (například vypršel).

Řešením je jednoduše požádat o nový ověřovací token prostřednictvím koncového bodu REST API GetWebSocketsToken a použít nový token pro všechny následné ověřené (privátní) požadavky na odběr.

Chyba špatného požadavku (bad request) indikuje, že něco není v pořádku se základním požadavkem HTTP (nikoli s následným požadavkem API), například neshodné URL mezi REST/WebSocket, nebo nesprávné zahrnutí dat HTTP POST:

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

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

Tato chyba je vrácena, když volaný koncový bod není platný koncový bod.

Překročili jste limit rychlosti API.

Zatímco přidávání a rušení objednávek se nezapočítává do našich standardních limitů počítadla API, tyto operace mají své vlastní počítadlo přidávání a rušení objednávek. Toto počítadlo funguje tak, že čím déle jsou objednávky ponechány v knize objednávek, tím více objednávek mohou klienti přidat nebo zrušit.

Chybové zprávy dočasného zablokování se mohou objevit, pokud jste měli příliš mnoho neúspěšných volání API nebo příliš mnoho chyb neplatného nonce v krátkém časovém období nebo neplatné podpisy. I když tato volání vrátí chybu, tato chyba se stále započítává do vašich limitů API a může vést k dočasnému zablokování.

Dočasné zablokování trvá přibližně 15 minut. Po obdržení chyby dočasného zablokování prosím počkejte 15 minut, než odešlete jakékoli nové požadavky API. Pokud spouštíte několik chyb neplatného nonce, zvyšte prosím okno nonce, protože to může pomoci snížit frekvenci výskytu těchto chyb. Zkuste také snížit frekvenci vašich soukromých volání API.

Otevírání nových spotových pozic na marži bylo dočasně pozastaveno z důvodu údržby obchodního enginu. Tato funkce se brzy vrátí a aktuální informace můžete sledovat na status.kraken.com.

Dalším důvodem může být, že spotové pozice na marži nejsou v současné době dostupné pro klienty s bydlištěm v určitých zemích.

Na Krakenu nelze otevřít long a short pozici pro stejný pár.

Pokud si přejete otevřít long a short pozici pro stejnou měnu, zvolte prosím různé obchodní páry se stejnou měnou jako základní nebo kótovanou měnou. Např.: short XBT/USD, long XBT/EUR.

Tato chyba nastane, když jste překročili limity povoleného marginu pro vaši aktuální úroveň ověření. Limity povoleného marginu pro každou měnu se liší v závislosti na vaší aktuální úrovni ověření.

Máme omezené prostředky dostupné pro rozšíření marginu. Zpráva "insufficient margin" (nedostatečný margin) naznačuje, že v příslušném marginovém fondu momentálně nemáme dostatek prostředků. Tato situace se může kdykoli změnit. Vaši objednávku se vám může podařit úspěšně zadat o několik sekund nebo minut později, ale objednávky s vysokým objemem a objednávky zadané v době vysokého objemu mohou trvat déle. Omlouváme se za případné nepříjemnosti.

Tato chyba nastane, když je nedostatečný Free Margin (volný margin) pro otevření nové pozice na účtu, nebo pokud by aktuální pokus o otevření pozice vedl k poklesu Free Marginu účtu pod 100 %.

Nemáte dostatek prostředků k zadání této objednávky. Zkontrolujte prosím své otevřené pozice a objednávky, zda neblokují vaše prostředky.

Nesplnili jste minimální objem objednávky pro toto aktivum.

Překročili jste maximální počet otevřených objednávek dostupných pro váš účet.

Tyto limity jsou založeny na vaší úrovni ověření. Zavřete prosím některé ze svých otevřených objednávek nebo ověřte svůj účet na vyšší úroveň.

Překročili jste maximální počet otevřených pozic dostupných pro váš účet.

Tyto limity jsou založeny na vaší úrovni ověření. Zavřete nebo vypořádejte některé nebo všechny své otevřené pozice, nebo pokud je to možné, ověřte svůj účet na vyšší úroveň.

Byl učiněn pokus o úpravu existující (otevřené) objednávky, ale úpravy nebyly úspěšně dokončeny. Možné důvody zahrnují nedostatečné prostředky pro novou objednávku, některé scénáře částečného plnění a některé pákové objednávky.

Nový objem je menší než již provedený/vyplněný objem.

Velikost objednávky překročila limit velikosti marginové pozice obchodního páru.

Zobrazený objem nesplnil minimální objem objednávky.

Zobrazený objem musí být menší než objem objednávky.

Iceberg objednávky nejsou kompatibilní s žádnými jinými typy objednávek kromě limitní objednávky.

Každá kryptoměna má maximálně 5 nových (nepoužitých) vkladových adres, po jejichž překročení jakýkoli pokus o vytvoření 6. nové adresy vrátí chybu.

Tato chyba se vrátí vždy, když jsou koncové body financování volány s neplatným nebo chybějícím parametrem "method". 

Vstupní parametr "key" neodpovídá popisu adresy nastavenému ve správě účtu (prostřednictvím Financování -> Výběr).

Minimální částky pro výběr se liší podle měny a jakýkoli pokus o výběr pod minimální částku by vedl k této chybě.

Jedná se o obecnou chybu, která naznačuje, že požadavek na financování nemohl být dokončen (například klienti z určitých lokalit, kteří se pokoušejí provést požadavky na on chain staking, by způsobili tuto chybu).

Požadovaný výběr nelze dokončit, protože cílová adresa postrádá požadované informace o příjemci/beneficientovi (upozorňujeme, že se to v současné době týká pouze vybraných výběrů z kanadských účtů).

Chyby služby, které zažíváte, by měly být pouze dočasné. Pokud vaše požadavky selhaly, můžete je zkusit odeslat znovu. Budeme sledovat problémy a aktualizovat naši stránku:

https://status.kraken.com/

Když čelíme problémům s degradací API, může se to pro Kraken projevit problémy ve formě zpráv o nedostupnosti služby a výpadků stránek.

Tento problém souvisí se zabezpečením vašeho účtu, které mohlo být kompromitováno. Změňte si prosím heslo a dvoufaktorové ověřování a kontaktujte naše Centrum podpory.

Tato chyba nastane, když je příznak nebo vstupní parametr dočasně nebo trvale zakázán. Chyba by měla pocházet z jednoho z předaných vstupů, kontaktujte prosím naši podporu a zašlete protokol s kompletními informacemi použitými pro volání, které chybu vygenerovalo.

Tyto chyby 5xx a 10xx ve skutečnosti nejsou chyby API, ale chyby webového serveru od Cloudflare.

Chyby API jsou vždy vráceny ve formátu JSON, například „error“:[„ErrorType:ErrorMessage“], takže kdykoli je přijata chyba v jiném formátu (například stavový kód HTTP 520, 504, 502, 1020 atd.), dočasným řešením je zkusit volání API znovu krátce poté a doufejme, že volání bude poté úspěšné.