よくある質問¶

基本事項 ¶

cTrader CLIとは何ですか？

cTrader CLIは、cTraderのデスクトップアプリを開かずに、ターミナルから口座管理、取引、アルゴリズム取引の操作を直接行えるコマンドラインツールです。コマンドを入力することで、ログイン、市場データの取得、取引の発注と管理、cBotの実行、バックテスト、最適化を行えます。

cTrader CLIを実行するには何が必要ですか？

少なくとも1つの取引口座が紐づいたcTrader ID、PATHから実行できるcTrader CLIの実行ファイル、cTrader IDの認証情報ファイルが必要です。

cTrader CLIをインストールするにはどうすればよいですか？

Windows、macOS、Linuxでは、パッケージマネージャーを使用します。お使いのOSに対応したビルドがダウンロードされます。 Dockerイメージも利用できます。また、WindowsではcTraderのデスクトップアプリに実行ファイルが同梱されています。

cTrader CLIは無料ですか？

はい。 cTrader CLIはcTraderに含まれています。ご自身のcTrader IDと認証情報ファイルが必要です。また、cBotを無人で稼働させる場合は、ホスティング環境もご自身で用意する必要があります。

AIエージェント ¶

cTrader CLIでAIアシスタントを使用できますか？

はい。 cTrader CLIには、コマンドを自分で入力したりスクリプトで実行したりする方法と、目的を自然言語で伝え、AIアシスタントにcTrader CLIコマンドの案を作成してもらい、それを確認して実行する方法があります。

AIアシスタントを使うにはスキルのインストールが必要ですか？

いいえ。スキルをインストールしなくても、AIアシスタントはcTrader CLIコマンドの案を作成できます。スキルをインストールすると、コマンド構文、出力、安全上のルールに関する参照資料をAIエージェントが利用できるようになり、より信頼性の高いコマンドを生成できます。

AIにコマンドを実行させる前に何を確認すべきですか？

AIアシスタントに長時間実行されるrunコマンドを自律的に開始させないでください。また、ライブ口座で実行する前に、AIが生成したすべてのコマンドを確認してください。

認証と認証情報 ¶

認証方法にはどのようなルールがありますか？

cTrader CLIには2種類の認証方式があります。バッチ方式では--ctidと--pwd-fileが必要です。対話方式では--ctid、--passwordまたは--pwd-file、および-qが必要です。バッチコマンドでは--passwordは使用できませんが、対話方式のコマンドではどちらも使用できます。

パスワードを安全に保存するにはどうすればよいですか？

cTIDのパスワードをプレーンテキストファイルに保存します。共有フォルダーやバージョン管理対象のフォルダーには保存せず、読み取りアクセスを制限し、不要になったら削除してください。

複数のブローカーで口座番号が重複している場合、ブローカーを指定するにはどうすればよいですか？

任意のコマンドに--broker=<broker-name>を追加してください。 cTrader IDに紐づく複数のブローカーで口座番号が重複している場合、このフラグで対象のブローカーを指定できます。

ワークフロー ¶

cTrader CLIではどのような操作ができますか？

cTrader CLIの操作には、口座管理、取引、市場データ、履歴、インジケーター、アラート、cBot、プロジェクト関連の操作が含まれます。

cTrader CLIで使用するタイムゾーンは何ですか？

入力と出力のすべての日付と時刻にはUTCが使用されます。例えば、--from=2026-10-08は10月8日の00:00 UTCを開始時刻とし、出力には2026-10-08T14:05:00.000Zのような時刻が表示されます。唯一の例外は実行中のcBot内で使用される時刻で、cBotのTimeZone設定に従います。

1つの取引に複数の利食い水準を設定できますか？

いいえ。現在、cTrader CLIでは1つの取引につき利食い水準を1つだけ設定できます。

トレーリングストップロスや建値保護を設定できますか？

いいえ。現在、cTrader CLIではどちらも利用できません。

予約注文に有効期限を設定できますか？

いいえ。現在、cTrader CLIでは注文の有効期限（good till date）を設定できません。

スリッページ許容幅を設定できますか？

いいえ。現在、cTrader CLIではスリッページ許容幅（market range）を設定できません。 --limit-rangeオプションはストップリミット注文に適用されます。

ストップ注文のトリガー方法を選択できますか？

いいえ。現在、cTrader CLIではストップ注文のトリガー方法を選択できません。

CLIが受け付ける期間トークンをすべて確認するにはどうすればよいですか？

ctrader-cli periodsを実行してください。このコマンドは、--periodと--timeframeで使用できるすべてのトークンを表示します。トークンの解析では大文字と小文字は区別されません。

VPSやクラウドサーバーでcBotを実行するにはどうすればよいですか？

cTrader CLIのDockerイメージ内でcBotを実行します。ホスト側のフォルダーをマウントし、設定値を環境変数として渡してください。

cBotのライフサイクル ¶

cBotにはどのバージョンの.NETが必要ですか？

.algoファイルは.NET 8向けにビルドする必要があります。古いcBotは最新のcTraderデスクトップアプリで再コンパイルしてください。

ターミナルからcBotを起動するにはどうすればよいですか？

ctrader-cli run <path-to-algo-file> --account=<account-id> --symbol=<symbol> --period=<period>を実行してください。このコマンドは長時間実行されます。cBotが停止したときにcTrader CLIのプロセスも終了させたい場合は、--exit-on-stopを使用してください。

実行中のすべてのcBotを一度に停止するにはどうすればよいですか？

ctrader-cliで対話型シェルを開き、ログインしてからstop all yesを実行してください。最後のインスタンスが停止すると、cTrader CLIのプロセスも終了します。

cBotのパラメータを渡すにはどうすればよいですか？

cBotのパラメータは3つの方法で指定できます。cBotのデフォルト値をそのまま使う方法、コマンドラインの--ParameterName=valueで1～2個の値を上書きする方法、保存済みの.cbotsetファイルを2番目の位置引数として渡す方法です。 .cbotsetファイルはcTraderデスクトップアプリで作成でき、実行時に同じ値を再利用できます。

cBotのパラメータを最適化するにはどうすればよいですか？

ctrader-cli optimize <path-to-algo-file> --params=<path-to-params-file>を実行してcBotを最適化します。JSON形式のパラメータファイルでは、探索するパラメータと固定するパラメータを指定します。標準の評価基準を使う場合は--criteriaを、cBot独自のGetFitnessメソッドを使う場合は--fitnessを指定してください。