Kraken Futures API Pythonの例

Kraken Futures APIにより、トレーダーはRESTコールを介して先物取引を自動化でき、HMACに署名したリクエスト、「PI_XBTUSD`などの有効なシンボル、およびKrakenの先物タブからAPIキーを分離する必要があります。

2025/07/26 19:29

Kraken Futures APIとは何ですか？

Kraken Futures APIは、トレーダーと開発者がKrakenの先物取引プラットフォームとプログラム的に対話できるようにするRESTベースのインターフェイスです。これには、注文の配置、市場データの取得、当座預金の残高、およびポジションの管理が含まれます。アルゴリズムトレーダーや自動化されたトレーディングボットを構築するトレーダーに最適です。 Pythonで使用するには、最初にKraken FuturesアカウントダッシュボードからAPIキーと秘密を取得する必要があります。これらの資格情報は、コードで公開することを避けるために、環境変数に適切に保存される必要があります。

必要なPythonライブラリをインストールする方法

コードを書く前に、必要なライブラリがインストールされていることを確認してください。最も重要なものは、API資格情報に環境変数を使用する予定がある場合、HTTP通信とpython-dotenv requestsです。ターミナルで次のコマンドを実行します。

• pip install requests
• pip install python-dotenv
  

  インストールしたら、次のようにスクリプトにインポートできます。

   import os
   import requests
   import time
   import hashlib
   import hmac
   from dotenv import load_dotenv

  クレデンシャルを保存するために.envファイルを使用している場合は、スクリプトの上部でload_dotenv()を呼び出すようにしてください。

  認証ヘッダーのセットアップ

  
  Kraken Futures APIは、リクエストに署名するためにHMAC-SHA256を使用しています。各プライベートエンドポイント呼び出しの署名を生成する必要があります。プロセスには以下が含まれます。
• ノンセを作成する（数秒でユニークなタイムスタンプ）
• 要求パス、ノンセ、ボディの連結
• APIシークレットを使用してメッセージをハッシュします

• APIKeyやAuthent （署名）などのヘッダーを追加する
  

  認証を構成する方法は次のとおりです。

   def get_kraken_signature(urlpath, data, secret):
   postdata = data
   encoded = (str(data['nonce']) + postdata).encode()
   message = urlpath.encode() + hashlib.sha256(encoded).digest()
   mac = hmac.new(base64.b64decode(secret), message, hashlib.sha512)
   sigdigest = base64.b64encode(mac.digest())
   return sigdigest.decode()

  この関数は、オーダーの配置やバランスの取得などのプライベートAPI呼び出しに必要な信頼ヘッダー値を返します。

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

  
  先物の注文を配置するには、 /derivatives/api/v3/sendorderエンドポイントにpostリクエストを送信する必要があります。これが完全な例です：

   url = 'https://futures.kraken.com/derivatives/api/v3/sendorder' headers = { 'User-Agent': 'Python API Client', 'APIKey': os.getenv('KRAKEN_API_KEY'), } data = {
  'OrderType'： 'LMT'、
  「サイズ」：1、
  「シンボル」：「pi_xbtusd」、
  「サイド」：「買い」、
  'Limitprice'： '69000.0'、
  'Cliordid'：f'my Order {int（time.time（））} '、
  'nonce'：str（int（time.time（） * 1000））、
  }
  
  
  
  
  
  signature = get_kraken_signature（ '/sendOrder'、data、os.getenv（ 'kraken_api_secret'））
  ヘッダー['信頼性'] =署名
  
  
  
  
  response = requests.post（url、headers = headers、data = data）
  
  
  
  
  The **`cliOrdId`** ensures each order is unique. The **`symbol`** must match Kraken's futures contract naming convention (eg, `pi_xbtusd` for perpetual Bitcoin/USD).オープンポジションとアカウント情報を取得します
  現在のオープンポジションを取得するには、 `/derivativation/api/v3/openpositions`にget requestを送信します。体は必要ありませんが、認証は必要です。
   url = 'https://futures.kraken.com/derivatives/api/v3/openpositions'
  ヘッダー= {
   'apikey'：os.getenv（ 'kraken_api_key'）、
   「ユーザーエージェント」：「Python APIクライアント」、
   }
   nonce = str（int（time.time（） * 1000））
   data = {'nonce'：nonce}
   signature = get_kraken_signature（ '/openpositions'、data、os.getenv（ 'kraken_api_secret'））
  ヘッダー['信頼性'] =署名
   

response = requests.get（url、headers = headers）
positions = respons.json（）

positions変数には、エントリー価格、サイズ、未実現のP＆Lなど、アクティブなポジションのリストが含まれています。

一般的なエラーとそれらを修正する方法

• 無効な署名：署名関数の連結ロジックを再確認します。 nonceが文字列であり、データペイロードの文字列と一致することを確認します。
• マージンが不十分：Krakenは、アカウントにマージンがない場合、注文を拒否する場合があります。最初に/accountsummaryを使用して残高を確認してください。
• 無効なシンボル：使用/instruments使用して、有効な先物契約のリストを取得します。命名パターンを想定しないでください。
• レート制限：Krakenはレート制限を実施します。 429エラーが発生した場合は、 time.sleep(1)を使用してリクエスト間に遅延を追加します。
  

  よくある質問

  BTC/USDの正しい先物記号を見つけるにはどうすればよいですか？
  
  /instrumentsエンドポイントを使用してください： GET https://futures.kraken.com/derivatives/api/v3/instruments 。 usdで終わるシンボルを探してください - 最も一般的なのは、永続的な先物契約のpi_xbtusdです。

  スポットと先物取引に同じAPIキーを使用できますか？
  
  No. Kraken Futuresには、KrakenアカウントのFuturesタブから生成された別のAPIキーが必要です。スポットキーを使用すると、認証エラーが返されます。

  正しいパラメーターでも注文が拒否されるのはなぜですか？
  
  注文サイズが最小値を下回っているかどうかを確認します（たとえば、BTC/USDの0.001 BTC）。また、 limitPriceマーク価格からの許可された偏差内にあることを確認します。Krakenは、現在の市場からあまりにも遠くの注文を拒否する場合があります。

  APIキーを環境変数に保管しても安全ですか？
  
  はい、 .envファイルが公開リポジトリにコミットしていない限り。 .gitignoreファイルに常に.envを追加し、コードでAPIキーを印刷したりログにしたりしないでください。