貴金属スポット価格 API リファレンス

金、銀、プラチナ、パラジウムのスポット価格と、WTI、ブレント、銅の参照価格を、単位とUTCタイムスタンプ付きで提供します。

認証とリクエスト

APIキーを Authorization ヘッダーに Bearer スキームで指定して送信します。製品概要→

curl "https://api.narwhalapi.com/v1/commodities/spot/XAU/USD" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

操作一覧

エンドポイント	操作
`GET /v1/commodities/spot/{commodity}/{currency}`	スポット価格または先物に基づく参照価格を取得します。
`GET /v1/commodities/spot/{commodity}/{currency}/bars`	金、銀、プラチナ、パラジウム、WTI、BRENTの始値・高値・安値・終値のバーを取得します。銅の履歴はまだ利用できません。

パラメータ

フィールド	意味
`commodity`	パスパラメータ。XAU、XAG、XPT、XPD、WTI（WTI原油）、BRENT（ブレント原油）、XCU（銅）のいずれか。
`currency`	パスパラメータ、大文字。金：USD, AUD, BGN, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TRY、またはZAR。銀、プラチナ、パラジウム、WTI、BRENT、XCU：USDのみ。
`interval`	バーのみ。1m、5m、15m、1h、4h、1d（デフォルト）のいずれか。
`start / end`	バーのみ。間隔の区切りに一致するUTC時刻（4hは00時、04時、08時など、1dは午前0時）。開始時刻を含み、終了時刻は含みません。
`limit / cursor`	バーのみ。デフォルトは100、最大500です。同じクエリでnext_cursorを再利用してください。

気配値のフィールド

フィールド	意味
`symbol, currency, unit`	シンボルと建値通貨。unitは貴金属ではtroy_ounce、WTIとBRENTではbarrel、XCUではpoundです。
`price`	正の参考価格を1つ、十進数の文字列で表します。
`timestamp, stale`	気配値の UTC タイムスタンプと、鮮度を明示するフラグ。
`bars`	バーのみ。確定済みバーを古い順に返します。各バーにはtimestamp（バーの開始時刻）と、小数点以下4桁の文字列で表したopen、high、low、closeが含まれます。USD以外の通貨建ての金はcloseのみです。
`next_cursor`	バーのみ。続きの取得用カーソル。残りのバーがない場合はnullです。

レスポンスの例： GET /v1/commodities/spot/{commodity}/{currency}。

気配値のレスポンス

{
  "symbol": "XAU-USD",
  "price": "2500.00",
  "currency": "USD",
  "unit": "troy_ounce",
  "timestamp": "2026-08-21T12:00:00Z",
  "stale": true
}

データの解釈

WTI、BRENT、XCUは先物市場に基づく参照価格であり、現物貨物のスポット価格ではありません。価格とともに単位とタイムスタンプを表示します。タイムスタンプは、その価格に対応する1分間の開始時刻です。毎日21:00-22:00 UTCの休止時間中はstale: trueが返されます。市場の休場中は気配値が古くなる場合があるため、最新の市場価格として表示しないでください。その他のコモディティまたは通貨の組み合わせは404を返します。価格履歴は金、銀、プラチナ、パラジウム、WTI、BRENTで利用でき、XCUでは利用できません。欠損は補完せず、バーがない箇所はそのままにします。分単位のバーは30日間、時間単位と日単位のバーは無期限に保持します。利用できる履歴はプランの範囲内です。 WTIとBRENTの15分足と時間足の履歴は2020年から利用できます。

エラー形式とクォータ →

MCPツール

commodities_get_spot_pricecommodities_get_price_history

MCP経由で接続 →