Pokročilé API FAQ

Naposledy aktualizováno: 25. listopadu 2025

Možné hodnoty stavu pro transakce vkladů/výběrů

Pomocí koncových bodů REST API pro financování mohou klienti vkládat/vybírat prostředky na/z jejich účtu Kraken a žádat o stav transakce vkladu/výběru v reálném čase.

Vklady/výběry procházejí několika fázemi mezi počátečním požadavkem a dokončením transakce, proto koncové body pro financování vrátí jinou hodnotu stavu v závislosti na tom, kdy jsou volány.

Všimněte si, že hodnoty stavu původně pocházely ze stránek 16/17 dokumentu Internet Financial Exchange Protocol (IFEX), ale hodnoty byly mírně upraveny, aby byly vhodnější pro krypto transakce (například se nepoužívají všechny možné hodnoty stavu).

Vklady

Možné hodnoty stavu pro transakce vkladů jsou následující:

•
Vypořádáno = Vklad byl přijat, ale stále potřebuje další potvrzení na blockchainu.
•
Úspěch = Vklad dosáhl požadovaného počtu potvrzení na blockchainu.
•
Selhání = Vklad se nezdařil (z jednoho nebo více různých důvodů).

Následují některé příklady, jak by se výše uvedené hodnoty stavu objevily v odpovědích z koncového bodu DepositStatus:

Stav Vypořádáno:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906dde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Settled"}]}

Stav Úspěch:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"QSB7IFM-Q3LT3X-NVAOKE","txid":"92c908ea2ea819d678d67130e4d20b625a8f97f3cfff45f906tdde8cef41a046a","info":"D7SLwMBPqfFMCZ8EJDMoVEePpZAFFegLt8","amount":"997.00000000","fee":"0.00000000","time":1611308478,"status":"Success"}]}

Výběry

Možné hodnoty stavu pro transakce výběrů jsou následující:

•
Počáteční = Žádost o výběr byla přijata a je kontrolována na platnost (jakákoli omezení financování na účtu atd.).
•
Čekající = Výběr čeká na zpracování naší platební bránou.
•
Vypořádáno = Výběr byl odeslán na blockchain (v tomto okamžiku by bylo k dispozici ID transakce blockchainu).
•
Úspěch = Transakce výběru má alespoň 1 potvrzení na blockchainu.
•
Pozastaveno = Výběr byl pozastaven a musí být ručně zkontrolován naším týmem pro financování.
•
Selhání = Výběr se nezdařil (z jednoho nebo více různých důvodů).

Následují některé příklady, jak by se výše uvedené hodnoty stavu objevily v odpovědích z koncového bodu WithdrawStatus:

Stav Počáteční:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Initial"}]}

Stav Čekající:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Pending"}]}

Stav Vypořádáno:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Settled"}]}

Stav Úspěch:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":"064536e901f2cbfa6e279aa7a87c700b64e0ce561bf6e266788c47496f75106c","info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Success"}]}

Stav Selhání:{"error":[],"result":[{"method":"Dogecoin","aclass":"currency","asset":"XXDG","refid":"ASBCMYC-F5ETQT-34NMWT","txid":null,"info":"DGNBPsa2GhhtZGEZo79uF3WN2bTxFxmc9y","amount":"98.00000000","fee":"2.00000000","time":1612782924,"status":"Failure","status-prop":"canceled"}]}

Další informace týkající se vkladů/výběrů jsou k dispozici na našich stránkách podpory pro financování hotovostí a financování kryptoměnami.

Jak získat historický čas a prodeje (historii obchodování) pomocí koncového bodu REST API Trades

Koncový bod REST API OHLC poskytuje pouze omezené množství historických dat, konkrétně 720 datových bodů požadovaného intervalu. Například vyžádání dat OHLC v 1minutových intervalech vrátí nejnovějších 720 minut (12 hodin) dat.

Pro aplikace, které vyžadují další data OHLC nebo tick data, je možné získat celou obchodní historii našich trhů (historický čas a prodeje) prostřednictvím koncového bodu REST API Trades. OHLC pro jakýkoli časový rámec a jakýkoli interval lze poté vytvořit z historických dat času a prodejů.

Koncový bod Trades přijímá volitelný parametr s názvem since, který určuje počáteční datum/čas dat. Hodnota since je UNIXový časový údaj v nanosekundovém rozlišení (standardní UNIXový časový údaj v sekundách s 9 dalšími číslicemi).

Například volání koncového bodu Trades, jako je https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559347200000000000 by vrátilo historický čas a prodeje pro XBT/USD od 1. června 2019 v 00:00:00 UTC:

{"error":[],"result":{"XXBTZUSD":[["8552.90000","0.03190270",1559347203.7998,"s","m",""],["8552.90000","0.03155529",1559347203.8086,"s","m",""],["8552.90000","0.00510797",1559347203.9664,"s","m",""],["8552.90000","0.09047336",1559347203.9789,"s","m",""],["8552.90000","0.00328738",1559347203.9847,"s","m",""],["8552.90000","0.00492152",1559347203.9897,"s","m",""],["8552.90000","0.00201848",1559347203.9937,"s","m",""],["8552.90000","0.11422068",1559347203.9993,"s","m",""],["8552.90000","0.00425858",1559347204.071,"s","m",""],["8552.90000","0.00427679",1559347204.0762,"s","m",""],["8552.90000","0.06381401",1559347204.1662,"s","m",""]
...
["8579.50000","0.05379597",1559350785.248,"s","l",""],["8579.50000","0.94620403",1559350785.2936,"s","l",""],["8578.10000","0.45529068",1559350785.297,"s","l",""]],"last":"1559350785297011117"}}

Následná volání koncového bodu Trades by měla nahradit hodnotu parametru since hodnotou parametru last z výsledků předchozího volání, například https://api.kraken.com/0/public/Trades?pair=xbtusd&since=1559350785297011117.

Použití speciální hodnoty since 0 (nula) by vrátilo historický čas a prodeje od začátku trhu (počínaje úplně prvním obchodem).

Jak zadávat, zobrazovat a rušit objednávky pomocí uživatelské reference

Uživatelská reference je ID objednávky poskytnuté klientem, které lze použít namísto skutečného (API poskytnutého) ID objednávky pro některé úkoly správy objednávek (zejména rušení objednávek).

Uživatelské reference jsou implementovány tak, aby byly co nejflexibilnější, a proto je lze použít různými způsoby, včetně:

•
jako jedinečné ID (kde každá objednávka má jinou uživatelskou referenci),
•
pro seskupení souvisejících objednávek (například seskupení objednávek s různými úrovněmi pákového efektu),
•
nebo jako záložní ID v případě, že skutečné ID objednávky není známo.

Uživatelská reference musí být číselná hodnota mezi 1 a 2 147 483 647 (v podstatě jakékoli kladné 32bitové číslo) a proto by mohla být implementována jako jednoduché počítadlo, jako náhodná 32bitová hodnota se znaménkem, nebo dokonce jako časové razítko v sekundách (i když by to selhalo po 19. lednu 2038 v 3:14:07 UTC).

Zadávání objednávek s uživatelskou referencí

Objednávky lze zadávat s připojenou uživatelskou referencí voláním koncového bodu AddOrder a zahrnutím parametru userref s uživatelskou referencí jako hodnotou:

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=limit price=0.1 volume=50 userref=27649653

{"error":[],"result":{"descr":{"order":"buy 50.00000000 XDGUSD @ limit 0.1000000"},"txid":["OQJSXE-F5FOM-IXHVL4"]}}

Zobrazení objednávek s uživatelskou referencí

Objednávky, které již mají připojenou uživatelskou referenci, lze zobrazit voláním koncových bodů Open/Closed/QueryOrders a zahrnutím parametru userref s existující uživatelskou referencí jako hodnotou (v tomto případě uživatelská reference funguje jako filtr, zobrazující pouze související objednávky):

$ ./krakenapi OpenOrders userref=27649653

{"error":[],"result":{"open":{"OQJSXE-F5FOM-IXHVL4":{"refid":null,"userref":27649653,"status":"open","opentm":1629618802.9812,"starttm":0,"expiretm":0,"descr":{"pair":"XDGUSD","type":"buy","ordertype":"limit","price":"0.1000000","price2":"0","leverage":"none","order":"buy 50.00000000 XDGUSD @ limit 0.1000000","close":""},"vol":"50.00000000","vol_exec":"0.00000000","cost":"0.000000000","fee":"0.000000000","price":"0.000000000","stopprice":"0.000000000","limitprice":"0.000000000","misc":"","oflags":"fciq"}}}}

$ ./krakenapi ClosedOrders userref=38695724

{"error":[],"result":{"closed":{"O7YEFN-3V4RK-FBNSNM":{"refid":null,"userref":38695724,"status":"canceled","reason":"User requested","opentm":1629619539.3593,"closetm":1629619542.2246,"starttm":0,"expiretm":0,"descr":{"pair":"XBTUSD","type":"buy","ordertype":"limit","price":"25000.0","price2":"0","leverage":"none","order":"buy 0.00010000 XBTUSD @ limit 25000.0","close":""},"vol":"0.00010000","vol_exec":"0.00000000","cost":"0.00000","fee":"0.00000","price":"0.00000","stopprice":"0.00000","limitprice":"0.00000","misc":"","oflags":"fciq"}},"count":1}}

Rušení objednávek s uživatelskou referencí

Objednávky, které již mají připojenou uživatelskou referenci, lze zrušit pomocí uživatelské reference voláním koncového bodu CancelOrder a použitím uživatelské reference jako hodnoty txid (namísto hodnoty ID objednávky):

$ ./krakenapi CancelOrder txid=16764529

{"error":[],"result":{"count":1}}

Všimněte si, že všechny otevřené objednávky se stejnou uživatelskou referencí by byly zrušeny, proto je možné provést jediné volání CancelOrder pro zrušení více objednávek současně (jak je naznačeno hodnotou count 3 v následující odpovědi):

$ ./krakenapi CancelOrder txid=48695624

{"error":[],"result":{"count":3}}

Proč dostávám chybu 403 při používání Kraken API?

Tento problém může souviset s Cloudflare:

https://support.cloudflare.com/hc/en-us/articles/200169226-Why-am-I-getting-a-403-error-

POZNÁMKA: Kraken má povolenou funkci „Kontrola integrity prohlížeče“.

K tomu může dojít, pokud váš požadavek obsahuje podezřelé hlavičky. Například váš požadavek může postrádat uživatelského agenta nebo používat nestandardního uživatelského agenta; zkontrolujte proto hlavičky svého požadavku.

Pokud nejste schopni vytvořit žádné standardní požadavky, které náš systém povoluje, zašlete nám kompletní kopii požadavku (požadavků), které se pokoušíte provést, včetně vaší IP adresy a všech hlaviček. Tyto informace by nám umožnily další šetření.

Nabízí Kraken testovací prostředí API?

Futures API

Pro naše Futures REST a WebSocket API (futures.kraken.com) nabízíme kompletní testovací prostředí pomocí URL API demo-futures.kraken.com.

Testovací prostředí REST, WebSocket a FIX

Pro naše spotové REST/WebSocket API a FIX API v současné době nabízíme testovací prostředí pro kvalifikované klienty. Přístup do tohoto prostředí vyžaduje proces onboardingu, který lze zahájit přímým kontaktováním týmu API.

Testování našeho API pomocí testovacího parametru Validate

Při zadávání objednávky prostřednictvím koncových bodů REST API AddOrder nebo WebSocket API addOrder lze k simulaci objednávky použít vstupní parametr validate.

Volání AddOrder/addOrder s parametrem validate nastaveným na true (validate=1, validate=true, validate=anything atd.) způsobí kontrolu podrobností objednávky na chyby, ale odpověď API nikdy nebude obsahovat ID objednávky (které by bylo vždy vráceno pro úspěšnou objednávku bez parametru validate).

Příklad volání AddOrder s parametrem validate (všimněte si chybějícího ID objednávky):

Bash

$ ./krakenapi AddOrder pair=xdgusd type=buy ordertype=market volume=5000 validate=true{"error":[],"result":{"descr":{"order":"buy 5000.00000000 XDGUSD @ market"}}}

Malé reálné objednávky a/nebo objednávky s extrémními cenami

Pro komplexní test API pomocí parametru Validate doporučujeme zadávat velmi malé tržní objednávky (objednávky na minimální velikost objednávky) nebo limitní objednávky, které jsou cenově daleko od aktuální tržní ceny (například zadání limitní objednávky na prodej ETH/USD za 800 $ při tržní ceně 200 $).

Testování pomocí živých objednávek umožňuje vašemu API kódu interagovat s naším API v reálných podmínkách, a proto bude každý aspekt testu přesný (jak vaše objednávky ovlivňují knihu objednávek atd.).

Upgrade TLS, který může ovlivnit vaše připojení API

Z bezpečnostních důvodů jsme nedávno ukončili podporu pro TLS 1.0 a 1.1. Pokud se při pokusu o připojení k našemu API setkáváte s chybovými zprávami připojení SSL/TLS, je to pravděpodobně způsobeno použitím jednoho z těchto zastaralých standardů. Budete muset upravit svého API klienta tak, aby vynutil použití TLS 1.2/1.3, nebo upgradovat svou verzi .NET na 4.6 nebo vyšší, která používá TLS 1.2/1.3 jako standard.

Kalkulačka autentizace REST API (Google Sheet)

Následující tabulka Google Sheet může být použita k výpočtu autentizačního podpisu REST API pro jakoukoli kombinaci vstupních dat:

•
Soukromý (tajný) klíč API
•
Koncový bod API (Balance, TradeBalance, QueryOrders atd.)
•
Hodnota Nonce (více podrobností naleznete na naší stránce podpory co je nonce)
•
Vstupní parametry koncového bodu (například asset=doge)

Kalkulačka může být použita k ověření, že autentizační algoritmus byl správně implementován, čímž se předejde potenciálním problémům (zejména neočekávaným chybám neplatného klíče) později ve vývojovém cyklu.

Pokyny k použití

1
Otevřete kalkulačku autentizace REST API v prohlížeči Chrome (nebo jiném moderním webovém prohlížeči)
2
Vytvořte kopii kalkulačky na svůj vlastní Google Drive prostřednictvím nabídky Soubor -> Vytvořit kopii (pro tento krok se budete muset přihlásit ke svému účtu Google)
3
Upravte pole API klíč, koncový bod API, hodnota nonce a vstupní data pomocí vlastního API klíče a podrobností požadavku
4
Porovnejte vypočítaný autentizační podpis API s hodnotou vypočítanou vaším vlastním API kódem (obě hodnoty se musí přesně shodovat)

Z bezpečnostních důvodů doporučujeme používat autentizační kalkulačku s dočasným API klíčem a poté API klíč smazat z vašeho účtu, jakmile se prokáže, že implementace vašeho autentizačního podpisu je správná.

Příklad

Potřebuji použít obal klientské knihovny?

Hlavní výhodou používání našich obalů klientských knihoven je, že nemusíte trávit čas/úsilí vymýšlením, jak vytvářet podpisy API, je to již hotové za vás.

Pokud máte v úmyslu volat pouze veřejné metody, můžete se rozhodnout nepoužívat klientské knihovny, protože není potřeba žádná autentizace.

Seznam dostupných obalů naleznete zde.