snaptrade 3.0.30 → 3.0.31

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa858a86d922e9a3c017b09530fdccbb3c39505f9f7086d04c49b858ec56dc95
-  data.tar.gz: 866202c7c7be9671c1ccbbc7396532abed2e35d08c1de5e67eb868f3779a1a05
+  metadata.gz: 1effb1f305a79d998a07364a160d695925a60f64daf153a0f1e3b276f568663d
+  data.tar.gz: 757327cc71cdbf1ea7f4ccee9075b582b35afc93d07a334d246cee8ff37b054f
 SHA512:
-  metadata.gz: a3f566995ffbde9eae7b27ce4bd22dd76b6b311777431b93bdd064a2d7406e3be58d506657176dc0bbf5005bf7a9ce030f8b863602958c01975ebed8f35cad0b
-  data.tar.gz: 3e763c0a88ae31270037b1117a40ae9aa3992659705dc805e14835b4938fc16263832bba8d0e61d9536731249eabf35583325460da903fb1b3f865747eb23d51
+  metadata.gz: 55e913bb5fc1d61102562495178f7567bca3f0c93e174bee7381d00041f6d7943476e8637098839e1223e0af08f1f8167df4ee2d235ce5e50045ee4c9895f4e6
+  data.tar.gz: 51ca83e7c04bb35df1ee98c746b0ee140f352fe5d90a4cbc2c249a0dacf3006004248e6f8f74916599eae899dd222dea7da6f14f0cd24424e267e6746a04f314

data/README.md

@@ -63,7 +63,7 @@ backoff with jitter rather than from the headers.
 See https://docs.snaptrade.com/docs/ratelimiting.
 
 
-[![npm](https://img.shields.io/badge/gem-v3.0.30-blue)](https://rubygems.org/gems/snaptrade/versions/3.0.30)
+[![npm](https://img.shields.io/badge/gem-v3.0.31-blue)](https://rubygems.org/gems/snaptrade/versions/3.0.31)
 [![More Info](https://img.shields.io/badge/More%20Info-Click%20Here-orange)](https://snaptrade.com/)
 
 </div>
@@ -111,6 +111,7 @@ See https://docs.snaptrade.com/docs/ratelimiting.
   * [`snaptrade.experimental_endpoints.get_user_account_recent_orders_v2`](#snaptradeexperimental_endpointsget_user_account_recent_orders_v2)
   * [`snaptrade.experimental_endpoints.list_all_user_accounts`](#snaptradeexperimental_endpointslist_all_user_accounts)
   * [`snaptrade.experimental_endpoints.list_subscriptions`](#snaptradeexperimental_endpointslist_subscriptions)
+  * [`snaptrade.experimental_endpoints.place_simple_order`](#snaptradeexperimental_endpointsplace_simple_order)
   * [`snaptrade.reference_data.get_partner_info`](#snaptradereference_dataget_partner_info)
   * [`snaptrade.reference_data.get_stock_exchanges`](#snaptradereference_dataget_stock_exchanges)
   * [`snaptrade.reference_data.get_symbols`](#snaptradereference_dataget_symbols)
@@ -142,7 +143,7 @@ See https://docs.snaptrade.com/docs/ratelimiting.
 Add to Gemfile:
 
 ```ruby
-gem 'snaptrade', '~> 3.0.30'
+gem 'snaptrade', '~> 3.0.31'
 ```
 
 ## Getting Started<a id="getting-started"></a>
@@ -276,6 +277,8 @@ one account to another. - `SPLIT` - A stock share split.
 
 An experimental endpoint that returns estimated historical total account value for the specified account. Total account value is the sum of the market value of all positions and cash in the account at a given time. This endpoint is experimental, disabled by default, and has a maximum lookback of 1 year. Because the data is dynamically generated, we recommend replacing your dataset with each request as opposed to combining data from multiple requests. Enable this feature for free in the [Add-on page of the Customer Dashboard](https://dashboard.snaptrade.com/add-ons)
 
+The data may contain gaps and is best used for charting account value trends. It should not be relied on as a complete or exact record of historical account values.
+
 
 #### 🛠️ Usage<a id="🛠️-usage"></a>
 
@@ -1610,6 +1613,119 @@ p result
 ---
 
 
+### `snaptrade.experimental_endpoints.place_simple_order`<a id="snaptradeexperimental_endpointsplace_simple_order"></a>
+
+**Beta.** Places a single-leg or multi-leg order using a common request format for equities, equity options, futures, and future options. This endpoint is experimental; breaking changes are possible during the experimental phase.
+
+Equity and equity-option orders use the existing brokerage trading capabilities. Futures and future options are currently supported only on tastytrade. Order types, time in force, optional fields, and strategy combinations remain subject to brokerage support. See the [brokerage trading support page](https://support.snaptrade.com/brokerages).
+
+An order may contain equity/option legs or future/future_option legs, but cannot mix those two families. Equity/option strategies must share the same underlying symbol. Each strategy is submitted as one brokerage order; unsupported strategies are never split into independent orders. Tastytrade supports single-leg outright futures and up to four future-option legs, and does not support multi-leg market orders.
+
+All string choices use lower snake_case and are case-sensitive. Symbols retain their native format: equity tickers, OCC equity-option symbols, or the exact tastytrade BrokerageInstrument ticker for futures and future options, including any spaces.
+
+A successful response contains only the brokerage order ID. Use the existing order endpoints to retrieve order details.
+
+
+#### 🛠️ Usage<a id="🛠️-usage"></a>
+
+```ruby
+result = snaptrade.experimental_endpoints.place_simple_order(
+  order_type: "stop_limit",
+  time_in_force: "day",
+  legs: [
+        {
+            "instrument" => {
+                "kind" => "future",
+                "symbol" => "/ESZ6",
+            },
+            "action" => "buy",
+            "units" => "1.25",
+        }
+    ],
+  account_id: "917c8734-8470-4a3e-a18f-57c3f2ee6631",
+  user_id: "snaptrade-user-123",
+  user_secret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
+  limit_price: "1.25",
+  stop_price: "1.25",
+  price_effect: "debit",
+  client_order_id: "550e8400-e29b-41d4-a716-446655440000",
+  expiry_date: "2026-12-18T20:00:00Z",
+  notional_value: "1.25",
+  trading_session: "regular",
+)
+p result
+```
+
+#### ⚙️ Parameters<a id="⚙️-parameters"></a>
+
+##### order_type: [`SimpleTradeFormOrderType`](./lib/snaptrade/models/simple_trade_form_order_type.rb)<a id="order_type-simpletradeformordertypelibsnaptrademodelssimple_trade_form_order_typerb"></a>
+##### time_in_force: [`SimpleTradeFormTimeInForce`](./lib/snaptrade/models/simple_trade_form_time_in_force.rb)<a id="time_in_force-simpletradeformtimeinforcelibsnaptrademodelssimple_trade_form_time_in_forcerb"></a>
+Order duration, subject to brokerage and execution-path support. gtd requires
+expiry_date and a non-market single-leg equity/option order. Existing single-leg
+option routing does not support ioc. Futures and multi-leg orders do not support
+gtd through this endpoint.
+
+##### legs: Array<[`SimpleTradeLeg`](./lib/snaptrade/models/simple_trade_leg.rb)><a id="legs-array"></a>
+Legs of one brokerage order. Use equity/option legs or future/future_option
+legs, without mixing the two families. Brokerage strategy and leg-count limits
+apply.
+
+##### account_id: `String`<a id="account_id-string"></a>
+The ID of the account to execute the trade on.
+
+##### user_id: `String`<a id="user_id-string"></a>
+##### user_secret: `String`<a id="user_secret-string"></a>
+##### limit_price: [`Float`](./lib/snaptrade/models/float.rb)<a id="limit_price-floatlibsnaptrademodelsfloatrb"></a>
+Required for limit and stop_limit orders, except that multi-leg price_effect
+even implies zero. Must be omitted or null for market and stop orders. For
+multi-leg orders this is the net strategy price. Negative prices are accepted
+only for futures-family orders, subject to brokerage support.
+
+##### stop_price: [`Float`](./lib/snaptrade/models/float.rb)<a id="stop_price-floatlibsnaptrademodelsfloatrb"></a>
+Required for stop and stop_limit orders. Must be omitted or null for market and
+limit orders. Must be positive for equity/option orders; futures-family trigger
+prices are subject to brokerage support.
+
+##### price_effect: [`SimpleTradeFormPriceEffect`](./lib/snaptrade/models/simple_trade_form_price_effect.rb)<a id="price_effect-simpletradeformpriceeffectlibsnaptrademodelssimple_trade_form_price_effectrb"></a>
+Only applicable to multi-leg limit and stop_limit orders. Requirements and
+supported values depend on the brokerage; tastytrade requires credit or debit.
+even implies a zero limit_price, which may be omitted and must be zero if
+supplied. Single-leg price effects are derived from the action.
+
+##### client_order_id: [`String`](./lib/snaptrade/models/string.rb)<a id="client_order_id-stringlibsnaptrademodelsstringrb"></a>
+Optional canonical UUID, forwarded where the existing execution path supports it
+and for tastytrade futures orders. Requires the existing client-order-ID
+enablement; when disabled the value is ignored. Brokerage behavior on duplicates
+varies; SnapTrade does not enforce uniqueness. Tastytrade uses this as
+external-identifier for correlation and does not deduplicate submissions.
+
+##### expiry_date: `Time`<a id="expiry_date-time"></a>
+ISO 8601 expiry timestamp, required for gtd and invalid with other durations. A
+missing timezone is treated as UTC. Supported only through existing single-leg
+Public and Sandbox execution paths.
+
+##### notional_value: [`Float`](./lib/snaptrade/models/float.rb)<a id="notional_value-floatlibsnaptrademodelsfloatrb"></a>
+Positive order value, supported only for a single-equity market order on
+eligible brokerages and partners. Mutually exclusive with leg units. Omit or set
+units to null when supplied.
+
+##### trading_session: [`SimpleTradeFormTradingSession`](./lib/snaptrade/models/simple_trade_form_trading_session.rb)<a id="trading_session-simpletradeformtradingsessionlibsnaptrademodelssimple_trade_form_trading_sessionrb"></a>
+extended uses existing single-leg equity/option brokerage support and requires
+extended-hours enablement. Futures and multi-leg orders only accept regular.
+
+#### 🔄 Return<a id="🔄-return"></a>
+
+[SimpleTradeResponse](./lib/snaptrade/models/simple_trade_response.rb)
+
+#### 🌐 Endpoint<a id="🌐-endpoint"></a>
+
+`/accounts/{accountId}/trading/simple` `POST`
+
+[🔙 **Back to Table of Contents**](#table-of-contents)
+
+---
+
+
 ### `snaptrade.reference_data.get_partner_info`<a id="snaptradereference_dataget_partner_info"></a>
 
 Returns configurations for your SnapTrade Client ID, including allowed brokerages and data access.

data/lib/snaptrade/api/account_information_api.rb

@@ -186,6 +186,8 @@ module SnapTrade
     # List historical account total value
     #
     # An experimental endpoint that returns estimated historical total account value for the specified account. Total account value is the sum of the market value of all positions and cash in the account at a given time. This endpoint is experimental, disabled by default, and has a maximum lookback of 1 year. Because the data is dynamically generated, we recommend replacing your dataset with each request as opposed to combining data from multiple requests. Enable this feature for free in the [Add-on page of the Customer Dashboard](https://dashboard.snaptrade.com/add-ons)
+    # 
+    # The data may contain gaps and is best used for charting account value trends. It should not be relied on as a complete or exact record of historical account values.
     #
     # @param user_id [String] 
     # @param user_secret [String] 
@@ -199,6 +201,8 @@ module SnapTrade
     # List historical account total value
     #
     # An experimental endpoint that returns estimated historical total account value for the specified account. Total account value is the sum of the market value of all positions and cash in the account at a given time. This endpoint is experimental, disabled by default, and has a maximum lookback of 1 year. Because the data is dynamically generated, we recommend replacing your dataset with each request as opposed to combining data from multiple requests. Enable this feature for free in the [Add-on page of the Customer Dashboard](https://dashboard.snaptrade.com/add-ons)
+    # 
+    # The data may contain gaps and is best used for charting account value trends. It should not be relied on as a complete or exact record of historical account values.
     #
     # @param user_id [String] 
     # @param user_secret [String] 
@@ -209,7 +213,7 @@ module SnapTrade
     end
 
     # List historical account total value
-    # An experimental endpoint that returns estimated historical total account value for the specified account. Total account value is the sum of the market value of all positions and cash in the account at a given time. This endpoint is experimental, disabled by default, and has a maximum lookback of 1 year. Because the data is dynamically generated, we recommend replacing your dataset with each request as opposed to combining data from multiple requests. Enable this feature for free in the [Add-on page of the Customer Dashboard](https://dashboard.snaptrade.com/add-ons) 
+    # An experimental endpoint that returns estimated historical total account value for the specified account. Total account value is the sum of the market value of all positions and cash in the account at a given time. This endpoint is experimental, disabled by default, and has a maximum lookback of 1 year. Because the data is dynamically generated, we recommend replacing your dataset with each request as opposed to combining data from multiple requests. Enable this feature for free in the [Add-on page of the Customer Dashboard](https://dashboard.snaptrade.com/add-ons)  The data may contain gaps and is best used for charting account value trends. It should not be relied on as a complete or exact record of historical account values. 
     # @param user_id [String] 
     # @param user_secret [String] 
     # @param account_id [String] 
@@ -221,7 +225,7 @@ module SnapTrade
     end
 
     # List historical account total value
-    # An experimental endpoint that returns estimated historical total account value for the specified account. Total account value is the sum of the market value of all positions and cash in the account at a given time. This endpoint is experimental, disabled by default, and has a maximum lookback of 1 year. Because the data is dynamically generated, we recommend replacing your dataset with each request as opposed to combining data from multiple requests. Enable this feature for free in the [Add-on page of the Customer Dashboard](https://dashboard.snaptrade.com/add-ons) 
+    # An experimental endpoint that returns estimated historical total account value for the specified account. Total account value is the sum of the market value of all positions and cash in the account at a given time. This endpoint is experimental, disabled by default, and has a maximum lookback of 1 year. Because the data is dynamically generated, we recommend replacing your dataset with each request as opposed to combining data from multiple requests. Enable this feature for free in the [Add-on page of the Customer Dashboard](https://dashboard.snaptrade.com/add-ons)  The data may contain gaps and is best used for charting account value trends. It should not be relied on as a complete or exact record of historical account values. 
     # @param user_id [String] 
     # @param user_secret [String] 
     # @param account_id [String] 

data/lib/snaptrade/api/experimental_endpoints_api.rb

@@ -924,6 +924,182 @@ module SnapTrade
       end
       return data, status_code, headers, response
     end
+
+
+    # Place a simple order (beta)
+    #
+    # **Beta.** Places a single-leg or multi-leg order using a common request format for equities, equity options, futures, and future options. This endpoint is experimental; breaking changes are possible during the experimental phase.
+    # 
+    # Equity and equity-option orders use the existing brokerage trading capabilities. Futures and future options are currently supported only on tastytrade. Order types, time in force, optional fields, and strategy combinations remain subject to brokerage support. See the [brokerage trading support page](https://support.snaptrade.com/brokerages).
+    # 
+    # An order may contain equity/option legs or future/future_option legs, but cannot mix those two families. Equity/option strategies must share the same underlying symbol. Each strategy is submitted as one brokerage order; unsupported strategies are never split into independent orders. Tastytrade supports single-leg outright futures and up to four future-option legs, and does not support multi-leg market orders.
+    # 
+    # All string choices use lower snake_case and are case-sensitive. Symbols retain their native format: equity tickers, OCC equity-option symbols, or the exact tastytrade BrokerageInstrument ticker for futures and future options, including any spaces.
+    # 
+    # A successful response contains only the brokerage order ID. Use the existing order endpoints to retrieve order details.
+    #
+    # @param order_type [SimpleTradeFormOrderType] 
+    # @param time_in_force [SimpleTradeFormTimeInForce] Order duration, subject to brokerage and execution-path support. gtd requires expiry_date and a non-market single-leg equity/option order. Existing single-leg option routing does not support ioc. Futures and multi-leg orders do not support gtd through this endpoint.
+    # @param legs [Array<SimpleTradeLeg>] Legs of one brokerage order. Use equity/option legs or future/future_option legs, without mixing the two families. Brokerage strategy and leg-count limits apply.
+    # @param account_id [String] The ID of the account to execute the trade on.
+    # @param user_id [String] 
+    # @param user_secret [String] 
+    # @param limit_price [Float] Required for limit and stop_limit orders, except that multi-leg price_effect even implies zero. Must be omitted or null for market and stop orders. For multi-leg orders this is the net strategy price. Negative prices are accepted only for futures-family orders, subject to brokerage support.
+    # @param stop_price [Float] Required for stop and stop_limit orders. Must be omitted or null for market and limit orders. Must be positive for equity/option orders; futures-family trigger prices are subject to brokerage support.
+    # @param price_effect [SimpleTradeFormPriceEffect] Only applicable to multi-leg limit and stop_limit orders. Requirements and supported values depend on the brokerage; tastytrade requires credit or debit. even implies a zero limit_price, which may be omitted and must be zero if supplied. Single-leg price effects are derived from the action.
+    # @param client_order_id [String] Optional canonical UUID, forwarded where the existing execution path supports it and for tastytrade futures orders. Requires the existing client-order-ID enablement; when disabled the value is ignored. Brokerage behavior on duplicates varies; SnapTrade does not enforce uniqueness. Tastytrade uses this as external-identifier for correlation and does not deduplicate submissions.
+    # @param expiry_date [Time] ISO 8601 expiry timestamp, required for gtd and invalid with other durations. A missing timezone is treated as UTC. Supported only through existing single-leg Public and Sandbox execution paths.
+    # @param notional_value [Float] Positive order value, supported only for a single-equity market order on eligible brokerages and partners. Mutually exclusive with leg units. Omit or set units to null when supplied.
+    # @param trading_session [SimpleTradeFormTradingSession] extended uses existing single-leg equity/option brokerage support and requires extended-hours enablement. Futures and multi-leg orders only accept regular.
+    # @param body [SimpleTradeForm] 
+    # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
+    def place_simple_order(order_type:, time_in_force:, legs:, account_id:, user_id:, user_secret:, limit_price: SENTINEL, stop_price: SENTINEL, price_effect: SENTINEL, client_order_id: SENTINEL, expiry_date: SENTINEL, notional_value: SENTINEL, trading_session: 'regular', extra: {})
+      _body = {}
+      _body[:order_type] = order_type if order_type != SENTINEL
+      _body[:time_in_force] = time_in_force if time_in_force != SENTINEL
+      _body[:legs] = legs if legs != SENTINEL
+      _body[:limit_price] = limit_price if limit_price != SENTINEL
+      _body[:stop_price] = stop_price if stop_price != SENTINEL
+      _body[:price_effect] = price_effect if price_effect != SENTINEL
+      _body[:client_order_id] = client_order_id if client_order_id != SENTINEL
+      _body[:expiry_date] = expiry_date if expiry_date != SENTINEL
+      _body[:notional_value] = notional_value if notional_value != SENTINEL
+      _body[:trading_session] = trading_session if trading_session != SENTINEL
+      simple_trade_form = _body
+      data, _status_code, _headers = place_simple_order_with_http_info_impl(account_id, user_id, user_secret, simple_trade_form, extra)
+      data
+    end
+
+    # Place a simple order (beta)
+    #
+    # **Beta.** Places a single-leg or multi-leg order using a common request format for equities, equity options, futures, and future options. This endpoint is experimental; breaking changes are possible during the experimental phase.
+    # 
+    # Equity and equity-option orders use the existing brokerage trading capabilities. Futures and future options are currently supported only on tastytrade. Order types, time in force, optional fields, and strategy combinations remain subject to brokerage support. See the [brokerage trading support page](https://support.snaptrade.com/brokerages).
+    # 
+    # An order may contain equity/option legs or future/future_option legs, but cannot mix those two families. Equity/option strategies must share the same underlying symbol. Each strategy is submitted as one brokerage order; unsupported strategies are never split into independent orders. Tastytrade supports single-leg outright futures and up to four future-option legs, and does not support multi-leg market orders.
+    # 
+    # All string choices use lower snake_case and are case-sensitive. Symbols retain their native format: equity tickers, OCC equity-option symbols, or the exact tastytrade BrokerageInstrument ticker for futures and future options, including any spaces.
+    # 
+    # A successful response contains only the brokerage order ID. Use the existing order endpoints to retrieve order details.
+    #
+    # @param order_type [SimpleTradeFormOrderType] 
+    # @param time_in_force [SimpleTradeFormTimeInForce] Order duration, subject to brokerage and execution-path support. gtd requires expiry_date and a non-market single-leg equity/option order. Existing single-leg option routing does not support ioc. Futures and multi-leg orders do not support gtd through this endpoint.
+    # @param legs [Array<SimpleTradeLeg>] Legs of one brokerage order. Use equity/option legs or future/future_option legs, without mixing the two families. Brokerage strategy and leg-count limits apply.
+    # @param account_id [String] The ID of the account to execute the trade on.
+    # @param user_id [String] 
+    # @param user_secret [String] 
+    # @param limit_price [Float] Required for limit and stop_limit orders, except that multi-leg price_effect even implies zero. Must be omitted or null for market and stop orders. For multi-leg orders this is the net strategy price. Negative prices are accepted only for futures-family orders, subject to brokerage support.
+    # @param stop_price [Float] Required for stop and stop_limit orders. Must be omitted or null for market and limit orders. Must be positive for equity/option orders; futures-family trigger prices are subject to brokerage support.
+    # @param price_effect [SimpleTradeFormPriceEffect] Only applicable to multi-leg limit and stop_limit orders. Requirements and supported values depend on the brokerage; tastytrade requires credit or debit. even implies a zero limit_price, which may be omitted and must be zero if supplied. Single-leg price effects are derived from the action.
+    # @param client_order_id [String] Optional canonical UUID, forwarded where the existing execution path supports it and for tastytrade futures orders. Requires the existing client-order-ID enablement; when disabled the value is ignored. Brokerage behavior on duplicates varies; SnapTrade does not enforce uniqueness. Tastytrade uses this as external-identifier for correlation and does not deduplicate submissions.
+    # @param expiry_date [Time] ISO 8601 expiry timestamp, required for gtd and invalid with other durations. A missing timezone is treated as UTC. Supported only through existing single-leg Public and Sandbox execution paths.
+    # @param notional_value [Float] Positive order value, supported only for a single-equity market order on eligible brokerages and partners. Mutually exclusive with leg units. Omit or set units to null when supplied.
+    # @param trading_session [SimpleTradeFormTradingSession] extended uses existing single-leg equity/option brokerage support and requires extended-hours enablement. Futures and multi-leg orders only accept regular.
+    # @param body [SimpleTradeForm] 
+    # @param [Hash] extra additional parameters to pass along through :header_params, :query_params, or parameter name
+    def place_simple_order_with_http_info(order_type:, time_in_force:, legs:, account_id:, user_id:, user_secret:, limit_price: SENTINEL, stop_price: SENTINEL, price_effect: SENTINEL, client_order_id: SENTINEL, expiry_date: SENTINEL, notional_value: SENTINEL, trading_session: 'regular', extra: {})
+      _body = {}
+      _body[:order_type] = order_type if order_type != SENTINEL
+      _body[:time_in_force] = time_in_force if time_in_force != SENTINEL
+      _body[:legs] = legs if legs != SENTINEL
+      _body[:limit_price] = limit_price if limit_price != SENTINEL
+      _body[:stop_price] = stop_price if stop_price != SENTINEL
+      _body[:price_effect] = price_effect if price_effect != SENTINEL
+      _body[:client_order_id] = client_order_id if client_order_id != SENTINEL
+      _body[:expiry_date] = expiry_date if expiry_date != SENTINEL
+      _body[:notional_value] = notional_value if notional_value != SENTINEL
+      _body[:trading_session] = trading_session if trading_session != SENTINEL
+      simple_trade_form = _body
+      place_simple_order_with_http_info_impl(account_id, user_id, user_secret, simple_trade_form, extra)
+    end
+
+    # Place a simple order (beta)
+    # **Beta.** Places a single-leg or multi-leg order using a common request format for equities, equity options, futures, and future options. This endpoint is experimental; breaking changes are possible during the experimental phase.  Equity and equity-option orders use the existing brokerage trading capabilities. Futures and future options are currently supported only on tastytrade. Order types, time in force, optional fields, and strategy combinations remain subject to brokerage support. See the [brokerage trading support page](https://support.snaptrade.com/brokerages).  An order may contain equity/option legs or future/future_option legs, but cannot mix those two families. Equity/option strategies must share the same underlying symbol. Each strategy is submitted as one brokerage order; unsupported strategies are never split into independent orders. Tastytrade supports single-leg outright futures and up to four future-option legs, and does not support multi-leg market orders.  All string choices use lower snake_case and are case-sensitive. Symbols retain their native format: equity tickers, OCC equity-option symbols, or the exact tastytrade BrokerageInstrument ticker for futures and future options, including any spaces.  A successful response contains only the brokerage order ID. Use the existing order endpoints to retrieve order details. 
+    # @param account_id [String] The ID of the account to execute the trade on.
+    # @param user_id [String] 
+    # @param user_secret [String] 
+    # @param simple_trade_form [SimpleTradeForm] 
+    # @param [Hash] opts the optional parameters
+    # @return [SimpleTradeResponse]
+    private def place_simple_order_impl(account_id, user_id, user_secret, simple_trade_form, opts = {})
+      data, _status_code, _headers = place_simple_order_with_http_info(account_id, user_id, user_secret, simple_trade_form, opts)
+      data
+    end
+
+    # Place a simple order (beta)
+    # **Beta.** Places a single-leg or multi-leg order using a common request format for equities, equity options, futures, and future options. This endpoint is experimental; breaking changes are possible during the experimental phase.  Equity and equity-option orders use the existing brokerage trading capabilities. Futures and future options are currently supported only on tastytrade. Order types, time in force, optional fields, and strategy combinations remain subject to brokerage support. See the [brokerage trading support page](https://support.snaptrade.com/brokerages).  An order may contain equity/option legs or future/future_option legs, but cannot mix those two families. Equity/option strategies must share the same underlying symbol. Each strategy is submitted as one brokerage order; unsupported strategies are never split into independent orders. Tastytrade supports single-leg outright futures and up to four future-option legs, and does not support multi-leg market orders.  All string choices use lower snake_case and are case-sensitive. Symbols retain their native format: equity tickers, OCC equity-option symbols, or the exact tastytrade BrokerageInstrument ticker for futures and future options, including any spaces.  A successful response contains only the brokerage order ID. Use the existing order endpoints to retrieve order details. 
+    # @param account_id [String] The ID of the account to execute the trade on.
+    # @param user_id [String] 
+    # @param user_secret [String] 
+    # @param simple_trade_form [SimpleTradeForm] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SimpleTradeResponse, Integer, Hash)>] SimpleTradeResponse data, response status code and response headers
+    private def place_simple_order_with_http_info_impl(account_id, user_id, user_secret, simple_trade_form, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ExperimentalEndpointsApi.place_simple_order ...'
+      end
+      # verify the required parameter 'account_id' is set
+      if @api_client.config.client_side_validation && account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'account_id' when calling ExperimentalEndpointsApi.place_simple_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 ExperimentalEndpointsApi.place_simple_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 ExperimentalEndpointsApi.place_simple_order"
+      end
+      # verify the required parameter 'simple_trade_form' is set
+      if @api_client.config.client_side_validation && simple_trade_form.nil?
+        fail ArgumentError, "Missing the required parameter 'simple_trade_form' when calling ExperimentalEndpointsApi.place_simple_order"
+      end
+      # resource path
+      local_var_path = '/accounts/{accountId}/trading/simple'.sub('{' + 'accountId' + '}', CGI.escape(account_id.to_s))
+
+      # 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(simple_trade_form)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SimpleTradeResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['PartnerClientId', 'PartnerSignature', 'PartnerTimestamp']
+
+      new_options = opts.merge(
+        :operation => :"ExperimentalEndpointsApi.place_simple_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: ExperimentalEndpointsApi#place_simple_order\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers, response
+    end
   end
 
   # top-level client access to avoid having the user to insantiate their own API instances

data/lib/snaptrade/models/account_position.rb

@@ -30,7 +30,7 @@ module SnapTrade
     # Present for mutual fund positions and for other instrument kinds when true. A true value means the position is also counted in cash balance or buying power.
     attr_accessor :cash_equivalent
 
-    # List of tax lots for the given position (disabled by default, only available on paid plans, contact support if needed)
+    # List of tax lots for the given position. Disabled by default; enable via the Customer Dashboard Add-ons page. When enabled, this field is included only for stocks, ADRs, ETFs, mutual funds, and crypto positions. For these positions, an empty list means no tax lot data is available. Availability varies by brokerage and position. This field is omitted for all other instrument kinds or when the feature is disabled.
     attr_accessor :tax_lots
 
     # Attribute mapping from ruby-style variable name to JSON key.

data/lib/snaptrade/models/account_value_history_response.rb

@@ -13,7 +13,7 @@ require 'time'
 module SnapTrade
   # The response to the account value history endpoint, containing a list of estimated account values at different points in time.
   class AccountValueHistoryResponse
-    # List of estimated account values over time returned by the endpoint.
+    # List of estimated account values over time returned by the endpoint. The data may contain gaps and is best used for charting trends, rather than as a complete or exact record of historical account values.
     attr_accessor :history
 
     # The ISO-4217 currency code for the account values.

data/lib/snaptrade/models/{account_type.rb → cash_or_margin.rb}

@@ -11,7 +11,7 @@ require 'date'
 require 'time'
 
 module SnapTrade
-  class AccountType
+  class CashOrMargin
     CASH = "cash".freeze
     MARGIN = "margin".freeze
     UNKNOWN = "unknown".freeze
@@ -31,8 +31,8 @@ module SnapTrade
     # @param [String] The enum value in the form of the string
     # @return [String] The enum value
     def build_from_hash(value)
-      return value if AccountType.all_vars.include?(value)
-      raise "Invalid ENUM value #{value} for class #AccountType"
+      return value if CashOrMargin.all_vars.include?(value)
+      raise "Invalid ENUM value #{value} for class #CashOrMargin"
     end
   end
 end

data/lib/snaptrade/models/institution.rb

@@ -34,7 +34,7 @@ module SnapTrade
     # URL of the institution's square logo.
     attr_accessor :square_logo_url
 
-    # How mature the integration is. - `GENERALLY_AVAILABLE`: fully supported and validated for production use. - `BETA`: production-ready, with ongoing validation and improvements. 
+    # How mature the integration is. - `GENERALLY_AVAILABLE`: fully supported and validated for production use. - `BETA`: production-ready, with ongoing validation and improvements. - `ALPHA`: early access with limited validation. Expect issues and incomplete functionality. 
     attr_accessor :release_stage
 
     # Regions where end users can connect to this institution. - `US`: United States - `CA`: Canada - `EUROPE`: Europe, including the United Kingdom - `AU`: Australia - `IN`: India 

data/lib/snaptrade/models/investment_account.rb

@@ -46,7 +46,7 @@ module SnapTrade
     attr_accessor :raw_type
 
     # Whether the institution reports the account as a cash or margin account, normalized across institutions. - `cash`: A cash account. The account cannot borrow on margin. - `margin`: A margin account, including portfolio margin accounts. Some institutions also report retirement accounts with limited margin (for example, trading before funds settle) as margin accounts. - `unknown`: The institution does not report whether the account is cash or margin.  **Beta:** only returned for some institutions and partners it has been enabled for. Omitted otherwise. 
-    attr_accessor :account_type
+    attr_accessor :cash_or_margin
 
     # Indicates whether the account is a paper (simulated) trading account.
     attr_accessor :is_paper
@@ -67,7 +67,7 @@ module SnapTrade
         :'funding_date' => :'funding_date',
         :'sync_status' => :'sync_status',
         :'raw_type' => :'raw_type',
-        :'account_type' => :'account_type',
+        :'cash_or_margin' => :'cash_or_margin',
         :'is_paper' => :'is_paper',
         :'net_value' => :'net_value'
       }
@@ -92,7 +92,7 @@ module SnapTrade
         :'funding_date' => :'Time',
         :'sync_status' => :'ConnectionAccountSyncStatus',
         :'raw_type' => :'String',
-        :'account_type' => :'AccountType',
+        :'cash_or_margin' => :'CashOrMargin',
         :'is_paper' => :'Boolean',
         :'net_value' => :'InvestmentAccountNetValue'
       }
@@ -169,8 +169,8 @@ module SnapTrade
         self.raw_type = attributes[:'raw_type']
       end
 
-      if attributes.key?(:'account_type')
-        self.account_type = attributes[:'account_type']
+      if attributes.key?(:'cash_or_margin')
+        self.cash_or_margin = attributes[:'cash_or_margin']
       end
 
       if attributes.key?(:'is_paper')
@@ -241,7 +241,7 @@ module SnapTrade
           funding_date == o.funding_date &&
           sync_status == o.sync_status &&
           raw_type == o.raw_type &&
-          account_type == o.account_type &&
+          cash_or_margin == o.cash_or_margin &&
           is_paper == o.is_paper &&
           net_value == o.net_value
     end
@@ -255,7 +255,7 @@ module SnapTrade
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [kind, id, connection_id, display_name, masked_account_number, institution_account_id, institution_id, opening_date, funding_date, sync_status, raw_type, account_type, is_paper, net_value].hash
+      [kind, id, connection_id, display_name, masked_account_number, institution_account_id, institution_id, opening_date, funding_date, sync_status, raw_type, cash_or_margin, is_paper, net_value].hash
     end
 
     # Builds the object from hash

data/lib/snaptrade/models/position.rb

@@ -35,7 +35,7 @@ module SnapTrade
     # If the position is a cash equivalent (usually a money market fund) that is also counted in account cash balance and buying power
     attr_accessor :cash_equivalent
 
-    # List of tax lots for the given position. Disabled by default, only available on paid plans, enable this feature in the [Add-on page of the Customer Dashboard](https://dashboard.snaptrade.com/add-ons)
+    # List of tax lots for the given position. Disabled by default, enable this feature in the [Add-on page of the Customer Dashboard](https://dashboard.snaptrade.com/add-ons)
     attr_accessor :tax_lots
 
     # Attribute mapping from ruby-style variable name to JSON key.

data/lib/snaptrade/models/release_stage.rb

@@ -14,9 +14,10 @@ module SnapTrade
   class ReleaseStage
     GENERALLY_AVAILABLE = "GENERALLY_AVAILABLE".freeze
     BETA = "BETA".freeze
+    ALPHA = "ALPHA".freeze
 
     def self.all_vars
-      @all_vars ||= [GENERALLY_AVAILABLE, BETA].freeze
+      @all_vars ||= [GENERALLY_AVAILABLE, BETA, ALPHA].freeze
     end
 
     # Builds the enum from string