API key de MT5 vs login del broker: ¿cuál es la diferencia?

Si buscaste «API key de MT5» y no encontraste nada en la configuración de MetaTrader, es porque no existe. MetaTrader 5 y tu broker te dan un login, una contraseña y un nombre de servidor. Una API key viene de la API con la que operas. Una integración necesita ambos tipos, para tareas distintas.

Para obtener una API key de MT5: regístrate en un proveedor de API de MT5 como fxapis, crea una clave en su consola y conecta tu cuenta de MT5 una sola vez con el login, la contraseña de trading y el servidor de la cuenta. Funciona igual con cualquier broker de MT5.

Cuatro credenciales, dos dueños

La primera pertenece a tu aplicación. Las otras tres pertenecen a una cuenta de trading: la tuya o la de uno de tus usuarios.

Cómo encajan

Conectar una cuenta usa las cuatro, una sola vez. Tu servidor envía los datos de la cuenta a fxapis, autenticado con tu clave:

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

La respuesta es un id de cuenta. Desde entonces, cada solicitud usa la clave y ese id, nunca más la contraseña. fxapis cifra la contraseña al recibirla con una clave única para esa cuenta, nunca la devuelve y la borra cuando desconectas la cuenta.

Cómo obtener cada una

La API key. Regístrate en fxapis.com/sign-up, abre la consola y crea una clave en API keys. Se muestra una sola vez; fxapis guarda solo un hash, así que una clave perdida se reemplaza, no se recupera. Dale a cada clave solo los scopes que necesita; por ejemplo, trading:reduce para una herramienta de riesgo que puede cerrar pero nunca abrir.

El login y la contraseña. Del broker, al abrir la cuenta: normalmente en el correo de bienvenida y en el área de clientes del broker. Usa la contraseña de trading (maestra). La contraseña de inversor inicia sesión pero no puede operar; mira contraseña de inversor vs contraseña de trading.

El nombre del servidor. Aparece en MetaTrader junto a la cuenta, y en el correo del broker. Debe coincidir exactamente; mira cómo encontrar el nombre del servidor de MT5.

Dónde debe vivir cada una

• La API key se queda en tu servidor. Es una credencial de servidor a servidor: nunca en un navegador, una app móvil o un repositorio. El prefijo fx_ hace que una clave filtrada sea fácil de encontrar con una búsqueda.
• La contraseña de MT5 pasa una sola vez. Tu formulario de conexión la envía a tu backend, tu backend llama a POST /v1/accounts en la misma solicitud, y nada (base de datos, log, cola) guarda una copia. Guarda en su lugar el id de cuenta de fxapis.

Confusiones comunes

• «Mi API key no inicia sesión en MetaTrader». No está hecha para eso. La clave habla con fxapis; MetaTrader nunca la ve.
• «La cuenta se conectó pero no puede operar». Normalmente se usó la contraseña de inversor en lugar de la contraseña de trading.
• «Una clave de prueba no debería operar dinero real». fxapis etiqueta las claves como live o test para que distingas configuraciones, pero ambas llegan a brokers reales. Prueba con cuentas demo del broker.

Próximos pasos

• Crea tu cuenta y tu primera clave.
• La guía de autenticación cubre scopes, rotación y sesiones de miembros (en inglés).
• Conectar cuentas de MT5 cubre en detalle la pantalla de conexión, incluido qué decirles a los usuarios cuando falla un login (en inglés).