Kraken APIの使用方法

Kraken APIは、データのパブリックエンドポイントとアカウントアクションのプライベートエンドポイントを使用して、RESTおよびWebSocketを介した自動取引およびリアルタイム市場データアクセスを可能にします。

2025/08/02 10:28

Kraken APIとその目的を理解する

Kraken APIは、開発者とトレーダーがプログラムでKraken Cryptocurrency Exchangeと対話できるようにする強力なツールです。これにより、自動化された取引、ポートフォリオ管理、リアルタイム市場データの検索、およびWebインターフェイスに依存せずにアカウントの監視を可能にします。 APIは両方のパブリックエンドポイントをサポートしています。これは、ティッカー情報、注文書、取引履歴などの市場データを提供し、認証を必要とし、ユーザーが注文を管理し、残高を確認し、資金を引き出すことができます。

Kraken APIを効果的に使用するには、 REST APIとWebSockets APIという2つの主要なコンポーネントを理解する必要があります。 REST APIは、資産価格を取得したり注文したりするなどの1回限りのリクエストに最適です。 WebSockets APIは、ライブ価格の更新や帳簿変更など、リアルタイムデータストリーミングに使用されます。両方のAPIは、それぞれHTTPSとWebSocket接続を介してアクセス可能であり、通常はJSON形式でリクエストと応答の適切なフォーマットが必要です。

Kraken API資格情報をセットアップします

API呼び出しを行う前に、KrakenアカウントからAPIキーと秘密を生成する必要があります。 Krakenアカウントにログインし、 [設定]セクションに移動します。 [API]タブをクリックし、 [新しいAPIキー]を選択します。キーの権限を設定するように求められます。基本的なデータ検索の場合、パブリックオプションとクエリのプライベートオプションをクエリします。取引を行うか、資金を引き出すことを計画している場合は、貿易および撤回許可も有効にします。妥協したキーは資金の損失につながる可能性があるため、許可に注意してください。

キーが生成されると、2つの文字列が表示されます。

• APIキー：アカウントを識別するために使用される長い英数字の文字列。
• API Secret ：リクエストに署名するために使用されるbase64エンコード文字列。

これらをしっかりと保管してください。 APIの秘密は、クライアント側のコードまたはパブリックリポジトリに決して公開されないでください。これらの資格情報をAPIリクエストで使用するには、 HMAC-Sha512暗号化を使用して各プライベートリクエストに署名する必要があります。APIシークレットは、URIパス、NONCE、およびPOSTデータを含むキーとメッセージとしてsecretを使用する必要があります。

パブリックAPIリクエストの実行

パブリックエンドポイントは認証を必要とせず、HTTP GETリクエストを介して直接アクセスできます。これらは、市場データを取得するのに役立ちます。たとえば、Bitcoinの現在のティッカー情報を米ドル（BTC/USD）に対して取得するには、次のエンドポイントを使用します。

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

応答には、最後の取引価格、 24時間のボリューム、高価格/低価格、および入札/尋ねる料金が含まれます。その他のパブリックエンドポイントには次のものがあります。

• Assetpairs ：すべての取引可能なペアとその仕様をリストします。
• 深さ：特定のペアの現在の注文帳を返します。
• 取引：最近の貿易履歴を取得します。
• OHLC ：チャートのためにCandlestickデータを提供します。

各パブリックリクエストは、データを含むresultフィールドと問題をリストするerrorフィールドを持つJSONオブジェクトを返します。結果を処理する前に、 error配列をチェックして、アプリケーションがエラーを優雅に処理するようにしてください。

プライベートAPIリクエストの署名と送信

プライベートAPI呼び出しでは、APIキーと暗号化署名を使用した認証が必要です。すべてのリクエストには、次のヘッダーを含める必要があります。

• API-Key ：生成されたAPIキー。
• API-Sign ：メッセージのHMAC-SHA512署名。

署名されるメッセージは次のとおりです。

• URIパス（例： /0/private/Balance ）。
• NonCe値 - 1回使用される厳密に増加する整数。
• POSTデータ（例： nonce=1234567890 ）。

署名を作成するには：

• メッセージを連結してください： path + SHA256(nonce + POST data) 。
• デコードされたAPIシークレットをHMACキーとして使用します。
• HMAC-Sha512を連結したメッセージに適用します。

Pythonでは、これは次のように実装できます。

 import hashlib
 import hmac
 import time def get_kraken_signature（urlpath、data、secret）：





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()
 /0/private/Balanceまたは/0/private/AddOrderなどのエンドポイントに投稿リクエストを行うときに、 API-Signヘッダーでこの署名を使用します。
 
実際のユースケースとコードの例
一般的なユースケースは、アカウントの残高を確認することです。これを行うには：
 
https://api.kraken.com/0/private/Balanceに投稿リクエストを送信します。
ポストボディにnonceを含めます。
 API-KeyおよびAPI-Signヘッダーを設定します。
別の例は、制限購入注文を配置することです。
 
/0/private/AddOrderエンドポイントを使用します。
 pair=XXBTZUSD 、 type=buy 、 ordertype=limit 、 price=30000 、 volume=0.01などのパラメーターを含めます。
 Nonceが前のものよりも大きいことを確認してください。
リアルタイムデータについては、WebSockets APIを使用します。 wss://ws.kraken.com/v2に接続します。 ticker 、 book 、または特定のペアのtradeなどのチャネルを購読します。たとえば、ライブBTC/USD取引を取得するには：
 
{
 「方法」：「購読」、
 「パラメーション」：{
 
'channel': 'trade', 'symbol': 'BTC/USD', 'snapshot': true
 }
 }

サーバーは、トレードアップデートが発生するとプッシュされます。アプリケーションでイベントリスナーを使用して着信メッセージを処理します。

セキュリティのベストプラクティスとレートの制限

Krakenは、虐待を防ぐためにレート制限を実施します。パブリックエンドポイントでは、IPごとに最大10秒のリクエストを許可します。プライベートエンドポイントは、APIキーごとに1秒あたり15のリクエストに制限されています。これらの制限を超えると、一時的な禁止が発生します。これを回避するには、コードにリクエストスロットリングと指数関数的なバックオフを実装します。

セキュリティを強化する：

• APIキーにIPホワイトリストを使用します。
• 不必要な権限を無効にします。
• 定期的にAPIキーを回転させます。
• APIシークレットをプレーンテキストに記録または保存しないでください。

レストコールには常にHTTPSを使用し、WSSSにはWSSを使用してください。生産環境でSSL証明書を検証します。

---

よくある質問

Kraken APIリクエストのNONCEの正しい形式は何ですか？

Nonceは、各リクエストとともに増加する整数でなければなりません。ほとんどの開発者は、マイクロ秒単位でUNIXタイムスタンプを使用しています。たとえば、Pythonのint(time.time() * 1000000)は、一意性と単調な成長を保証します。ノンセを再利用または減少させると、APIがリクエストを拒否します。

実際の資金を危険にさらすことなく、Kraken APIをテストするにはどうすればよいですか？

Krakenはサンドボックス環境を提供していません。ただし、引き出しまたは取引許可なしで新しいAPIキーを作成し、それを使用してバランスクエリと市場データの検索をテストすることができます。シミュレーションを取引するには、市場データを取得し、実際の注文を送信せずに注文実行をローカルにシミュレートします。

なぜ「EAPI：無効なキー」エラーを取得するのですか？

このエラーは、Api-Keyヘッダーが欠落、奇形、または認識されていないことを示しています。キーがKrakenダッシュボードから正確にコピーされ、リクエストヘッダーに含まれていることを再確認します。また、余分なスペースやラインブレークが存在しないことを確認してください。

Kraken APIを使用して、履歴のろうそく足データを取得できますか？

はい。 pairとintervalパラメーターを使用して/0/public/OHLCエンドポイントを使用します。たとえば、 pair=XXBTZUSD&interval=60 1時間のキャンドルを返します。応答には、時間、オープン、ハイ、ロー、クローズ、ボリュームデータが含まれます。 Krakenは、履歴データをリクエストごとに一定数の最近の間隔に制限することに注意してください。