Candle Data HTTP Exporter

EA が設定済みの URL へローソク足のエクスポートを開始するために、最低限必要な手順は次のとおりです：

• お使いのサーバー上に、POST リクエストを受け付けるアドレス（URL は targetExportUrlTemplate から生成）を用意します。このアドレスの要件は次のとおりです：

  • 下記の JSON 構造のレートデータを受け付けること。
  • 受信に成功したらステータスコード 200 を返すこと。

• ターミナルがお使いのサーバーへデータを送信できるようにします：「ツール > オプション > エキスパートアドバイザー」（Tools > Options > Expert Advisors）を開き、"Allow WebRequest for listed URL" にチェックを入れ、サーバーのアドレス（例：https://data.example.com）を追加します。

  • localhost でローカルにテストする場合は、Windows では 'C:\Windows\System32\drivers\etc\hosts'、Linux 系のシステムでは '/etc/hosts' にホスト名を作成し、そのホスト名を targetExportUrlTemplate で使用してください。

• ターミナルで任意のチャートに EA を適用し、次の入力パラメータを設定します：

  • dataProvider と targetExportUrlTemplate：必須です（これらがないと EA は起動しません）。
  • startExportFromTimestampMillis：ローソク足を取得したい開始タイムスタンプを設定します。
  • symbols と timeframes：ローソク足が必要な銘柄と時間足。
  • shouldReExportHistoricalRates：初回の実行時は、最後に送信したローソク足のタイムスタンプを記録するファイルを EA がすべて作成できるよう、true に設定する必要があります。初回の実行後は false に戻してください（戻さないと、再起動のたびに startExportFromTimestampMillis からすべてを送信し直します）。

注意：ストラテジーテスターはインターネット経由のデータ送信をブロックするため、EA はテスターでは動作しません。

オフセットの管理

EA は、中断やターミナルの再起動後にエクスポートを続行できるよう、最後に送信に成功したローソク足のタイムスタンプ（オフセット）を保持します。
デフォルトでは、タイムスタンプはターミナルの MQL5\Files フォルダーに自動作成されるファイルに保存されます。ファイルは銘柄と時間足ごとに 1 つずつ作られます。

ファイルの代わりに、お使いのサーバー上の個別のアドレスでオフセットを読み書きすることもできます。
この機能を使うには、lastSentRateTimestampSource を 'HTTP_ENDPOINT' に設定し、lastSentRateTimestampUrlTemplate で定義した URL に従ってサーバー上にアドレスを用意します。
サーバー側では、オフセットをデータベース（PostgreSQL など）に保存できます。特定の銘柄のローソク足を再エクスポートしたい場合は、データベースのテーブルにあるタイムスタンプの値を更新するだけで済みます。

オフセットとは。オフセットは最後に配信したローソク足の始値の時刻で、ブローカーのサーバー時刻（ターミナルに表示される時刻）での 1970-01-01 からのミリ秒数です（UTC ではありません）。オフセットをサーバーで保持する場合は、EA が送信した数値をそのまま返してください。

エクスポートする銘柄の管理

デフォルトでは、EA は入力パラメータ symbols を使って、ローソク足をエクスポートする銘柄を決定します。
お使いのサーバー上の個別のアドレスから銘柄リストを取得することもできます。
この機能を使うには、exportedSymbolsSource を 'HTTP_ENDPOINT' に設定し、exportedSymbolsFetchUrlTemplate で定義した URL に従ってサーバー上にアドレスを用意します。

EA の外部からの管理

アプリケーション連携用 REST API 仕様

[
  {
    "symbol": "EURUSD",
    "timeframe": "H1",
    "timestampMillis": 1670001234000,
    "open": 1.12345,
    "high": 1.12500,
    "low": 1.12200,
    "close": 1.12400,
    "tickVolume": 1234,
    "spread": 12,
    "realVolume": 0
  },
  ...
]