免费套餐包含每小时 100 次请求、5 种金属的实时价格和汇率。每个请求都需要 API 密钥。
免费套餐包含
限制按账户的所有密钥合计。如果显示价格的页面包含指向 goldApi.dev 的可见链接,免费套餐允许商业使用。
| Free | 限制 |
|---|---|
| 每月价格 | $0 |
| 每小时请求数 | 100 |
| 现货价格 | 实时 |
| 金属 | 5 |
| 汇率和其他货币 | 是 |
| 每日历史 | 否 |
| 每日 OHLC K 线 | 否 |
| 前收盘价和每日变化 | 否 |
| 商业使用 | 是,需在价格旁放置指向 goldApi.dev 的可见链接 |
达到限制时
使用响应头 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset,在达到限制前放慢请求。超过限制时,API 返回 429、简短的 JSON 和以秒为单位的 Retry-After 响应头。下一个小时开始后请求恢复正常。
Shell
curl -i "https://goldapi.dev/api/v1/price/XAU/USD" \ -H "X-API-Key: $API_KEY"| 状态 | 错误 | 情况 |
|---|---|---|
| 429 | rate_limit_exceeded | 超过套餐的每小时请求数 |
| 401 | api_key_required | 请求没有密钥 |
| 401 | invalid_api_key | 密钥无效 |
| 403 | feature_requires_basic | 套餐不包含此接口 |
响应
{ "error": "rate_limit_exceeded" }付费套餐的限制
付费套餐包含更多请求和更多数据。
Basic 套餐
| Basic | 限制 |
|---|---|
| 每月价格 | $8 |
| 每小时请求数 | 2,000 |
| 现货价格 | 实时 |
| 金属 | 5 |
| 汇率和其他货币 | 是 |
| 每日历史 | 是 |
| 每日 OHLC K 线 | 否 |
| 前收盘价和每日变化 | 否 |
| 商业使用 | 是,无需链接 |
Pro 套餐
| Pro | 限制 |
|---|---|
| 每月价格 | $15 |
| 每小时请求数 | 不限量 |
| 现货价格 | 实时 |
| 金属 | 5 |
| 汇率和其他货币 | 是 |
| 每日历史 | 是 |
| 每日 OHLC K 线 | 是 |
| 前收盘价和每日变化 | 是 |
| 商业使用 | 是,无需链接 |
选择套餐
免费套餐适合原型、内部仪表板和个人网站。如需每小时超过 100 次请求、每日历史或每日 K 线,请选择付费套餐。