Reddit上の金価格APIに関する開発者の質問、一挙回答

Redditで「金価格 API」を検索すると、スレッドの形はほぼ毎回同じだ。ダッシュボード、価格アラート、トレーディングボット、あるいは地金を値付けするオンラインストアを作っている誰かが、コードから取得できるリアルタイムの金価格を求めている。何かを組み込む前に、彼らはr/algotrading、r/webdev、r/golangで、決まって同じ一握りの質問をする。無料プランはあるか、数値はどれくらい新鮮か、制限はどうなっているか、商用利用できるか、そのデータは信頼できるか、という質問だ。

本稿ではgoldprice.devを実例として、これらの質問に直接答えていく。読むだけなら登録は不要で、下に示す最初のAPI呼び出しはキーなしで動く。

goldprice.devとは何か、そして何でないか

これは開発者向けのコモディティ価格APIであり、金・銀・銅をhttps://api.goldprice.devにある単一の認証付きRESTエンドポイントから提供する。すべてのレスポンスには相互検証済みの陳旧度フラグが含まれており、?include=を使えばデータソースごとの価格・タイムスタンプや乖離幅も取得できるので、あるアップストリームが遅れているときにコード側で黙って失敗するのではなく、それを検知できる。MCPサーバーは無料プランを含む全プランに標準で付属している。

これは証券会社でも決済用のフィードでもない。ここで提供される価格は、表示・分析・アラート用に公開される参考値だ。取引を決済するための約定可能なディーリング・クオートが必要なら、公開されている金価格APIのどれも適切なツールではない。それは本APIも例外ではない。

無料プランはあるか?

ある。カードは不要だ。Freeは月5,000回、毎分10リクエストで、金・銀・銅の現物価格を15分遅れで提供する。有料プランではライブ価格、ディーラー価格、より高い上限が加わる。

価格はどれくらいの頻度で更新されるか?

現物価格は利用許諾を得た市場の一次データに基づく。有料プランはライブ価格、Free・匿名呼び出し・本サイトは15分遅れだ。各レスポンスのcomputed_atで更新時刻を確認でき、想定更新期間を過ぎた値にはis_staleが設定される。?include=sourcesでソースごとのタイムスタンプも取得できる。

レート制限はどうなっているか?

毎分の上限はFreeが10、Basicが60、Plusが120、Proが300リクエストだ。すべてのレスポンスに標準のX-RateLimit-Remainingヘッダーが付いてくるので、正しいやり方はそれを読み取り、残数が少なくなったら自ら速度を落とすことであり、闇雲にポーリングして429を食らうことではない。ほとんどのアプリでは、元の値が実際に動く頻度に合わせた短いクライアント側キャッシュを挟むだけで、無料プランの範囲に余裕を持って収まる。

認証はどう行うか?

ベアラートークンによる認証だ。キーにはga_live_という接頭辞が付き、Authorizationヘッダーに入れる。加えて、IPごとに毎分30、毎時100、月1,000リクエストまでという上限付きの匿名アクセス経路も用意されており、価格・タイムスタンプ・陳旧度を返す。bid/askは有料のみの任意項目で、整合した両側の気配値が必要だ。認証すると、始値・高値・安値・前日終値・変化率、そしてデータソース間の乖離フィールドを含む?include=statsが解禁される。なお?include=sourcesと?include=karatは認証の有無にかかわらず利用できる。

この数値がどこから来ているのか確認できるか?

できる。そしてこれこそ、大半のAPIが隠している部分だ。?include=sourcesを付けると、レスポンスにsources[]という配列が含まれ、アップストリームごとに1行、それぞれ独自の価格とタイムスタンプを持つ。データソース間で食い違いがある場合、?include=stats(認証必須)にはdivergence_bpsとdivergence_flagが含まれるので、出所不明な単一の混合値を鵜呑みにするのではなく、自分自身で許容範囲を決められる。誤った価格がコストにつながるようなものを作っているなら、この可視性こそが、ウェブページのスクレイピングではなく構造化されたAPIを使うべき理由だ。

商用利用はできるか?

すべてのプランで商用利用できる。どのプランも出典リンクは不要だ。データ自体の再配布・再販売は別契約となるため、hello@goldprice.devへ連絡してほしい。

LLMエージェントから使えるか?

使える。MCPサーバーは無料プランを含む全プランに含まれている。Claude、Cursor、あるいはMCPに対応した任意のランタイムに設定ブロックを一つ追加するだけで、独自のツールコードを書かなくても、エージェントが直接リアルタイム価格を取得できるようになる。データはREST APIが提供しているものと同一だ。セットアップの詳細を知りたい場合は、MCPの完全な手順ガイドを参照してほしい。

最短の呼び出し

キーも依存関係も不要だ。

curl https://api.goldprice.dev/v1/prices?symbol=XAU-USD-SPOT

価格と陳旧度フラグを含むJSONが15分遅延で返る。bid/askは有料のみの任意項目で、整合した両側の気配値がある場合に返る。カラット別のグラム単価内訳が欲しければ?include=karatを、寄与しているデータソースが欲しければ?include=sourcesを付け加える。完全なレスポンス形式とより高い上限が欲しくなったら、無料キーの取得は1分で終わる。

特定言語向けの実装については、Fetch live gold prices in JavaScriptがREST経路を端から端まで解説しており、Caching gold prices and staying inside rate limitsは大量アクセス時の扱い方をカバーしている。