TradeSantaでボットを作成した際、時として「Invalid API Key」
というエラーが表示されることがあります。この場合、ボットはトレードを開始せず、「Stop Bot」オプションの下にあるバーが赤色に変わり、同じメッセージである — Invalid API Keyが表示されます。
では、これは何を意味し、どのように修正すればよいのでしょうか？
⚙️ 「Invalid API Key」エラーの原因
このエラーは通常、APIキーが正しくない権限で作成されたことを意味します、または IPホワイトリストが正しく設定されていないことが、TradeSantaに取引所を接続する際に原因となっている可能性があります。
言い換えれば、設定の不足または誤りにより、APIキーがTradeSantaによる取引データへのアクセスや取引の実行を許可していない状態です。
ご利用の取引所に応じて、確認すべき項目を確認していきましょう。
🟡 Binance
Binanceを接続した際に「Invalid API Key」と表示された場合は、BinanceのAPI管理ページで以下の権限を確認してください：
必要な権限：
- ✅ 読取を有効にする — 常にオン
- ✅ スポット・マージン取引を有効にする — 常にオン
- ❌ 出金を有効にする — 常にオフ
- ❌ 通貨ペアホワイトリストを有効にする— は次である必要があります: オフ
- 🔒 IPアドレス制限:
- 次の値に設定してください: 制限付き 次を使用: TradeSantaのIPホワイトリスト セキュリティ強化のため
次で確認できます: 独自のIPリスト TradeSantaアカウント内の
接続済み取引所 → Binance → IPリスト。
すべてのIPがコピーされ、Binanceの「信頼できるIPのみにアクセスを制限する」フィールドに貼り付けられていることを確認してください。
ホワイトリストが不足しているか正しくない場合、APIキーは機能せず、ボットには次のように表示されます：Invalid API Key。
詳細なセットアップ手順はこちらで確認できます：
BinanceでAPIキーを作成する方法
Binance/Binance FuturesでIPホワイトリストを有効にする方法
🔵 HTX (Huobi)
HTX (旧Huobi) を使用している場合は、API Management ページを開き、キーの権限が以下と一致していることを確認してください：
必要な権限：
- ✅ Read-only — オン
- ✅ Trade — オン
- ❌ Withdraw — オフ
- 🌐 IPアドレスを紐付ける: 空のままにしてください
権限が誤って設定されている場合、または権限を編集するオプションがなくなった場合は、新しいAPIキーを作成し、上記の正しいオプションを有効にしてください。
セットアップの全手順はこちらでご確認いただけます:
HTXでのAPIキー作成方法
⚫ OKX
接続する場合 OKX、キーの権限と設定を注意深く確認してください。
OKXで「Invalid API Key」が発生する一般的な理由には、取引権限の不足、パスフレーズの誤り、またはIPホワイトリストの未設定が含まれます。
必要な権限:
- ✅ Read — オン
- ✅ Trade — オン
- ❌ Withdraw — オフ
- 🧩 パスフレーズ: は TradeSanta で入力したものと正確に一致する必要があります
- 🌐 IP ホワイトリスト: 空欄
セットアップガイドの全文はこちらでご確認いただけます:
OKX で API を作成する方法
🧭 エラーが解消されない場合の対処法
API キーが誤った権限や IP で作成され、編集できなくなった場合は、以下を行ってください:
- 古いキーを削除する （取引所アカウント内）。
- 新しいキーを作成します 正しい権限とIPホワイトリストを設定してください。
- 再接続 TradeSantaで取引所を再接続します。
古いAPIキーを新しいものに安全に置き換える方法は、こちらで確認できます：
新しいAPIキーでアクセスポイントを更新する方法
✅ 最終チェックリスト
再接続する前に、以下を確認してください：
- 必要なすべての権限が有効になっていること（読み取り + トレード、出金は不可）。
- TradeSantaのIPがホワイトリストに正しく追加されていること。
- パスフレーズ（OKXの場合）が正確に一致していること。
- APIキーとシークレットが、余分なスペースなしで正しくコピーされていること。
すべての設定が正しいことを確認したら、TradeSanta で取引所を再接続してください。これでボットが正常に取引を開始するはずです。