diff --git a/src/config/sidebar.ts b/src/config/sidebar.ts index d47bf0f9a8f..843e8c6f6e1 100644 --- a/src/config/sidebar.ts +++ b/src/config/sidebar.ts @@ -877,7 +877,7 @@ export const SIDEBAR: Partial> = { }, { title: "Rate and Volatility Feeds", url: "data-feeds/rates-feeds" }, { title: "L2 Sequencer Uptime Feeds", url: "data-feeds/l2-sequencer-feeds" }, - { title: "24/7 Blended Precious Metals Feeds", url: "data-feeds/blended-precious-metals-feeds" }, + { title: "24/7 Extended-Hours Data Feeds", url: "data-feeds/24-7-extended-hours-data-feeds" }, { title: "Self-Managed Feeds", url: "data-feeds/self-managed-feeds" }, ], }, diff --git a/src/content/data-feeds/24-7-extended-hours-data-feeds.mdx b/src/content/data-feeds/24-7-extended-hours-data-feeds.mdx new file mode 100644 index 00000000000..e8aabe5084b --- /dev/null +++ b/src/content/data-feeds/24-7-extended-hours-data-feeds.mdx @@ -0,0 +1,98 @@ +--- +section: dataFeeds +date: Last Modified +title: "24/7 Extended-Hours Data Feeds" +metadata: + title: "24/7 Extended-Hours Data Feeds | Chainlink Data Feeds" + description: "Learn how 24/7 extended-hours data feeds work for assets whose underlying markets normally close, including closed-market precious metals methodology and crypto-derived 24/7 forex rates such as USD/ARS." + keywords: + [ + "24/7 Data Feeds", + "Extended Hours", + "Blended Precious Metals Feeds", + "tGLD", + "Custom Feeds", + "Precious Metals", + "XAU", + "Forex", + "ARS", + "USDARS", + "Data Feeds", + ] +whatsnext: + { + "Review custom feed categories": "/data-feeds/selecting-data-feeds#-custom-feeds", + "Learn about single source data providers": "/data-feeds/selecting-data-feeds#single-source-data-providers", + "Find Price Feed Addresses": "/data-feeds/price-feeds/addresses", + "Learn about developer responsibilities": "/data-feeds/developer-responsibilities", + } +--- + +import { Aside } from "@components" +import { FeedList } from "@features/feeds" + +Some assets only trade during specific [market hours](/data-feeds/selecting-data-feeds#market-hours): precious metals and forex markets close on weekends and holidays, and some currencies trade mainly during local hours or are subject to capital controls. To support applications that need continuous price data anyway, Chainlink offers [custom feeds](/data-feeds/selecting-data-feeds#-custom-feeds) that publish 24/7 for certain assets in these categories. + +These feeds are not a single, uniform product. Each asset class uses a different methodology to produce a continuous price, and each has its own risk profile. Review the section below for the asset class you are integrating, alongside the [Custom Feeds](/data-feeds/selecting-data-feeds#-custom-feeds) section and [risk mitigation](/data-feeds/selecting-data-feeds#risk-mitigation) guidance appropriate for your use case. + +- [Precious Metals](#precious-metals) +- [Forex](#forex) + +## Precious Metals + +24/7 blended precious metals price feeds publish a precious-metals-linked price both during and outside regular [precious metals market hours](/data-feeds/selecting-data-feeds#market-hours). They use a bespoke methodology rather than a continuously open physical precious metals spot market. + +### How it works + +During [open precious metals market hours](/data-feeds/selecting-data-feeds#market-hours), the feed reports the underlying precious metals spot price (for example, XAU/USD for gold). When the precious metals market is _closed_, the feed starts from the last observed open-market price and adjusts it with a blended signal derived from tokenized precious metals price streams. + +For example, the current tGLD/USD implementation uses [XAUT/USD](/data-streams/crypto-streams?search=XAUT) and [PAXG/USD](/data-streams/crypto-streams?search=PAXG) streams for the closed-market signal. For each available tokenized precious metals stream, the adapter tracks the token's open-market premium or discount to the spot price with an EMA, uses that value to derive a spot-equivalent tokenized price, averages the valid derived prices, and smooths the resulting deviation from the last spot price with another EMA. The composite price applies configurable weighting and deviation controls before the closed-market adjustment is reflected in the answer. Other blended precious metals feeds may use different tokenized streams or methodology variations. + +### Supported feeds + +The following table shows the available 24/7 blended precious metals feeds. + + + +Find these feeds on the [Price Feed Addresses](/data-feeds/price-feeds/addresses) page. + +### Risks + + + +## Forex + +Standard [Forex feeds](/data-feeds/selecting-data-feeds#market-hours) follow the global Forex market schedule (18:00 ET Sunday to 17:00 ET Friday). Some currencies, however, are thinly traded outside their local market hours, subject to capital controls, or otherwise lack a single institutional or interbank rate that is observable at all times. For a subset of these currency pairs, Chainlink offers 24/7 forex feeds that source a crypto-derived exchange rate instead of a traditional interbank or institutional rate. + +### How it works + +A 24/7 crypto-derived forex rate is constructed by observing FX-to-stablecoin-to-FX arbitrage pathways: the implied exchange rate between two currencies, derived from the prices at which each currency trades against stablecoins and other crypto assets across global exchanges, 24 hours a day, 7 days a week. Because this rate is observed through crypto trading venues rather than through a country's official fixing mechanism or regulated banking channels, it is not constrained by capital controls and can be published continuously, including on weekends and local holidays. + +This also means a 24/7 crypto-derived rate measures a different market than an official, interbank, or institutional reference rate for the same currency pair, and the two can diverge, sometimes significantly. For example, [NCFX's analysis of its 24x7 USDARS rate](https://www.newchangefx.com/post/argentina-s-fifth-dollar-what-ncfx-s-24x7-usdars-rate-reveals) found the crypto-derived rate traded at a persistent premium of roughly 2.6% to 7.9% (averaging near 5%) above the institutional reference rate over a five-month period, with the premium widening or compressing in response to events such as central bank or IMF policy news. A 24/7 forex feed reflects the venue and methodology it is built on, not necessarily the rate you would get through a bank, a regulated exchange, or an official government fixing. + +### Supported feeds + +24/7 forex feeds are available for select currency pairs, such as [USD / ARS](https://data.chain.link/feeds/ethereum/mainnet/usd-ars). Check the specific feed's page on [data.chain.link](https://data.chain.link/) for its current data source and methodology before integrating it. + +### Risks + + diff --git a/src/content/data-feeds/blended-precious-metals-feeds.mdx b/src/content/data-feeds/blended-precious-metals-feeds.mdx deleted file mode 100644 index 09bb0fb8cb3..00000000000 --- a/src/content/data-feeds/blended-precious-metals-feeds.mdx +++ /dev/null @@ -1,50 +0,0 @@ ---- -section: dataFeeds -date: Last Modified -title: "24/7 Blended Precious Metals Feeds" -metadata: - title: "24/7 Blended Precious Metals Feeds | Chainlink Data Feeds" - description: "Learn how 24/7 blended precious metals price feeds work, including closed-market methodology and integration risks for custom feeds such as tGLD/USD." - keywords: - ["Blended Precious Metals Feeds", "tGLD", "Custom Feeds", "Precious Metals", "XAU", "Blended Gold", "Data Feeds"] -whatsnext: - { - "Review custom feed categories": "/data-feeds/selecting-data-feeds#-custom-feeds", - "Find Price Feed Addresses": "/data-feeds/price-feeds/addresses", - "Learn about developer responsibilities": "/data-feeds/developer-responsibilities", - } ---- - -import { Aside } from "@components" -import { FeedList } from "@features/feeds" - -24/7 blended precious metals price feeds are [custom feeds](/data-feeds/selecting-data-feeds#-custom-feeds) designed to publish a precious-metals-linked price both during and outside regular [precious metals market hours](/data-feeds/selecting-data-feeds#market-hours). They use a bespoke methodology rather than a continuously open physical precious metals spot market. - -Developers integrating these feeds should review this page alongside the [Custom Feeds](/data-feeds/selecting-data-feeds#-custom-feeds) section and implement [risk mitigation](/data-feeds/selecting-data-feeds#risk-mitigation) appropriate for their use case. - -## How it works - -During [open precious metals market hours](/data-feeds/selecting-data-feeds#market-hours), the feed reports the underlying precious metals spot price (for example, XAU/USD for gold). When the precious metals market is _closed_, the feed starts from the last observed open-market price and adjusts it with a blended signal derived from tokenized precious metals price streams. - -For example, the current tGLD/USD implementation uses [XAUT/USD](/data-streams/crypto-streams?search=XAUT) and [PAXG/USD](/data-streams/crypto-streams?search=PAXG) streams for the closed-market signal. For each available tokenized precious metals stream, the adapter tracks the token's open-market premium or discount to the spot price with an EMA, uses that value to derive a spot-equivalent tokenized price, averages the valid derived prices, and smooths the resulting deviation from the last spot price with another EMA. The composite price applies configurable weighting and deviation controls before the closed-market adjustment is reflected in the answer. Other blended precious metals feeds may use different tokenized streams or methodology variations. - -## Supported feeds - -The following table shows the available 24/7 blended precious metals feeds. - - - -Find these feeds on the [Price Feed Addresses](/data-feeds/price-feeds/addresses) page. - -## Risks - - diff --git a/src/content/data-feeds/llms-full.txt b/src/content/data-feeds/llms-full.txt index 1f375940c3a..cea653ba511 100644 --- a/src/content/data-feeds/llms-full.txt +++ b/src/content/data-feeds/llms-full.txt @@ -1,3 +1,72 @@ +# 24/7 Extended-Hours Data Feeds +Source: https://docs.chain.link/data-feeds/24-7-extended-hours-data-feeds + +Some assets only trade during specific [market hours](/data-feeds/selecting-data-feeds#market-hours): precious metals and forex markets close on weekends and holidays, and some currencies trade mainly during local hours or are subject to capital controls. To support applications that need continuous price data anyway, Chainlink offers [custom feeds](/data-feeds/selecting-data-feeds#-custom-feeds) that publish 24/7 for certain assets in these categories. + +These feeds are not a single, uniform product. Each asset class uses a different methodology to produce a continuous price, and each has its own risk profile. Review the section below for the asset class you are integrating, alongside the [Custom Feeds](/data-feeds/selecting-data-feeds#-custom-feeds) section and [risk mitigation](/data-feeds/selecting-data-feeds#risk-mitigation) guidance appropriate for your use case. + +- [Precious Metals](#precious-metals) +- [Forex](#forex) + +## Precious Metals + +24/7 blended precious metals price feeds publish a precious-metals-linked price both during and outside regular [precious metals market hours](/data-feeds/selecting-data-feeds#market-hours). They use a bespoke methodology rather than a continuously open physical precious metals spot market. + +### How it works + +During [open precious metals market hours](/data-feeds/selecting-data-feeds#market-hours), the feed reports the underlying precious metals spot price (for example, XAU/USD for gold). When the precious metals market is *closed*, the feed starts from the last observed open-market price and adjusts it with a blended signal derived from tokenized precious metals price streams. + +For example, the current tGLD/USD implementation uses [XAUT/USD](/data-streams/crypto-streams?search=XAUT) and [PAXG/USD](/data-streams/crypto-streams?search=PAXG) streams for the closed-market signal. For each available tokenized precious metals stream, the adapter tracks the token's open-market premium or discount to the spot price with an EMA, uses that value to derive a spot-equivalent tokenized price, averages the valid derived prices, and smooths the resulting deviation from the last spot price with another EMA. The composite price applies configurable weighting and deviation controls before the closed-market adjustment is reflected in the answer. Other blended precious metals feeds may use different tokenized streams or methodology variations. + +### Supported feeds + +The following table shows the available 24/7 blended precious metals feeds. + +Find these feeds on the [Price Feed Addresses](/data-feeds/price-feeds/addresses) page. + +### Risks + + + +## Forex + +Standard [Forex feeds](/data-feeds/selecting-data-feeds#market-hours) follow the global Forex market schedule (18:00 ET Sunday to 17:00 ET Friday). Some currencies, however, are thinly traded outside their local market hours, subject to capital controls, or otherwise lack a single institutional or interbank rate that is observable at all times. For a subset of these currency pairs, Chainlink offers 24/7 forex feeds that source a crypto-derived exchange rate instead of a traditional interbank or institutional rate. + +### How it works + +A 24/7 crypto-derived forex rate is constructed by observing FX-to-stablecoin-to-FX arbitrage pathways: the implied exchange rate between two currencies, derived from the prices at which each currency trades against stablecoins and other crypto assets across global exchanges, 24 hours a day, 7 days a week. Because this rate is observed through crypto trading venues rather than through a country's official fixing mechanism or regulated banking channels, it is not constrained by capital controls and can be published continuously, including on weekends and local holidays. + +This also means a 24/7 crypto-derived rate measures a different market than an official, interbank, or institutional reference rate for the same currency pair, and the two can diverge, sometimes significantly. For example, [NCFX's analysis of its 24x7 USDARS rate](https://www.newchangefx.com/post/argentina-s-fifth-dollar-what-ncfx-s-24x7-usdars-rate-reveals) found the crypto-derived rate traded at a persistent premium of roughly 2.6% to 7.9% (averaging near 5%) above the institutional reference rate over a five-month period, with the premium widening or compressing in response to events such as central bank or IMF policy news. A 24/7 forex feed reflects the venue and methodology it is built on, not necessarily the rate you would get through a bank, a regulated exchange, or an official government fixing. + +### Supported feeds + +24/7 forex feeds are available for select currency pairs, such as [USD / ARS](https://data.chain.link/feeds/ethereum/mainnet/usd-ars). Check the specific feed's page on [data.chain.link](https://data.chain.link/) for its current data source and methodology before integrating it. + +### Risks + + + +--- + # Data Feeds API Reference Source: https://docs.chain.link/data-feeds/api-reference @@ -774,40 +843,6 @@ In this step, you will interact with your deployed contract to fetch the BTC/USD --- -# 24/7 Blended Precious Metals Feeds -Source: https://docs.chain.link/data-feeds/blended-precious-metals-feeds - -24/7 blended precious metals price feeds are [custom feeds](/data-feeds/selecting-data-feeds#-custom-feeds) designed to publish a precious-metals-linked price both during and outside regular [precious metals market hours](/data-feeds/selecting-data-feeds#market-hours). They use a bespoke methodology rather than a continuously open physical precious metals spot market. - -Developers integrating these feeds should review this page alongside the [Custom Feeds](/data-feeds/selecting-data-feeds#-custom-feeds) section and implement [risk mitigation](/data-feeds/selecting-data-feeds#risk-mitigation) appropriate for their use case. - -## How it works - -During [open precious metals market hours](/data-feeds/selecting-data-feeds#market-hours), the feed reports the underlying precious metals spot price (for example, XAU/USD for gold). When the precious metals market is *closed*, the feed starts from the last observed open-market price and adjusts it with a blended signal derived from tokenized precious metals price streams. - -For example, the current tGLD/USD implementation uses [XAUT/USD](/data-streams/crypto-streams?search=XAUT) and [PAXG/USD](/data-streams/crypto-streams?search=PAXG) streams for the closed-market signal. For each available tokenized precious metals stream, the adapter tracks the token's open-market premium or discount to the spot price with an EMA, uses that value to derive a spot-equivalent tokenized price, averages the valid derived prices, and smooths the resulting deviation from the last spot price with another EMA. The composite price applies configurable weighting and deviation controls before the closed-market adjustment is reflected in the answer. Other blended precious metals feeds may use different tokenized streams or methodology variations. - -## Supported feeds - -The following table shows the available 24/7 blended precious metals feeds. - -Find these feeds on the [Price Feed Addresses](/data-feeds/price-feeds/addresses) page. - -## Risks - - - ---- - # Flags Contract Registry Source: https://docs.chain.link/data-feeds/contract-registry @@ -3738,7 +3773,7 @@ Custom Feeds have the following categories and compositions: - [๐ŸŸก](#-medium-market-pricing-risk-feeds) **Technical Feeds:** Feeds within this category measure a particular technical metric from a specified blockchain. For example, Fast Gas or Block Difficulty. - [๐ŸŸก](#-medium-market-pricing-risk-feeds) **Total Value Locked Feeds:** These feeds measure the total value locked in a particular protocol. - [๐ŸŸ ](#-high-market-pricing-risk-feeds) **Custom Index Feeds:** An index calculates a function of the values for multiple underlying assets. The function is specific to that index and is typically calculated by node operators following an agreed formula. -- [๐ŸŸ ](#-high-market-pricing-risk-feeds) **24/7 Blended Price Feeds:** Custom feeds that publish outside standard market hours by blending a reference price with other inputs such as tokenized asset streams. See [24/7 blended precious metals feeds](/data-feeds/blended-precious-metals-feeds) for methodology and risk considerations. +- [๐ŸŸ ](#-high-market-pricing-risk-feeds) **24/7 Extended-Hours Feeds:** Custom feeds that publish outside an asset's standard market hours, using a methodology specific to the asset class, such as blending a reference price with tokenized asset streams for precious metals, or sourcing a crypto-derived rate for select forex pairs. See [24/7 Extended-Hours Data Feeds](/data-feeds/24-7-extended-hours-data-feeds) for methodology and risk considerations. - [๐ŸŸ ](#-high-market-pricing-risk-feeds) **Offchain Single Source Feeds:** Some data providers use a single data source, which might be necessary if only one source exists offchain for a specific type of data. - [๐ŸŸ ](#-high-market-pricing-risk-feeds) **Offchain Proof of Reserve Feeds:** Chainlink Proof of Reserve uses a large decentralized collection of security-reviewed and Sybil-resistant node operators to acquire and verify reserve data. In this use case, reserves reside offchain. - [๐ŸŸ ](#-high-market-pricing-risk-feeds) **LP Token Feeds:** These feeds use a decentralized feed for the underlying asset as well as calculations to value the liquidity pool (LP) tokens. @@ -3768,19 +3803,19 @@ Known users of these feeds will be contacted directly about the feeds' deprecati 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. | -| **US_Equities_24/5** | 24 hours a day, 5 days a week: 18:00 ET Sunday to 17:00 ET Friday. These feeds aggregate data across regular, pre-market, post-market, and overnight equity trading sessions. Used by [tokenized equity feeds](/data-feeds/tokenized-equity-feeds) that require continuous equity pricing outside of standard market hours. Feeds are not updated on weekends or 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.
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. We generally observe normal trading within these hours. Prices outside of these hours may be subject to volatility and users are advised to implement additional controls. In addition, local holidays, natural disasters, political unrest or other exogenous shocks are liable to interrupt normal trading in less-liquid currencies. | -| **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.
The feeds also follow the global Forex market holiday schedule for Christmas and New Year's Day. Some [24/7 blended precious metals feeds](/data-feeds/blended-precious-metals-feeds) publish outside these hours using a custom methodology. | -| **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.
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.
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. | +| 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. | +| **US_Equities_24/5** | 24 hours a day, 5 days a week: 18:00 ET Sunday to 17:00 ET Friday. These feeds aggregate data across regular, pre-market, post-market, and overnight equity trading sessions. Used by [tokenized equity feeds](/data-feeds/tokenized-equity-feeds) that require continuous equity pricing outside of standard market hours. Feeds are not updated on weekends or 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.
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. We generally observe normal trading within these hours. Prices outside of these hours may be subject to volatility and users are advised to implement additional controls. In addition, local holidays, natural disasters, political unrest or other exogenous shocks are liable to interrupt normal trading in less-liquid currencies. Some currency pairs are instead offered as [24/7 forex feeds](/data-feeds/24-7-extended-hours-data-feeds#forex), which source a crypto-derived rate and publish continuously; review that page's risk considerations before using one. | +| **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.
The feeds also follow the global Forex market holiday schedule for Christmas and New Year's Day. Some [24/7 blended precious metals feeds](/data-feeds/24-7-extended-hours-data-feeds#precious-metals) publish outside these hours using a custom methodology. | +| **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.
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.
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 @@ -3851,6 +3886,8 @@ Before using a single-source feed, determine whether it is suitable for your use Users of single-source feeds MUST implement additional safeguards such as value bounds, caps, circuit breakers, freshness checks, fallback behavior, monitoring against independent references where available, and manual pause or kill-switch controls. Single-source feeds can be classified as High or Very High Market Pricing Risk depending on the asset, methodology, provider dependency, and intended use case. +For example, the [USD / ARS feed](https://data.chain.link/feeds/ethereum/mainnet/usd-ars) is a [24/7 forex feed](/data-feeds/24-7-extended-hours-data-feeds#forex) that sources a single data provider's crypto-derived rate, which is constructed differently from, and can diverge materially from, Argentina's official, MEP, or CCL exchange rates. Confirm this rate construction matches your use case's definition of the currency pair before relying on it, particularly for anything securing value or triggering liquidations. + If you are using or considering a single-source feed in production, [contact the Chainlink Labs team](mailto:chainlink_data_feeds@smartcontract.com) to discuss the feed's methodology, provider dependency, and appropriate application-level mitigations. ### Crypto and Blockchain Actions diff --git a/src/content/data-feeds/selecting-data-feeds.mdx b/src/content/data-feeds/selecting-data-feeds.mdx index a3722c1526f..a9f5c05fe7a 100644 --- a/src/content/data-feeds/selecting-data-feeds.mdx +++ b/src/content/data-feeds/selecting-data-feeds.mdx @@ -95,7 +95,7 @@ Custom Feeds have the following categories and compositions: - [๐ŸŸก](#-medium-market-pricing-risk-feeds) **Technical Feeds:** Feeds within this category measure a particular technical metric from a specified blockchain. For example, Fast Gas or Block Difficulty. - [๐ŸŸก](#-medium-market-pricing-risk-feeds) **Total Value Locked Feeds:** These feeds measure the total value locked in a particular protocol. - [๐ŸŸ ](#-high-market-pricing-risk-feeds) **Custom Index Feeds:** An index calculates a function of the values for multiple underlying assets. The function is specific to that index and is typically calculated by node operators following an agreed formula. -- [๐ŸŸ ](#-high-market-pricing-risk-feeds) **24/7 Blended Price Feeds:** Custom feeds that publish outside standard market hours by blending a reference price with other inputs such as tokenized asset streams. See [24/7 blended precious metals feeds](/data-feeds/blended-precious-metals-feeds) for methodology and risk considerations. +- [๐ŸŸ ](#-high-market-pricing-risk-feeds) **24/7 Extended-Hours Feeds:** Custom feeds that publish outside an asset's standard market hours, using a methodology specific to the asset class, such as blending a reference price with tokenized asset streams for precious metals, or sourcing a crypto-derived rate for select forex pairs. See [24/7 Extended-Hours Data Feeds](/data-feeds/24-7-extended-hours-data-feeds) for methodology and risk considerations. - [๐ŸŸ ](#-high-market-pricing-risk-feeds) **Offchain Single Source Feeds:** Some data providers use a single data source, which might be necessary if only one source exists offchain for a specific type of data. - [๐ŸŸ ](#-high-market-pricing-risk-feeds) **Offchain Proof of Reserve Feeds:** Chainlink Proof of Reserve uses a large decentralized collection of security-reviewed and Sybil-resistant node operators to acquire and verify reserve data. In this use case, reserves reside offchain. - [๐ŸŸ ](#-high-market-pricing-risk-feeds) **LP Token Feeds:** These feeds use a decentralized feed for the underlying asset as well as calculations to value the liquidity pool (LP) tokens. @@ -124,19 +124,19 @@ Known users of these feeds will be contacted directly about the feeds' deprecati 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. | -| **US_Equities_24/5** | 24 hours a day, 5 days a week: 18:00 ET Sunday to 17:00 ET Friday. These feeds aggregate data across regular, pre-market, post-market, and overnight equity trading sessions. Used by [tokenized equity feeds](/data-feeds/tokenized-equity-feeds) that require continuous equity pricing outside of standard market hours. Feeds are not updated on weekends or 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.
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. We generally observe normal trading within these hours. Prices outside of these hours may be subject to volatility and users are advised to implement additional controls. In addition, local holidays, natural disasters, political unrest or other exogenous shocks are liable to interrupt normal trading in less-liquid currencies. | -| **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.
The feeds also follow the global Forex market holiday schedule for Christmas and New Year's Day. Some [24/7 blended precious metals feeds](/data-feeds/blended-precious-metals-feeds) publish outside these hours using a custom methodology. | -| **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.
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.
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. | +| 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. | +| **US_Equities_24/5** | 24 hours a day, 5 days a week: 18:00 ET Sunday to 17:00 ET Friday. These feeds aggregate data across regular, pre-market, post-market, and overnight equity trading sessions. Used by [tokenized equity feeds](/data-feeds/tokenized-equity-feeds) that require continuous equity pricing outside of standard market hours. Feeds are not updated on weekends or 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.
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. We generally observe normal trading within these hours. Prices outside of these hours may be subject to volatility and users are advised to implement additional controls. In addition, local holidays, natural disasters, political unrest or other exogenous shocks are liable to interrupt normal trading in less-liquid currencies. Some currency pairs are instead offered as [24/7 forex feeds](/data-feeds/24-7-extended-hours-data-feeds#forex), which source a crypto-derived rate and publish continuously; review that page's risk considerations before using one. | +| **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.
The feeds also follow the global Forex market holiday schedule for Christmas and New Year's Day. Some [24/7 blended precious metals feeds](/data-feeds/24-7-extended-hours-data-feeds#precious-metals) publish outside these hours using a custom methodology. | +| **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.
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.
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 @@ -207,6 +207,8 @@ Before using a single-source feed, determine whether it is suitable for your use Users of single-source feeds MUST implement additional safeguards such as value bounds, caps, circuit breakers, freshness checks, fallback behavior, monitoring against independent references where available, and manual pause or kill-switch controls. Single-source feeds can be classified as High or Very High Market Pricing Risk depending on the asset, methodology, provider dependency, and intended use case. +For example, the [USD / ARS feed](https://data.chain.link/feeds/ethereum/mainnet/usd-ars) is a [24/7 forex feed](/data-feeds/24-7-extended-hours-data-feeds#forex) that sources a single data provider's crypto-derived rate, which is constructed differently from, and can diverge materially from, Argentina's official, MEP, or CCL exchange rates. Confirm this rate construction matches your use case's definition of the currency pair before relying on it, particularly for anything securing value or triggering liquidations. + If you are using or considering a single-source feed in production, [contact the Chainlink Labs team](mailto:chainlink_data_feeds@smartcontract.com) to discuss the feed's methodology, provider dependency, and appropriate application-level mitigations. ### Crypto and Blockchain Actions diff --git a/src/features/feeds/components/Tables.tsx b/src/features/feeds/components/Tables.tsx index ccd4dee7e7d..95944aae28c 100644 --- a/src/features/feeds/components/Tables.tsx +++ b/src/features/feeds/components/Tables.tsx @@ -571,7 +571,7 @@ const DefaultTr = ({ {BLENDED_PRECIOUS_METALS_PROXY_ADDRESSES.has(metadata.proxyAddress?.toLowerCase()) && (
diff --git a/src/features/redirects/redirects.json b/src/features/redirects/redirects.json index a00a4d4d04b..fc4ea6485a4 100644 --- a/src/features/redirects/redirects.json +++ b/src/features/redirects/redirects.json @@ -1,5 +1,10 @@ { "redirects": [ + { + "source": "data-feeds/blended-precious-metals-feeds", + "destination": "data-feeds/24-7-extended-hours-data-feeds", + "statusCode": 301 + }, { "source": "docs/any-api/api-reference", "destination": "any-api/api-reference",