> ## 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.

# Cerrar una posición

> Cierre total o parcial usando el ticket y la cuenta verificada.

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

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{"login": 104205}
```

## Cierre parcial

Indica el volumen que quieres cerrar, en unidades MT5: **10000 = 1 lote**.
Por ejemplo, cerrar 0,5 lotes:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{"login": 104205, "volume": 5000, "comment": "Cierre parcial"}
```

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:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --fail-with-body -X POST "$API_BASE/api/v1/positions/654321/close" \
  -H "Authorization: Bearer $MT5_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $CLOSE_KEY" \
  --data-binary @closing.json
```

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](/es/trading/results). 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.


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