goldprice.devgoldprice.dev提供黄金、白银和铜价格的REST API。通过/v1/carat查询以CNY计价的不同成色每克金价，或通过/v1/prices获取现货价。Free套餐每月包含5,000次请求，以下请求均可免密钥试用。
API返回哪些数据
所有接口均通过HTTPS返回JSON。下表列出各接口返回的数据及可使用该接口的最低套餐。
| 接口 | 返回数据 | 最低套餐 |
|---|---|---|
/v1/prices | 黄金、白银和铜的现货价 | Free |
/v1/carat | 以CNY计价的不同成色每克金价 | Free |
/v1/convert | 金属、货币与单位之间的换算 | Free |
/v1/bars | 每日OHLC历史数据（Free：最近30天） | Free |
/v1/physical | 按国家提供黄金和白银的经销商价格 | Basic |
发送首次请求
此请求查询以CNY计价的K金价格。使用密钥时，请将其放在Authorization: Bearer请求头中；不带密钥也能发送相同请求，但需遵守免密钥请求限额。
Shell
curl "https://api.goldprice.dev/v1/carat?currency=CNY" \ -H "Authorization: Bearer $GOLDPRICE_API_KEY"JavaScript
const res = await fetch("https://api.goldprice.dev/v1/carat?currency=CNY", { headers: { Authorization: `Bearer ${process.env.GOLDPRICE_API_KEY}` },})const data = await res.json()if (!res.ok) throw new Error(data.error)Python
import os, requestsres = requests.get( "https://api.goldprice.dev/v1/carat?currency=CNY", headers={"Authorization": f"Bearer {os.environ['GOLDPRICE_API_KEY']}"}, timeout=10,)res.raise_for_status()data = res.json()读取响应
price_gram_24k至price_gram_10k各字段表示对应成色黄金以CNY计价的每克价格，以字符串返回，避免精度损失。timestamp为现货价对应的UTC时间。以下示例采集于2026年10月19日，并非当前价格。
响应示例，采集于2026年10月19日
{ "currency": "CNY", "timestamp": "2026-10-19T13:06:01.344423Z", "price_gram_24k": "895.13", "price_gram_22k": "820.53", "price_gram_21k": "783.24", "price_gram_20k": "745.94", "price_gram_18k": "671.35", "price_gram_16k": "596.75", "price_gram_14k": "522.16", "price_gram_10k": "372.97"}套餐对比
所有套餐均包含现货价、K金价格和换算功能。付费套餐提供实时价格，并按套餐级别增加历史数据、经销商价格和流式传输。完整说明见定价页面。
| 套餐 | Free | Basic | Plus | Pro |
|---|---|---|---|---|
| 每月价格（美元） | $0 | $19 | $39 | $89 |
| 每月请求数 | 5,000 | 100,000 | 300,000 | 1,000,000 |
| 每分钟请求数 | 10 | 60 | 120 | 300 |
| 现货价 | 延迟15分钟 | 实时 | 实时 | 实时 |
| 每日历史数据 | 30天 | 1年 | 完整，黄金自1996年起 | 完整，黄金自1996年起 |
| 各国经销商价格 | 不支持 | 支持 | 支持 | 支持 |
| 流式传输 | 不支持 | 不支持 | 支持 | 支持 |
| MCP服务器 | 支持 | 支持 | 支持 | 支持 |
| 商业使用 | 允许，需链接至goldprice.dev | 支持 | 支持 | 支持 |
免密钥试用
/v1/prices、/v1/spot/{symbol}、/v1/carat和/v1/convert均支持免密钥请求，每个IP地址每分钟限10次，每小时限100次，数据与Free套餐相同。超出限额时，API返回429，JSON响应体会说明触发了哪项限额。
接下来
在文档中查看所有接口及参数，然后获取免费密钥，使用自己的请求配额。