ボットが期待どおりに動かないとき、その原因はほぼ必ず、解決可能な数種類のうちのどれかです — たいていは資金やAPI権限といった取引所側の問題です。このガイドでは、よくあるものから順に一つずつ見ていきます。
ボットがエントリーしないのとは別の話です。 ボットは正常に稼働しているのにポジションを持っていない場合、それはたいていエントリー条件の話です — ボットが取引しないのはなぜ？をご覧ください。この記事は、一時停止した、停止した、またはエラーになったボットについて扱います。
要点
- ボットは明確なステータス — アクティブ（エントリー待ち）、トリガー中、稼働中（ポジション保有）、一時停止、一時停止待機中、エラー — の間を移り変わります。このガイドは、ボットが一時停止・停止・エラーになる理由を扱います。
- ボットが執行を止める最も多い理由は、取引所口座の残高不足または証拠金不足です。
- APIキーの問題 — 無効化・失効・権限違いのキーや、IPホワイトリストによるブロック — もボットを停止させます。読み取りと取引の権限を持つ新しいキーで再接続すれば解決します。
- 先物では、そのペアに対して高すぎるレバレッジや、ポジションモードの不一致が注文をブロックすることがあります。
- 取引所エラーの多く（レート制限、タイムアウト、時刻・タイムスタンプ）は一時的なものです。ボットが失敗するとFreyaが通知するので、すぐに対処できます。
ボットのステータス早見表
- アクティブ — 稼働中で、エントリー条件を満たす動きを市場で待っています。ポジションはまだありません。
- トリガー中 — エントリー条件が満たされ、ボットがポジションを建てているところです。
- 稼働中 — ポジションを保有しており、ボットが取引を管理しています（セーフティオーダー、利益確定、決済）。
- 一時停止 — あなたが一時停止しました。再開するまで新しいポジションは建てません。
- 一時停止待機中 — ポジション保有中に一時停止しました。そのポジションを安全に処理し終えてから、一時停止になります。
- エラー — 動作しようとしましたが、取引所またはチェックに拒否されました。ボットは停止し、問題を知らせます。
- 決済中 / 決済済み — ボットが取引を終えようとしています。完了すると、その取引は履歴に保存されます。
（アクティブと稼働中の違いを含む完全なステータス解説は、ボットが取引しないのはなぜ？をご覧ください。）
ボットが自力で回復できない問題に直面すると、エラー状態に移行し、「ボット失敗」通知が届きます（通知を設定している場合）。これにより素早く対処できます。
最も多い原因：残高または証拠金の不足
ボットが注文を出さなくなる理由として圧倒的に多いのが、取引所口座の残高不足（現物）または証拠金不足（先物）です。ボットが注文 — 基本注文、平均化のための注文、あるいは利益確定 — を出そうとしたのに、資金がなかったため取引所が拒否したのです。
対処法： 取引所口座に、ボットの計画全体をカバーできる十分な余剰残高・証拠金があることを確認してください — グリッド内のすべての平均化注文を含みます。（グリッド全体に資金を用意することが重要なのはこのためです。エントリー注文とグリッドをご覧ください。）
APIキーの問題
Freyaがあなたに代わって動作できなくなると、ボットは停止します。APIキー関連のよくある原因は次のとおりです。
- 無効化・失効・再生成されたキー — 取引所側でキーを削除またはローテーションした場合、Freyaが保持しているキーはもう機能しません。
- 権限が違う — キーには読み取りと取引の権限が必要です（出金権限は絶対に付けないでください）。読み取り専用のキーでは注文を出せません。
- IPホワイトリストによるブロック — キーを特定のIPに制限している場合、FreyaのサーバーIPを許可する必要があります（これらは取引所を接続する際に表示されます）。
対処法： 読み取りと取引の権限を持つ新しいキーで再接続してください。取引所を接続する方法とAPIキーの管理をご覧ください。
注文が小さすぎる
どの取引所にも最小注文サイズ（最小取引金額）があります。注文額 — またはグリッド内の個々の注文 — がこれを下回ると、取引所は注文を拒否します。
対処法： 取引額（または1注文あたりの数量）を増やし、各注文が取引所の最低額を上回るようにしてください。
先物特有：レバレッジとポジションモード
先物では、2つの設定が注文をブロックすることがあります。
- レバレッジが高すぎる — 設定したレバレッジが、そのペアで取引所が許容する範囲を超えています。許容される水準まで下げてください。
- ポジションモードの不一致 — 取引所口座のポジションモード（ヘッジモードと一方向モード）が、ボットの想定と異なっています。取引所側のポジションモードを、ボットの取引方法に合わせてください。
一時的な取引所側の問題
一部のエラーはあなたのせいではなく、自然に解消することがよくあります。
- レート制限 — 短時間にリクエストが多すぎます。
- タイムアウト / ネットワークエラー — 取引所との一時的な接続の問題です。
- タイムスタンプエラー — システムと取引所の間の時刻同期の問題です。
- 取引所の混雑 / メンテナンス — 取引所自体が過負荷、またはダウンしています。
対処法： これらはたいてい自然に解決します。こうした理由でボットがエラーになった場合、取引所が正常に応答するようになれば、通常はそのまま再開できます。
対処手順：クイックチェックリスト
- 取引所の残高・証拠金を確認 — 最も多い原因です。少なければ追加してください。
- APIキーを確認 — 有効か、読み取りと取引の権限があるか、FreyaのIPが許可されているか。
- 注文サイズを確認 — 取引所の最低額を上回っているか。
- 先物の場合、 レバレッジが上限内か、ポジションモードが一致しているか確認してください。
- 一時的なエラーだった場合、 取引所の復旧を待ってボットを再開してください。
- それでも解決しない場合は、 [email protected] までご連絡ください。
よくある質問
ボットが一時停止・停止したのはなぜですか？
多くの場合、取引所が注文を拒否したためです — たいていは残高または証拠金の不足、APIキーの問題、あるいは取引所の最小サイズを下回る注文です。先物では、レバレッジやポジションモードの設定が注文をブロックすることもあります。一時的な取引所側の問題（レート制限、タイムアウト）でもボットは停止しますが、これらは通常自然に解消します。
ボットがエラー状態になっているのはどういう意味ですか？
ボットが動作しようとしたものの何かに拒否されたため、そのまま盲目的に続けるのではなく停止して問題を知らせている、という意味です。「ボット失敗」通知が届きます（通知をオンにしている場合）。根本原因 — たいていは残高かAPIキー — を解決すれば、再び稼働させられます。
ボットが残高不足と表示しています。どうすればいいですか？
取引所口座に資金を追加し、ボットの注文（平均化注文のグリッドを含む）をカバーできる十分な余剰残高（現物）または証拠金（先物）を確保してください。取引所側に資金がなかったため、ボットは注文を出せませんでした。
APIキーが原因の可能性はありますか？
はい — よくある原因です。キーが削除・再生成された、読み取り専用に設定されている、またはIP制限がかかっていてFreyaのサーバーIPが許可されていない場合、ボットは取引できません。読み取りと取引の権限を持つ新しいキーで再接続してください（出金権限は絶対に付けないでください）。
先物ボットが注文を出しません。レバレッジやポジションモードが原因でしょうか？
はい。レバレッジがそのペアで取引所が許容する水準より高い場合、または口座のポジションモード（ヘッジモードと一方向モード）がボットの取引方法と一致していない場合、注文は拒否されます。レバレッジを許容される水準まで下げ、取引所側のポジションモードを合わせてください。
ボットが失敗したら通知は届きますか？
はい — 通知を設定していれば、ボットがエラー状態になったときにFreyaが「ボット失敗」アラートを送信するので、素早く対処できます。通知の設定方法をご覧ください。
ボットは稼働中ですが取引を1件も開始していません。これは同じことですか？
いいえ。稼働中でポジションを持っていないボットは、たいていまだエントリー条件を満たしていないだけです — これはボットが取引しないのはなぜ？で扱っています。この記事は、一時停止した、停止した、またはエラーになったボットについてです。