La MetaTrader 5 Web API es la interfaz de servidor de MetaQuotes para conectar un servidor de trading MT5 con sitios web, CRM y otros sistemas de la empresa. Una aplicación inicia sesión con una cuenta de manager y puede gestionar usuarios, saldos, grupos, símbolos, órdenes, posiciones, operaciones cerradas, ticks y gráficos. No conecta proveedores de liquidez ni transmite el libro de órdenes de un LP; esas tareas corresponden a otras API de MT5.
¿Qué es la MetaTrader 5 Web API?
La MetaTrader 5 Web API es la interfaz que ofrece MetaQuotes para conectar un servidor de trading MT5 con los servicios web propios del bróker: el área de cliente, el CRM, el procesamiento de pagos, los informes y los front ends de trading a medida. Trabaja contra el servidor, no contra el terminal de un trader, y se autentica como manager, el mismo tipo de cuenta que usa su personal de back office en el terminal MT5 Manager.
La definición de una línea que da la propia MetaQuotes es breve y precisa: la Web API sirve para la integración con recursos web y otros servicios de la empresa. Todo lo demás en esta página trata de lo que eso significa en la práctica. La referencia técnica completa está en el sitio de soporte de MetaQuotes, al que acceden los titulares de licencia tras iniciar sesión; si usted tiene una licencia de servidor MT5, o trabaja para quien la tiene, esa referencia prevalece sobre cualquier cosa escrita aquí.
“La Web API se utiliza para integrar la plataforma con recursos web y otros servicios de la empresa.”
¿En qué se diferencia la Web API de las demás API de MetaTrader 5?
MetaQuotes publica cinco API para MT5 y cada una tiene una función distinta. La Web API es la que se comunica con el servidor desde fuera, a través de la red; las demás funcionan dentro del servidor, lo conectan con los mercados o amplían sus informes. Las definiciones de la segunda columna están citadas de la página de MetaQuotes para brókeres.
| API | Definición de MetaQuotes | Dónde se ejecuta su código | Uso típico en un bróker |
|---|---|---|---|
| Web API | “se utiliza para integrar la plataforma con recursos web y otros servicios de la empresa” | En su propio servidor, conectado a través de la red | CRM, área de cliente, pagos, WebTrader a medida |
| Manager API | “permite desarrollar utilidades personalizadas de administración y gestión, o incluso su propio terminal de manager” | En una aplicación de manager que se conecta al servidor | Herramientas de back office, utilidades de dealing y riesgo |
| Server API | “puede ayudarle a añadir más funciones a MetaTrader 5 Trade Server y MetaTrader 5 History Server” | Dentro del servidor MT5, como plugin | Reglas personalizadas en cada operación, bonos, lógica de copia |
| Gateway API | “se utiliza para integrar MetaTrader 5 con otros sistemas de trading y crear flujos de datos personalizados” | En un gateway conectado a la plataforma | Proveedores de liquidez, bolsas, flujos de datos |
| Report API | “amplía los informes que generan los servidores de trading de MetaTrader 5” | Dentro del componente de informes | Informes regulatorios y de gestión a medida |
¿La MT5 Web API es REST o WebSocket?
La MT5 Web API funciona por solicitud y respuesta: su aplicación envía un comando y espera la respuesta. En las versiones actuales eso significa solicitudes HTTPS a rutas como /api/user/get o /api/tick/last con respuestas en JSON, junto a un protocolo binario más antiguo sobre un socket persistente, que es el que usa el código de ejemplo de la propia MetaQuotes. Nosotros usamos ambos, para tareas distintas.
Lo que no es, en cambio, es una API WebSocket. Nada en la Web API le envía por iniciativa propia un precio o un cambio de posición; si quiere actualizaciones en directo, las solicita con la frecuencia que usted elija. Cuando lea que la “MT5 Web API de un proveedor está basada en WebSocket”, lo que suele querer decir es que ha construido una capa WebSocket por encima, que es exactamente lo que hicimos nosotros para nuestro WebTrader con su marca.
Conviene aclarar pronto una segunda confusión. Varios servicios venden una “MT5 API” que se conecta a la cuenta de un trader a través de un terminal que funciona en su nube, o mediante el paquete de Python de MetaQuotes para el terminal de escritorio. Son herramientas a nivel de cuenta, pensadas para traders y servicios de señales. La Web API trabaja a nivel de bróker: ve todas las cuentas del servidor que el manager tiene permiso para ver.
¿Cómo funciona la autenticación en la MT5 Web API?
Su aplicación se autentica como manager de MT5 mediante un intercambio de desafío y respuesta, de modo que la contraseña del manager nunca viaja en texto claro. En la variante HTTPS que usamos, requiere dos llamadas:
- InicioLa aplicación llama al comando de inicio de autenticación con su login de manager y se identifica como agente de la Web API. El servidor responde con un desafío aleatorio.
- RespuestaLa aplicación combina el hash de la contraseña con ese desafío, envía el resultado y añade un desafío aleatorio propio.
- Verificación del servidorEl servidor responde al desafío del cliente; la aplicación comprueba esa respuesta, de modo que ambas partes han demostrado que conocen la contraseña.
- Mantenimiento de la sesiónLa sesión autenticada queda ligada a la conexión subyacente. Si se cae la conexión, hay que volver a autenticarse.
¿Qué se puede construir con la MetaTrader 5 Web API?
Casi todos los sistemas de cara al cliente que necesita un bróker pueden construirse sobre la Web API, porque llega a los objetos que importan a esos sistemas: usuarios, cuentas, grupos, símbolos, órdenes, posiciones, operaciones cerradas e historial de precios. La tabla relaciona las áreas de comandos que usamos con las tareas a las que sirven.
| Área | Qué abarca | Uso típico |
|---|---|---|
| Usuarios y cuentas | Crear, actualizar, eliminar y leer cuentas; comprobar o cambiar contraseñas; leer saldo, equity y margen | Apertura de cuenta tras el KYC en el CRM, restablecimiento de contraseñas, paneles del área de cliente |
| Operaciones de saldo | Depósitos, retiradas, crédito y ajustes en una cuenta | Abonar automáticamente un depósito con tarjeta o transferencia |
| Grupos y símbolos | Leer y mantener la configuración de grupos y símbolos | Mostrar en un front end las especificaciones de contrato, el margen y las sesiones correctos |
| Órdenes, posiciones, operaciones e historial | Datos de trading abiertos e históricos, con consultas por lotes para muchas cuentas | Historial de operaciones, extractos, cálculo de comisiones de IB |
| Precios y gráficos | Últimos ticks, estadísticas de ticks, historial de ticks y barras de gráfico | Cotizaciones y gráficos en un WebTrader o una aplicación móvil |
| Solicitudes de trading | Solicitudes ejecutadas en el servidor en nombre de una cuenta, con un código de resultado | Abrir, modificar y cerrar órdenes desde un front end a medida |
| Correo y noticias | Correo interno y noticias a los terminales | Mensajes de servicio a los clientes |
¿Qué no puede hacer la MT5 Web API?
La Web API no puede conectar su servidor con la liquidez, no puede ejecutar código dentro del servidor y no puede enviarle datos por iniciativa propia. Son límites deliberados: para cada una de esas tareas existen otras API de MetaTrader 5.
- Sin conexión con la liquidez. Los precios de bancos o de proveedores prime-of-prime llegan a través de un gateway, de un bridge de liquidez o de Ultency; consulte las páginas sobre la MT5 Gateway API y la integración de liquidez.
- Sin libro de órdenes del LP ni profundidad de mercado. La Web API le da los últimos ticks y estadísticas por símbolo. No transmite el libro agregado de sus proveedores, así que un front end basado en la Web API muestra compra y venta, no una escalera de profundidad de mercado.
- Sin lógica dentro del servidor. Las reglas que deben ejecutarse en cada operación, antes de que se ejecute, necesitan un plugin de la Server API. Una aplicación de la Web API solo ve lo que ya ha sucedido.
- Sin push. Cada actualización es una solicitud; tener cotizaciones y posiciones en directo implica consultar al servidor con la frecuencia que usted elija y que el servidor pueda soportar.
- Sin informes de servidor personalizados. Ampliar los informes que genera el propio servidor de trading es tarea de la Report API.
¿Cómo usa FXUP la MT5 Web API para su WebTrader?
Nuestro WebTrader y nuestras aplicaciones móviles nunca hablan directamente con MT5. Se conectan mediante WebSocket seguro a un back end escrito en Go, y ese back end se comunica con el servidor MT5 a través de la Web API, usando tanto el protocolo binario como solicitudes HTTPS. El cliente recibe actualizaciones de tipo push; el servidor MT5 ve un número pequeño y previsible de sesiones de manager.
Puede probar el resultado en la demo del WebTrader y en la demo de la aplicación móvil, ambas conectadas a un entorno demo real de MT5. FXUP es una desarrolladora independiente y no está vinculada a MetaQuotes; construimos sobre las interfaces publicadas como cualquier otro integrador. Nuestro propio CRM usa el mismo back end, y también trabajamos con CRM de socios, proponiendo el que mejor encaje con la configuración del bróker.
Consulta por lotes
Un único bucle pide a MT5 ticks, posiciones, órdenes y datos de cuenta cada 100 milisegundos mediante consultas por lotes, de modo que la carga del servidor no crece con el número de usuarios conectados.
Push por cliente
Cada cliente conectado recibe solo los símbolos y las cuentas a los que se ha suscrito, y no se reenvían las secciones que no han cambiado. Las tramas grandes se comprimen.
Caché del historial
El historial de gráficos se guarda en caché en disco y se carga bajo demanda, para que un trader que retrocede por años de velas H1 no consulte al servidor MT5 cada vez.
Seguridad en las operaciones
Una orden idéntica que todavía se está ejecutando se descarta como duplicada, y ni el servidor ni las aplicaciones reenvían automáticamente una operación tras un tiempo de espera agotado: una doble ejecución es peor que un reintento decidido por el trader.
¿Cómo se envían operaciones a través de la Web API?
Una operación a través de la Web API es una solicitud que se ejecuta en el servidor en nombre de la cuenta del cliente, seguida de un resultado. Su aplicación envía la solicitud, recibe un identificador y después lee el desenlace: un código de retorno como 10009 (realizada) o 10008 (orden colocada), o un rechazo, por ejemplo por stops no válidos, mercado cerrado o fondos insuficientes.
De ello se derivan dos consecuencias prácticas. Primera: los permisos del propio cliente siguen aplicándose; la configuración del grupo, los modos de trading de los símbolos, los niveles de stop y el margen los impone el servidor, no su front end, así que la última palabra la tiene el servidor. Segunda: un tiempo de espera agotado no significa que la orden haya fallado. Si la respuesta no llega, lo correcto es revisar las posiciones y el historial antes de hacer nada más. Nuestros front ends indican al trader que el resultado es incierto en lugar de enviar de nuevo la misma orden.
Las marcas de tiempo son otro detalle que sorprende a muchos equipos. MT5 registra las horas en la zona horaria configurada en el servidor de trading; todo lo que muestre a los clientes o guarde en un CRM debe convertirse a UTC real una sola vez, en un único punto.
¿Qué seguridad ofrece una integración con la MT5 Web API?
La propia Web API usa autenticación por desafío y respuesta y admite sesiones cifradas; la mayor parte del riesgo restante está en cómo trata el integrador la cuenta de manager. Un manager de la Web API a menudo puede mover dinero y modificar cuentas, así que trate sus credenciales como las llaves de una cuenta bancaria. MetaQuotes indica en su página para brókeres que el intercambio de datos entre los componentes del sistema se realiza mediante una conexión cifrada; sus propios sistemas necesitan la misma disciplina.
- Asigne a la integración su propia cuenta de manager, solo con los permisos y grupos que necesita; nunca reutilice el login de un dealer.
- Limite desde dónde puede conectarse ese manager y guarde las credenciales en un gestor de secretos, no en el código fuente.
- No exponga nunca la Web API a navegadores ni aplicaciones. Los clientes se conectan a su back end, que comprueba cada solicitud contra la cuenta del propio cliente.
- Limite la frecuencia de solicitudes y bloquee por dirección IP, de su lado, los intentos fallidos de inicio de sesión repetidos.
- Registre cada operación de saldo indicando quién la originó y por qué, y concilie esos registros con el CRM a diario.
¿Tiene límites de solicitudes la MT5 Web API?
MetaQuotes no publica límites de solicitudes en sus páginas públicas, y no vamos a dar cifras que no podamos respaldar. En la práctica, el límite es la capacidad de su servidor y el comportamiento de su integración, y una integración descuidada puede ralentizar un servidor de trading para todos.
Lo que nos funciona es mantener un conjunto de sesiones autenticadas, separar las solicitudes de trading de las consultas generales, usar comandos por lotes siempre que existan y guardar en caché todo lo que no cambia cada segundo, como la configuración de los símbolos y el historial cerrado. Del lado del cliente aplicamos un control general de mensajes por conexión, pero ningún límite a las operaciones: un cliente puede enviar órdenes una tras otra, porque en eso consiste operar.
Si está diseñando su propia integración, ponga por escrito su perfil de carga antes de entrar en funcionamiento: con qué frecuencia consulta cada tipo de dato, para cuántas cuentas y a través de cuántas sesiones. Esa única página responde a la mayoría de las preguntas que le hará un administrador del servidor.
¿Quién puede obtener acceso a la MT5 Web API?
El acceso a la Web API lo concede quien controla el servidor MT5, porque requiere una cuenta de manager en ese servidor. Lo que eso supone depende de su configuración. Para ver qué configuración de FXUP le da el acceso que necesita, con los precios y las condiciones vigentes en la misma pantalla, compare las opciones en el buscador de soluciones.
| Configuración | Quién controla el servidor | Qué suele poder obtener |
|---|---|---|
| Licencia MT5 propia | Su empresa | Acceso completo; usted mismo crea los managers y fija los permisos |
| White label de MT5 | El titular de la licencia | Un manager limitado a sus grupos, si el contrato lo permite |
| Grey label de MT5 | El proveedor | Depende del proveedor; con FXUP, una cuenta Manager dedicada que solo ve a sus usuarios, más acceso a la Manager API y al SDK tras el pago |
¿Qué debe incluir la lista de control de una integración con la MT5 Web API?
Antes de escribir código, cierre las cuestiones que luego resultan caras de cambiar. Esta es la lista que repasamos con los clientes que conectan un CRM para brókeres, un área de cliente o un front end; la misma lista de control se aplica a las demás integraciones a medida que desarrollamos:
- Qué build del servidor y qué variante de la Web API (HTTPS, binaria o ambas) va a usar.
- Una cuenta de manager dedicada, sus permisos y los grupos que puede ver.
- Qué eventos desencadenan la creación de cuentas, los cambios de saldo y los cambios de grupo, y quién los aprueba.
- La frecuencia de consulta por tipo de dato y los comandos por lotes que la cubren.
- El tratamiento de las zonas horarias y un único punto de conversión.
- Qué ocurre cuando se agota el tiempo de espera en cada operación, sobre todo en las operaciones de trading y los cambios de saldo.
- Monitorización: una alerta cuando se cae la conexión con MT5, no la queja de un cliente.
Preguntas frecuentes
¿Qué es la MetaTrader 5 Web API?
¿La MT5 Web API es REST?
¿Puedo construir mi propio WebTrader sobre la MT5 Web API?
¿Da acceso la Web API a la profundidad de mercado?
¿Qué diferencia hay entre la Web API y la Manager API?
¿Puede un bróker grey label obtener acceso a la API?
¿Tiene límites de solicitudes la MT5 Web API?
¿Es segura la MT5 Web API?
¿Cuánto se tarda en hacer una integración con la MT5 Web API?
¿Necesito permiso de MetaQuotes para usar la Web API?
¿No encuentra su pregunta? Abrir el buscador de soluciones y vea la configuración, los precios y las condiciones que se ajustan a su caso.
Fuentes
- MetaQuotes — MetaTrader 5 trading platform for brokers and banks (consultado en octubre de 2026)
- MetaQuotes — MetaTrader 5 for brokers (metaquotes.net) (consultado en octubre de 2026)
- MetaQuotes — Liquidity providers for MetaTrader 5 (consultado en octubre de 2026)
- MQL5 Reference — Python integration for the MetaTrader 5 terminal (consultado en octubre de 2026)
FXUP es una consultora y empresa tecnológica independiente y no está vinculada a MetaQuotes Ltd. MetaTrader 4 y MetaTrader 5 son marcas registradas de MetaQuotes Ltd. Esta página ofrece información general y no constituye asesoramiento jurídico, fiscal ni de inversión; los requisitos regulatorios dependen de cada jurisdicción y cambian con el tiempo. Los precios y las condiciones actuales de FXUP se muestran en el buscador de soluciones.