Python で Kraken Futures API を使用するにはどうすればよいですか? (開発者ガイド)

認証資格情報のセットアップ

1. Kraken アカウントにログインし、[API] の [設定] セクションに移動します。

2. 先物取引専用の新しい API キー ペアを生成し、「先物」権限が有効になっていることを確認します。

3. API キーと秘密キーを安全に保管します。ソース ファイルにハードコーディングしたり、バージョン管理にコミットしたりしないでください。

4. KRAKEN_FUTURES_API_KEYやKRAKEN_FUTURES_PRIVATE_KEYなどの環境変数を使用して、実行時に資格情報を挿入します。

5. GET /api/v3/accountsエンドポイント経由でアカウント残高を取得するなど、最小限の認証済みリクエストを作成してキーを検証します。

必要なライブラリのインストールと構成

1. pip を使用して公式の Kraken Futures Python SDK をインストールします: pip install kraken-futures-api 。

2. ヘッダーと署名ロジックに対するきめ細かい制御が必要な場合は、リクエストを直接使用します。

3. 手動署名生成に必要なモジュール: KrakenFuturesAPI 、 json 、およびBase64をインポートします。

4. 資格情報を使用してクライアントを初期化します: client = KrakenFuturesAPI(key=key, secret=secret) 。

5. client.get_server_time()を呼び出し、応答に有効な Unix タイムスタンプが含まれていることを確認して、接続を確認します。

先物注文の発注と管理

1. シンボル ( PI_XBTUSDなど)、サイド (買いまたは売り)、サイズ、注文タイプ (指値、市場、ストップ) を指定する注文ペイロードを構築します。

2. client.send_order(...)を使用して注文を送信します。これにより、 order_id 、 status 、およびfilled_size を含む構造化された応答が返されます。

3. client.cancel_order(order_id)を使用してアクティブな注文をキャンセルし、返された JSON でキャンセルステータスを検証します。

4. client.get_open_orders()を使用してオープン注文を取得し、必要に応じてシンボルまたは注文 ID でフィルタリングします。

5. client.get_fills()をポーリングするか、実行イベント用の Kraken の WebSocket フィードと統合して、リアルタイムのフィルを監視します。

マージンと位置データの処理

1. client.get_margin_requirements(symbol='PI_XBTUSD')を使用して、契約ごとの現在の証拠金要件を取得します。

2. client.get_open_positions()を介してオープンポジションをクエリし、 size 、 mark_price 、 unrealized_pnlなどのフィールドを検査します。

3. Kraken の段階的証拠金ルールに従い、 client.set_leverage(symbol='PI_XBTUSD', leverage=5)を使用してポジションのレバレッジを調整します。

4. 現在のサイズに一致する反対成行注文を送信するか、 client.close_position(symbol='PI_XBTUSD')を使用してポジションを明示的にクローズします。

5. client.get_account_summary()からの清算リスク指標、特にmargin_levelとavailable_margin を解析します。

よくある質問

Q: スポットエンドポイントと先物エンドポイントに同じ API キーを使用できますか? A: いいえ。Kraken は、スポット サービスと先物サービスに個別の API キーを必要とします。 Spot API 設定で生成されたキーには Futures 権限がないため、Futures エンドポイントでは HTTP 403 が返されます。

Q: 注文署名の有効期限が切れたらどうなりますか? A: Kraken は、署名されたリクエストに対して 60 秒の有効期間を強制します。 Kraken-Api-Keyヘッダーのタイムスタンプがサーバー時間と 60 秒以上異なる場合、リクエストはエラー コードEAPI:Invalid nonceで失敗します。

Q: 注文応答のステータスフィールドはどのように解釈すればよいですか? A: 有効な値には、 accept 、 triggered 、 canceled 、 filled 、およびexpired が含まれます。それぞれは、価格条件とシステム処理によって制御される個別のライフサイクル段階を反映しています。

Q: Futures API にはレート制限がありますか? A: はい。 Kraken は、アカウント層とエンドポイント カテゴリに基づいて動的なレート制限を適用します。制限を超えると HTTP 429 が返され、遅延時間を秒単位で示すRetry-Afterヘッダーが含まれます。