Candle Data HTTP Exporter

要让 EA 开始向您配置的 URL 导出K线，至少需要完成以下步骤：

• 在您的服务器上设置一个接收 POST 请求的地址，其 URL 由 targetExportUrlTemplate 生成。该地址应：

  • 接收符合下文所述 JSON 结构的K线数据。
  • 接收成功时返回状态码 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：设置需要获取K线的起始时间戳。
  • symbols 和 timeframes：需要获取K线的交易品种和时间周期。
  • shouldReExportHistoricalRates：首次运行时必须设为 true，以便 EA 创建记录最后发送的K线时间戳所需的全部文件。首次运行后请将其改回 false，否则每次重启都会从 startExportFromTimestampMillis 重新发送全部数据。

注意：EA 无法在策略测试器中工作，因为测试器禁止通过互联网发送数据。

偏移量管理

EA 会保存最后一根成功发送的K线的时间戳（偏移量），以便在中断或终端重启后继续导出。
默认情况下，时间戳保存在终端 MQL5\Files 文件夹中自动创建的文件里。每个交易品种和时间周期各对应一个单独的文件。

此外，也可以使用您服务器上的单独地址代替文件来读取/保存偏移量。
要使用此功能，请将 lastSentRateTimestampSource 设为 'HTTP_ENDPOINT'，并在您的服务器上按照 lastSentRateTimestampUrlTemplate 中定义的 URL 设置相应的地址。
在服务器端，您可以将偏移量存储在数据库中（例如 PostgreSQL）。如果需要重新导出某个交易品种的K线，只需更新数据库表中的时间戳值即可。

偏移量是什么。偏移量是最后一根已送达K线的开盘时间，为按经纪商服务器时钟（即终端显示的时间）计算的自 1970-01-01 起的毫秒数，不是 UTC。如果您在服务器上保存偏移量，请原样返回 EA 发送的数值。

导出品种管理

默认情况下，EA 根据输入参数 symbols 确定需要导出哪些交易品种的K线。
此外，也可以从您服务器上的单独地址获取交易品种列表。
要使用此功能，请将 exportedSymbolsSource 设为 'HTTP_ENDPOINT'，并在您的服务器上按照 exportedSymbolsFetchUrlTemplate 中定义的 URL 设置地址。

EA 外部管理

应用程序集成 REST API 规范

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