goldprice.dev使用免费的 iframe 组件，即可在商店网站显示实时金价。无需注册或 API 密钥，组件会自动刷新。本页文字中的价格延迟十五分钟，截至 2026年10月30日 21:08 UTC：24K 黄金（纯度 99.9%）每克 unavailable，22K 黄金每克 unavailable，均未计入工费和 GST。
- 在生成器中选择货币、单位、K 数、主题和语言。
- 将生成的 iframe 粘贴到支持 HTML 的页面中。
- 注明显示的是基于现货价的价格，并与店内售价区分。
选择组件设置
打开黄金价格组件生成器。选择货币，以及金衡盎司或克作为单位。单位为克时，还需选择 K 数。再选择浅色、深色或自动主题，以及页面所用语言。
参数表列出了可用值和默认值。印度商店示例选择卢比、克和 22K。每克价格按所选纯度计算，因此复制生成的代码前，请同时检查单位和 K 数。
| 参数 | 可用值 | 默认值 |
|---|---|---|
| currency | USD, 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, ZAR | USD |
| unit | oz, gram | oz |
| karat | 24, 22, 21, 20, 18, 16, 14, 10 | 24 |
| theme | auto, light, dark | auto |
| locale | en, ar, es, id, ja, ko, vi, zh | en |
复制 iframe 代码
生成器会根据你的设置生成 iframe。将该代码作为 HTML 复制。下方示例以卢比显示 22K 黄金的每克价格，与首饰店示例一致，并非每盎司报价。
嵌入的卡片显示基于现货价的价格、过去二十四小时的变动和更新时间。它会自动刷新，并链接至 goldprice.dev。卡片价格和本页文字中的价格均延迟十五分钟。
<iframe src="https://goldprice.dev/embed/xau?currency=INR&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>粘贴到网页中
将代码添加到自定义 HTML 区块或网站中其他支持 HTML 的位置。保存页面后，打开公开页面，确认 iframe 显示为价格卡片，而非直接显示代码。
在旁边简要说明，这个数字是基于现货价的金属价值，不含经销商溢价和税费。组件本身也会注明这一点。附近的清晰说明有助于访客区分参考价与店内售价。
检查手机端显示
在窄屏设备上打开页面，检查卡片、周围文字和所选语言。卡片最宽为 360 像素，可适应窄屏。也请确认页面中容纳卡片的区块留有足够空间。
确认卡片中显示的货币、克单位和 K 数。检查更新时间是否可见，附近的说明是否仍清晰易读。访客应无需打开其他页面，就能了解价格的计算依据。
说明店内售价
组件显示所含黄金的现货价值，不代表店内成品售价。工费、经销商溢价和税费都会影响总价，因此请在每件商品的详情旁清楚标明其售价。
面向商店的说明可见首饰店金价组件页面。如需从金属价值计算成品价格，请参考含工费的首饰价格。物品重量和纯度应与参考每克价格的单位及纯度一致。