TradeAccount

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/alpaca/json-schema/alpaca-trade-account-schema.json",
  "title": "TradeAccount",
  "description": "This is an extended version of the Account model found [in the trading api](https://alpaca.markets/docs/api-references/trading-api/account/#account-entity).\n\nExtra data has been added that would be useful for brokers.",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/alpaca-us-broker-api-openapi.yml#/components/schemas/TradeAccount",
  "properties": {
    "account_blocked": {
      "description": "If true, the account activity by user is prohibited.",
      "type": "boolean"
    },
    "account_number": {
      "description": "The account number",
      "type": [
        "string",
        "null"
      ]
    },
    "accrued_fees": {
      "description": "Accrued fees",
      "format": "decimal",
      "type": "string"
    },
    "admin_configurations": {
      "$ref": "#/$defs/AdminConfigurations"
    },
    "balance_asof": {
      "description": "The date of the snapshot for `last_*` fields",
      "type": "string"
    },
    "buying_power": {
      "description": "Current available cash buying power. If multiplier = 2 then buying_power = max(equity-initial_margin(0) * 2). If multiplier = 1 then buying_power = cash.",
      "format": "decimal",
      "type": "string"
    },
    "cash": {
      "description": "Cash balance",
      "format": "decimal",
      "type": "string"
    },
    "cash_transferable": {
      "description": "Cash available for transfer (JNLC)",
      "type": "string"
    },
    "cash_withdrawable": {
      "description": "Cash available for withdrawal",
      "format": "decimal",
      "type": "string"
    },
    "clearing_broker": {
      "description": "Clearing broker",
      "type": "string"
    },
    "created_at": {
      "description": "Timestamp this account was created at",
      "type": "string"
    },
    "crypto_status": {
      "$ref": "#/$defs/AccountStatus"
    },
    "currency": {
      "description": "Always USD",
      "type": "string"
    },
    "effective_buying_power": {
      "description": "Effective buying power (duplicate of buying power)",
      "format": "decimal",
      "type": "string"
    },
    "equity": {
      "description": "cash + long_market_value + short_market_value",
      "format": "decimal",
      "type": "string"
    },
    "id": {
      "description": "The account ID",
      "format": "uuid",
      "type": "string"
    },
    "initial_margin": {
      "description": "Reg T initial margin requirement (continuously updated value)",
      "format": "decimal",
      "type": "string"
    },
    "intraday_adjustments": {
      "description": "The intraday adjustment by non_trade_activities such as fund deposit/withdraw.\n",
      "type": "string"
    },
    "last_buying_power": {
      "description": "Value of buying_power as of previous trading day at 16:00:00 ET",
      "type": "string"
    },
    "last_cash": {
      "description": "Value of all cash as of previous trading day at 16:00:00 ET",
      "type": "string"
    },
    "last_equity": {
      "description": "Equity as of previous trading day at 16:00:00 ET",
      "format": "decimal",
      "type": "string"
    },
    "last_initial_margin": {
      "description": "Value of Reg T margin as of previous trading day at 16:00:00 ET",
      "type": "string"
    },
    "last_long_market_value": {
      "description": "Value of all long positions as of previous trading day at 16:00:00 ET",
      "type": "string"
    },
    "last_maintenance_margin": {
      "description": "Maintenance margin requirement on the previous trading day",
      "format": "decimal",
      "type": "string"
    },
    "last_options_buying_power": {
      "description": "Value of option buying power as of previous trading day at 16:00:00 ET",
      "type": "string"
    },
    "last_regt_buying_power": {
      "description": "Value of Reg T buying power as of previous trading day at 16:00:00 ET",
      "type": "string"
    },
    "last_short_market_value": {
      "description": "Value of all short positions as of previous trading day at 16:00:00 ET",
      "type": "string"
    },
    "long_market_value": {
      "description": "Real-time MtM value of all long positions held in the account",
      "format": "decimal",
      "type": "string"
    },
    "maintenance_margin": {
      "description": "Maintenance margin requirement (continuously updated value)",
      "format": "decimal",
      "type": "string"
    },
    "memoposts": {
      "description": "Outstanding memopost value",
      "type": "string"
    },
    "multiplier": {
      "description": "\"1\", \"2\", \"3\", or \"4\"",
      "format": "decimal",
      "type": "string"
    },
    "non_marginable_buying_power": {
      "description": "Non-marginable buying power (currently used for only crypto trading)",
      "format": "decimal",
      "type": "string"
    },
    "options_approved_level": {
      "description": "The options trading level that was approved for this account.\n0=disabled, 1=Covered Call/Cash-Secured Put, 2=Long Call/Put, 3=Spreads/Straddles.\n",
      "enum": [
        0,
        1,
        2,
        3
      ],
      "type": "integer"
    },
    "options_buying_power": {
      "description": "Your buying power for options trading",
      "format": "decimal",
      "type": "string"
    },
    "options_trading_level": {
      "description": "The effective options trading level of the account.\nThis is the minimum between account options_approved_level and account configurations max_options_trading_level.\n0=disabled, 1=Covered Call/Cash-Secured Put, 2=Long Call/Put, 3=Spreads/Straddles.\n",
      "enum": [
        0,
        1,
        2,
        3
      ],
      "type": "integer"
    },
    "pending_reg_taf_fees": {
      "description": "Pending regulatory fees for the account.",
      "type": "string"
    },
    "pending_transfer_out": {
      "description": "Cash pending transfer out",
      "type": "string"
    },
    "portfolio_value": {
      "description": "Total value of cash + holding positions. (This field is deprecated. It is equivalent to the equity field.)",
      "format": "decimal",
      "type": "string"
    },
    "position_market_value": {
      "description": "Real-time MtM value of all the positions held in the account",
      "format": "decimal",
      "type": "string"
    },
    "previous_close": {
      "description": "Previous sessions close time",
      "type": "string"
    },
    "regt_buying_power": {
      "description": "User's buying power under Regulation T (excess equity - (equity - margin value) - * margin multiplier)",
      "format": "decimal",
      "type": "string"
    },
    "short_market_value": {
      "description": "Real-time MtM value of all short positions held in the account",
      "format": "decimal",
      "type": "string"
    },
    "shorting_enabled": {
      "description": "Flag to denote whether or not the account is permitted to short",
      "type": "boolean"
    },
    "sma": {
      "description": "Value of Special Memorandum Account (will be used at a later date to provide additional buying_power)",
      "format": "decimal",
      "type": "string"
    },
    "status": {
      "$ref": "#/$defs/AccountStatus"
    },
    "trade_suspended_by_user": {
      "description": "If true, the account is not allowed to place orders.",
      "type": "boolean"
    },
    "trading_blocked": {
      "description": "If true, the account is not allowed to place orders.",
      "type": "boolean"
    },
    "transfers_blocked": {
      "description": "If true, the account is not allowed to request money transfers.",
      "type": "boolean"
    },
    "user_configurations": {
      "anyOf": [
        {
          "$ref": "#/$defs/AccountConfigurations"
        },
        {
          "type": "null"
        }
      ],
      "description": "Custom user-level configuration overrides for this account.\n\nThis field is always present in the response, but its value will be `null` until user-level configurations have been explicitly set for the account."
    }
  },
  "required": [
    "id",
    "admin_configurations",
    "account_number",
    "status",
    "crypto_status",
    "currency",
    "buying_power",
    "regt_buying_power",
    "effective_buying_power",
    "non_marginable_buying_power",
    "accrued_fees",
    "portfolio_value",
    "trading_blocked",
    "transfers_blocked",
    "account_blocked",
    "created_at",
    "trade_suspended_by_user",
    "multiplier",
    "shorting_enabled",
    "equity",
    "last_equity",
    "long_market_value",
    "short_market_value",
    "position_market_value",
    "initial_margin",
    "maintenance_margin",
    "last_maintenance_margin",
    "sma",
    "balance_asof",
    "cash"
  ],
  "type": "object",
  "$defs": {
    "AccountConfigurations": {
      "description": "Represents additional configuration settings for an account",
      "properties": {
        "disable_overnight_trading": {
          "description": "If true, overnight trading is disabled.",
          "type": "boolean"
        },
        "fractional_trading": {
          "description": "If true, account is able to participate in fractional trading",
          "type": "boolean"
        },
        "max_margin_multiplier": {
          "description": "Can be \"1\" or \"2\"",
          "type": "string"
        },
        "max_options_trading_level": {
          "description": "The desired maximum options trading level. 0=disabled, 1=Covered Call/Cash-Secured Put, 2=Long Call/Put, 3=Spreads/Straddles.",
          "enum": [
            0,
            1,
            2,
            3
          ],
          "type": "integer"
        },
        "no_shorting": {
          "description": "If true, account becomes long-only mode.",
          "type": "boolean"
        },
        "ptp_no_exception_entry": {
          "description": "If set to true then Alpaca will accept orders for PTP symbols with no exception. Default is false.",
          "type": "boolean"
        },
        "suspend_trade": {
          "description": "If true, new orders are blocked.",
          "type": "boolean"
        },
        "trade_confirm_email": {
          "description": "all or none. If none, emails for order fills are not sent.",
          "enum": [
            "all",
            "none"
          ],
          "type": "string"
        }
      },
      "title": "AccountConfigurations",
      "type": "object"
    },
    "AccountStatus": {
      "description": "Designates the current status of this account\n\nPossible Values:\n- **INACTIVE**\nAccount not set to trade given asset.\n- **PAPER_ONLY**\nThe account is limited to paper trading.\n- **ONBOARDING**\nAn application is expected for this user, but has not been submitted yet.\n- **SUBMITTED**\nThe application has been submitted and is being processed.\n- **SUBMISSION_FAILED**\nUsed to display if failure on submission\n- **ACTION_REQUIRED**\nThe application requires manual action.\n- **ACCOUNT_UPDATED**\nUsed to display when Account has been modified by user\n- **APPROVAL_PENDING**\nInitial value. The application approval process is in progress.\n- **APPROVED**\nThe account application has been approved, and waiting to be ACTIVE\n- **REJECTED**\nThe account application is rejected for some reason\n- **ACTIVE**\nThe account is fully active. Trading and funding are processed under this status.\n- **ACCOUNT_CLOSED**\nThe account is closed.\n",
      "enum": [
        "INACTIVE",
        "PAPER_ONLY",
        "ONBOARDING",
        "SUBMITTED",
        "SUBMISSION_FAILED",
        "ACTION_REQUIRED",
        "ACCOUNT_UPDATED",
        "APPROVAL_PENDING",
        "APPROVED",
        "REJECTED",
        "ACTIVE",
        "ACCOUNT_CLOSED"
      ],
      "type": "string"
    },
    "AdminConfigurations": {
      "description": "These configurations show account properties that are overridden either by Alpaca Broker Operations or an automated process.\n\nThese values cannot be modified by the Broker Partners.\n\nThis schema represents the current, effective value of each configuration (e.g. as returned by the get trading account endpoint). For the shape of the payloads broadcast by the **events** streaming API when these values change, see [AdminConfigurationsEvent](#/components/schemas/AdminConfigurationsEvent).",
      "properties": {
        "acct_daily_transfer_limit": {
          "description": "Override the correspondent level daily transfer limits",
          "format": "decimal",
          "type": "string"
        },
        "allow_instant_ach": {
          "description": "If true, the account is allowed to perform instant ACH",
          "type": "boolean"
        },
        "disable_algodash_access": {
          "description": "If true, the account is allowed to access algo dash",
          "type": "boolean"
        },
        "disable_api_key": {
          "description": "If true, the account's API key will be disabled",
          "type": "boolean"
        },
        "disable_crypto": {
          "description": "If true, the account is not allowed to trade cryptos",
          "type": "boolean"
        },
        "disable_day_trading": {
          "description": "If true, the account is not allowed to day trade (e.g. buy and sell the same security on the same day)",
          "type": "boolean"
        },
        "disable_fractional": {
          "description": "If true, the account cannot create orders for fractional share positions",
          "type": "boolean"
        },
        "disable_shorting": {
          "description": "If true the account is not allowed to create short position orders",
          "type": "boolean"
        },
        "incoming_transfers_blocked": {
          "description": "If true, incoming transfers to this account are rejected",
          "type": "boolean"
        },
        "max_margin_multiplier": {
          "description": "The max margin multiplier set by admin for this account. Can be \"1\", \"2\", or \"4\".",
          "type": "string"
        },
        "max_options_trading_level": {
          "description": "The max options trading level set by admin for this account.\n0=disabled, 1=Covered Call/Cash-Secured Put, 2=Long Call/Put, 3=Spreads/Straddles.\n",
          "enum": [
            0,
            1,
            2,
            3
          ],
          "type": "integer"
        },
        "outgoing_transfers_blocked": {
          "description": "If true, outgoing transfers from this account are rejected",
          "type": "boolean"
        },
        "restrict_to_liquidation_reasons": {
          "$ref": "#/$defs/RestrictToLiquidationReasons"
        }
      },
      "title": "AdminConfigurations",
      "type": "object"
    },
    "RestrictToLiquidationReasons": {
      "description": "Reasons why the liquidation only flag was set",
      "properties": {
        "ach_return": {
          "description": "Set when an incoming ACH transfer gets rejected",
          "type": "boolean"
        },
        "position_to_equity_ratio": {
          "description": "Set when the position to equity ration exceeds the maximum limit",
          "type": "boolean"
        },
        "unspecified": {
          "description": "Default value for unknown reason",
          "type": "boolean"
        }
      },
      "title": "RestrictToLiquidationReasons",
      "type": "object"
    }
  }
}