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

> Prueba una API de MT5 con seguridad: conecta una cuenta demo, lee de ella, coloca una orden pequeña y revisa el resultado. Una clave de prueba no basta.

Publicado el 2026-10-26 por ElWizard para fxapis. Canónica: https://fxapis.com/es/blog/probar-una-api-de-mt5-sin-arriesgar-dinero-real

## En resumen

- Prueba con una cuenta demo de un broker: precios reales y el comportamiento real del broker, con dinero de práctica.
- fxapis no tiene un mercado simulado. Una clave marcada como de prueba igual llega a brokers reales: lo que hace segura una prueba es la cuenta, no la clave.
- Avanza en cuatro pasos: conecta la cuenta demo, lee de ella, coloca la orden más pequeña y revisa lo que volvió.
- Después prueba las fallas a propósito: un mercado cerrado, un volumen demasiado grande, un doble clic.

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):

```bash
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:

```bash
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:

```bash
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:

| Prueba | Espera |
|---|---|
| Una orden con el mercado cerrado (un fin de semana, en Forex) | `ORDER_REJECTED`, no reintentable |
| Un volumen muy por encima del margen de la cuenta | `ORDER_REJECTED` por margen insuficiente |
| La misma solicitud dos veces con el mismo `Idempotency-Key` | La primera respuesta, repetida: una sola posición |
| Un error de tipeo en el nombre del servidor | La cuenta en `invalid_credentials` |

Cada falla debería terminar donde tu código lo espera. La [referencia de errores](https://docs.fxapis.com/es/errors) 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](https://docs.fxapis.com/es/quickstart): los mismos pasos con ejemplos en Python y Node.js.
- [Por qué una operación en MT5 puede fallar](https://fxapis.com/es/blog/por-que-mt5-rechaza-tu-orden): cómo leer un rechazo.
- [Crea tu clave](https://fxapis.com/sign-up) y conecta tu primera cuenta demo.

## Preguntas

### ¿fxapis tiene un sandbox?

No. No hay un mercado simulado. Toda clave, incluidas las fx_test_, llega a servidores reales de brokers. Para probar sin riesgo, conecta cuentas demo de tu broker.

### ¿Dónde consigo una cuenta demo de MT5?

En tu broker. La mayoría ofrece cuentas demo de MetaTrader 5 gratis desde su sitio web o desde dentro de MetaTrader. Anota el login, la contraseña y el nombre del servidor demo que te dan.

### ¿Puedo probar gratis?

Sí, con una prueba gratuita de 14 días del plan que elijas: las funciones y los límites de ese plan en cuentas demo (hasta 5; la prueba de Personal tiene 2), sin tarjeta. Al final pagas el plan o te detienes; no hay plan gratuito.

### ¿Una cuenta demo es exactamente igual a una real?

Parecida, no idéntica. Los servidores demo usan precios reales, pero las ejecuciones, el deslizamiento y algunas reglas pueden diferir de los servidores reales del broker. Prueba tu integración en demo y luego pasa a real con tamaños pequeños.