publicdotcom-cli 1.3.3__tar.gz → 1.3.5__tar.gz

{publicdotcom_cli-1.3.3 → publicdotcom_cli-1.3.5}/CHANGELOG.md

@@ -5,6 +5,75 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.5] - 2026-09-22
+
+### Added
+- `public order search` command covering the new
+  `POST /userapigateway/trading/{accountId}/order/v2` endpoint: filter the last
+  30 days of orders (up to 500) by `--status`, `--side`, `--symbol` (`SYMBOL` or
+  `SYMBOL:TYPE`, repeatable), `--security-type`, `--open-close`,
+  `--created-after` and `--created-before`. Only the filters given are sent, so a
+  bare `order search` lists everything. Results render as an Orders table, or as
+  raw JSON with `--json`.
+- `public order get-v2 ORDER_ID` command covering the new
+  `GET /userapigateway/trading/{accountId}/order/v2/{orderId}` endpoint. The v2
+  order shape adds `trades`, `filledAt`, `replacedAt`, `lastModified` and
+  `equityMarketSession` to the `order get` response.
+- README "Order Search" section.
+
+### Changed
+- Regenerated `_generated/` from the updated `spec.yaml`:
+  - New `search_orders` and `get_order_v2` endpoint modules.
+  - New `ApiQueryOrdersRequest`, `GatewayOrders`, `GatewayOrderV2` and
+    `GatewayTrade` models plus their enums (16 files).
+  - `JOINT` added to both `accountType` enums (`AccountSettings` and
+    `GatewayPortfolioAccountV2`).
+  - The generator's usual unrelated churn (`typing_extensions.Self`,
+    `enum.StrEnum`, `*args: object`) was reverted across 164 files, and the new
+    files were normalized to the vendored `TypeVar` / `(str, Enum)` style so the
+    package keeps supporting Python 3.10.
+- `scripts/generate_client.py`: the `x-enum-varnames` injection now also matches
+  YAML sequences indented at the same level as their `enum:` key (PyYAML's
+  default dump style). Without it the S&P bond-rating enum collision resurfaced
+  and generation failed on the new spec.
+
+## [1.3.4] - 2026-09-10
+
+### Added
+- Bracket-order support on `public order place`, mirroring the new `orderClass`,
+  `takeProfit` and `stopLoss` fields on the order request. New flags
+  `--order-class` (`SIMPLE`/`BRACKET`/`OCO`/`OTO`), `--take-profit-limit`,
+  `--stop-loss-stop` and `--stop-loss-limit` override the corresponding keys in
+  the request file. The CLI checks that a bracket class has at least one exit
+  leg and that exit legs carry a bracket class; the remaining constraints
+  (equities and options only, whole-share `quantity`, `CORE` session, `LIMIT`
+  or `MARKET` entry — `LIMIT` only for `OCO`) are enforced by the API.
+- `examples/order.single-leg.bracket.json` sample payload.
+- README "Bracket Orders" section covering the classes, flags, `bracketId`
+  grouping, and the bracket replacement rules.
+
+### Changed
+- Regenerated `_generated/` from the updated `spec.yaml`:
+  - New `ComHellopublicUserapigatewayApiRestOrderApiOrderRequestOrderClass`
+    enum and `GatewayTakeProfit` / `GatewayStopLoss` models, wired as the
+    optional `order_class`, `take_profit` and `stop_loss` fields on the order
+    request.
+  - `bracket_id` on `GatewayOrder`.
+  - `nullable: true` was dropped from `OrderLeg`, `OptionGreeks` and
+    `GatewayAvailableToWithdraw` in the spec, so their generated `*_type_0`
+    variants collapse into plain models (5 files removed, 8 added).
+  - `PageableObject` field order follows a cosmetic key reorder in the spec (no
+    behavioral change).
+  - The generator's usual unrelated churn was reverted: the unpinned newer
+    generator rewrites `from_dict` to return `typing_extensions.Self` (not a
+    declared dependency) and emits `enum.StrEnum`, which requires Python 3.11
+    while this package supports 3.10. 147 files were normalized back.
+
+### Notes
+- The spec also tightened multileg `quantity` and `ratioQuantity` to
+  `exclusiveMinimum: 0`. The generated models carry no numeric constraints, so
+  this is a no-op for the CLI; the API rejects non-positive values.
+
 ## [1.3.3] - 2026-08-11
 
 ### Added

{publicdotcom_cli-1.3.3 → publicdotcom_cli-1.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: publicdotcom-cli
-Version: 1.3.3
+Version: 1.3.5
 Summary: Command-line client for the Public.com Trading API
 Project-URL: Homepage, https://github.com/publicdotcom/publicdotcom-cli
 Project-URL: Repository, https://github.com/publicdotcom/publicdotcom-cli
@@ -238,6 +238,8 @@ public order place --file examples/order.single-leg.market-buy.json
 public order replace --file examples/order.replace.notional.json
 public order get ORDER_ID
 public order cancel ORDER_ID
+public order search --status FILLED --created-after 2026-09-01T00:00:00Z
+public order get-v2 ORDER_ID
 ```
 
 Trading commands prompt before submitting order placement, replacement, or cancellation
@@ -255,6 +257,45 @@ Order-placement and single-leg preflight payloads also accept an optional
 which tax lots to close when selling equity. See
 `examples/order.single-leg.tax-lot-matching.json` for a sample.
 
+### Bracket Orders
+
+`order place` accepts bracket orders — an entry order with take-profit and/or stop-loss
+exit legs that are placed automatically when the entry fills. Set `orderClass` to
+`BRACKET`, `OCO` or `OTO` in the request file, or pass the flags:
+
+```bash
+public order place --file examples/order.single-leg.bracket.json
+
+public order place --file examples/order.single-leg.market-buy.json \
+  --order-class BRACKET --take-profit-limit 245.00 --stop-loss-stop 210.00
+
+# STOP_LIMIT stop-loss instead of a plain STOP
+public order place --file examples/order.single-leg.market-buy.json \
+  --order-class OTO --stop-loss-stop 210.00 --stop-loss-limit 209.50
+```
+
+`--order-class`, `--take-profit-limit`, `--stop-loss-stop` and `--stop-loss-limit`
+override `orderClass`, `takeProfit` and `stopLoss` in the request file. A bracket class
+needs at least one exit leg, and exit legs need a bracket class — the CLI checks both
+before submitting.
+
+| Class | Meaning |
+|---|---|
+| `SIMPLE` (or omitted) | Standalone order — no exit legs. |
+| `BRACKET` | Entry with take-profit and/or stop-loss exits. |
+| `OCO` | One-cancels-other exits; the entry must be a `LIMIT` order. |
+| `OTO` | One-triggers-other — the entry triggers the attached exit. |
+
+The API enforces the remaining constraints: equities and options only, a whole-share
+`quantity` (no `amount`), the `CORE` market session, and a `LIMIT` or `MARKET` entry
+order type (`LIMIT` only for `OCO`). Responses from `order get` carry a `bracketId` —
+the entry order's id, shared by every leg of the bracket, and absent on standalone
+orders. See `examples/order.single-leg.bracket.json` for a full sample payload.
+
+Bracket legs have their own replacement rules: the entry order cannot be replaced, and
+the closing legs accept `limitPrice` / `stopPrice` replacements only — resubmit
+`quantity`, `orderType` and `expiration` unchanged.
+
 `order replace` submits a cancel-replace request for an open order. The replacement can
 specify either a `quantity` or a notional `amount` — the two fields are mutually
 exclusive. `--quantity` and `--amount` override the corresponding field in the request
@@ -267,6 +308,28 @@ public order replace --file examples/order.replace.notional.json
 public order replace --file examples/order.replace.notional.json --amount 250.00
 ```
 
+### Order Search
+
+`order search` queries the last 30 days of orders (up to 500) and renders them as a
+table. Combine any of the filters, or pass none to list everything:
+
+```bash
+public order search
+public order search --status FILLED --side BUY --created-after 2026-09-01T00:00:00Z
+public order search --symbol AAPL --symbol SPY:OPTION --open-close OPEN
+public --json order search --security-type MULTI_LEG_INSTRUMENT
+```
+
+`--symbol` takes `SYMBOL` or `SYMBOL:TYPE` (the type defaults to `EQUITY`) and can be
+repeated. `--status`, `--side`, `--security-type` and `--open-close` accept the values
+from the API spec, case-insensitively; `--created-after` and `--created-before` are ISO
+8601 timestamps. Each order comes back in the v2 shape, which adds `trades` (each with
+`tradeId`, `price`, `quantity`, `side`, `timestamp`), `filledAt`, `replacedAt`,
+`lastModified` and `equityMarketSession` to the fields `order get` returns.
+
+`order get-v2 ORDER_ID` fetches a single order in that same v2 shape. Both v2 commands
+only cover orders created within the last 30 days.
+
 ## Tax Lots
 
 Inspect unrealized tax lots for the configured (or `--account-id`) account:

{publicdotcom_cli-1.3.3 → publicdotcom_cli-1.3.5}/README.md

@@ -200,6 +200,8 @@ public order place --file examples/order.single-leg.market-buy.json
 public order replace --file examples/order.replace.notional.json
 public order get ORDER_ID
 public order cancel ORDER_ID
+public order search --status FILLED --created-after 2026-09-01T00:00:00Z
+public order get-v2 ORDER_ID
 ```
 
 Trading commands prompt before submitting order placement, replacement, or cancellation
@@ -217,6 +219,45 @@ Order-placement and single-leg preflight payloads also accept an optional
 which tax lots to close when selling equity. See
 `examples/order.single-leg.tax-lot-matching.json` for a sample.
 
+### Bracket Orders
+
+`order place` accepts bracket orders — an entry order with take-profit and/or stop-loss
+exit legs that are placed automatically when the entry fills. Set `orderClass` to
+`BRACKET`, `OCO` or `OTO` in the request file, or pass the flags:
+
+```bash
+public order place --file examples/order.single-leg.bracket.json
+
+public order place --file examples/order.single-leg.market-buy.json \
+  --order-class BRACKET --take-profit-limit 245.00 --stop-loss-stop 210.00
+
+# STOP_LIMIT stop-loss instead of a plain STOP
+public order place --file examples/order.single-leg.market-buy.json \
+  --order-class OTO --stop-loss-stop 210.00 --stop-loss-limit 209.50
+```
+
+`--order-class`, `--take-profit-limit`, `--stop-loss-stop` and `--stop-loss-limit`
+override `orderClass`, `takeProfit` and `stopLoss` in the request file. A bracket class
+needs at least one exit leg, and exit legs need a bracket class — the CLI checks both
+before submitting.
+
+| Class | Meaning |
+|---|---|
+| `SIMPLE` (or omitted) | Standalone order — no exit legs. |
+| `BRACKET` | Entry with take-profit and/or stop-loss exits. |
+| `OCO` | One-cancels-other exits; the entry must be a `LIMIT` order. |
+| `OTO` | One-triggers-other — the entry triggers the attached exit. |
+
+The API enforces the remaining constraints: equities and options only, a whole-share
+`quantity` (no `amount`), the `CORE` market session, and a `LIMIT` or `MARKET` entry
+order type (`LIMIT` only for `OCO`). Responses from `order get` carry a `bracketId` —
+the entry order's id, shared by every leg of the bracket, and absent on standalone
+orders. See `examples/order.single-leg.bracket.json` for a full sample payload.
+
+Bracket legs have their own replacement rules: the entry order cannot be replaced, and
+the closing legs accept `limitPrice` / `stopPrice` replacements only — resubmit
+`quantity`, `orderType` and `expiration` unchanged.
+
 `order replace` submits a cancel-replace request for an open order. The replacement can
 specify either a `quantity` or a notional `amount` — the two fields are mutually
 exclusive. `--quantity` and `--amount` override the corresponding field in the request
@@ -229,6 +270,28 @@ public order replace --file examples/order.replace.notional.json
 public order replace --file examples/order.replace.notional.json --amount 250.00
 ```
 
+### Order Search
+
+`order search` queries the last 30 days of orders (up to 500) and renders them as a
+table. Combine any of the filters, or pass none to list everything:
+
+```bash
+public order search
+public order search --status FILLED --side BUY --created-after 2026-09-01T00:00:00Z
+public order search --symbol AAPL --symbol SPY:OPTION --open-close OPEN
+public --json order search --security-type MULTI_LEG_INSTRUMENT
+```
+
+`--symbol` takes `SYMBOL` or `SYMBOL:TYPE` (the type defaults to `EQUITY`) and can be
+repeated. `--status`, `--side`, `--security-type` and `--open-close` accept the values
+from the API spec, case-insensitively; `--created-after` and `--created-before` are ISO
+8601 timestamps. Each order comes back in the v2 shape, which adds `trades` (each with
+`tradeId`, `price`, `quantity`, `side`, `timestamp`), `filledAt`, `replacedAt`,
+`lastModified` and `equityMarketSession` to the fields `order get` returns.
+
+`order get-v2 ORDER_ID` fetches a single order in that same v2 shape. Both v2 commands
+only cover orders created within the last 30 days.
+
 ## Tax Lots
 
 Inspect unrealized tax lots for the configured (or `--account-id`) account:

publicdotcom_cli-1.3.5/examples/order.single-leg.bracket.json

@@ -0,0 +1,21 @@
+{
+  "instrument": {
+    "symbol": "AAPL",
+    "type": "EQUITY"
+  },
+  "orderSide": "BUY",
+  "orderType": "LIMIT",
+  "expiration": {
+    "timeInForce": "DAY"
+  },
+  "quantity": "10",
+  "limitPrice": "227.50",
+  "equityMarketSession": "CORE",
+  "orderClass": "BRACKET",
+  "takeProfit": {
+    "limitPrice": "245.00"
+  },
+  "stopLoss": {
+    "stopPrice": "210.00"
+  }
+}

{publicdotcom_cli-1.3.3 → publicdotcom_cli-1.3.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "publicdotcom-cli"
-version = "1.3.3"
+version = "1.3.5"
 description = "Command-line client for the Public.com Trading API"
 readme = "README.md"
 requires-python = ">=3.10"

{publicdotcom_cli-1.3.3 → publicdotcom_cli-1.3.5}/scripts/generate_client.py

@@ -57,7 +57,9 @@ def _inject_enum_varnames(text: str) -> str:
             i += 1
             continue
         indent = match.group(1)
-        item_re = re.compile(rf"^({re.escape(indent)}\s+)- (\S.*?)\s*$")
+        # Sequence items may sit deeper than the `enum:` key or at the same indent
+        # (PyYAML's default dump style), so allow zero or more extra spaces.
+        item_re = re.compile(rf"^({re.escape(indent)}\s*)- (\S.*?)\s*$")
         values: list[str] = []
         item_indent = ""
         j = i + 1

{publicdotcom_cli-1.3.3 → publicdotcom_cli-1.3.5}/src/publicdotcom_cli/__init__.py

@@ -1,3 +1,3 @@
 """Command-line tools for the Public API."""
 
-__version__ = "1.3.3"
+__version__ = "1.3.5"

publicdotcom_cli-1.3.5/src/publicdotcom_cli/_generated/api/order_placement/get_order_v2.py

@@ -0,0 +1,190 @@
+from http import HTTPStatus
+from typing import Any, cast
+from urllib.parse import quote
+from uuid import UUID
+
+import httpx
+
+from ... import errors
+from ...client import AuthenticatedClient, Client
+from ...models.com_hellopublic_userapigateway_api_rest_order_v2_gateway_order_v2 import (
+    ComHellopublicUserapigatewayApiRestOrderV2GatewayOrderV2,
+)
+from ...types import Response
+
+
+def _get_kwargs(
+    account_id: str,
+    order_id: UUID,
+) -> dict[str, Any]:
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/userapigateway/trading/{account_id}/order/v2/{order_id}".format(
+            account_id=quote(str(account_id), safe=""),
+            order_id=quote(str(order_id), safe=""),
+        ),
+    }
+
+    return _kwargs
+
+
+def _parse_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Any | ComHellopublicUserapigatewayApiRestOrderV2GatewayOrderV2 | None:
+    if response.status_code == 200:
+        response_200 = ComHellopublicUserapigatewayApiRestOrderV2GatewayOrderV2.from_dict(
+            response.json()
+        )
+
+        return response_200
+
+    if response.status_code == 404:
+        response_404 = cast(Any, None)
+        return response_404
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(
+    *, client: AuthenticatedClient | Client, response: httpx.Response
+) -> Response[Any | ComHellopublicUserapigatewayApiRestOrderV2GatewayOrderV2]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    account_id: str,
+    order_id: UUID,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[Any | ComHellopublicUserapigatewayApiRestOrderV2GatewayOrderV2]:
+    """Retrieve order details
+
+     Fetches the status and details of a specific order for the given account.
+    Works only for orders created within last 30 days.
+
+    Args:
+        account_id (str):
+        order_id (UUID):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any | ComHellopublicUserapigatewayApiRestOrderV2GatewayOrderV2]
+    """
+
+    kwargs = _get_kwargs(
+        account_id=account_id,
+        order_id=order_id,
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+def sync(
+    account_id: str,
+    order_id: UUID,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Any | ComHellopublicUserapigatewayApiRestOrderV2GatewayOrderV2 | None:
+    """Retrieve order details
+
+     Fetches the status and details of a specific order for the given account.
+    Works only for orders created within last 30 days.
+
+    Args:
+        account_id (str):
+        order_id (UUID):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Any | ComHellopublicUserapigatewayApiRestOrderV2GatewayOrderV2
+    """
+
+    return sync_detailed(
+        account_id=account_id,
+        order_id=order_id,
+        client=client,
+    ).parsed
+
+
+async def asyncio_detailed(
+    account_id: str,
+    order_id: UUID,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Response[Any | ComHellopublicUserapigatewayApiRestOrderV2GatewayOrderV2]:
+    """Retrieve order details
+
+     Fetches the status and details of a specific order for the given account.
+    Works only for orders created within last 30 days.
+
+    Args:
+        account_id (str):
+        order_id (UUID):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any | ComHellopublicUserapigatewayApiRestOrderV2GatewayOrderV2]
+    """
+
+    kwargs = _get_kwargs(
+        account_id=account_id,
+        order_id=order_id,
+    )
+
+    response = await client.get_async_httpx_client().request(**kwargs)
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio(
+    account_id: str,
+    order_id: UUID,
+    *,
+    client: AuthenticatedClient | Client,
+) -> Any | ComHellopublicUserapigatewayApiRestOrderV2GatewayOrderV2 | None:
+    """Retrieve order details
+
+     Fetches the status and details of a specific order for the given account.
+    Works only for orders created within last 30 days.
+
+    Args:
+        account_id (str):
+        order_id (UUID):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Any | ComHellopublicUserapigatewayApiRestOrderV2GatewayOrderV2
+    """
+
+    return (
+        await asyncio_detailed(
+            account_id=account_id,
+            order_id=order_id,
+            client=client,
+        )
+    ).parsed

{publicdotcom_cli-1.3.3 → publicdotcom_cli-1.3.5}/src/publicdotcom_cli/_generated/api/order_placement/place_order.py

@@ -78,6 +78,10 @@ def sync_detailed(
 
      Submits a new order asynchronously for the specified account.
 
+    Bracket orders: set orderClass to BRACKET, OCO, or OTO and supply takeProfit and/or stopLoss. The
+    returned orderId
+    identifies the entry order; the exit legs are placed automatically when the entry fills.
+
     Note: Order placement is asynchronous. The returned result confirms submission, not execution or
     visibility.
     To retrieve the order status or execution details, query the GET /{orderId} endpoint after
@@ -119,6 +123,10 @@ def sync(
 
      Submits a new order asynchronously for the specified account.
 
+    Bracket orders: set orderClass to BRACKET, OCO, or OTO and supply takeProfit and/or stopLoss. The
+    returned orderId
+    identifies the entry order; the exit legs are placed automatically when the entry fills.
+
     Note: Order placement is asynchronous. The returned result confirms submission, not execution or
     visibility.
     To retrieve the order status or execution details, query the GET /{orderId} endpoint after
@@ -155,6 +163,10 @@ async def asyncio_detailed(
 
      Submits a new order asynchronously for the specified account.
 
+    Bracket orders: set orderClass to BRACKET, OCO, or OTO and supply takeProfit and/or stopLoss. The
+    returned orderId
+    identifies the entry order; the exit legs are placed automatically when the entry fills.
+
     Note: Order placement is asynchronous. The returned result confirms submission, not execution or
     visibility.
     To retrieve the order status or execution details, query the GET /{orderId} endpoint after
@@ -194,6 +206,10 @@ async def asyncio(
 
      Submits a new order asynchronously for the specified account.
 
+    Bracket orders: set orderClass to BRACKET, OCO, or OTO and supply takeProfit and/or stopLoss. The
+    returned orderId
+    identifies the entry order; the exit legs are placed automatically when the entry fills.
+
     Note: Order placement is asynchronous. The returned result confirms submission, not execution or
     visibility.
     To retrieve the order status or execution details, query the GET /{orderId} endpoint after

{publicdotcom_cli-1.3.3 → publicdotcom_cli-1.3.5}/src/publicdotcom_cli/_generated/api/order_placement/replace_order.py

@@ -82,6 +82,9 @@ def sync_detailed(
     Note: Order replacement is asynchronous. This response confirms submission only. To verify the order
     status or execution details, use the GET /{orderId} endpoint after replacement.
     Supported for equity, option, and crypto quantity orders.
+    Bracket orders: the opening (entry) order cannot be replaced. The closing legs (take-profit, stop-
+    loss, and both legs of an OCO) can have their limitPrice and stopPrice replaced; quantity, orderType
+    and expiration must be resubmitted unchanged.
 
     Args:
         account_id (str):
@@ -124,6 +127,9 @@ def sync(
     Note: Order replacement is asynchronous. This response confirms submission only. To verify the order
     status or execution details, use the GET /{orderId} endpoint after replacement.
     Supported for equity, option, and crypto quantity orders.
+    Bracket orders: the opening (entry) order cannot be replaced. The closing legs (take-profit, stop-
+    loss, and both legs of an OCO) can have their limitPrice and stopPrice replaced; quantity, orderType
+    and expiration must be resubmitted unchanged.
 
     Args:
         account_id (str):
@@ -161,6 +167,9 @@ async def asyncio_detailed(
     Note: Order replacement is asynchronous. This response confirms submission only. To verify the order
     status or execution details, use the GET /{orderId} endpoint after replacement.
     Supported for equity, option, and crypto quantity orders.
+    Bracket orders: the opening (entry) order cannot be replaced. The closing legs (take-profit, stop-
+    loss, and both legs of an OCO) can have their limitPrice and stopPrice replaced; quantity, orderType
+    and expiration must be resubmitted unchanged.
 
     Args:
         account_id (str):
@@ -201,6 +210,9 @@ async def asyncio(
     Note: Order replacement is asynchronous. This response confirms submission only. To verify the order
     status or execution details, use the GET /{orderId} endpoint after replacement.
     Supported for equity, option, and crypto quantity orders.
+    Bracket orders: the opening (entry) order cannot be replaced. The closing legs (take-profit, stop-
+    loss, and both legs of an OCO) can have their limitPrice and stopPrice replaced; quantity, orderType
+    and expiration must be resubmitted unchanged.
 
     Args:
         account_id (str):