---
title: "Reddit 上关于黄金价格 API 的开发者问题，一一解答 · goldprice.dev"
description: "Reddit 上反复出现的黄金价格 API 问题，直接解答：免费套餐、更新频率、速率限制、鉴权方式、数据来源、商业用途，以及它是否足够可靠用于生产。"
canonical: "https://goldprice.dev/zh/blog/gold-price-api-reddit"
---

# Reddit 上关于黄金价格 API 的开发者问题，一一解答

Reddit 上反复出现的黄金价格 API 问题，直接解答：免费套餐、更新频率、速率限制、鉴权方式、数据来源、商业用途，以及它是否足够可靠用于生产。

2026年6月30日 · 阅读时间：4 分钟

在 Reddit 上搜索黄金价格 API，帖子的结构几乎总是一样的。有人在构建行情看板、价格提醒、交易机器人，或者一个需要报价贵金属的在线商店，他们需要一个可以从代码中拉取的实时黄金价格。在接入任何东西之前，他们会在 r/algotrading、r/webdev 和 r/golang 上提出同样几个问题：有没有免费套餐？数据有多新鲜？限流是多少？可以商用吗？数据可信吗？

本文直接回答这些问题，以 goldprice.dev 作为实际示例。阅读无需注册，下面的第一个 API 调用不需要密钥即可运行。

## goldprice.dev 是什么，又不是什么

它是面向开发者的商品定价 API：黄金、白银和铜，通过位于 `https://api.goldprice.dev` 的单一认证 REST 端点提供服务。每个响应都包含经过交叉验证的数据陈旧标志，你还可以通过 `?include=` 请求各数据源的价格和时间戳，或价差指标，让你的代码能够发现某个上游数据源是否正在滞后，而不是默默失效。MCP 服务器在所有套餐中均已包含，包括免费套餐。

它不是经纪商，也不是结算报价源。这些价格是指示性参考数据，用于展示、分析和告警。如果你需要可执行的交易报价来结算一笔交易，任何公开的黄金价格 API 都不是合适的工具，本 API 也不例外。

## 有免费套餐吗？

有，无需信用卡。Free 每月提供 5,000 次调用，每分钟 10 次请求，涵盖延迟 15 分钟的黄金、白银和铜现货。付费套餐增加实时价格、金商报价和更高限额：

| 套餐 | 价格 | 每月调用次数 | 新增内容 |
| --- | --- | --- | --- |
| Free | $0 | 5,000 | XAU/XAG/HG 现货、MCP、最近 30 天日线 |
| Basic | $19/月 | 100,000 | 实时现货、金商报价、最近一年日线 |
| Plus | $39/月 | 300,000 | 完整日线（黄金自 1996 年）；最近 30 天 1h/4h K线；1 个流连接 |
| Pro | $89/月 | 1,000,000 | 完整日内历史；3 connections, SSE or WebSocket in any mix；金商报价流 |

## 价格多久更新一次？

现货价格来自一手市场数据。付费套餐提供实时价格；Free、匿名调用和本网站提供延迟 15 分钟的价格。每个响应带有 `computed_at`，值超出预期刷新窗口时设置 `is_stale`。`?include=sources` 提供各数据源的时间戳，便于核对新鲜度。

## 速率限制是多少？

每分钟请求上限为 Free 10 次、Basic 60 次、Plus 120 次、Pro 300 次。每个响应都会返回标准的 `X-RateLimit-Remaining` 请求头，因此正确的做法是读取该请求头，在剩余次数不多时主动降速，而不是盲目轮询然后触发 429 错误。对于大多数应用，一个客户端短期缓存，TTL 与底层数据实际变化的频率相匹配，就足以让你舒适地维持在免费套餐内。

## 如何进行鉴权？

使用 Bearer Token。密钥以 `ga_live_` 为前缀，放入 `Authorization` 请求头中。此外还有一个匿名接口，每个 IP 限制每分钟 30 次、每小时 100 次、每月 1,000 次请求，返回价格、时间戳和陈旧字段。bid/ask 为付费专属可选字段，需要一致的双边报价。鉴权会解锁 `?include=stats`：开盘价、最高价、最低价、前收盘价、涨跌幅，以及跨数据源的价差字段，`?include=sources` 和 `?include=karat` 无论是否鉴权都可以使用。

## 我能看到这个数字从哪里来吗？

可以，而且这正是大多数 API 隐藏的部分。加上 `?include=sources`，响应就会包含一个 `sources[]` 数组，每行对应一个上游数据源，各自有独立的价格和时间戳。当各数据源出现分歧时，`?include=stats`（需鉴权）会带有 `divergence_bps` 和 `divergence_flag`，让你可以自行设定容忍阈值，而不是盲目相信一个无来源可查的混合数字。如果你在构建任何一个价格出错会造成损失的系统，这种可见性正是选择结构化 API 而非抓取网页的理由。

## 可以商业使用吗？

所有套餐均允许商业使用。付费套餐无需署名链接；Free 要求在价格附近显示指向 goldprice.dev 的可见链接。数据本身的再分发或转售需要另行签约，请联系 hello@goldprice.dev。

## 我的 LLM 智能体可以使用它吗？

可以。MCP 服务器包含在所有套餐中，包括免费套餐。你只需在 Claude、Cursor 或任何支持 MCP 的运行时中添加一个配置块，智能体就能直接获取实时价格，无需手写任何工具代码。数据与 REST API 提供的完全相同。如需了解设置细节，可查阅[完整的 MCP 使用指南](https://goldprice.dev/blog/gold-prices-llm-agent-mcp)。

## 最简单的调用

无需密钥，无需任何依赖：

```bash
curl https://api.goldprice.dev/v1/prices?symbol=XAU-USD-SPOT
```

你将得到含价格和陈旧标志的 JSON，延迟 15 分钟。bid/ask 为付费专属可选字段，只有一致的双边报价可用时才出现。加上 `?include=karat` 可以获取按成色分克重的换算明细，加上 `?include=sources` 可以获取贡献数据源。当你需要完整响应体和更高限额时，申请一个[免费密钥](https://goldprice.dev/docs/quickstart)只需一分钟。

如需特定语言的版本，[Fetch live gold prices in JavaScript](https://goldprice.dev/blog/fetch-gold-prices-javascript) 完整覆盖了 REST 调用的全流程，[Caching gold prices and staying inside rate limits](https://goldprice.dev/blog/gold-price-caching-rate-limits) 则介绍了如何在大规模场景下使用。

## 继续阅读

- [用 Python 获取每克黄金价格（24K、22K、18K）](https://goldprice.dev/zh/blog/gold-price-per-gram-python)
- [在 Google Sheets 中制作黄金投资组合追踪表](https://goldprice.dev/zh/blog/gold-portfolio-tracker-google-sheets)
- [实时黄金价格图表是如何工作的？](https://goldprice.dev/zh/blog/live-gold-price-chart)
- [在不引入外汇前视偏差的情况下回测本币计价的黄金](https://goldprice.dev/zh/blog/backtest-gold-local-currency)

Source: https://goldprice.dev/zh/blog/gold-price-api-reddit
