> ## Documentation Index
> Fetch the complete documentation index at: https://api-trading-docs.vexprofx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Errores y soporte

> Interpreta los códigos HTTP, los resultados MT5 y las respuestas de verificación.

## Dos niveles de resultado

Comprueba el código HTTP y el contenido. Algunas consultas conservan el sobre MT5,
por ejemplo `{"retcode":"0 Done","answer":{}}`; la forma de `answer` depende de la ruta.
Un éxito de transporte no equivale a una ejecución de trading confirmada.
Una verificación de contraseña fallida puede devolver HTTP 200 con `valid:false`.

## Errores HTTP

| Código | Causa habitual | Acción |
| - | - | - |
| 400 | Clave de idempotencia ausente o inválida | Revisar formato de 16–128 caracteres |
| 401 | Token ausente, inválido, expirado o revocado | Revisar el secreto o solicitar reemplazo |
| 403 | Ruta, cuenta, IP, solicitud o posición no autorizada; trading deshabilitado | Revisar `detail`, permisos y verificación |
| 409 | Clave reutilizada con otros datos o reserva pendiente | Reconciliar; no generar otra clave a ciegas |
| 413 | Cuerpo demasiado grande | Reducirlo a los campos admitidos |
| 422 | Cuerpo, JSON o parámetros inválidos; cierre incompatible | Revisar restricciones y posición actual |
| 429 | Límite de peticiones o fallos de contraseña | Esperar y reducir frecuencia; no insistir con contraseñas |
| 500 | Error interno | Conservar identificadores; reconciliar si fue una operación |
| 502 | MT5 rechazó la solicitud | Revisar `retcode` y el contexto con soporte |
| 503 | MT5, autorización o búsqueda de posición no disponible | Reintentar lecturas con espera; reconciliar escrituras |

Los errores de validación del servicio se simplifican a
`{"detail":"Invalid request"}` para no devolver datos sensibles. No dependas de
que `detail` contenga una lista de campos o el valor que enviaste. El cierre también
puede devolver un mensaje específico cuando los parámetros no coinciden con la posición.

Un error MT5 puede devolver:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{"detail": "MT5 rejected the request", "retcode": "CODIGO_MT5"}
```

El código es una cadena y se filtra antes de devolverlo. Un rechazo de ejecución
también puede aparecer dentro del resultado asíncrono con HTTP 200.

## Recuperación

Las consultas GET pueden repetirse con espera y un máximo de intentos. No apliques
esa misma política automáticamente a las aperturas y cierres. Sigue
[idempotencia y recuperación](/es/trading/idempotency) para resultados inciertos.
No se garantiza un encabezado `Retry-After`; no inventes una espera fija del servidor.

Si recibes HTML o un bloqueo del proxy en vez de JSON, trátalo como una respuesta no
válida para tu flujo. Mantén la validación HTTPS y confirma el estado antes de operar.

## Información para soporte

Conserva método, ruta, hora UTC, código HTTP, `X-Request-ID`, `X-Audit-ID` cuando exista,
login, ID de solicitud MT5 y clave de idempotencia para operaciones.
Las respuestas generadas por la aplicación incluyen `X-Request-ID`; un fallo previo
en el proxy o la red puede no incluirlo. `X-Audit-ID` depende de que se registre la auditoría.
Nunca envíes tokens, contraseñas ni el cuerpo de verificación en un reporte.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.