Por qué una operación en MT5 puede fallar aunque tu solicitud a la API sea correcta

Tu solicitud es JSON válido, tu clave es correcta, la cuenta está en línea… y aun así la orden es rechazada. La API aceptó tu solicitud; el broker rechazó la operación. Los brokers revisan cada orden con sus propias reglas, y esas reglas pueden decir que no a una solicitud perfectamente formada.

Primero, lee el resultado

Con fxapis, un rechazo del broker llega como 422 ORDER_REJECTED, con el motivo y un indicador retryable:

{
  "error": {
    "code": "ORDER_REJECTED",
    "message": "The broker rejected the order: No money",
    "details": [{ "orderId": "…", "state": "rejected", "retryable": false }]
  }
}

GET /v1/orders/{id} muestra el código de retorno de MT5 del propio broker (aquí, 10019) tal como lo envió el broker. No se ejecutó nada. La solución depende de la causa.

Las cinco causas más comunes

1. El mercado está cerrado

Código de retorno 10018. El Forex cierra el fin de semana, el oro hace una pausa diaria, los índices siguen el horario de su bolsa, y cada broker fija sus propios horarios para cada símbolo.

Cómo evitarlo: revisa el horario de mercado de la cuenta antes de enviar. GET /v1/accounts/{id}/sessions?instrument=XAUUSD devuelve openNow y nextOpen, leídos de ese broker.

2. El volumen no cumple las reglas del símbolo

Código de retorno 10014. Cada símbolo tiene un volumen mínimo, un máximo y un paso. 0.015 lotes es inválido donde el paso es 0.01; 0.01 es inválido donde el mínimo es 0.1.

Cómo evitarlo: lee las reglas del broker de la cuenta (GET /v1/accounts/{id}/symbols?search=EURUSD devuelve volumeMin, volumeStep y volumeMax) y redondea el tamaño al paso antes de enviar. Envía los volúmenes como texto, "0.10", para que nada se redondee en el camino.

3. Los stops son inválidos

Código de retorno 10016. El stop loss de una compra debe estar por debajo del precio y su take profit por encima (en una venta, al revés), y los brokers suelen exigir una distancia mínima respecto al precio.

Cómo evitarlo: los stops son precios absolutos, no distancias en pips: calcúlalos a partir del precio actual y mantenlos fuera de la distancia mínima del broker. fxapis rechaza un stop que está claramente del lado equivocado antes de enviar nada.

4. No hay margen suficiente

Código de retorno 10019. La cuenta no puede financiar la posición con su apalancamiento. Es común cuando una misma señal se envía con el mismo tamaño a cuentas con saldos muy distintos.

Cómo evitarlo: POST /v1/accounts/{id}/calculate con "kind": "margin" devuelve el margen que necesita una orden sin abrir nada. En órdenes a varias cuentas, ajusta el tamaño de cada cuenta a su saldo con weights.

5. El símbolo tiene otro nombre

El oro es XAUUSD en un broker y XAUUSD.a o GOLD en otro. Si envías el nombre de otro broker, la orden falla antes de poder operar.

Cómo evitarlo: envía instrument en lugar de symbol ("instrument": "XAUUSD") y fxapis opera el símbolo propio de cada cuenta. Si un broker no tiene equivalente, o tiene dos posibles, la orden se rechaza antes de enviar nada, con INSTRUMENT_NOT_OFFERED o INSTRUMENT_AMBIGUOUS.

La guía rápida

Más códigos de retorno de MT5, y qué hace fxapis con cada uno

MetaTrader 5 responde cada solicitud de operación con un código de retorno numérico. fxapis entrega el código del broker sin cambios (GET /v1/orders/{id}) y lo clasifica en uno de tres resultados: rechazada (ORDER_REJECTED, no se ejecutó nada), rechazada pero reintentable (ORDER_REJECTED con retryable: true, no se ejecutó nada y una orden nueva puede funcionar) o desconocida (ORDER_UNRESOLVED, se confirma con los registros del broker antes de suponer nada).

Los códigos y nombres vienen de los códigos de retorno del servidor de operaciones de MetaQuotes (revisado el 26 de octubre de 2026). Los brokers pueden devolver otros códigos; fxapis trata un código que no reconoce como desconocido, nunca como rechazado, para confirmarlo en lugar de adivinar.

No toda falla es un rechazo

Hay otras dos fallas que se parecen y significan otra cosa:

• SEND_FAILED (503): está comprobado que la orden nunca llegó al broker. Es seguro reenviarla, con la misma clave de idempotencia.
• ORDER_UNRESOLVED (503): todavía nadie sabe si se ejecutó. No la reenvíes. Consulta la orden; fxapis la confirma con los registros del broker.

Próximos pasos

• Las tres fallas: rechazada, nunca enviada y desconocida, en detalle (en inglés).
• Todos los códigos de error, con si conviene reintentar (en inglés).
• Instrumentos y símbolos: un nombre para cada mercado, en todos los brokers (en inglés).
• La API de MT5: cuentas, órdenes e historial, con un resultado registrado para cada operación.