Candle Data HTTP Exporter NZDUSD

A continuación se indican las acciones mínimas necesarias para que el EA comience a exportar cotizaciones a la URL configurada:

• Implementa un punto final HTTP que gestione una solicitud POST en una URL derivada de «targetExportUrlTemplate». Este punto final debe:

  • Aceptar datos de tipos de cambio con la estructura JSON que se describe a continuación.
  • Responder con un código de estado 200 si la recepción se realiza correctamente.

• Permitir que la terminal envíe datos a tu servidor: abre Herramientas > Opciones > Asesores expertos, marca la casilla «Permitir WebRequest para la URL indicada» y añade la dirección de tu servidor, p. ej., https://data.example.com.

  • Si está realizando pruebas localmente en localhost, cree un nombre de host en «C:\Windows\System32\drivers\etc\hosts» en Windows o en «/etc/hosts» en sistemas basados en Linux. Utilice este nombre de host en targetExportUrlTemplate.

• Asigna el EA a cualquier gráfico de la terminal y configura los siguientes parámetros:

  • dataProvider y targetExportUrlTemplate: obligatorios; el EA no se inicia sin ellos.
  • startExportFromTimestampMillis: establece la marca de tiempo a partir de la cual necesitas obtener los tipos de cambio.
  • timeframes: los marcos temporales para los que necesitas cotizaciones (esta versión siempre exporta NZDUSD).
  • shouldReExportHistoricalRates: debe establecerse en «true» en la primera ejecución para que el EA cree todos los archivos necesarios para realizar un seguimiento de la última marca de tiempo de cotización enviada. Tras la primera ejecución, vuelve a establecerlo en «false»; de lo contrario, cada reinicio enviará todo de nuevo a partir de startExportFromTimestampMillis.

Nota: el EA no funciona en el Strategy Tester, ya que este bloquea el envío de datos a través de Internet.

Gestión del desfase

El EA mantiene la marca de tiempo (offset) de la última cotización enviada con éxito para continuar el proceso de exportación en caso de interrupciones o de un reinicio de la terminal.
Por defecto, las marcas de tiempo se almacenan en archivos que se crean automáticamente en la carpeta MQL5\Files de la terminal. Hay un archivo independiente para cada símbolo y marco temporal.

Además, existe la opción de utilizar puntos finales HTTP independientes para leer o almacenar el offset en lugar de archivos.
Para utilizar esta función, establezca lastSentRateTimestampSource en «HTTP_ENDPOINT» e implemente puntos finales HTTP basados en la URL definida en lastSentRateTimestampUrlTemplate.
Como solución de backend, puede optar por almacenar los offsets en una base de datos (como PostgreSQL). Si necesita volver a exportar las cotizaciones de un símbolo específico, solo tendría que actualizar los valores de marca de tiempo en la tabla de la base de datos.

¿Qué es el desfase? El desfase es la hora de apertura de la última vela entregada, en milisegundos desde el 1 de enero de 1970 según el reloj del servidor del bróker (la hora que muestra la terminal), no según UTC. Si almacenas los desfases en tu servidor, devuelve exactamente el número que ha publicado el EA.

Gestión de símbolos exportados

No disponible en esta versión: siempre exporta NZDUSD.
Por defecto, el EA utiliza los símbolos de entrada para determinar para qué símbolos se deben exportar las cotizaciones.
Sin embargo, también existe la opción de recuperar la lista de símbolos desde un punto final HTTP independiente.
Para utilizar esta función, configura exportedSymbolsSource en «HTTP_ENDPOINT» e implementa un punto final utilizando la URL definida en exportedSymbolsFetchUrlTemplate.

Gestión externa del EA

Especificación de la API REST para la integración de aplicaciones

[
  {
    "symbol": "NZDUSD",
    "timeframe": "H1",
    "timestampMillis": 1670001234000,
    "open": 0.61234,
    "high": 0.61350,
    "low": 0.61180,
    "close": 0.61300,
    "tickVolume": 1234,
    "spread": 12,
    "realVolume": 0
  },
  ...
]