利用可能なエンドポイント

ベースURLと共通パラメーター

すべてのエンドポイントはhttps://metalapi.com/api/v1配下のGETリクエストで、APIキーが必要です（API認証を参照）。ほとんどのエンドポイントで、次の共通オプションパラメーターを使用できます：

• base：価格を表す通貨。デフォルトはUSDで、サポートされている任意のシンボルを指定できます。
• currencies（別名symbols）：返すシンボルのカンマ区切りリスト（例：XAU,XAG,EUR）。省略するとすべてのシンボルが返されます。
• unit：金属価格の質量単位。troy_oz（デフォルト）、gram、kilogram、ounce、pound、metric_ton、short_tonのいずれかです。

日付はYYYY-MM-DD形式で、UTCとして解釈されます。

最新レート：/latest

プランの更新間隔に応じた現在の価格を返します。更新間隔はFreeの毎日1回からEnterpriseの5秒ごとまでです。Standardプラン以上では、currenciesにXAU-BIDやXAU-ASKなどのシンボルを追加すると、Bid価格とAsk価格を取得できます。

GET https://metalapi.com/api/v1/latest?api_key=YOUR_API_KEY&base=USD&currencies=XAU,XAG,EUR

過去レート：/{date}

過去の特定の日の終値を返します。日付をパスに指定する方法、/historical?date=、/yesterdayの3つの形式を利用できます。

GET /api/v1/2026-10-01?api_key=YOUR_API_KEY&currencies=XAU,XAG
GET /api/v1/historical?date=2026-10-01&api_key=YOUR_API_KEY&currencies=XAU,XAG
GET /api/v1/yesterday?api_key=YOUR_API_KEY&currencies=XAU,XAG

換算：/convert

fromのamountをtoに換算します。たとえば米ドルを金のオンス数に、銀をユーロに換算できます。dateを追加すると過去の終値で換算し、unitを追加すると金属をグラムやキログラム単位で換算します。

GET /api/v1/convert?api_key=YOUR_API_KEY&from=USD&to=XAU&amount=1000

# 2026年10月1日の終値で、銀500グラムをユーロに換算
GET /api/v1/convert?api_key=YOUR_API_KEY&from=XAG&to=EUR&amount=500&unit=gram&date=2026-10-01

期間指定：/timeframe

start_dateからend_dateまでの毎日の終値を返します。1回のリクエストで指定できる期間は、Freeプランで最大30日、有料プランで最大365日です。それより長い期間を指定するとエラー207が返されます。/timeseriesは互換性のために残されているエイリアスです。

GET /api/v1/timeframe?api_key=YOUR_API_KEY&start_date=2026-09-01&end_date=2026-09-30&currencies=XAU

変動：/change

2つの日付間における各シンボルの開始レート、終了レート、変動額、変動率を返します。「金は今月3.6%上昇」のような表示に便利です。期間の上限は/timeframeと同じです。

GET /api/v1/change?api_key=YOUR_API_KEY&start_date=2026-09-30&end_date=2026-10-23&currencies=XAU,XAG

OHLC：/ohlc

1日分の始値、高値、安値、終値を返します。dateを省略するかlatestを指定すると、当日のその時点までのバーを取得できます。

GET /api/v1/ohlc?api_key=YOUR_API_KEY&date=2026-10-22&currencies=XAU,XAG

カラット別の金価格：/carat

24Kから8Kまでの宝飾品向け純度の金価格を、任意の通貨と単位で返します。carat=24（デフォルト）、18などの単一のカラット、またはcarat=allを指定します。対応するカラットは24、23、22、21、20、18、16、14、12、10、9、8です。dateを追加すると過去のカラット別価格を取得できます。

このエンドポイントは有料プランで利用できます。Freeプランのキーではエラー106が返されます。

GET /api/v1/carat?api_key=YOUR_API_KEY&carat=all&base=EUR&unit=gram

シンボル：/symbols

サポートされているシンボルとその名称の一覧を返します。details=1を追加すると、各シンボルのカテゴリと単位も含まれます。このエンドポイントは月間クォータにカウントされません。

GET /api/v1/symbols?api_key=YOUR_API_KEY&details=1

利用状況：/usage

当月の請求期間における使用済みリクエスト数と残りのリクエスト数を返します。こちらも無料なので、クォータを消費せずに監視ツールから呼び出せます。

GET /api/v1/usage?api_key=YOUR_API_KEY

リアルタイムストリーム：/stream

価格の更新を発生と同時にプッシュするServer-Sent Eventsストリームです。/latestをポーリングする必要がなくなります。Proプラン以上で利用できます。イベント形式についてはストリーミングのドキュメントをご覧ください。

curl -N "https://metalapi.com/api/v1/stream" \
  -H "Authorization: Bearer YOUR_API_KEY"