Document the Object Store download permission rule

01 Cloud Platform/04 Organizations/02 Tier Features/05 Trading Firm Tier.html

@@ -1,6 +1,6 @@
 <p>The Trading Firm tier is designed for growing quantitative firms, prop desks, hedge funds, ETF companies, professional teams of quants, and sophisticated independent investors. It has special features for collaborating with consultants to protect the investor IP. If you are a company on QuantConnect, we recommend the Trading Firm Pack to make the most of QuantConnect.</p>
 
-<p>The Trading Firm tier builds on the features included in the Team tier. Organizations on the Trading Firm tier can have an unlimited number of members and up to 10 collaborators simultaneously working on an individual project. The IP ownership of all the projects in these organizations remains within the organization. There is no limit on the number of backtesting, research, and live trading nodes these organizations can rent. They can produce 5MB of logs/backtest and 50MB of logs/day. Members in these organizations can have up to eight active coding sessions in the organization. Each live algorithm in a Trading Firm organization can send up to 240 Telegram, Email, or Webhook notifications per hour for free. These organizations can also <a href="/docs/v2/ai-assistance/tasks#04-Schedule-Work">schedule AI agent tasks</a> to run automatically.</p>
+<p>The Trading Firm tier builds on the features included in the Team tier. Organizations on the Trading Firm tier can have an unlimited number of members and up to 10 collaborators simultaneously working on an individual project. The IP ownership of all the projects in these organizations remains within the organization. There is no limit on the number of backtesting, research, and live trading nodes these organizations can rent. They can produce 5MB of logs/backtest and 50MB of logs/day. Members in these organizations can have up to eight active coding sessions in the organization. Each live algorithm in a Trading Firm organization can send up to 240 Telegram, Email, or Webhook notifications per hour for free. These organizations can also <a href="/docs/v2/ai-assistance/tasks#04-Schedule-Work">schedule AI agent tasks</a> to run automatically. Downloading files from the Object Store is not included; it is an <a href="/docs/v2/cloud-platform/object-store#04-Download-Files">Institution tier feature</a>.</p>
 
 <p>The owner of a Trading Firm organization can grant various <a href="/docs/v2/cloud-platform/organizations/members#09-Permissions">permissions</a> to the organization's members, including designating a member to manage the organization's billing. These organizations have access to custom lean builds, so they can use feature branches or historical master branches to run their strategies. An example of this could be granting only a few members of your team live trading deployment access. </p>
 

01 Cloud Platform/04 Organizations/02 Tier Features/06 Institution Tier.html

@@ -1,6 +1,6 @@
 <p>The Institution tier is designed for established larger funds, large prop desks, hedge funds, banks, ETF vehicles, and professional teams of quants. It is "unlocked", so you can run it on-premises to serve your internal teams. If this sounds interesting, <a href="/appointments">reach out</a> and we'd be happy to arrange a demonstration for your department.
 </p>
 
-<p>The Institution tier builds on the features included in the Trading Firm tier. Organizations on the institutional tier have no limit on the number of backtest logs that they can produce, and each member of the organization can have up to 16 active coding sessions. These organizations can use <a href="/docs/v2/cloud-platform/live-trading/brokerages/bloomberg-emsx">Terminal Link</a> or <a href="/docs/v2/cloud-platform/live-trading/brokerages/bloomberg-fix">Bloomberg FIX</a> to live trade Equities, Futures, and Options via the Bloomberg EMSX or FixNet HUB. They can also request <a href="/docs/v2/cloud-platform/projects/package-environments#99-Request-New-Libraries">custom libraries and frameworks</a> to use in the QuantConnect web IDE and receive instant messaging support from a QuantConnect engineer. Each live algorithm in an Institution organization can send up to 3,600 Telegram, Email, or Webhook notifications per hour for free.</p>
+<p>The Institution tier builds on the features included in the Trading Firm tier. Organizations on the institutional tier have no limit on the number of backtest logs that they can produce, and each member of the organization can have up to 16 active coding sessions. These organizations can use <a href="/docs/v2/cloud-platform/live-trading/brokerages/bloomberg-emsx">Terminal Link</a> or <a href="/docs/v2/cloud-platform/live-trading/brokerages/bloomberg-fix">Bloomberg FIX</a> to live trade Equities, Futures, and Options via the Bloomberg EMSX or FixNet HUB. They can also request <a href="/docs/v2/cloud-platform/projects/package-environments#99-Request-New-Libraries">custom libraries and frameworks</a> to use in the QuantConnect web IDE and receive instant messaging support from a QuantConnect engineer. Each live algorithm in an Institution organization can send up to 3,600 Telegram, Email, or Webhook notifications per hour for free. Permissioned Institution organizations that sign the derived data agreement can <a href="/docs/v2/cloud-platform/object-store#04-Download-Files">download derived data from the Object Store</a>; this is the only tier where Object Store download is available.</p>
 
 <p>Institutional clients can run our proprietary build of LEAN, LEAN Enterprise, on-premises. LEAN Enterprise holds speed improvements we haven't pushed to the open-source.</p>

01 Cloud Platform/04 Organizations/04 Object Store/metadata.json

@@ -2,7 +2,7 @@
     "type": "metadata",
     "values": {
         "description": "The Object Store is an organization-specific key-value storage location to save and retrieve data in QuantConnect's cache. It's similar to a hash table.",
-        "keywords": "cloud storage, json, xml, bytes, manage storage usage",
+        "keywords": "cloud storage, json, xml, bytes, manage storage usage, download, export, derivative export, institution",
         "og:description": "The Object Store is an organization-specific key-value storage location to save and retrieve data in QuantConnect's cache. It's similar to a hash table.",
         "og:title": "Object Store - Documentation QuantConnect.com",
         "og:type": "website",

01 Cloud Platform/08 Backtesting/04 Results/03 Runtime Statistics.php

@@ -4,6 +4,4 @@
 
 <? include(DOCS_RESOURCES."/algorithm-results/runtime-statistics-table.php"); ?>
 
-<p>To download the runtime statistics data, see <a href='/docs/v2/cloud-platform/backtesting/results#17-Download-Results'>Download Results</a>.</p>
-
-<p>To add a custom runtime statistic, see <a href='/docs/v2/writing-algorithms/statistics/runtime-statistics#03-Add-Statistics'>Add Statistics</a>.</p>
+<p>To add your own runtime statistics, see <a href='/docs/v2/writing-algorithms/statistics/runtime-statistics#03-Add-Statistics'>Add Statistics</a>. Custom statistics appear in the banner, and you can <a href='/docs/v2/cloud-platform/backtesting/results#17-Download-Results'>download</a> them with the rest of the results. LEAN keeps at most 50 runtime statistics, truncates names and values to 200 characters, and ignores encoded values such as base64 or hexadecimal strings. When it ignores a statistic, it sends one debug message to the algorithm.</p>

01 Cloud Platform/13 Object Store/metadata.json

@@ -2,7 +2,7 @@
     "type": "metadata",
     "values": {
         "description": "The Object Store is an organization-specific key-value storage location to save and retrieve data in QuantConnect's cache. It's similar to a hash table.",
-        "keywords": "cloud storage, json, xml, bytes, manage storage usage",
+        "keywords": "cloud storage, json, xml, bytes, manage storage usage, download, export, derivative export, institution",
         "og:description": "The Object Store is an organization-specific key-value storage location to save and retrieve data in QuantConnect's cache. It's similar to a hash table.",
         "og:title": "Object Store - Documentation QuantConnect.com",
         "og:type": "website",

01 Cloud Platform/99 API Reference/09 Object Store Management/03 Get Object Store File/02 Description.html

@@ -0,0 +1,5 @@
+<!-- Code generated by API-Reference-Code-Generator.py -->
+
+<p>
+Downloading files from the Object Store is only available to permissioned <a href='/docs/v2/cloud-platform/organizations/tier-features#06-Institution-Tier'>Institution</a> tier organizations. Without that permission, the endpoint returns <code>Organization does not have derivative export enabled</code>. See <a href='/docs/v2/cloud-platform/object-store#04-Download-Files'>Download Files</a>.
+</p>

QuantConnect-Platform-2.0.0.yaml

@@ -1347,6 +1347,7 @@ paths:
         - 09 Object Store Management
         - 03 Get Object Store File
       summary: Get Object Store file of a specific organization and key.
+      description: "Downloading files from the Object Store is only available to permissioned <a href='/docs/v2/cloud-platform/organizations/tier-features#06-Institution-Tier'>Institution</a> tier organizations. Without that permission, the endpoint returns <code>Organization does not have derivative export enabled</code>. See <a href='/docs/v2/cloud-platform/object-store#04-Download-Files'>Download Files</a>."
       requestBody:
         description: Get Object Store files of a specific organization and key.
         content:

Resources/backtesting/results/download-results.php

@@ -1,10 +1,10 @@
 <p>You can download the following information <?=$localPlatform ? "for cloud backtests" : ""?> from the backtest results page:</p>
 
 <ul>
-    <li>Runtime statistics</li>
-    <li>Charts</li>
-    <li>The data in the <span class='tab-name'>Overview</span> tab</li>
-    <li>The data in the <span class='tab-name'>Orders</span> tab</li>
+    <li><a href="/docs/v2/cloud-platform/backtesting/results#03-Runtime-Statistics">Runtime statistics</a></li>
+    <li><a href="/docs/v2/cloud-platform/backtesting/results#04-Built-in-Charts">Charts</a></li>
+    <li>The data in the <a href="/docs/v2/cloud-platform/backtesting/results#09-Key-Statistics"><span class='tab-name'>Overview</span> tab</a></li>
+    <li>The data in the <a href="/docs/v2/cloud-platform/backtesting/results#11-Orders"><span class='tab-name'>Orders</span> tab</a></li>
 </ul>
 
 <p>To download the preceding information, open the backtest results page, click the <span class='tab-name'>Overview</span> tab, and then click <span class='button-name'>Download Results</span>. The timestamps in the file are based in Coordinated Universal Time (UTC).</p>

Resources/object-store/download-files-from-cloud-permission.php

@@ -1 +1,13 @@
-<p>Permissioned <a href="/docs/v2/cloud-platform/organizations/tier-features#06-Institution-Tier">Institutional</a> clients can build derivative data such as machine learning models and download it from the Object Store. <a href="mailto:support@quantconnect.com?cc=jared@quantconnect.com&amp;?subject=Download%20Files%20From%20Object%20Store">Contact us</a> to unlock this feature for your account.</p>
+<p>Downloading files from the Object Store is only available to <a href="/docs/v2/cloud-platform/organizations/tier-features#06-Institution-Tier">Institution</a> tier organizations that have signed QuantConnect's derived data agreement. It is not available on the Free, Quant Researcher, Team, or Trading Firm tiers, and <a href="/docs/v2/cloud-platform/object-store#07-Edit-Storage-Plan">adding storage</a> doesn't change that.</p>
+
+<p>The restriction applies to every file in the Object Store, including files you upload and files your algorithms generate. The Object Store is a single shared store, so the platform can't distinguish your own files from data derived from licensed datasets, and there is no per-file or per-organization exception. Keeping the data in the cloud is what lets QuantConnect offer licensed data at a fraction of its direct cost. Even permissioned organizations can only download derived data such as machine learning models and signal files. Raw price and alternative data can never be downloaded.</p>
+
+<p>If your organization isn't permissioned, the <span class='button-name'>Download</span> action on the Object Store page is unavailable, and the <a href="/docs/v2/cloud-platform/api-reference/object-store-management/get-object-store-file">API</a> and <a href="/docs/v2/lean-cli/object-store#04-Download-Files">CLI</a> return <code>Organization does not have derivative export enabled</code>. Use the data in the cloud instead:</p>
+
+<ul>
+    <li>Read the file in the <a href="/docs/v2/research-environment/object-store#05-Read-Data">Research Environment</a> or in a <a href="/docs/v2/writing-algorithms/object-store#05-Read-Data">backtest</a> and do the analysis there. For a full walkthrough, see <a href='/docs/v2/writing-algorithms/object-store#13-Example-for-Logging'>Example for Logging</a>.</li>
+    <li>For values a backtest produces, plot them and use <a href="/docs/v2/cloud-platform/backtesting/results#17-Download-Results">Download Results</a>, or log them within your <a href="/docs/v2/cloud-platform/organizations/resources#09-Log-Quotas">log quota</a>.</li>
+    <li>Project source files don't need the Object Store. Pull them with <a href="/docs/v2/lean-cli/projects/cloud-synchronization#02-Pulling-Cloud-Projects">lean cloud pull</a>.</li>
+</ul>
+
+<p>If you represent a fund or company and are interested in the Institution tier but unsure if it's right for you, <a href="/appointments">contact us</a> to schedule a demo with QuantConnect to learn more.</p>

Resources/object-store/download-files-from-cloud.php

@@ -1,14 +1,12 @@
 <? include(DOCS_RESOURCES."/object-store/download-files-from-cloud-permission.php"); ?>
 
-<p>Follow these steps to download files and directories from the Object Store:</p>
+<p>If your organization is permissioned, follow these steps to download files and directories from the Object Store:</p>
 
 <ol>
 	<li>Open the <a href='/docs/v2/cloud-platform/object-store#02-View-Storage'>Object Store</a> page.</li>
 	<li>Navigate to the directory in the Object Store where you want to download files and directories.</li>
-	<li>Select the file(s) and directory(ies) to download</li>
+	<li>Select the file(s) and directory(ies) to download.</li>
 	<li>Click <span class='button-name'>Download</span>.</li>
 	<li>Wait while QuantConnect processes the request.</li>
 	<li>Click the <span class='button-name'>Download</span> link that appears.</li>
 </ol>
-
-<p>If you can't download files from the Object Store, you can log data to the Object Store during a backtest and analyze it in the Research Environment. For a full walkthrough, see <a href='/docs/v2/writing-algorithms/object-store#13-Example-for-Logging'>Example for Logging</a>.</p>

Resources/object-store/storage-sizes.html

@@ -1,4 +1,4 @@
-<p>The Object Store is available to paid organizations. Paid organizations get 50 MB of free storage in the Object Store and can subscribe to more storage space. The following table shows the cost of the supported storage sizes:</p>
+<p>The Object Store is available to paid organizations. Paid organizations get 50 MB of free storage in the Object Store and can subscribe to more storage space. Storage subscriptions add capacity only; they don't enable <a href="/docs/v2/cloud-platform/object-store#04-Download-Files">downloading files</a>. The following table shows the cost of the supported storage sizes:</p>
 
 <table class="qc-table table" id="storage-sizes-table">
   <thead>