v57

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-07-2161198428.4 KB

Positions

Close Position

Delete a position within an account for an instrument.

Retrieves orders generated to close the position.

delete/v1/accounts/{account_id}/positions/{instrument_id}

Path parameters

account_idinteger required

Account identifier

string uuid required

Instrument identifier

string required

Symbol (symbol for equities, OSI for options)

Instrument ID (UUID) or symbol (equity ticker or OSI option symbol).

Request body

cancel_ordersboolean nullable

Whether to cancel existing open orders for the position before submitting closing orders.

Example request

{
  "cancel_orders": false
}

Response

List of orders generated to close the position.

Example response

{
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero"
  },
  "data": [
    {
      "account_id": 19816,
      "client_order_id": "my-ref-id-20251001-001",
      "created_at": "2025-10-31T13:30:00.000000000Z",
      "extended_hours": false,
      "filled_quantity": "0",
      "id": "0195f6c7-4f64-7e3c-8b0a-1d8e4f5e6a7b",
      "instrument_id": "d4d5d6d7-e4e5-f4f5-a4a5-a6a7a8a9aaab",
      "instrument_type": "COMMON_STOCK",
      "leaves_quantity": "1",
      "limit_price": "48.00",
      "order_type": "LIMIT",
      "quantity": "1",
      "side": "BUY",
      "status": "PENDING_NEW",
      "stop_price": null,
      "symbol": "TSLA",
      "time_in_force": "DAY",
      "updated_at": "2025-10-31T13:30:00.000000000Z",
      "venue": "XNAS"
    }
  ]
}