Close Order

​

Authentication

Authorization: Bearer <your_jwt_token>

​

Request Body

​

Response

​

Error Responses

​

Status Codes

• 200 - Order closed successfully
• 400 - Missing orderId, order not found, or order already closed
• 401 - Unauthorized - invalid or expired token
• 500 - Internal server error

​

Examples

​

Close an Order

curl -X POST https://api.exness.com/api/v1/trade/close \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "orderId": "ord_1234567890abcdef"
  }'

{
  "message": "Order closed successfully",
  "order": {
    "orderId": "ord_1234567890abcdef",
    "status": "CLOSED",
    "closePrice": 42350.75,
    "profit": 125.50
  }
}

​

Error: Missing Order ID

curl -X POST https://api.exness.com/api/v1/trade/close \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "error": "Missing required parameters: orderId"
}

​

Error: Order Not Found

curl -X POST https://api.exness.com/api/v1/trade/close \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "orderId": "ord_nonexistent"
  }'

{
  "error": "Order not found or already closed",
  "message": "Order not found or already closed"
}

​

Error: Order ID Mismatch

{
  "error": "Order ID mismatch"
}

​

Trading Workflow

1. Get Open Orders - Use GET /api/v1/trade/orders to see all open positions
2. Select Order - Choose the orderId of the position you want to close
3. Close Order - Use this endpoint to close the position at market price
4. View Closed Orders - Use GET /api/v1/trade/close to see your trading history

​

Notes

• Only the user who created the order can close it (verified via JWT token)
• Orders are closed at the current market price
• The close operation is processed asynchronously through a Redis stream
• The endpoint will timeout after 5 seconds if no response is received
• Closing an order calculates the final profit/loss based on entry and exit prices
• Once closed, an order cannot be reopened - you would need to create a new order