菜单

快速开始

几分钟内获取 XAU/USD 实时价格。

开始之前

你需要 curl 或任意 HTTP 客户端,以及一个免费 API 密钥。注册并确认邮箱,然后从账户复制密钥。免费套餐包含每小时 100 次请求。

获取免费密钥

第一个请求

在 X-API-Key 请求头中发送密钥。请把密钥放在服务器上,不要放在访客能看到的代码里。

curl --fail-with-body --max-time 10 "https://goldapi.dev/api/v1/price/XAU/USD" \  -H "X-API-Key: $API_KEY"

读取响应

price 是响应中单位的价格:金衡盎司,铜为磅。gram 是响应中 K 数对应的每克价格,updatedAt 是生成响应的时间。

响应 200

{
    "symbol": "XAU",
    "name": "Gold",
    "currency": "USD",
    "unit": "oz",
    "price": 4072.1,
    "gram": 130.921,
    "karat": 24,
    "updatedAt": "2026-11-07T02:43:29+02:00"
}

出错时

错误是带 error 字段的 JSON。常见的有缺少请求头时的 401 api_key_required、密钥错误时的 401 invalid_api_key,以及确认邮箱前的 403 email_not_verified。超过限制会收到带 Retry-After 响应头的 429 rate_limit_exceeded。

下一步