Tick Data HTTP Exporter

Ниже приведены минимальные действия, необходимые для начала экспорта данных о тиках советником (EA) на ваш настроенный URL:

• Сделайте на своём сервере адрес, который принимает POST-запрос; его URL получается из targetExportUrlTemplate. Этот адрес должен:

  • Принимать данные о тиках с JSON-структурой, описанной ниже.
  • Отвечать кодом состояния 200 в случае успешного приема.

• Разрешите терминалу отправлять данные на ваш сервер: откройте Сервис > Настройки > Советники, поставьте галочку "Разрешить WebRequest для следующих URL" и добавьте адрес вашего сервера, например https://data.example.com.

  • Если вы тестируете локально на localhost, создайте имя хоста в 'C:\Windows\System32\drivers\etc\hosts' на Windows или '/etc/hosts' на системах на базе Linux. Используйте это имя хоста в targetExportUrlTemplate.

• Прикрепите EA к любому графику в терминале и настройте следующие входные параметры:

  • dataProvider и targetExportUrlTemplate: обязательны, без них советник не запустится.
  • startExportFromTimestampMillis: укажите временную метку, с которой вам нужно получать данные о тиках.
  • symbols: настройте символы, для которых вам нужны данные о тиках.
  • shouldReExportHistoricalTicks: этот параметр должен быть установлен в true при первом запуске, чтобы EA создал все необходимые файлы для отслеживания временной метки последнего отправленного тика. После первого запуска верните false, иначе каждый перезапуск будет отправлять всё заново с startExportFromTimestampMillis.

Примечание: в тестере стратегий советник не работает, потому что тестер не даёт отправлять данные через интернет.

Управление смещением

EA хранит временную метку (смещение) последнего успешно отправленного тика, чтобы продолжить процесс экспорта в случае сбоев или перезапуска терминала. По умолчанию временные метки хранятся в файлах, которые автоматически создаются в папке MQL5\Files терминала. Для каждого символа создается отдельный файл.

Кроме того, есть возможность использовать отдельные адреса на вашем сервере для чтения/хранения смещения вместо файлов.
Чтобы использовать эту функцию, установите lastSentTickTimestampSource в 'HTTP_ENDPOINT' и сделайте на своём сервере адреса на основе URL, определенного в lastSentTickTimestampUrlTemplate.
В качестве решения на сервере вы можете выбрать хранение смещений в базе данных (например, PostgreSQL). Если вам нужно повторно экспортировать данные о тиках для определенного символа, вам нужно будет только обновить значение временной метки в таблице базы данных.

Что такое смещение. Смещение — время последнего доставленного тика в миллисекундах с 1970-01-01 по часам сервера брокера (то время, которое показывает терминал), а не UTC. Если вы храните смещения на своём сервере, возвращайте ровно то число, которое прислал советник.

Управление экспортируемыми символами

По умолчанию EA использует входной параметр symbols, чтобы определить, данные о тиках каких символов необходимо экспортировать.
Однако также есть опция получения списка символов с вашего сервера по HTTP.
Чтобы использовать эту функцию, установите exportedSymbolsSource в 'HTTP_ENDPOINT' и сделайте на своём сервере адрес по URL, определенному в exportedSymbolsFetchUrlTemplate.

Внешнее управление EA

Спецификация REST API для интеграции приложения

[
    {
        "symbol": "EURUSD",
        "bid": 1.18000,
        "ask": 1.18020,
        "last": 1.18010,
        "volume": 1234.56,
        "timestampMillis": 1625135912000
    },
    ...
]