無料プランには、1時間あたり100リクエスト、5種類の金属のリアルタイム価格と為替レートが含まれます。すべてのリクエストにAPIキーが必要です。
無料プランの内容
制限はアカウントのすべてのキーを合算して数えます。価格を表示するページにgoldApi.devへの見えるリンクがあれば、無料プランでも商用利用できます。
| Free | 制限 |
|---|---|
| 月額 | $0 |
| 1時間あたりのリクエスト | 100 |
| スポット価格 | リアルタイム |
| 金属 | 5 |
| 為替レートと他の通貨 | はい |
| 日次履歴 | いいえ |
| 日次ローソク足 | いいえ |
| 前日終値と日次変動 | いいえ |
| 商用利用 | はい、価格の近くに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 | プランの1時間あたりのリクエストを超えた |
| 401 | api_key_required | リクエストにキーがない |
| 401 | invalid_api_key | キーが無効 |
| 403 | feature_requires_basic | プランにこのエンドポイントが含まれない |
レスポンス
{ "error": "rate_limit_exceeded" }有料プランの制限
有料プランにはより多くのリクエストとデータが含まれます。
Basicプラン
| Basic | 制限 |
|---|---|
| 月額 | $8 |
| 1時間あたりのリクエスト | 2,000 |
| スポット価格 | リアルタイム |
| 金属 | 5 |
| 為替レートと他の通貨 | はい |
| 日次履歴 | はい |
| 日次ローソク足 | いいえ |
| 前日終値と日次変動 | いいえ |
| 商用利用 | はい、リンクは不要です |
Proプラン
| Pro | 制限 |
|---|---|
| 月額 | $15 |
| 1時間あたりのリクエスト | 無制限 |
| スポット価格 | リアルタイム |
| 金属 | 5 |
| 為替レートと他の通貨 | はい |
| 日次履歴 | はい |
| 日次ローソク足 | はい |
| 前日終値と日次変動 | はい |
| 商用利用 | はい、リンクは不要です |
プランの選び方
無料プランはプロトタイプ、社内ダッシュボード、個人サイトに向いています。1時間あたり100を超えるリクエスト、日次履歴、日次ローソク足が必要なら有料プランを選んでください。