料金 ガイド

無料プランの制限

APIのプラン表に基づく無料・有料プランの制限

無料プランには、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"
ステータスエラー発生条件
429rate_limit_exceededプランの1時間あたりのリクエストを超えた
401api_key_requiredリクエストにキーがない
401invalid_api_keyキーが無効
403feature_requires_basicプランにこのエンドポイントが含まれない
レスポンス
{ "error": "rate_limit_exceeded" }

有料プランにはより多くのリクエストとデータが含まれます。

Basicプラン

Basic制限
月額$8
1時間あたりのリクエスト2,000
スポット価格リアルタイム
金属5
為替レートと他の通貨はい
日次履歴はい
日次ローソク足いいえ
前日終値と日次変動いいえ
商用利用はい、リンクは不要です

Proプラン

Pro制限
月額$15
1時間あたりのリクエスト無制限
スポット価格リアルタイム
金属5
為替レートと他の通貨はい
日次履歴はい
日次ローソク足はい
前日終値と日次変動はい
商用利用はい、リンクは不要です

プランの選び方

無料プランはプロトタイプ、社内ダッシュボード、個人サイトに向いています。1時間あたり100を超えるリクエスト、日次履歴、日次ローソク足が必要なら有料プランを選んでください。

質問

無料プランのリクエスト制限は?

アカウントのすべてのキーを合算して、1時間あたり100リクエストです。

キーなしでAPIを使えますか?

いいえ。すべてのリクエストで X-API-Key ヘッダーにキーが必要です。無料キーにクレジットカードは不要です。

制限に達するとどんな応答が返りますか?

エラー rate_limit_exceeded と秒単位の Retry-After ヘッダー付きの429です。

制限はいつリセットされますか?

次の時間が始まるときです。正確な時刻は X-RateLimit-Reset ヘッダーでわかります。

無料プランで商用利用できますか?

はい。価格を表示するページにgoldApi.devへの見えるリンクが必要です。有料プランではリンクは不要です。

関連ページ

無料のAPIキーで始める

無料プランで1時間あたり100リクエスト。クレジットカードは不要です。

無料キーを取得