本文へスキップ
← 記事一覧

EAソースコード

MQL5のEAパラメーター設定:ソースコードで初期値を変更する方法

EABuild Team · · 読了目安 1分

EA Input Parameters in MQL5: How to Change Defaults in Source Code – EABuild

EAにはそれぞれ設定項目の一覧があり、EAのパラメーターは、売買ロジックには触れずに変更できるMQL5プログラムの部分です。この記事では、ソースファイルでパラメーターがどのように宣言されているか、キーワードinputとsinputの意味、初期値の編集・再コンパイル・結果の検証の方法を説明します。あわせて、編集を元に戻せる状態に保つための習慣として、バックアップ、変更は一度に一つだけ、変更内容の記録についても取り上げます。

MQL5プログラムにおけるEAパラメーターとは

EA(自動で売買注文を出すプログラム)をチャートに適用すると、MetaTrader 5には「Inputs」タブのあるウィンドウが開きます。このタブの各行が1つのパラメーターで、名前、値、場合によってはドロップダウンリストで構成されています。これらの行は、ソースファイルの冒頭付近にある、キーワードinputで始まる行から作られます。

input double LotSize = 0.10;という行は、double型(小数を扱える数値)の変数LotSizeを宣言し、その初期値を0.10とするものです。初期値は、EAを初めて適用したときにウィンドウに表示される値であり、「Reset」を押したときに戻る値でもあります。プログラム内部では、この変数は読み取り専用です。コードはLotSizeを使えますが、実行中に新しい値を代入することはできません。だからこそ、inputは設定を置くための想定された場所なのです。

初期値と実際に動かしている値の違い

ソース内の初期値とチャート上の値は別のものです。Inputsタブに0.05と入力すると、ソースファイルが0.10のままでも、チャートは0.05で動作します。MetaTraderは、入力した値をコードではなくチャートに保存します。ソースを編集して変わるのは、次に新しく適用したときに表示される開始値だけです。

初期値を変えたのに違いが見えない、という場面ではこの点が重要です。すでにEAが適用されているチャートは、以前に与えられた値を保持し続けます。そのため、EAをいったん削除して再ビルドしたものを適用し直すか、セットファイル(MetaTraderで読み込む、入力設定を保存したリスト)から値を読み込み直す必要があります。

inputブロックの読み方:型、コメント、グループ

MQL5のEAを開くと、たいてい最初の関数の前にinput行のブロックがあります。変更する前にこれを丁寧に読めば、必要な情報の大半がわかります。

よく目にする型

  • intは整数を保持します。バーの本数や、マジックナンバー(EAが自分の注文を見つけられるよう、注文に付ける番号)などです。
  • doubleは小数を含む数値を保持します。ロット数や、価格値で表した距離などです。
  • boolはtrueまたはfalseで、この2つの選択肢を持つドロップダウンとして表示されます。
  • stringは文字列を保持します。注文に付けるコメントや、銘柄のサフィックスなどです。
  • enum型は、時間足やモードなど、名前付きの選択肢のリストを表示します。名前はコード内で宣言された列挙型に由来し、リストにない値は入力できません。

ラベルになるコメント

input行の後ろに、スラッシュ2つで始めて書いたコメントは、Inputsタブで変数名の代わりにその行のラベルとして表示されます。input int MaxSpread = 30; // Maximum spread allowedという行では、スラッシュ以降のテキストが表示されます。コメントだけを変えても、ウィンドウの表示が変わるだけで、プログラムの動作は変わりません。ただし、ラベルがわかりやすくても、単位までわかりやすいとは限りません。ポイント、pips、金額のどれなのかは、コードがその数値をどう使っているかを確認してから判断してください。

グループ

MQL5では、input group "Risk settings"のような行で、関連するinputを見出しの下にまとめられます。見出しはウィンドウ内で区切り行として表示されます。売買には影響せず、リストを整理するだけです。

inputとsinput:違いで何が変わるか

キーワードsinputは静的なinputを宣言します。Inputsタブでは通常のinputとまったく同じように表示され、セットファイルからも読み込めますが、最適化(選んだinputを変えながら行う一連のテスト実行)を行うときには、ストラテジーテスターの対象から外されます。作者は、マジックナンバーやコメント文字列など、変化させるべきでない値にsinputを使います。

初期値の編集においては、実務上の影響が一つあります。ある行でinputをsinputに、あるいはその逆に変えると、変わるのは最適化でその値を動かせるかどうかであって、値そのものではありません。理由があり、影響を理解している場合を除き、キーワードは作者が書いたままにしてください。正確な構文が必要なときは、MQL5ドキュメントに、入力変数とそのルールが詳しく記載されています。

MQL5ソースの初期値を変更する前の準備

小さな編集でも無害に見えて、EAの売買の仕方を変えてしまうことがあります。そのため、ファイルを開く前に準備をしてください。この段階でのミスの多くは、編集そのものではなく、バックアップを省いたことから生じます。

  1. 未編集のソースを別のフォルダーにコピーします。そのコピーには手を加えず、わかりやすい名前を付けて保管してください。編集に失敗したときに戻るための手段になります。
  2. 付属のセットファイルは残しておきます。ダウンロードにセットファイルが含まれている場合は、そのままにして、自分用のバリエーションは別の名前で保存してください。
  3. テスト用のコピーで作業します。すでに稼働させているプログラムを、コンパイルで上書きしないよう、新しいファイル名を付けた複製を編集してください。
  4. 開始時の値を書き留めます。変更する前に、各初期値を書き留めてください。該当の行、変更前の値、変更後の値を記した短いテキストファイルで十分です。
  5. 銘柄と時間足を把握します。値は特定の市場とチャート期間を前提に選ばれています。ある銘柄に合う距離が、別の銘柄では大きすぎたり小さすぎたりすることがあります。

ダウンロードしたファイルで、パッケージの中身がよくわからない場合は、MQ4・MQ5ソースコードのガイドで、ソースファイルとコンパイル済みファイルの関係を説明しています。

MetaEditorでinputの初期値を変更して再コンパイルする手順

以下の手順は、ソースファイルがMT5のデータフォルダー内のMQL5フォルダー、その中のExpertsサブフォルダーにあることを前提としています。データフォルダーは、ターミナルの「ファイル」から「データフォルダーを開く」で開けます。

  1. MetaTrader 5でF4キーを押し、MetaEditorを開きます。
  2. ナビゲーターパネルでMQL5、Expertsの順に展開し、テスト用コピーの.mq5ファイルをダブルクリックします。
  3. inputまたはsinputで始まる行のブロックまでスクロールします。ファイルが長い場合は、Ctrl+Fでその語を検索します。
  4. イコールの右側の値だけを変更します。input double LotSize = 0.10;であれば、0.10の部分だけを置き換え、セミコロン、型、名前はそのまま残します。
  5. ドロップダウンのinputでは、列挙型にすでに存在する値を選びます。右辺に新しい単語を入力しないでください。
  6. Ctrl+Sで保存し、続けてF7でコンパイルします。
  7. 下部のErrorsタブを開きます。エラーがゼロであることを確認し、警告も読んでください。
  8. ターミナルに戻り、ナビゲーターを更新し(またはMT5を再起動し)、チャートから古いEAを削除して、再ビルドしたEAを適用します。
  9. Inputsタブを開き、その行に新しい初期値が表示されていることを確認します。

ビルド手順とそのエラーメッセージについてさらに詳しく知りたい場合は、MetaEditorでMQ5をコンパイルする方法をご覧ください。

小さな編集の後にビルドが失敗するとき

よくある原因は、セミコロンの抜け、文字列値の引用符の削除、小数点をピリオドではなくカンマで入力したことです。MQL5では小数点にピリオドが必要です。Ctrl+Zで元に戻すか、バックアップと見比べて、もう一度ゆっくり変更し直してください。

EAのinputを編集するときに触れてはいけないもの

初期値を変えることと、戦略を変えることは同じではなく、その境界をはっきり保つことには意味があります。ロット数、時間帯、スプレッド上限などの値は、作者が利用者による調整を想定した設定です。それ以上のこと、たとえば取引を開始または決済するタイミングを決めるコードの編集は、プログラムそのものを変えることになります。

  • inputの名前を変えないでください。保存済みのセットファイルは、名前でinputを参照します。名前を変えると、古いセットファイルがその値を適用できず、何も知らせないまま初期値のままになることがあります。
  • コードがまだ使っているinput行を削除しないでください。ビルド時に、未宣言の識別子としてエラーが報告されます。
  • 型をintからdoubleへ、あるいはその逆へ変えないでください。変数が使われているすべての箇所を確認した場合は別です。値が切り捨てられたり、思わぬ形で比較されたりすることがあるためです。
  • 編集したバージョンを、未編集の製品として説明しないでください。コードを変えた時点で、動作を検証する責任は自分にあります。未編集のEAについて掲載情報が述べていることは、編集したビルドには当てはまりません。

編集したEAが未編集のものと同じように動作すると約束できる人はいません。また、初期値を変えると、EAが取るエクスポージャーが増えることも減ることもあります。編集のたびに、独自のテストが必要な新しい設定として扱ってください。

例:Smart Gold Hunterのソースコードでinputを読む

ソースコードのダウンロードがあれば、読む練習に使える具体的なファイルが手に入ります。Smart Gold Hunter EA Source Code (MQ5)パッケージは、バージョン3.5のMetaTrader 5向け製品です。掲載情報によると、XAUUSDのM5とM15向けに設計されており、戦略はスキャルピング、経済指標トレード、両建てと説明されています。ダウンロードには、コンパイル済みファイル1つ、ソースファイル1つ、セットファイル6つが含まれ、DLLは使用されていません。

このテーマにとって、セットファイルは重要です。それぞれがEAのinputの開始設定であり、結果を推奨するものではありません。ソースの初期値を編集する前に、セットファイルを1つ読み込んでInputsタブを確認し、次にソースを開いてinputブロックで同じ名前を探してください。この比較で、セットファイルがどの値を上書きし、どの値がコード上の初期値のままなのかがわかります。

掲載情報には、推奨最低資金として$100が記載され、プロップファームのチャレンジルールを念頭に作られたEAであることも示されています。編集したコピーをプロップファームの口座で使うつもりなら、まずEAに関する会社のルールを確認してください。ルールは会社ごとに異なり、編集したビルドは掲載情報が説明しているものではないためです。6つのファイルの読み込み方は、MT4・MT5でセットファイルを読み込む方法のガイドで各手順を説明しています。

inputパラメーターを変更した後のEAのテスト

コンパイルが通っても、証明されるのは文法が正しいことだけです。新しい値でEAがどう売買するかは何も示しません。編集したビルドを実際の資金に近づける前に、次の確認を行ってください。

  1. 初期値を確認します。再ビルドしたEAを新しいチャートに適用し、変更した各行をInputsタブで確認してください。
  2. Expertsタブを読みます。Ctrl+Tでツールボックスを開き、Expertsタブで初期化メッセージやエラーがないか確認してください。
  3. ストラテジーテスターを実行します。編集したビルドと未編集のビルドを、同じ銘柄、時間足、期間でテストし、実行ごとに変えるinputは一つだけにしてください。テスターの結果は保存された価格データに基づいており、将来について確かなことは何も示しません。
  4. デモ口座を使います。ブローカーの条件はテスターの条件と異なるため、さまざまなスプレッドや急な相場の動きに遭遇できるだけの期間、デモ口座でEAを動かしてください。
  5. 設定をもう一度確認します。実際に使う前に、ロット数、スプレッド上限、口座タイプを、ブローカーの契約内容と照らし合わせてください。

変更履歴をつける

それぞれのビルドを区別できるよう、たとえばEA名に日付や短いバージョンメモを加えて名前を付けてください。メモのファイルはソースの隣に置いておきます。結果が意外だったときに、履歴を見れば、どの値が動いたのかが正確にわかり、バックアップへもすぐに戻れます。

EAのinputが期待どおりに動かないときのよくある問題

Inputsタブに古い初期値が表示されたままになる

古いコンパイル済みファイルがまだチャートに残っているか、ターミナルが読み込むものとは別のコピーをコンパイルしたかのどちらかです。「ファイル」から「データフォルダーを開く」で開いたフォルダー内のファイルを確認し、EAを削除してから適用し直してください。

Inputsタブに行がまったく表示されない

input行のないEAには、表示するものがありません。また、設定をinputではなく通常のグローバル変数で宣言しているプログラムもあります。それらはウィンドウから変更できず、ソースでの編集が必要です。

セットファイルが値を適用しなくなった

これは通常、inputの名前または型を変えた後に起こります。以前の名前と型に戻すか、再ビルドしたEAのInputsタブから新しいセットファイルを保存してください。

別のブローカーでEAの売買が変わる

ストップの距離やスプレッド上限などの値はポイントで測られますが、ブローカーごとに桁数、スプレッド、契約サイズが異なります。ある口座に合う初期値が、別の口座では違う動きをすることがあるため、実際に使う口座タイプでテストしてください。

今週、デモ口座でinputの編集を練習する

最初の練習は小さなもので十分です。ソースファイルをコピーし、初期値を一つだけ変え、コンパイルして、変更前後のInputsタブを比べます。バックアップと変更履歴を残し、まずデモ口座でテストしてください。ほかにも読むファイルが欲しい場合は、EAソースコードのダウンロードをご覧いただけます。また、ショップのすべての製品はメンバーシップに含まれています。当ショップはデジタルダウンロードを販売しており、製品の開発元ではありません。

外国為替取引およびCFD取引は高いリスクを伴い、すべての投資家に適しているとは限りません。過去の実績は将来の結果を保証するものではありません。失っても問題のない資金の範囲でのみ取引してください。

タグ: EA Source Code, MQL5, MetaEditor

← 記事一覧

メンバーシップで全EAを利用

310 件の製品 · $16.59/月から

プランを見る

EAソースコードのその他の記事