Cómo probar una API de MT5 sin arriesgar dinero real

Puedes construir y probar una integración completa de MT5 sin arriesgar un centavo, si pruebas con lo correcto. La seguridad viene de la cuenta, no de la API key. Usa una cuenta demo de un broker, y avanza de leer a operar.

Una clave de prueba no es un sandbox

Muchas API tienen un sandbox: claves de prueba que llegan a un mercado falso. fxapis no. Las claves llevan las etiquetas fx_live_ y fx_test_ para que puedas distinguir configuraciones, pero las dos llegan a brokers reales. Una clave de prueba conectada a una cuenta con dinero real coloca operaciones reales.

Los brokers ya tienen el mejor sandbox que existe: las cuentas demo. Operan con precios reales y dinero de práctica, en servidores hechos para eso.

Paso 1: conecta una cuenta demo

Abre una cuenta demo de MT5 gratis con tu broker y anota tres cosas: el login, la contraseña y el nombre del servidor demo, que suele terminar en -Demo. Luego conéctala, con el nombre del servidor exactamente como lo muestra MetaTrader (por ejemplo Exness-MT5Trial8, ICMarketsSC-Demo o Pepperstone-Demo; fxapis funciona con cualquier broker de MT5):

curl -X POST https://api.fxapis.com/v1/accounts \
  -H "Authorization: Bearer $FXAPIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "login": "26177561", "server": "YourBroker-Demo",
        "password": "the-demo-password", "mode": "warm_on_demand",
        "label": "demo" }'

Ponla en línea con POST /v1/accounts/{id}/warm y consulta GET /v1/accounts/{id}/status hasta que el estado sea ready: unos 10 segundos en nuestras mediciones. Si termina en invalid_credentials, revisa primero el nombre del servidor.

Paso 2: lee antes de escribir

Haz solicitudes que no pueden cambiar nada:

curl https://api.fxapis.com/v1/accounts/$ACCOUNT_ID/positions -H "Authorization: Bearer $FXAPIS_KEY"
curl "https://api.fxapis.com/v1/accounts/$ACCOUNT_ID/symbols?search=EURUSD" -H "Authorization: Bearer $FXAPIS_KEY"

La segunda muestra cómo nombra tu broker el símbolo y sus reglas de volumen (volumeMin, volumeStep). Si quieres saber si una orden pasará la revisión de margen, POST /v1/accounts/{id}/calculate responde sin abrir nada.

Paso 3: coloca la orden más pequeña

Envía el volumen mínimo, con una clave de idempotencia:

curl -X POST https://api.fxapis.com/v1/accounts/$ACCOUNT_ID/orders/market \
  -H "Authorization: Bearer $FXAPIS_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ "symbol": "EURUSD", "side": "buy", "volume": "0.01" }'

Fíjate en que el volumen es un string, "0.01": fxapis rechaza los números JSON para que ningún tamaño se redondee en el camino.

Paso 4: revisa lo que volvió

No te quedes en un 201. Lee el resultado:

• state debería ser filled, con un filledPrice y el número de orden del propio broker.
• GET /v1/accounts/{id}/positions debería mostrar ahora la posición.
• Ciérrala con POST /v1/accounts/{id}/positions/{ticket}/close, de nuevo con una clave de idempotencia, y revisa que la posición desapareció.

Compáralo con lo que muestra MetaTrader para la cuenta demo. Tu integración funciona cuando los dos coinciden.

Paso 5: prueba las fallas a propósito

El camino feliz es la parte fácil. En la cuenta demo, prueba:

Cada falla debería terminar donde tu código lo espera. La referencia de errores lista cada código y si conviene reintentar.

Pasar a real

Cuando la demo se comporte bien, conecta una cuenta real y empieza con los tamaños más pequeños. Mantén claves separadas para las configuraciones de prueba y reales (la etiqueta hace fácil detectar una clave de prueba en producción) y conserva la cuenta demo para las pruebas de regresión.

Próximos pasos

• Inicio rápido: los mismos pasos con ejemplos en Python y Node.js.
• Por qué una operación en MT5 puede fallar: cómo leer un rechazo.
• Crea tu clave y conecta tu primera cuenta demo.