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 +24 -18
- package/dist/browser.umd.js +7 -7
- package/dist/index.cjs +43 -43
- package/dist/index.d.cts +46 -46
- package/dist/index.d.mts +46 -46
- package/dist/index.d.ts +46 -46
- package/dist/index.mjs +43 -43
- package/package.json +2 -2
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
|
-
[](https://www.npmjs.com/package/snaptrade-typescript-sdk/v/11.0.2)
|
|
10
10
|
[](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
|

|
|
351
353
|
|
|
352
|
-
**Deprecated
|
|
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
|

|
|
553
555
|
|
|
554
|
-
|
|
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
|
-
|
|
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
|

|
|
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
|

|
|
1523
1528
|
|
|
1524
|
-
|
|
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
|
-
|
|
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
|

|
|
1937
1942
|
|
|
1938
|
-
**
|
|
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
|

|
|
2226
2230
|
|
|
2227
|
-
**
|
|
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
|

|
|
2830
2835
|
|
|
2831
|
-
|
|
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
|

|
|
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
|
|