ソースごとにそのまま提供
多くの金属APIは、複数のフィードから価格を収集し、加重中央値を計算し、入力データを破棄して、1つの数値を返します。混合の中身は不透明です。取引所間で価格が異なる場合(ロールオーバー、清算、各市場の取引終了の前後に毎日起こります)、APIの数値が実態を反映しているのか、API内部の重み付けを反映しているのか判断できません。
スポット価格は、ライセンスを取得した1つの主ソースから、混合や平均化をせずにそのまま提供します。障害時には、ライセンスを取得したバックアップが金と銀の価格を提供します。銅にはバックアップがありません。?include=sourcesを追加すると、価格を提供したソースと、その価格、fetched_at、source_timestampを確認できます。
GET /v1/prices?symbol=XAU-USD-SPOT&include=sources
{
"symbol": "XAU",
"price": "4803.94",
"is_stale": false,
"computed_at": "2026-05-01T02:34:02Z",
"sources": [
{ "source": "oracle.xau_usd", "display_name": "Live spot", "price": "4803.94", "fetched_at": "...", "source_timestamp": "..." }
]
}取り込むソース
各階層のソースのカテゴリです。各呼び出しで、特定の価格にどのフィードが使われたかを示す証拠は、/v1/pricesのレスポンスに含まれます。
| ソース | 用途 | 階層 |
|---|---|---|
| 主リアルタイムスポットフィード | 金、銀、銅のリアルタイムスポット価格 | 全プラン。Freeは15分遅れ、有料プランはリアルタイム |
| バックアップスポットフィード | 主ソースが利用できない間のみ、金と銀のスポット価格を提供 | 全プラン。Freeは15分遅れ、有料プランはリアルタイム |
| 先物清算値の参照データ(金 + 銀 + 銅) | 日次清算値、先物の連続性、清算値とスポット価格の差 | 旧プランのみ |
| exchangerate.devの為替レート | USD以外の金価格の通貨換算 | 全階層 |
ソース識別子、更新間隔、上流エンドポイントの詳細は内部で文書化され、リリースごとに変わります。法的評価のためにこの詳細が必要な場合は、用途を添えてhello@goldprice.devにメールをお送りください。返信いたします。
通貨ページのUSD以外の価格は、USD建ての金スポット価格に、姉妹通貨APIであるexchangerate.devのリアルタイム為替レートを掛けたものです。USD以外のスポット行では、保存済み為替レートへのフォールバックを使用しません。リアルタイム為替レートが停止すると、/v1/convertと/v1/caratは、保存から3日以内の最新レートを使用します。USD以外のスポット行は古い価格を保持します。
バックアップスポットフィード
スポット価格には、ライセンスを取得した主市場データを使用します。買値と売値は有料プラン限定の任意項目で、整合性のある両側の気配値が必要です。主ソースが停止すると、復旧するまで金と銀はライセンスを取得したバックアップに切り替わります。バックアップ価格は市場から最大で約2分遅れる場合があります。使用中のレスポンスには買値も売値も含まれません。
金属市場の休場中はバックアップを使用しません。休場時間は毎日17:00から18:00、および金曜日17:00から日曜日18:00で、すべてニューヨーク時間です。銅にはバックアップがありません。フィードが停止すると、最後の銅価格に古いデータであることを示す印が付きます。
ソース間の乖離
少なくとも2つの新鮮な主ソースを持つ行には、divergence_bpsが含まれます。これは平均に対する価格差をベーシスポイントで表したものです。スポット行は1つのソースを使用するため、この項目を省略します。GET /v1/prices/divergenceは、全階層で価格差のしきい値を超えるシンボルを一覧表示します。
XAU-USD-SPOTではdivergence_flagはfalseのままです。USD以外の金価格は、USDスポット価格 × exchangerate.devのリアルタイム為替レートで算出します。
LBMAフィックスについて
ソースごとのデータの古さ
価格を提供しているソースが想定される更新期間を過ぎると、最上位のis_staleがtrueになります。?include=sourcesを追加すると、そのソースの価格、fetched_at、source_timestampを確認し、鮮度を自分で評価できます。
将来の見通し:先物カーブ
市場が織り込む将来の価格推移は、/v1/forward-view/{asset}で提供します。以下では計算方法、ソース、更新間隔を説明します。
先物カーブ
今後の金先物5限月です。清算値は、主遅延フィードの系列を通じて約15分遅れで提供し、副フォールバックも使用します。先物の値は公開されている遅延フィードに由来し、ライセンスを取得したリアルタイムデータではありません。破線は5つの清算値の点を結びます。ある限月について主フィードとフォールバックの両方が失敗すると、線に空白が生じます。建玉と出来高はベストエフォート扱いでnullとなり、レスポンスには表示されません。
データの鮮度
先物清算値の更新は平日の20:30 UTCに実行します。年間を通じて同じスケジュールで、EDTでは清算後+2h、ESTでは+1hとなり、夏時間の切り替えによる変更はありません。
提供しないもの
- LBMAフィックス 上記をご覧ください。
- ティック単位のL2注文板 公開するのは価格であり、市場の厚みは公開しません。ティック単位の注文板は、このAPIの対象外です。
- 1秒未満のレイテンシ保証 レイテンシの数値を定めたSLAは公開していません。
- 明示しない価格の混合 このページの主題です。
よくある質問
価格の出所とバックアップの対応範囲について。
主データプロバイダーとバックアップデータプロバイダーは誰ですか?
金、銀、銅には、ライセンスを取得した1つの主市場データプロバイダーを使用します。ライセンスを取得したバックアッププロバイダーが金と銀をカバーします。いずれのプロバイダー名も公開していません。
スポット価格は合成レートですか、それとも1つの提供元の価格ですか?
主プロバイダーの価格を、混合や平均化をせずにそのまま提供します。公式ベンチマークでもLBMAフィックスでもありません。?include=sourcesは、fetched_atとsource_timestampを含むsources[]を返します。
主フィードが停止するとどうなりますか?
主ソースが利用できない間は、ライセンスを取得したバックアップが金と銀の価格を提供します。約2分遅れる場合があり、買値も売値もありません。銅にはバックアップがありません。使用中のソースが想定される更新期間を過ぎると、is_staleがtrueになります。
方法論の変更履歴
| バージョン | 変更 |
|---|---|
| v3.3 | データソース、バックアップの対応範囲、グループのウェブサイトでの利用を更新。現在の有料プランではクレジット表記は不要です。 |
| v3.2 | APIに合わせて文章を修正:Freeの遅延、買値と売値の提供条件、銅スポット、ソースのフィールド。 |
| v3.1 | 金と銀にバックアップスポットフィードを追加。トークン化された金のフォールバックを廃止。 |
| v3.0 | 公開する方法論を、ソースのカテゴリ + 乖離 + データの古さの概念に絞り込み。ソースごとの識別子、更新間隔、集約の詳細を公開ページから移動。 |
| v2.1 | 金属へ転換。XAGオラクルによる銀スポットと、銅先物の清算値を追加。 |
| v2.0 | ソースごとの直接提供へ転換。混合中央値による集約を廃止。リアルタイムスポットオラクル、ECB為替レート、トークン化された金(参考情報)を追加。 |
| v1.0 | 初期の複数ソース集約。階層1の加重中央値(後に置き換え)。 |
方法論の改訂以外のAPIエンドポイント、階層、製品のリリースについては、製品の変更履歴をご覧ください。
誤りに気づいた場合や、検討すべきソースがある場合は、hello@goldprice.devにメールをお送りください。重要な訂正はここで公開します。
APIについて質問がありますか?ドキュメントを読む。