La API de MT5: opera MetaTrader 5 desde tu propio código.
MetaQuotes no publica una API REST para operar cuentas. Esta página explica qué es realmente una “API de MT5”, las cuatro formas de tener una, qué separa a una buena de una riesgosa, y cómo lo resuelve fxapis.
# 1. Conecta una cuenta (una sola vez). La contraseña se cifra al llegar.
curl -X POST https://api.fxapis.com/v1/accounts \
-H "Authorization: Bearer $FXAPIS_KEY" \
-H "Content-Type: application/json" \
-d '{
"login": "81234567",
"server": "Exness-MT5Trial7",
"password": "trading-password",
"mode": "warm_on_demand"
}'
# 2. Coloca una orden de mercado en ella.
curl -X POST https://api.fxapis.com/v1/accounts/$ACCOUNT_ID/orders/market \
-H "Authorization: Bearer $FXAPIS_KEY" \
-H "Idempotency-Key: 7f3e0c9a-order-1" \
-H "Content-Type: application/json" \
-d '{ "symbol": "EURUSD", "side": "buy", "volume": "0.10" }'¿Qué es una API de MT5?
MetaTrader 5 es una plataforma cliente–servidor. Un broker opera el servidor de trading de MetaTrader 5; los traders llegan a él a través del terminal de MetaTrader 5 (en el escritorio, en el teléfono o en el navegador) con la sesión iniciada con tres datos: un número de cuenta, una contraseña y el nombre del servidor del broker. Cada orden que coloca un trader viaja desde un terminal hasta ese servidor de trading.
MetaQuotes ofrece a los desarrolladores vías oficiales del lado del trader. MQL5 es el lenguaje de los programas que corren dentro del terminal: Expert Advisors, indicadores y scripts. El paquete MetaTrader5 de Python permite que un programa en Python, en la misma computadora con Windows, controle un terminal en ejecución. Y el terminal de escritorio ya tiene su propio servidor MCP: se activa en Tools → Options → MCP y permite que clientes de IA como Claude Code o Codex lean la cuenta y coloquen y gestionen órdenes a través de una dirección local, mientras ese terminal está abierto (la guía de configuración de MetaQuotes, en inglés). Los brokers tienen interfaces aparte para sus propios servidores. Lo que no existe es una API web oficial: una URL a la que tu backend pueda llamar para operar una cuenta desde cualquier lugar.
Así que el acceso de IA a MT5 no es algo que solo ofrezca un servicio alojado. La diferencia es dónde corre el terminal: el servidor MCP nativo funciona con el terminal en tu propia computadora, que tiene que seguir abierta; el servidor MCP alojado de fxapis corre los terminales en nuestra nube, así que Claude, ChatGPT o un agente llegan a tus cuentas por HTTPS sin que nada corra de tu lado. La comparación MCP nativo de MT5 frente a un servidor MCP alojado (en inglés) explica las diferencias.
Por eso, cuando los desarrolladores buscan una API de MT5 o una API REST de MetaTrader 5, se refieren a algo que se ubica entre su código y un terminal. Recibe solicitudes (coloca esta orden, lista estas posiciones, muestra este historial) y convierte cada una en la acción correspondiente en un terminal con la sesión de la cuenta iniciada. Las preguntas prácticas son quién mantiene esos terminales, cuántos, y con cuánto cuidado trata tu dinero la capa intermedia cuando algo sale mal.
Cuatro formas de tener una API de MT5
Cada una es una opción real, y la correcta depende de cuántas cuentas operas, de quién son esas cuentas y cuánta infraestructura quieres mantener.
1. El paquete oficial MetaTrader5 de Python
MetaQuotes publica en PyPI un paquete MetaTrader5 gratuito, con licencia MIT. Se comunica con un terminal de MetaTrader 5 mediante comunicación entre procesos (documentación): initialize() se conecta a un terminal y lo inicia si hace falta, login() inicia sesión en una cuenta y order_send() opera.
Es la herramienta adecuada para una estrategia personal o para investigar en una cuenta. Los límites aparecen en cuanto construyes un producto: el paquete se publica solo para Windows, el terminal tiene que correr en la misma máquina que tu código, y un terminal trabaja con una sola cuenta a la vez; así que diez cuentas son diez instalaciones del terminal. El acceso por HTTP, los reintentos, la supervisión y el almacenamiento de credenciales los tienes que construir tú.
2. Las APIs Manager y Server, para brokers
Los brokers que operan su propio servidor de MetaTrader 5 pueden usar las interfaces para brokers de MetaQuotes: la Manager API para herramientas de administración, la Server API para extender el servidor de trading, y otras (la página para brokers de MetaQuotes). Administran usuarios, grupos y balances en el servidor de ese broker. Si construyes un producto para traders cuyas cuentas están en muchos brokers distintos, no tienes acceso a ellas, y tampoco son lo que necesitas.
3. Puentes y Expert Advisors
El camino de hacerlo tú mismo: un Expert Advisor dentro de un terminal abre un socket, un canal de ZeroMQ o un sondeo HTTP, y tu código habla con él. Funciona con cualquier broker y te da control total. También significa mantener los terminales tú mismo, normalmente en servidores virtuales con Windows, uno por cuenta; mantenerlos con la sesión iniciada, actualizados y en línea; y decidir qué cree tu sistema cuando el puente se cae a mitad de una orden.
4. APIs de MT5 alojadas
Un proveedor mantiene los terminales por ti y expone una API, por lo general REST y a veces con streaming. Conectas una cuenta con su login, contraseña y servidor, y la operas por HTTPS desde cualquier lenguaje. MetaApi, API2Trade, MetaRPC y fxapis son ejemplos; se diferencian en las plataformas que soportan, el modelo de precios y cómo manejan las fallas. Nuestra guía de alternativas a MetaApi (en inglés) compara varias, con fuentes.
El costo es la confianza: le entregas al proveedor las credenciales de las cuentas, y tu producto depende de su disponibilidad. A cambio, no mantienes ningún terminal.
| Aspecto | Paquete de Python | Manager / Server API | Puente o EA | API alojada |
|---|---|---|---|---|
| Hecha para | Los scripts de un trader | Brokers, en su propio servidor | Desarrolladores que quieren control total | Productos que operan muchas cuentas |
| Lo que mantienes | Windows + un terminal | El servidor de MT5 del broker | Terminales + puente, normalmente en VPS | Nada |
| Cuentas | Una por terminal a la vez | Todas las de ese broker | Una por terminal | Muchas, en brokers que permiten iniciar sesión con contraseña |
| Lenguajes | Python | C++ / .NET (herramientas del broker) | Lo que hable tu puente | Cualquiera, por HTTPS |
| Tipo de costo | Gratis, más tus servidores | Licencias para brokers | Tus servidores y tu tiempo | Suscripción o uso por cuenta |
Qué buscar en una API de MT5
Colocar una orden cuando todo funciona es lo fácil; cualquiera de las opciones anteriores lo hace. Las diferencias están en lo que pasa en los casos límite, y en el trading, ahí es donde se pierde dinero.
- Un resultado registrado para cada orden. Cuando una solicitud se queda sin respuesta, ¿la orden llegó al broker? Una API debería distinguir “nunca se envió” (seguro de reintentar) de “todavía no lo sabemos” (nunca reintentar), y luego averiguarlo, no informar una suposición.
- Claves de idempotencia. Las redes fallan. Una solicitud reintentada tiene que devolver el primer resultado, no abrir una segunda posición.
- Un manejo de credenciales que puedas explicar a tus usuarios. Cómo se cifran las contraseñas, si alguna vez se devuelven o se registran en logs, y si se borran al desconectar una cuenta.
- Muchas cuentas a la vez. Si copias operaciones o tienes un servicio de señales, pregunta cómo llega una orden a cincuenta cuentas y cuánto tiempo separa la primera ejecución de la última.
- Un historial que coincida con el broker. Las órdenes son lo que pediste; los deals son lo que hizo el broker, incluidos stop-outs y swaps que ninguna solicitud tuya provocó. Necesitas ambos.
- Números honestos. Latencia medida, con el método explicado, y dónde están los servidores. La ubicación de tu broker importa tanto como el código del proveedor.
- Un modelo de precios que se ajuste a tu uso. El cobro por hora conviene a cuentas que están en línea de vez en cuando; los planes fijos convienen a cuentas que operan todo el mes. Haz las cuentas con tus propios números.
- Control de acceso. Keys con permisos limitados, para que una herramienta de monitoreo pueda leer y una de riesgo pueda cerrar posiciones sin poder abrir ninguna.
Cómo funciona la API de MT5 de fxapis
fxapis es una API REST de MetaTrader 5 alojada. MetaTrader 5 corre de nuestro lado, alojado en la UE; tú llamas a https://api.fxapis.com con una API key y JSON. Ni tú ni tus usuarios tienen que mantener un terminal, un VPS o un Expert Advisor.
Conectas una cuenta con su login, contraseña de trading y servidor, y eliges cómo se mantiene en línea: siempre conectada para cuentas que tienen que actuar al instante, bajo demanda (en línea cuando operas y desconectada otra vez tras 15 minutos de inactividad) o manual, donde decides tú. En nuestras mediciones, una cuenta queda en línea unos 9.6 segundos después de conectarla, y el viaje de ida y vuelta de una orden desde nuestros servidores hasta el servidor de trading de un broker en Londres es de 96–110 ms. La página de mediciones (en inglés) explica cómo se midió cada número.
Todos los tipos de orden que necesitas
Una orden, muchas cuentas
Resultados que nunca se adivinan
API keys con permisos limitados
Credenciales bien cuidadas
import os, uuid, requests
API = "https://api.fxapis.com"
fx = requests.Session()
fx.headers["Authorization"] = f"Bearer {os.environ['FXAPIS_KEY']}"
order = fx.post(
f"{API}/v1/accounts/{account_id}/orders/market",
headers={"Idempotency-Key": str(uuid.uuid4())}, # seguro de reintentar
json={
"symbol": "EURUSD",
"side": "buy",
"volume": "0.10", # los decimales van como texto
"stopLoss": "1.0890", # precios absolutos
"takeProfit": "1.1010",
},
).json()["data"]
print(order["state"], order["filledPrice"]) # filled 1.09472
positions = fx.get(f"{API}/v1/accounts/{account_id}/positions").json()["data"]Hecha para reintentarse
Las órdenes de mercado, las órdenes pendientes, los cierres y las órdenes multicuenta aceptan una Idempotency-Key; los cambios de stop y las cancelaciones se pueden repetir sin riesgo. Envía la misma solicitud dos veces con la misma key y recibes la primera respuesta, sin que se coloque nada por segunda vez. Las fallas traen códigos estables que dicen qué hacer: SEND_FAILED significa que nada llegó al broker y reintentar es seguro; ORDER_REJECTED trae el código de respuesta del propio broker; ORDER_UNRESOLVED significa que no la reenvíes: la estamos confirmando con el broker.
La referencia de la API (en inglés) muestra cada endpoint en 13 lenguajes, y la especificación OpenAPI genera un cliente para cualquier otro. Empieza con la guía de inicio rápido de cinco minutos y luego lee Trading e historial.
Endpoints de un vistazo
Los endpoints principales, agrupados por lo que hacen. Las formas completas de las solicitudes y respuestas están en la referencia de la API.
| Método | Ruta | Qué hace |
|---|---|---|
| Cuentas | ||
| POST | /v1/accounts | Conecta una cuenta de MT5 con login, contraseña y servidor |
| GET | /v1/accounts | Lista las cuentas conectadas y sus estados |
| GET | /v1/accounts/{id}/status | Estado ligero, pensado para consultas periódicas |
| POST | /v1/accounts/prepare | Pone en línea hasta 200 cuentas en una llamada |
| POST | /v1/accounts/{id}/warm · cool · restart | Pone en línea, desconecta o reinicia una cuenta |
| POST | /v1/accounts/{id}/mode | Siempre conectada, bajo demanda o manual |
| POST | /v1/accounts/{id}/disconnect | Desconecta y borra la contraseña guardada |
| Trading | ||
| POST | /v1/accounts/{id}/orders/market | Orden de mercado, con stop loss y take profit opcionales |
| POST | /v1/accounts/{id}/orders/pending | Órdenes limit, stop y stop-limit |
| POST | /v1/orders/{id}/modify · cancel | Modifica o cancela una orden pendiente |
| POST | /v1/accounts/{id}/positions/{positionId}/close | Cierra una posición completa o en parte (positionId = ticket) |
| POST | /v1/accounts/{id}/positions/{positionId}/modify | Mueve el stop loss o el take profit de una posición |
| POST | /v1/accounts/{id}/calculate | Margen o ganancia de una operación, antes de colocarla |
| Muchas cuentas | ||
| POST | /v1/execution-waves | Una operación en muchas cuentas, con volumen por cuenta |
| GET | /v1/execution-waves/{id} | El resultado de cada cuenta y la dispersión |
| POST | /v1/execution-waves/{id}/cancel | La cancela antes de que salga cualquier orden |
| Historial | ||
| GET | /v1/orders | Cada orden que colocaste, filtrable por cuenta, estado, símbolo y fecha |
| GET | /v1/accounts/{id}/deals | Lo que hizo el broker, incluidos stop-outs y swaps |
| GET | /v1/accounts/{id}/positions | Posiciones abiertas, con la última vez que se vieron |
| POST | /v1/accounts/{id}/reconcile | Compara ahora con los registros del broker |
Lo que fxapis no hace
- MT4. Solo MetaTrader 5, por ahora.
- Un feed de datos de mercado. No hay streaming de precios, ni historial de ticks, ni un archivo profundo de velas. Las cotizaciones en vivo y hasta 1,000 barras recientes son lecturas desde una cuenta en línea, no un producto de datos.
- Una garantía de disponibilidad sin contrato. Los niveles de servicio se acuerdan en Enterprise.
- Señales o asesoría. fxapis ejecuta lo que envía tu código. No tiene opinión sobre el mercado.
Mira también las alertas de TradingView a MT5, sin EA ni VPS, y el servidor MCP alojado que permite a los asistentes de IA usar fxapis.
Empieza a construir, paso a paso.
- Artículo del blog
Cómo elegir una API de MT5
Las preguntas que conviene hacer antes de construir sobre una API de MT5.
Leer - Artículo del blog
API key de MT5 vs login del broker
Qué hace cada cosa: una API key, un login de MT5, una contraseña y un nombre de servidor.
Leer - Artículo del blog
Opera MT5 desde Python con el SDK de fxapis
pip install fxapis, conecta una cuenta y coloca órdenes que nunca se ejecutan dos veces.
Leer - Artículo del blog
Paquete de Python de MetaTrader 5 vs API REST
Windows y un terminal en ejecución, o ninguno de los dos: las dos opciones comparadas.
Leer - Guía de la documentación
Inicio rápido
De una API key a una orden ejecutada, en unos cinco minutos.
Leer - Guía de la documentación
Python (en inglés)
Un programa completo en Python que opera MT5 sin MetaTrader instalado.
Leer
Preguntas sobre la API de MT5
¿Existe una API REST oficial de MetaTrader 5?
No. MetaQuotes ofrece MQL5 para programas que corren dentro del terminal, un paquete de Python que se comunica con un terminal en la misma computadora con Windows, un servidor MCP dentro del terminal de escritorio para clientes de IA mientras ese terminal está abierto, y APIs aparte para los servidores de los propios brokers. Una API REST para operar una cuenta por internet viene de un tercero que mantiene los terminales por ti; fxapis es uno de ellos.
¿Puedo usar una API de MT5 desde Linux, macOS o una función serverless?
Con una API alojada, sí: es HTTPS y JSON, así que cualquier lenguaje en cualquier plataforma puede llamarla. El paquete oficial MetaTrader5 de Python solo se publica para Windows y necesita un terminal corriendo en la misma máquina.
¿Puedo usar la API de MT5 de fxapis desde Python?
Sí. Es una API REST, así que te basta con las librerías requests o httpx, y la referencia de la API muestra cada endpoint en Python y en 12 lenguajes más. También puedes generar un cliente a partir de la especificación OpenAPI.
¿Qué diferencia hay entre una API de MT5 y la Manager API de MT5?
Una API de MT5, en el sentido habitual, opera una cuenta como lo haría un trader, con la sesión iniciada con el login de esa cuenta. La Manager API es para brokers: administra su propio servidor de MT5 (usuarios, grupos, balances) y se licencia al broker que lo opera. fxapis es una API del lado del trader: funciona con cuentas en brokers de MT5 que permiten iniciar sesión con contraseña, y no necesita que el broker intervenga.
¿fxapis funciona con MT4?
Todavía no. Hoy fxapis es solo para MetaTrader 5.
¿fxapis transmite precios o velas?
No hay streaming. Las cotizaciones en vivo son una consulta REST al broker de la propia cuenta, y las velas recientes son hasta 1,000 barras de ese mismo terminal. No hay historial de ticks, ni archivo histórico profundo, ni feed por WebSocket. Para gráficos y backtests, usa un proveedor de datos.
¿Cuántas cuentas puedo conectar?
Los planes tienen precio por cuenta: cada uno incluye algunas cuentas y cobra un poco por cada cuenta adicional, hasta mil en el plan más grande; para más, Enterprise tiene un precio acordado contigo. Las cuentas pueden estar en línea todo el tiempo (un pequeño cargo mensual), ponerse en línea solo cuando operas, o quedar bajo tu control.
¿Hay un sandbox?
Las keys vienen marcadas como live o test, pero las dos llegan a brokers reales. Usa las cuentas demo gratuitas de tu broker para desarrollar y probar, y luego conecta cuentas con dinero real.
Coloca tu primera operación en MT5 por HTTPS.
Crea un espacio de trabajo, genera una API key, conecta una cuenta demo y envía una orden, en unos cinco minutos.