价格多久更新一次

现货接口可每隔 60 秒更新一次。可下载的工作流每小时运行一次，每次执行调用 API 一次。调整频率前，请先确认对月度额度的影响。

自动刷新会超出免费额度吗

每小时执行一次不会超出：24 × 30 约为每月 720 次，在免费套餐的 5,000 次额度内。每 15 分钟执行一次约为每月 2,880 次，每 5 分钟执行一次约为每月 8,640 次。多个工作流的调用量会累加。

所有套餐都允许商用。付费套餐无需添加署名链接。使用免费套餐时，必须在价格附近放置清晰可见的 goldprice.dev 链接。

为什么固定使用 HTTP Request v4

下载文件指定 HTTP Request 的 typeVersion: 4.2 和 Schedule Trigger 的 typeVersion: 1.2 ，与此处使用的 n8n 2.x 工作流导出格式一致。导入后，如果 n8n 显示迁移提示，请先检查再发布。

支持黄金（XAU）、白银（XAG）和铜（HG）。所有套餐均不提供铂金和钯金。替换交易符号中的金属代码即可，例如 XAG-USD-SPOT 。

免费套餐真的免费吗

是的，每月含 5,000 次调用，无需信用卡，也没有到期时间。前往 /onboarding 获取密钥。

可以让 Claude 帮我编写吗

可以。为 Claude 配置 goldprice.dev MCP 服务器，然后输入：创建 n8n 2.x 工作流，使用 HTTP Request v4.2 每小时调用 /v1/spot/XAU-USD-SPOT。通过请求头认证配置 X-API-Key，不要在导出文件中包含凭据。发布前，请检查导入的节点并手动测试。

n8n 实时金价：自动化工作流教程

Q: 可以让 Claude 帮我编写吗

可以。为 Claude 配置 goldprice.dev MCP 服务器，然后输入： 创建 n8n 2.x 工作流，使用 HTTP Request v4.2 每小时调用 /v1/spot/XAU-USD-SPOT。通过请求头认证配置 X-API-Key，不要在导出文件中包含凭据。 发布前，请检查导入的节点并手动测试。

要在 n8n 中自动获取实时金价，请导入不含凭据的 goldprice.dev 工作流 JSON，创建名为 X-API-Key 的请求头认证凭据，并绑定到 HTTP Request v4.2 节点。工作流默认未启用，通过 Schedule Trigger v1.2 每小时调用一次 api.goldprice.dev/v1/spot/XAU-USD-SPOT。按每月 30 天计算，每小时执行约需 720 次调用，在免费套餐每月 5,000 次额度内。手动运行成功后再发布。

获取 goldprice.dev API 密钥

前往 goldprice.dev/onboarding 注册免费账户。控制台会显示以 ga_live_ 开头的密钥。下一步将其存入 n8n 凭据，不要直接粘贴到节点字段中。

免费套餐每月含 5,000 次调用，支持以 31 种货币报价的黄金现货价格。无需信用卡。

导入不含凭据的工作流

**下载每小时运行的 n8n 工作流 JSON**，然后在 n8n 中选择从文件导入。文件包含 Schedule Trigger v1.2 和 HTTP Request v4.2 节点，默认未启用，不含 API 密钥或凭据绑定。

创建并绑定请求头认证凭据

创建 n8n 请求头认证凭据。将名称设为 X-API-Key，将值设为 goldprice.dev 密钥。打开获取金价节点，选择通用凭据类型 → 请求头认证，再选中该凭据。将密钥保存在 n8n 凭据中，可避免它出现在导出的工作流 JSON 中。

n8n · HTTP 请求节点节选

{  "parameters": {    "url": "https://api.goldprice.dev/v1/spot/XAU-USD-SPOT",    "authentication": "genericCredentialType",    "genericAuthType": "httpHeaderAuth",    "options": {      "response": {        "response": {          "neverError": false,          "responseFormat": "autodetect"        }      },      "timeout": 5000    }  },  "type": "n8n-nodes-base.httpRequest",  "typeVersion": 4.2,  "retryOnFail": true,  "maxTries": 3,  "waitBetweenTries": 2000,  "onError": "continueErrorOutput"}

运行一次并检查输出

点击执行工作流。确认获取金价节点返回价格、computed_at 和 is_stale。买入价和卖出价仅限付费套餐，可能不会返回。发布前先解决所有凭据错误。手动运行成功后，发布工作流以启用每小时执行的计划。

切换货币或金属

修改获取金价节点中 URL 的最后一段。交易符号格式为 METAL-CURRENCY-SPOT。需要查询多个符号时，先创建输入项，再在 HTTP Request 节点中使用 https://api.goldprice.dev/v1/spot/{{ $json.symbol }}。

n8n · 多币种输入项

[  { "symbol": "XAU-USD-SPOT" },  { "symbol": "XAU-INR-SPOT" },  { "symbol": "XAU-EUR-SPOT" },  { "symbol": "XAG-USD-SPOT" }]

预期输出

JSON

{  "symbol": "XAU",  "quote_currency": "USD",  "unit": "troy_ounce",  "contract_type": "spot",  "price": "4012.75",  "is_stale": false,  "computed_at": "2026-08-18T08:00:00Z"}

HTTP Request 节点的输出面板显示完整 JSON。下游节点可通过 {{ $json.price }} 或 {{ $json.computed_at }} 等表达式引用字段。

常见错误

代码	现象	解决方法
401	HTTP Request 节点失败，显示 `401 Unauthorized`	API 密钥缺失或无效。打开凭据 → X-API-Key，粘贴从控制台获取的新密钥。确认 HTTP Request 节点的身份验证下拉菜单已选择该凭据，路径为通用凭据类型 → 请求头认证。
429	错误输出分支偶尔出现 `429 Too Many Requests`	执行过于频繁，或多个工作流共用同一套餐。每小时执行一次，30 天约调用 720 次；每 15 分钟执行一次则为 2,880 次。降低触发频率，并按 API 的额度重置提示等待后再重试。持续失败的执行会显示在节点的错误输出中。
N/A	导出的工作流 JSON 中出现明文 API 密钥	密钥被直接粘贴到了 URL 或请求头字段中，没有使用凭据。删除该值，按步骤 3 创建请求头认证凭据，并在身份验证下拉菜单中选中它。n8n 不导出凭据值，但会原样导出直接填写的值。
N/A	手动运行正常，但工作流从不按小时执行	导入的工作流默认未启用。手动验证凭据成功后，请发布工作流。只有已发布的工作流才会触发 Schedule Trigger。

进阶用法

在 HTTP Request 后添加 Postgres 节点，插入 {symbol, price, computed_at} 数据行，用于时间序列分析
通过 IF 节点判断 price > threshold，满足条件时发送 Slack/Discord 提醒
循环处理多个输入项，在同一工作流中跟踪黄金、白银和铜
将错误输出接入 Slack 频道，让 429 错误触发可见提醒，避免失败后无人察觉

如何在 n8n 中获取实时金价