Data Feed Market Hours Description (#1582)

* Add Market Hours to data feeds * Add market hours to feeds lists * Lint fix * Lint fix and edits * Update market hours notice on feeds lists * Edits * Apply suggestions from code review Co-authored-by: ritika-b <ritika.bharati@smartcontract.com> * Market hours table Changes the list to a table --------- Co-authored-by: Crystal Gomes <thedriftofwords@users.noreply.github.com> Co-authored-by: ritika-b <ritika.bharati@smartcontract.com>
smartcontractkit · Oct 20, 2023 · d80b3ff · d80b3ff · vercel · Oct 20, 2023
1 parent a1510d5
commit d80b3ff
Show file tree

Hide file tree

Showing 3 changed files with 43 additions and 4 deletions.
diff --git a/src/content/data-feeds/selecting-data-feeds.mdx b/src/content/data-feeds/selecting-data-feeds.mdx
@@ -102,6 +102,23 @@ Data feeds managed by Chainlink Labs will be considered for deprecation if they
 
 Known users of these feeds will be contacted directly about the feeds' deprecation. Notifications will also be posted on the [Feeds Scheduled For Deprecation](/data-feeds/deprecating-feeds) page and on our [Discord channel](https://discord.com/channels/592041321326182401/991444378335838318) with 2 weeks of notice before they are shut down.
 
+## Market hours
+
+In addition to categories, be aware that markets for several assets are actively traded only during certain hours. Listed data feeds include an attribute describing their market hours. Chainlink Labs recommends using these feeds only during their specified hours:
+
+|Feed            | Hours                                                                      |
+|----------------|----------------------------------------------------------------------------|
+|**Crypto**      | 24/7/365 - No market close.                                                |
+|**US_Equities** | Standard US equity market hours: 09:30 - 16:00 ET M-F excluding US equity market holidays.|
+|**UK_ETF**      | Standard UK equity market hours: 08:00 - 16:30 UK time M-F excluding UK equity market holidays.|
+|**Forex**       | 18:00 ET Sunday to 17:00 ET Friday. <br/> The feeds also follow the global Forex market Christmas and New Year's Day holiday schedule. Many non-G12 currencies primarily trade during local market hours. It is recommended to use those feeds only during local trading hours. |
+|**Precious_Metals** | 18:00 ET Sunday to 17:00 ET Friday with a one-hour break Monday through Thursday from 17:00 to 18:00. <br/> The feeds also follow the global Forex market holiday schedule for Christmas and New Year's Day.|
+|**NYMEX** (US OIL) | 18:00 ET Sunday to 17:00 ET Friday, with a one-hour break Monday through Thursday from 17:00 to 18:00. <br/> The feed also follows the NYMEX market holiday schedule. |
+|**COMEX** (Non precious metals) | 18:00 ET Sunday to 17:00 ET Friday with a one-hour break Monday through Thursday from 17:00 to 18:00. <br/> The feed also follows the COMEX market holiday schedule. |
+|**CBOT** (Agricultural) | Monday - Thursday 00:00-08:45, 09:30-00:00 and Friday 00:00-08:45, 09:30-14:00 ET, excluding CBOT market holidays. |
+|**MI_ETF**      | Standard Milan equity market hours. 09:00-17:30 CET time M-F, excluding Milan equity market holidays. |
+|**XETRA_ETF**   | Deutsche Börse Xetra equity market hours. 09:00-17:30 CET time M-F, excluding Xetra equity market holidays. |
+
 ## Risk Mitigation
 
 As a development best practice, design your systems and smart contracts to be resilient and mitigate risk to your protocol and your users. Ensure that your systems can tolerate known and unknown exceptions that might occur. Some examples include but are not limited to volatile market conditions, the degraded performance of infrastructure, chains, or networks, and any other upstream outage related to data providers or node operators. You bear responsibility for any manner in which you use the Chainlink Network, its software, and documentation.

diff --git a/src/features/feeds/callouts/etf-best-practices.mdx b/src/features/feeds/callouts/etf-best-practices.mdx
@@ -1,5 +1,5 @@
 ### Best practices for ETF and Forex feeds
 
-- Off-chain equity and ETF assets are traded only during standard market hours from 9:30AM to 4:00PM EDT Monday through Friday.{" "} **Do not** use these feeds outside of those windows.
-- Assets on the Forex (Foreign Exchange) markets are traded only from 5PM EDT on Sunday through 4PM EDT on Friday. Additionally, some currencies might trade only during local banking hours.{" "} **Do not** use Forex feeds outside of market hours for the specific currency.
-- UK ETF price feed answers are 15 minutes delayed from their original published source. Assets are traded only during standard market hours from 9:30AM to 4:00PM GMT/BST, Monday through Friday. Do not use these feeds outside of those windows.
+- Off-chain equity and ETF assets are traded only during [standard market hours](/data-feeds/selecting-data-feeds#market-hours). {" "} **Do not** use these feeds outside those windows.
+- Assets on the Forex (Foreign Exchange) markets are traded only during [defined market hours](/data-feeds/selecting-data-feeds#market-hours). Additionally, some currencies might trade only during local banking hours.{" "} **Do not** use Forex feeds outside market hours for the specific currency.
+- UK ETF price feed answers are 15 minutes delayed from their original published source. Assets are traded only during [standard market hours](/data-feeds/selecting-data-feeds#market-hours). Do not use these feeds outside their specified hours.
diff --git a/src/features/feeds/components/Tables.tsx b/src/features/feeds/components/Tables.tsx
@@ -157,6 +157,16 @@ const DefaultTr = ({ network, proxy, showExtraDetails, isTestnet = false }) => (
                 </dd>
               </div>
             )}
+            {proxy.docs.marketHours && (
+              <div>
+                <dt>
+                  <span class="label">Market hours:</span>
+                </dt>
+                <dd>
+                  <a href="/data-feeds/selecting-data-feeds#market-hours">{proxy.docs.marketHours}</a>
+                </dd>
+              </div>
+            )}
           </dl>
         </div>
       )}
@@ -250,6 +260,16 @@ const ProofOfReserveTr = ({ network, proxy, showExtraDetails }) => (
             </dt>
             <dd>{proxy.docs.porSource}</dd>
           </div>
+          {proxy.docs.marketHours && (
+            <div>
+              <dt>
+                <span class="label">Market hours:</span>
+              </dt>
+              <dd>
+                <a href="/data-feeds/selecting-data-feeds#market-hours">{proxy.docs.marketHours}</a>
+              </dd>
+            </div>
+          )}
         </dl>
       </div>
     </td>
@@ -418,7 +438,9 @@ const StreamsTr = ({ network, proxy, showExtraDetails }) => (
               <dt>
                 <span class="label">Market hours:</span>
               </dt>
-              <dd>{proxy.docs.marketHours}</dd>
+              <dd>
+                <a href="/data-feeds/selecting-data-feeds#market-hours">{proxy.docs.marketHours}</a>
+              </dd>
             </div>
           ) : (
             ""