ボットが一時停止・停止したのはなぜ？

ボットが期待どおりに動かないとき、その原因はほぼ必ず、解決可能な数種類のうちのどれかです — たいていは資金やAPI権限といった取引所側の問題です。このガイドでは、よくあるものから順に一つずつ見ていきます。

ボットがエントリーしないのとは別の話です。 ボットは正常に稼働しているのにポジションを持っていない場合、それはたいていエントリー条件の話です — ボットが取引しないのはなぜ？をご覧ください。この記事は、一時停止した、停止した、またはエラーになったボットについて扱います。

Key Takeaways

ボットは明確なステータス — アクティブ（エントリー待ち）、トリガー中、稼働中（ポジション保有）、一時停止、一時停止待機中、エラー — の間を移り変わります。このガイドは、ボットが一時停止・停止・エラーになる理由を扱います。
ボットが執行を止める最も多い理由は、取引所口座の残高不足または証拠金不足です。
APIキーの問題 — 無効化・失効・権限違いのキーや、IPホワイトリストによるブロック — もボットを停止させます。読み取りと取引の権限を持つ新しいキーで再接続すれば解決します。
先物では、そのペアに対して高すぎるレバレッジや、ポジションモードの不一致が注文をブロックすることがあります。
取引所エラーの多く（レート制限、タイムアウト、時刻・タイムスタンプ）は一時的なものです。ボットが失敗するとFreyaが通知するので、すぐに対処できます。

ボットのステータス早見表

アクティブ — 稼働中で、エントリー条件を満たす動きを市場で待っています。ポジションはまだありません。
トリガー中 — エントリー条件が満たされ、ボットがポジションを建てているところです。
稼働中 — ポジションを保有しており、ボットが取引を管理しています（セーフティオーダー、利益確定、決済）。
一時停止 — あなたが一時停止しました。再開するまで新しいポジションは建てません。
一時停止待機中 — ポジション保有中に一時停止しました。そのポジションを安全に処理し終えてから、一時停止になります。
エラー — 動作しようとしましたが、取引所またはチェックに拒否されました。ボットは停止し、問題を知らせます。
決済中 / 決済済み — ボットが取引を終えようとしています。完了すると、その取引は履歴に保存されます。

（アクティブと稼働中の違いを含む完全なステータス解説は、ボットが取引しないのはなぜ？をご覧ください。）

ボットが自力で回復できない問題に直面すると、エラー状態に移行し、「ボット失敗」通知が届きます（通知を設定している場合）。これにより素早く対処できます。

最も多い原因：残高または証拠金の不足

ボットが注文を出さなくなる理由として圧倒的に多いのが、取引所口座の残高不足（現物）または証拠金不足（先物）です。ボットが注文 — 基本注文、平均化のための注文、あるいは利益確定 — を出そうとしたのに、資金がなかったため取引所が拒否したのです。

対処法： 取引所口座に、ボットの計画全体をカバーできる十分な余剰残高・証拠金があることを確認してください — グリッド内のすべての平均化注文を含みます。（グリッド全体に資金を用意することが重要なのはこのためです。エントリー注文とグリッドをご覧ください。）

APIキーの問題

Freyaがあなたに代わって動作できなくなると、ボットは停止します。APIキー関連のよくある原因は次のとおりです。

無効化・失効・再生成されたキー — 取引所側でキーを削除またはローテーションした場合、Freyaが保持しているキーはもう機能しません。
権限が違う — キーには読み取りと取引の権限が必要です（出金権限は絶対に付けないでください）。読み取り専用のキーでは注文を出せません。
IPホワイトリストによるブロック — キーを特定のIPに制限している場合、FreyaのサーバーIPを許可する必要があります（これらは取引所を接続する際に表示されます）。

対処法： 読み取りと取引の権限を持つ新しいキーで再接続してください。取引所を接続する方法とAPIキーの管理をご覧ください。

注文が小さすぎる

どの取引所にも最小注文サイズ（最小取引金額）があります。注文額 — またはグリッド内の個々の注文 — がこれを下回ると、取引所は注文を拒否します。

対処法： 取引額（または1注文あたりの数量）を増やし、各注文が取引所の最低額を上回るようにしてください。

先物特有：レバレッジとポジションモード

先物では、2つの設定が注文をブロックすることがあります。

レバレッジが高すぎる — 設定したレバレッジが、そのペアで取引所が許容する範囲を超えています。許容される水準まで下げてください。
ポジションモードの不一致 — 取引所口座のポジションモード（ヘッジモードと一方向モード）が、ボットの想定と異なっています。取引所側のポジションモードを、ボットの取引方法に合わせてください。

一時的な取引所側の問題

一部のエラーはあなたのせいではなく、自然に解消することがよくあります。

レート制限 — 短時間にリクエストが多すぎます。
タイムアウト / ネットワークエラー — 取引所との一時的な接続の問題です。
タイムスタンプエラー — システムと取引所の間の時刻同期の問題です。
取引所の混雑 / メンテナンス — 取引所自体が過負荷、またはダウンしています。

対処法： これらはたいてい自然に解決します。こうした理由でボットがエラーになった場合、取引所が正常に応答するようになれば、通常はそのまま再開できます。

対処手順：クイックチェックリスト

取引所の残高・証拠金を確認 — 最も多い原因です。少なければ追加してください。
APIキーを確認 — 有効か、読み取りと取引の権限があるか、FreyaのIPが許可されているか。
注文サイズを確認 — 取引所の最低額を上回っているか。
先物の場合、 レバレッジが上限内か、ポジションモードが一致しているか確認してください。
一時的なエラーだった場合、 取引所の復旧を待ってボットを再開してください。
それでも解決しない場合は、 [email protected] までご連絡ください。