## Close Position

`client.V1.Positions.ClosePosition(ctx, instrumentID, params) (*V1PositionClosePositionResponse, error)`

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

Delete a position within an account for an instrument.

Retrieves orders generated to close the position.

### Parameters

- `InstrumentID InstrumentIDOrSymbol`

  OEMS instrument UUID

- `params V1PositionClosePositionParams`

  - `AccountID param.Field[int64]`

    Path param: Account identifier

  - `CancelOrders param.Field[bool]`

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

### Returns

- `type V1PositionClosePositionResponse struct{…}`

  - `Data OrderList`

    - `ID string`

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

    - `AccountID int64`

      Account placing the order

    - `ClientOrderID string`

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

    - `CreatedAt Time`

      Timestamp when order was created (UTC)

    - `FilledQuantity string`

      Cumulative filled quantity

    - `InstrumentID string`

      OEMS instrument UUID for the traded instrument.

    - `InstrumentType SecurityType`

      Type of security

      - `const SecurityTypeCommonStock SecurityType = "COMMON_STOCK"`

      - `const SecurityTypePreferredStock SecurityType = "PREFERRED_STOCK"`

      - `const SecurityTypeOption SecurityType = "OPTION"`

      - `const SecurityTypeCash SecurityType = "CASH"`

      - `const SecurityTypeOther SecurityType = "OTHER"`

    - `LeavesQuantity string`

      Remaining unfilled quantity

    - `OrderType OrderType`

      Type of order (MARKET, LIMIT, etc.)

      - `const OrderTypeMarket OrderType = "MARKET"`

      - `const OrderTypeLimit OrderType = "LIMIT"`

      - `const OrderTypeStop OrderType = "STOP"`

      - `const OrderTypeStopLimit OrderType = "STOP_LIMIT"`

      - `const OrderTypeTrailingStop OrderType = "TRAILING_STOP"`

      - `const OrderTypeTrailingStopLimit OrderType = "TRAILING_STOP_LIMIT"`

      - `const OrderTypeOther OrderType = "OTHER"`

    - `Quantity string`

      Total order quantity

    - `Side Side`

      Side of the order (BUY, SELL, SELL_SHORT)

      - `const SideBuy Side = "BUY"`

      - `const SideSell Side = "SELL"`

      - `const SideSellShort Side = "SELL_SHORT"`

      - `const SideOther Side = "OTHER"`

    - `Status OrderStatus`

      Current status of the order

      - `const OrderStatusPendingNew OrderStatus = "PENDING_NEW"`

      - `const OrderStatusNew OrderStatus = "NEW"`

      - `const OrderStatusPartiallyFilled OrderStatus = "PARTIALLY_FILLED"`

      - `const OrderStatusFilled OrderStatus = "FILLED"`

      - `const OrderStatusCanceled OrderStatus = "CANCELED"`

      - `const OrderStatusRejected OrderStatus = "REJECTED"`

      - `const OrderStatusExpired OrderStatus = "EXPIRED"`

      - `const OrderStatusPendingCancel OrderStatus = "PENDING_CANCEL"`

      - `const OrderStatusPendingReplace OrderStatus = "PENDING_REPLACE"`

      - `const OrderStatusReplaced OrderStatus = "REPLACED"`

      - `const OrderStatusDoneForDay OrderStatus = "DONE_FOR_DAY"`

      - `const OrderStatusStopped OrderStatus = "STOPPED"`

      - `const OrderStatusSuspended OrderStatus = "SUSPENDED"`

      - `const OrderStatusCalculated OrderStatus = "CALCULATED"`

      - `const OrderStatusOther OrderStatus = "OTHER"`

    - `Symbol string`

      Trading symbol

    - `TimeInForce TimeInForce`

      Time in force instruction

      - `const TimeInForceDay TimeInForce = "DAY"`

      - `const TimeInForceGoodTillCancel TimeInForce = "GOOD_TILL_CANCEL"`

      - `const TimeInForceImmediateOrCancel TimeInForce = "IMMEDIATE_OR_CANCEL"`

      - `const TimeInForceFillOrKill TimeInForce = "FILL_OR_KILL"`

      - `const TimeInForceGoodTillDate TimeInForce = "GOOD_TILL_DATE"`

      - `const TimeInForceAtTheOpening TimeInForce = "AT_THE_OPENING"`

      - `const TimeInForceAtTheClose TimeInForce = "AT_THE_CLOSE"`

      - `const TimeInForceGoodTillCrossing TimeInForce = "GOOD_TILL_CROSSING"`

      - `const TimeInForceGoodThroughCrossing TimeInForce = "GOOD_THROUGH_CROSSING"`

      - `const TimeInForceAtCrossing TimeInForce = "AT_CROSSING"`

      - `const TimeInForceOther TimeInForce = "OTHER"`

    - `UpdatedAt Time`

      Timestamp of the most recent update (UTC)

    - `Venue string`

      MIC code of the venue where the order is routed

    - `AverageFillPrice string`

      Average fill price across all executions

    - `Details []string`

      Contains execution, rejection or cancellation details, if any

    - `ExpiresAt Time`

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

    - `ExtendedHours bool`

      Whether the order is eligible for extended-hours trading.

    - `LimitOffset string`

      Limit offset for trailing stop-limit orders (signed)

    - `LimitPrice string`

      Limit price (for LIMIT and STOP_LIMIT orders)

    - `QueueState QueueState`

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

      - `const QueueStateAwaitingRelease QueueState = "AWAITING_RELEASE"`

      - `const QueueStateReleased QueueState = "RELEASED"`

    - `ReleasesAt Time`

      Scheduled release time for orders awaiting release.

    - `StopPrice string`

      Stop price (for STOP and STOP_LIMIT orders)

    - `TrailingLimitPx string`

      Current trailing limit price computed by the trailing strategy

    - `TrailingOffset string`

      Trailing offset amount for trailing orders

    - `TrailingOffsetType TrailingOffsetType`

      Trailing offset type for trailing orders

      - `const TrailingOffsetTypePrice TrailingOffsetType = "PRICE"`

      - `const TrailingOffsetTypeBps TrailingOffsetType = "BPS"`

    - `TrailingStopPx string`

      Current trailing stop price computed by the trailing strategy

    - `TrailingWatermarkPx string`

      Trailing watermark price for trailing orders

    - `TrailingWatermarkTs Time`

      Trailing watermark timestamp for trailing orders

    - `UnderlyingInstrumentID string`

      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.

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/clear-street/clear-street-go"
  "github.com/clear-street/clear-street-go/option"
)

func main() {
  client := clearstreet.NewClient(
    option.WithAPIKey("My API Key"),
  )
  response, err := client.V1.Positions.ClosePosition(
    context.TODO(),
    "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    clearstreet.V1PositionClosePositionParams{
      AccountID: 0,
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response)
}
```

#### Response

```json
{
  "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"
  }
}
```