cBotの操作¶

この記事では、cTrader CLIでのcBotのライフサイクルを説明します。ターミナルからcBotを実行する方法、実行中のインスタンスの一覧表示と停止、Dockerを使ったVPSやクラウドサーバーでの稼働、過去データを使用したバックテストの方法を紹介します。

前提条件 ¶

• cTrader CLIがインストール済みであること。
• cTrader ID、認証情報ファイル、口座番号が用意されていること。
• cBotが.NET 8向けにビルドされた.algoファイルとしてエクスポートされていること。

cBotのメタデータを確認する ¶

cBotを実行する前に、metadataで使用可能なパラメータを一覧表示してください。出力には、cBotの各プロパティの名前と型が表示されます。

ctrader-cli metadata <path-to-algo-file>

コマンドラインまたは.cbotsetファイルでパラメータを指定する際は、メタデータの出力に表示されたパラメータ名を使用してください。

cBotを実行する ¶

runでcBotを起動します。 .algoファイルへのパスを最初の引数に指定します。 --account、--symbol、--periodは必須です。

ctrader-cli run <path-to-algo-file> --account=<account-id> --symbol=<symbol> --period=<period>

パラメータを渡す方法は3つあります。

自動実行では、2つのオプションの指定が役立ちます。

VPSまたはクラウドサーバーでcBotを実行する ¶

ターミナルだけで動作するツールなら、小規模なLinuxインスタンスでも快適に実行できます。そのため、デスクトップPCよりも低コストでcBotを継続稼働させられます。これを実現する最も移植性の高い方法は、cTrader CLIのDockerイメージを使用することです。

最新のイメージを取得します。

docker pull ghcr.io/spotware/ctrader-console:latest

コンテナ内でcBotを実行します。 --mountオプションはホストのフォルダをコンテナ内にマウントし、-eオプションは環境変数を通じて設定を渡します。

docker run -d -it \
  --name ctrader.console.run.mybot \
  --mount type=bind,src=/cAlgo/Robots,dst=/mnt/Robots \
  -e CTID='mycid' \
  -e PWD-FILE='/mnt/Robots/ctrader-cli.pwd' \
  -e ACCOUNT='9102302' \
  -e SYMBOL='EURUSD' \
  -e PERIOD='H1' \
  ghcr.io/spotware/ctrader-console:latest run "/mnt/Robots/My bot.algo" --environment-variables

cTraderデスクトップアプリから起動する ¶

cTrader CLIを利用するために、コマンドラインの操作を習得する必要はありません。

1. cTraderデスクトップアプリで、希望するパラメータを設定したcBotを用意します。
2. ローカルのcBotインスタンスを右クリックし、外部プロセスで起動を選択します。 cTrader CLIが自動的に起動し、インスタンスを独立して実行します。
3. CPUとRAMの使用量を抑えるため、デスクトップアプリを閉じてください。 cBotはcTrader CLIプロセス内で実行され続けます。

cBotを一覧表示して停止する ¶

その口座で現在実行中のcBotインスタンスを一覧表示します。

ctrader-cli cbots --ctid=letstrade --password=secret --account=1234567 -q

runの出力に表示される識別子を使って、実行中のインスタンスを停止します。

ctrader-cli stop --ctid=letstrade --password=secret --account=1234567 -q --instance=<instance-id>

実行中のすべてのcBotを一度に停止するには、対話型シェルを開いてstop all yesを実行してください。最後のインスタンスが停止すると、cTrader CLIプロセスも終了します。

cBotをバックテストする ¶

backtestを使って過去データでcBotをテストします。 .algoファイルへのパスが最初の引数です。必要に応じて.cbotsetファイルを続けて指定できます。テストには銘柄、時間枠、日付範囲も必要です。

ctrader-cli backtest <path-to-algo-file> [<path-to-cbotset-file>] --account=<account-id> --symbol=<symbol> --period=<period> --start=<start-date> --end=<end-date> --data-mode=<data-mode>

テスト環境のオプション ¶

テスト環境のフラグはCLIリファレンスのbacktestの項目に記載されています。必須の入力は--start、--end、--data-modeだけです。任意のフラグでは、開始残高、手数料、スプレッド、データソース、レポート出力を指定できます。

データモード ¶

実行例 ¶

単一の.cbotsetパラメータファイルを使用して、サンプルcBotのバックテストを実行します。

ctrader-cli backtest "C:/test/sample martingale.algo" C:/test/special-parameters.cbotset \
  --ctid=letstrade --pwd-file=C:/test/password.pwd --account=1234567 --symbol=EURUSD --period=h1 \
  --start="01/01/2025 12:34" --end="31/01/2025 20:56" \
  --balance=10000 --commission=30 --commission-type=UsdPerMillionUsdVolume --spread=1 --data-mode=m1

バックテストの出力 ¶

cTrader CLIは進行状況をターミナルに逐次出力し、完了すると概要を表示します。完全な結果は.algoファイルの隣にあるBacktestingフォルダに保存され、実行ごとに個別のサブフォルダが作成されます。

…/data/{cBotName}/{BacktestingInstanceID}/Backtesting

--reportと--report-jsonを指定すると、上記のフォルダに加えて、指定したパスにもレポートを保存します。

cTrader CLIでのAlgo APIの動作 ¶

cTrader CLIにはグラフィカルインターフェースがないため、cBotを実行するとcTrader Algo APIの一部のメンバーの動作が異なります。