每个来源，清晰可见

按来源直接传递

大多数金属 API 从多个数据流收集价格，计算加权中位数，丢弃输入数据，然后给你一个数字。混合过程并不透明。当各交易所的价格不一致时（每天在换月、结算及每次市场收盘前后都会发生），你无法判断 API 的数字反映的是实际情况，还是 API 内部的权重分配。

现货价格直接传递自一个已获许可的主来源，不混合，也不取平均值。发生中断时，由已获许可的备用来源提供黄金和白银价格。铜没有备用来源。添加 ?include=sources，即可查看提供该价格的来源、该来源的价格、fetched_at 和 source_timestamp。

GET /v1/prices?symbol=XAU-USD-SPOT&include=sources

{
  "symbol": "XAU",
  "price": "4803.94",
  "is_stale": false,
  "computed_at": "2026-05-01T02:34:02Z",
  "sources": [
    { "source": "oracle.xau_usd", "display_name": "Live spot", "price": "4803.94", "fetched_at": "...", "source_timestamp": "..." }
  ]
}

我们接入的来源

各层级的来源类别。每次调用中，某个价格使用了哪些数据流，其证据都在你的 /v1/prices 响应中。

来源标识符、刷新频率和上游端点详情均记录在内部文档中，并随每次发布而变化。如果法律评估需要这些详细信息，请将你的使用场景发送至 hello@goldprice.dev，我们会回复。

货币页面上的非 USD 价格，是 USD 黄金现货价乘以我们的姊妹货币 API exchangerate.dev 提供的实时汇率。非 USD 现货行不使用已存储的汇率作为后备。如果实时汇率停止更新，/v1/convert 和 /v1/carat 会使用存储时间不超过 3 天的最新汇率；非 USD 现货行则保留过时的价格。

备用现货数据流

现货价格使用已获许可的主要市场数据。买价和卖价仅供付费套餐选择使用，且需要一致的双向报价。如果主来源停止服务，黄金和白银会切换至已获许可的备用来源，直到主来源恢复。备用价格最多可能比市场滞后约两分钟。使用备用来源期间，响应中不包含买价或卖价。

金属市场休市时，我们不使用备用来源：每天 17:00 至 18:00，以及周五 17:00 至周日 18:00，均为纽约时间。铜没有备用来源。如果其数据流停止更新，最后一个铜价会被标记为过时。

来源间偏差

至少有两个未过时主来源的行包含 divergence_bps：以基点表示的、相对于平均值的价格差。现货行使用一个来源，因此省略此字段。GET /v1/prices/divergence 在所有层级列出价格差超过阈值的品种代码。

XAU-USD-SPOT 的 divergence_flag 始终为 false；非 USD 黄金价格使用 USD 现货价 × exchangerate.dev 实时汇率。

关于 LBMA 定盘价

按来源判断数据是否过时

当提供价格的来源超出其预期刷新时间窗口时，顶层 is_stale 会变为 true。添加 ?include=sources，即可查看该来源的价格、fetched_at 和 source_timestamp，自行判断数据的新鲜度。

远期展望：期货曲线

市场隐含的远期价格路径由 /v1/forward-view/{asset} 提供。下文说明计算方法、来源和刷新频率。

期货曲线

接下来的 5 个黄金远期合约。结算价通过我们的主要延迟数据流序列提供，延迟约 15 分钟，并设有次级后备来源。期货数值来自公开可用的延迟数据流，并非已获许可的实时数据。虚线连接 5 个结算点；当某个合约的主要数据流和后备数据流均失败时，会出现空缺。持仓量和成交量按尽力而为原则处理，值为 null，不在响应中显示。

数据新鲜度

期货结算价在工作日 20:30 UTC 更新：全年采用同一时间表，在 EDT 为结算后 +2h，在 EST 为结算后 +1h，不随夏令时切换而改变。

我们不做什么

• LBMA 定盘价 见上文。
• 逐笔级 L2 订单簿 我们发布价格，不发布市场深度。逐笔级订单簿不在此 API 的覆盖范围内。
• 亚秒级延迟保证 我们不公布具体数值的延迟 SLA。
• 静默混合 这正是本页的主旨。

常见问题

我们的价格来自哪里，以及备用覆盖如何运作。

你们的主要和备用数据提供商是谁？

我们使用一家已获许可的主要市场数据提供商提供黄金、白银和铜数据。另有一家已获许可的备用提供商覆盖黄金和白银。我们不公布这两家提供商的名称。

你们的现货价格是综合价格，还是单一提供方的报价？

我们直接传递主要提供商的价格，不混合，也不取平均值。它不是官方基准，也不是 LBMA 定盘价。?include=sources 返回带有 fetched_at 和 source_timestamp 的 sources[]。

如果主要数据流停止更新，会发生什么？

主来源不可用期间，由已获许可的备用来源提供黄金和白银价格。它可能滞后约两分钟，且没有买价或卖价。铜没有备用来源。当使用中的来源超出其预期刷新时间窗口时，is_stale 会变为 true。

方法变更日志

如需查看方法修订之外的 API 端点、层级和产品发布，请参阅产品变更日志。

有关于 API 的问题？阅读文档。