snaptrade-typescript-sdk 9.0.39 → 9.0.40

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.39-blue)](https://www.npmjs.com/package/snaptrade-typescript-sdk/v/9.0.39)
9
+ [![npm](https://img.shields.io/badge/npm-v9.0.40-blue)](https://www.npmjs.com/package/snaptrade-typescript-sdk/v/9.0.40)
10
10
  [![More Info](https://img.shields.io/badge/More%20Info-Click%20Here-orange)](https://snaptrade.com/)
11
11
 
12
12
  </div>
@@ -1123,7 +1123,7 @@ const placeOptionStrategyResponse = await snaptrade.options.placeOptionStrategy(
1123
1123
  userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
1124
1124
  accountId: "2bcd7cc3-e922-4976-bce1-9858296801c3",
1125
1125
  optionStrategyId: "2bcd7cc3-e922-4976-bce1-9858296801c3",
1126
- order_type: "Limit",
1126
+ order_type: "Market",
1127
1127
  time_in_force: "FOK",
1128
1128
  price: 31.33,
1129
1129
  }
@@ -1134,11 +1134,11 @@ const placeOptionStrategyResponse = await snaptrade.options.placeOptionStrategy(
1134
1134
 
1135
1135
  ##### order_type: [`OrderTypeStrict`](./models/order-type-strict.ts)<a id="order_type-ordertypestrictmodelsorder-type-strictts"></a>
1136
1136
 
1137
- Order Type
1137
+ The type of order to place. - For `Limit` and `StopLimit` orders, the `price` field is required. - For `Stop` and `StopLimit` orders, the `stop` field is required.
1138
1138
 
1139
1139
  ##### time_in_force: [`TimeInForceStrict`](./models/time-in-force-strict.ts)<a id="time_in_force-timeinforcestrictmodelstime-in-force-strictts"></a>
1140
1140
 
1141
- Trade time in force examples: * FOK - Fill Or Kill * Day - Day * GTC - Good Til Canceled
1141
+ The Time in Force type for the order. This field indicates how long the order will remain active before it is executed or expires. Here are the supported values: - `Day` - Day. The order is valid only for the trading day on which it is placed. - `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.
1142
1142
 
1143
1143
  ##### userId: `string`<a id="userid-string"></a>
1144
1144
 
@@ -1486,8 +1486,7 @@ The ID of the account to search for symbols within.
1486
1486
 
1487
1487
  ### `snaptrade.trading.cancelUserAccountOrder`<a id="snaptradetradingcanceluseraccountorder"></a>
1488
1488
 
1489
- Sends a signal to the brokerage to cancel the specified order.
1490
- This will only work if the order has not yet been executed.
1489
+ Attempts to cancel an open order with the brokerage. If the order is no longer cancellable, the request will be rejected.
1491
1490
 
1492
1491
 
1493
1492
  #### 🛠️ Usage<a id="🛠️-usage"></a>
@@ -1498,7 +1497,7 @@ const cancelUserAccountOrderResponse =
1498
1497
  userId: "snaptrade-user-123",
1499
1498
  userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
1500
1499
  accountId: "917c8734-8470-4a3e-a18f-57c3f2ee6631",
1501
- brokerage_order_id: "2bcd7cc3-e922-4976-bce1-9858296801c3",
1500
+ brokerage_order_id: "66a033fa-da74-4fcf-b527-feefdec9257e",
1502
1501
  });
1503
1502
  ```
1504
1503
 
@@ -1510,10 +1509,10 @@ const cancelUserAccountOrderResponse =
1510
1509
 
1511
1510
  ##### accountId: `string`<a id="accountid-string"></a>
1512
1511
 
1513
- The ID of the account to cancel the order in.
1514
-
1515
1512
  ##### brokerage_order_id: `string`<a id="brokerage_order_id-string"></a>
1516
1513
 
1514
+ Order ID returned by brokerage. This is the unique identifier for the order in the brokerage system.
1515
+
1517
1516
  #### 🔄 Return<a id="🔄-return"></a>
1518
1517
 
1519
1518
  [AccountOrderRecord](./models/account-order-record.ts)
@@ -1529,7 +1528,7 @@ The ID of the account to cancel the order in.
1529
1528
 
1530
1529
  ### `snaptrade.trading.getOrderImpact`<a id="snaptradetradinggetorderimpact"></a>
1531
1530
 
1532
- Return the trade object and it's impact on the account for the specified order.
1531
+ 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.
1533
1532
 
1534
1533
  #### 🛠️ Usage<a id="🛠️-usage"></a>
1535
1534
 
@@ -1537,47 +1536,52 @@ Return the trade object and it's impact on the account for the specified order.
1537
1536
  const getOrderImpactResponse = await snaptrade.trading.getOrderImpact({
1538
1537
  userId: "snaptrade-user-123",
1539
1538
  userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
1540
- account_id: "2bcd7cc3-e922-4976-bce1-9858296801c3",
1539
+ account_id: "917c8734-8470-4a3e-a18f-57c3f2ee6631",
1541
1540
  action: "BUY",
1542
- order_type: "Limit",
1541
+ universal_symbol_id: "2bcd7cc3-e922-4976-bce1-9858296801c3",
1542
+ order_type: "Market",
1543
+ time_in_force: "FOK",
1543
1544
  price: 31.33,
1544
1545
  stop: 31.33,
1545
- time_in_force: "FOK",
1546
- universal_symbol_id: "2bcd7cc3-e922-4976-bce1-9858296801c3",
1546
+ units: 10.5,
1547
1547
  });
1548
1548
  ```
1549
1549
 
1550
1550
  #### ⚙️ Parameters<a id="⚙️-parameters"></a>
1551
1551
 
1552
- ##### userId: `string`<a id="userid-string"></a>
1553
-
1554
- ##### userSecret: `string`<a id="usersecret-string"></a>
1555
-
1556
1552
  ##### account_id: `string`<a id="account_id-string"></a>
1557
1553
 
1554
+ Unique identifier for the connected brokerage account. This is the UUID used to reference the account in SnapTrade.
1555
+
1558
1556
  ##### action: [`ActionStrict`](./models/action-strict.ts)<a id="action-actionstrictmodelsaction-strictts"></a>
1559
1557
 
1560
- Trade Action
1558
+ The action describes the intent or side of a trade. This is either `BUY` or `SELL`
1559
+
1560
+ ##### universal_symbol_id: `string`<a id="universal_symbol_id-string"></a>
1561
+
1562
+ Unique identifier for the symbol within SnapTrade. This is the ID used to reference the symbol in SnapTrade API calls.
1561
1563
 
1562
1564
  ##### order_type: [`OrderTypeStrict`](./models/order-type-strict.ts)<a id="order_type-ordertypestrictmodelsorder-type-strictts"></a>
1563
1565
 
1564
- Order Type
1566
+ The type of order to place. - For `Limit` and `StopLimit` orders, the `price` field is required. - For `Stop` and `StopLimit` orders, the `stop` field is required.
1565
1567
 
1566
- ##### price: `number`<a id="price-number"></a>
1568
+ ##### time_in_force: [`TimeInForceStrict`](./models/time-in-force-strict.ts)<a id="time_in_force-timeinforcestrictmodelstime-in-force-strictts"></a>
1567
1569
 
1568
- Trade Price if limit or stop limit order
1570
+ The Time in Force type for the order. This field indicates how long the order will remain active before it is executed or expires. Here are the supported values: - `Day` - Day. The order is valid only for the trading day on which it is placed. - `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.
1569
1571
 
1570
- ##### stop: `number`<a id="stop-number"></a>
1572
+ ##### userId: `string`<a id="userid-string"></a>
1571
1573
 
1572
- Stop Price. If stop loss or stop limit order, the price to trigger the stop
1574
+ ##### userSecret: `string`<a id="usersecret-string"></a>
1573
1575
 
1574
- ##### time_in_force: [`TimeInForceStrict`](./models/time-in-force-strict.ts)<a id="time_in_force-timeinforcestrictmodelstime-in-force-strictts"></a>
1576
+ ##### price: `number`<a id="price-number"></a>
1575
1577
 
1576
- Trade time in force examples: * FOK - Fill Or Kill * Day - Day * GTC - Good Til Canceled
1578
+ The limit price for `Limit` and `StopLimit` orders.
1577
1579
 
1578
- ##### units: [`number`](./models/number.ts)<a id="units-numbermodelsnumberts"></a>
1580
+ ##### stop: `number`<a id="stop-number"></a>
1579
1581
 
1580
- ##### universal_symbol_id: `string`<a id="universal_symbol_id-string"></a>
1582
+ The price at which a stop order is triggered for `Stop` and `StopLimit` orders.
1583
+
1584
+ ##### units: [`number`](./models/number.ts)<a id="units-numbermodelsnumberts"></a>
1581
1585
 
1582
1586
  ##### notional_value: [`ManualTradeFormNotionalValue`](./models/manual-trade-form-notional-value.ts)<a id="notional_value-manualtradeformnotionalvaluemodelsmanual-trade-form-notional-valuets"></a>
1583
1587
 
@@ -1596,7 +1600,7 @@ Trade time in force examples: * FOK - Fill Or Kill * Day - Day * GTC - Goo
1596
1600
 
1597
1601
  ### `snaptrade.trading.getUserAccountQuotes`<a id="snaptradetradinggetuseraccountquotes"></a>
1598
1602
 
1599
- Returns quote(s) from the brokerage for the specified symbol(s).
1603
+ Returns quotes from the brokerage for the specified symbols and account. The quotes returned can be delayed depending on the brokerage the account belongs to. It is highly recommended that you use your own market data provider for real-time quotes instead of relying on this endpoint. This endpoint does not work for options quotes.
1600
1604
 
1601
1605
  #### 🛠️ Usage<a id="🛠️-usage"></a>
1602
1606
 
@@ -1618,15 +1622,13 @@ const getUserAccountQuotesResponse =
1618
1622
 
1619
1623
  ##### symbols: `string`<a id="symbols-string"></a>
1620
1624
 
1621
- List of universal_symbol_id or tickers to get quotes for.
1625
+ List of Universal Symbol IDs or tickers to get quotes for.
1622
1626
 
1623
1627
  ##### accountId: `string`<a id="accountid-string"></a>
1624
1628
 
1625
- The ID of the account to get quotes.
1626
-
1627
1629
  ##### useTicker: `boolean`<a id="useticker-boolean"></a>
1628
1630
 
1629
- Should be set to True if providing tickers.
1631
+ Should be set to `True` if `symbols` are comprised of tickers. Defaults to `False` if not provided.
1630
1632
 
1631
1633
  #### 🔄 Return<a id="🔄-return"></a>
1632
1634
 
@@ -1643,7 +1645,10 @@ Should be set to True if providing tickers.
1643
1645
 
1644
1646
  ### `snaptrade.trading.placeForceOrder`<a id="snaptradetradingplaceforceorder"></a>
1645
1647
 
1646
- Places a specified trade in the specified account.
1648
+ Places a brokerage order in the specified account. The order could be rejected by the brokerage if it is invalid or if the account does not have sufficient funds.
1649
+
1650
+ This endpoint does not compute the impact to the account balance from the order and any potential commissions before submitting the order to the brokerage. If that is desired, you can use the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact).
1651
+
1647
1652
 
1648
1653
  #### 🛠️ Usage<a id="🛠️-usage"></a>
1649
1654
 
@@ -1651,47 +1656,52 @@ Places a specified trade in the specified account.
1651
1656
  const placeForceOrderResponse = await snaptrade.trading.placeForceOrder({
1652
1657
  userId: "snaptrade-user-123",
1653
1658
  userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
1654
- account_id: "2bcd7cc3-e922-4976-bce1-9858296801c3",
1659
+ account_id: "917c8734-8470-4a3e-a18f-57c3f2ee6631",
1655
1660
  action: "BUY",
1656
- order_type: "Limit",
1661
+ universal_symbol_id: "2bcd7cc3-e922-4976-bce1-9858296801c3",
1662
+ order_type: "Market",
1663
+ time_in_force: "FOK",
1657
1664
  price: 31.33,
1658
1665
  stop: 31.33,
1659
- time_in_force: "FOK",
1660
- universal_symbol_id: "2bcd7cc3-e922-4976-bce1-9858296801c3",
1666
+ units: 10.5,
1661
1667
  });
1662
1668
  ```
1663
1669
 
1664
1670
  #### ⚙️ Parameters<a id="⚙️-parameters"></a>
1665
1671
 
1666
- ##### userId: `string`<a id="userid-string"></a>
1667
-
1668
- ##### userSecret: `string`<a id="usersecret-string"></a>
1669
-
1670
1672
  ##### account_id: `string`<a id="account_id-string"></a>
1671
1673
 
1674
+ Unique identifier for the connected brokerage account. This is the UUID used to reference the account in SnapTrade.
1675
+
1672
1676
  ##### action: [`ActionStrict`](./models/action-strict.ts)<a id="action-actionstrictmodelsaction-strictts"></a>
1673
1677
 
1674
- Trade Action
1678
+ The action describes the intent or side of a trade. This is either `BUY` or `SELL`
1679
+
1680
+ ##### universal_symbol_id: `string`<a id="universal_symbol_id-string"></a>
1681
+
1682
+ Unique identifier for the symbol within SnapTrade. This is the ID used to reference the symbol in SnapTrade API calls.
1675
1683
 
1676
1684
  ##### order_type: [`OrderTypeStrict`](./models/order-type-strict.ts)<a id="order_type-ordertypestrictmodelsorder-type-strictts"></a>
1677
1685
 
1678
- Order Type
1686
+ The type of order to place. - For `Limit` and `StopLimit` orders, the `price` field is required. - For `Stop` and `StopLimit` orders, the `stop` field is required.
1679
1687
 
1680
- ##### price: `number`<a id="price-number"></a>
1688
+ ##### time_in_force: [`TimeInForceStrict`](./models/time-in-force-strict.ts)<a id="time_in_force-timeinforcestrictmodelstime-in-force-strictts"></a>
1681
1689
 
1682
- Trade Price if limit or stop limit order
1690
+ The Time in Force type for the order. This field indicates how long the order will remain active before it is executed or expires. Here are the supported values: - `Day` - Day. The order is valid only for the trading day on which it is placed. - `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.
1683
1691
 
1684
- ##### stop: `number`<a id="stop-number"></a>
1692
+ ##### userId: `string`<a id="userid-string"></a>
1685
1693
 
1686
- Stop Price. If stop loss or stop limit order, the price to trigger the stop
1694
+ ##### userSecret: `string`<a id="usersecret-string"></a>
1687
1695
 
1688
- ##### time_in_force: [`TimeInForceStrict`](./models/time-in-force-strict.ts)<a id="time_in_force-timeinforcestrictmodelstime-in-force-strictts"></a>
1696
+ ##### price: `number`<a id="price-number"></a>
1689
1697
 
1690
- Trade time in force examples: * FOK - Fill Or Kill * Day - Day * GTC - Good Til Canceled
1698
+ The limit price for `Limit` and `StopLimit` orders.
1691
1699
 
1692
- ##### units: [`number`](./models/number.ts)<a id="units-numbermodelsnumberts"></a>
1700
+ ##### stop: `number`<a id="stop-number"></a>
1693
1701
 
1694
- ##### universal_symbol_id: `string`<a id="universal_symbol_id-string"></a>
1702
+ The price at which a stop order is triggered for `Stop` and `StopLimit` orders.
1703
+
1704
+ ##### units: [`number`](./models/number.ts)<a id="units-numbermodelsnumberts"></a>
1695
1705
 
1696
1706
  ##### notional_value: [`ManualTradeFormNotionalValue`](./models/manual-trade-form-notional-value.ts)<a id="notional_value-manualtradeformnotionalvaluemodelsmanual-trade-form-notional-valuets"></a>
1697
1707
 
@@ -1710,15 +1720,14 @@ Trade time in force examples: * FOK - Fill Or Kill * Day - Day * GTC - Goo
1710
1720
 
1711
1721
  ### `snaptrade.trading.placeOrder`<a id="snaptradetradingplaceorder"></a>
1712
1722
 
1713
- Places the specified trade object. This places the order in the account and
1714
- returns the status of the order from the brokerage.
1723
+ Places the previously checked order with the brokerage. The `tradeId` is obtained from the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact). If you prefer to place the order without checking for impact first, you can use the [place order endpoint](/reference/Trading/Trading_placeForceOrder).
1715
1724
 
1716
1725
 
1717
1726
  #### 🛠️ Usage<a id="🛠️-usage"></a>
1718
1727
 
1719
1728
  ```typescript
1720
1729
  const placeOrderResponse = await snaptrade.trading.placeOrder({
1721
- tradeId: "tradeId_example",
1730
+ tradeId: "139e307a-82f7-4402-b39e-4da7baa87758",
1722
1731
  userId: "snaptrade-user-123",
1723
1732
  userSecret: "adf2aa34-8219-40f7-a6b3-60156985cc61",
1724
1733
  wait_to_confirm: true,
@@ -1729,7 +1738,7 @@ const placeOrderResponse = await snaptrade.trading.placeOrder({
1729
1738
 
1730
1739
  ##### tradeId: `string`<a id="tradeid-string"></a>
1731
1740
 
1732
- The ID of trade object obtained from trade/impact endpoint
1741
+ Obtained from calling the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact)
1733
1742
 
1734
1743
  ##### userId: `string`<a id="userid-string"></a>
1735
1744
 
@@ -1737,7 +1746,7 @@ The ID of trade object obtained from trade/impact endpoint
1737
1746
 
1738
1747
  ##### wait_to_confirm: `boolean`<a id="wait_to_confirm-boolean"></a>
1739
1748
 
1740
- Optional, defaults to true. Determines if a wait is performed to check on order status. If false, latency will be reduced but orders returned will be more likely to be of status PENDING as we will not wait to check on the status before responding to the request
1749
+ Optional, defaults to true. Determines if a wait is performed to check on order status. If false, latency will be reduced but orders returned will be more likely to be of status `PENDING` as we will not wait to check on the status before responding to the request.
1741
1750
 
1742
1751
  #### 🔄 Return<a id="🔄-return"></a>
1743
1752
 
@@ -13,19 +13,19 @@ import { ValidatedTradeBody } from '../models';
13
13
  */
14
14
  export declare const TradingApiAxiosParamCreator: (configuration?: Configuration) => {
15
15
  /**
16
- * Sends a signal to the brokerage to cancel the specified order. This will only work if the order has not yet been executed.
17
- * @summary Cancel open order in account
16
+ * Attempts to cancel an open order with the brokerage. If the order is no longer cancellable, the request will be rejected.
17
+ * @summary Cancel order
18
18
  * @param {string} userId
19
19
  * @param {string} userSecret
20
- * @param {string} accountId The ID of the account to cancel the order in.
21
- * @param {TradingCancelUserAccountOrderRequest} tradingCancelUserAccountOrderRequest The Order ID to be canceled
20
+ * @param {string} accountId
21
+ * @param {TradingCancelUserAccountOrderRequest} tradingCancelUserAccountOrderRequest
22
22
  * @param {*} [options] Override http request option.
23
23
  * @throws {RequiredError}
24
24
  */
25
25
  cancelUserAccountOrder: (userId: string, userSecret: string, accountId: string, tradingCancelUserAccountOrderRequest: TradingCancelUserAccountOrderRequest, options?: AxiosRequestConfig) => Promise<RequestArgs>;
26
26
  /**
27
- * Return the trade object and it\'s impact on the account for the specified order.
28
- * @summary Check the impact of a trade on an account
27
+ * 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.
28
+ * @summary Check order impact
29
29
  * @param {string} userId
30
30
  * @param {string} userSecret
31
31
  * @param {ManualTradeForm} manualTradeForm
@@ -34,20 +34,20 @@ export declare const TradingApiAxiosParamCreator: (configuration?: Configuration
34
34
  */
35
35
  getOrderImpact: (userId: string, userSecret: string, manualTradeForm: ManualTradeForm, options?: AxiosRequestConfig) => Promise<RequestArgs>;
36
36
  /**
37
- * Returns quote(s) from the brokerage for the specified symbol(s).
37
+ * Returns quotes from the brokerage for the specified symbols and account. The quotes returned can be delayed depending on the brokerage the account belongs to. It is highly recommended that you use your own market data provider for real-time quotes instead of relying on this endpoint. This endpoint does not work for options quotes.
38
38
  * @summary Get symbol quotes
39
39
  * @param {string} userId
40
40
  * @param {string} userSecret
41
- * @param {string} symbols List of universal_symbol_id or tickers to get quotes for.
42
- * @param {string} accountId The ID of the account to get quotes.
43
- * @param {boolean} [useTicker] Should be set to True if providing tickers.
41
+ * @param {string} symbols List of Universal Symbol IDs or tickers to get quotes for.
42
+ * @param {string} accountId
43
+ * @param {boolean} [useTicker] Should be set to &#x60;True&#x60; if &#x60;symbols&#x60; are comprised of tickers. Defaults to &#x60;False&#x60; if not provided.
44
44
  * @param {*} [options] Override http request option.
45
45
  * @throws {RequiredError}
46
46
  */
47
47
  getUserAccountQuotes: (userId: string, userSecret: string, symbols: string, accountId: string, useTicker?: boolean, options?: AxiosRequestConfig) => Promise<RequestArgs>;
48
48
  /**
49
- * Places a specified trade in the specified account.
50
- * @summary Place a trade with NO validation.
49
+ * Places a brokerage order in the specified account. The order could be rejected by the brokerage if it is invalid or if the account does not have sufficient funds. This endpoint does not compute the impact to the account balance from the order and any potential commissions before submitting the order to the brokerage. If that is desired, you can use the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact).
50
+ * @summary Place order
51
51
  * @param {string} userId
52
52
  * @param {string} userSecret
53
53
  * @param {ManualTradeForm} manualTradeForm
@@ -56,9 +56,9 @@ export declare const TradingApiAxiosParamCreator: (configuration?: Configuration
56
56
  */
57
57
  placeForceOrder: (userId: string, userSecret: string, manualTradeForm: ManualTradeForm, options?: AxiosRequestConfig) => Promise<RequestArgs>;
58
58
  /**
59
- * Places the specified trade object. This places the order in the account and returns the status of the order from the brokerage.
60
- * @summary Place order
61
- * @param {string} tradeId The ID of trade object obtained from trade/impact endpoint
59
+ * Places the previously checked order with the brokerage. The `tradeId` is obtained from the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact). If you prefer to place the order without checking for impact first, you can use the [place order endpoint](/reference/Trading/Trading_placeForceOrder).
60
+ * @summary Place checked order
61
+ * @param {string} tradeId Obtained from calling the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact)
62
62
  * @param {string} userId
63
63
  * @param {string} userSecret
64
64
  * @param {ValidatedTradeBody} [validatedTradeBody]
@@ -73,23 +73,23 @@ export declare const TradingApiAxiosParamCreator: (configuration?: Configuration
73
73
  */
74
74
  export declare const TradingApiFp: (configuration?: Configuration) => {
75
75
  /**
76
- * Sends a signal to the brokerage to cancel the specified order. This will only work if the order has not yet been executed.
77
- * @summary Cancel open order in account
76
+ * Attempts to cancel an open order with the brokerage. If the order is no longer cancellable, the request will be rejected.
77
+ * @summary Cancel order
78
78
  * @param {TradingApiCancelUserAccountOrderRequest} requestParameters Request parameters.
79
79
  * @param {*} [options] Override http request option.
80
80
  * @throws {RequiredError}
81
81
  */
82
82
  cancelUserAccountOrder(requestParameters: TradingApiCancelUserAccountOrderRequest, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AccountOrderRecord>>;
83
83
  /**
84
- * Return the trade object and it\'s impact on the account for the specified order.
85
- * @summary Check the impact of a trade on an account
84
+ * 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.
85
+ * @summary Check order impact
86
86
  * @param {TradingApiGetOrderImpactRequest} requestParameters Request parameters.
87
87
  * @param {*} [options] Override http request option.
88
88
  * @throws {RequiredError}
89
89
  */
90
90
  getOrderImpact(requestParameters: TradingApiGetOrderImpactRequest, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ManualTradeAndImpact>>;
91
91
  /**
92
- * Returns quote(s) from the brokerage for the specified symbol(s).
92
+ * Returns quotes from the brokerage for the specified symbols and account. The quotes returned can be delayed depending on the brokerage the account belongs to. It is highly recommended that you use your own market data provider for real-time quotes instead of relying on this endpoint. This endpoint does not work for options quotes.
93
93
  * @summary Get symbol quotes
94
94
  * @param {TradingApiGetUserAccountQuotesRequest} requestParameters Request parameters.
95
95
  * @param {*} [options] Override http request option.
@@ -97,16 +97,16 @@ export declare const TradingApiFp: (configuration?: Configuration) => {
97
97
  */
98
98
  getUserAccountQuotes(requestParameters: TradingApiGetUserAccountQuotesRequest, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<Array<SymbolsQuotesInner>>>;
99
99
  /**
100
- * Places a specified trade in the specified account.
101
- * @summary Place a trade with NO validation.
100
+ * Places a brokerage order in the specified account. The order could be rejected by the brokerage if it is invalid or if the account does not have sufficient funds. This endpoint does not compute the impact to the account balance from the order and any potential commissions before submitting the order to the brokerage. If that is desired, you can use the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact).
101
+ * @summary Place order
102
102
  * @param {TradingApiPlaceForceOrderRequest} requestParameters Request parameters.
103
103
  * @param {*} [options] Override http request option.
104
104
  * @throws {RequiredError}
105
105
  */
106
106
  placeForceOrder(requestParameters: TradingApiPlaceForceOrderRequest, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<AccountOrderRecord>>;
107
107
  /**
108
- * Places the specified trade object. This places the order in the account and returns the status of the order from the brokerage.
109
- * @summary Place order
108
+ * Places the previously checked order with the brokerage. The `tradeId` is obtained from the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact). If you prefer to place the order without checking for impact first, you can use the [place order endpoint](/reference/Trading/Trading_placeForceOrder).
109
+ * @summary Place checked order
110
110
  * @param {TradingApiPlaceOrderRequest} requestParameters Request parameters.
111
111
  * @param {*} [options] Override http request option.
112
112
  * @throws {RequiredError}
@@ -119,23 +119,23 @@ export declare const TradingApiFp: (configuration?: Configuration) => {
119
119
  */
120
120
  export declare const TradingApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
121
121
  /**
122
- * Sends a signal to the brokerage to cancel the specified order. This will only work if the order has not yet been executed.
123
- * @summary Cancel open order in account
122
+ * Attempts to cancel an open order with the brokerage. If the order is no longer cancellable, the request will be rejected.
123
+ * @summary Cancel order
124
124
  * @param {TradingApiCancelUserAccountOrderRequest} requestParameters Request parameters.
125
125
  * @param {*} [options] Override http request option.
126
126
  * @throws {RequiredError}
127
127
  */
128
128
  cancelUserAccountOrder(requestParameters: TradingApiCancelUserAccountOrderRequest, options?: AxiosRequestConfig): AxiosPromise<AccountOrderRecord>;
129
129
  /**
130
- * Return the trade object and it\'s impact on the account for the specified order.
131
- * @summary Check the impact of a trade on an account
130
+ * 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.
131
+ * @summary Check order impact
132
132
  * @param {TradingApiGetOrderImpactRequest} requestParameters Request parameters.
133
133
  * @param {*} [options] Override http request option.
134
134
  * @throws {RequiredError}
135
135
  */
136
136
  getOrderImpact(requestParameters: TradingApiGetOrderImpactRequest, options?: AxiosRequestConfig): AxiosPromise<ManualTradeAndImpact>;
137
137
  /**
138
- * Returns quote(s) from the brokerage for the specified symbol(s).
138
+ * Returns quotes from the brokerage for the specified symbols and account. The quotes returned can be delayed depending on the brokerage the account belongs to. It is highly recommended that you use your own market data provider for real-time quotes instead of relying on this endpoint. This endpoint does not work for options quotes.
139
139
  * @summary Get symbol quotes
140
140
  * @param {TradingApiGetUserAccountQuotesRequest} requestParameters Request parameters.
141
141
  * @param {*} [options] Override http request option.
@@ -143,16 +143,16 @@ export declare const TradingApiFactory: (configuration?: Configuration, basePath
143
143
  */
144
144
  getUserAccountQuotes(requestParameters: TradingApiGetUserAccountQuotesRequest, options?: AxiosRequestConfig): AxiosPromise<Array<SymbolsQuotesInner>>;
145
145
  /**
146
- * Places a specified trade in the specified account.
147
- * @summary Place a trade with NO validation.
146
+ * Places a brokerage order in the specified account. The order could be rejected by the brokerage if it is invalid or if the account does not have sufficient funds. This endpoint does not compute the impact to the account balance from the order and any potential commissions before submitting the order to the brokerage. If that is desired, you can use the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact).
147
+ * @summary Place order
148
148
  * @param {TradingApiPlaceForceOrderRequest} requestParameters Request parameters.
149
149
  * @param {*} [options] Override http request option.
150
150
  * @throws {RequiredError}
151
151
  */
152
152
  placeForceOrder(requestParameters: TradingApiPlaceForceOrderRequest, options?: AxiosRequestConfig): AxiosPromise<AccountOrderRecord>;
153
153
  /**
154
- * Places the specified trade object. This places the order in the account and returns the status of the order from the brokerage.
155
- * @summary Place order
154
+ * Places the previously checked order with the brokerage. The `tradeId` is obtained from the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact). If you prefer to place the order without checking for impact first, you can use the [place order endpoint](/reference/Trading/Trading_placeForceOrder).
155
+ * @summary Place checked order
156
156
  * @param {TradingApiPlaceOrderRequest} requestParameters Request parameters.
157
157
  * @param {*} [options] Override http request option.
158
158
  * @throws {RequiredError}
@@ -178,7 +178,7 @@ export type TradingApiCancelUserAccountOrderRequest = {
178
178
  */
179
179
  readonly userSecret: string;
180
180
  /**
181
- * The ID of the account to cancel the order in.
181
+ *
182
182
  * @type {string}
183
183
  * @memberof TradingApiCancelUserAccountOrder
184
184
  */
@@ -222,19 +222,19 @@ export type TradingApiGetUserAccountQuotesRequest = {
222
222
  */
223
223
  readonly userSecret: string;
224
224
  /**
225
- * List of universal_symbol_id or tickers to get quotes for.
225
+ * List of Universal Symbol IDs or tickers to get quotes for.
226
226
  * @type {string}
227
227
  * @memberof TradingApiGetUserAccountQuotes
228
228
  */
229
229
  readonly symbols: string;
230
230
  /**
231
- * The ID of the account to get quotes.
231
+ *
232
232
  * @type {string}
233
233
  * @memberof TradingApiGetUserAccountQuotes
234
234
  */
235
235
  readonly accountId: string;
236
236
  /**
237
- * Should be set to True if providing tickers.
237
+ * Should be set to `True` if `symbols` are comprised of tickers. Defaults to `False` if not provided.
238
238
  * @type {boolean}
239
239
  * @memberof TradingApiGetUserAccountQuotes
240
240
  */
@@ -266,7 +266,7 @@ export type TradingApiPlaceForceOrderRequest = {
266
266
  */
267
267
  export type TradingApiPlaceOrderRequest = {
268
268
  /**
269
- * The ID of trade object obtained from trade/impact endpoint
269
+ * Obtained from calling the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact)
270
270
  * @type {string}
271
271
  * @memberof TradingApiPlaceOrder
272
272
  */
@@ -292,8 +292,8 @@ export type TradingApiPlaceOrderRequest = {
292
292
  */
293
293
  export declare class TradingApiGenerated extends BaseAPI {
294
294
  /**
295
- * Sends a signal to the brokerage to cancel the specified order. This will only work if the order has not yet been executed.
296
- * @summary Cancel open order in account
295
+ * Attempts to cancel an open order with the brokerage. If the order is no longer cancellable, the request will be rejected.
296
+ * @summary Cancel order
297
297
  * @param {TradingApiCancelUserAccountOrderRequest} requestParameters Request parameters.
298
298
  * @param {*} [options] Override http request option.
299
299
  * @throws {RequiredError}
@@ -301,8 +301,8 @@ export declare class TradingApiGenerated extends BaseAPI {
301
301
  */
302
302
  cancelUserAccountOrder(requestParameters: TradingApiCancelUserAccountOrderRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<AccountOrderRecord, any>>;
303
303
  /**
304
- * Return the trade object and it\'s impact on the account for the specified order.
305
- * @summary Check the impact of a trade on an account
304
+ * 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.
305
+ * @summary Check order impact
306
306
  * @param {TradingApiGetOrderImpactRequest} requestParameters Request parameters.
307
307
  * @param {*} [options] Override http request option.
308
308
  * @throws {RequiredError}
@@ -310,7 +310,7 @@ export declare class TradingApiGenerated extends BaseAPI {
310
310
  */
311
311
  getOrderImpact(requestParameters: TradingApiGetOrderImpactRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<ManualTradeAndImpact, any>>;
312
312
  /**
313
- * Returns quote(s) from the brokerage for the specified symbol(s).
313
+ * Returns quotes from the brokerage for the specified symbols and account. The quotes returned can be delayed depending on the brokerage the account belongs to. It is highly recommended that you use your own market data provider for real-time quotes instead of relying on this endpoint. This endpoint does not work for options quotes.
314
314
  * @summary Get symbol quotes
315
315
  * @param {TradingApiGetUserAccountQuotesRequest} requestParameters Request parameters.
316
316
  * @param {*} [options] Override http request option.
@@ -319,8 +319,8 @@ export declare class TradingApiGenerated extends BaseAPI {
319
319
  */
320
320
  getUserAccountQuotes(requestParameters: TradingApiGetUserAccountQuotesRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<SymbolsQuotesInner[], any>>;
321
321
  /**
322
- * Places a specified trade in the specified account.
323
- * @summary Place a trade with NO validation.
322
+ * Places a brokerage order in the specified account. The order could be rejected by the brokerage if it is invalid or if the account does not have sufficient funds. This endpoint does not compute the impact to the account balance from the order and any potential commissions before submitting the order to the brokerage. If that is desired, you can use the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact).
323
+ * @summary Place order
324
324
  * @param {TradingApiPlaceForceOrderRequest} requestParameters Request parameters.
325
325
  * @param {*} [options] Override http request option.
326
326
  * @throws {RequiredError}
@@ -328,8 +328,8 @@ export declare class TradingApiGenerated extends BaseAPI {
328
328
  */
329
329
  placeForceOrder(requestParameters: TradingApiPlaceForceOrderRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<AccountOrderRecord, any>>;
330
330
  /**
331
- * Places the specified trade object. This places the order in the account and returns the status of the order from the brokerage.
332
- * @summary Place order
331
+ * Places the previously checked order with the brokerage. The `tradeId` is obtained from the [check order impact endpoint](/reference/Trading/Trading_getOrderImpact). If you prefer to place the order without checking for impact first, you can use the [place order endpoint](/reference/Trading/Trading_placeForceOrder).
332
+ * @summary Place checked order
333
333
  * @param {TradingApiPlaceOrderRequest} requestParameters Request parameters.
334
334
  * @param {*} [options] Override http request option.
335
335
  * @throws {RequiredError}