【MQL5】MathArctan関数の使い方と自動売買実装コード

1. MathArctan関数の概要と実務での活用法

MathArctan関数は、指定した数値の逆正接（アークタンジェント）を計算するための関数です。数学的には「ある傾き（タンジェント）から、その角度を逆算する」役割を担います。

FXのシステムトレード開発において、この関数は主に「トレンドの勢い（角度）」を数値化するために活用されます。例えば、移動平均線（MA）がただ右肩上がりなだけでなく、「45度以上の急角度で上昇しているか？」といった条件をロジックに組み込む際に必須となります。

実務開発で多くの初心者がつまずくポイントは、「価格の差分」と「実際のチャート上の見た目の角度」の不一致です。価格の変動幅（Pips）をそのまま代入するだけでは正確な角度は出せません。時間軸と価格軸の比率を考慮した正規化が必要になりますが、その第一歩として「数値からラジアン（角度の単位）を得る」のがこの関数の役割です。

2. 構文と戻り値

MathArctan関数の使い方は非常にシンプルです。

double MathArctan(
   double  value      // ターゲットとなる数値（傾き）
);

• パラメーター: value には、角度を求めたいタンジェントの値（傾き）を入力します。
• 戻り値: $-\pi/2$ から $\pi/2$ （ラジアン単位）の範囲で、指定された値の逆正接を返します。

※度数（0～360度）ではなく、ラジアン（0～$\pi$）で返ってくる点に注意が必要です。

3. 具体的な使い方・実践サンプルコード

以下のコードは、2本の移動平均線の値から現在の「傾きの角度」を計算し、一定以上の角度があればエントリー判断に使うためのサンプルです。

//+------------------------------------------------------------------+
//| 移動平均線の傾きを角度で取得するサンプルコード                           |
//+------------------------------------------------------------------+
double GetMAAngle(int period)
{
   double ma_now = iMA(_Symbol, _Period, period, 0, MODE_SMA, PRICE_CLOSE, 0);
   double ma_prev = iMA(_Symbol, _Period, period, 0, MODE_SMA, PRICE_CLOSE, 1);

   // 1. 価格の差分を計算（価格のままだと値が小さすぎるため、Pips単位などに調整）
   double price_diff = (ma_now - ma_prev) / _Point;

   // 2. MathArctanで逆正接を求める（戻り値はラジアン）
   double radian = MathArctan(price_diff);

   // 3. ラジアンを「度（degree）」に変換（180 / π を掛ける）
   double degree = radian * 180.0 / M_PI;

   return degree;
}

void OnTick()
{
   // 20期間移動平均線の角度を取得
   double angle = GetMAAngle(20);

   // 角度が30度を超えていたら上昇トレンドと判断
   if(angle > 30.0)
   {
      Print("強い上昇トレンド検知: 角度 = ", DoubleToString(angle, 2));
      // ここに買いロジックなどを記述
   }
}

4. 使用上の注意点とよくあるエラー

開発時に注意すべき最大のポイントは、「価格スケール（縦軸）の影響」です。

1. ラジアンと度の混同: MathArctanの戻り値をそのまま If(angle > 45) のように判定に使っても、意図した動作をしません。必ず 180 / M_PI を掛けて度数法に変換しましょう。
2. 正規化の重要性: 通貨ペアや時間足によって1バーあたりの価格変動幅は大きく異なります。ドル円での「10Pipsの差」と、ポンド円での「10Pipsの差」は、ボラティリティが異なるため、単純に比較すると角度の意味が変わってしまいます。実務ではボラティリティ（ATR等）で差分を割るなどの正規化を行うのが一般的です。
3. MathArctan2との使い分け: MathArctanは引数が1つですが、X方向とY方向のベクトルから直接角度を出したい場合は MathArctan2(y, x) を使う方が、符号判定（正負の向き）を含めて処理できるため便利な場合があります。

5. 【重要】自動売買における約定スピードと環境の罠

アルゴリズムトレードにおいて、MathArctanなどでどれほど精緻な計算ロジックを組み上げたとしても、それを実行する「インフラ」が脆弱であれば全ては無意味になります。多くの個人開発者が陥る罠が、自宅のPCや一般的な光回線での運用です。FXの市場価格はミリ秒単位で変動しており、自宅PCからの注文は物理的な距離とネットワーク経路の複雑さから、サーバーに到達するまでに致命的な遅延（レイテンシ）が発生します。

この遅延は「スリッページ」を招き、バックテストでは利益が出ていたロジックを実運用で赤字へと叩き落とします。プロのクオンツ環境において、約定スピードを極限まで高めるための専用VPS（仮想専用サーバー）導入は「オプション」ではなく「必須条件」です。ブローカーのサーバーに物理的に近いデータセンターに設置されたVPSを利用することで、ネットワーク遅延を最小化し、計算された理論通りの価格で約定させる。このインフラの差こそが、シストレで生き残るエンジニアと退場する素人を分ける決定的な境界線となります。