设置黄金价格提醒

Plus 或 Pro 用户可在账户中设置黄金价格提醒。Free 或 Basic 用户可定时查询 API，并接入自己的通知工具。截至 2026年10月29日 12:14 UTC，当前报价为每金衡盎司 US$4,028.49。免费价格延迟十五分钟。

• Plus 和 Pro 均包含五个内置价格提醒。
• 内置提醒检查实时价格，并向你的 URL 发送带签名的 POST 请求。
• Free 和 Basic 用户可定时查询，并保存上次状态。

创建内置提醒

Plus 和 Pro 均包含五个价格提醒，Free 和 Basic 不包含。先比较套餐价格，再登录并打开账户提醒创建提醒。每个提醒监测一种金属：黄金、白银或铜。

选择一种规则：向上、向下或任一方向越过指定价位；一小时或二十四小时内的百分比变动；或每日收盘价。提醒检查实时价格。每个提醒每小时最多发送一次价位或百分比提醒，或每个 UTC 日发送一次收盘价提醒。

在 Free 或 Basic 上定时查询

Free 和 Basic 用户可每十五分钟运行下方请求，从 /v1/spot/XAU-USD-SPOT 读取每金衡盎司黄金价格。目标价位应使用相同的货币和单位。免密钥请求无需密钥或注册，因此可以不创建账户就开始使用。

按此频率，每小时请求四次，每天九十六次，每月约两千九百次。这个用量符合免密钥请求每个 IP 每分钟十次、每小时一百次的限制，也符合免费密钥每月五千次调用的额度。

curl "https://api.goldprice.dev/v1/spot/XAU-USD-SPOT"

检查投递和签名

内置提醒向你指定的 URL 发送带签名的 POST 请求，请求体为 JSON。请使用 https、端口 443 和公共主机名，不接受私有或本地地址。请求体包含 event、alert_id、kind、symbol、direction、price 和 observed_at。规则字段为 level；percent、window 和 reference_price；或 date 和 close。

Webhook-Signature 请求头的格式为 t=<unix time>,v1=<HMAC SHA-256 of "<t>.<body>" with your signing secret>。创建提醒时请保存签名密钥，它只显示一次。使用收到的原始请求体验证签名，并拒绝超过五分钟的签名。

在提醒页面发送测试请求，检查接收 URL。goldprice.dev 不发送电子邮件或短信。POST 请求会发送到你管理的 URL，例如聊天工具的入站 webhook 或小型服务器。

保存定时查询的上次状态

定时查询时，先读取 is_stale 和 computed_at，再比较价格。免费价格延迟十五分钟。用首次有效读数确定价格高于还是低于目标价位，并保存该状态。

后续有效读数越过目标价位时再通知。向上越过时，状态从低于目标变为达到或高于目标；向下越过时则反向比较。同侧的重复读数不应反复触发提醒。若价格在两次查询之间越过后又返回，轮询可能漏掉这次变动。

按照教程完成设置

价格提醒教程提供脚本，演示如何查询报价、保存上次状态，并向聊天服务的入站 webhook 发送请求。按教程操作，即可将定时请求接入通知。

如果不想编写脚本，可参考定时工作流教程或。无论采用哪种方式，都要检查数据时效、单位是否一致，以及是否保存状态。通知由你选择的工具发送。