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

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

MQL5のSignalBaseGetIntegerは、MetaTrader 5（MT5）が提供する「シグナルサービス」に登録されている公開シグナルのうち、整数型（long型）のプロパティ値を取得するための関数です。

実務レベルの開発では、主に「シグナルの自動フィルタリング」や「コピー取引の動的な選択」に活用されます。例えば、購読者数が一定以上の人気シグナルのみを抽出したり、レバレッジ設定が自身の口座と合致するシグナルを特定したりする際に不可欠です。

実務でつまずきやすいポイント：
初心者の多くは、この関数を呼び出す前に「シグナルの選択（SignalBaseSelect）」が必要であることを忘れがちです。MT5内部のデータベースから対象のシグナルを一度インデックス（番号）で指定（セレクト）してからでないと、正しいデータは取得できません。また、自身の現在の購読情報を取得する「SignalInfo系関数」と、シグナルベース全体を検索する「SignalBase系関数」を混同しないよう注意が必要です。

2. 構文と戻り値

SignalBaseGetInteger関数の基本的な構文は以下の通りです。

long SignalBaseGetInteger(
   ENUM_SIGNAL_BASE_INTEGER  property_id     // プロパティ識別子
);

パラメーター

• property_id: 取得したい情報の種類をENUM_SIGNAL_BASE_INTEGERの中から指定します。
  • SIGNAL_BASE_ID: シグナルのID
  • SIGNAL_BASE_SUBSCRIBERS: 現在の購読者数
  • SIGNAL_BASE_LEVERAGE: シグナル配信者の最大レバレッジ
  • SIGNAL_BASE_DATE_PUBLISHED: シグナルの公開日（UNIXタイムスタンプ）

戻り値

成功した場合は指定されたプロパティの値をlong型で返します。失敗した場合は「0」を返します。エラーの詳細を確認するにはGetLastError()関数を使用します。

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

以下のコードは、現在利用可能なシグナルリストを全件スキャンし、「購読者が最も多い人気のシグナル」のIDと購読者数をエキスパートログに出力するスクリプト例です。

void OnStart()
{
    // 利用可能なシグナルの総数を取得
    int total_signals = SignalBaseTotal();

    long max_subscribers = -1;
    long best_signal_id = 0;

    // 全シグナルをループで確認
    for(int i = 0; i < total_signals; i++)
    {
        // 1. まずインデックスでシグナルを選択（必須ステップ）
        if(SignalBaseSelect(i))
        {
            // 2. 選択したシグナルの購読者数を取得
            long subscribers = SignalBaseGetInteger(SIGNAL_BASE_SUBSCRIBERS);

            // 3. 最大購読者数のシグナルを保持
            if(subscribers > max_subscribers)
            {
                max_subscribers = subscribers;
                best_signal_id = SignalBaseGetInteger(SIGNAL_BASE_ID);
            }
        }
        else
        {
            Print("シグナルの選択に失敗しました。インデックス: ", i);
        }
    }

    // 結果の出力
    if(best_signal_id > 0)
    {
        PrintFormat("最も人気のシグナルID: %lld, 購読者数: %lld", best_signal_id, max_subscribers);
    }
    else
    {
        Print("シグナルが見つかりませんでした。");
    }
}

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

1. インデックスの有効範囲: SignalBaseSelectに渡すインデックスは、0からSignalBaseTotal() - 1の範囲である必要があります。範囲外を指定するとエラーになります。
2. データ型の一致: SignalBaseGetDouble（浮動小数点数用）と混同しないようにしてください。例えば、シグナルの価格（SIGNAL_BASE_PRICE）を取得したい場合はSignalBaseGetDoubleを使用する必要があります。
3. 同期のタイミング: ネットワークの状態により、シグナル情報の取得に時間がかかったり、一時的に空のデータが返ってきたりすることがあります。特にOnTick内で頻繁に呼び出すとパフォーマンス低下の原因になるため、OnInitや特定のタイマーイベントでの処理を推奨します。

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

アルゴリズムトレードの世界において、ロジックの優劣以上に勝敗を分けるのが「実行環境」です。自宅のPCや一般的な光回線でEAを稼働させることは、プロのレーサーが一般道をファミリーカーで走るようなものです。家庭用ネットワークでは、プロバイダーを経由するたびにミリ秒単位の遅延（レイテンシ）が発生し、MT5の注文が証券会社のサーバーに届く頃には、価格が数ピップス滑ってしまう「スリッページ」が避けられません。

このわずかな遅延が、数ヶ月のスパンでは致命的な損失の差となって現れます。約定スピードを極限まで高め、物理的な距離による損失を排除するには、証券会社のサーバーと同じデータセンター、あるいは至近距離に設置された専用の「FX用VPS」が必須です。24時間安定した稼働環境と超低遅延なネットワークを手に入れて初めて、あなたのアルゴリズムは設計通りのパフォーマンスを発揮することが可能になります。