CashFlow v1.0.0 — cTrader用のDCAトレーディングボット

シンプルなアイデアに基づいて構築されたDCAトレーディングボット：キャッシュフローを管理し、市場を予測しない。2つのリカバリーモードにより、新しいバーを待つか、固定グリッド距離でトリガーするかを選択できます。

🔍 このボットの動作（わかりやすく言うと）

CashFlowは最初の注文を開き、待機し、価格が逆行すると追加の注文を出します。合計利益がプラスになると、すべてをクローズして新しいサイクルを開始します。これがコアループです — インジケーターの予測もトレンドの推測もありません。

あなたが決めるのはいつ追加するかとどれだけリスクを取るかです。

⚙️ パラメーターガイド

1. CashFlow（メイン）

• トレードモード — 方向を選択： BuyOnly（買いのみDCA）、SellOnly（売りのみ）、またはBoth（両方向を独立して実行し、それぞれ独自のメモリを持つ）。

2. リスク

• 片側あたりの最大ポジション数 — 方向ごとの同時注文の最大数。上限に達すると、ボットは最も古い注文をクローズして新しい注文のスペースを作ります（ローテーション、ボットが停止せずに稼働し続ける）。
• 最大スプレッド（ピップス） — スプレッドがこの値を超えると、ボットは注文を一時停止します。スプレッドが戻ると、保留中の注文が即座に発動します（毎ティックでチェック、毎バーではありません）。
• FIFO損失の記録 — ローテーションのために最も古い注文が損失でクローズされた場合、その損失は記憶され次のサイクルの利益目標に加算されます。これにより、全体の資産が開始時より低くなる「偽の勝利」を防ぎます。
• スプレッド待機状態の表示 — 注文がスプレッドの正常化を待っているときにチャート上に状態を表示します。

3. ロット管理

• マーチンゲール乗数 — 階層ごとのロット乗数（デフォルト2.0）。これを1.0に設定するとマーチンゲールが完全に無効になります。
• マーチンゲールロットステップサイズ — 階層ごとの注文数。例：ステップサイズ10の場合、注文1〜10は基本ロット、11〜20は基本×乗数、21〜30は基本×乗数²、など。
• 常にオープンリカバリー（New Barモード） — NewBarモードで有効にすると、価格の方向に関係なく新しいバーごとに注文を追加します。無効にすると、最後の注文に対して価格が逆行した場合のみ追加します。

4. リカバリー（注文追加トリガー）

これはボットの性格を決める重要な選択です。

• リカバリーモード
• • NewBar — 価格が最後の注文に逆行した場合、新しいバーの始まりに注文を追加します。時間軸依存 — 日足チャートは1日1回評価します。
  • FixGrid — バーに関係なく、価格が最後の注文から固定距離動いたら注文を追加します。時間軸非依存 — 価格変動にリアルタイムで反応します。
• グリッド距離（ピップス） — FixGridモードでのみ使用。新しい注文を追加する前に価格が最後の注文に対して動く必要がある距離。

5. 戦略

• 初期ロット（ベース） — 各サイクルの最初の注文の基本ロットサイズ。
• 最大ロット — マーチンゲールの階層がどれだけ上がっても、注文ごとのロットサイズの上限。安全のための上限。

🧠 2つのリカバリーモード — どちらをいつ使うか

NewBarモード

• 価格が最後の注文に逆行した場合、新しいバーの始まりに注文を追加します。
• 各バーが意味のある情報を持つ高い時間軸（H4、D1）に適しています。
• ペースが遅く、注文数が少なく、資本保全に適しています。

FixGridモード

• 固定ピップ距離で注文を追加し、毎ティックでチェックします。
• 時間軸非依存 — M1でもD1でも同じ動作。
• 予測可能な注文間隔が欲しいボラティリティの高い銘柄（金、指数など）に適しています。
• ペースが速く、動きごとの注文数が多く、グリッドの規律が高い。

実践的なガイダンス： 初めての場合は、H4または日足のNewBarから始めてください。ボットの動作に慣れたら、シンボルの日次ATRの約1倍の距離でFixGridを試してみてください。

📊 ポジション管理の方法

最初の注文を開く — その側に開いている注文がない場合、スプレッドが許容範囲内であればすぐに基本ロットを開きます。

注文の追加 — モードに応じて、新しいバー（NewBar）または固定距離（FixGrid）で追加注文が入ります。ロットサイズは階層の計算式に従います。

クローズ — すべての開いている注文の合計純利益（記録されたFIFO損失を含む）が新しいバーの始まりにプラスになるか、複数ポジションが開いていて任意の時点で合計利益がプラスになると、すべてクローズされサイクルがリセットされます。

ローテーション — 最大ポジション数に達し新しい注文が必要な場合、最も古い注文を先にクローズしてスペースを作ります。FIFO損失の記録が有効なら、その損失は次のサイクルの目標に含まれます。

🛡️ 内蔵の安全機能

• 毎ティックのスプレッドゲート — ニュースイベントやセッション開始時などのスプレッドが広い時は注文が発動しません。スプレッドが正常化すると保留中の注文が実行されます。
• 固定ベースロット — デフォルトの乗数は2.0ですが、1.0に設定すると純粋な固定ロットDCAになります。攻撃性のレベルをコントロールできます。
• 最大ロット上限 — マーチンゲールの階層がどれだけ上がってもロットサイズの厳格な上限です。
• FIFOメモリ — ローテーションによる損失は追跡され、次のサイクルの目標で補填されるため、常に現在の状況が把握できます。

⚠️ 使用前に理解すべきこと

• DCAはドローダウンリスクを伴います。 強い一方向のトレンドでは注文が蓄積します。長期トレンド中にアカウントが耐えられるレベルに最大ポジション数を設定してください。
• マーチンゲールはリスクを急速に増加させます。 乗数2.0、ステップサイズ10の場合、30番目の注文は基本ロットの4倍を使用します。1.0を超える値を使う前に計算を理解してください。
• まずバックテストを行ってください。 対象のシンボルと時間軸で、トレンド期間とレンジ期間の両方をテストしてからライブ運用してください。
• ロットサイズをアカウントに合わせてください。 一般的な開始点：基本ロット ≤ 0.01 を500ドルの資本あたりに調整し、シンボルのボラティリティに応じて調整します。

ボットは感情なしにルールに従いますが、ルールは設定がアカウントサイズとリスク許容度に合っている場合にのみ機能します。

🚀 クイックスタート

1. 取引したいシンボルのチャートにアタッチします。
2. バイアスに基づいてトレードモードを設定します（または両方向の場合はBoth）。
3. リカバリーモードを選択します — 不明な場合はNewBarから始めてください。
4. 初期ロットを控えめに設定します（ほとんどのアカウントで0.01が妥当な開始点です）。
5. 片側あたりの最大ポジション数を、許容できるドローダウンに基づいて設定します。
6. ライブ運用前に少なくとも6ヶ月分のデータでバックテストを行います。
7. ボットの動作を市場環境で理解するまでデモアカウントで開始してください。

CashFlowはツールであり保証ではありません。ルールに一貫して従いますが、結果は市場の動向によります。アカウントに適したリスク管理を行ってください。