MetaTrader API — Centro de ayuda
Busca o explora las categorías de la izquierda para encontrar respuestas. Cada pregunta tiene su propia URL para compartir.
Busca o explora las categorías de la izquierda para encontrar respuestas. Cada pregunta tiene su propia URL para compartir.
MetaTrader API es un servicio de API REST alojado que te permite interactuar con cuentas de trading de MT4 y MT5 de forma programática, sin tener que ejecutar MetaTrader en tu ordenador.
Conectas tu cuenta de trading una sola vez y, a partir de ese momento, puedes ejecutar operaciones, consultar datos de la cuenta y leer precios de mercado desde cualquier lenguaje de programación mediante peticiones HTTP estándar.
Para todos los detalles técnicos, consulta la documentación oficial.
Empezar lleva menos de 30 minutos:
POST /v1/seats o /ConnectEx).Consulta la guía paso a paso en la documentación de autenticación.
Cualquier lenguaje capaz de hacer peticiones HTTP funciona con MetaTrader API. Al ser una API REST sobre HTTPS, puedes usar Python, JavaScript/Node.js, Go, C#, Java, Ruby, PHP o cualquier otro lenguaje.
También funciona con herramientas no-code como Postman, Make (Integromat), n8n, Zapier o cualquier cosa capaz de llamar a un endpoint HTTP.
Sí. La API admite cuentas de MetaTrader 4 (MT4) y MetaTrader 5 (MT5). Puedes conectar y gestionar cuentas de ambas plataformas simultáneamente.
La facturación es por plaza: cada plaza conecta una cuenta de MT4 o una de MT5, y puedes combinar plazas de MT4 y MT5 en la misma suscripción.
MT4 y MT5 ofrecen los mismos endpoints; la única diferencia es que las órdenes stop-limit solo existen en MT5. Consulta la documentación para la referencia completa de endpoints por plataforma.
No. Ese es precisamente el propósito de este servicio. MetaTrader API se ejecuta íntegramente en el servidor. Conectas las credenciales de tu bróker una vez y la API mantiene la conexión con el bróker en tu nombre.
No necesitas instalar MetaTrader, ni mantener ninguna aplicación de escritorio en ejecución, ni programar Expert Advisors en MQL.
Usa tu clave de API en la cabecera x-api-key y pasa el UUID de la cuenta como parámetro de consulta id (o accountId):
curl -X GET "https://api.metatraderapi.net/AccountSummary?id=YOUR_ACCOUNT_UUID" \
-H "x-api-key: YOUR_API_KEY"La clave de API se crea en la tarjeta de la cuenta en el panel con Generate key; solo se muestra una vez. La clave de gestión de Settings (Configuración) sirve para el aprovisionamiento, no para la cabecera x-api-key.
La clave de API de una cuenta se crea en la tarjeta de esa cuenta en el panel, en app.metatraderapi.net: haz clic en Generate key. Solo se muestra una vez, así que guárdala enseguida. /ConnectEx y POST /v1/seats también devuelven una clave nueva para la cuenta que conectan. La pestaña Settings (Configuración) contiene tu clave de gestión, que sirve para el aprovisionamiento (crear y eliminar plazas), no para las llamadas de trading.
Buena práctica: guárdala como variable de entorno (por ejemplo MTAPI_KEY) e inyéctala en tiempo de ejecución.
Puedes conectar cuentas de dos formas:
Inicia sesión en app.metatraderapi.net, ve a la sección Accounts (Cuentas) y añade tus credenciales de MT4/MT5 (número de acceso, contraseña y nombre del servidor del bróker). Una vez conectada, recibirás un UUID único para esa cuenta.
Desde un backend, usa POST /v1/seats con un cuerpo JSON y tu clave de gestión. También puedes llamar a /ConnectEx?user=&password=&server=&platform=MT5&wait=60 con una clave de gestión o una clave de API que no sea de solo lectura ni esté limitada a una cuenta. Ambos devuelven el id de la cuenta y una nueva apiKey para ella. Los parámetros exactos y el formato de respuesta están en la documentación de la API.
NombreDelBroker-Live o NombreDelBroker-Demo.Usa /CheckConnect?id=. Responde true o false: si la cuenta está conectada a su bróker en este momento. El servicio restablece automáticamente las conexiones caídas. /ConnectState?id= muestra el estado y su statusReason, y /Reconnect?id= fuerza una reconexión.
Para los detalles del formato de la petición y de los valores de respuesta, consulta la documentación.
Usa /Disconnect?id= (o DELETE /v1/seats/{id} con una clave de gestión) para desconectar y eliminar una cuenta de trading conectada. Puedes listar todas las cuentas actualmente conectadas con /ConnectState sin id (o con GET /v1/seats).
Al desconectar, la plaza de la cuenta queda libre. Sigue pagada hasta el final del mes de facturación, y la siguiente cuenta que conectes la usa sin coste adicional.
Consulta la documentación de la API para los parámetros de la petición.
Tantas como plazas tengas. La facturación es por plaza: una plaza = una cuenta conectada a la vez. Añade plazas cuando las necesites (14 $ por plaza al mes de la plaza 1 a la 4, 13 $ de la 5 a la 19 y 12 $ a partir de la plaza 20, cobradas por adelantado).
Cada cliente puede tener hasta 50 plazas; más bajo petición — contacta con soporte.
La API cubre el ciclo completo de trading:
/OrderClose), o contra una posición opuesta (/OrderCloseBy)Para los detalles completos de endpoints, parámetros y formatos de respuesta, consulta la documentación de la API.
Usa el endpoint /OrderSend. Como todos los endpoints clásicos, es una petición GET con parámetros de consulta: símbolo, operación (Buy, Sell, BuyLimit…), volumen en lotes y, opcionalmente, stop loss, take profit, un comentario y un clientOrderId:
curl -H "x-api-key: YOUR_API_KEY" \
"https://api.metatraderapi.net/OrderSend?id=YOUR_ACCOUNT_UUID&symbol=EURUSD&operation=Buy&volume=0.01&clientOrderId=order-1"Los parámetros son los mismos en MT4 y MT5. Las órdenes stop-limit (stopLimitPrice) solo existen en MT5. Las órdenes pendientes admiten un expiration opcional; expirationType se ignora en MT5.
Usa los endpoints /OrderHistory u /OrderHistoryPagination. Ambos filtran solo por rango de fechas (from y to, ISO-8601 o segundos Unix); /OrderHistoryPagination divide el resultado en páginas (ordersPerPage, pageNumber). El filtrado por ticket y la ordenación se hacen en tu propio código. Para consultas más detalladas, MT4 y MT5 ofrecen además /PendingOrderHistory y /HistoryDealsByPositionId.
La referencia completa de parámetros está en la documentación.
Sí. La API ofrece una conexión WebSocket (eventos) para streaming en tiempo real. Esto te permite recibir actualizaciones en vivo en lugar de consultar repetidamente los endpoints REST.
A través del stream WebSocket (wss://api.metatraderapi.net/v1/stream?id=, autenticado con la cabecera x-api-key) recibes cotizaciones y velas en vivo de los símbolos a los que te suscribes, tus posiciones abiertas con su beneficio en vivo, las órdenes pendientes y cada operación ejecutada, además de un heartbeat cada 10 segundos. Puede haber hasta 25 streams abiertos por cuenta.
Para precios bid/ask en vivo puedes usar el endpoint REST /GetQuote (o /GetQuoteMany para varios símbolos), o suscribirte a las cotizaciones mediante el stream WebSocket para recibir actualizaciones continuas en tiempo real.
/GetQuote recibe el id de la cuenta y un symbol. Las respuestas se guardan en caché 250 ms por cuenta y símbolo; añade cached=0 para saltarte la caché.
Para velas OHLC históricas, usa /PriceHistory en MT4 y MT5 (/QuoteHistory es un alias) — consulta la documentación para los marcos temporales y parámetros.
Hay un único plan: pagas por plaza, y cada plaza incluye la API completa: REST, streaming por WebSocket y compatibilidad con MT4 y MT5. Precios sin IVA:
Cada plaza admite una cuenta MT4 o MT5 conectada a la vez y se cobra por adelantado por un mes de facturación completo. Ejemplo: 10 plazas cuestan 4 × 14 $ + 6 × 13 $ = 134 $ al mes. Todos los precios se confirman en la página de precios.
No. Actualmente no ofrecemos prueba gratuita. Si tienes dudas sobre cómo evaluar la API, escríbenos por Telegram o por correo a support@metatraderapi.net.
Puedes empezar con una sola plaza por 14 $ y añadir más cuando tu integración funcione.
Sí. El plan por plaza se factura por plaza, y cada plaza admite una cuenta conectada a la vez. Cuando todas tus plazas están en uso, conectar otra cuenta añade una plaza por 14 $ al mes (13 $ para las plazas 5–19, 12 $ a partir de la 20.ª), cobrada por adelantado al añadirla. Desconectar una cuenta libera su plaza para la siguiente sin coste, y puedes liberar las plazas que no uses desde tu panel. Cada cliente puede tener hasta 50 plazas; más bajo petición — contacta con soporte.
El pago se hace con tarjeta de crédito o débito a través de Stripe, como suscripción que se factura mensualmente. No aceptamos criptomonedas ni transferencias bancarias.
Al realizar un pedido, aceptas también el Acuerdo de servicios de Stripe.
Sí, puedes cancelar en cualquier momento. Las cancelaciones surten efecto al final del mes de facturación en curso: no hay reembolsos parciales por los días no utilizados.
El servicio lo opera Apex Vanguard Dynamics LLC, una sociedad de responsabilidad limitada (LLC) registrada en Estados Unidos, con domicilio social en 30 N Gould St Ste R, Sheridan, WY 82801, Estados Unidos.
Correo de contacto: support@metatraderapi.net · Teléfono: +1 (929) 333-6422
Para los datos legales completos, consulta el aviso legal.
Las Condiciones generales se rigen por la legislación del Estado de Wyoming, Estados Unidos. Cualquier controversia queda sometida a la jurisdicción exclusiva de los tribunales de Wyoming, y ambas partes se comprometen a intentar resolverla primero mediante negociación de buena fe.
Puedes leer las Condiciones generales completas en el sitio web.
No. Las Condiciones del servicio exigen expresamente que mantengas confidenciales tus credenciales de acceso y tus claves de API, y que no las compartas con terceros sin el consentimiento previo por escrito de MetaTrader API.
Si estás construyendo un producto o servicio sobre la API (por ejemplo, para tus propios clientes), debes implementar tu propia capa de autenticación y mantener la clave de MetaTrader API únicamente en el servidor: nunca la expongas a los usuarios finales.
No. Las Condiciones del servicio prohíben extraer (scraping) o revender datos del servicio sin autorización expresa y por escrito de MetaTrader API. Las suscripciones tampoco son transferibles.
Si tienes un caso de negocio concreto, escribe a support@metatraderapi.net.
Sí. Los acuerdos de confidencialidad están disponibles a petición y deben acordarse mutuamente por escrito. Se aplican las condiciones estándar de NDA salvo que se negocie otra cosa.
Escribe a support@metatraderapi.net para solicitarlo.
MetaTrader API protege las cuentas conectadas con las siguientes medidas:
Las medidas de seguridad, los subencargados y la disponibilidad medida están documentados en el Centro de confianza; el tratamiento de datos se describe en la Política de privacidad.
MetaTrader API es operado por una empresa estadounidense (véase ¿Quién opera MetaTrader API?) y declara cumplir la normativa de protección de datos aplicable, incluido el RGPD cuando resulta aplicable a usuarios de la UE/EEE.
Datos personales que se recogen: información de la cuenta (nombre, correo electrónico, datos de facturación), datos de uso (registros de la API, dirección IP, navegador y sistema operativo) e información de pago procesada a través de Stripe.
No vendemos datos personales. Solo se comparten con proveedores que los tratan por cuenta nuestra (por ejemplo, alojamiento, pagos y envío de correo), y hay un acuerdo de tratamiento de datos (DPA) disponible para clientes. Todos los detalles están en la Política de privacidad y en el Centro de confianza.
Según la Política de privacidad, pueden recogerse los siguientes datos:
En las cuentas de trading conectadas también se almacenan las credenciales de acceso al bróker (cifradas en reposo con AES-256-GCM), y los datos de trading que obtiene la API se tratan por cuenta tuya. Los datos de clientes y los servidores de la API están en la UE (Finlandia y Alemania). Las plazas con alojamiento privado funcionan en la región que elijas.
Lee la Política de privacidad completa para toda la información.
Los motivos más habituales de un fallo de conexión:
ICMarkets-Live02). Lo encontrarás en MetaTrader en Archivo → Abrir una cuenta.Usa el endpoint /CheckConnect para verificar el estado actual de la conexión. Si el problema persiste, escribe a support@metatraderapi.net.
Los errores de autenticación suelen indicar que falta la clave de API, es incorrecta o se envía con un formato equivocado. Comprueba lo siguiente:
x-api-key, y no Authorization: Bearer.Consulta la documentación de autenticación para el formato correcto.
MetaTrader API publica su disponibilidad medida en una página de estado pública, con el estado en vivo y el historial de disponibilidad de la API REST, el streaming WebSocket y el panel. No hay SLA ni compromiso de disponibilidad; en el Centro de confianza se explica cómo se opera el servicio.
Ten en cuenta que, según las Condiciones del servicio, el servicio se presta «tal cual» y «según disponibilidad»: contractualmente no se garantiza un funcionamiento ininterrumpido o libre de errores. Para sistemas en producción, implementa siempre lógica de reintentos y gestión de errores por tu parte.
Los rechazos de órdenes proceden del servidor de trading del bróker, no de MetaTrader API. Las causas más habituales son:
EURUSD o EURUSDm).Un rechazo del bróker no es un error HTTP: la API responde HTTP 200 con el objeto de la orden, y su campo state lleva el código de resultado del bróker. 10009 significa ejecutada; cualquier otro valor es el motivo (por ejemplo 10016 stops no válidos, 10018 mercado cerrado, 10019 fondos insuficientes; en MT4, el número de error de MT4).