So verwenden Sie die Kraken -API

Verständnis der Kraken -API und ihres Zwecks

Die Kraken -API ist ein leistungsstarkes Tool, mit dem Entwickler und Händler programmgesteuert mit dem Kraken Craken Craken Cryptocurrency Exchange interagieren können. Es ermöglicht automatisierte Handel, Portfoliomanagement, Echtzeit-Marktdatenabruf und Kontoüberwachung, ohne sich auf die Webschnittstelle zu verlassen. Die API unterstützt beide öffentlichen Endpunkte , die Marktdaten wie Tickerinformationen, Auftragsbücher und Handelsgeschichte sowie private Endpunkte bereitstellen, für die Authentifizierung erforderlich ist und Benutzern es ermöglicht, Bestellungen zu überprüfen, die Guthaben zu überprüfen und Mittel zurückzuziehen.

Um die Kraken -API effektiv zu verwenden, müssen Sie ihre beiden Hauptkomponenten verstehen: REST -API und WebSockets -API . Die Rest-API ist ideal für einmalige Anfragen wie das Abnehmen von Vermögenspreisen oder die Bestellung. Die WebSockets-API wird für Echtzeitdaten-Streaming verwendet, z. B. Live-Preis-Updates oder Bestellbuchänderungen. Beide APIs sind über HTTPS- bzw. WebSocket -Verbindungen zugänglich und erfordern die ordnungsgemäße Formatierung von Anforderungen und Antworten, die normalerweise im JSON -Format sind.

Einrichten Ihrer Kraken -API -Anmeldeinformationen

Bevor Sie API -Anrufe tätigen, müssen Sie Ihren API -Schlüssel und Ihr Geheimnis aus Ihrem Kraken -Konto generieren. Melden Sie sich in Ihrem Kraken -Konto an und navigieren Sie zum Abschnitt "Einstellungen" . Klicken Sie auf die Registerkarte API und wählen Sie dann neue API -Taste . Sie werden aufgefordert, Berechtigungen für den Schlüssel festzulegen. Aktivieren Sie für grundlegende Datenabrufe die öffentlichen Abfragen und Fragen Sie private Optionen. Wenn Sie vorhaben, Geschäfte zu platzieren oder Mittel abzuheben, aktivieren Sie auch Handels- und Abhebungsberechtigungen . Seien Sie vorsichtig mit Berechtigungen, da gefährdete Schlüssel zu Fondsverlusten führen können.

Sobald der Schlüssel generiert ist, sehen Sie zwei Zeichenfolgen:

• API -Schlüssel : Eine lange alphanumerische Zeichenfolge, mit der Ihr Konto identifiziert wird.
• API Secret : Eine Basis64-kodierte Zeichenfolge, die zum Unterschreiben von Anforderungen verwendet wird.

Lagern Sie diese sicher. Das API-Geheimnis sollte niemals im kundenseitigen Kodex oder in öffentlichen Repositorys ausgesetzt sein. Um diese Anmeldeinformationen in API-Anfragen zu verwenden, müssen Sie jede private Anforderung mithilfe der HMAC-SHA512- Verschlüsselung unterschreiben, wobei der API-Geheimnis als Schlüssel und eine Nachricht, die den URI-Pfad, Nonce und Postdaten enthält, enthält.

Ausführung öffentlicher API -Anfragen

Öffentliche Endpunkte erfordern keine Authentifizierung und können direkt über HTTP -Anfragen zugegriffen werden. Diese sind nützlich, um Marktdaten abzurufen. Verwenden Sie beispielsweise die aktuellen Ticker -Informationen für Bitcoin gegen den US -Dollar (BTC/USD), den folgenden Endpunkt:

 https://api.kraken.com/0/public/Ticker?pair=XXBTZUSD

Die Antwort umfasst den zuletzt gehandelten Preis , 24-Stunden-Volumen , hohe/niedrige Preise und BID/AS-Preise . Weitere öffentliche Endpunkte sind:

• AssetPairs : Listet alle handelbaren Paare und deren Spezifikationen auf.
• Tiefe : Gibt das aktuelle Bestellbuch für ein bestimmtes Paar zurück.
• Trades : Ruft die jüngste Handelsgeschichte ab.
• OHLC : Bietet Candlestick -Daten zum Diagramm.

Jede öffentliche Anfrage gibt ein JSON -Objekt mit einem result zurück, das die Daten und ein error enthält, das Probleme auflistet. Stellen Sie sicher, dass Ihre Anwendung Fehler ordnungsgemäß behandelt, indem Sie das error überprüfen, bevor Sie das Ergebnis verarbeiten.

Unterzeichnung und Senden von privaten API -Anfragen

Private API -Aufrufe erfordern eine Authentifizierung mit Ihrem API -Schlüssel und einer kryptografischen Signatur . Jede Anfrage muss die folgenden Header enthalten:

• API-Key : Ihr generierter API-Schlüssel.
• API-Sign : Die HMAC-SHA512-Signatur der Nachricht.

Die zu signierte Nachricht besteht aus:

• Der URI -Pfad (zB /0/private/Balance ).
• Ein Nonce -Wert - eine streng zunehmende Ganzzahl einmal verwendet.
• Die Postdaten (z. nonce=1234567890 ).

Um die Signatur zu konstruieren:

• Verkettieren Sie die Nachricht als: path + SHA256(nonce + POST data) .
• Verwenden Sie das dekodierte API -Geheimnis als HMAC -Schlüssel.
• Wenden Sie HMAC-SHA512 auf die verkettete Nachricht an.

In Python kann dies implementiert werden als:

 import hashlib import hmac import time Def get_kraken_signature (UrlPath, Daten, Geheimnis):
postdata = urllib.parse.urlencode(data) encoded = (str(data['nonce']) + postdata).encode() message = urlpath.encode() + hashlib.sha256(encoded).digest() mac = hmac.new(base64.b64decode(secret), message, hashlib.sha512) return base64.b64encode(mac.digest()).decode()
 Verwenden Sie diese Signatur im API-Sign Header, wenn Sie Postanforderungen an Endpunkte wie /0/private/Balance oder /0/private/AddOrder erstellen.
 
Praktische Anwendungsfälle und Codebeispiele
 Ein allgemeiner Anwendungsfall besteht darin, Ihren Kontostand zu überprüfen. Um dies zu tun:
 

• Senden Sie eine Postanforderung an https://api.kraken.com/0/private/Balance .
• Fügen Sie den nonce in den Postkörper ein.
• Stellen Sie die Header für API-Key und API-Sign ein.

Ein weiteres Beispiel ist die Aufgabe einer Limit -Kaufbestellung:

• Verwenden Sie den Endpunkt /0/private/AddOrder .
• Fügen Sie Parameter wie pair=XXBTZUSD , type=buy , ordertype=limit , price=30000 und volume=0.01 hinzu.
• Stellen Sie sicher, dass der Nonce größer ist als der vorherige.

Verwenden Sie für Echtzeitdaten die WebSockets-API. Stellen Sie eine Verbindung zu wss://ws.kraken.com/v2 . Abonnieren Sie Kanäle wie ticker , book oder trade für bestimmte Paare. Zum Beispiel, um Live -BTC/USD -Trades zu erhalten:

{

'Methode': 'abonnieren', 'Params': {{

'channel': 'trade', 'symbol': 'BTC/USD', 'snapshot': true

} }

Der Server wird beim Auftreten von Handelsaktualisierungen vorangetrieben. Behandeln Sie eingehende Nachrichten mithilfe von Ereignishörern in Ihrer Anwendung.

Best Practices und Ratenbegrenzung für Sicherheitsbeschwerden

Kraken erzwingt Tarifgrenzen , um Missbrauch zu verhindern. Öffentliche Endpunkte erlauben bis zu 10 Anfragen pro Sekunde pro IP. Private Endpunkte sind auf 15 Anfragen pro Sekunde pro API -Schlüssel begrenzt. Das Überschreiten dieser Grenzen führt zu temporären Verboten. Um dies zu vermeiden, implementieren Sie Anforderungsdrossung und exponentielle Backoff in Ihrem Code.

Sicherheit verbessern durch:

• Verwenden Sie IP Whitelisting für Ihre API -Schlüssel.
• Unnötige Berechtigungen deaktivieren.
• Rotierende API -Schlüssel regelmäßig rotieren.
• Niemals API -Geheimnisse in Klarheit anmelden oder speichern.

Verwenden Sie immer HTTPS für REST -Anrufe und WSS für Websockets. Validieren Sie SSL -Zertifikate in Produktionsumgebungen.

Häufig gestellte Fragen

Was ist das richtige Format für die Nonce in Kraken -API -Anfragen? Der Nonce muss eine Ganzzahl sein, die mit jeder Anfrage zunimmt. Die meisten Entwickler verwenden UNIX -Zeitstempel in Mikrosekunden. Zum Beispiel sorgt int(time.time() * 1000000) in Python Einzigartigkeit und monotones Wachstum. Die Wiederverwendung oder Verringerung des Nonce führt dazu, dass die API die Anfrage ablehnt.

Wie kann ich die Kraken -API testen, ohne echte Mittel zu riskieren? Kraken bietet keine Sandkastenumgebung. Sie können jedoch einen neuen API -Schlüssel ohne Rückzugs- oder Handelsberechtigungen erstellen und diese zum Testen von Abfragen und dem Abrufen von Marktdaten verwenden. Für Handelssimulationen finden Sie Marktdaten und simulieren Sie die Bestellausführung lokal, ohne reale Bestellungen zu senden.

Warum bekomme ich einen Fehler "EAPI: Ungültiger Schlüssel"? Dieser Fehler zeigt an, dass der API-Key-Header fehlt, missgebildet oder nicht erkannt wird. Überprüfen Sie, ob der Schlüssel genau aus dem Kraken-Dashboard kopiert und in den Anforderungsheadern enthalten ist. Stellen Sie außerdem sicher, dass keine zusätzlichen Räume oder Linienbrüche vorhanden sind.

Kann ich die Kraken -API verwenden, um historische Candlestick -Daten abzurufen? Ja. Verwenden Sie den Endpunkt /0/public/OHLC mit den pair und interval . Zum Beispiel pair=XXBTZUSD&interval=60 gibt 1-stündige Kerzen zurück. Die Antwort umfasst Zeit-, offene, hoch, niedrige, schließende und Volumendaten. Beachten Sie, dass Kraken historische Daten auf eine bestimmte Anzahl von jüngsten Intervallen pro Anfrage beschränkt.