Kraken Futures APIチュートリアル

Kraken先物とAPIエコシステムの理解

Kraken Futures APIは、 Krakenのデリバティブ市場への自動アクセスを求めるトレーダーや開発者向けに設計された強力なツールです。スポット取引とは異なり、先物はユーザーがレバレッジを使用して暗号通貨の価格の動きについて推測することを許可します。 Kraken Futures APIは、注文を配置し、市場データの取得、ポジションの管理、およびアカウントステータスの監視をプログラムで提供するためのエンドポイントを提供します。このAPIは、HTTPSおよびWebSocketプロトコルを介して動作し、RESTベースのリクエストとデータのリアルタイムストリーミングの両方を可能にします。

APIと対話するには、最初にその2つの主要な環境を理解する必要がありますfutures.kraken.comの生産環境と、 demo-futures.kraken.comのサンドボックステスト環境です。サンドボックスにより、開発者は実際の資金を危険にさらすことなく戦略をテストすることができます。すべてのエンドポイントでは、Kraken Futuresアカウントダッシュボードを介して生成されるAPIキーとシークレットを使用して認証が必要です。

プライベートエンドポイントへの各リクエストには、3つのヘッダーを含める必要があります。

• Apikey ：パブリックAPIキー
• 認証：秘密の鍵から生成されたSHA256 HMAC署名
• Nonce ：ユニークで増分数またはタイムスタンプ

これらのセキュリティ対策により、許可されたユーザーのみが注文の配置や資金の撤回などのアクションを実行できるようになります。

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

API呼び出しを行う前に、Kraken Futuresアカウント内で有効な資格情報を生成する必要があります。 Kraken FuturesダッシュボードのAPI管理セクションに移動します。開発のニーズに基づいて、正しい環境（ライブまたはデモ）にログインしていることを確認してください。

• 「新しいキーを生成する」をクリックします
• 識別を簡単にするために、APIキーに説明名を割り当てます
• 適切な権限を選択します：注文配置、読み取りバランス、および表示位置
• 追加のセキュリティに必要な場合は、IPホワイトリストを有効にします
• 生成プロセスを確認します

完了すると、 APIキー（長い英数字）とプライベートシークレットの2つの重要なコンポーネントが届きます。これらをしっかりと保管してください。ダイアログを閉じた後、秘密は再び表示されません。それを失うことは、キーを取り消して再生する必要があることを意味します。

テストのために、サンドボックス環境を使用して、ライブマーケットでの意図しない取引を避けてください。環境を切り替えるときは、それに応じてベースURLを更新します。

• サンドボックス： https://demo-futures.kraken.com
• ライブ： https://futures.kraken.com

プライベートエンドポイントの認証メカニズム

/orders 、 /positions 、または/accountなどのプライベートエンドポイントへのアクセスには、適切な認証が必要です。このプロセスの中核は、有効なHMAC-SHA256署名を生成することにあります。この署名はあなたのプライベートシークレットから派生しており、リクエストパス、ノンセ、ボディ（該当する場合）が含まれます。

認証ヘッダーを段階的に構築する方法は次のとおりです。

• 現在のUNIXタイムスタンプ（NONCE）、要求パス（ /api/v3/leads/status ）、およびリクエスト本文（POST/PUTの場合）を単一の文字列に連結します
• 私的な秘密を使用して、この連結文字列のHMAC-SHA256ハッシュを計算します
• 結果のハッシュをBase64形式でエンコードします
• このエンコードされた値をAuthentificationヘッダーに含めます

Pythonの例：

 import hmac import hashlib import time nonce = str（int（time.time（） * 1000）） path = '/api/v3/注文' body = '{' ordertype '：' lmt '、' symbol '：' pi_xbtusd '、' side '：' buy '、' size '：1000、' limitprice '：30000}'




メッセージ= nonce + path + body署名= hmac.new（




b'your_private_secret_here', msg=message.encode(), digestmod=hashlib.sha256
 ）。ダイジェスト（）
 
auth_header = base64.b64encode（signature）.decode（）

この署名は、 APIKeyおよびNonceとともに、すべてのプライベートリクエストに含める必要があります。

API経由で先物注文を配置します

認証されたら、トレーディングエンドポイントとのやり取りを開始できます。新しい注文を行うには、 /api/v3/sendorderに投稿リクエストを送信します。ペイロードには、シンボル、サイド、サイズ、順序タイプなどの必須パラメーターを含める必要があります。

JSONボディに必要なフィールド：

• OrderType ： lmt （LIMIT）、 mkt （Market）、またはpost （Post Only Limit）にすることができます
• シンボル：たとえば、永久Bitcoin/usd契約のpi_xbtusd
• サイドsell buy
• サイズ：契約数（ほとんどのペアで最低1）
• LimitPrice ：制限注文に必要です

Curlを使用した例の例：

 curl -X POST https://futures.kraken.com/api/v3/sendorder \ -H 'APIKey: your_api_key_here' \ -H 'Nonce: 1234567890' \ -H 'Authentification: generated_signature_here' \ -d '{'orderType':'lmt','symbol':'pi_xbtusd','side':'buy','size':100,'limitPrice':35000}'

提出後、APIはorderId 、ステータス、およびその他のメタデータを含む応答を返します。このIDを使用して、後で注文をキャンセルまたは照会できます。

市場データとアカウント情報の取得

パブリックエンドポイントは認証を必要とせず、リアルタイムの市場条件を取得するのに最適です。便利なエンドポイントは次のとおりです。

• GET /api/v3/tickers ：すべてのシンボルの最新の価格、資金調達率、およびオープンな利息を返します
• GET /api/v3/orderbook?symbol=pi_xbtusd ：フルレベル2注文書を取得します
• GET /api/v3/history?symbol=pi_xbtusd&lastTime=... ：最近の貿易履歴を取得します

アカウント固有のデータについては、プライベートエンドポイントを使用します。

• GET /api/v3/accounts ：すべての元帳にわたってマージンバランス、エクイティ、およびPNLを表示します
• GET /api/v3/positions ：エントリー価格、サイズ、清算レベルのすべてのアクティブポジションをリストします
• GET /api/v3/orders ：オープン注文を取得します。 add ?order_status=closed記入/キャンセルされたものを表示します

すべての応答はJSON形式であるため、コードを簡単に解析できます。ポーリング間隔では、レートの制限を尊重する必要があります。これは、公開エンドポイントでは、1秒あたり10リクエスト、プライベートエンドポイントでは5つのリクエストを尊重する必要があります。

エラーの処理とデバッグAPI呼び出し

正しい構文があっても、API要求は、無効なパラメーター、マージン不足、または接続の問題により失敗する可能性があります。一般的なHTTPステータスコードは次のとおりです。

• 400悪いリクエスト：不正なJSONまたは必要なフィールドの欠落
• 401不正：無効なAPIキーまたは失敗した署名検証
• 403禁止：IPは、ホワイトリストまたは不十分な権限を不足していません
• 429リクエストが多すぎる：レート制限が超えた

エラー応答には、 codeとerrorメッセージが含まれています。たとえば、 'error': 'Invalid signature' HMAC計算の不一致を示します。連結ロジックとエンコーディングステップを再確認します。

開発中の生のリクエストと応答のロギングを有効にします。 -v Flagを備えたPostmanやCurlなどのツールは、ヘッダーとペイロードを検査するのに役立ちます。タイムスタンプを検証します。これらは、krakenのサーバー時間の小さなウィンドウ（通常±60秒）内にある必要があり、 GET /api/v3/timeで取得可能です。

---

よくある質問

先物契約の正しいシンボルを見つけるにはどうすればよいですか？シンボルは、特定の命名規則に従います。永久はpi_から始まり、その後に基本通貨と引用通貨（ pi_ethusdなど）が続きます。四半期ごとの先物はf_プレフィックスを使用し、有効期限を含めます（例： f_xbtusd_240628 ）。完全なリストについては/api/v3/instruments確認してください。

スポット取引と先物取引の両方に同じAPIキーを使用できますか？いいえ。KrakenSpotとFuturesプラットフォームは、別々のシステムで動作します。メインのkraken.comインターフェイスではなく、 Kraken Futuresダッシュボードから個別のAPIキーを生成する必要があります。

Kraken先物の最小注文サイズはどれくらいですか？ほとんどの永久契約の最小注文サイズは1つの契約です。通常、1つの契約は、基礎となる資産の1ドルに相当します。 pi_xbtusdの場合、1つの契約= 1ドル相当Bitcoin。常に/api/v3/instrumentsを介して確認してください。

WebSocketサポートはKraken Futuresで利用できますか？はい。注文書、取引、および個人注文イベントのライブアップデートについては、 wss://futures.kraken.com/ws/v1に接続します。認証には/api/v3/auth/tokenエンドポイントから取得したtokenを送信します。