Kraken 取引 API での無効な API 署名エラーを修正するにはどうすればよいですか?

Kraken API 署名要件を理解する

1. Kraken は、取引エンドポイントへのすべての認証されたリクエストに対して厳密な署名検証を強制します。

2. 署名は、データ要素の特定の連結に対して HMAC-SHA512 を使用して計算する必要があります。

3. すべてのリクエストにはミリ秒単位の一意のタイムスタンプが必要で、サーバーは 60 秒を超えるリクエストを拒否します。

4. POST 本文は、署名ベースに含める前に、URL エンコードされた文字列としてエンコードする必要があります。

5. リクエストヘッダーで使用される API キーは、署名に使用されるシークレットに関連付けられたものと一致する必要があります。

正しい署名構築シーケンス

1.署名フィールド自体を除く、すべてのリクエスト パラメータを辞書にアセンブルします。

2. パラメータ キーをアルファベット順に並べ替え、 key1=value1&key2=value2 の形式で単一の文字列に連結します。

3. API エンドポイント パス (例: /0/private/AddOrder ) を並べ替えられたパラメーター文字列の先頭に追加します。

4. 結果の文字列を UTF-8 を使用してエンコードし、デコードされた Base64 API シークレットをキーとして使用して HMAC-SHA512 を計算します。

5. 結果のダイジェストを Base64 に変換し、それを要求ペイロードの符号パラメーターとして含めます。

Python 実装における一般的なエンコーディングの落とし穴

1. Base64 でエンコードされた API シークレットをhmac.new()に渡す前にデコードできないと、無効な出力が発生します。

2. POST 本文を構築するときに、URL エンコードされたフォーム データではなく生の JSON を使用すると、署名入力の不一致が発生します。

3. 連結前にタイムスタンプを文字列に変換せずに整数として渡すと、サイレント型エラーが発生します。

4. パラメーター値を誤って二重エンコードすると (URL エンコード中に 1 回、JSON シリアル化中に 2 回)、署名の位置合わせが壊れます。

5. JSON ペイロードの空白正規化の無視: Kraken はスペースのないコンパクトな JSON を想定しているため、 separators=(',', ':') を強制する必要があります。

ヘッダー構成の基本事項

1. API キーヘッダーには、Kraken アカウント ダッシュボードに登録されている正確な API キー文字列が含まれている必要があります。

2. API-Signヘッダーは、16 進数ダイジェストまたは生のバイトではなく、Base64 でエンコードされた HMAC-SHA512 結果を伝送する必要があります。

3. すべてのプライベート エンドポイントでContent-Typeヘッダーをapplication/x-www-form-urlencodedに設定する必要があります。

4. ヘッダーで渡されるタイムスタンプは、署名の計算で使用されるタイムスタンプと正確に一致している必要があり、丸めや切り捨ては許可されません。

5. すべてのヘッダーでは大文字と小文字が区別されます。 api-keyまたはApi-Sign はすぐに認証に失敗します。

無効な署名応答のトラブルシューティング

1. mitmproxyやWiresharkなどのツールを使用して完全な生のリクエストおよびレスポンスの本文をキャプチャし、予期される署名入力と実際の署名入力を比較します。

2. Python REPL で署名文字列を手動で再構築し、各コンポーネントのバイト表現が Kraken の期待と一致することを確認します。

3. シークレットの長さをバイト単位で出力して、シークレットの Base64 デコードを検証します。Kraken シークレットは、SHA512 との互換性のために正確に 64 バイトにデコードされます。

4. エンコードする前にパラメータ値に隠し文字 (BOM、ゼロ幅スペースなど) が存在しないことを確認します。

5. プライベート呼び出しを試みる前に、まず Kraken の/0/public/Timeエンドポイントに対してテストして、タイムスタンプの同期を検証します。

よくある質問

Q: Kraken では、KuCoin のようにパスフレーズを個別に署名する必要がありますか?いいえ、Kraken は署名スキームにパスフレーズを使用しません。 HMAC の計算には API キーとシークレットのみが関係します。

Q: 複数のリクエスト間で同じ署名を再利用できますか?いいえ。各署名は一意のタイムスタンプとパラメータ セットにバインドされています。署名を再利用すると、即座に拒否されます。

Q: 私の署名は Postman では機能するのに、Python では失敗するのはなぜですか?これは通常、一貫性のない URL エンコード動作が原因で発生します。Postman は値を自動エンコードしますが、Python のurllib.parse.urlencode()は、明示的に設定されていない限り、特定の文字のエンコードを省略する場合があります。

Q: Kraken API パラメータ値の最大長はありますか? Kraken には文書化されたハード制限はありませんが、過度に長い値を使用すると、HTTP トランスポートまたは内部解析中のサイレント切り捨てにより署名の不整合が発生する可能性があります。