Version Bump SDKs

Author: konfig-publisher

.konfig/generate-id.txt

@@ -1 +1 @@
-91597193-8d71-4b24-b49e-33d571495054
+69782d51-2bae-4ff6-9aa2-bfd8d6484b99

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.30-blue)](https://packagist.org/packages/konfig/snaptrade-php-7-sdk)
+[![Packagist](https://img.shields.io/badge/Packagist-v2.0.31-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.30"
+    "konfig/snaptrade-php-7-sdk": "2.0.31"
   }
 }
 ```
@@ -340,6 +340,8 @@ The ID of the account to get positions.
 
 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.__
 
+The data returned here is cached. How long the data is cached for varies by brokerage. Check the [brokerage integrations doc](https://snaptrade.notion.site/66793431ad0b416489eaabaf248d0afb?v=d16c4c97b8d5438bbb2d8581ac53b11e) and look for "Cache Expiry Time" to see the exact value for a specific brokerage. **If you need real-time data, please use the [manual refresh](/reference/Connections/Connections_refreshBrokerageAuthorization) endpoint**.
+
 
 
 #### 🛠️ Usage<a id="🛠️-usage"></a>

lib/Configuration.php

@@ -97,7 +97,7 @@ class Configuration
      *
      * @var string
      */
-    protected $userAgent = 'Konfig/2.0.30/PHP';
+    protected $userAgent = 'Konfig/2.0.31/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.30' . PHP_EOL;
+        $report .= '    SDK Package Version: 2.0.31' . PHP_EOL;
         $report .= '    Temp Folder Path: ' . self::getDefaultConfiguration()->getTempFolderPath() . PHP_EOL;
 
         return $report;

lib/Model/AccountHoldingsAccount.php

@@ -30,7 +30,7 @@
  * AccountHoldingsAccount Class Doc Comment
  *
  * @category Class
- * @description A wrapper object containing holdings information for a single account
+ * @description A wrapper object containing holdings information for a single account.
  * @package  SnapTrade
  * @implements \ArrayAccess<string, mixed>
  */

lib/Model/AccountOrderRecord.php

@@ -30,7 +30,7 @@
  * AccountOrderRecord Class Doc Comment
  *
  * @category Class
- * @description Record of order in brokerageaccount
+ * @description Describes a single recent order in an account.
  * @package  SnapTrade
  * @implements \ArrayAccess<string, mixed>
  */
@@ -422,7 +422,7 @@ public function getBrokerageOrderId()
     /**
      * Sets brokerage_order_id
      *
-     * @param string|null $brokerage_order_id Order id returned by brokerage
+     * @param string|null $brokerage_order_id Order ID returned by brokerage. This is the unique identifier for the order in the brokerage system.
      *
      * @return self
      */
@@ -471,6 +471,7 @@ public function setStatus($status)
      * Gets symbol
      *
      * @return string|null
+     * @deprecated
      */
     public function getSymbol()
     {
@@ -480,9 +481,10 @@ public function getSymbol()
     /**
      * Sets symbol
      *
-     * @param string|null $symbol symbol
+     * @param string|null $symbol A unique ID for the security within SnapTrade, scoped to the brokerage account that the security belongs to. This is a legacy field and should not be used. Do not rely on this being a stable ID as it can change.
      *
      * @return self
+     * @deprecated
      */
     public function setSymbol($symbol)
     {

lib/Model/AccountOrderRecordStatus.php

@@ -28,6 +28,7 @@
  * AccountOrderRecordStatus Class Doc Comment
  *
  * @category Class
+ * @description Indicates the status of an order. SnapTrade does a best effort to map brokerage statuses to statuses in this enum.
  * @package  SnapTrade
  */
 class AccountOrderRecordStatus