Skip to main content
POST /api/v1/positions/{position}/close requiere una cuenta verificada, permisos de trading y una Idempotency-Key persistida para esa intención de cierre.

​
Cierre completo

Selecciona el ticket Position consultando las posiciones de tu cuenta. No es el ID de solicitud ni el de la orden de apertura. Para solicitar todo el volumen actual de la posición, envía únicamente el login de la cuenta autorizada:

​
Cierre parcial

Indica el volumen que quieres cerrar, en unidades MT5: 10000 = 1 lote. Por ejemplo, cerrar 0,5 lotes:
El volumen debe ser positivo, no superar la posición actual y respetar el mínimo, máximo y paso del símbolo. volume omitido o null solicita todo el volumen observado. comment es opcional y tiene un máximo de 31 caracteres.

​
Qué calcula la API

La API busca la posición exclusivamente en la cuenta verificada y obtiene el símbolo y volumen actuales. Para cerrar un BUY envía un SELL al Bid; para cerrar un SELL envía un BUY al Ask. Resuelve precisión, cotización vigente y FOK/IOC según el símbolo efectivo del grupo. Envía el ticket en Position para cerrar esa posición concreta. El cliente no envía symbol, side, price ni digits; los cuerpos antiguos con esos campos producen 422 y deben actualizarse. Los símbolos en modo solo cierre están admitidos cuando permiten la operación.

​
Envío y confirmación

Guarda el cuerpo en closing.json y una clave única para esta intención:
Repetir el mismo cuerpo, ticket y clave devuelve el envío original sin consultar de nuevo la posición ni volver a operar. Una clave nueva representa otra intención. Guarda el ID recibido y consulta su resultado. IOC puede cerrar solo parte del volumen solicitado, incluso en un cierre completo. Revisa la posición restante antes de decidir otra operación; no hay reenvío automático. Un ticket ajeno o inexistente devuelve 403. Volumen excesivo, paso incorrecto o campos adicionales devuelven 422. Una cotización vencida impide el envío. Cambios concurrentes en MT5 pueden alterar la posición: el broker valida el cierre final. No se garantiza liquidación completa por el mero envío de la solicitud.