MT5 Manager API, Web API o Server API: ¿cuál necesita su bróker?

¿Qué es la Manager API de MT5?

La Manager API de MT5 es la interfaz que ofrece MetaQuotes para escribir su propio software de administración y gestión para un servidor MetaTrader 5. Todo lo que un empleado de back office hace en el terminal MT5 Manager —abrir cuentas, moverlas entre grupos, registrar depósitos, vigilar posiciones, atender solicitudes del dealer— puede hacerse, en principio, desde un programa construido sobre ella.

Se entrega a los titulares de licencia como parte de los paquetes para desarrolladores de MetaQuotes, no como descarga pública, y la documentación está en el sitio de soporte de MetaQuotes, con acceso restringido. En los paquetes con los que hemos trabajado es una biblioteca nativa para Windows con cabeceras para C++ y wrappers para .NET; revise el paquete actual para la build de su servidor, porque los detalles cambian.

¿Cómo se comparan la Manager API, la Web API y la Server API?

La forma más rápida de distinguirlas es preguntar dónde se ejecuta el código y qué pasa si falla. Los programas basados en la Manager API y en la Web API se ejecutan fuera del servidor y se conectan a él; un plugin de la Server API se ejecuta dentro, en cada evento relevante.

¿Dónde encajan la Gateway API y la Report API?

Completan el conjunto, pero responden a preguntas distintas. La Gateway API conecta MT5 con otros sistemas de trading y fuentes de datos, que es como se conectan los proveedores de liquidez y los mercados organizados; la tratamos en la guía sobre la Gateway API de MT5. La Report API amplía los informes que genera el servidor de trading, algo importante para los informes regulatorios y de gestión.

Ninguna sustituye a la Manager API ni a la Web API. Un CRM que necesita abrir cuentas nunca usará la Gateway API, y una conexión de liquidez nunca se construirá sobre la Web API.

¿Qué automatizan los brókeres con la Manager API?

Los brókeres usan la Manager API sobre todo para tareas que, de otro modo, su personal haría a mano en el terminal Manager, a gran escala o a cualquier hora. Ejemplos habituales de proyectos que hemos visto:

• Administración de cuentas: crear cuentas en bloque, mover clientes entre grupos, cambiar el apalancamiento tras una evaluación de conveniencia.
• Operaciones de saldo: registrar depósitos, retiradas, créditos y correcciones a partir de una cola de pagos aprobados.
• Herramientas de dealing y riesgo: pantallas a medida de exposición neta por símbolo, alertas de posiciones grandes y rentabilidad por cliente.
• Informes para introducing brokers: extraer las operaciones al final de cada día para calcular comisiones.
• Controles de cumplimiento: marcar cuentas que operan fuera de los patrones esperados o mantienen posiciones durante el fin de semana.
• Mantenimiento: archivar cuentas inactivas, limpiar grupos de prueba, comparar la configuración de los símbolos con una lista maestra.

Ejemplo práctico: de la aprobación del KYC a la primera operación

Supongamos que un bróker aprueba a un cliente nuevo en su CRM un martes a las 10:00. Así se reparte el trabajo entre interfaces en una integración típica; en un CRM web, como el nuestro, las llamadas de nivel manager suelen pasar por la Web API.

1. KYC aprobadoEl responsable de cumplimiento aprueba los documentos en el CRM. El CRM comprueba el país del cliente y le asigna el grupo de MT5 que corresponde.
2. Cuenta creadaEl CRM llama al servidor como manager para crear la cuenta con nombre, grupo, apalancamiento y una contraseña generada, y después muestra el login en el área de cliente.
3. Depósito acreditadoEl proveedor de pagos confirma un depósito con tarjeta. Tras los controles propios del CRM, se registra una operación de saldo en la cuenta con la referencia del pago en el comentario.
4. El cliente operaEl cliente entra en el WebTrader o en la aplicación y abre una posición. Si el bróker tiene un plugin de la Server API, en este punto puede aplicar reglas propias.
5. InformesDurante la noche, un proceso de informes lee las operaciones del día para las comisiones de los IB y para el panel del equipo de riesgos.

¿Cuándo conviene más la Web API que la Manager API?

La Web API suele ser la mejor opción cuando quien la consume es un servicio web que funciona en Linux, en la nube o en un lenguaje distinto de C++ o .NET. Trabaja con HTTPS y JSON, así que un CRM escrito en PHP, Node.js, Go o Python puede usarla sin biblioteca nativa. Por eso la mayoría de los CRM y portales, incluido el nuestro, se construyen sobre ella.

La Manager API se gana su sitio cuando usted está creando una herramienta de escritorio para dealers, necesita todas las funciones de manager en una aplicación nativa o quiere reaccionar a los eventos del servidor sin hacer consultas periódicas. Un monitor de riesgo que debe mostrar la exposición en tiempo real es el caso típico. Nuestra guía sobre la Web API de MetaTrader 5 explica con más detalle los límites de la Web API.

¿Qué es un plugin de la Server API de MT5 y cuándo lo necesita?

Un plugin de la Server API es código que se ejecuta dentro del servidor de trading o de historial de MetaTrader 5 y al que se llama a medida que ocurren los eventos: una solicitud de operación, una transacción, un cambio en una cuenta. Lo necesita cuando una regla debe aplicarse en cada operación, antes de que el resultado sea definitivo, y no puede esperar a que un programa externo se dé cuenta.

Algunos ejemplos son controles de margen o de exposición a medida, reglas de bonos que dependen del volumen operado, lógica de copy trading que debe reaccionar al instante o datos adicionales que se escriben en las operaciones para los informes. Esa potencia es también el riesgo: un plugin lento o defectuoso ralentiza o detiene el servidor para todos. Recomendamos a los clientes mantener los plugins pequeños, probarlos en un servidor aparte con una carga realista y dejar fuera del servidor todo lo que pueda ejecutarse fuera.

¿Qué API de MT5 debe usar para cada tarea del bróker?

Elija la interfaz según la tarea, no según la que ya conozca su desarrollador. La tabla refleja cómo construiríamos hoy cada elemento.

¿Quién puede obtener acceso a la Manager API de MT5?

El acceso lo da el propietario del servidor MT5, porque cada cuenta de manager se crea en ese servidor. Con su propia licencia MT5, usted decide quién recibe cada manager y qué paquetes para desarrolladores utiliza. En un white label decide el titular de la licencia, y el manager que usted recibe suele estar limitado a sus grupos. En un grey label de MT5, por lo general trabaja a través del CRM y las interfaces del proveedor, sin credenciales de manager directas.

Es una de las cuestiones que conviene resolver antes de firmar. Si sus planes incluyen una herramienta de dealing a medida o un CRM propio, pida a su proveedor por escrito qué nivel de acceso a la API tendrá y en qué condiciones. FXUP es independiente y no está vinculada a MetaQuotes; para preguntas de licencia sobre los propios paquetes de API, el interlocutor adecuado es MetaQuotes o su proveedor de servidor. Si está solicitando su propia licencia MT5, nos encargamos de los requisitos de MetaQuotes y de la solicitud como servicio de consultoría, con honorarios.

¿No sabe qué pedir? Envíenos un mensaje por WhatsApp describiendo su configuración y le propondremos la redacción.

¿Y los servicios de “API de MT5” de terceros?

Muchos productos que se venden como “API de MT5” no son en absoluto las API para brókeres de MetaQuotes. Algunos se conectan a cuentas de trading individuales ejecutando terminales en la nube del proveedor; otros envuelven el paquete de Python de MetaQuotes, que se comunica con un terminal de escritorio en el mismo equipo. Sirven para traders, servicios de señales y analítica, y funcionan con las cuentas de cualquier bróker.

Otros son wrappers alojados sobre la Manager API o la Web API, que ofrecen una interfaz REST por encima de una conexión de manager. Pueden ahorrar tiempo de desarrollo, pero sus credenciales de manager quedan en manos de un tercero y usted depende de su disponibilidad y de su ciclo de actualizaciones cuando MetaQuotes publica una build nueva. Pregunte dónde está alojado el servicio, quién puede ver las credenciales y qué ocurre con su integración si el proveedor cierra.

¿Cómo se mantiene segura una integración con nivel de manager?

Trate cada cuenta de manager que use un software como una cuenta de sistema con privilegios, porque eso es lo que es. Estas son las reglas que aplicamos en nuestras propias integraciones:

• Un manager por integración, solo con los derechos y los grupos que esa integración necesita.
• Operaciones de saldo únicamente desde una cola aprobada, nunca directamente desde una solicitud del cliente.
• Credenciales en un gestor de secretos, renovadas cuando cambian empleados o proveedores.
• Conexión permitida solo desde servidores conocidos.
• Cada escritura registrada con su motivo de negocio y conciliada a diario.
• Nada de reintentos automáticos de movimientos de dinero u operaciones tras un timeout; compruebe primero el estado del servidor.

¿Cuáles son los errores habituales en los proyectos con la Manager API de MT5?

Los errores habituales son de arquitectura, y la mayoría se cometen en la primera semana. Evitarlos cuesta poco; corregirlos cuando los clientes ya dependen del sistema cuesta mucho.

• Un solo manager para todo. El CRM, el proceso de informes y la herramienta del dealer comparten un login con todos los derechos, así que nadie sabe qué sistema hizo un cambio y no se puede revocar ninguno por separado.
• Consultas cuenta por cuenta. Un portal que pide las posiciones de cada cliente una tras otra funciona con 50 cuentas y ralentiza el servidor con 5.000. Use peticiones por lotes y guarde en caché lo que no cambia.
• Lógica de negocio en un plugin. Una regla de copy trading o de bonos escrita como plugin de la Server API porque parecía “más cerca del servidor”, cuando podía ejecutarse fuera sin riesgo.
• Ignorar la hora del servidor. Operaciones guardadas en el CRM con la hora del servidor y comparadas con registros de pagos en UTC, de modo que las conciliaciones diarias se desfasan dos o tres horas.
• Reintentar movimientos de dinero. Una llamada de depósito supera el tiempo de espera, el código lo vuelve a intentar y el cliente recibe el abono dos veces. Revise el historial de la cuenta antes de cualquier reintento.
• Sin plan para las actualizaciones de MT5. MetaQuotes publica builds nuevas con regularidad. Mantenga un servidor de pruebas con la siguiente build y pruebe allí su integración antes de que se actualice el servidor real.

¿Cambia la elección en un proyecto de prop firm o de copy trading?

Sí, un poco. La tecnología para prop trading depende mucho de acciones rápidas y basadas en reglas sobre las cuentas: por ejemplo, cerrar una cuenta de evaluación en el momento en que se supera un límite de drawdown. Algunas firmas lo hacen desde fuera, mediante la Web API o la Manager API con comprobaciones frecuentes; otras prefieren un plugin para que la regla se aplique dentro del servidor. Se trata de elegir entre tiempo de reacción y el riesgo de ejecutar código propio en el servidor.

El copy trading y el PAMM están en una situación parecida. La copia en sí puede ejecutarse fuera del servidor, pero el reparto del volumen y de las comisiones tiene que ser exacto, así que la interfaz que elija debe darle datos fiables de las operaciones y una forma de conciliarlos. La liquidez es otro asunto: si el proyecto también necesita proveedores nuevos, consulte la integración de proveedores de liquidez.

¿Cómo trabaja FXUP con las API de MT5?

Nuestro WebTrader con su marca, las aplicaciones móviles y nuestro propio CRM para brókeres se conectan a MT5 a través de un back end en Go que usa la Web API. También trabajamos con CRM de socios y proponemos el que mejor encaje con el proyecto; en ambos casos comprobamos qué interfaz y qué derechos de manager necesita el CRM antes de que nada entre en funcionamiento. Para clientes con servidor propio también definimos herramientas de dealing, procesos de informes y algún plugin ocasional, y le diremos cuándo una función que ya existe en MT5 o una interfaz más sencilla haría el trabajo.

Si está comparando presupuestos para un proyecto de API, envíenos la especificación por WhatsApp; le diremos qué interfaz necesita cada elemento y dónde está el trabajo oculto. Nuestra página de integraciones a medida enumera el tipo de proyectos que asumimos.

Preguntas frecuentes

¿No encuentra su pregunta? Escríbanos por WhatsApp, escriba a @FXUPCK en Telegram o envíe un correo a [email protected].