From 7da56c7b8accc89882233e1297f96cd643ba7188 Mon Sep 17 00:00:00 2001 From: Sebastian Lerner Date: Thu, 2 Jul 2026 19:48:02 -0400 Subject: [PATCH 1/7] Document tGLD blended gold feed risks --- src/content/data-feeds/selecting-data-feeds.mdx | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/src/content/data-feeds/selecting-data-feeds.mdx b/src/content/data-feeds/selecting-data-feeds.mdx index 57cbcc67ccd..8acff53d514 100644 --- a/src/content/data-feeds/selecting-data-feeds.mdx +++ b/src/content/data-feeds/selecting-data-feeds.mdx @@ -120,6 +120,22 @@ In addition to categories, be aware that markets for several assets are actively | **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. | +## 24/7 blended gold price feeds + +Some custom feeds, such as the tGLD/USD 24/7 blended price feed on Ethereum mainnet, are designed to publish a gold-linked price both during and outside regular precious metals market hours. During open market hours, the feed reports the XAU/USD price. When the XAU market is closed, the feed starts from the last observed open-market XAU/USD price and adjusts it with a blended signal derived from tokenized gold price streams. + +The current implementation uses XAUT/USD and PAXG/USD streams for the closed-market signal. For each available tokenized gold stream, the adapter tracks the token's open-market premium or discount to XAU/USD with an EMA, uses that value to derive a spot-equivalent tokenized gold price, averages the valid derived prices, and smooths the resulting deviation from the last XAU/USD price with another EMA. The composite price then applies a configurable weight to that smoothed deviation. In the current implementation, the tokenized-gold signal has a 70% weight and the smoothed deviation is capped between -5% and +2.5% before it is applied. + + + ## 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. From 64a22ac0788bc53667319e2b5af89cdfc0330cac Mon Sep 17 00:00:00 2001 From: Sebastian Lerner Date: Thu, 2 Jul 2026 19:49:59 -0400 Subject: [PATCH 2/7] Redact blended gold feed parameters --- src/content/data-feeds/selecting-data-feeds.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/data-feeds/selecting-data-feeds.mdx b/src/content/data-feeds/selecting-data-feeds.mdx index 8acff53d514..dd7a30fec3e 100644 --- a/src/content/data-feeds/selecting-data-feeds.mdx +++ b/src/content/data-feeds/selecting-data-feeds.mdx @@ -124,7 +124,7 @@ In addition to categories, be aware that markets for several assets are actively Some custom feeds, such as the tGLD/USD 24/7 blended price feed on Ethereum mainnet, are designed to publish a gold-linked price both during and outside regular precious metals market hours. During open market hours, the feed reports the XAU/USD price. When the XAU market is closed, the feed starts from the last observed open-market XAU/USD price and adjusts it with a blended signal derived from tokenized gold price streams. -The current implementation uses XAUT/USD and PAXG/USD streams for the closed-market signal. For each available tokenized gold stream, the adapter tracks the token's open-market premium or discount to XAU/USD with an EMA, uses that value to derive a spot-equivalent tokenized gold price, averages the valid derived prices, and smooths the resulting deviation from the last XAU/USD price with another EMA. The composite price then applies a configurable weight to that smoothed deviation. In the current implementation, the tokenized-gold signal has a 70% weight and the smoothed deviation is capped between -5% and +2.5% before it is applied. +The current implementation uses XAUT/USD and PAXG/USD streams for the closed-market signal. For each available tokenized gold stream, the adapter tracks the token's open-market premium or discount to XAU/USD with an EMA, uses that value to derive a spot-equivalent tokenized gold price, averages the valid derived prices, and smooths the resulting deviation from the last XAU/USD price with another EMA. The composite price applies configurable weighting and deviation controls before the closed-market adjustment is reflected in the answer. ## Risk Mitigation From fe543258d91dfb865f7486b91230248bd2f6f847 Mon Sep 17 00:00:00 2001 From: Sebastian Lerner Date: Mon, 6 Jul 2026 12:17:49 -0400 Subject: [PATCH 4/7] Move tGLD blended gold docs to a dedicated custom feeds page. Keep selecting-data-feeds concise with a Custom Feeds bullet and Precious_Metals cross-link, and document methodology and risks on blended-gold-feeds. Co-authored-by: Cursor --- src/content/data-feeds/blended-gold-feeds.mdx | 56 +++++++++++++++++++ .../data-feeds/selecting-data-feeds.mdx | 19 +------ 2 files changed, 58 insertions(+), 17 deletions(-) create mode 100644 src/content/data-feeds/blended-gold-feeds.mdx diff --git a/src/content/data-feeds/blended-gold-feeds.mdx b/src/content/data-feeds/blended-gold-feeds.mdx new file mode 100644 index 00000000000..13fa40f7da7 --- /dev/null +++ b/src/content/data-feeds/blended-gold-feeds.mdx @@ -0,0 +1,56 @@ +--- +section: dataFeeds +date: Last Modified +title: "24/7 Blended Gold Feeds" +metadata: + title: "24/7 Blended Gold Feeds | Chainlink Data Feeds" + description: "Learn how 24/7 blended gold price feeds work, including closed-market methodology and integration risks for custom feeds such as tGLD/USD." + keywords: + [ + "Blended Gold Feeds", + "tGLD", + "Custom Feeds", + "Precious Metals", + "XAU", + "Tokenized 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" + +24/7 blended gold price feeds are [custom feeds](/data-feeds/selecting-data-feeds#-custom-feeds) designed to publish a gold-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 gold 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, the feed reports the XAU/USD price. When the XAU market is closed, the feed starts from the last observed open-market XAU/USD price and adjusts it with a blended signal derived from tokenized gold price streams. + +The current implementation uses XAUT/USD and PAXG/USD streams for the closed-market signal. For each available tokenized gold stream, the adapter tracks the token's open-market premium or discount to XAU/USD with an EMA, uses that value to derive a spot-equivalent tokenized gold price, averages the valid derived prices, and smooths the resulting deviation from the last XAU/USD price with another EMA. The composite price applies configurable weighting and deviation controls before the closed-market adjustment is reflected in the answer. + +## Supported feeds + +| Feed | Network | Proxy address | +| ---- | ------- | ------------- | +| tGLD/USD - 24/7 Blended Price | Ethereum Mainnet | [0x369C67E8b026CC4Ef98350f332D7Dd52b85b7674](https://etherscan.io/address/0x369C67E8b026CC4Ef98350f332D7Dd52b85b7674) | + +Find this feed on the [Price Feed Addresses](/data-feeds/price-feeds/addresses) page. + +## Risks + + diff --git a/src/content/data-feeds/selecting-data-feeds.mdx b/src/content/data-feeds/selecting-data-feeds.mdx index f948bfd9ac4..5d33b189fdc 100644 --- a/src/content/data-feeds/selecting-data-feeds.mdx +++ b/src/content/data-feeds/selecting-data-feeds.mdx @@ -86,6 +86,7 @@ Custom feeds have the following categories and compositions: - Technical Feeds: Feeds within this category measure a particular technical metric from a specified blockchain. For example, Fast Gas or Block Difficulty. - Total Value Locked Feeds: These feeds measure the total value locked in a particular protocol. - 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. +- 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 gold feeds](/data-feeds/blended-gold-feeds) for methodology and risk considerations. - 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. - 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. - LP Token Feeds: These feeds use a decentralized feed for the underlying asset as well as calculations to value the liquidity pool (LP) tokens. @@ -113,29 +114,13 @@ In addition to categories, be aware that markets for several assets are actively | **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.
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. | +| **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 gold feeds](/data-feeds/blended-gold-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. | -## 24/7 blended gold price feeds - -Some custom feeds, such as the tGLD/USD 24/7 blended price feed on Ethereum mainnet, are designed to publish a gold-linked price both during and outside regular precious metals market hours. During open market hours, the feed reports the XAU/USD price. When the XAU market is closed, the feed starts from the last observed open-market XAU/USD price and adjusts it with a blended signal derived from tokenized gold price streams. - -The current implementation uses XAUT/USD and PAXG/USD streams for the closed-market signal. For each available tokenized gold stream, the adapter tracks the token's open-market premium or discount to XAU/USD with an EMA, uses that value to derive a spot-equivalent tokenized gold price, averages the valid derived prices, and smooths the resulting deviation from the last XAU/USD price with another EMA. The composite price applies configurable weighting and deviation controls before the closed-market adjustment is reflected in the answer. - - - ## 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. From 1baf7465436bf54f4ff136e13a9235b53d7c2012 Mon Sep 17 00:00:00 2001 From: devin distefano Date: Fri, 17 Jul 2026 01:40:39 -0500 Subject: [PATCH 5/7] upgraded and generalized tokenized metal feed pages --- src/config/sidebar.ts | 1 + src/content/data-feeds/blended-gold-feeds.mdx | 56 ------------------- .../blended-precious-metals-feeds.mdx | 50 +++++++++++++++++ src/content/data-feeds/llms-full.txt | 37 ++++++------ .../data-feeds/selecting-data-feeds.mdx | 4 +- src/features/data/chains.ts | 21 ++++++- src/features/feeds/components/Tables.tsx | 13 ++++- src/features/feeds/types.ts | 1 + src/features/feeds/utils/chainFilters.ts | 7 ++- src/features/feeds/utils/feedVisibility.ts | 12 +++- 10 files changed, 119 insertions(+), 83 deletions(-) delete mode 100644 src/content/data-feeds/blended-gold-feeds.mdx create mode 100644 src/content/data-feeds/blended-precious-metals-feeds.mdx diff --git a/src/config/sidebar.ts b/src/config/sidebar.ts index 39c00a14ae2..1d1ed9d94ab 100644 --- a/src/config/sidebar.ts +++ b/src/config/sidebar.ts @@ -868,6 +868,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: "Self-Managed Feeds", url: "data-feeds/self-managed-feeds" }, ], }, diff --git a/src/content/data-feeds/blended-gold-feeds.mdx b/src/content/data-feeds/blended-gold-feeds.mdx deleted file mode 100644 index 13fa40f7da7..00000000000 --- a/src/content/data-feeds/blended-gold-feeds.mdx +++ /dev/null @@ -1,56 +0,0 @@ ---- -section: dataFeeds -date: Last Modified -title: "24/7 Blended Gold Feeds" -metadata: - title: "24/7 Blended Gold Feeds | Chainlink Data Feeds" - description: "Learn how 24/7 blended gold price feeds work, including closed-market methodology and integration risks for custom feeds such as tGLD/USD." - keywords: - [ - "Blended Gold Feeds", - "tGLD", - "Custom Feeds", - "Precious Metals", - "XAU", - "Tokenized 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" - -24/7 blended gold price feeds are [custom feeds](/data-feeds/selecting-data-feeds#-custom-feeds) designed to publish a gold-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 gold 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, the feed reports the XAU/USD price. When the XAU market is closed, the feed starts from the last observed open-market XAU/USD price and adjusts it with a blended signal derived from tokenized gold price streams. - -The current implementation uses XAUT/USD and PAXG/USD streams for the closed-market signal. For each available tokenized gold stream, the adapter tracks the token's open-market premium or discount to XAU/USD with an EMA, uses that value to derive a spot-equivalent tokenized gold price, averages the valid derived prices, and smooths the resulting deviation from the last XAU/USD price with another EMA. The composite price applies configurable weighting and deviation controls before the closed-market adjustment is reflected in the answer. - -## Supported feeds - -| Feed | Network | Proxy address | -| ---- | ------- | ------------- | -| tGLD/USD - 24/7 Blended Price | Ethereum Mainnet | [0x369C67E8b026CC4Ef98350f332D7Dd52b85b7674](https://etherscan.io/address/0x369C67E8b026CC4Ef98350f332D7Dd52b85b7674) | - -Find this feed on the [Price Feed Addresses](/data-feeds/price-feeds/addresses) page. - -## Risks - - diff --git a/src/content/data-feeds/blended-precious-metals-feeds.mdx b/src/content/data-feeds/blended-precious-metals-feeds.mdx new file mode 100644 index 00000000000..09bb0fb8cb3 --- /dev/null +++ b/src/content/data-feeds/blended-precious-metals-feeds.mdx @@ -0,0 +1,50 @@ +--- +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 409daefe82d..073459d7db1 100644 --- a/src/content/data-feeds/llms-full.txt +++ b/src/content/data-feeds/llms-full.txt @@ -774,37 +774,36 @@ In this step, you will interact with your deployed contract to fetch the BTC/USD --- -# 24/7 Blended Gold Feeds -Source: https://docs.chain.link/data-feeds/blended-gold-feeds +# 24/7 Blended Precious Metals Feeds +Source: https://docs.chain.link/data-feeds/blended-precious-metals-feeds -24/7 blended gold price feeds are [custom feeds](/data-feeds/selecting-data-feeds#-custom-feeds) designed to publish a gold-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 gold spot market. +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, the feed reports the XAU/USD price. When the XAU market is closed, the feed starts from the last observed open-market XAU/USD price and adjusts it with a blended signal derived from tokenized gold price streams. +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. -The current implementation uses XAUT/USD and PAXG/USD streams for the closed-market signal. For each available tokenized gold stream, the adapter tracks the token's open-market premium or discount to XAU/USD with an EMA, uses that value to derive a spot-equivalent tokenized gold price, averages the valid derived prices, and smooths the resulting deviation from the last XAU/USD price with another EMA. The composite price applies configurable weighting and deviation controls before the closed-market adjustment is reflected in the answer. +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 -| Feed | Network | Proxy address | -| ----------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------------------- | -| tGLD/USD - 24/7 Blended Price | Ethereum Mainnet | [0x369C67E8b026CC4Ef98350f332D7Dd52b85b7674](https://etherscan.io/address/0x369C67E8b026CC4Ef98350f332D7Dd52b85b7674) | +The following table shows the available 24/7 blended precious metals feeds. -Find this feed on the [Price Feed Addresses](/data-feeds/price-feeds/addresses) page. +Find these feeds on the [Price Feed Addresses](/data-feeds/price-feeds/addresses) page. ## Risks -