API de MT5 · API REST de MetaTrader 5

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.

cURL
# 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" }'
Lo básico

¿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.

Tus opciones

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.

Cuatro formas de tener una API de MT5, comparadas
AspectoPaquete de PythonManager / Server APIPuente o EAAPI alojada
Hecha paraLos scripts de un traderBrokers, en su propio servidorDesarrolladores que quieren control totalProductos que operan muchas cuentas
Lo que mantienesWindows + un terminalEl servidor de MT5 del brokerTerminales + puente, normalmente en VPSNada
CuentasUna por terminal a la vezTodas las de ese brokerUna por terminalMuchas, en brokers que permiten iniciar sesión con contraseña
LenguajesPythonC++ / .NET (herramientas del broker)Lo que hable tu puenteCualquiera, por HTTPS
Tipo de costoGratis, más tus servidoresLicencias para brokersTus servidores y tu tiempoSuscripción o uso por cuenta
Un resumen para orientarte, no un veredicto: la opción correcta depende de quién es dueño de las cuentas y de cuántas son.
Cómo elegir

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.
fxapis

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.

Conecta cuentas de MT5 con contraseña

Login, contraseña de trading y servidor, en brokers de MT5 que permiten iniciar sesión con contraseña. Siempre conectada, bajo demanda o manual, y prepara hasta 200 cuentas en una llamada.

Todos los tipos de orden que necesitas

Órdenes de mercado y pendientes, cierres parciales, cambios de stop loss y take profit, y una calculadora de margen y ganancia.

Una orden, muchas cuentas

Órdenes multicuenta con un volumen por cuenta, y tú decides qué pasa con las cuentas que no están listas. 30 ms de la primera a la última en 100 cuentas, en nuestra medición contra un broker instantáneo, y cada orden multicuenta informa su propia dispersión.

Resultados que nunca se adivinan

Un resultado que no está claro se informa como sin resolver y se confirma contra los registros del broker. 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.

API keys con permisos limitados

Keys de solo lectura, keys que solo cierran (trading:reduce) y keys de trading completo. Etiquetas live y test para separar configuraciones.

Credenciales bien cuidadas

Cifradas por cuenta al llegar, nunca devueltas ni registradas en logs, borradas al desconectar. Cerrar una posición nunca se bloquea por facturación.
Python · requests
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"]
Los volúmenes y los precios van como texto, así que ningún tamaño se redondea por un número de punto flotante en el camino.

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.

Referencia

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.

Endpoints de la API de fxapis
MétodoRutaQué hace
Cuentas
POST/v1/accountsConecta una cuenta de MT5 con login, contraseña y servidor
GET/v1/accountsLista las cuentas conectadas y sus estados
GET/v1/accounts/{id}/statusEstado ligero, pensado para consultas periódicas
POST/v1/accounts/preparePone en línea hasta 200 cuentas en una llamada
POST/v1/accounts/{id}/warm · cool · restartPone en línea, desconecta o reinicia una cuenta
POST/v1/accounts/{id}/modeSiempre conectada, bajo demanda o manual
POST/v1/accounts/{id}/disconnectDesconecta y borra la contraseña guardada
Trading
POST/v1/accounts/{id}/orders/marketOrden 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 · cancelModifica o cancela una orden pendiente
POST/v1/accounts/{id}/positions/{positionId}/closeCierra una posición completa o en parte (positionId = ticket)
POST/v1/accounts/{id}/positions/{positionId}/modifyMueve el stop loss o el take profit de una posición
POST/v1/accounts/{id}/calculateMargen o ganancia de una operación, antes de colocarla
Muchas cuentas
POST/v1/execution-wavesUna 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}/cancelLa cancela antes de que salga cualquier orden
Historial
GET/v1/ordersCada orden que colocaste, filtrable por cuenta, estado, símbolo y fecha
GET/v1/accounts/{id}/dealsLo que hizo el broker, incluidos stop-outs y swaps
GET/v1/accounts/{id}/positionsPosiciones abiertas, con la última vez que se vieron
POST/v1/accounts/{id}/reconcileCompara ahora con los registros del broker
Con claridad

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.

Guías

Empieza a construir, paso a paso.

FAQ

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.

> Conecta. Ejecuta. Escala.

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.