snaptrade-typescript-sdk 8.29.0 → 8.29.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 +125 -84
- package/dist/api/account-information-api-generated.d.ts +18 -18
- package/dist/api/account-information-api-generated.js +15 -15
- package/dist/api/authentication-api-generated.d.ts +12 -12
- package/dist/api/authentication-api-generated.js +12 -12
- package/dist/api/options-api-generated.d.ts +10 -10
- package/dist/api/options-api-generated.js +5 -5
- package/dist/api/reference-data-api-generated.d.ts +10 -10
- package/dist/api/reference-data-api-generated.js +9 -9
- package/dist/api/trading-api-generated.d.ts +2 -2
- package/dist/api/trading-api-generated.js +1 -1
- package/dist/api/transactions-and-reporting-api-generated.d.ts +4 -4
- package/dist/api/transactions-and-reporting-api-generated.js +4 -4
- package/dist/browser.js +1 -1
- package/dist/configuration.d.ts +5 -0
- package/dist/configuration.js +1 -1
- package/dist/models/index.d.ts +1 -0
- package/dist/models/index.js +1 -0
- package/dist/models/model500-unexpected-exception-response.d.ts +26 -0
- package/dist/models/model500-unexpected-exception-response.js +12 -0
- package/dist/models/options-position.d.ts +0 -12
- package/dist/models/snap-trade-login-user-request-body.d.ts +5 -5
- package/dist/models/snap-trade-register-user-request-body.d.ts +0 -6
- package/package.json +1 -1
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/8.29.2)
|
|
10
10
|
[](https://snaptrade.com/)
|
|
11
11
|
|
|
12
12
|
</div>
|
|
@@ -184,20 +184,21 @@ const getAllUserHoldingsResponse =
|
|
|
184
184
|
Optional. Comma seperated list of authorization IDs (only use if filtering is needed on one or more authorizations).
|
|
185
185
|
|
|
186
186
|
#### 🔄 Return
|
|
187
|
+
|
|
187
188
|
[AccountHoldings](./models/account-holdings.ts)
|
|
188
189
|
|
|
189
190
|
#### 🌐 Endpoint
|
|
190
191
|
|
|
191
192
|
`/holdings` `GET`
|
|
192
193
|
|
|
193
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
194
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
194
195
|
|
|
195
196
|
---
|
|
196
197
|
|
|
197
198
|
|
|
198
199
|
### `snaptrade.accountInformation.getUserAccountBalance`
|
|
199
200
|
|
|
200
|
-
|
|
201
|
+
A list of account balances for the specified account (one per currency that the account holds).
|
|
201
202
|
|
|
202
203
|
#### 🛠️ Usage
|
|
203
204
|
|
|
@@ -218,16 +219,17 @@ const getUserAccountBalanceResponse =
|
|
|
218
219
|
|
|
219
220
|
##### accountId: `string`
|
|
220
221
|
|
|
221
|
-
The ID of the account get
|
|
222
|
+
The ID of the account to get balances.
|
|
222
223
|
|
|
223
224
|
#### 🔄 Return
|
|
225
|
+
|
|
224
226
|
[Balance](./models/balance.ts)
|
|
225
227
|
|
|
226
228
|
#### 🌐 Endpoint
|
|
227
229
|
|
|
228
230
|
`/accounts/{accountId}/balances` `GET`
|
|
229
231
|
|
|
230
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
232
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
231
233
|
|
|
232
234
|
---
|
|
233
235
|
|
|
@@ -258,20 +260,21 @@ const getUserAccountDetailsResponse =
|
|
|
258
260
|
The ID of the account to get detail of.
|
|
259
261
|
|
|
260
262
|
#### 🔄 Return
|
|
263
|
+
|
|
261
264
|
[Account](./models/account.ts)
|
|
262
265
|
|
|
263
266
|
#### 🌐 Endpoint
|
|
264
267
|
|
|
265
268
|
`/accounts/{accountId}` `GET`
|
|
266
269
|
|
|
267
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
270
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
268
271
|
|
|
269
272
|
---
|
|
270
273
|
|
|
271
274
|
|
|
272
275
|
### `snaptrade.accountInformation.getUserAccountOrders`
|
|
273
276
|
|
|
274
|
-
|
|
277
|
+
Fetch all recent orders from a user\'s account.
|
|
275
278
|
|
|
276
279
|
#### 🛠️ Usage
|
|
277
280
|
|
|
@@ -293,20 +296,21 @@ const getUserAccountOrdersResponse =
|
|
|
293
296
|
|
|
294
297
|
##### accountId: `string`
|
|
295
298
|
|
|
296
|
-
The ID of the account get
|
|
299
|
+
The ID of the account to get orders.
|
|
297
300
|
|
|
298
301
|
##### state: `'all' | 'open' | 'executed'`
|
|
299
302
|
|
|
300
303
|
defaults value is set to \"all\"
|
|
301
304
|
|
|
302
305
|
#### 🔄 Return
|
|
306
|
+
|
|
303
307
|
[AccountOrderRecord](./models/account-order-record.ts)
|
|
304
308
|
|
|
305
309
|
#### 🌐 Endpoint
|
|
306
310
|
|
|
307
311
|
`/accounts/{accountId}/orders` `GET`
|
|
308
312
|
|
|
309
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
313
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
310
314
|
|
|
311
315
|
---
|
|
312
316
|
|
|
@@ -334,23 +338,24 @@ const getUserAccountPositionsResponse =
|
|
|
334
338
|
|
|
335
339
|
##### accountId: `string`
|
|
336
340
|
|
|
337
|
-
The ID of the account get positions.
|
|
341
|
+
The ID of the account to get positions.
|
|
338
342
|
|
|
339
343
|
#### 🔄 Return
|
|
344
|
+
|
|
340
345
|
[Position](./models/position.ts)
|
|
341
346
|
|
|
342
347
|
#### 🌐 Endpoint
|
|
343
348
|
|
|
344
349
|
`/accounts/{accountId}/positions` `GET`
|
|
345
350
|
|
|
346
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
351
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
347
352
|
|
|
348
353
|
---
|
|
349
354
|
|
|
350
355
|
|
|
351
356
|
### `snaptrade.accountInformation.getUserHoldings`
|
|
352
357
|
|
|
353
|
-
List balances, positions and orders for the specified account
|
|
358
|
+
List balances, positions and orders for the specified account
|
|
354
359
|
|
|
355
360
|
#### 🛠️ Usage
|
|
356
361
|
|
|
@@ -374,13 +379,14 @@ The ID of the account to fetch holdings for.
|
|
|
374
379
|
##### userSecret: `string`
|
|
375
380
|
|
|
376
381
|
#### 🔄 Return
|
|
382
|
+
|
|
377
383
|
[AccountHoldingsAccount](./models/account-holdings-account.ts)
|
|
378
384
|
|
|
379
385
|
#### 🌐 Endpoint
|
|
380
386
|
|
|
381
387
|
`/accounts/{accountId}/holdings` `GET`
|
|
382
388
|
|
|
383
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
389
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
384
390
|
|
|
385
391
|
---
|
|
386
392
|
|
|
@@ -406,13 +412,14 @@ const listUserAccountsResponse =
|
|
|
406
412
|
##### userSecret: `string`
|
|
407
413
|
|
|
408
414
|
#### 🔄 Return
|
|
415
|
+
|
|
409
416
|
[Account](./models/account.ts)
|
|
410
417
|
|
|
411
418
|
#### 🌐 Endpoint
|
|
412
419
|
|
|
413
420
|
`/accounts` `GET`
|
|
414
421
|
|
|
415
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
422
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
416
423
|
|
|
417
424
|
---
|
|
418
425
|
|
|
@@ -443,13 +450,14 @@ const updateUserAccountResponse =
|
|
|
443
450
|
The ID of the account to update.
|
|
444
451
|
|
|
445
452
|
#### 🔄 Return
|
|
453
|
+
|
|
446
454
|
[Account](./models/account.ts)
|
|
447
455
|
|
|
448
456
|
#### 🌐 Endpoint
|
|
449
457
|
|
|
450
458
|
`/accounts/{accountId}` `PUT`
|
|
451
459
|
|
|
452
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
460
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
453
461
|
|
|
454
462
|
---
|
|
455
463
|
|
|
@@ -465,20 +473,21 @@ const checkResponse = await snaptrade.apiStatus.check();
|
|
|
465
473
|
```
|
|
466
474
|
|
|
467
475
|
#### 🔄 Return
|
|
476
|
+
|
|
468
477
|
[Status](./models/status.ts)
|
|
469
478
|
|
|
470
479
|
#### 🌐 Endpoint
|
|
471
480
|
|
|
472
481
|
`/` `GET`
|
|
473
482
|
|
|
474
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
483
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
475
484
|
|
|
476
485
|
---
|
|
477
486
|
|
|
478
487
|
|
|
479
488
|
### `snaptrade.authentication.deleteSnapTradeUser`
|
|
480
489
|
|
|
481
|
-
|
|
490
|
+
Deletes a user you\'ve registered over the SnapTrade API, and any data associated with them or their investment accounts.
|
|
482
491
|
|
|
483
492
|
#### 🛠️ Usage
|
|
484
493
|
|
|
@@ -494,13 +503,14 @@ const deleteSnapTradeUserResponse =
|
|
|
494
503
|
##### userId: `string`
|
|
495
504
|
|
|
496
505
|
#### 🔄 Return
|
|
506
|
+
|
|
497
507
|
[DeleteUserResponse](./models/delete-user-response.ts)
|
|
498
508
|
|
|
499
509
|
#### 🌐 Endpoint
|
|
500
510
|
|
|
501
511
|
`/snapTrade/deleteUser` `DELETE`
|
|
502
512
|
|
|
503
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
513
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
504
514
|
|
|
505
515
|
---
|
|
506
516
|
|
|
@@ -528,14 +538,14 @@ const getUserJWTResponse = await snaptrade.authentication.getUserJWT({
|
|
|
528
538
|
|
|
529
539
|
`/snapTrade/encryptedJWT` `GET`
|
|
530
540
|
|
|
531
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
541
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
532
542
|
|
|
533
543
|
---
|
|
534
544
|
|
|
535
545
|
|
|
536
546
|
### `snaptrade.authentication.listSnapTradeUsers`
|
|
537
547
|
|
|
538
|
-
|
|
548
|
+
Returns a list of users you\'ve registered over the SnapTrade API.
|
|
539
549
|
|
|
540
550
|
#### 🛠️ Usage
|
|
541
551
|
|
|
@@ -548,14 +558,14 @@ const listSnapTradeUsersResponse =
|
|
|
548
558
|
|
|
549
559
|
`/snapTrade/listUsers` `GET`
|
|
550
560
|
|
|
551
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
561
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
552
562
|
|
|
553
563
|
---
|
|
554
564
|
|
|
555
565
|
|
|
556
566
|
### `snaptrade.authentication.loginSnapTradeUser`
|
|
557
567
|
|
|
558
|
-
|
|
568
|
+
Logs in a SnapTrade user and returns an authenticated connection portal URL for them to use to connect a brokerage account.
|
|
559
569
|
|
|
560
570
|
#### 🛠️ Usage
|
|
561
571
|
|
|
@@ -580,19 +590,29 @@ const loginSnapTradeUserResponse =
|
|
|
580
590
|
|
|
581
591
|
##### broker: `string`
|
|
582
592
|
|
|
593
|
+
Slug of the brokerage to connect the user to
|
|
594
|
+
|
|
583
595
|
##### immediateRedirect: `boolean`
|
|
584
596
|
|
|
597
|
+
When set to True, user will be redirected back to the partner\\\'s site instead of the connection portal
|
|
598
|
+
|
|
585
599
|
##### customRedirect: `string`
|
|
586
600
|
|
|
601
|
+
URL to redirect the user to after the user connects their brokerage account
|
|
602
|
+
|
|
587
603
|
##### reconnect: `string`
|
|
588
604
|
|
|
605
|
+
The UUID of the brokerage connection to be reconnected
|
|
606
|
+
|
|
589
607
|
##### connectionType: `string`
|
|
590
608
|
|
|
609
|
+
Sets whether the connection should be read or trade
|
|
610
|
+
|
|
591
611
|
#### 🌐 Endpoint
|
|
592
612
|
|
|
593
613
|
`/snapTrade/login` `POST`
|
|
594
614
|
|
|
595
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
615
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
596
616
|
|
|
597
617
|
---
|
|
598
618
|
|
|
@@ -607,8 +627,6 @@ Create SnapTrade user
|
|
|
607
627
|
const registerSnapTradeUserResponse =
|
|
608
628
|
await snaptrade.authentication.registerSnapTradeUser({
|
|
609
629
|
userId: "snaptrade-user-123",
|
|
610
|
-
rsaPublicKey:
|
|
611
|
-
"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQC7vbqajDw4o6gJy8UtmIbkcpnkO3Kwc4qsEnSZp/TR+fQi62F79RHWmwKOtFmwteURgLbj7D/WGuNLGOfa/2vse3G2eHnHl5CB8ruRX9fBl/KgwCVr2JaEuUm66bBQeP5XeBotdR4cvX38uPYivCDdPjJ1QWPdspTBKcxeFbccDw==",
|
|
612
630
|
});
|
|
613
631
|
```
|
|
614
632
|
|
|
@@ -618,18 +636,15 @@ const registerSnapTradeUserResponse =
|
|
|
618
636
|
|
|
619
637
|
SnapTrade User ID. Provided by SnapTrade Partner. Can be any string, as long as it\\\'s unique to a user
|
|
620
638
|
|
|
621
|
-
##### rsaPublicKey: `string`
|
|
622
|
-
|
|
623
|
-
Open SSH RSA public key
|
|
624
|
-
|
|
625
639
|
#### 🔄 Return
|
|
640
|
+
|
|
626
641
|
[UserIDandSecret](./models/user-idand-secret.ts)
|
|
627
642
|
|
|
628
643
|
#### 🌐 Endpoint
|
|
629
644
|
|
|
630
645
|
`/snapTrade/registerUser` `POST`
|
|
631
646
|
|
|
632
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
647
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
633
648
|
|
|
634
649
|
---
|
|
635
650
|
|
|
@@ -660,13 +675,14 @@ The ID of a brokerage authorization object.
|
|
|
660
675
|
##### userSecret: `string`
|
|
661
676
|
|
|
662
677
|
#### 🔄 Return
|
|
678
|
+
|
|
663
679
|
[BrokerageAuthorization](./models/brokerage-authorization.ts)
|
|
664
680
|
|
|
665
681
|
#### 🌐 Endpoint
|
|
666
682
|
|
|
667
683
|
`/authorizations/{authorizationId}` `GET`
|
|
668
684
|
|
|
669
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
685
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
670
686
|
|
|
671
687
|
---
|
|
672
688
|
|
|
@@ -692,13 +708,14 @@ const listBrokerageAuthorizationsResponse =
|
|
|
692
708
|
##### userSecret: `string`
|
|
693
709
|
|
|
694
710
|
#### 🔄 Return
|
|
711
|
+
|
|
695
712
|
[BrokerageAuthorization](./models/brokerage-authorization.ts)
|
|
696
713
|
|
|
697
714
|
#### 🌐 Endpoint
|
|
698
715
|
|
|
699
716
|
`/authorizations` `GET`
|
|
700
717
|
|
|
701
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
718
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
702
719
|
|
|
703
720
|
---
|
|
704
721
|
|
|
@@ -732,7 +749,7 @@ The ID of the Authorization to delete.
|
|
|
732
749
|
|
|
733
750
|
`/authorizations/{authorizationId}` `DELETE`
|
|
734
751
|
|
|
735
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
752
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
736
753
|
|
|
737
754
|
---
|
|
738
755
|
|
|
@@ -769,7 +786,7 @@ Optional comma seperated list of session IDs used to filter the request on speci
|
|
|
769
786
|
|
|
770
787
|
`/sessionEvents` `GET`
|
|
771
788
|
|
|
772
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
789
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
773
790
|
|
|
774
791
|
---
|
|
775
792
|
|
|
@@ -794,13 +811,14 @@ const listUserErrorsResponse = await snaptrade.errorLogs.listUserErrors({
|
|
|
794
811
|
##### userSecret: `string`
|
|
795
812
|
|
|
796
813
|
#### 🔄 Return
|
|
814
|
+
|
|
797
815
|
[UserErrorLog](./models/user-error-log.ts)
|
|
798
816
|
|
|
799
817
|
#### 🌐 Endpoint
|
|
800
818
|
|
|
801
819
|
`/snapTrade/listUserErrors` `GET`
|
|
802
820
|
|
|
803
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
821
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
804
822
|
|
|
805
823
|
---
|
|
806
824
|
|
|
@@ -830,11 +848,12 @@ const getOptionStrategyResponse = await snaptrade.options.getOptionStrategy({
|
|
|
830
848
|
|
|
831
849
|
#### ⚙️ Parameters
|
|
832
850
|
|
|
833
|
-
#####
|
|
851
|
+
##### underlying_symbol_id: `string`
|
|
834
852
|
|
|
835
|
-
##### legs:
|
|
853
|
+
##### legs: `OptionLeg`
|
|
854
|
+
[`OptionLeg`](./models/option-leg.ts)[]
|
|
836
855
|
|
|
837
|
-
#####
|
|
856
|
+
##### strategy_type: `string`
|
|
838
857
|
|
|
839
858
|
##### userId: `string`
|
|
840
859
|
|
|
@@ -842,16 +861,17 @@ const getOptionStrategyResponse = await snaptrade.options.getOptionStrategy({
|
|
|
842
861
|
|
|
843
862
|
##### accountId: `string`
|
|
844
863
|
|
|
845
|
-
The ID of the account
|
|
864
|
+
The ID of the account to create the option strategy object in.
|
|
846
865
|
|
|
847
866
|
#### 🔄 Return
|
|
867
|
+
|
|
848
868
|
[StrategyQuotes](./models/strategy-quotes.ts)
|
|
849
869
|
|
|
850
870
|
#### 🌐 Endpoint
|
|
851
871
|
|
|
852
872
|
`/accounts/{accountId}/optionStrategy` `POST`
|
|
853
873
|
|
|
854
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
874
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
855
875
|
|
|
856
876
|
---
|
|
857
877
|
|
|
@@ -879,7 +899,7 @@ const getOptionsChainResponse = await snaptrade.options.getOptionsChain({
|
|
|
879
899
|
|
|
880
900
|
##### accountId: `string`
|
|
881
901
|
|
|
882
|
-
The ID of the account get
|
|
902
|
+
The ID of the account to get the options chain from.
|
|
883
903
|
|
|
884
904
|
##### symbol: `string`
|
|
885
905
|
|
|
@@ -889,7 +909,7 @@ Universal symbol ID if symbol
|
|
|
889
909
|
|
|
890
910
|
`/accounts/{accountId}/optionsChain` `GET`
|
|
891
911
|
|
|
892
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
912
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
893
913
|
|
|
894
914
|
---
|
|
895
915
|
|
|
@@ -918,20 +938,21 @@ const getOptionsStrategyQuoteResponse =
|
|
|
918
938
|
|
|
919
939
|
##### accountId: `string`
|
|
920
940
|
|
|
921
|
-
The ID of the account
|
|
941
|
+
The ID of the account the strategy will be placed in.
|
|
922
942
|
|
|
923
943
|
##### optionStrategyId: `string`
|
|
924
944
|
|
|
925
945
|
Option strategy id obtained from response when creating option strategy object
|
|
926
946
|
|
|
927
947
|
#### 🔄 Return
|
|
948
|
+
|
|
928
949
|
[StrategyQuotes](./models/strategy-quotes.ts)
|
|
929
950
|
|
|
930
951
|
#### 🌐 Endpoint
|
|
931
952
|
|
|
932
953
|
`/accounts/{accountId}/optionStrategy/{optionStrategyId}` `GET`
|
|
933
954
|
|
|
934
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
955
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
935
956
|
|
|
936
957
|
---
|
|
937
958
|
|
|
@@ -958,16 +979,17 @@ const listOptionHoldingsResponse = await snaptrade.options.listOptionHoldings({
|
|
|
958
979
|
|
|
959
980
|
##### accountId: `string`
|
|
960
981
|
|
|
961
|
-
The ID of the account
|
|
982
|
+
The ID of the account to fetch options holdings for.
|
|
962
983
|
|
|
963
984
|
#### 🔄 Return
|
|
985
|
+
|
|
964
986
|
[OptionsPosition](./models/options-position.ts)
|
|
965
987
|
|
|
966
988
|
#### 🌐 Endpoint
|
|
967
989
|
|
|
968
990
|
`/accounts/{accountId}/options` `GET`
|
|
969
991
|
|
|
970
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
992
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
971
993
|
|
|
972
994
|
---
|
|
973
995
|
|
|
@@ -994,9 +1016,9 @@ const placeOptionStrategyResponse = await snaptrade.options.placeOptionStrategy(
|
|
|
994
1016
|
|
|
995
1017
|
#### ⚙️ Parameters
|
|
996
1018
|
|
|
997
|
-
#####
|
|
1019
|
+
##### order_type: `string`
|
|
998
1020
|
|
|
999
|
-
#####
|
|
1021
|
+
##### time_in_force: `string`
|
|
1000
1022
|
|
|
1001
1023
|
##### price: `number`
|
|
1002
1024
|
|
|
@@ -1008,20 +1030,21 @@ Trade Price if limit or stop limit order
|
|
|
1008
1030
|
|
|
1009
1031
|
##### accountId: `string`
|
|
1010
1032
|
|
|
1011
|
-
The ID of the account
|
|
1033
|
+
The ID of the account to execute the strategy in.
|
|
1012
1034
|
|
|
1013
1035
|
##### optionStrategyId: `string`
|
|
1014
1036
|
|
|
1015
1037
|
Option strategy id obtained from response when creating option strategy object
|
|
1016
1038
|
|
|
1017
1039
|
#### 🔄 Return
|
|
1040
|
+
|
|
1018
1041
|
[StrategyOrderRecord](./models/strategy-order-record.ts)
|
|
1019
1042
|
|
|
1020
1043
|
#### 🌐 Endpoint
|
|
1021
1044
|
|
|
1022
1045
|
`/accounts/{accountId}/optionStrategy/{optionStrategyId}/execute` `POST`
|
|
1023
1046
|
|
|
1024
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1047
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1025
1048
|
|
|
1026
1049
|
---
|
|
1027
1050
|
|
|
@@ -1046,13 +1069,14 @@ const getCurrencyExchangeRatePairResponse =
|
|
|
1046
1069
|
A currency pair based on currency code for example, {CAD-USD}
|
|
1047
1070
|
|
|
1048
1071
|
#### 🔄 Return
|
|
1072
|
+
|
|
1049
1073
|
[ExchangeRatePairs](./models/exchange-rate-pairs.ts)
|
|
1050
1074
|
|
|
1051
1075
|
#### 🌐 Endpoint
|
|
1052
1076
|
|
|
1053
1077
|
`/currencies/rates/{currencyPair}` `GET`
|
|
1054
1078
|
|
|
1055
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1079
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1056
1080
|
|
|
1057
1081
|
---
|
|
1058
1082
|
|
|
@@ -1068,20 +1092,21 @@ const getPartnerInfoResponse = await snaptrade.referenceData.getPartnerInfo();
|
|
|
1068
1092
|
```
|
|
1069
1093
|
|
|
1070
1094
|
#### 🔄 Return
|
|
1095
|
+
|
|
1071
1096
|
[PartnerData](./models/partner-data.ts)
|
|
1072
1097
|
|
|
1073
1098
|
#### 🌐 Endpoint
|
|
1074
1099
|
|
|
1075
1100
|
`/snapTrade/partners` `GET`
|
|
1076
1101
|
|
|
1077
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1102
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1078
1103
|
|
|
1079
1104
|
---
|
|
1080
1105
|
|
|
1081
1106
|
|
|
1082
1107
|
### `snaptrade.referenceData.getSecurityTypes`
|
|
1083
1108
|
|
|
1084
|
-
List
|
|
1109
|
+
List security types available on SnapTrade.
|
|
1085
1110
|
|
|
1086
1111
|
#### 🛠️ Usage
|
|
1087
1112
|
|
|
@@ -1091,13 +1116,14 @@ const getSecurityTypesResponse =
|
|
|
1091
1116
|
```
|
|
1092
1117
|
|
|
1093
1118
|
#### 🔄 Return
|
|
1119
|
+
|
|
1094
1120
|
[SecurityType](./models/security-type.ts)
|
|
1095
1121
|
|
|
1096
1122
|
#### 🌐 Endpoint
|
|
1097
1123
|
|
|
1098
1124
|
`/securityTypes` `GET`
|
|
1099
1125
|
|
|
1100
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1126
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1101
1127
|
|
|
1102
1128
|
---
|
|
1103
1129
|
|
|
@@ -1114,13 +1140,14 @@ const getStockExchangesResponse =
|
|
|
1114
1140
|
```
|
|
1115
1141
|
|
|
1116
1142
|
#### 🔄 Return
|
|
1143
|
+
|
|
1117
1144
|
[Exchange](./models/exchange.ts)
|
|
1118
1145
|
|
|
1119
1146
|
#### 🌐 Endpoint
|
|
1120
1147
|
|
|
1121
1148
|
`/exchanges` `GET`
|
|
1122
1149
|
|
|
1123
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1150
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1124
1151
|
|
|
1125
1152
|
---
|
|
1126
1153
|
|
|
@@ -1142,13 +1169,14 @@ const getSymbolsResponse = await snaptrade.referenceData.getSymbols({
|
|
|
1142
1169
|
##### substring: `string`
|
|
1143
1170
|
|
|
1144
1171
|
#### 🔄 Return
|
|
1172
|
+
|
|
1145
1173
|
[UniversalSymbol](./models/universal-symbol.ts)
|
|
1146
1174
|
|
|
1147
1175
|
#### 🌐 Endpoint
|
|
1148
1176
|
|
|
1149
1177
|
`/symbols` `POST`
|
|
1150
1178
|
|
|
1151
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1179
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1152
1180
|
|
|
1153
1181
|
---
|
|
1154
1182
|
|
|
@@ -1177,13 +1205,14 @@ The ticker of the UniversalSymbol to get.
|
|
|
1177
1205
|
OPTIONAL IN PATH Can be used instead of the ticker ; The ID of the UniversalSymbol to get.
|
|
1178
1206
|
|
|
1179
1207
|
#### 🔄 Return
|
|
1208
|
+
|
|
1180
1209
|
[UniversalSymbol](./models/universal-symbol.ts)
|
|
1181
1210
|
|
|
1182
1211
|
#### 🌐 Endpoint
|
|
1183
1212
|
|
|
1184
1213
|
`/symbols/{ticker}` `GET`
|
|
1185
1214
|
|
|
1186
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1215
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1187
1216
|
|
|
1188
1217
|
---
|
|
1189
1218
|
|
|
@@ -1208,13 +1237,14 @@ const listAllBrokerageAuthorizationTypeResponse =
|
|
|
1208
1237
|
Comma separated value of brokerage slugs
|
|
1209
1238
|
|
|
1210
1239
|
#### 🔄 Return
|
|
1240
|
+
|
|
1211
1241
|
[BrokerageAuthorizationTypeReadOnly](./models/brokerage-authorization-type-read-only.ts)
|
|
1212
1242
|
|
|
1213
1243
|
#### 🌐 Endpoint
|
|
1214
1244
|
|
|
1215
1245
|
`/brokerageAuthorizationTypes` `GET`
|
|
1216
1246
|
|
|
1217
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1247
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1218
1248
|
|
|
1219
1249
|
---
|
|
1220
1250
|
|
|
@@ -1231,13 +1261,14 @@ const listAllBrokeragesResponse =
|
|
|
1231
1261
|
```
|
|
1232
1262
|
|
|
1233
1263
|
#### 🔄 Return
|
|
1264
|
+
|
|
1234
1265
|
[Brokerage](./models/brokerage.ts)
|
|
1235
1266
|
|
|
1236
1267
|
#### 🌐 Endpoint
|
|
1237
1268
|
|
|
1238
1269
|
`/brokerages` `GET`
|
|
1239
1270
|
|
|
1240
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1271
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1241
1272
|
|
|
1242
1273
|
---
|
|
1243
1274
|
|
|
@@ -1254,13 +1285,14 @@ const listAllCurrenciesResponse =
|
|
|
1254
1285
|
```
|
|
1255
1286
|
|
|
1256
1287
|
#### 🔄 Return
|
|
1288
|
+
|
|
1257
1289
|
[Currency](./models/currency.ts)
|
|
1258
1290
|
|
|
1259
1291
|
#### 🌐 Endpoint
|
|
1260
1292
|
|
|
1261
1293
|
`/currencies` `GET`
|
|
1262
1294
|
|
|
1263
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1295
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1264
1296
|
|
|
1265
1297
|
---
|
|
1266
1298
|
|
|
@@ -1277,13 +1309,14 @@ const listAllCurrenciesRatesResponse =
|
|
|
1277
1309
|
```
|
|
1278
1310
|
|
|
1279
1311
|
#### 🔄 Return
|
|
1312
|
+
|
|
1280
1313
|
[ExchangeRatePairs](./models/exchange-rate-pairs.ts)
|
|
1281
1314
|
|
|
1282
1315
|
#### 🌐 Endpoint
|
|
1283
1316
|
|
|
1284
1317
|
`/currencies/rates` `GET`
|
|
1285
1318
|
|
|
1286
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1319
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1287
1320
|
|
|
1288
1321
|
---
|
|
1289
1322
|
|
|
@@ -1312,18 +1345,19 @@ const symbolSearchUserAccountResponse =
|
|
|
1312
1345
|
|
|
1313
1346
|
##### accountId: `string`
|
|
1314
1347
|
|
|
1315
|
-
The ID of the account
|
|
1348
|
+
The ID of the account to search for symbols within.
|
|
1316
1349
|
|
|
1317
1350
|
##### substring: `string`
|
|
1318
1351
|
|
|
1319
1352
|
#### 🔄 Return
|
|
1353
|
+
|
|
1320
1354
|
[UniversalSymbol](./models/universal-symbol.ts)
|
|
1321
1355
|
|
|
1322
1356
|
#### 🌐 Endpoint
|
|
1323
1357
|
|
|
1324
1358
|
`/accounts/{accountId}/symbols` `POST`
|
|
1325
1359
|
|
|
1326
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1360
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1327
1361
|
|
|
1328
1362
|
---
|
|
1329
1363
|
|
|
@@ -1352,18 +1386,19 @@ const cancelUserAccountOrderResponse =
|
|
|
1352
1386
|
|
|
1353
1387
|
##### accountId: `string`
|
|
1354
1388
|
|
|
1355
|
-
The ID of the account
|
|
1389
|
+
The ID of the account to cancel the order in.
|
|
1356
1390
|
|
|
1357
|
-
#####
|
|
1391
|
+
##### brokerage_order_id: `string`
|
|
1358
1392
|
|
|
1359
1393
|
#### 🔄 Return
|
|
1394
|
+
|
|
1360
1395
|
[AccountOrderRecord](./models/account-order-record.ts)
|
|
1361
1396
|
|
|
1362
1397
|
#### 🌐 Endpoint
|
|
1363
1398
|
|
|
1364
1399
|
`/accounts/{accountId}/orders/cancel` `POST`
|
|
1365
1400
|
|
|
1366
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1401
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1367
1402
|
|
|
1368
1403
|
---
|
|
1369
1404
|
|
|
@@ -1394,11 +1429,11 @@ const getOrderImpactResponse = await snaptrade.trading.getOrderImpact({
|
|
|
1394
1429
|
|
|
1395
1430
|
##### userSecret: `string`
|
|
1396
1431
|
|
|
1397
|
-
#####
|
|
1432
|
+
##### account_id: `string`
|
|
1398
1433
|
|
|
1399
1434
|
##### action:
|
|
1400
1435
|
|
|
1401
|
-
#####
|
|
1436
|
+
##### order_type:
|
|
1402
1437
|
|
|
1403
1438
|
##### price: `number`
|
|
1404
1439
|
|
|
@@ -1408,22 +1443,23 @@ Trade Price if limit or stop limit order
|
|
|
1408
1443
|
|
|
1409
1444
|
Stop Price. If stop loss or stop limit order, the price to trigger the stop
|
|
1410
1445
|
|
|
1411
|
-
#####
|
|
1446
|
+
##### time_in_force:
|
|
1412
1447
|
|
|
1413
1448
|
##### units: `number`
|
|
1414
1449
|
|
|
1415
1450
|
Trade Units
|
|
1416
1451
|
|
|
1417
|
-
#####
|
|
1452
|
+
##### universal_symbol_id: `string`
|
|
1418
1453
|
|
|
1419
1454
|
#### 🔄 Return
|
|
1455
|
+
|
|
1420
1456
|
[ManualTradeAndImpact](./models/manual-trade-and-impact.ts)
|
|
1421
1457
|
|
|
1422
1458
|
#### 🌐 Endpoint
|
|
1423
1459
|
|
|
1424
1460
|
`/trade/impact` `POST`
|
|
1425
1461
|
|
|
1426
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1462
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1427
1463
|
|
|
1428
1464
|
---
|
|
1429
1465
|
|
|
@@ -1466,7 +1502,7 @@ Should be set to True if providing tickers.
|
|
|
1466
1502
|
|
|
1467
1503
|
`/accounts/{accountId}/quotes` `GET`
|
|
1468
1504
|
|
|
1469
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1505
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1470
1506
|
|
|
1471
1507
|
---
|
|
1472
1508
|
|
|
@@ -1497,11 +1533,11 @@ const placeForceOrderResponse = await snaptrade.trading.placeForceOrder({
|
|
|
1497
1533
|
|
|
1498
1534
|
##### userSecret: `string`
|
|
1499
1535
|
|
|
1500
|
-
#####
|
|
1536
|
+
##### account_id: `string`
|
|
1501
1537
|
|
|
1502
1538
|
##### action:
|
|
1503
1539
|
|
|
1504
|
-
#####
|
|
1540
|
+
##### order_type:
|
|
1505
1541
|
|
|
1506
1542
|
##### price: `number`
|
|
1507
1543
|
|
|
@@ -1511,22 +1547,23 @@ Trade Price if limit or stop limit order
|
|
|
1511
1547
|
|
|
1512
1548
|
Stop Price. If stop loss or stop limit order, the price to trigger the stop
|
|
1513
1549
|
|
|
1514
|
-
#####
|
|
1550
|
+
##### time_in_force:
|
|
1515
1551
|
|
|
1516
1552
|
##### units: `number`
|
|
1517
1553
|
|
|
1518
1554
|
Trade Units
|
|
1519
1555
|
|
|
1520
|
-
#####
|
|
1556
|
+
##### universal_symbol_id: `string`
|
|
1521
1557
|
|
|
1522
1558
|
#### 🔄 Return
|
|
1559
|
+
|
|
1523
1560
|
[AccountOrderRecord](./models/account-order-record.ts)
|
|
1524
1561
|
|
|
1525
1562
|
#### 🌐 Endpoint
|
|
1526
1563
|
|
|
1527
1564
|
`/trade/place` `POST`
|
|
1528
1565
|
|
|
1529
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1566
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1530
1567
|
|
|
1531
1568
|
---
|
|
1532
1569
|
|
|
@@ -1550,22 +1587,23 @@ const placeOCOOrderResponse = await snaptrade.trading.placeOCOOrder({
|
|
|
1550
1587
|
|
|
1551
1588
|
##### userSecret: `string`
|
|
1552
1589
|
|
|
1553
|
-
#####
|
|
1590
|
+
##### first_trade_id:
|
|
1554
1591
|
|
|
1555
1592
|
The ID of first trade object obtained from trade/impact endpoint
|
|
1556
1593
|
|
|
1557
|
-
#####
|
|
1594
|
+
##### second_trade_id:
|
|
1558
1595
|
|
|
1559
1596
|
The ID of second trade object obtained from trade/impact endpoint
|
|
1560
1597
|
|
|
1561
1598
|
#### 🔄 Return
|
|
1599
|
+
|
|
1562
1600
|
[AccountOrderRecord](./models/account-order-record.ts)
|
|
1563
1601
|
|
|
1564
1602
|
#### 🌐 Endpoint
|
|
1565
1603
|
|
|
1566
1604
|
`/trade/oco` `POST`
|
|
1567
1605
|
|
|
1568
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1606
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1569
1607
|
|
|
1570
1608
|
---
|
|
1571
1609
|
|
|
@@ -1595,20 +1633,21 @@ The ID of trade object obtained from trade/impact endpoint
|
|
|
1595
1633
|
##### userSecret: `string`
|
|
1596
1634
|
|
|
1597
1635
|
#### 🔄 Return
|
|
1636
|
+
|
|
1598
1637
|
[AccountOrderRecord](./models/account-order-record.ts)
|
|
1599
1638
|
|
|
1600
1639
|
#### 🌐 Endpoint
|
|
1601
1640
|
|
|
1602
1641
|
`/trade/{tradeId}` `POST`
|
|
1603
1642
|
|
|
1604
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1643
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1605
1644
|
|
|
1606
1645
|
---
|
|
1607
1646
|
|
|
1608
1647
|
|
|
1609
1648
|
### `snaptrade.transactionsAndReporting.getActivities`
|
|
1610
1649
|
|
|
1611
|
-
Returns activities (transactions) for a user. Specifing start and end date is highly recommended for
|
|
1650
|
+
Returns activities (transactions) for a user. Specifing start and end date is highly recommended for better performance
|
|
1612
1651
|
|
|
1613
1652
|
#### 🛠️ Usage
|
|
1614
1653
|
|
|
@@ -1650,13 +1689,14 @@ Optional comma seperated list of brokerage authorization IDs used to filter the
|
|
|
1650
1689
|
Optional comma seperated list of types to filter activities by. This is not an exhaustive list, if we fail to match to these types, we will return the raw description from the brokerage. Potential values include - DIVIDEND - BUY - SELL - CONTRIBUTION - WITHDRAWAL - EXTERNAL_ASSET_TRANSFER_IN - EXTERNAL_ASSET_TRANSFER_OUT - INTERNAL_CASH_TRANSFER_IN - INTERNAL_CASH_TRANSFER_OUT - INTERNAL_ASSET_TRANSFER_IN - INTERNAL_ASSET_TRANSFER_OUT - INTEREST - REBATE - GOV_GRANT - TAX - FEE - REI - FXT
|
|
1651
1690
|
|
|
1652
1691
|
#### 🔄 Return
|
|
1692
|
+
|
|
1653
1693
|
[UniversalActivity](./models/universal-activity.ts)
|
|
1654
1694
|
|
|
1655
1695
|
#### 🌐 Endpoint
|
|
1656
1696
|
|
|
1657
1697
|
`/activities` `GET`
|
|
1658
1698
|
|
|
1659
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1699
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1660
1700
|
|
|
1661
1701
|
---
|
|
1662
1702
|
|
|
@@ -1704,13 +1744,14 @@ Optional, increases frequency of data points for the total value and contributio
|
|
|
1704
1744
|
Optional frequency for the rate of return chart (defaults to monthly). Possible values are daily, weekly, monthly, quarterly, yearly.
|
|
1705
1745
|
|
|
1706
1746
|
#### 🔄 Return
|
|
1747
|
+
|
|
1707
1748
|
[PerformanceCustom](./models/performance-custom.ts)
|
|
1708
1749
|
|
|
1709
1750
|
#### 🌐 Endpoint
|
|
1710
1751
|
|
|
1711
1752
|
`/performance/custom` `GET`
|
|
1712
1753
|
|
|
1713
|
-
[🔙 Back to Table of Contents](#table-of-contents)
|
|
1754
|
+
[🔙 **Back to Table of Contents**](#table-of-contents)
|
|
1714
1755
|
|
|
1715
1756
|
---
|
|
1716
1757
|
|