Close Position

v1.positions.close_position(, ) -> PositionClosePositionResponse

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

Delete a position within an account for an instrument.

Retrieves orders generated to close the position.

ParametersExpand Collapse

account_id: int

instrument_id: InstrumentIDOrSymbol

OEMS instrument UUID

formatuuid

cancel_orders: Optional[bool]

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

ReturnsExpand Collapse

class PositionClosePositionResponse: …

data: OrderList

id: str

Engine-assigned unique identifier for this order (UUID).

account_id: int

Account placing the order

formatint64

client_order_id: str

Client-provided identifier echoed back (FIX tag 11).

created_at: datetime

Timestamp when order was created (UTC)

formatdate-time

filled_quantity: str

Cumulative filled quantity

instrument_id: str

OEMS instrument UUID for the traded instrument.

formatuuid

instrument_type: SecurityType

Type of security

One of the following:

"COMMON_STOCK"

"PREFERRED_STOCK"

"OPTION"

"CASH"

"OTHER"

leaves_quantity: str

Remaining unfilled quantity

order_type: OrderType

Type of order (MARKET, LIMIT, etc.)

One of the following:

"MARKET"

"LIMIT"

"STOP"

"STOP_LIMIT"

"TRAILING_STOP"

"TRAILING_STOP_LIMIT"

"OTHER"

quantity: str

Total order quantity

side: Side

Side of the order (BUY, SELL, SELL_SHORT)

One of the following:

"BUY"

"SELL"

"SELL_SHORT"

"OTHER"

status: OrderStatus

Current status of the order

One of the following:

"PENDING_NEW"

"NEW"

"PARTIALLY_FILLED"

"FILLED"

"CANCELED"

"REJECTED"

"EXPIRED"

"PENDING_CANCEL"

"PENDING_REPLACE"

"REPLACED"

"DONE_FOR_DAY"

"STOPPED"

"SUSPENDED"

"CALCULATED"

"OTHER"

symbol: str

Trading symbol

time_in_force: TimeInForce

Time in force instruction

One of the following:

"DAY"

"GOOD_TILL_CANCEL"

"IMMEDIATE_OR_CANCEL"

"FILL_OR_KILL"

"GOOD_TILL_DATE"

"AT_THE_OPENING"

"AT_THE_CLOSE"

"GOOD_TILL_CROSSING"

"GOOD_THROUGH_CROSSING"

"AT_CROSSING"

"OTHER"

updated_at: datetime

Timestamp of the most recent update (UTC)

formatdate-time

venue: str

MIC code of the venue where the order is routed

average_fill_price: Optional[str]

Average fill price across all executions

details: Optional[List[str]]

Contains execution, rejection or cancellation details, if any

expires_at: Optional[datetime]

Timestamp when the order will expire (UTC). Present when time_in_force is GOOD_TILL_DATE.

formatdate-time

extended_hours: Optional[bool]

Whether the order is eligible for extended-hours trading.

limit_offset: Optional[str]

Limit offset for trailing stop-limit orders (signed)

limit_price: Optional[str]

Limit price (for LIMIT and STOP_LIMIT orders)

queue_state: Optional[QueueState]

Parent order queue state, present when the order is awaiting release or released.

One of the following:

"AWAITING_RELEASE"

"RELEASED"

releases_at: Optional[datetime]

Scheduled release time for orders awaiting release.

formatdate-time

stop_price: Optional[str]

Stop price (for STOP and STOP_LIMIT orders)

trailing_limit_px: Optional[str]

Current trailing limit price computed by the trailing strategy

trailing_offset: Optional[str]

Trailing offset amount for trailing orders

trailing_offset_type: Optional[TrailingOffsetType]

Trailing offset type for trailing orders

One of the following:

"PRICE"

"BPS"

trailing_stop_px: Optional[str]

Current trailing stop price computed by the trailing strategy

trailing_watermark_px: Optional[str]

Trailing watermark price for trailing orders

trailing_watermark_ts: Optional[datetime]

Trailing watermark timestamp for trailing orders

formatdate-time

underlying_instrument_id: Optional[str]

OEMS instrument ID of the option’s underlying instrument. Populated only for OPTIONS orders; null for non-options and for options whose underlier cannot be resolved from the instrument cache.

formatuuid

Close Position

from clear_street import ClearStreet

client = ClearStreet(
    api_key="My API Key",
)
response = client.v1.positions.close_position(
    instrument_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    account_id=0,
)
print(response)

{
  "data": [
    {
      "account_id": 19816,
      "average_fill_price": null,
      "created_at": "2025-10-03T14:01:15.000000000Z",
      "filled_quantity": "0",
      "id": "019c0b56-2119-7482-a80f-5a2a316524d9",
      "instrument_id": "c3c4c5c6-d3d4-e3e4-f3f4-f5f6f7f8f9fa",
      "instrument_type": "COMMON_STOCK",
      "leaves_quantity": "25",
      "limit_price": null,
      "order_type": "MARKET",
      "quantity": "25",
      "side": "SELL",
      "status": "PENDING_NEW",
      "stop_price": null,
      "symbol": "GOOG",
      "time_in_force": "DAY",
      "updated_at": "2025-10-03T14:01:15.000000000Z",
      "venue": "XNMS"
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "3f4a5b6c-7d8e-9f0a-1b2c-3d4e5f6a7b8c"
  }
}

{
  "error": {
    "code": 400,
    "message": "Failed to parse the request body as JSON: expected `:` at line 2 column 19"
  },
  "metadata": {
    "request_id": "93a7c482-b246-4e15-9618-bcbe0906b815"
  }
}

{
  "error": {
    "code": 403,
    "message": "The caller does not have permission to execute the specified operation"
  },
  "metadata": {
    "request_id": "5518f0c6-58ff-4b4a-81a5-701556d41206"
  }
}

Returns Examples

{
  "data": [
    {
      "account_id": 19816,
      "average_fill_price": null,
      "created_at": "2025-10-03T14:01:15.000000000Z",
      "filled_quantity": "0",
      "id": "019c0b56-2119-7482-a80f-5a2a316524d9",
      "instrument_id": "c3c4c5c6-d3d4-e3e4-f3f4-f5f6f7f8f9fa",
      "instrument_type": "COMMON_STOCK",
      "leaves_quantity": "25",
      "limit_price": null,
      "order_type": "MARKET",
      "quantity": "25",
      "side": "SELL",
      "status": "PENDING_NEW",
      "stop_price": null,
      "symbol": "GOOG",
      "time_in_force": "DAY",
      "updated_at": "2025-10-03T14:01:15.000000000Z",
      "venue": "XNMS"
    }
  ],
  "error": null,
  "metadata": {
    "request_id": "3f4a5b6c-7d8e-9f0a-1b2c-3d4e5f6a7b8c"
  }
}

{
  "error": {
    "code": 400,
    "message": "Failed to parse the request body as JSON: expected `:` at line 2 column 19"
  },
  "metadata": {
    "request_id": "93a7c482-b246-4e15-9618-bcbe0906b815"
  }
}

{
  "error": {
    "code": 403,
    "message": "The caller does not have permission to execute the specified operation"
  },
  "metadata": {
    "request_id": "5518f0c6-58ff-4b4a-81a5-701556d41206"
  }
}