Home
MQL4(MT4) APIリファレンス（各種関数、変数の使い方）

MQL4(MT4) APIリファレンス（各種関数、変数の使い方）

2024.01.28

MQL4 (MT4)の各種API、変数の利用方法等について、ChatGPTに聞いてみました。
一覧にしていますので、参考にしてもらえたらと思います。

使用GPTｓ：EA Creator

事前定義変数（The predefined Variables）

MQL4プログラム（エキスパートアドバイザー、スクリプト、またはカスタムインジケーター）が起動される際、現在の価格チャートの状態を反映する一連の事前定義された変数がサポートされています。

以下に事前定義された変数一覧を示します。詳細は「MQL4(MT4) の事前定義変数（Predefined Variables）と使用例」をご参照ください。

変数名説明
_Digits現在のシンボルの小数点以下の桁数
_Point現在のシンボルのポイントサイズ（見積もり通貨）
_LastError最後に発生したエラーコード
_Period現在のチャートの時間枠
_RandomSeed擬似乱数ジェネレータの現在の状態
_StopFlagプログラム停止フラグ
_Symbol現在のチャートのシンボル名
_UninitReason初期化解除の理由コード
Ask現在のシンボルの最新の売り手価格（アスク価格）
Bars現在のチャートのバー数
Bid現在のシンボルの最新の買い手価格（ビッド価格）
Close各バーの終値を含むシリーズ配列
Digits現在のシンボル価格の小数点以下の桁数
High各バーの最高価格を含むシリーズ配列
Low各バーの最低価格を含むシリーズ配列
Open各バーの始値を含むシリーズ配列
Point現在のシンボルのポイント値（見積もり通貨）
Time各バーのオープン時間を含むシリーズ配列
Volume各バーのティックボリュームを含むシリーズ配列

イベントハンドリング関数

イベント受信用の関数です。

MQL4言語では、いくつかの事前定義されたイベントの処理が提供されています。これらのイベントを扱う関数は、MQL4プログラム内で定義されなければならず、関数名、戻り値の型、パラメータ（存在する場合）およびその型は、イベントハンドラ関数の説明に厳密に準じる必要があります。

クライアントターミナルのイベントハンドラは、戻り値の型とパラメータの型によって、このまたはそのイベントを処理する関数を識別します。対応する関数に対して、以下の説明に合致しないパラメータが指定されたり、別の戻り値の型が示されたりした場合、その関数はイベントハンドラとして使用されません。

関数名概要
OnInitエキスパートアドバイザーやインジケータがチャートに読み込まれた時に一度だけ呼ばれる初期化関数です。初期設定やリソースの準備に使用されます。
OnDeinitエキスパートアドバイザーやインジケータがチャートから削除される時、またはMT4が閉じられる時に呼ばれる終了関数です。使用したリソースの解放などの後処理に使用されます。
OnStartスクリプトが実行された時に呼ばれる関数です。エキスパートアドバイザーでは使用されません。
OnCalculateカスタムインジケーターが新しい価格データを受け取った時に呼ばれる関数です。価格データの分析やインジケーター値の計算に使用されます。
OnTick新しい市場のティックデータ（価格更新）が到着した時にエキスパートアドバイザーによって呼ばれる関数です。トレードの決定や価格分析に使用されます。
OnTimer設定された時間間隔で定期的に呼ばれる関数です。定期的なタスクの実行や状態のチェックに使用されます。
OnTesterバックテスト中に呼ばれる関数です。バックテストの最後に特定の処理を行うために使用されます。
OnChartEventチャートイベント（マウス操作、キーボード入力、カスタムイベント）が発生した時に呼ばれる関数です。ユーザーの操作に応じた処理やインタラクティブな機能の実装に使用されます。

イベント設定関数

イベント設定用の関数です。

これらの関数を使用することで、特定の時間に定期的に実行する必要があるコードや、カスタムイベントに応じて動作するコードを実装することが可能になります。これは、自動取引システムや複雑なアルゴリズムを持つインジケータで特に有用です。各関数を使用する際は、特定のイベントが発生したときに適切なアクションを取るように、関連するイベントハンドラ関数を適切に実装する必要があります。

関数名概要
EventSetMillisecondTimerミリ秒単位でタイマーイベントを設定します。指定された時間間隔後にOnTimer()イベントを発生させるために使用します。
EventSetTimer秒単位でタイマーイベントを設定します。指定された時間間隔後にOnTimer()イベントを発生させるために使用します。
EventKillTimerタイマーイベントを削除します。EventSetTimerまたはEventSetMillisecondTimerによって設定されたタイマーを停止し、OnTimer()の呼び出しを停止します。
EventChartCustomカスタムチャートイベントを生成します。カスタムイベントを処理するためにOnChartEvent()関数内で使用されます。

トレード関数

トレード用の関数です。

取引活動を管理するために意図された関数群です。

トレード関数は、エキスパートアドバイザーやスクリプトで使用できます。取引口座の状態を変更するOrderSend()、OrderClose()、OrderCloseBy()、OrderModify()、OrderDelete()などのトレード関数は、エキスパートアドバイザーが取引を許可されている場合（エキスパートアドバイザーやスクリプトのプロパティで「ライブトレードを許可」チェックボックスが有効になっている場合）のみ呼び出すことができます。

取引の許可または禁止は、取引許可セクションで説明されている様々な要因に依存しています。

関数名概要
OrderClose指定されたチケット番号、ロット数、クローズ価格、スリッページを指定して特定の注文を閉じるために使用されます。成功した場合、真を返します。
OrderCloseBy2つの相反する注文を相殺するために使用され、一方の注文を閉じ、もう一方には相当する利益または損失が記録されます。
OrderClosePrice最後に閉じられた注文のクローズ価格を返します。注文が選択されている必要があります。
OrderCloseTime注文が閉じられた正確な日時を返します。注文が閉じられていない場合は、ゼロを返します。
OrderComment注文に関連付けられたコメントを返します。
OrderCommission注文にかかるコミッションの金額を返します。
OrderDelete指定されたチケット番号の保留中の注文を削除します。成功した場合、真を返します。
OrderExpiration保留注文の有効期限を日時形式で返します。有効期限が設定されていない場合は、ゼロを返します。
OrderLots注文のロット数を返します。
OrderMagicNumber注文に割り当てられたマジックナンバーを返します。これは注文を識別するためにEAによって使用される数値です。
OrderModify既存の注文のパラメータ（価格、ストップロス、テイクプロフィット、有効期限等）を変更します。成功した場合、真を返します。
OrderOpenPrice注文が開かれた価格を返します。
OrderOpenTime注文が開かれた正確な日時を返します。
OrderProfit選択された注文の詳細情報をエキスパートログに出力します。
OrderProfit注文から得られた利益または損失を返します。
OrderSelect指定されたチケット番号の注文を選択するか、全注文の中から特定の注文を選択します。成功した場合、真を返します。
OrderSend新しい注文を送信します。注文のタイプ、量、価格、ストップロス、テイクプロフィット等を指定できます。成功した場合、注文のチケット番号を返します。
OrdersHistoryTotalアカウントの取引履歴に含まれる注文の総数を返します。これには閉じられた注文とキャンセルされた注文が含まれます。
OrderStopLoss注文のストップロスレベルを返します。
OrdersTotal現在開いている注文の総数を返します。
OrderSwap注文にかかるスワップ料金を返します。
OrderSymbol注文が関連する通貨ペアを返します。
OrderTakeProfit注文のテイクプロフィットレベルを返します。
OrderTicket注文のユニークなチケット番号を返します。
OrderType注文のタイプ（買い、売り、買い停止、売り停止、買いリミット、売りリミット）を表す整数値を返します。

グラフィックオブジェクト関数

グラフィックオブジェクト関連の関数です。

指定されたチャートに関連するグラフィックオブジェクトを操作するための関数群です。現在のチャート上のオブジェクトを操作する場合、直接アクセスが使用され、関数呼び出し中に指定されたオブジェクトの存在が事前にチェックされ、失敗した場合は直ちにエラーコードが返されます。現在のもの以外のチャートのオブジェクトに関数を使用する場合、事前チェックが行われず、そのチャートのキューに関数がそのまま追加される非同期関数呼び出しが使用されます。

グラフィックオブジェクトのプロパティを設定する関数や、ObjectCreate()、ObjectMove() 操作は、実際にはチャートへのコマンド送信に使用されます。これらの関数が成功した場合、コマンドはチャートイベントのキューに追加されます。グラフィックオブジェクトのプロパティの視覚的な変更は、キューからのチャートイベントの処理によって実装されます。

そのため、これらの関数を呼び出した後にグラフィックオブジェクトの視覚的な更新が即時に行われるとは期待しないでください。一般的に、チャート上のグラフィックオブジェクトは、新しい見積もりの到着、チャートウィンドウのサイズ変更などの更新イベントに基づいて、端末によって自動的に更新されます。グラフィックオブジェクトの更新を強制するには、ChartRedraw() コマンドを使用します。

関数名概要
ObjectCreateチャート上に新しいオブジェクトを作成します。
ObjectName指定されたインデックスにあるオブジェクトの名前を取得します。
ObjectDeleteチャートから指定された名前のオブジェクトを削除します。
ObjectsDeleteAll特定のウィンドウ、またはすべてのウィンドウからオブジェクトを削除します。
ObjectFind指定された名前のオブジェクトが存在するウィンドウのインデックスを返します。
ObjectGetTimeByValue指定された価格に対応する時間をオブジェクトから取得します。
ObjectGetValueByTime指定された時間に対応する価格をオブジェクトから取得します。
ObjectMove指定されたオブジェクトを新しい位置に移動します。
ObjectsTotalチャート上のオブジェクトの総数を返します。
ObjectGetDouble指定されたオブジェクトのプロパティ値（double型）を取得します。
ObjectGetInteger指定されたオブジェクトのプロパティ値（整数型）を取得します。
ObjectGetString指定されたオブジェクトのプロパティ値（文字列型）を取得します。
ObjectSetDouble指定されたオブジェクトのプロパティ値（double型）を設定します。
ObjectSetInteger指定されたオブジェクトのプロパティ値（整数型）を設定します。
ObjectSetString指定されたオブジェクトのプロパティ値（文字列型）を設定します。
TextSetFontテキストオブジェクトのフォント名、サイズ、スタイル、重さを設定します。
TextOutチャートに直接テキストを描画します。
TextGetSize指定されたテキストのサイズを取得します。
ObjectDescriptionオブジェクトの説明を取得します。
ObjectGetオブジェクトのプロパティを取得します。
ObjectGetFiboDescriptionフィボナッチオブジェクトのレベル説明を取得します。
ObjectGetShiftByValue指定された価格に対応するオブジェクトのシフトを取得します。
ObjectGetValueByShift指定されたシフトに対応するオブジェクトの価格を取得します。
ObjectSetオブジェクトの特定のプロパティを設定します。
ObjectSetFiboDescriptionフィボナッチオブジェクトのレベル説明を設定します。
ObjectSetTextオブジェクトにテキストを設定します。
ObjectTypeオブジェクトのタイプを取得します。

アカウント情報関数

アカウント情報関連の関数です。

現在のアカウント情報を取得するための関数群です。

関数名概要
AccountInfoDoubleアカウントの数値情報をdouble型で返します（例: バランス、エクイティなど）。
AccountInfoIntegerアカウントの数値情報をlong型で返します（例: レバレッジ、ストップアウトレベルなど）。
AccountInfoStringアカウントの文字列情報を返します（例: アカウント名、通貨など）。
AccountBalanceアカウントの現在のバランスを返します。
AccountCreditアカウントのクレジット額を返します。
AccountCompanyアカウントを提供するブローカー会社の名前を返します。
AccountCurrencyアカウントの通貨を返します。
AccountEquityアカウントのエクイティ（資産額）を返します。
AccountFreeMarginアカウントの利用可能なマージンを返します。
AccountFreeMarginCheck指定されたシンボルとロット数で取引を行った場合の、アカウントの利用可能なマージンを計算します。
AccountFreeMarginModeアカウントのマージン計算モードを返します。
AccountLeverageアカウントのレバレッジを返します。
AccountMarginアカウントの使用中のマージンを返します。
AccountNameアカウントの名前を返します。
AccountNumberアカウントの番号を返します。
AccountProfitアカウントの現在の浮動損益を返します。
AccountServerアカウントを提供するサーバーの名前を返します。
AccountStopoutLevelストップアウトレベル（マージンコールレベル）を返します。
AccountStopoutModeストップアウトの計算モードを返します。

カスタムインジケータ関数

カスタムインディケータ関連の関数です。

カスタムインディケータを作成する際に使用されるグループ関数です。これらの関数は、エキスパートアドバイザーやスクリプトを書く際には使用できません。

関数名概要
HideTestIndicatorsテスト中にグラフ上のインディケータを隠すかどうかを設定します。チャート上での表示を制御するのに使用されます。
IndicatorSetDoubleインディケータの設定可能なdouble型プロパティ（例: 最小値、最大値）を設定します。これはインディケータの表示範囲やスケールを調整するのに使われます。
IndicatorSetIntegerインディケータの設定可能なinteger型プロパティ（例: 描画スタイル、幅）を設定します。インディケータの見た目をカスタマイズするのに役立ちます。
IndicatorSetStringインディケータの設定可能なstring型プロパティ（例: 名前）を設定します。インディケータの識別や説明に使用されます。
SetIndexBufferインディケータ計算結果を格納するバッファを設定します。インディケータのデータを格納する配列を割り当てるのに必要です。
IndicatorBuffersインディケータが使用するバッファの数を設定します。計算に必要なデータ配列の数を定義します。
IndicatorCounted既に計算されたバーの数を返します。これにより、新たに計算が必要なデータのみを処理できます。
IndicatorDigitsインディケータの価格データの表示精度（小数点以下の桁数）を設定します。チャート上での価格表示を制御します。
IndicatorShortNameインディケータの短縮名を設定します。チャートのデータウィンドウに表示される名前です。
SetIndexArrowインディケータのバッファに対して表示する矢印記号を設定します。特定の条件を示すマーカーとして利用されます。
SetIndexDrawBeginインディケータが描画を開始するバーの数を設定します。これにより、過去の特定のポイントから描画を開始できます。
SetIndexEmptyValueインディケータのバッファで未定義の値を表すために使用する値を設定します。空のデータポイントを示すのに使用されます。
SetIndexLabelインディケータの各バッファのラベルを設定します。データウィンドウに表示される各バッファの説明テキストです。
SetIndexShiftインディケータの描画をずらすバーの数を設定します。インディケータの表示を時間軸に沿って前後に移動させることができます。
SetIndexStyleインディケータの線のスタイル、太さ、色を設定します。インディケータの視覚的表現をカスタマイズするのに使われます。
SetLevelStyleインディケータのレベル線のスタイルと色を設定します。特定の価格レベルや意味のある閾値を示すのに使用されます。
SetLevelValueインディケータのレベル線の値を設定します。これにより、チャート上に表示される水平線の位置を定義できます。

テクニカルインディケータ関数

テクニカルインディケータ関連の関数です。

標準およびカスタムインディケータの計算を目的とした関数群です。

エキスパートアドバイザー（または他のMQL4プログラム）が任意のインディケータの値を取得するためには、そのインディケータがチャートに表示されている必要はありません。要求されたインディケータは、呼び出したモジュールのスレッドでロードされ、計算されます。

任意のインディケータは、現在のチャートのデータだけでなく、利用可能な任意のシンボル/期間のデータに基づいて計算することができます。別のチャートからデータ（シンボル名および/またはタイムフレームが現在のものと異なる）が要求される場合、対応するチャートがクライアントターミナルで開かれていなかった状況が発生し、必要なデータをサーバーから要求する必要があります。この場合、エラーERR_HISTORY_WILL_UPDATED（4066 – 要求された履歴データが更新中です）がlast_error変数に設定され、再度要求する必要があります（ArrayCopySeries()の例を参照）。

すべてのインディケータ関数には、少なくとも2つのパラメーター（シンボルと期間）があります。シンボルのNULL値は現在のシンボルを意味し、期間の0値は現在のタイムフレームを意味します。

関数名概要
iACAccelerator Oscillatorの値を計算します。
iADAccumulation/Distributionインディケータの値を計算します。
iADX平均方向移動指数 (Average Directional Movement Index) の値を計算します。
iAlligatorビル・ウィリアムズのアリゲーターインディケータの値を計算します。
iAOAwesome Oscillatorの値を計算します。
iATR平均真の範囲 (Average True Range) の値を計算します。
iBearsPowerベアパワーインディケータの値を計算します。
iBandsボリンジャーバンドの値を計算します。
iBandsOnArray配列データに基づいてボリンジャーバンドの値を計算します。
iBullsPowerブルパワーインディケータの値を計算します。
iCCI商品チャネル指数 (Commodity Channel Index) の値を計算します。
iCCIOnArray配列データに基づいて商品チャネル指数の値を計算します。
iCustomカスタムインディケータの値を計算します。
iDeMarkerDeMarkerインディケータの値を計算します。
iEnvelopesエンベロープインディケータの値を計算します。
iEnvelopesOnArray配列データに基づいてエンベロープインディケータの値を計算します。
iForceフォースインデックスの値を計算します。
iFractalsフラクタルインディケータの値を計算します。
iGatorゲーターオシレータの値を計算します。
iIchimoku一目均衡表の値を計算します。
iBWMFI市場係数インディケータ (Market Facilitation Index) の値を計算します。
iMomentumモメンタムインディケータの値を計算します。
iMomentumOnArray配列データに基づいてモメンタムインディケータの値を計算します。
iMFI資金流量指数 (Money Flow Index) の値を計算します。
iMA移動平均の値を計算します。
iMAOnArray配列データに基づいて移動平均の値を計算します。
iOsMA移動平均のオシレータ (OsMA) の値を計算します。
iMACD移動平均収束発散 (MACD) の値を計算します。
iOBVオンバランスボリューム (On Balance Volume) の値を計算します。
iSARパラボリックSARの値を計算します。
iRSI相対力指数 (Relative Strength Index) の値を計算します。
iRSIOnArray配列データに基づいて相対力指数の値を計算します。
iRVI相対活性指数 (Relative Vigor Index) の値を計算します。
iStdDev標準偏差インディケータの値を計算します。
iStdDevOnArray配列データに基づいて標準偏差インディケータの値を計算します。
iStochasticストキャスティクスオシレータの値を計算します。
iWPRウィリアムズ%Rインディケータの値を計算します。

注意点

  • カスタムインディケーターの開発時にこれらの関数を使用しますが、エキスパートアドバイザーやスクリプトでの使用はできません。
  • 各関数のパラメータは、計算するインディケーターの特性や必要な入力値によって異なります。適切なパラメータ値を設定することが重要です。
  • インディケータの計算結果を解釈する際は、その指標が示す市場状況を正確に理解する必要があります。各インディケータの理論背景や使い方を学ぶことが推奨されます。
  • インディケータのパフォーマンスや効率性を考慮して、計算に必要なデータ範囲や期間を適切に設定してください。不必要に長い期間のデータを計算に含めると、パフォーマンスに影響を及ぼす場合があります。

関連記事

タイトルとURLをコピーしました