Plantillas de n8n y Postman para la API de MT5

No todo lo que habla con MetaTrader 5 necesita un programa. fxapis-integrations reúne las formas de entrar con poco código: una colección de Postman para explorar la API, y flujos de n8n para las automatizaciones que prefieres armar en un lienzo, además de mensajes de alertas de TradingView, que tienen su propio artículo.

Postman: prueba cada endpoint a mano

postman/fxapis.postman_collection.json es una colección de Postman que cubre cada endpoint público (conectar cuentas, ponerlas en línea, órdenes de mercado y pendientes, posiciones, historial y órdenes multicuenta) con un cuerpo de ejemplo listo para enviar en cada solicitud que lo lleva. Se genera a partir de la especificación de la API en vivo, con una carpeta por sección de la API.

1. En Postman, elige Import y selecciona el archivo.
2. Abre las Variables de la colección y pon tu clave en apiKey. Completa accountId y los otros ids a medida que avanzas.
3. Envía Connect an MT5 account con un login demo, luego Bring an account online, y luego consulta su estado.

El script previo a cada solicitud de la colección le da a cada POST y PATCH un Idempotency-Key nuevo, así que hacer clic dos veces en Send en una orden no puede abrir dos posiciones. Si la API cambia, node postman/generate.mjs regenera la colección a partir de la especificación en vivo.

Alertas de TradingView

El repositorio también tiene mensajes de alerta de TradingView listos para pegar, para indicadores, estrategias y texto simple. Funcionan con un hook de TradingView de la consola, sin nada de código; TradingView a MT5: puente EA vs API alojada muestra el formato del mensaje y qué revisar, y la guía de TradingView tiene la referencia completa de los campos.

n8n: automatizaciones en un lienzo

fxapis todavía no tiene un nodo oficial de n8n, así que las dos plantillas de n8n/ usan el nodo HTTP Request integrado de n8n:

• Webhook de TradingView a orden de mercado: recibe un cuerpo con forma de alerta, coloca una orden de mercado y responde con el resultado.
• Cerrar todo según un horario: cada día hábil a las 21:00 UTC, lista las posiciones de una cuenta y cierra cada una.

Importa cualquiera de los dos archivos desde Workflows → Import from File. La API key se toma de una variable de entorno ($env.FXAPIS_API_KEY), así que nunca vive dentro del JSON del flujo; las notas de n8n cubren las instancias donde el acceso al entorno está desactivado.

Las reglas que sigue cada plantilla

• Una clave de idempotencia en cada orden: el script de Postman y las plantillas de n8n envían Idempotency-Key.
• Los volúmenes y los precios son strings, y los stops y objetivos son precios absolutos, no pips.
• La URL del hook y la API key son credenciales. Mantenlas fuera de todo lo que subas a un repositorio, captures en pantalla o compartas.
• Primero cuentas demo. fx_test_ es una etiqueta, no un sandbox.

Adónde ir después

• Alertas de TradingView a MT5 en el sitio (en inglés), y la guía de TradingView en la documentación.
• La referencia de la API: las mismas solicitudes que la colección de Postman, con ejemplos en 13 lenguajes (en inglés).
• Ejemplos ejecutables cuando estés listo para escribir código.