goldprice.devgoldprice.devは、金・銀・銅の価格を取得できるREST APIです。/v1/caratでJPY建ての品位別グラム価格を、/v1/pricesでスポット価格を取得できます。Freeには月5,000回のリクエストが含まれ、以下のリクエストはすべてキーなしで試せます。
取得できるデータ
すべてのエンドポイントがHTTPS経由でJSONを返します。下の表で、取得できるデータと利用可能になるプランを確認できます。
| エンドポイント | 取得できるデータ | 利用可能なプラン |
|---|---|---|
/v1/prices | 金・銀・銅のスポット価格 | Free |
/v1/carat | JPY建ての品位別グラム価格 | Free |
/v1/convert | 金属・通貨・単位間の換算 | Free |
/v1/bars | 日次OHLC履歴（Freeは直近30日分） | Free |
/v1/physical | 国別の金・銀の販売店価格 | Basic |
最初のリクエスト
このリクエストで、JPY建ての品位別価格を取得します。キーはAuthorization: Bearerヘッダーに指定してください。キーなしでも、キー不要のリクエスト上限内で同じリクエストを実行できます。
Shell
curl "https://api.goldprice.dev/v1/carat?currency=JPY" \ -H "Authorization: Bearer $GOLDPRICE_API_KEY"JavaScript
const res = await fetch("https://api.goldprice.dev/v1/carat?currency=JPY", { 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=JPY", headers={"Authorization": f"Bearer {os.environ['GOLDPRICE_API_KEY']}"}, timeout=10,)res.raise_for_status()data = res.json()レスポンスの見方
price_gram_24kからprice_gram_10kの各フィールドは、該当する品位の金のグラム価格をJPY建てで示します。精度を保つため、値は文字列です。timestampはスポット価格の時刻をUTCで示します。以下は2026年10月19日に取得した例で、現在の価格ではありません。
レスポンス例、2026年10月19日取得
{ "currency": "JPY", "timestamp": "2026-10-19T13:42:01.29429Z", "price_gram_24k": "21164", "price_gram_22k": "19400", "price_gram_21k": "18518", "price_gram_20k": "17637", "price_gram_18k": "15873", "price_gram_16k": "14109", "price_gram_14k": "12346", "price_gram_10k": "8818"}プランを比較
すべてのプランで、スポット価格、品位別価格、換算を利用できます。有料プランではリアルタイム価格に加え、プランに応じて履歴、販売店価格、ストリーミングが利用できます。詳細は料金ページをご覧ください。
| プラン | 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のレスポンスボディに該当する上限を示します。
次のステップ
ドキュメントで各エンドポイントとパラメーターを確認し、無料キーを取得して自分の利用枠で使い始めましょう。