snaptrade 1.17.10 → 2.0.77

data/lib/snaptrade/api/trading_api.rb

@@ -5,7 +5,6 @@
 
 The version of the OpenAPI document: 1.0.0
 Contact: api@snaptrade.com
-
 =end
 
 require 'cgi'
@@ -18,12 +17,15 @@ module SnapTrade
       @api_client = api_client
     end
 
-    # Cancel open order in account
+    # Cancel order
+    #
+    # Attempts to cancel an open order with the brokerage. If the order is no longer cancellable, the request will be rejected.
+    #
     # @param user_id [String] 
     # @param user_secret [String] 
-    # @param account_id [String] The ID of the account to cancel the order in.
-    # @param brokerage_order_id [String] 
-    # @param body [TradingCancelUserAccountOrderRequest] The Order ID to be canceled
+    # @param account_id [String] 
+    # @param brokerage_order_id [String] Order ID returned by brokerage. This is the unique identifier for the order in the brokerage system.
+    # @param body [TradingCancelUserAccountOrderRequest] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
     def cancel_user_account_order(user_id:, user_secret:, account_id:, brokerage_order_id: SENTINEL, extra: {})
       _body = {}
@@ -33,12 +35,15 @@ module SnapTrade
       data
     end
 
-    # Cancel open order in account
+    # Cancel order
+    #
+    # Attempts to cancel an open order with the brokerage. If the order is no longer cancellable, the request will be rejected.
+    #
     # @param user_id [String] 
     # @param user_secret [String] 
-    # @param account_id [String] The ID of the account to cancel the order in.
-    # @param brokerage_order_id [String] 
-    # @param body [TradingCancelUserAccountOrderRequest] The Order ID to be canceled
+    # @param account_id [String] 
+    # @param brokerage_order_id [String] Order ID returned by brokerage. This is the unique identifier for the order in the brokerage system.
+    # @param body [TradingCancelUserAccountOrderRequest] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
     def cancel_user_account_order_with_http_info(user_id:, user_secret:, account_id:, brokerage_order_id: SENTINEL, extra: {})
       _body = {}
@@ -47,26 +52,28 @@ module SnapTrade
       cancel_user_account_order_with_http_info_impl(user_id, user_secret, account_id, trading_cancel_user_account_order_request, extra)
     end
 
-    # Cancel open order in account
+    # Cancel order
+    # Attempts to cancel an open order with the brokerage. If the order is no longer cancellable, the request will be rejected. 
     # @param user_id [String] 
     # @param user_secret [String] 
-    # @param account_id [String] The ID of the account to cancel the order in.
-    # @param trading_cancel_user_account_order_request [TradingCancelUserAccountOrderRequest] The Order ID to be canceled
+    # @param account_id [String] 
+    # @param trading_cancel_user_account_order_request [TradingCancelUserAccountOrderRequest] 
     # @param [Hash] opts the optional parameters
     # @return [AccountOrderRecord]
-    def cancel_user_account_order_impl(user_id, user_secret, account_id, trading_cancel_user_account_order_request, opts = {})
+    private def cancel_user_account_order_impl(user_id, user_secret, account_id, trading_cancel_user_account_order_request, opts = {})
       data, _status_code, _headers = cancel_user_account_order_with_http_info(user_id, user_secret, account_id, trading_cancel_user_account_order_request, opts)
       data
     end
 
-    # Cancel open order in account
+    # Cancel order
+    # Attempts to cancel an open order with the brokerage. If the order is no longer cancellable, the request will be rejected. 
     # @param user_id [String] 
     # @param user_secret [String] 
-    # @param account_id [String] The ID of the account to cancel the order in.
-    # @param trading_cancel_user_account_order_request [TradingCancelUserAccountOrderRequest] The Order ID to be canceled
+    # @param account_id [String] 
+    # @param trading_cancel_user_account_order_request [TradingCancelUserAccountOrderRequest] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(AccountOrderRecord, Integer, Hash)>] AccountOrderRecord data, response status code and response headers
-    def cancel_user_account_order_with_http_info_impl(user_id, user_secret, account_id, trading_cancel_user_account_order_request, opts = {})
+    private def cancel_user_account_order_with_http_info_impl(user_id, user_secret, account_id, trading_cancel_user_account_order_request, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: TradingApi.cancel_user_account_order ...'
       end
@@ -134,83 +141,91 @@ module SnapTrade
     end
 
 
-    # Check impact of trades on account.
+    # Check order impact
+    #
+    # Simulates an order and its impact on the account. This endpoint does not place the order with the brokerage. If successful, it returns a `Trade` object and the ID of the object can be used to place the order with the brokerage using the [place checked order endpoint](/reference/Trading/Trading_placeOrder). Please note that the `Trade` object returned expires after 5 minutes. Any order placed using an expired `Trade` will be rejected.
+    #
+    # @param account_id [String] Unique identifier for the connected brokerage account. This is the UUID used to reference the account in SnapTrade.
+    # @param action [ActionStrict] The action describes the intent or side of a trade. This is either `BUY` or `SELL`.
+    # @param universal_symbol_id [String] Unique identifier for the symbol within SnapTrade. This is the ID used to reference the symbol in SnapTrade API calls.
+    # @param order_type [OrderTypeStrict] The type of order to place. - For `Limit` and `StopLimit` orders, the `price` field is required. - For `Stop` and `StopLimit` orders, the `stop` field is required. 
+    # @param time_in_force [TimeInForceStrict] The Time in Force type for the order. This field indicates how long the order will remain active before it is executed or expires. Here are the supported values: - `Day` - Day. The order is valid only for the trading day on which it is placed. - `GTC` - Good Til Canceled. The order is valid until it is executed or canceled. - `FOK` - Fill Or Kill. The order must be executed in its entirety immediately or be canceled completely. 
     # @param user_id [String] 
     # @param user_secret [String] 
-    # @param account_id [String] 
-    # @param action [Action] 
-    # @param order_type [OrderType] 
-    # @param price [Float] Trade Price if limit or stop limit order
-    # @param stop [Float] Stop Price. If stop loss or stop limit order, the price to trigger the stop
-    # @param time_in_force [TimeInForce] 
-    # @param units [Float] Trade Units. Cannot work with notional value.
-    # @param universal_symbol_id [String] 
-    # @param notional_value [Float] Dollar amount to trade. Cannot work with units. Can only work for market order types and day for time in force.
+    # @param price [Float] The limit price for `Limit` and `StopLimit` orders.
+    # @param stop [Float] The price at which a stop order is triggered for `Stop` and `StopLimit` orders.
+    # @param units [Float] 
+    # @param notional_value [ManualTradeFormNotionalValue] 
     # @param body [ManualTradeForm] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def get_order_impact(user_id:, user_secret:, account_id: SENTINEL, action: SENTINEL, order_type: SENTINEL, price: SENTINEL, stop: SENTINEL, time_in_force: SENTINEL, units: SENTINEL, universal_symbol_id: SENTINEL, notional_value: SENTINEL, extra: {})
+    def get_order_impact(account_id:, action:, universal_symbol_id:, order_type:, time_in_force:, user_id:, user_secret:, price: SENTINEL, stop: SENTINEL, units: SENTINEL, notional_value: SENTINEL, extra: {})
       _body = {}
       _body[:account_id] = account_id if account_id != SENTINEL
       _body[:action] = action if action != SENTINEL
+      _body[:universal_symbol_id] = universal_symbol_id if universal_symbol_id != SENTINEL
       _body[:order_type] = order_type if order_type != SENTINEL
+      _body[:time_in_force] = time_in_force if time_in_force != SENTINEL
       _body[:price] = price if price != SENTINEL
       _body[:stop] = stop if stop != SENTINEL
-      _body[:time_in_force] = time_in_force if time_in_force != SENTINEL
       _body[:units] = units if units != SENTINEL
-      _body[:universal_symbol_id] = universal_symbol_id if universal_symbol_id != SENTINEL
       _body[:notional_value] = notional_value if notional_value != SENTINEL
       manual_trade_form = _body
       data, _status_code, _headers = get_order_impact_with_http_info_impl(user_id, user_secret, manual_trade_form, extra)
       data
     end
 
-    # Check impact of trades on account.
+    # Check order impact
+    #
+    # Simulates an order and its impact on the account. This endpoint does not place the order with the brokerage. If successful, it returns a `Trade` object and the ID of the object can be used to place the order with the brokerage using the [place checked order endpoint](/reference/Trading/Trading_placeOrder). Please note that the `Trade` object returned expires after 5 minutes. Any order placed using an expired `Trade` will be rejected.
+    #
+    # @param account_id [String] Unique identifier for the connected brokerage account. This is the UUID used to reference the account in SnapTrade.
+    # @param action [ActionStrict] The action describes the intent or side of a trade. This is either `BUY` or `SELL`.
+    # @param universal_symbol_id [String] Unique identifier for the symbol within SnapTrade. This is the ID used to reference the symbol in SnapTrade API calls.
+    # @param order_type [OrderTypeStrict] The type of order to place. - For `Limit` and `StopLimit` orders, the `price` field is required. - For `Stop` and `StopLimit` orders, the `stop` field is required. 
+    # @param time_in_force [TimeInForceStrict] The Time in Force type for the order. This field indicates how long the order will remain active before it is executed or expires. Here are the supported values: - `Day` - Day. The order is valid only for the trading day on which it is placed. - `GTC` - Good Til Canceled. The order is valid until it is executed or canceled. - `FOK` - Fill Or Kill. The order must be executed in its entirety immediately or be canceled completely. 
     # @param user_id [String] 
     # @param user_secret [String] 
-    # @param account_id [String] 
-    # @param action [Action] 
-    # @param order_type [OrderType] 
-    # @param price [Float] Trade Price if limit or stop limit order
-    # @param stop [Float] Stop Price. If stop loss or stop limit order, the price to trigger the stop
-    # @param time_in_force [TimeInForce] 
-    # @param units [Float] Trade Units. Cannot work with notional value.
-    # @param universal_symbol_id [String] 
-    # @param notional_value [Float] Dollar amount to trade. Cannot work with units. Can only work for market order types and day for time in force.
+    # @param price [Float] The limit price for `Limit` and `StopLimit` orders.
+    # @param stop [Float] The price at which a stop order is triggered for `Stop` and `StopLimit` orders.
+    # @param units [Float] 
+    # @param notional_value [ManualTradeFormNotionalValue] 
     # @param body [ManualTradeForm] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def get_order_impact_with_http_info(user_id:, user_secret:, account_id: SENTINEL, action: SENTINEL, order_type: SENTINEL, price: SENTINEL, stop: SENTINEL, time_in_force: SENTINEL, units: SENTINEL, universal_symbol_id: SENTINEL, notional_value: SENTINEL, extra: {})
+    def get_order_impact_with_http_info(account_id:, action:, universal_symbol_id:, order_type:, time_in_force:, user_id:, user_secret:, price: SENTINEL, stop: SENTINEL, units: SENTINEL, notional_value: SENTINEL, extra: {})
       _body = {}
       _body[:account_id] = account_id if account_id != SENTINEL
       _body[:action] = action if action != SENTINEL
+      _body[:universal_symbol_id] = universal_symbol_id if universal_symbol_id != SENTINEL
       _body[:order_type] = order_type if order_type != SENTINEL
+      _body[:time_in_force] = time_in_force if time_in_force != SENTINEL
       _body[:price] = price if price != SENTINEL
       _body[:stop] = stop if stop != SENTINEL
-      _body[:time_in_force] = time_in_force if time_in_force != SENTINEL
       _body[:units] = units if units != SENTINEL
-      _body[:universal_symbol_id] = universal_symbol_id if universal_symbol_id != SENTINEL
       _body[:notional_value] = notional_value if notional_value != SENTINEL
       manual_trade_form = _body
       get_order_impact_with_http_info_impl(user_id, user_secret, manual_trade_form, extra)
     end
 
-    # Check impact of trades on account.
+    # Check order impact
+    # Simulates an order and its impact on the account. This endpoint does not place the order with the brokerage. If successful, it returns a `Trade` object and the ID of the object can be used to place the order with the brokerage using the [place checked order endpoint](/reference/Trading/Trading_placeOrder). Please note that the `Trade` object returned expires after 5 minutes. Any order placed using an expired `Trade` will be rejected.
     # @param user_id [String] 
     # @param user_secret [String] 
     # @param manual_trade_form [ManualTradeForm] 
     # @param [Hash] opts the optional parameters
     # @return [ManualTradeAndImpact]
-    def get_order_impact_impl(user_id, user_secret, manual_trade_form, opts = {})
+    private def get_order_impact_impl(user_id, user_secret, manual_trade_form, opts = {})
       data, _status_code, _headers = get_order_impact_with_http_info(user_id, user_secret, manual_trade_form, opts)
       data
     end
 
-    # Check impact of trades on account.
+    # Check order impact
+    # Simulates an order and its impact on the account. This endpoint does not place the order with the brokerage. If successful, it returns a &#x60;Trade&#x60; object and the ID of the object can be used to place the order with the brokerage using the [place checked order endpoint](/reference/Trading/Trading_placeOrder). Please note that the &#x60;Trade&#x60; object returned expires after 5 minutes. Any order placed using an expired &#x60;Trade&#x60; will be rejected.
     # @param user_id [String] 
     # @param user_secret [String] 
     # @param manual_trade_form [ManualTradeForm] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(ManualTradeAndImpact, Integer, Hash)>] ManualTradeAndImpact data, response status code and response headers
-    def get_order_impact_with_http_info_impl(user_id, user_secret, manual_trade_form, opts = {})
+    private def get_order_impact_with_http_info_impl(user_id, user_secret, manual_trade_form, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: TradingApi.get_order_impact ...'
       end
@@ -275,11 +290,14 @@ module SnapTrade
 
 
     # Get symbol quotes
+    #
+    # Returns quotes from the brokerage for the specified symbols and account. The quotes returned can be delayed depending on the brokerage the account belongs to. It is highly recommended that you use your own market data provider for real-time quotes instead of relying on this endpoint. This endpoint does not work for options quotes.
+    #
     # @param user_id [String] 
     # @param user_secret [String] 
-    # @param symbols [String] List of universal_symbol_id or tickers to get quotes for.
-    # @param account_id [String] The ID of the account to get quotes.
-    # @param use_ticker [Boolean] Should be set to True if providing tickers.
+    # @param symbols [String] List of Universal Symbol IDs or tickers to get quotes for. When providing multiple values, use a comma as separator
+    # @param account_id [String] 
+    # @param use_ticker [Boolean] Should be set to `True` if `symbols` are comprised of tickers. Defaults to `False` if not provided.
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
     def get_user_account_quotes(user_id:, user_secret:, symbols:, account_id:, use_ticker: SENTINEL, extra: {})
       extra[:use_ticker] = use_ticker if use_ticker != SENTINEL
@@ -288,11 +306,14 @@ module SnapTrade
     end
 
     # Get symbol quotes
+    #
+    # Returns quotes from the brokerage for the specified symbols and account. The quotes returned can be delayed depending on the brokerage the account belongs to. It is highly recommended that you use your own market data provider for real-time quotes instead of relying on this endpoint. This endpoint does not work for options quotes.
+    #
     # @param user_id [String] 
     # @param user_secret [String] 
-    # @param symbols [String] List of universal_symbol_id or tickers to get quotes for.
-    # @param account_id [String] The ID of the account to get quotes.
-    # @param use_ticker [Boolean] Should be set to True if providing tickers.
+    # @param symbols [String] List of Universal Symbol IDs or tickers to get quotes for. When providing multiple values, use a comma as separator
+    # @param account_id [String] 
+    # @param use_ticker [Boolean] Should be set to `True` if `symbols` are comprised of tickers. Defaults to `False` if not provided.
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
     def get_user_account_quotes_with_http_info(user_id:, user_secret:, symbols:, account_id:, use_ticker: SENTINEL, extra: {})
       extra[:use_ticker] = use_ticker if use_ticker != SENTINEL
@@ -300,27 +321,29 @@ module SnapTrade
     end
 
     # Get symbol quotes
+    # Returns quotes from the brokerage for the specified symbols and account. The quotes returned can be delayed depending on the brokerage the account belongs to. It is highly recommended that you use your own market data provider for real-time quotes instead of relying on this endpoint. This endpoint does not work for options quotes.
     # @param user_id [String] 
     # @param user_secret [String] 
-    # @param symbols [String] List of universal_symbol_id or tickers to get quotes for.
-    # @param account_id [String] The ID of the account to get quotes.
+    # @param symbols [String] List of Universal Symbol IDs or tickers to get quotes for. When providing multiple values, use a comma as separator
+    # @param account_id [String] 
     # @param [Hash] opts the optional parameters
-    # @option opts [Boolean] :use_ticker Should be set to True if providing tickers.
+    # @option opts [Boolean] :use_ticker Should be set to `True` if `symbols` are comprised of tickers. Defaults to `False` if not provided.
     # @return [Array<SymbolsQuotesInner>]
-    def get_user_account_quotes_impl(user_id, user_secret, symbols, account_id, opts = {})
+    private def get_user_account_quotes_impl(user_id, user_secret, symbols, account_id, opts = {})
       data, _status_code, _headers = get_user_account_quotes_with_http_info(user_id, user_secret, symbols, account_id, opts)
       data
     end
 
     # Get symbol quotes
+    # Returns quotes from the brokerage for the specified symbols and account. The quotes returned can be delayed depending on the brokerage the account belongs to. It is highly recommended that you use your own market data provider for real-time quotes instead of relying on this endpoint. This endpoint does not work for options quotes.
     # @param user_id [String] 
     # @param user_secret [String] 
-    # @param symbols [String] List of universal_symbol_id or tickers to get quotes for.
-    # @param account_id [String] The ID of the account to get quotes.
+    # @param symbols [String] List of Universal Symbol IDs or tickers to get quotes for. When providing multiple values, use a comma as separator
+    # @param account_id [String] 
     # @param [Hash] opts the optional parameters
-    # @option opts [Boolean] :use_ticker Should be set to True if providing tickers.
+    # @option opts [Boolean] :use_ticker Should be set to `True` if `symbols` are comprised of tickers. Defaults to `False` if not provided.
     # @return [Array<(Array<SymbolsQuotesInner>, Integer, Hash)>] Array<SymbolsQuotesInner> data, response status code and response headers
-    def get_user_account_quotes_with_http_info_impl(user_id, user_secret, symbols, account_id, opts = {})
+    private def get_user_account_quotes_with_http_info_impl(user_id, user_secret, symbols, account_id, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: TradingApi.get_user_account_quotes ...'
       end
@@ -385,83 +408,115 @@ module SnapTrade
     end
 
 
-    # Place a trade with NO validation.
+    # Place order
+    #
+    # Places a brokerage order in the specified account. The order could be rejected by the brokerage if it is invalid or if the account does not have sufficient funds.
+    # 
+    # This endpoint does not compute the impact to the account balance from the order and any potential commissions before submitting the order to the brokerage. If that is desired, you can use the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact).
+    # 
+    # It's recommended to trigger a manual refresh of the account after placing an order to ensure the account is up to date. You can use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint for this.
+    #
+    # @param account_id [String] Unique identifier for the connected brokerage account. This is the UUID used to reference the account in SnapTrade.
+    # @param action [ActionStrictWithOptions] The action describes the intent or side of a trade. This is either `BUY` or `SELL` for Equity symbols or `BUY_TO_OPEN`, `BUY_TO_CLOSE`, `SELL_TO_OPEN` or `SELL_TO_CLOSE` for Options.
+    # @param order_type [OrderTypeStrict] The type of order to place. - For `Limit` and `StopLimit` orders, the `price` field is required. - For `Stop` and `StopLimit` orders, the `stop` field is required. 
+    # @param time_in_force [TimeInForceStrict] The Time in Force type for the order. This field indicates how long the order will remain active before it is executed or expires. Here are the supported values: - `Day` - Day. The order is valid only for the trading day on which it is placed. - `GTC` - Good Til Canceled. The order is valid until it is executed or canceled. - `FOK` - Fill Or Kill. The order must be executed in its entirety immediately or be canceled completely. 
     # @param user_id [String] 
     # @param user_secret [String] 
-    # @param account_id [String] 
-    # @param action [Action] 
-    # @param order_type [OrderType] 
-    # @param price [Float] Trade Price if limit or stop limit order
-    # @param stop [Float] Stop Price. If stop loss or stop limit order, the price to trigger the stop
-    # @param time_in_force [TimeInForce] 
-    # @param units [Float] Trade Units. Cannot work with notional value.
-    # @param universal_symbol_id [String] 
-    # @param notional_value [Float] Dollar amount to trade. Cannot work with units. Can only work for market order types and day for time in force.
-    # @param body [ManualTradeForm] 
+    # @param universal_symbol_id [String] The universal symbol ID of the security to trade. Must be 'null' if `symbol` is provided, otherwise must be provided.
+    # @param symbol [String] The security's trading ticker symbol. This currently only support Options symbols in the 21 character OCC format. For example \"AAPL 131124C00240000\" represents a call option on AAPL expiring on 2024-11-13 with a strike price of $240. For more information on the OCC format, see [here](https://en.wikipedia.org/wiki/Option_symbol#OCC_format). If 'symbol' is provided, then 'universal_symbol_id' must be 'null'.
+    # @param price [Float] The limit price for `Limit` and `StopLimit` orders.
+    # @param stop [Float] The price at which a stop order is triggered for `Stop` and `StopLimit` orders.
+    # @param units [Float] For Equity orders, this represents the number of shares for the order. This can be a decimal for fractional orders. Must be `null` if `notional_value` is provided. If placing an Option order, this field represents the number of contracts to buy or sell. (e.g., 1 contract = 100 shares).
+    # @param notional_value [ManualTradeFormNotionalValue] 
+    # @param order_class [OrderClass] The class of order intended to be placed. Defaults to SIMPLE for regular, one legged trades. Set to BRACKET if looking to place a bracket (One-triggers-a-one-cancels-the-other) order, then specify take profit and stop loss conditions. Bracket orders currently only supported on Alpaca, Tradier, and Tradestation, contact us for more details
+    # @param stop_loss [ManualTradeFormWithOptionsStopLoss] 
+    # @param take_profit [ManualTradeFormWithOptionsTakeProfit] 
+    # @param body [ManualTradeFormWithOptions] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def place_force_order(user_id:, user_secret:, account_id: SENTINEL, action: SENTINEL, order_type: SENTINEL, price: SENTINEL, stop: SENTINEL, time_in_force: SENTINEL, units: SENTINEL, universal_symbol_id: SENTINEL, notional_value: SENTINEL, extra: {})
+    def place_force_order(account_id:, action:, order_type:, time_in_force:, user_id:, user_secret:, universal_symbol_id: SENTINEL, symbol: SENTINEL, price: SENTINEL, stop: SENTINEL, units: SENTINEL, notional_value: SENTINEL, order_class: SENTINEL, stop_loss: SENTINEL, take_profit: SENTINEL, extra: {})
       _body = {}
       _body[:account_id] = account_id if account_id != SENTINEL
       _body[:action] = action if action != SENTINEL
+      _body[:universal_symbol_id] = universal_symbol_id if universal_symbol_id != SENTINEL
+      _body[:symbol] = symbol if symbol != SENTINEL
       _body[:order_type] = order_type if order_type != SENTINEL
+      _body[:time_in_force] = time_in_force if time_in_force != SENTINEL
       _body[:price] = price if price != SENTINEL
       _body[:stop] = stop if stop != SENTINEL
-      _body[:time_in_force] = time_in_force if time_in_force != SENTINEL
       _body[:units] = units if units != SENTINEL
-      _body[:universal_symbol_id] = universal_symbol_id if universal_symbol_id != SENTINEL
       _body[:notional_value] = notional_value if notional_value != SENTINEL
-      manual_trade_form = _body
-      data, _status_code, _headers = place_force_order_with_http_info_impl(user_id, user_secret, manual_trade_form, extra)
+      _body[:order_class] = order_class if order_class != SENTINEL
+      _body[:stop_loss] = stop_loss if stop_loss != SENTINEL
+      _body[:take_profit] = take_profit if take_profit != SENTINEL
+      manual_trade_form_with_options = _body
+      data, _status_code, _headers = place_force_order_with_http_info_impl(user_id, user_secret, manual_trade_form_with_options, extra)
       data
     end
 
-    # Place a trade with NO validation.
+    # Place order
+    #
+    # Places a brokerage order in the specified account. The order could be rejected by the brokerage if it is invalid or if the account does not have sufficient funds.
+    # 
+    # This endpoint does not compute the impact to the account balance from the order and any potential commissions before submitting the order to the brokerage. If that is desired, you can use the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact).
+    # 
+    # It's recommended to trigger a manual refresh of the account after placing an order to ensure the account is up to date. You can use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint for this.
+    #
+    # @param account_id [String] Unique identifier for the connected brokerage account. This is the UUID used to reference the account in SnapTrade.
+    # @param action [ActionStrictWithOptions] The action describes the intent or side of a trade. This is either `BUY` or `SELL` for Equity symbols or `BUY_TO_OPEN`, `BUY_TO_CLOSE`, `SELL_TO_OPEN` or `SELL_TO_CLOSE` for Options.
+    # @param order_type [OrderTypeStrict] The type of order to place. - For `Limit` and `StopLimit` orders, the `price` field is required. - For `Stop` and `StopLimit` orders, the `stop` field is required. 
+    # @param time_in_force [TimeInForceStrict] The Time in Force type for the order. This field indicates how long the order will remain active before it is executed or expires. Here are the supported values: - `Day` - Day. The order is valid only for the trading day on which it is placed. - `GTC` - Good Til Canceled. The order is valid until it is executed or canceled. - `FOK` - Fill Or Kill. The order must be executed in its entirety immediately or be canceled completely. 
     # @param user_id [String] 
     # @param user_secret [String] 
-    # @param account_id [String] 
-    # @param action [Action] 
-    # @param order_type [OrderType] 
-    # @param price [Float] Trade Price if limit or stop limit order
-    # @param stop [Float] Stop Price. If stop loss or stop limit order, the price to trigger the stop
-    # @param time_in_force [TimeInForce] 
-    # @param units [Float] Trade Units. Cannot work with notional value.
-    # @param universal_symbol_id [String] 
-    # @param notional_value [Float] Dollar amount to trade. Cannot work with units. Can only work for market order types and day for time in force.
-    # @param body [ManualTradeForm] 
+    # @param universal_symbol_id [String] The universal symbol ID of the security to trade. Must be 'null' if `symbol` is provided, otherwise must be provided.
+    # @param symbol [String] The security's trading ticker symbol. This currently only support Options symbols in the 21 character OCC format. For example \"AAPL 131124C00240000\" represents a call option on AAPL expiring on 2024-11-13 with a strike price of $240. For more information on the OCC format, see [here](https://en.wikipedia.org/wiki/Option_symbol#OCC_format). If 'symbol' is provided, then 'universal_symbol_id' must be 'null'.
+    # @param price [Float] The limit price for `Limit` and `StopLimit` orders.
+    # @param stop [Float] The price at which a stop order is triggered for `Stop` and `StopLimit` orders.
+    # @param units [Float] For Equity orders, this represents the number of shares for the order. This can be a decimal for fractional orders. Must be `null` if `notional_value` is provided. If placing an Option order, this field represents the number of contracts to buy or sell. (e.g., 1 contract = 100 shares).
+    # @param notional_value [ManualTradeFormNotionalValue] 
+    # @param order_class [OrderClass] The class of order intended to be placed. Defaults to SIMPLE for regular, one legged trades. Set to BRACKET if looking to place a bracket (One-triggers-a-one-cancels-the-other) order, then specify take profit and stop loss conditions. Bracket orders currently only supported on Alpaca, Tradier, and Tradestation, contact us for more details
+    # @param stop_loss [ManualTradeFormWithOptionsStopLoss] 
+    # @param take_profit [ManualTradeFormWithOptionsTakeProfit] 
+    # @param body [ManualTradeFormWithOptions] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def place_force_order_with_http_info(user_id:, user_secret:, account_id: SENTINEL, action: SENTINEL, order_type: SENTINEL, price: SENTINEL, stop: SENTINEL, time_in_force: SENTINEL, units: SENTINEL, universal_symbol_id: SENTINEL, notional_value: SENTINEL, extra: {})
+    def place_force_order_with_http_info(account_id:, action:, order_type:, time_in_force:, user_id:, user_secret:, universal_symbol_id: SENTINEL, symbol: SENTINEL, price: SENTINEL, stop: SENTINEL, units: SENTINEL, notional_value: SENTINEL, order_class: SENTINEL, stop_loss: SENTINEL, take_profit: SENTINEL, extra: {})
       _body = {}
       _body[:account_id] = account_id if account_id != SENTINEL
       _body[:action] = action if action != SENTINEL
+      _body[:universal_symbol_id] = universal_symbol_id if universal_symbol_id != SENTINEL
+      _body[:symbol] = symbol if symbol != SENTINEL
       _body[:order_type] = order_type if order_type != SENTINEL
+      _body[:time_in_force] = time_in_force if time_in_force != SENTINEL
       _body[:price] = price if price != SENTINEL
       _body[:stop] = stop if stop != SENTINEL
-      _body[:time_in_force] = time_in_force if time_in_force != SENTINEL
       _body[:units] = units if units != SENTINEL
-      _body[:universal_symbol_id] = universal_symbol_id if universal_symbol_id != SENTINEL
       _body[:notional_value] = notional_value if notional_value != SENTINEL
-      manual_trade_form = _body
-      place_force_order_with_http_info_impl(user_id, user_secret, manual_trade_form, extra)
+      _body[:order_class] = order_class if order_class != SENTINEL
+      _body[:stop_loss] = stop_loss if stop_loss != SENTINEL
+      _body[:take_profit] = take_profit if take_profit != SENTINEL
+      manual_trade_form_with_options = _body
+      place_force_order_with_http_info_impl(user_id, user_secret, manual_trade_form_with_options, extra)
     end
 
-    # Place a trade with NO validation.
+    # Place order
+    # Places a brokerage order in the specified account. The order could be rejected by the brokerage if it is invalid or if the account does not have sufficient funds.  This endpoint does not compute the impact to the account balance from the order and any potential commissions before submitting the order to the brokerage. If that is desired, you can use the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact).  It's recommended to trigger a manual refresh of the account after placing an order to ensure the account is up to date. You can use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint for this. 
     # @param user_id [String] 
     # @param user_secret [String] 
-    # @param manual_trade_form [ManualTradeForm] 
+    # @param manual_trade_form_with_options [ManualTradeFormWithOptions] 
     # @param [Hash] opts the optional parameters
     # @return [AccountOrderRecord]
-    def place_force_order_impl(user_id, user_secret, manual_trade_form, opts = {})
-      data, _status_code, _headers = place_force_order_with_http_info(user_id, user_secret, manual_trade_form, opts)
+    private def place_force_order_impl(user_id, user_secret, manual_trade_form_with_options, opts = {})
+      data, _status_code, _headers = place_force_order_with_http_info(user_id, user_secret, manual_trade_form_with_options, opts)
       data
     end
 
-    # Place a trade with NO validation.
+    # Place order
+    # Places a brokerage order in the specified account. The order could be rejected by the brokerage if it is invalid or if the account does not have sufficient funds.  This endpoint does not compute the impact to the account balance from the order and any potential commissions before submitting the order to the brokerage. If that is desired, you can use the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact).  It&#39;s recommended to trigger a manual refresh of the account after placing an order to ensure the account is up to date. You can use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint for this. 
     # @param user_id [String] 
     # @param user_secret [String] 
-    # @param manual_trade_form [ManualTradeForm] 
+    # @param manual_trade_form_with_options [ManualTradeFormWithOptions] 
     # @param [Hash] opts the optional parameters
     # @return [Array<(AccountOrderRecord, Integer, Hash)>] AccountOrderRecord data, response status code and response headers
-    def place_force_order_with_http_info_impl(user_id, user_secret, manual_trade_form, opts = {})
+    private def place_force_order_with_http_info_impl(user_id, user_secret, manual_trade_form_with_options, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: TradingApi.place_force_order ...'
       end
@@ -473,9 +528,9 @@ module SnapTrade
       if @api_client.config.client_side_validation && user_secret.nil?
         fail ArgumentError, "Missing the required parameter 'user_secret' when calling TradingApi.place_force_order"
       end
-      # verify the required parameter 'manual_trade_form' is set
-      if @api_client.config.client_side_validation && manual_trade_form.nil?
-        fail ArgumentError, "Missing the required parameter 'manual_trade_form' when calling TradingApi.place_force_order"
+      # verify the required parameter 'manual_trade_form_with_options' is set
+      if @api_client.config.client_side_validation && manual_trade_form_with_options.nil?
+        fail ArgumentError, "Missing the required parameter 'manual_trade_form_with_options' when calling TradingApi.place_force_order"
       end
       # resource path
       local_var_path = '/trade/place'
@@ -499,7 +554,7 @@ module SnapTrade
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(manual_trade_form)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(manual_trade_form_with_options)
 
       # return_type
       return_type = opts[:debug_return_type] || 'AccountOrderRecord'
@@ -525,155 +580,67 @@ module SnapTrade
     end
 
 
-    # Place a OCO (One Cancels Other) order
-    # @param user_id [String] 
-    # @param user_secret [String] 
-    # @param first_trade_id [Object] The ID of first trade object obtained from trade/impact endpoint
-    # @param second_trade_id [Object] The ID of second trade object obtained from trade/impact endpoint
-    # @param body [TradingPlaceOCOOrderRequest] 
-    # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def place_oco_order(user_id:, user_secret:, first_trade_id: SENTINEL, second_trade_id: SENTINEL, extra: {})
-      _body = {}
-      _body[:first_trade_id] = first_trade_id if first_trade_id != SENTINEL
-      _body[:second_trade_id] = second_trade_id if second_trade_id != SENTINEL
-      trading_place_oco_order_request = _body
-      data, _status_code, _headers = place_oco_order_with_http_info_impl(user_id, user_secret, trading_place_oco_order_request, extra)
-      data
-    end
-
-    # Place a OCO (One Cancels Other) order
+    # Place checked order
+    #
+    # Places the previously checked order with the brokerage. The `tradeId` is obtained from the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact). If you prefer to place the order without checking for impact first, you can use the [place order endpoint](/reference/Trading/Trading_placeForceOrder).
+    # 
+    # It's recommended to trigger a manual refresh of the account after placing an order to ensure the account is up to date. You can use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint for this.
+    #
+    # @param trade_id [String] Obtained from calling the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact)
     # @param user_id [String] 
     # @param user_secret [String] 
-    # @param first_trade_id [Object] The ID of first trade object obtained from trade/impact endpoint
-    # @param second_trade_id [Object] The ID of second trade object obtained from trade/impact endpoint
-    # @param body [TradingPlaceOCOOrderRequest] 
+    # @param wait_to_confirm [Boolean] Optional, defaults to true. Determines if a wait is performed to check on order status. If false, latency will be reduced but orders returned will be more likely to be of status `PENDING` as we will not wait to check on the status before responding to the request.
+    # @param body [ValidatedTradeBody] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def place_oco_order_with_http_info(user_id:, user_secret:, first_trade_id: SENTINEL, second_trade_id: SENTINEL, extra: {})
+    def place_order(trade_id:, user_id:, user_secret:, wait_to_confirm: SENTINEL, extra: {})
       _body = {}
-      _body[:first_trade_id] = first_trade_id if first_trade_id != SENTINEL
-      _body[:second_trade_id] = second_trade_id if second_trade_id != SENTINEL
-      trading_place_oco_order_request = _body
-      place_oco_order_with_http_info_impl(user_id, user_secret, trading_place_oco_order_request, extra)
-    end
-
-    # Place a OCO (One Cancels Other) order
-    # @param user_id [String] 
-    # @param user_secret [String] 
-    # @param trading_place_oco_order_request [TradingPlaceOCOOrderRequest] 
-    # @param [Hash] opts the optional parameters
-    # @return [AccountOrderRecord]
-    def place_oco_order_impl(user_id, user_secret, trading_place_oco_order_request, opts = {})
-      data, _status_code, _headers = place_oco_order_with_http_info(user_id, user_secret, trading_place_oco_order_request, opts)
-      data
-    end
-
-    # Place a OCO (One Cancels Other) order
-    # @param user_id [String] 
-    # @param user_secret [String] 
-    # @param trading_place_oco_order_request [TradingPlaceOCOOrderRequest] 
-    # @param [Hash] opts the optional parameters
-    # @return [Array<(AccountOrderRecord, Integer, Hash)>] AccountOrderRecord data, response status code and response headers
-    def place_oco_order_with_http_info_impl(user_id, user_secret, trading_place_oco_order_request, opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: TradingApi.place_oco_order ...'
-      end
-      # verify the required parameter 'user_id' is set
-      if @api_client.config.client_side_validation && user_id.nil?
-        fail ArgumentError, "Missing the required parameter 'user_id' when calling TradingApi.place_oco_order"
-      end
-      # verify the required parameter 'user_secret' is set
-      if @api_client.config.client_side_validation && user_secret.nil?
-        fail ArgumentError, "Missing the required parameter 'user_secret' when calling TradingApi.place_oco_order"
-      end
-      # verify the required parameter 'trading_place_oco_order_request' is set
-      if @api_client.config.client_side_validation && trading_place_oco_order_request.nil?
-        fail ArgumentError, "Missing the required parameter 'trading_place_oco_order_request' when calling TradingApi.place_oco_order"
-      end
-      # resource path
-      local_var_path = '/trade/oco'
-
-      # query parameters
-      query_params = opts[:query_params] || {}
-      query_params[:'userId'] = user_id
-      query_params[:'userSecret'] = user_secret
-
-      # header parameters
-      header_params = opts[:header_params] || {}
-      # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
-      # HTTP header 'Content-Type'
-      content_type = @api_client.select_header_content_type(['application/json'])
-      if !content_type.nil?
-        header_params['Content-Type'] = content_type
-      end
-
-      # form parameters
-      form_params = opts[:form_params] || {}
-
-      # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(trading_place_oco_order_request)
-
-      # return_type
-      return_type = opts[:debug_return_type] || 'AccountOrderRecord'
-
-      # auth_names
-      auth_names = opts[:debug_auth_names] || ['PartnerClientId', 'PartnerSignature', 'PartnerTimestamp']
-
-      new_options = opts.merge(
-        :operation => :"TradingApi.place_oco_order",
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names,
-        :return_type => return_type
-      )
-
-      data, status_code, headers, response = @api_client.call_api(:POST, local_var_path, new_options)
-      if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: TradingApi#place_oco_order\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers, response
-    end
-
-
-    # Place order
-    # @param trade_id [String] The ID of trade object obtained from trade/impact endpoint
-    # @param user_id [String] 
-    # @param user_secret [String] 
-    # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def place_order(trade_id:, user_id:, user_secret:, extra: {})
+      _body[:wait_to_confirm] = wait_to_confirm if wait_to_confirm != SENTINEL
+      extra[:validated_trade_body] = _body if !_body.empty?
       data, _status_code, _headers = place_order_with_http_info_impl(trade_id, user_id, user_secret, extra)
       data
     end
 
-    # Place order
-    # @param trade_id [String] The ID of trade object obtained from trade/impact endpoint
+    # Place checked order
+    #
+    # Places the previously checked order with the brokerage. The `tradeId` is obtained from the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact). If you prefer to place the order without checking for impact first, you can use the [place order endpoint](/reference/Trading/Trading_placeForceOrder).
+    # 
+    # It's recommended to trigger a manual refresh of the account after placing an order to ensure the account is up to date. You can use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint for this.
+    #
+    # @param trade_id [String] Obtained from calling the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact)
     # @param user_id [String] 
     # @param user_secret [String] 
+    # @param wait_to_confirm [Boolean] Optional, defaults to true. Determines if a wait is performed to check on order status. If false, latency will be reduced but orders returned will be more likely to be of status `PENDING` as we will not wait to check on the status before responding to the request.
+    # @param body [ValidatedTradeBody] 
     # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
-    def place_order_with_http_info(trade_id:, user_id:, user_secret:, extra: {})
+    def place_order_with_http_info(trade_id:, user_id:, user_secret:, wait_to_confirm: SENTINEL, extra: {})
+      _body = {}
+      _body[:wait_to_confirm] = wait_to_confirm if wait_to_confirm != SENTINEL
+      extra[:validated_trade_body] = _body if !_body.empty?
       place_order_with_http_info_impl(trade_id, user_id, user_secret, extra)
     end
 
-    # Place order
-    # @param trade_id [String] The ID of trade object obtained from trade/impact endpoint
+    # Place checked order
+    # Places the previously checked order with the brokerage. The `tradeId` is obtained from the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact). If you prefer to place the order without checking for impact first, you can use the [place order endpoint](/reference/Trading/Trading_placeForceOrder).  It's recommended to trigger a manual refresh of the account after placing an order to ensure the account is up to date. You can use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint for this. 
+    # @param trade_id [String] Obtained from calling the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact)
     # @param user_id [String] 
     # @param user_secret [String] 
     # @param [Hash] opts the optional parameters
+    # @option opts [ValidatedTradeBody] :validated_trade_body 
     # @return [AccountOrderRecord]
-    def place_order_impl(trade_id, user_id, user_secret, opts = {})
+    private def place_order_impl(trade_id, user_id, user_secret, opts = {})
       data, _status_code, _headers = place_order_with_http_info(trade_id, user_id, user_secret, opts)
       data
     end
 
-    # Place order
-    # @param trade_id [String] The ID of trade object obtained from trade/impact endpoint
+    # Place checked order
+    # Places the previously checked order with the brokerage. The &#x60;tradeId&#x60; is obtained from the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact). If you prefer to place the order without checking for impact first, you can use the [place order endpoint](/reference/Trading/Trading_placeForceOrder).  It&#39;s recommended to trigger a manual refresh of the account after placing an order to ensure the account is up to date. You can use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint for this. 
+    # @param trade_id [String] Obtained from calling the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact)
     # @param user_id [String] 
     # @param user_secret [String] 
     # @param [Hash] opts the optional parameters
+    # @option opts [ValidatedTradeBody] :validated_trade_body 
     # @return [Array<(AccountOrderRecord, Integer, Hash)>] AccountOrderRecord data, response status code and response headers
-    def place_order_with_http_info_impl(trade_id, user_id, user_secret, opts = {})
+    private def place_order_with_http_info_impl(trade_id, user_id, user_secret, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: TradingApi.place_order ...'
       end
@@ -701,12 +668,17 @@ module SnapTrade
       header_params = opts[:header_params] || {}
       # HTTP header 'Accept' (if needed)
       header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+        header_params['Content-Type'] = content_type
+      end
 
       # form parameters
       form_params = opts[:form_params] || {}
 
       # http body (model)
-      post_body = opts[:debug_body]
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'validated_trade_body'])
 
       # return_type
       return_type = opts[:debug_return_type] || 'AccountOrderRecord'