snaptrade-typescript-sdk 11.0.0 → 11.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  Connect brokerage accounts to your app for live positions and trading
8
8
 
9
- [![npm](https://img.shields.io/badge/npm-v11.0.0-blue)](https://www.npmjs.com/package/snaptrade-typescript-sdk/v/11.0.0)
9
+ [![npm](https://img.shields.io/badge/npm-v11.0.2-blue)](https://www.npmjs.com/package/snaptrade-typescript-sdk/v/11.0.2)
10
10
  [![More Info](https://img.shields.io/badge/More%20Info-Click%20Here-orange)](https://snaptrade.com/)
11
11
 
12
12
  </div>
@@ -218,6 +218,8 @@ main();
218
218
 
219
219
  ### `snaptrade.accountInformation.getAccountActivities`<a id="snaptradeaccountinformationgetaccountactivities"></a>
220
220
 
221
+ This endpoint is not deprecated and has no planned sunset. Responses to requests using the legacy `/api/v1` path prefix include `Deprecation: @1781222400` (June 12, 2026); that header applies only to the path prefix. Use the canonical root path `/accounts/{accountId}/activities`.
222
+
221
223
  Returns all historical transactions for the specified account.
222
224
 
223
225
  This endpoint is paginated with a default page size of 1000. The endpoint will return a maximum of 1000 transactions per request. See the query parameters for pagination options.
@@ -263,7 +265,7 @@ An integer that specifies the maximum number of transactions to return. Default
263
265
 
264
266
  ##### type: `string`<a id="type-string"></a>
265
267
 
266
- Optional comma separated list of transaction types to filter by. SnapTrade does a best effort to categorize brokerage transaction types into a common set of values. Here are some of the most popular values: - `BUY` - Asset bought. - `SELL` - Asset sold. - `DIVIDEND` - Dividend payout. - `CONTRIBUTION` - Cash contribution. - `WITHDRAWAL` - Cash withdrawal. - `REI` - Dividend reinvestment. - `STOCK_DIVIDEND` - A type of dividend where a company distributes shares instead of cash - `INTEREST` - Interest deposited into the account. - `FEE` - Fee withdrawn from the account. - `TAX` - A tax related fee. - `OPTIONEXPIRATION` - Option expiration event. - `OPTIONASSIGNMENT` - Option assignment event. - `OPTIONEXERCISE` - Option exercise event. - `TRANSFER` - Transfer of assets from one account to another. - `SPLIT` - A stock share split.
268
+ Optional comma separated list of transaction types to filter by. SnapTrade does a best effort to categorize brokerage transaction types into a common set of values. Here are some of the most popular values: - `BUY` - Asset bought. - `SELL` - Asset sold. - `DIVIDEND` - Dividend payout. - `SUBSTITUTE_DIVIDEND` - Payment in lieu of a dividend. - `CONTRIBUTION` - Cash contribution. - `WITHDRAWAL` - Cash withdrawal. - `REI` - Dividend reinvestment. - `STOCK_DIVIDEND` - A type of dividend where a company distributes shares instead of cash - `INTEREST` - Interest deposited into the account. - `FEE` - Fee withdrawn from the account. - `TAX` - A tax related fee. - `OPTIONEXPIRATION` - Option expiration event. - `OPTIONASSIGNMENT` - Option assignment event. - `OPTIONEXERCISE` - Option exercise event. - `TRANSFER` - Transfer of assets from one account to another. - `SPLIT` - A stock share split.
267
269
 
268
270
  #### 🔄 Return<a id="🔄-return"></a>
269
271
 
@@ -349,13 +351,13 @@ const getAllAccountPositionsResponse =
349
351
  ### `snaptrade.accountInformation.getAllUserHoldings`<a id="snaptradeaccountinformationgetalluserholdings"></a>
350
352
  ![Deprecated](https://img.shields.io/badge/deprecated-yellow)
351
353
 
352
- **Deprecated, please use the account-specific holdings endpoint instead.**
354
+ **Deprecated.** Use the account-specific holdings endpoint instead.
355
+
356
+ This endpoint will return HTTP 410 Gone for all customers that sign up after April 25, 2026.
353
357
 
354
358
  List all accounts for the user, plus balances, positions, and orders for each
355
359
  account.
356
360
 
357
- **Note:** This endpoint will return HTTP 410 Gone for all customers that sign up after April 25, 2026.
358
-
359
361
 
360
362
  #### 🛠️ Usage<a id="🛠️-usage"></a>
361
363
 
@@ -551,9 +553,9 @@ Number of days in the past to fetch the most recent orders. Defaults to the last
551
553
  ### `snaptrade.accountInformation.getUserAccountPositions`<a id="snaptradeaccountinformationgetuseraccountpositions"></a>
552
554
  ![Deprecated](https://img.shields.io/badge/deprecated-yellow)
553
555
 
554
- Returns a list of stock/ETF/crypto/mutual fund positions in the specified account. For option positions, please use the [options endpoint](/reference/Options/Options_listOptionHoldings).
556
+ **Deprecated.** Use the newer [unified positions endpoint](/reference/Account%20Information/AccountInformation_getAllAccountPositions) instead. This will allow you to get both equity and option positions in a single call, as well as additional asset classes such as futures.
555
557
 
556
- This endpoint is deprecated. Consider using the newer [unified positions endpoint](/reference/Account%20Information/AccountInformation_getAllAccountPositions). This will allow you to get both equity and option positions in a single call, as well as additional asset classes such as futures.
558
+ Returns a list of stock/ETF/crypto/mutual fund positions in the specified account. For option positions, please use the [options endpoint](/reference/Options/Options_listOptionHoldings).
557
559
 
558
560
  Check your API key on the [Customer Dashboard billing page](https://dashboard.snaptrade.com/settings/billing) to see if you have real-time data access:
559
561
  - If you do, this endpoint returns real-time data.
@@ -666,6 +668,9 @@ Optional comma separated list of rate-of-return timeframes to return. Supported
666
668
  ![Deprecated](https://img.shields.io/badge/deprecated-yellow)
667
669
 
668
670
  **Deprecated.** Use the finer-grained account data endpoints instead: [balances](/reference/Account%20Information/AccountInformation_getUserAccountBalance), [positions](/reference/Account%20Information/AccountInformation_getAllAccountPositions), and [orders](/reference/Account%20Information/AccountInformation_getUserAccountOrders).
671
+
672
+ This endpoint will return HTTP 410 Gone for all customers that sign up after May 11, 2026.
673
+
669
674
  Returns a list of balances, positions, and recent orders for the specified account.
670
675
 
671
676
  Check your API key on the [Customer Dashboard billing page](https://dashboard.snaptrade.com/settings/billing) to see if you have real-time data access:
@@ -1521,9 +1526,9 @@ const listSubscriptionsResponse =
1521
1526
  ### `snaptrade.options.listOptionHoldings`<a id="snaptradeoptionslistoptionholdings"></a>
1522
1527
  ![Deprecated](https://img.shields.io/badge/deprecated-yellow)
1523
1528
 
1524
- Returns a list of option positions in the specified account. For stock/ETF/crypto/mutual fund positions, please use the [positions endpoint](/reference/Account%20Information/AccountInformation_getUserAccountPositions).
1529
+ **Deprecated.** Use the newer [unified positions endpoint](/reference/Account%20Information/AccountInformation_getAllAccountPositions) instead. This will allow you to get both equity and option positions in a single call, as well as additional asset classes such as futures.
1525
1530
 
1526
- This endpoint is deprecated. Consider using the newer [unified positions endpoint](/reference/Account%20Information/AccountInformation_getAllAccountPositions). This will allow you to get both equity and option positions in a single call, as well as additional asset classes such as futures.
1531
+ Returns a list of option positions in the specified account. For stock/ETF/crypto/mutual fund positions, please use the [positions endpoint](/reference/Account%20Information/AccountInformation_getUserAccountPositions).
1527
1532
 
1528
1533
  Check your API key on the [Customer Dashboard billing page](https://dashboard.snaptrade.com/settings/billing) to see if you have real-time data access:
1529
1534
  - If you do, this endpoint returns real-time data.
@@ -1935,7 +1940,8 @@ Order ID returned by brokerage. This is the unique identifier for the order in t
1935
1940
  ### `snaptrade.trading.cancelUserAccountOrder`<a id="snaptradetradingcanceluseraccountorder"></a>
1936
1941
  ![Deprecated](https://img.shields.io/badge/deprecated-yellow)
1937
1942
 
1938
- **This endpoint is deprecated. Please switch to [the new cancel order endpoint](/reference/Trading/Trading_cancelOrder) **
1943
+ **Deprecated.** Use [the new cancel order endpoint](/reference/Trading/Trading_cancelOrder) instead.
1944
+
1939
1945
  Attempts to cancel an open order with the brokerage. If the order is no longer cancellable, the request will be rejected.
1940
1946
 
1941
1947
 
@@ -2183,8 +2189,6 @@ The quotes returned can be delayed depending on the brokerage the account belong
2183
2189
 
2184
2190
  This endpoint does not work for options quotes.
2185
2191
 
2186
- This endpoint is disabled for free plans by default. Please contact support to enable this endpoint if needed.
2187
-
2188
2192
 
2189
2193
  #### 🛠️ Usage<a id="🛠️-usage"></a>
2190
2194
 
@@ -2224,7 +2228,8 @@ Should be set to `True` if `symbols` are comprised of tickers. Defaults to `Fals
2224
2228
  ### `snaptrade.trading.placeBracketOrder`<a id="snaptradetradingplacebracketorder"></a>
2225
2229
  ![Deprecated](https://img.shields.io/badge/deprecated-yellow)
2226
2230
 
2227
- **This endpoint is deprecated. Please switch to [the new complex order endpoint](/reference/Trading/Trading_placeComplexOrder) **
2231
+ **Deprecated.** Use [the new complex order endpoint](/reference/Trading/Trading_placeComplexOrder) instead.
2232
+
2228
2233
  Places a bracket order (entry order + OCO of stop loss and take profit). Disabled by default please contact support for
2229
2234
  use. Only supported on certain brokerages
2230
2235
 
@@ -2828,7 +2833,9 @@ const searchCryptocurrencyPairInstrumentsResponse =
2828
2833
  ### `snaptrade.transactionsAndReporting.getActivities`<a id="snaptradetransactionsandreportinggetactivities"></a>
2829
2834
  ![Deprecated](https://img.shields.io/badge/deprecated-yellow)
2830
2835
 
2831
- This endpoint is being deprecated but will continue to be available for use via SDKs, please use [the account level endpoint](/reference/Account%20Information/AccountInformation_getAccountActivities) if possible
2836
+ **Deprecated.** Use [the account level endpoint](/reference/Account%20Information/AccountInformation_getAccountActivities) instead, if possible.
2837
+
2838
+ This endpoint will return HTTP 410 Gone for all customers that sign up after April 25, 2026.
2832
2839
 
2833
2840
  Returns all historical transactions for the specified user and filtering criteria. It's recommended to use `startDate` and `endDate` to paginate through the data, as the response may be very large for accounts with a long history and/or a lot of activity. There's a max number of 10000 transactions returned per request.
2834
2841
 
@@ -2836,8 +2843,6 @@ There is no guarantee to the ordering of the transactions returned. Please sort
2836
2843
 
2837
2844
  This endpoint returns Daily data. Daily data is cached and refreshed once a day. Exact refresh timing may vary by brokerage.
2838
2845
 
2839
- **Note:** This endpoint will return HTTP 410 Gone for all customers that sign up after April 25, 2026.
2840
-
2841
2846
 
2842
2847
  #### 🛠️ Usage<a id="🛠️-usage"></a>
2843
2848
 
@@ -2874,7 +2879,7 @@ Optional comma separated list of SnapTrade Connection (Brokerage Authorization)
2874
2879
 
2875
2880
  ##### type: `string`<a id="type-string"></a>
2876
2881
 
2877
- Optional comma separated list of transaction types to filter by. SnapTrade does a best effort to categorize brokerage transaction types into a common set of values. Here are some of the most popular values: - `BUY` - Asset bought. - `SELL` - Asset sold. - `DIVIDEND` - Dividend payout. - `CONTRIBUTION` - Cash contribution. - `WITHDRAWAL` - Cash withdrawal. - `REI` - Dividend reinvestment. - `INTEREST` - Interest deposited into the account. - `FEE` - Fee withdrawn from the account. - `OPTIONEXPIRATION` - Option expiration event. - `OPTIONASSIGNMENT` - Option assignment event. - `OPTIONEXERCISE` - Option exercise event. - `TRANSFER` - Transfer of assets from one account to another
2882
+ Optional comma separated list of transaction types to filter by. SnapTrade does a best effort to categorize brokerage transaction types into a common set of values. Here are some of the most popular values: - `BUY` - Asset bought. - `SELL` - Asset sold. - `DIVIDEND` - Dividend payout. - `SUBSTITUTE_DIVIDEND` - Payment in lieu of a dividend. - `CONTRIBUTION` - Cash contribution. - `WITHDRAWAL` - Cash withdrawal. - `REI` - Dividend reinvestment. - `INTEREST` - Interest deposited into the account. - `FEE` - Fee withdrawn from the account. - `OPTIONEXPIRATION` - Option expiration event. - `OPTIONASSIGNMENT` - Option assignment event. - `OPTIONEXERCISE` - Option exercise event. - `TRANSFER` - Transfer of assets from one account to another
2878
2883
 
2879
2884
  #### 🔄 Return<a id="🔄-return"></a>
2880
2885
 
@@ -2892,7 +2897,8 @@ Optional comma separated list of transaction types to filter by. SnapTrade does
2892
2897
  ### `snaptrade.transactionsAndReporting.getReportingCustomRange`<a id="snaptradetransactionsandreportinggetreportingcustomrange"></a>
2893
2898
  ![Deprecated](https://img.shields.io/badge/deprecated-yellow)
2894
2899
 
2895
- Returns performance information (contributions, dividends, rate of return, etc) for a specific timeframe. Please note that Total Equity Timeframe and Rate of Returns are experimental features. Please contact support@snaptrade.com if you notice any inconsistencies.
2900
+ **Deprecated.** Returns performance information (contributions, dividends, rate of return, etc) for a specific timeframe. Please note that Total Equity Timeframe and Rate of Returns are experimental features. Please contact support@snaptrade.com if you notice any inconsistencies.
2901
+
2896
2902
 
2897
2903
  #### 🛠️ Usage<a id="🛠️-usage"></a>
2898
2904