Free gold price widgetsWidget

Gold price widget for China

Show gold prices in Chinese yuan for visitors comparing gold content

27 Oct 2026 · 2 min read

Embed the live gold price in Chinese yuan with one free iframe, without needing an API key. Today's 24K gold price is unavailable per gram, while 22K gold is unavailable per gram. Each preview includes code you can paste into your website.

24K gold per gram in CNY
22K gold per gram in CNY

Gold price previews for China

Embed code for 24K
<iframe src="https://goldprice.dev/embed/xau?currency=CNY&unit=gram&karat=24&theme=auto&locale=en" title="Gold price" width="360" height="190" loading="lazy" style="border:0;width:100%;max-width:360px" referrerpolicy="strict-origin-when-cross-origin"></iframe>
Embed code for 22K
<iframe src="https://goldprice.dev/embed/xau?currency=CNY&unit=gram&karat=22&theme=auto&locale=en" title="Gold price" width="360" height="190" loading="lazy" style="border:0;width:100%;max-width:360px" referrerpolicy="strict-origin-when-cross-origin"></iframe>

Add the widget to your website

Copy the iframe code below either preview. Paste it into a custom HTML block on your page, then save your changes.

Open your page on a phone and check that the card fits. It stays within 360 pixels and fits narrow screens. The price refreshes by itself.

Widget settings

Each setting is a query parameter in the iframe address. Use the widget builder to choose your settings and generate the code.

SettingOptionsUsed on this page
currencyUSD, AUD, BGN, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TRY, ZARCNY
unitoz, gramgram
karat24, 22, 21, 20, 18, 16, 14, 1024, 22
themeauto, light, darkauto
localeen, ar, es, id, ja, ko, vi, zhen

A gold widget for China

The CNY gold page for China shows 24K, 22K and 18K prices. A jewellery site can select a matching gram setting to display the gold content reference in Chinese yuan, alongside the shop's own selling prices.

In mainland China, the liang, often written as tael in English, weighs 50 g. Its value is the gram price times 50 at the same purity. The widget itself shows grams and troy ounces only.

What this gold value covers

The value comes from the gold spot price and reflects gold content only. It excludes dealer premium, making charges and tax, which a shop's selling price includes.

The card shows the update time and gold's twenty four hour percentage change. It refreshes by itself and links to goldprice.dev. Both the card's price and the figures written in this page's text are fifteen minutes late, as of unavailable.

Questions

How do I add a gold price widget in CNY to my website?

Copy the code beneath a CNY preview into your site's HTML block. The iframe shows gold prices in Chinese yuan, refreshes automatically and needs neither a sign-up nor an API key.

Is the CNY gold price the same as a jewellery shop price?

The CNY widget represents gold content using a spot-derived price at the selected karat. Jewellery shop selling prices add making charges, premium and tax. The displayed reference excludes each of those additions.

Can the gold price widget display a tael price?

The widget offers grams and troy ounces only. In mainland China, a liang, often called a tael in English, weighs 50 g. Multiply the gram price by 50 at the same purity to work out its gold content value.

Keep reading

Start with a free API key

5,000 requests a month on the free plan. No credit card.

Get a free key