finance_dev 0.9.0__py3-none-any.whl

finance_dev/models/accountbalancev2.py

@@ -0,0 +1,340 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: bdd1603013e1
+
+from __future__ import annotations
+from datetime import date, datetime
+from finance_dev.types import BaseModel, UNSET_SENTINEL
+import pydantic
+from pydantic import model_serializer
+from typing import Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class AccountBalanceV2TypedDict(TypedDict):
+    r"""Response body for GET /v2/accounts/{id}/balance. Returned as the **top-level JSON object**. Numeric amounts are decimal strings."""
+
+    account_id: NotRequired[str]
+    r"""Account these balances belong to. Match it to the account selected by the user."""
+    amount_available_to_withdraw: NotRequired[str]
+    r"""Cash currently available to withdraw from the account, returned as a decimal string."""
+    balance: NotRequired[str]
+    r"""Total account balance (net account value), returned as a decimal string. Use this as the headline portfolio value."""
+    cash_balance: NotRequired[str]
+    r"""Current cash balance in the account, returned as a decimal string. Can be negative on a margin account."""
+    cost_of_positions: NotRequired[str]
+    r"""Aggregate cost basis of all currently open positions, returned as a decimal string."""
+    credit: NotRequired[str]
+    r"""Total margin credit line extended to the account. Decimal string."""
+    credit_remaining: NotRequired[str]
+    r"""How much of the credit line is still available to draw against. Decimal string."""
+    day_open_pnl: NotRequired[str]
+    r"""Open (unrealized) profit/loss generated during the current trading day, returned as a decimal string."""
+    day_realized_pnl: NotRequired[str]
+    r"""Profit/loss realized from positions closed during the current trading day, returned as a decimal string."""
+    day_total_pnl: NotRequired[str]
+    r"""Total profit/loss for the current trading day, combining day open and day realized P&L (`dayOpenPnl` + `dayRealizedPnl`). Decimal string."""
+    day_trade_buying_power: NotRequired[str]
+    r"""How much the user can use for same-day round-trip trades. Typically up to 4× equity for pattern day traders. Resets at end of day. Decimal string."""
+    day_trade_overnight_reg_t_buying_power: NotRequired[str]
+    r"""Reg T overnight buying power available for day-trade-related calculations, returned as a decimal string."""
+    funds_available_for_withdrawal: NotRequired[str]
+    r"""Cash available to withdraw right now, returned as a decimal string. The lower of `creditRemaining` and `smaCreditRemaining`, adjusted by the clearing firm's previous-close haircut (`sodNetFundsAvailable` minus `sodGrossFundsAvailable`) and floored at zero. Derived at read time. Until the start-of-day funds data has loaded (see `sodFundsAvailableDate`) the haircut is zero and this equals the lower of the two credit figures."""
+    gross_margin: NotRequired[str]
+    r"""Total amount currently borrowed from the broker on margin (before offsets). Use this in risk and account-health displays. Decimal string."""
+    held_back_funds: NotRequired[str]
+    r"""Funds reserved or held back by the brokerage, returned as a decimal string. Subtract this from available cash displays when explaining restricted funds."""
+    intraday_margin_balance: NotRequired[str]
+    r"""Margin loan currently outstanding, returned as a positive decimal string and rolled forward through today's trading: the start-of-day margin trade balance (sign-inverted) plus `valueSold` minus `valueBought`. Derived at read time, not stored."""
+    maint_req: NotRequired[str]
+    r"""**Maintenance requirement** — the minimum equity that must be held to support current positions. Drop below this and the account may receive a margin call. Decimal string."""
+    net_buying_power: NotRequired[str]
+    r"""Total purchasing power available right now across all instruments — the main number to show as 'Buying Power' in a trading UI. Decimal string."""
+    open_pnl: NotRequired[str]
+    r"""Total open (unrealized) profit/loss across all currently held positions, returned as a decimal string. Mirrors `unrealizedPl`."""
+    option_buying_power: NotRequired[str]
+    r"""How much the user can spend specifically on options. Usually lower than stock buying power because options require cash. Decimal string."""
+    pdt: NotRequired[str]
+    r"""**Pattern Day Trader** flag balance — relates to FINRA Rule 4210 (four-day-trades-in-five-days rule, $25,000 minimum equity). Decimal string."""
+    pdt_credit_remaining: NotRequired[str]
+    r"""Remaining day-trade buying power for a PDT-flagged account. Decimal string."""
+    pending_orders_count: NotRequired[int]
+    r"""Number of orders currently pending. Use this to explain why available buying power may be reserved."""
+    pending_orders_margin_requirements: NotRequired[str]
+    r"""Estimated margin requirement reserved by pending orders, returned as a decimal string."""
+    realized_pl: NotRequired[str]
+    r"""Cumulative profit/loss from positions that have already been **closed**. Locked in — does not move with the market. Decimal string."""
+    settled_funds: NotRequired[str]
+    r"""Cash that has fully settled (T+1/T+2 has passed) and is freely available with no restrictions. Decimal string."""
+    sma: NotRequired[str]
+    r"""**Special Memorandum Account** — a Reg T concept. Effectively a stored-up pool of 'extra' buying power that grew from past gains in a margin account. Decimal string."""
+    sma_credit_remaining: NotRequired[str]
+    r"""Remaining SMA-based buying power still available to draw against, returned as a decimal string."""
+    sod_funds_available_date: NotRequired[date]
+    r"""Business date (YYYY-MM-DD) of the start-of-day funds data behind `sodGrossFundsAvailable` and `sodNetFundsAvailable`. Omitted when that data has not loaded for the account, which is the only way to tell a genuine zero from an unloaded one."""
+    sod_gross_funds_available: NotRequired[str]
+    r"""Gross funds available at the previous close, as reported by the clearing firm, returned as a decimal string. `\"0\"` until the start-of-day load has run; check `sodFundsAvailableDate` before relying on it."""
+    sod_margin_trade_balance: NotRequired[str]
+    r"""Start-of-day margin trade-date balance as reported by the clearing firm, returned as a decimal string. Negative while a margin loan is outstanding. `\"0\"` until the start-of-day load has run for the account."""
+    sod_net_funds_available: NotRequired[str]
+    r"""Net funds available to withdraw at the previous close, as reported by the clearing firm, returned as a decimal string. Previous-close only; for the live figure use `fundsAvailableForWithdrawal`. `\"0\"` until the start-of-day load has run."""
+    sod_positions_market_value: NotRequired[str]
+    r"""Market value of positions at the start of the day, returned as a decimal string. Use this for daily performance comparisons."""
+    sod_ttl_equity: NotRequired[str]
+    r"""Total account equity at the start of the day, returned as a decimal string. Use this as the baseline for day-over-day equity changes."""
+    sod_ttl_equity_updated_at: NotRequired[datetime]
+    r"""When start-of-day total equity (`sodTtlEquity`) was last updated, in RFC3339 format. Omitted when not set."""
+    start_of_day_cash: NotRequired[str]
+    r"""Cash balance when today's trading session opened. Useful as the baseline for calculating today's cash change. Decimal string."""
+    stock_buying_power: NotRequired[str]
+    r"""How much the user can spend specifically on stocks. On a margin account this is typically up to 2× cash. Decimal string."""
+    unrealized_pl: NotRequired[str]
+    r"""Profit/loss on positions the user currently **holds open** — paper gains/losses based on current market prices. Changes with the market. Decimal string."""
+    unsettled_funds: NotRequired[str]
+    r"""Cash from recent sales that hasn't settled yet. Usable for most trades, but cash accounts may restrict using it for new buys. Decimal string."""
+    value_bought: NotRequired[str]
+    r"""Total value bought for the reporting window, returned as a decimal string. Use this in trading activity summaries."""
+    value_sold: NotRequired[str]
+    r"""Total value sold for the reporting window, returned as a decimal string. Use this in trading activity summaries."""
+
+
+class AccountBalanceV2(BaseModel):
+    r"""Response body for GET /v2/accounts/{id}/balance. Returned as the **top-level JSON object**. Numeric amounts are decimal strings."""
+
+    account_id: Annotated[Optional[str], pydantic.Field(alias="accountId")] = None
+    r"""Account these balances belong to. Match it to the account selected by the user."""
+
+    amount_available_to_withdraw: Annotated[
+        Optional[str], pydantic.Field(alias="amountAvailableToWithdraw")
+    ] = None
+    r"""Cash currently available to withdraw from the account, returned as a decimal string."""
+
+    balance: Optional[str] = None
+    r"""Total account balance (net account value), returned as a decimal string. Use this as the headline portfolio value."""
+
+    cash_balance: Annotated[Optional[str], pydantic.Field(alias="cashBalance")] = None
+    r"""Current cash balance in the account, returned as a decimal string. Can be negative on a margin account."""
+
+    cost_of_positions: Annotated[
+        Optional[str], pydantic.Field(alias="costOfPositions")
+    ] = None
+    r"""Aggregate cost basis of all currently open positions, returned as a decimal string."""
+
+    credit: Optional[str] = None
+    r"""Total margin credit line extended to the account. Decimal string."""
+
+    credit_remaining: Annotated[
+        Optional[str], pydantic.Field(alias="creditRemaining")
+    ] = None
+    r"""How much of the credit line is still available to draw against. Decimal string."""
+
+    day_open_pnl: Annotated[Optional[str], pydantic.Field(alias="dayOpenPnl")] = None
+    r"""Open (unrealized) profit/loss generated during the current trading day, returned as a decimal string."""
+
+    day_realized_pnl: Annotated[
+        Optional[str], pydantic.Field(alias="dayRealizedPnl")
+    ] = None
+    r"""Profit/loss realized from positions closed during the current trading day, returned as a decimal string."""
+
+    day_total_pnl: Annotated[Optional[str], pydantic.Field(alias="dayTotalPnl")] = None
+    r"""Total profit/loss for the current trading day, combining day open and day realized P&L (`dayOpenPnl` + `dayRealizedPnl`). Decimal string."""
+
+    day_trade_buying_power: Annotated[
+        Optional[str], pydantic.Field(alias="dayTradeBuyingPower")
+    ] = None
+    r"""How much the user can use for same-day round-trip trades. Typically up to 4× equity for pattern day traders. Resets at end of day. Decimal string."""
+
+    day_trade_overnight_reg_t_buying_power: Annotated[
+        Optional[str], pydantic.Field(alias="dayTradeOvernightRegTBuyingPower")
+    ] = None
+    r"""Reg T overnight buying power available for day-trade-related calculations, returned as a decimal string."""
+
+    funds_available_for_withdrawal: Annotated[
+        Optional[str], pydantic.Field(alias="fundsAvailableForWithdrawal")
+    ] = None
+    r"""Cash available to withdraw right now, returned as a decimal string. The lower of `creditRemaining` and `smaCreditRemaining`, adjusted by the clearing firm's previous-close haircut (`sodNetFundsAvailable` minus `sodGrossFundsAvailable`) and floored at zero. Derived at read time. Until the start-of-day funds data has loaded (see `sodFundsAvailableDate`) the haircut is zero and this equals the lower of the two credit figures."""
+
+    gross_margin: Annotated[Optional[str], pydantic.Field(alias="grossMargin")] = None
+    r"""Total amount currently borrowed from the broker on margin (before offsets). Use this in risk and account-health displays. Decimal string."""
+
+    held_back_funds: Annotated[Optional[str], pydantic.Field(alias="heldBackFunds")] = (
+        None
+    )
+    r"""Funds reserved or held back by the brokerage, returned as a decimal string. Subtract this from available cash displays when explaining restricted funds."""
+
+    intraday_margin_balance: Annotated[
+        Optional[str], pydantic.Field(alias="intradayMarginBalance")
+    ] = None
+    r"""Margin loan currently outstanding, returned as a positive decimal string and rolled forward through today's trading: the start-of-day margin trade balance (sign-inverted) plus `valueSold` minus `valueBought`. Derived at read time, not stored."""
+
+    maint_req: Annotated[Optional[str], pydantic.Field(alias="maintReq")] = None
+    r"""**Maintenance requirement** — the minimum equity that must be held to support current positions. Drop below this and the account may receive a margin call. Decimal string."""
+
+    net_buying_power: Annotated[
+        Optional[str], pydantic.Field(alias="netBuyingPower")
+    ] = None
+    r"""Total purchasing power available right now across all instruments — the main number to show as 'Buying Power' in a trading UI. Decimal string."""
+
+    open_pnl: Annotated[Optional[str], pydantic.Field(alias="openPnl")] = None
+    r"""Total open (unrealized) profit/loss across all currently held positions, returned as a decimal string. Mirrors `unrealizedPl`."""
+
+    option_buying_power: Annotated[
+        Optional[str], pydantic.Field(alias="optionBuyingPower")
+    ] = None
+    r"""How much the user can spend specifically on options. Usually lower than stock buying power because options require cash. Decimal string."""
+
+    pdt: Optional[str] = None
+    r"""**Pattern Day Trader** flag balance — relates to FINRA Rule 4210 (four-day-trades-in-five-days rule, $25,000 minimum equity). Decimal string."""
+
+    pdt_credit_remaining: Annotated[
+        Optional[str], pydantic.Field(alias="pdtCreditRemaining")
+    ] = None
+    r"""Remaining day-trade buying power for a PDT-flagged account. Decimal string."""
+
+    pending_orders_count: Annotated[
+        Optional[int], pydantic.Field(alias="pendingOrdersCount")
+    ] = None
+    r"""Number of orders currently pending. Use this to explain why available buying power may be reserved."""
+
+    pending_orders_margin_requirements: Annotated[
+        Optional[str], pydantic.Field(alias="pendingOrdersMarginRequirements")
+    ] = None
+    r"""Estimated margin requirement reserved by pending orders, returned as a decimal string."""
+
+    realized_pl: Annotated[Optional[str], pydantic.Field(alias="realizedPl")] = None
+    r"""Cumulative profit/loss from positions that have already been **closed**. Locked in — does not move with the market. Decimal string."""
+
+    settled_funds: Annotated[Optional[str], pydantic.Field(alias="settledFunds")] = None
+    r"""Cash that has fully settled (T+1/T+2 has passed) and is freely available with no restrictions. Decimal string."""
+
+    sma: Optional[str] = None
+    r"""**Special Memorandum Account** — a Reg T concept. Effectively a stored-up pool of 'extra' buying power that grew from past gains in a margin account. Decimal string."""
+
+    sma_credit_remaining: Annotated[
+        Optional[str], pydantic.Field(alias="smaCreditRemaining")
+    ] = None
+    r"""Remaining SMA-based buying power still available to draw against, returned as a decimal string."""
+
+    sod_funds_available_date: Annotated[
+        Optional[date], pydantic.Field(alias="sodFundsAvailableDate")
+    ] = None
+    r"""Business date (YYYY-MM-DD) of the start-of-day funds data behind `sodGrossFundsAvailable` and `sodNetFundsAvailable`. Omitted when that data has not loaded for the account, which is the only way to tell a genuine zero from an unloaded one."""
+
+    sod_gross_funds_available: Annotated[
+        Optional[str], pydantic.Field(alias="sodGrossFundsAvailable")
+    ] = None
+    r"""Gross funds available at the previous close, as reported by the clearing firm, returned as a decimal string. `\"0\"` until the start-of-day load has run; check `sodFundsAvailableDate` before relying on it."""
+
+    sod_margin_trade_balance: Annotated[
+        Optional[str], pydantic.Field(alias="sodMarginTradeBalance")
+    ] = None
+    r"""Start-of-day margin trade-date balance as reported by the clearing firm, returned as a decimal string. Negative while a margin loan is outstanding. `\"0\"` until the start-of-day load has run for the account."""
+
+    sod_net_funds_available: Annotated[
+        Optional[str], pydantic.Field(alias="sodNetFundsAvailable")
+    ] = None
+    r"""Net funds available to withdraw at the previous close, as reported by the clearing firm, returned as a decimal string. Previous-close only; for the live figure use `fundsAvailableForWithdrawal`. `\"0\"` until the start-of-day load has run."""
+
+    sod_positions_market_value: Annotated[
+        Optional[str], pydantic.Field(alias="sodPositionsMarketValue")
+    ] = None
+    r"""Market value of positions at the start of the day, returned as a decimal string. Use this for daily performance comparisons."""
+
+    sod_ttl_equity: Annotated[Optional[str], pydantic.Field(alias="sodTtlEquity")] = (
+        None
+    )
+    r"""Total account equity at the start of the day, returned as a decimal string. Use this as the baseline for day-over-day equity changes."""
+
+    sod_ttl_equity_updated_at: Annotated[
+        Optional[datetime], pydantic.Field(alias="sodTtlEquityUpdatedAt")
+    ] = None
+    r"""When start-of-day total equity (`sodTtlEquity`) was last updated, in RFC3339 format. Omitted when not set."""
+
+    start_of_day_cash: Annotated[
+        Optional[str], pydantic.Field(alias="startOfDayCash")
+    ] = None
+    r"""Cash balance when today's trading session opened. Useful as the baseline for calculating today's cash change. Decimal string."""
+
+    stock_buying_power: Annotated[
+        Optional[str], pydantic.Field(alias="stockBuyingPower")
+    ] = None
+    r"""How much the user can spend specifically on stocks. On a margin account this is typically up to 2× cash. Decimal string."""
+
+    unrealized_pl: Annotated[Optional[str], pydantic.Field(alias="unrealizedPl")] = None
+    r"""Profit/loss on positions the user currently **holds open** — paper gains/losses based on current market prices. Changes with the market. Decimal string."""
+
+    unsettled_funds: Annotated[
+        Optional[str], pydantic.Field(alias="unsettledFunds")
+    ] = None
+    r"""Cash from recent sales that hasn't settled yet. Usable for most trades, but cash accounts may restrict using it for new buys. Decimal string."""
+
+    value_bought: Annotated[Optional[str], pydantic.Field(alias="valueBought")] = None
+    r"""Total value bought for the reporting window, returned as a decimal string. Use this in trading activity summaries."""
+
+    value_sold: Annotated[Optional[str], pydantic.Field(alias="valueSold")] = None
+    r"""Total value sold for the reporting window, returned as a decimal string. Use this in trading activity summaries."""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(
+            [
+                "accountId",
+                "amountAvailableToWithdraw",
+                "balance",
+                "cashBalance",
+                "costOfPositions",
+                "credit",
+                "creditRemaining",
+                "dayOpenPnl",
+                "dayRealizedPnl",
+                "dayTotalPnl",
+                "dayTradeBuyingPower",
+                "dayTradeOvernightRegTBuyingPower",
+                "fundsAvailableForWithdrawal",
+                "grossMargin",
+                "heldBackFunds",
+                "intradayMarginBalance",
+                "maintReq",
+                "netBuyingPower",
+                "openPnl",
+                "optionBuyingPower",
+                "pdt",
+                "pdtCreditRemaining",
+                "pendingOrdersCount",
+                "pendingOrdersMarginRequirements",
+                "realizedPl",
+                "settledFunds",
+                "sma",
+                "smaCreditRemaining",
+                "sodFundsAvailableDate",
+                "sodGrossFundsAvailable",
+                "sodMarginTradeBalance",
+                "sodNetFundsAvailable",
+                "sodPositionsMarketValue",
+                "sodTtlEquity",
+                "sodTtlEquityUpdatedAt",
+                "startOfDayCash",
+                "stockBuyingPower",
+                "unrealizedPl",
+                "unsettledFunds",
+                "valueBought",
+                "valueSold",
+            ]
+        )
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+try:
+    AccountBalanceV2.model_rebuild()
+except NameError:
+    pass

finance_dev/models/accountitem.py

@@ -0,0 +1,78 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 9f4ff8f87f18
+
+from __future__ import annotations
+from enum import Enum
+from finance_dev import models, utils
+from finance_dev.types import BaseModel
+from pydantic import field_serializer
+from typing_extensions import TypedDict
+
+
+class AccountItemStatus(str, Enum, metaclass=utils.OpenEnumMeta):
+    r"""Account status. **OPEN** = account open for trading; **SUSPENDED** = account suspended; **CLOSED** = account closed; **PENDING_APEX_VERIFICATION** = sent to Apex, awaiting verification; **CANCELED** = account canceled; **REJECTED** = application/account rejected."""
+
+    NEW = "NEW"
+    PENDING_PLAID_VERIFICATION = "PENDING_PLAID_VERIFICATION"
+    PENDING_APEX_VERIFICATION = "PENDING_APEX_VERIFICATION"
+    READY_FOR_BACK_OFFICE = "READY_FOR_BACK_OFFICE"
+    BACK_OFFICE = "BACK_OFFICE"
+    OPEN = "OPEN"
+    CANCELED = "CANCELED"
+    REJECTED = "REJECTED"
+    SUSPENDED = "SUSPENDED"
+    CLOSED = "CLOSED"
+    ERROR = "ERROR"
+    AWAITING_REVIEW = "AWAITING_REVIEW"
+    AWAITING_APEX = "AWAITING_APEX"
+    RETURNED_APEX = "RETURNED_APEX"
+    PENDING_CLOSE = "PENDING_CLOSE"
+    STERLING_PENDING = "STERLING_PENDING"
+
+
+class AccountItemTypedDict(TypedDict):
+    r"""User account item returned by GET /v2/users/me/accounts. Use `trading_account_id` as the `tradingAccountId` in order API requests. Account type and class are empty when broker metadata is unavailable (e.g. simulation accounts)."""
+
+    account_class: str
+    r"""Account class (for example MARGIN or CASH). Empty for simulation accounts or when broker metadata is unavailable."""
+    account_type: str
+    r"""Account type (for example INDIVIDUAL or JOINT). Empty for simulation accounts or when broker metadata is unavailable."""
+    broker_account_id: str
+    r"""Broker account identifier. Empty for simulation accounts and for accounts not yet opened with the broker."""
+    is_sim: bool
+    r"""Whether this is a simulation (paper trading) account."""
+    status: AccountItemStatus
+    r"""Account status. **OPEN** = account open for trading; **SUSPENDED** = account suspended; **CLOSED** = account closed; **PENDING_APEX_VERIFICATION** = sent to Apex, awaiting verification; **CANCELED** = account canceled; **REJECTED** = application/account rejected."""
+    trading_account_id: str
+    r"""Trading account identifier. Pass this value as `tradingAccountId` when placing, replacing, or canceling orders. Empty until the trading account has been created."""
+
+
+class AccountItem(BaseModel):
+    r"""User account item returned by GET /v2/users/me/accounts. Use `trading_account_id` as the `tradingAccountId` in order API requests. Account type and class are empty when broker metadata is unavailable (e.g. simulation accounts)."""
+
+    account_class: str
+    r"""Account class (for example MARGIN or CASH). Empty for simulation accounts or when broker metadata is unavailable."""
+
+    account_type: str
+    r"""Account type (for example INDIVIDUAL or JOINT). Empty for simulation accounts or when broker metadata is unavailable."""
+
+    broker_account_id: str
+    r"""Broker account identifier. Empty for simulation accounts and for accounts not yet opened with the broker."""
+
+    is_sim: bool
+    r"""Whether this is a simulation (paper trading) account."""
+
+    status: AccountItemStatus
+    r"""Account status. **OPEN** = account open for trading; **SUSPENDED** = account suspended; **CLOSED** = account closed; **PENDING_APEX_VERIFICATION** = sent to Apex, awaiting verification; **CANCELED** = account canceled; **REJECTED** = application/account rejected."""
+
+    trading_account_id: str
+    r"""Trading account identifier. Pass this value as `tradingAccountId` when placing, replacing, or canceling orders. Empty until the trading account has been created."""
+
+    @field_serializer("status")
+    def serialize_status(self, value):
+        if isinstance(value, str):
+            try:
+                return models.AccountItemStatus(value)
+            except ValueError:
+                return value
+        return value

finance_dev/models/accountposition.py

@@ -0,0 +1,147 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+# @generated-id: 4e662fb20d35
+
+from __future__ import annotations
+from datetime import datetime
+from enum import Enum
+from finance_dev import models, utils
+from finance_dev.types import BaseModel, UNSET_SENTINEL
+import pydantic
+from pydantic import field_serializer, model_serializer
+from typing import Optional
+from typing_extensions import Annotated, NotRequired, TypedDict
+
+
+class AccountPositionSecurityType(str, Enum, metaclass=utils.OpenEnumMeta):
+    r"""Indicates whether the position is an equity/stock position or an option position. Use this value to decide which position details and actions should be shown in the UI.
+    - `EQUITY` — a stock or ETF position.
+    - `OPTION` — an option contract position.
+    """
+
+    EQUITY = "EQUITY"
+    OPTION = "OPTION"
+
+
+class AccountPositionTypedDict(TypedDict):
+    r"""One open position in the account positions list. Field names and types are stable across REST and WebSocket order updates."""
+
+    account_id: NotRequired[str]
+    r"""Account this position belongs to. Match it to the account selected by the user."""
+    average_price: NotRequired[str]
+    r"""Average entry price per share or contract, returned as a decimal string. This value can be used with quantity and current market price to calculate position-level profit/loss."""
+    cost_basis: NotRequired[str]
+    r"""Total cost basis of the position, returned as a decimal string. Omitted when unavailable (for example, on a closed position with zero quantity)."""
+    created_at: NotRequired[datetime]
+    r"""Timestamp when the current net position was established, returned in RFC3339 format. If the position is closed and reopened, this resets to the new establishment time rather than the first lot's open time. Omitted when not available."""
+    market_value: NotRequired[str]
+    r"""Current market value of the position (`quantity` × `price`), returned as a decimal string. Omitted when unavailable (for example, on a closed position with zero quantity)."""
+    price: NotRequired[str]
+    r"""Current market price per share or contract, returned as a decimal string. Omitted when unavailable (for example, on a closed position with zero quantity)."""
+    quantity: NotRequired[str]
+    r"""Current position quantity, returned as a decimal string. Positive values represent long positions. Negative values may represent short positions, depending on brokerage conventions."""
+    security_type: NotRequired[AccountPositionSecurityType]
+    r"""Indicates whether the position is an equity/stock position or an option position. Use this value to decide which position details and actions should be shown in the UI.
+    - `EQUITY` — a stock or ETF position.
+    - `OPTION` — an option contract position.
+    """
+    symbol: NotRequired[str]
+    r"""Symbol for the held instrument. Use this to link the position to quotes, charts, and research."""
+    today_pl: NotRequired[str]
+    r"""Profit or loss for the current trading day, returned as a decimal string."""
+    today_realized_pn_l: NotRequired[str]
+    r"""Profit or loss realized today from closed activity in this symbol, returned as a decimal string."""
+    unrealized_pl: NotRequired[str]
+    r"""Profit or loss on the open position at current market prices, returned as a decimal string."""
+
+
+class AccountPosition(BaseModel):
+    r"""One open position in the account positions list. Field names and types are stable across REST and WebSocket order updates."""
+
+    account_id: Annotated[Optional[str], pydantic.Field(alias="accountId")] = None
+    r"""Account this position belongs to. Match it to the account selected by the user."""
+
+    average_price: Annotated[Optional[str], pydantic.Field(alias="averagePrice")] = None
+    r"""Average entry price per share or contract, returned as a decimal string. This value can be used with quantity and current market price to calculate position-level profit/loss."""
+
+    cost_basis: Annotated[Optional[str], pydantic.Field(alias="costBasis")] = None
+    r"""Total cost basis of the position, returned as a decimal string. Omitted when unavailable (for example, on a closed position with zero quantity)."""
+
+    created_at: Annotated[Optional[datetime], pydantic.Field(alias="createdAt")] = None
+    r"""Timestamp when the current net position was established, returned in RFC3339 format. If the position is closed and reopened, this resets to the new establishment time rather than the first lot's open time. Omitted when not available."""
+
+    market_value: Annotated[Optional[str], pydantic.Field(alias="marketValue")] = None
+    r"""Current market value of the position (`quantity` × `price`), returned as a decimal string. Omitted when unavailable (for example, on a closed position with zero quantity)."""
+
+    price: Optional[str] = None
+    r"""Current market price per share or contract, returned as a decimal string. Omitted when unavailable (for example, on a closed position with zero quantity)."""
+
+    quantity: Optional[str] = None
+    r"""Current position quantity, returned as a decimal string. Positive values represent long positions. Negative values may represent short positions, depending on brokerage conventions."""
+
+    security_type: Annotated[
+        Optional[AccountPositionSecurityType], pydantic.Field(alias="securityType")
+    ] = None
+    r"""Indicates whether the position is an equity/stock position or an option position. Use this value to decide which position details and actions should be shown in the UI.
+    - `EQUITY` — a stock or ETF position.
+    - `OPTION` — an option contract position.
+    """
+
+    symbol: Optional[str] = None
+    r"""Symbol for the held instrument. Use this to link the position to quotes, charts, and research."""
+
+    today_pl: Annotated[Optional[str], pydantic.Field(alias="todayPl")] = None
+    r"""Profit or loss for the current trading day, returned as a decimal string."""
+
+    today_realized_pn_l: Annotated[
+        Optional[str], pydantic.Field(alias="todayRealizedPnL")
+    ] = None
+    r"""Profit or loss realized today from closed activity in this symbol, returned as a decimal string."""
+
+    unrealized_pl: Annotated[Optional[str], pydantic.Field(alias="unrealizedPl")] = None
+    r"""Profit or loss on the open position at current market prices, returned as a decimal string."""
+
+    @field_serializer("security_type")
+    def serialize_security_type(self, value):
+        if isinstance(value, str):
+            try:
+                return models.AccountPositionSecurityType(value)
+            except ValueError:
+                return value
+        return value
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(
+            [
+                "accountId",
+                "averagePrice",
+                "costBasis",
+                "createdAt",
+                "marketValue",
+                "price",
+                "quantity",
+                "securityType",
+                "symbol",
+                "todayPl",
+                "todayRealizedPnL",
+                "unrealizedPl",
+            ]
+        )
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+try:
+    AccountPosition.model_rebuild()
+except NameError:
+    pass