Regenerate and Version SDKs

.konfig/generate-id.txt

@@ -1 +1 @@
-24723a97-2752-481c-9878-1f769b030c78
+91597193-8d71-4b24-b49e-33d571495054

README.md

@@ -6,7 +6,7 @@
 
 Connect brokerage accounts to your app for live positions and trading
 
-[![Packagist](https://img.shields.io/badge/Packagist-v2.0.29-blue)](https://packagist.org/packages/konfig/snaptrade-php-7-sdk)
+[![Packagist](https://img.shields.io/badge/Packagist-v2.0.30-blue)](https://packagist.org/packages/konfig/snaptrade-php-7-sdk)
 [![More Info](https://img.shields.io/badge/More%20Info-Click%20Here-orange)](https://snaptrade.com/)
 
 </div>
@@ -86,7 +86,7 @@ To install the bindings via [Composer](https://getcomposer.org/), add the follow
     }
   ],
   "require": {
-    "konfig/snaptrade-php-7-sdk": "2.0.29"
+    "konfig/snaptrade-php-7-sdk": "2.0.30"
   }
 }
 ```
@@ -338,9 +338,7 @@ The ID of the account to get positions.
 
 ### `snaptrade.accountInformation.getUserHoldings`<a id="snaptradeaccountinformationgetuserholdings"></a>
 
-Lists balances, positions and orders for the specified account as well as
-option_positions and account metadata. The data returned is similar to the
-data returned over the more fine-grained **positions**, **orders** and **balances** endpoints.
+Lists balances, positions, option positions, and recent orders for the specified account. The data returned is similar to the data returned over the more fine-grained [balances](/reference/Account%20Information/AccountInformation_getUserAccountBalance), [positions](/reference/Account%20Information/AccountInformation_getUserAccountPositions) and [orders](/reference/Account%20Information/AccountInformation_getUserAccountOrders) endpoints. __The finer-grained APIs are preferred. They are easier to work with, faster, and have better error handling than this coarse-grained API.__
 
 
 
@@ -358,8 +356,6 @@ $result = $snaptrade->accountInformation->getUserHoldings(
 
 ##### account_id: `string`<a id="account_id-string"></a>
 
-The ID of the account to fetch holdings for.
-
 ##### user_id: `string`<a id="user_id-string"></a>
 
 ##### user_secret: `string`<a id="user_secret-string"></a>

lib/Api/AccountInformationApi.php

@@ -2265,9 +2265,9 @@ public function getUserAccountPositionsRequest($user_id, $user_secret, $account_
     /**
      * Operation getUserHoldings
      *
-     * List balances, positions and orders for the specified account
+     * List account holdings
      *
-     * @param  string $account_id The ID of the account to fetch holdings for. (required)
+     * @param  string $account_id account_id (required)
      * @param  string $user_id user_id (required)
      * @param  string $user_secret user_secret (required)
      * @param  string $contentType The value for the Content-Type header. Check self::contentTypes['getUserHoldings'] to see the possible values for this operation
@@ -2292,9 +2292,9 @@ public function getUserHoldings(
     /**
      * Operation getUserHoldingsWithHttpInfo
      *
-     * List balances, positions and orders for the specified account
+     * List account holdings
      *
-     * @param  string $account_id The ID of the account to fetch holdings for. (required)
+     * @param  string $account_id (required)
      * @param  string $user_id (required)
      * @param  string $user_secret (required)
      * @param  string $contentType The value for the Content-Type header. Check self::contentTypes['getUserHoldings'] to see the possible values for this operation
@@ -2459,9 +2459,9 @@ public function getUserHoldingsWithHttpInfo($account_id, $user_id, $user_secret,
     /**
      * Operation getUserHoldingsAsync
      *
-     * List balances, positions and orders for the specified account
+     * List account holdings
      *
-     * @param  string $account_id The ID of the account to fetch holdings for. (required)
+     * @param  string $account_id (required)
      * @param  string $user_id (required)
      * @param  string $user_secret (required)
      * @param  string $contentType The value for the Content-Type header. Check self::contentTypes['getUserHoldings'] to see the possible values for this operation
@@ -2490,9 +2490,9 @@ function ($response) {
     /**
      * Operation getUserHoldingsAsyncWithHttpInfo
      *
-     * List balances, positions and orders for the specified account
+     * List account holdings
      *
-     * @param  string $account_id The ID of the account to fetch holdings for. (required)
+     * @param  string $account_id (required)
      * @param  string $user_id (required)
      * @param  string $user_secret (required)
      * @param  string $contentType The value for the Content-Type header. Check self::contentTypes['getUserHoldings'] to see the possible values for this operation
@@ -2548,7 +2548,7 @@ function ($exception) {
     /**
      * Create request for operation 'getUserHoldings'
      *
-     * @param  string $account_id The ID of the account to fetch holdings for. (required)
+     * @param  string $account_id (required)
      * @param  string $user_id (required)
      * @param  string $user_secret (required)
      * @param  string $contentType The value for the Content-Type header. Check self::contentTypes['getUserHoldings'] to see the possible values for this operation

lib/Configuration.php

@@ -97,7 +97,7 @@ class Configuration
      *
      * @var string
      */
-    protected $userAgent = 'Konfig/2.0.29/PHP';
+    protected $userAgent = 'Konfig/2.0.30/PHP';
 
     /**
      * Debug switch (default set to false)
@@ -487,7 +487,7 @@ public static function toDebugReport()
         $report .= '    OS: ' . php_uname() . PHP_EOL;
         $report .= '    PHP Version: ' . PHP_VERSION . PHP_EOL;
         $report .= '    The version of the OpenAPI document: 1.0.0' . PHP_EOL;
-        $report .= '    SDK Package Version: 2.0.29' . PHP_EOL;
+        $report .= '    SDK Package Version: 2.0.30' . PHP_EOL;
         $report .= '    Temp Folder Path: ' . self::getDefaultConfiguration()->getTempFolderPath() . PHP_EOL;
 
         return $report;

lib/Model/AccountBalance.php

@@ -30,7 +30,7 @@
  * AccountBalance Class Doc Comment
  *
  * @category Class
- * @description Balance of the account
+ * @description Contains balance related information for the account.
  * @package  SnapTrade
  * @implements \ArrayAccess<string, mixed>
  */

lib/Model/AccountBalanceTotal.php

@@ -303,7 +303,7 @@ public function getAmount()
     /**
      * Sets amount
      *
-     * @param float|null $amount amount
+     * @param float|null $amount Total value denominated in the currency of the `currency` field.
      *
      * @return self
      */
@@ -332,7 +332,7 @@ public function getCurrency()
     /**
      * Sets currency
      *
-     * @param string|null $currency currency
+     * @param string|null $currency The ISO-4217 currency code for the amount.
      *
      * @return self
      */

lib/Model/AccountHoldingsAccount.php

@@ -30,7 +30,7 @@
  * AccountHoldingsAccount Class Doc Comment
  *
  * @category Class
- * @description Account Holdings with Account ID
+ * @description A wrapper object containing holdings information for a single account
  * @package  SnapTrade
  * @implements \ArrayAccess<string, mixed>
  */
@@ -360,7 +360,7 @@ public function getBalances()
     /**
      * Sets balances
      *
-     * @param \SnapTrade\Model\Balance[]|null $balances balances
+     * @param \SnapTrade\Model\Balance[]|null $balances List of balances for the account. Each element of the list has a distinct currency. Some brokerages like Questrade [allows holding multiple currencies in the same account](https://www.questrade.com/learning/questrade-basics/balances-and-reports/understanding-your-account-balances).
      *
      * @return self
      */
@@ -396,7 +396,7 @@ public function getPositions()
     /**
      * Sets positions
      *
-     * @param \SnapTrade\Model\Position[]|null $positions positions
+     * @param \SnapTrade\Model\Position[]|null $positions List of stock/ETF/crypto/mutual fund positions in the account.
      *
      * @return self
      */
@@ -432,7 +432,7 @@ public function getOptionPositions()
     /**
      * Sets option_positions
      *
-     * @param \SnapTrade\Model\OptionsPosition[]|null $option_positions option_positions
+     * @param \SnapTrade\Model\OptionsPosition[]|null $option_positions List of option positions in the account.
      *
      * @return self
      */
@@ -468,7 +468,7 @@ public function getOrders()
     /**
      * Sets orders
      *
-     * @param \SnapTrade\Model\AccountOrderRecord[]|null $orders orders
+     * @param \SnapTrade\Model\AccountOrderRecord[]|null $orders List of recent orders in the account, including both pending and executed orders.
      *
      * @return self
      */

lib/Model/Amount.php

@@ -303,7 +303,7 @@ public function getAmount()
     /**
      * Sets amount
      *
-     * @param float|null $amount amount
+     * @param float|null $amount Total value denominated in the currency of the `currency` field.
      *
      * @return self
      */
@@ -332,7 +332,7 @@ public function getCurrency()
     /**
      * Sets currency
      *
-     * @param string|null $currency currency
+     * @param string|null $currency The ISO-4217 currency code for the amount.
      *
      * @return self
      */

lib/Model/Balance.php

@@ -30,7 +30,7 @@
  * Balance Class Doc Comment
  *
  * @category Class
- * @description Account Balance
+ * @description Holds balance information for a single currency in an account.
  * @package  SnapTrade
  * @implements \ArrayAccess<string, mixed>
  */
@@ -339,7 +339,7 @@ public function getCash()
     /**
      * Sets cash
      *
-     * @param float|null $cash cash
+     * @param float|null $cash The amount of available cash in the account denominated in the currency of the `currency` field.
      *
      * @return self
      */
@@ -375,7 +375,7 @@ public function getBuyingPower()
     /**
      * Sets buying_power
      *
-     * @param float|null $buying_power buying_power
+     * @param float|null $buying_power Buying power only applies to margin accounts. For non-margin accounts, buying power should be the same as cash. Please note that this field is not always available for all brokerages.
      *
      * @return self
      */

lib/Model/Currency.php

@@ -30,7 +30,7 @@
  * Currency Class Doc Comment
  *
  * @category Class
- * @description Currency
+ * @description Describes a currency object.
  * @package  SnapTrade
  * @implements \ArrayAccess<string, mixed>
  */
@@ -310,7 +310,7 @@ public function getId()
     /**
      * Sets id
      *
-     * @param string|null $id id
+     * @param string|null $id Unique identifier for the currency. This is the UUID used to reference the currency in SnapTrade.
      *
      * @return self
      */
@@ -339,7 +339,7 @@ public function getCode()
     /**
      * Sets code
      *
-     * @param string|null $code code
+     * @param string|null $code The ISO-4217 currency code for the currency.
      *
      * @return self
      */
@@ -368,7 +368,7 @@ public function getName()
     /**
      * Sets name
      *
-     * @param string|null $name name
+     * @param string|null $name A human-friendly name of the currency.
      *
      * @return self
      */