Close

Close an open position by its ticket number. Supports partial closes by specifying a volume less than the full position size.

Endpoint

POST /v1/close

Request Parameters

Parameter	Type	Required	Description
`ticket`	integer	Yes	Position ticket number to close
`volume`	number	No	Volume to close in lots. Omit to close the full position. Specify a smaller value for a partial close
`comment`	string	No	Close comment. Max 27 characters, ASCII only

Example Request

Close a full position:

curl -X POST https://interface.xbtfx.com/v1/close \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "ticket": 12345678
  }'

Partial close (close 0.05 lots of a 0.1 lot position):

curl -X POST https://interface.xbtfx.com/v1/close \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "ticket": 12345678,
    "volume": 0.05
  }'

Response

{
  "status": "placed",
  "retcode": 10008
}

Response Fields

Field	Type	Description
`status`	string	`placed` or `filled` or `rejected`
`retcode`	integer	MT5 return code. `10008` or `10009` indicate success
`deal`	integer	Closing deal ticket number (present when status is `filled`)
`price`	number	Close execution price (present when status is `filled`)