定价 指南

免费套餐的限制

来自 API 套餐表的免费和付费限制

免费套餐包含每小时 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"
状态错误情况
429rate_limit_exceeded超过套餐的每小时请求数
401api_key_required请求没有密钥
401invalid_api_key密钥无效
403feature_requires_basic套餐不包含此接口
响应
{ "error": "rate_limit_exceeded" }

付费套餐包含更多请求和更多数据。

Basic 套餐

Basic限制
每月价格$8
每小时请求数2,000
现货价格实时
金属5
汇率和其他货币是
每日历史是
每日 OHLC K 线否
前收盘价和每日变化否
商业使用是,无需链接

Pro 套餐

Pro限制
每月价格$15
每小时请求数不限量
现货价格实时
金属5
汇率和其他货币是
每日历史是
每日 OHLC K 线是
前收盘价和每日变化是
商业使用是,无需链接

选择套餐

免费套餐适合原型、内部仪表板和个人网站。如需每小时超过 100 次请求、每日历史或每日 K 线,请选择付费套餐。

问题

免费套餐的请求限制是多少?

每小时 100 次请求,按账户的所有密钥合计。

可以不用密钥使用 API 吗?

不可以。每个请求都需要在 X-API-Key 请求头中提供密钥。免费密钥无需信用卡。

达到限制后会收到什么响应?

429,带有错误 rate_limit_exceeded 和以秒为单位的 Retry-After 响应头。

限制何时重置?

下一个小时开始时。X-RateLimit-Reset 响应头给出确切时间。

免费套餐允许商业使用吗?

允许。显示价格的页面必须包含指向 goldApi.dev 的可见链接。付费套餐不需要链接。

继续阅读

从免费 API 密钥开始

免费套餐每小时 100 次请求。无需信用卡。

获取免费密钥