Kraken APIから履歴契約データを取得するにはどうすればよいですか？

Kraken APIおよび履歴契約データの理解

Kraken APIは、開発者とトレーダーがプログラムでKrakenの暗号通貨交換サービスと対話できるようにする強力なインターフェイスです。過去の契約データを参照する場合、Krakenは主にKraken Futuresプラットフォーム（以前はCryptowatchデリバティブとして知られている）を介してスポット取引と先物契約をサポートしていることを明確にすることが重要です。標準のKraken Rest API（API.kraken.com）は、先物または永久契約の履歴データを直接提供していません。代わりに、履歴契約データは、Futures-API.Kraken.comでホストされているKraken Futures APIからアクセスできます。

履歴データを取得するには、必要な契約の種類と時間枠に基づいて正しいエンドポイントを特定する必要があります。 Kraken Futures APIは/api/history/candlesなどのエンドポイントを提供し、特定の先物契約のOHLC（オープン、ハイ、ロー、クローズ）データを取得します。各エンドポイントには、データ範囲を定義するために、シンボル、間隔、およびfrom/till titmestamsなどのパラメーターが必要です。

APIアクセス資格情報の設定

リクエストを行う前に、Kraken Futures APIへの認証されたアクセスを設定する必要があります。これには、APIキーと秘密の作成が含まれます。

• Krakenアカウントにログインし、資金調達セクションに移動します。
• APIを選択し、 Kraken先物を選択します。
• [APIキーの作成]をクリックします。
• アクセス許可-Ensure Read Accessは、市場データに有効になります。
• キーを生成し、 APIキーとシークレットキーの両方を安全に保存します。

これらの資格情報は、HMAC-SHA256を使用してリクエストに署名する必要があります。 Spot Tradingとは異なり、Kraken Futuresは個別の認証メカニズムを使用しています。すべてのリクエストには、 APIKeyやAuthentなどのヘッダーが含まれている必要があります。ここでは、 Authent要求方法、パス、ボディ、およびタイムスタンプに基づいて計算された署名です。

履歴データのAPI要求の構築

履歴契約データを取得するには、キャンドル履歴エンドポイントを使用します。

 GET https://futures-api.kraken.com/api/history/candles

必要なクエリパラメーターには以下が含まれます。

• シンボル：Bitcoin永久逆契約のPI_XBTUSDなどの契約記号。
• 間隔：ろうそく足間間隔。有効な値には、 1m 、 5m 、 15m 、 1h 、 4h 、 1dが含まれます。
• FROM ：UNIXタイムスタンプの開始時間（秒）。
• UNIXタイムスタンプでの終了時間（秒）まで。

たとえば、2024年1月1日から2024年1月2日までのBitcoin永久契約のために1時間のキャンドルを取得するには：

 https://futures-api.kraken.com/api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600

このリクエストは、公開市場データのみにアクセスされる場合、認証を必要としません。ただし、レート制限されている場合は、認証されたリクエストの使用を検討してください。

レート制限リクエストの認証を処理します

認定されていないリクエスト制限を超える場合は、署名されたリクエストに切り替えます。プロセスには次のものが含まれます。

• メソッド、パス、ボディ、およびISO 8601タイムスタンプを使用したリクエストペイロードを作成します。
• タイムスタンプ、メソッド、パス、ボディ（存在する場合）を署名文字列に連結します。
• secretキーを使用してHMAC-SHA256を使用して、署名を生成します。
• Authentヘッダーの署名とAPIKeyのキーを含めます。

Pythonの例の例：

• リクエスト方法を設定します： GET
• パス： /api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600
• ISOタイムスタンプを生成： 2024-01-01T00:00:00Z
• 署名メッセージの作成： 2024-01-01T00:00:00ZGET/api/history/candles?symbol=PI_XBTUSD&interval=1h&from=1704067200&until=1704153600
• シークレットキーを使用してメッセージのHMAC-SHA256を計算します
• 結果をbase64でエンコードします
• セットヘッダー：
  • APIKey: YOUR_PUBLIC_KEY
  • Authent: BASE64_SIGNATURE
  • Nonce: 2024-01-01T00:00:00Z

requestsのようなライブラリを使用してリクエストを送信します。

応答データの処理と保存

APIは、キャンドルオブジェクトの配列を含むJSON応答を返します。各キャンドルには以下が含まれます。

• タイムスタンプ：ろうそくのUnix時間が始まります。
• オープン：オープニング価格。
• 高：最高価格。
• 低：最低価格。
• 閉鎖：終値。
• ボリューム：取引されたボリューム。

応答の例：

 { 'result': 'success', 'candles': [ { 'timestamp': 1704067200, 'open': '42000.00', 'high': '42500.00', 'low': '41800.00', 'close': '42300.00', 'volume': '120.5' }

] }

JSONを解析し、 candlesアレイを抽出します。このデータは、分析のためにCSV、データベース、またはデータフレームに保存できます。必要に応じて、タイムスタンプが現地時間またはUTCに変換されることを確認してください。ページネーションを処理する時間範囲が大きい場合は、クレイクがリクエストごとに結果を制限する場合があり、値until調整fromれた複数の呼び出しが必要です。

一般的なエラーとトラブルシューティング

• 無効なシンボル：契約記号を再確認します。 GET /api/instrumentsを使用して、利用可能なすべての契約をリストします。
• レートの制限：認証されていないリクエストは限られています。認証を使用するか、通話間に遅延を追加します。
• 無効なタイムスタンプ形式：UNIXタイムスタンプがミリ秒ではなく数秒であることを確認してください。
• 署名の不一致：署名文字列に正確なパスとクエリパラメーターが含まれていることを確認し、シークレットキーが正しいことを確認します。
• 空の応答：時間範囲にアクティブな取引期間が含まれることを確認してください。

PostmanやPythonスクリプトなどのツールを使用して、リクエストを段階的にテストします。ロギングを有効にして、リクエストヘッダーとデバッグの応答をキャプチャします。

よくある質問

Kraken先物契約の正しいシンボルを見つけるにはどうすればよいですか？ Instrumentsのエンドポイントを使用してください： GET https://futures-api.kraken.com/api/instruments 。これにより、Bitcoin永久のPI_XBTUSDやエーテル先物のFI_ETHUSDなど、すべてのアクティブな契約を記号で返します。

ろうそくの代わりにティックレベルの履歴データを取得できますか？ Kraken Futures APIは、パブリックエンドポイントを介してティックレベルのデータを提供しません。 /api/history/candlesエンドポイントは、指定された間隔で集約されたOHLCデータのみをサポートします。きめのデータについては、WebSocketフィードまたはサードパーティのデータプロバイダーを検討してください。

一度に取得できる履歴データの量に制限はありますか？はい、APIは、リクエストごとに返されるキャンドルの数を制限する場合があります。時間範囲が大きい場合は、一度に1日のような小さな間隔に分割し、複数のリクエストを行います。応答を完全性を確認し、それに応じuntilパラメーターfrom調整します。

履歴契約データにアクセスするには、検証済みのKrakenユーザーである必要がありますか？認定されていないパブリックデータリクエストの場合、基本的なアカウントアクセスで十分です。ただし、レート制限を増やし、安定したアクセスを確保するには、API資格情報を含む検証済みのアカウントが推奨されます。データの取得には完全な取引権限は必要ありません。