snaptrade-typescript-sdk 9.0.110 → 9.0.112

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-v9.0.110-blue)](https://www.npmjs.com/package/snaptrade-typescript-sdk/v/9.0.110)
9
+ [![npm](https://img.shields.io/badge/npm-v9.0.112-blue)](https://www.npmjs.com/package/snaptrade-typescript-sdk/v/9.0.112)
10
10
  [![More Info](https://img.shields.io/badge/More%20Info-Click%20Here-orange)](https://snaptrade.com/)
11
11
 
12
12
  </div>
@@ -42,9 +42,6 @@ Connect brokerage accounts to your app for live positions and trading
42
42
  * [`snaptrade.connections.removeBrokerageAuthorization`](#snaptradeconnectionsremovebrokerageauthorization)
43
43
  * [`snaptrade.connections.returnRates`](#snaptradeconnectionsreturnrates)
44
44
  * [`snaptrade.connections.sessionEvents`](#snaptradeconnectionssessionevents)
45
- * [`snaptrade.cryptoTrading.getCryptocurrencyPairQuote`](#snaptradecryptotradinggetcryptocurrencypairquote)
46
- * [`snaptrade.cryptoTrading.placeSimpleOrder`](#snaptradecryptotradingplacesimpleorder)
47
- * [`snaptrade.cryptoTrading.searchCryptocurrencyPairInstruments`](#snaptradecryptotradingsearchcryptocurrencypairinstruments)
48
45
  * [`snaptrade.options.getOptionStrategy`](#snaptradeoptionsgetoptionstrategy)
49
46
  * [`snaptrade.options.getOptionsChain`](#snaptradeoptionsgetoptionschain)
50
47
  * [`snaptrade.options.getOptionsStrategyQuote`](#snaptradeoptionsgetoptionsstrategyquote)
@@ -63,14 +60,17 @@ Connect brokerage accounts to your app for live positions and trading
63
60
  * [`snaptrade.referenceData.symbolSearchUserAccount`](#snaptradereferencedatasymbolsearchuseraccount)
64
61
  * [`snaptrade.trading.cancelOrder`](#snaptradetradingcancelorder)
65
62
  * [`snaptrade.trading.cancelUserAccountOrder`](#snaptradetradingcanceluseraccountorder)
63
+ * [`snaptrade.trading.getCryptocurrencyPairQuote`](#snaptradetradinggetcryptocurrencypairquote)
66
64
  * [`snaptrade.trading.getOrderImpact`](#snaptradetradinggetorderimpact)
67
65
  * [`snaptrade.trading.getUserAccountQuotes`](#snaptradetradinggetuseraccountquotes)
68
66
  * [`snaptrade.trading.placeBracketOrder`](#snaptradetradingplacebracketorder)
69
67
  * [`snaptrade.trading.placeForceOrder`](#snaptradetradingplaceforceorder)
70
68
  * [`snaptrade.trading.placeMlegOrder`](#snaptradetradingplacemlegorder)
71
69
  * [`snaptrade.trading.placeOrder`](#snaptradetradingplaceorder)
70
+ * [`snaptrade.trading.placeSimpleOrder`](#snaptradetradingplacesimpleorder)
72
71
  * [`snaptrade.trading.previewSimpleOrder`](#snaptradetradingpreviewsimpleorder)
73
72
  * [`snaptrade.trading.replaceOrder`](#snaptradetradingreplaceorder)
73
+ * [`snaptrade.trading.searchCryptocurrencyPairInstruments`](#snaptradetradingsearchcryptocurrencypairinstruments)
74
74
  * [`snaptrade.transactionsAndReporting.getActivities`](#snaptradetransactionsandreportinggetactivities)
75
75
  * [`snaptrade.transactionsAndReporting.getReportingCustomRange`](#snaptradetransactionsandreportinggetreportingcustomrange)
76
76
 
@@ -1133,174 +1133,6 @@ Optional comma separated list of session IDs used to filter the request on speci
1133
1133
  ---
1134
1134
 
1135
1135
 
1136
- ### `snaptrade.cryptoTrading.getCryptocurrencyPairQuote`<a id="snaptradecryptotradinggetcryptocurrencypairquote"></a>
1137
-
1138
- Gets a quote for the specified account.
1139
-
1140
-
1141
- #### 🛠️ Usage<a id="🛠️-usage"></a>
1142
-
1143
- ```typescript
1144
- const getCryptocurrencyPairQuoteResponse =
1145
- await snaptrade.cryptoTrading.getCryptocurrencyPairQuote({
1146
- userId: "snaptrade-user-123",
1147
- userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
1148
- accountId: "917c8734-8470-4a3e-a18f-57c3f2ee6631",
1149
- instrumentSymbol: "BTC-USD",
1150
- });
1151
- ```
1152
-
1153
- #### ⚙️ Parameters<a id="⚙️-parameters"></a>
1154
-
1155
- ##### userId: `string`<a id="userid-string"></a>
1156
-
1157
- ##### userSecret: `string`<a id="usersecret-string"></a>
1158
-
1159
- ##### accountId: `string`<a id="accountid-string"></a>
1160
-
1161
- ##### instrumentSymbol: `string`<a id="instrumentsymbol-string"></a>
1162
-
1163
- #### 🔄 Return<a id="🔄-return"></a>
1164
-
1165
- [CryptocurrencyPairQuote](./models/cryptocurrency-pair-quote.ts)
1166
-
1167
- #### 🌐 Endpoint<a id="🌐-endpoint"></a>
1168
-
1169
- `/accounts/{accountId}/trading/instruments/cryptocurrencyPairs/{instrumentSymbol}/quote` `GET`
1170
-
1171
- [🔙 **Back to Table of Contents**](#table-of-contents)
1172
-
1173
- ---
1174
-
1175
-
1176
- ### `snaptrade.cryptoTrading.placeSimpleOrder`<a id="snaptradecryptotradingplacesimpleorder"></a>
1177
-
1178
- Places an order in the specified account.
1179
- This endpoint does not compute the impact to the account balance from the order before submitting the order.
1180
-
1181
-
1182
- #### 🛠️ Usage<a id="🛠️-usage"></a>
1183
-
1184
- ```typescript
1185
- const placeSimpleOrderResponse = await snaptrade.cryptoTrading.placeSimpleOrder(
1186
- {
1187
- userId: "snaptrade-user-123",
1188
- userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
1189
- accountId: "917c8734-8470-4a3e-a18f-57c3f2ee6631",
1190
- instrument: {
1191
- symbol: "AAPL",
1192
- type: "EQUITY",
1193
- },
1194
- side: "BUY",
1195
- type: "MARKET",
1196
- time_in_force: "GTC",
1197
- amount: "123.45",
1198
- limit_price: "123.45",
1199
- stop_price: "123.45",
1200
- post_only: false,
1201
- expiration_date: "2024-01-01T00:00:00Z",
1202
- }
1203
- );
1204
- ```
1205
-
1206
- #### ⚙️ Parameters<a id="⚙️-parameters"></a>
1207
-
1208
- ##### instrument: [`TradingInstrument`](./models/trading-instrument.ts)<a id="instrument-tradinginstrumentmodelstrading-instrumentts"></a>
1209
-
1210
- ##### side: [`ActionStrict`](./models/action-strict.ts)<a id="side-actionstrictmodelsaction-strictts"></a>
1211
-
1212
- The action describes the intent or side of a trade. This is either `BUY` or `SELL`.
1213
-
1214
- ##### type: `string`<a id="type-string"></a>
1215
-
1216
- The type of order to place.
1217
-
1218
- ##### time_in_force: `string`<a id="time_in_force-string"></a>
1219
-
1220
- The Time in Force type for the order. This field indicates how long the order will remain active before it is executed or expires. - `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. - `IOC` - Immediate Or Cancel. The order must be executed immediately. Any portion of the order that cannot be filled immediately will be canceled. - `GTD` - Good Til Date. The order is valid until the specified date.
1221
-
1222
- ##### amount: `string`<a id="amount-string"></a>
1223
-
1224
- The amount of the base currency to buy or sell.
1225
-
1226
- ##### userId: `string`<a id="userid-string"></a>
1227
-
1228
- ##### userSecret: `string`<a id="usersecret-string"></a>
1229
-
1230
- ##### accountId: `string`<a id="accountid-string"></a>
1231
-
1232
- ##### limit_price: `string`<a id="limit_price-string"></a>
1233
-
1234
- The limit price. Required if the order type is LIMIT, STOP_LOSS_LIMIT or TAKE_PROFIT_LIMIT.
1235
-
1236
- ##### stop_price: `string`<a id="stop_price-string"></a>
1237
-
1238
- The stop price. Required if the order type is STOP_LOSS_MARKET, STOP_LOSS_LIMIT, TAKE_PROFIT_MARKET or TAKE_PROFIT_LIMIT.
1239
-
1240
- ##### post_only: `boolean`<a id="post_only-boolean"></a>
1241
-
1242
- Valid and required only for order type LIMIT. If true orders that would be filled immediately are rejected to avoid incurring TAKER fees.
1243
-
1244
- ##### expiration_date: `string`<a id="expiration_date-string"></a>
1245
-
1246
- The expiration date of the order. Required if the time_in_force is GTD.
1247
-
1248
- #### 🔄 Return<a id="🔄-return"></a>
1249
-
1250
- [OrderUpdatedResponse](./models/order-updated-response.ts)
1251
-
1252
- #### 🌐 Endpoint<a id="🌐-endpoint"></a>
1253
-
1254
- `/accounts/{accountId}/trading/simple` `POST`
1255
-
1256
- [🔙 **Back to Table of Contents**](#table-of-contents)
1257
-
1258
- ---
1259
-
1260
-
1261
- ### `snaptrade.cryptoTrading.searchCryptocurrencyPairInstruments`<a id="snaptradecryptotradingsearchcryptocurrencypairinstruments"></a>
1262
-
1263
- Searches cryptocurrency pairs instruments accessible to the specified account.
1264
-
1265
-
1266
- #### 🛠️ Usage<a id="🛠️-usage"></a>
1267
-
1268
- ```typescript
1269
- const searchCryptocurrencyPairInstrumentsResponse =
1270
- await snaptrade.cryptoTrading.searchCryptocurrencyPairInstruments({
1271
- userId: "snaptrade-user-123",
1272
- userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
1273
- accountId: "917c8734-8470-4a3e-a18f-57c3f2ee6631",
1274
- base: "BTC",
1275
- quote: "USD",
1276
- });
1277
- ```
1278
-
1279
- #### ⚙️ Parameters<a id="⚙️-parameters"></a>
1280
-
1281
- ##### userId: `string`<a id="userid-string"></a>
1282
-
1283
- ##### userSecret: `string`<a id="usersecret-string"></a>
1284
-
1285
- ##### accountId: `string`<a id="accountid-string"></a>
1286
-
1287
- ##### base: `string`<a id="base-string"></a>
1288
-
1289
- ##### quote: `string`<a id="quote-string"></a>
1290
-
1291
- #### 🔄 Return<a id="🔄-return"></a>
1292
-
1293
- [TradingSearchCryptocurrencyPairInstruments200Response](./models/trading-search-cryptocurrency-pair-instruments200-response.ts)
1294
-
1295
- #### 🌐 Endpoint<a id="🌐-endpoint"></a>
1296
-
1297
- `/accounts/{accountId}/trading/instruments/cryptocurrencyPairs` `GET`
1298
-
1299
- [🔙 **Back to Table of Contents**](#table-of-contents)
1300
-
1301
- ---
1302
-
1303
-
1304
1136
  ### `snaptrade.options.getOptionStrategy`<a id="snaptradeoptionsgetoptionstrategy"></a>
1305
1137
 
1306
1138
  Creates an option strategy object that will be used to place an option strategy order.
@@ -1934,6 +1766,46 @@ Order ID returned by brokerage. This is the unique identifier for the order in t
1934
1766
  ---
1935
1767
 
1936
1768
 
1769
+ ### `snaptrade.trading.getCryptocurrencyPairQuote`<a id="snaptradetradinggetcryptocurrencypairquote"></a>
1770
+
1771
+ Gets a quote for the specified account.
1772
+
1773
+
1774
+ #### 🛠️ Usage<a id="🛠️-usage"></a>
1775
+
1776
+ ```typescript
1777
+ const getCryptocurrencyPairQuoteResponse =
1778
+ await snaptrade.trading.getCryptocurrencyPairQuote({
1779
+ userId: "snaptrade-user-123",
1780
+ userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
1781
+ accountId: "917c8734-8470-4a3e-a18f-57c3f2ee6631",
1782
+ instrumentSymbol: "BTC-USD",
1783
+ });
1784
+ ```
1785
+
1786
+ #### ⚙️ Parameters<a id="⚙️-parameters"></a>
1787
+
1788
+ ##### userId: `string`<a id="userid-string"></a>
1789
+
1790
+ ##### userSecret: `string`<a id="usersecret-string"></a>
1791
+
1792
+ ##### accountId: `string`<a id="accountid-string"></a>
1793
+
1794
+ ##### instrumentSymbol: `string`<a id="instrumentsymbol-string"></a>
1795
+
1796
+ #### 🔄 Return<a id="🔄-return"></a>
1797
+
1798
+ [CryptocurrencyPairQuote](./models/cryptocurrency-pair-quote.ts)
1799
+
1800
+ #### 🌐 Endpoint<a id="🌐-endpoint"></a>
1801
+
1802
+ `/accounts/{accountId}/trading/instruments/cryptocurrencyPairs/{instrumentSymbol}/quote` `GET`
1803
+
1804
+ [🔙 **Back to Table of Contents**](#table-of-contents)
1805
+
1806
+ ---
1807
+
1808
+
1937
1809
  ### `snaptrade.trading.getOrderImpact`<a id="snaptradetradinggetorderimpact"></a>
1938
1810
 
1939
1811
  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.
@@ -2342,6 +2214,89 @@ Optional, defaults to true. Determines if a wait is performed to check on order
2342
2214
  ---
2343
2215
 
2344
2216
 
2217
+ ### `snaptrade.trading.placeSimpleOrder`<a id="snaptradetradingplacesimpleorder"></a>
2218
+
2219
+ Places an order in the specified account.
2220
+ This endpoint does not compute the impact to the account balance from the order before submitting the order.
2221
+
2222
+
2223
+ #### 🛠️ Usage<a id="🛠️-usage"></a>
2224
+
2225
+ ```typescript
2226
+ const placeSimpleOrderResponse = await snaptrade.trading.placeSimpleOrder({
2227
+ userId: "snaptrade-user-123",
2228
+ userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
2229
+ accountId: "917c8734-8470-4a3e-a18f-57c3f2ee6631",
2230
+ instrument: {
2231
+ symbol: "AAPL",
2232
+ type: "EQUITY",
2233
+ },
2234
+ side: "BUY",
2235
+ type: "MARKET",
2236
+ time_in_force: "GTC",
2237
+ amount: "123.45",
2238
+ limit_price: "123.45",
2239
+ stop_price: "123.45",
2240
+ post_only: false,
2241
+ expiration_date: "2024-01-01T00:00:00Z",
2242
+ });
2243
+ ```
2244
+
2245
+ #### ⚙️ Parameters<a id="⚙️-parameters"></a>
2246
+
2247
+ ##### instrument: [`TradingInstrument`](./models/trading-instrument.ts)<a id="instrument-tradinginstrumentmodelstrading-instrumentts"></a>
2248
+
2249
+ ##### side: [`ActionStrict`](./models/action-strict.ts)<a id="side-actionstrictmodelsaction-strictts"></a>
2250
+
2251
+ The action describes the intent or side of a trade. This is either `BUY` or `SELL`.
2252
+
2253
+ ##### type: `string`<a id="type-string"></a>
2254
+
2255
+ The type of order to place.
2256
+
2257
+ ##### time_in_force: `string`<a id="time_in_force-string"></a>
2258
+
2259
+ The Time in Force type for the order. This field indicates how long the order will remain active before it is executed or expires. - `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. - `IOC` - Immediate Or Cancel. The order must be executed immediately. Any portion of the order that cannot be filled immediately will be canceled. - `GTD` - Good Til Date. The order is valid until the specified date.
2260
+
2261
+ ##### amount: `string`<a id="amount-string"></a>
2262
+
2263
+ The amount of the base currency to buy or sell.
2264
+
2265
+ ##### userId: `string`<a id="userid-string"></a>
2266
+
2267
+ ##### userSecret: `string`<a id="usersecret-string"></a>
2268
+
2269
+ ##### accountId: `string`<a id="accountid-string"></a>
2270
+
2271
+ ##### limit_price: `string`<a id="limit_price-string"></a>
2272
+
2273
+ The limit price. Required if the order type is LIMIT, STOP_LOSS_LIMIT or TAKE_PROFIT_LIMIT.
2274
+
2275
+ ##### stop_price: `string`<a id="stop_price-string"></a>
2276
+
2277
+ The stop price. Required if the order type is STOP_LOSS_MARKET, STOP_LOSS_LIMIT, TAKE_PROFIT_MARKET or TAKE_PROFIT_LIMIT.
2278
+
2279
+ ##### post_only: `boolean`<a id="post_only-boolean"></a>
2280
+
2281
+ Valid and required only for order type LIMIT. If true orders that would be filled immediately are rejected to avoid incurring TAKER fees.
2282
+
2283
+ ##### expiration_date: `string`<a id="expiration_date-string"></a>
2284
+
2285
+ The expiration date of the order. Required if the time_in_force is GTD.
2286
+
2287
+ #### 🔄 Return<a id="🔄-return"></a>
2288
+
2289
+ [OrderUpdatedResponse](./models/order-updated-response.ts)
2290
+
2291
+ #### 🌐 Endpoint<a id="🌐-endpoint"></a>
2292
+
2293
+ `/accounts/{accountId}/trading/simple` `POST`
2294
+
2295
+ [🔙 **Back to Table of Contents**](#table-of-contents)
2296
+
2297
+ ---
2298
+
2299
+
2345
2300
  ### `snaptrade.trading.previewSimpleOrder`<a id="snaptradetradingpreviewsimpleorder"></a>
2346
2301
 
2347
2302
  Previews an order using the specified account.
@@ -2502,6 +2457,49 @@ The price at which a stop order is triggered for `Stop` and `StopLimit` orders.
2502
2457
  ---
2503
2458
 
2504
2459
 
2460
+ ### `snaptrade.trading.searchCryptocurrencyPairInstruments`<a id="snaptradetradingsearchcryptocurrencypairinstruments"></a>
2461
+
2462
+ Searches cryptocurrency pairs instruments accessible to the specified account.
2463
+
2464
+
2465
+ #### 🛠️ Usage<a id="🛠️-usage"></a>
2466
+
2467
+ ```typescript
2468
+ const searchCryptocurrencyPairInstrumentsResponse =
2469
+ await snaptrade.trading.searchCryptocurrencyPairInstruments({
2470
+ userId: "snaptrade-user-123",
2471
+ userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
2472
+ accountId: "917c8734-8470-4a3e-a18f-57c3f2ee6631",
2473
+ base: "BTC",
2474
+ quote: "USD",
2475
+ });
2476
+ ```
2477
+
2478
+ #### ⚙️ Parameters<a id="⚙️-parameters"></a>
2479
+
2480
+ ##### userId: `string`<a id="userid-string"></a>
2481
+
2482
+ ##### userSecret: `string`<a id="usersecret-string"></a>
2483
+
2484
+ ##### accountId: `string`<a id="accountid-string"></a>
2485
+
2486
+ ##### base: `string`<a id="base-string"></a>
2487
+
2488
+ ##### quote: `string`<a id="quote-string"></a>
2489
+
2490
+ #### 🔄 Return<a id="🔄-return"></a>
2491
+
2492
+ [TradingSearchCryptocurrencyPairInstruments200Response](./models/trading-search-cryptocurrency-pair-instruments200-response.ts)
2493
+
2494
+ #### 🌐 Endpoint<a id="🌐-endpoint"></a>
2495
+
2496
+ `/accounts/{accountId}/trading/instruments/cryptocurrencyPairs` `GET`
2497
+
2498
+ [🔙 **Back to Table of Contents**](#table-of-contents)
2499
+
2500
+ ---
2501
+
2502
+
2505
2503
  ### `snaptrade.transactionsAndReporting.getActivities`<a id="snaptradetransactionsandreportinggetactivities"></a>
2506
2504
  ![Deprecated](https://img.shields.io/badge/deprecated-yellow)
2507
2505