Kraken WebSocket API – Často kladené otázky

Má Kraken WebSocket API? Jak se k němu mohu připojit?

Kraken má jak REST API, tak WebSocket API. Naše WebSocket API je k dispozici na následujících zabezpečených URL adresách:

Veřejné (neověřené) datové kanály trhu: wss://ws.kraken.com/

Soukromé (ověřené) datové kanály účtu a obchodní koncové body: wss://ws-auth.kraken.com/

Pro připojení k veřejným datovým kanálům trhu není vyžadováno ověření, ale pro soukromé kanály je vyžadován platný ověřovací token.

Všechny zprávy odesílané a přijímané prostřednictvím WebSocket API jsou kódovány jako prostý text ve formátu JSON. Podrobnosti o každém typu zprávy jsou uvedeny v naší dokumentaci k WebSocket API.

Máte k dispozici knihovny WebSocket?

Máme k dispozici různé příklady kódu WebSocket API, které lze použít buď přímo, nebo jako výchozí bod pro vaši vlastní implementaci:

Naše WebSocket API lze implementovat v jakémkoli programovacím jazyce, který preferujete, a náš tým podpory API Vám rád pomůže nebo poskytne příklady kódu v dalších jazycích, pokud to bude potřeba.

Které kanály/koncové body jsou podporovány?

Naše WebSocket API poskytuje řadu datových kanálů trhu v reálném čase, datových kanálů účtu a obchodních koncových bodů. Kompletní seznam dostupných kanálů/koncových bodů, spolu s podrobnostmi implementace pro každý kanál/koncový bod, naleznete v naší dokumentaci k WebSocket API.

Jak poznám, že jsem úspěšně připojen? Jak poznám, že jsem stále připojen?

Při odběru kanálu bude přijata zpráva {u'event': u'heartbeat'} s frekvencí 1 heartbeat za sekundu.

Heartbeaty nebudou přijímány, pokud jsou místo nich přijímány jiné zprávy (tržní data, data účtu atd.). Kdy a proč jsou přijímána tržní data nebo data účtu, závisí na kanálu, k němuž jste přihlášeni.

Pokud se přihlašujete k odběru kanálu měnového páru s nízkým objemem obchodování, můžete po dlouhou dobu přijímat pouze heartbeaty.

Pokud se odhlásíte z odběru kanálu, nebudete již dostávat heartbeaty ani obchodní data a po 1 minutě bez odběru jakéhokoli kanálu budete odpojeni od kanálu WebSockets.

Kdy a proč WebSocket odesílá aktualizovaná data?

Kdy a proč jsou přijímána tržní data nebo data účtu, závisí na kanálu, k němuž jste přihlášeni. Například:

Ticker: Když dojde k obchodu nebo dávce obchodů pro měnový pár, je pro tento pár publikována zpráva tickeru. Tuto zprávu obdržíte pouze v případě, že jste přihlášeni k odběru kanálu tickeru pro tento pár.

Trade: Podobně, když dojde k obchodu nebo dávce obchodů pro měnový pár, je pro tento pár publikována také obchodní zpráva. Tuto zprávu obdržíte pouze v případě, že jste přihlášeni k odběru obchodního kanálu pro tento pár.

OHLC: Aktualizovaný interval OHLC je publikován pro každý interval, když je proveden obchod nebo dávka obchodů pro měnový pár. Aktualizace obdržíte pouze pro intervaly, k nimž jste přihlášeni. Po překročení hranice intervalu není odeslána žádná zpráva, dokud nedojde k dalšímu obchodu.

Book: Po prvním přihlášení k odběru kanálu Book je publikován počáteční snímek knihy objednávek s vybranou hloubkou.

Jakmile jsou do knihy objednávek přidány nové objednávky nebo jsou provedeny obchody, které ovlivňují hloubku knihy objednávek, k níž jste přihlášeni, je publikována zpráva obsahující aktualizace knihy objednávek pro všechny ovlivněné cenové úrovně a objemy. Tyto aktualizace mohou obsahovat pouze nabídky (bids), pouze poptávky (asks) nebo obojí. Podrobnosti naleznete v části Jak sestavit knihu objednávek níže.

Spread: Když je umístěna nová nejvyšší nabídka (bid) nebo nejnižší poptávka (ask), nebo je proveden obchod, který změní nejlepší nabídkovou nebo poptávkovou cenu, je publikována zpráva spreadu s aktualizovanými cenami nabídky a poptávky.

Poskytují kanály WebSocket historická data nebo pouze aktuální data?

Datové kanály trhu WebSocket poskytují pouze aktuální data, nicméně je možné se současně připojit k WebSocket API pro aktuální data a k REST API pro historická data.

Použití parametru reqid.

Požadavky na odběr mohou obsahovat klientem poskytnutý parametr reqid, který lze následně použít k přiřazení požadovaného požadavku na odběr WebSocket k ID kanálu pro tento odběr.

Všimněte si, že pokud provedete více odběrů WebSocket současně, všem bude přiřazena stejná hodnota reqid. Pro přiřazení jiné hodnoty reqid musí být každý kanál přihlášen individuálně.

Chci více podrobností, kde je najdu?

Kompletní specifikace WebSocket API je k dispozici v dokumentaci k WebSocket API.

Rozdíly mezi symboly měnových párů v REST a WebSocket API.

WebSocket API přijímá symboly měnových párů pouze ve formátu ISO 4217-A3, například XBT/USD.

Koncový bod REST API AssetPairs lze použít k překladu symbolů mezi verzemi REST API (jako XBTUSD nebo XXBTZUSD) a verzí WebSocket API (jako XBT/USD).

https://api.kraken.com/0/public/AssetPairs

Pole wsname poskytuje symbol WebSocket API.

Jak sestavit knihu objednávek

Kanál Book WebSocket API je nejsložitější ze všech kanálů WebSocket, ale pokud jsou zprávy kanálu Book interpretovány správně, je možné udržovat lokální kopii knihy objednávek s pouhými několika řádky kódu.

Naše stránky podpory WebSocket API poskytují podrobné pokyny pro interpretaci zpráv kanálu Book, spolu s příkladem přepisu kanálu Book a příkladem kódu (v Pythonu) pro udržování platné lokální kopie knihy objednávek.

Jaké jsou limity připojení WebSocket API?

WebSocket API omezuje maximální počet souběžných připojení, aby poskytovalo ochranu proti zneužití (například útokům DDoS). Pokud váš klient WebSocket provede příliš mnoho připojení současně, obdržíte následující chybovou zprávu:

{“error”: {“message”: “You have reached maximum capacity for WebSocket connections. Please reach out to Kraken support team for any questions.“, “hint”: “Your code may be reconnecting too often or when it has no need to.“, “name”: “WebSocket connection rate error”}}

WebSocket API umožňuje více odběrů kanálů prostřednictvím jednoho připojení WebSocket (například odběr všech dostupných tržních dat pro měnový pár XBT/USD prostřednictvím jednoho připojení), takže je možné streamovat všechna dostupná tržní data pro všechny měnové páry bez dosažení limitů připojení WebSocket.

Jaké jsou limity rychlosti WebSocket API?

Stejné limity rychlosti obchodování platí pro všechna rozhraní pro zadávání objednávek (webové stránky, Kraken Terminal, REST a WebSocket API) a jsou podrobně vysvětleny na naší stránce podpory limitů rychlosti.

Limit rychlosti zpráv jednoho připojení WebSocket API se bude lišit v závislosti na zatížení systému. Klienti WebSocket API obdrží chybovou zprávu {"Error": "Exceeded msg rate"}, když je limit rychlosti zpráv překročen.

Obchodování (zadávání/rušení objednávek) prostřednictvím WebSocket API.

Obchodování prostřednictvím WebSocket API je k dispozici prostřednictvím koncových bodů addOrder a cancelOrder, které se používají k zadávání nových objednávek a rušení stávajících (otevřených) objednávek.

Obchodní koncové body WebSocket jsou k dispozici prostřednictvím stejného soukromého připojení WebSocket (wss://ws-auth.kraken.com/) jako soukromé kanály pro správu účtu (openOrders a ownTrades).

Úplné podrobnosti týkající se obchodních koncových bodů jsou k dispozici v dokumentaci k WebSocket API a naše stránky podpory WebSocket API poskytují další informace a příklady použití obchodních koncových bodů ve vašem vlastním kódu.

Proč při připojení k WebSocket API dostávám chybu 403?

Připojení WebSocket API jsou zprostředkována přes Cloudflare, proto jakékoli bezpečnostní nastavení implementované společností Cloudflare může ovlivnit připojení k veřejným (wss://ws.kraken.com) i soukromým (wss://ws-auth.kraken.com) URL adresám.

Cloudflare vyžaduje, aby pro všechna připojení TLS bylo použito Server Name Indication (SNI), jinak by připojení WebSocket selhalo a místo toho by byla vrácena chyba HTTP 403 Forbidden. Stránky podpory Cloudflare poskytují další podrobnosti týkající se jejich požadavku TLS SNI.

Naše oficiální knihovna Python WebSocket API byla aktualizována tak, aby podporovala TLS SNI, ale některé knihovny WebSocket API třetích stran mohou být stále ovlivněny. Obraťte se prosím na náš tým podpory API, pokud potřebujete pomoc s aktualizací kódu WebSocket API pro podporu TLS SNI.

Pomoc s WebSocket API.

Obraťte se prosím na náš tým podpory API, pokud potřebujete pomoc s implementací vašeho klienta WebSocket API.