プラチナ価格API：XPTとXPDのリアルタイム価格と過去価格

APIでプラチナとパラジウムの価格を取得する

プラチナ価格APIは、プラチナの現在価格と過去価格を構造化データとして提供します。通常はHTTPS経由のJSONなので、リサイクル業者の見積もりツール、宝石店の価格表、投資家のポートフォリオ管理ツールで、ウェブサイトから数値をコピーせずに利用できます。プラチナに最も近い金属であるパラジウムも、通常は一緒に提供されます。MetalAPIは、金や銀と同じエンドポイントとレスポンス形式で両方を提供しています。

プラチナとパラジウムは、ロジウム、ルテニウム、イリジウム、オスミウムとともに、6種類の白金族金属（PGM）に属します。MetalAPIが扱うのはプラチナとパラジウムで、他の4つはシンボル一覧に含まれていません。

XPTとXPDは、それぞれの金属1トロイオンスを表すISO 4217コードで、金のXAUと同じ仲間です。リアルタイム価格はスポット価格、つまりインターバンクのBidとAskの気配値の仲値です。Freeを含むすべてのプランで、両方のシンボルを利用できます。

1オンスあたりのプラチナ価格をAPIで取得する

金や銀と同様に、プラチナとパラジウムも卸売市場ではトロイオンス（31.1034768 g）あたりで価格が付けられ、これがAPIのデフォルトの単位です。/latestで両方の金属をリクエストし、比較したい場合は金も加えます。返されるシンボルの数にかかわらず、1回のリクエストのコストは同じです：

curl "https://metalapi.com/api/v1/latest?currencies=XPT,XPD,XAU" \
  -H "X-API-Key: $METALAPI_KEY"

各金属は2回ずつ登場します。USDXPTはプラチナ1トロイオンスの米ドル建て価格で、表示すべき数値です。XPTはその逆数（1ドルあたりのトロイオンス数）で、為替系APIとの互換性のために残されています。以下はドキュメントの例の値で、リアルタイムの価格ではありません：

{
  "success": true,
  "timestamp": 1792713600,
  "date": "2026-10-23",
  "base": "USD",
  "rates": {
    "XPT": 0.000620212733,
    "USDXPT": 1612.35,
    "XPD": 0.0006775985906,
    "USDXPD": 1475.8,
    "XAU": 0.0002501319446,
    "USDXAU": 3997.89
  }
}

別の通貨にするにはbaseを設定します。base=EURではEURXPTとEURXPDが返されます。ドキュメントの例のレートである1ユーロ＝1.1642 USDでは、1トロイオンスあたりプラチナは1,384.94 EUR、パラジウムは1,267.65 EURです。サポートされている57通貨はすべて使え、金属価格と為替レートは常に同じスナップショットから取得されます。

1グラムあたりのプラチナとパラジウムの価格

宝石店やリサイクル業者は通常グラム単位で、産業用の買い手はキログラム単位で扱うことが多くあります。unitはサーバー側で換算を行い、デフォルトのtroy_ozのほかにgram、kilogram、ounce、pound、metric_ton、short_tonを受け付けます：

curl "https://metalapi.com/api/v1/latest?currencies=XPT,XPD&unit=gram" \
  -H "X-API-Key: $METALAPI_KEY"

{
  "success": true,
  "timestamp": 1792713600,
  "date": "2026-10-23",
  "base": "USD",
  "unit": "gram",
  "rates": {
    "XPT": 0.01929077235,
    "USDXPT": 51.83825623,
    "XPD": 0.02107567204,
    "USDXPD": 47.44807179
  }
}

これは、プラチナが1グラムあたり51.84 USD、パラジウムが1グラムあたり47.45 USDで、1キログラムあたりではそれぞれ51,838.26 USDと47,448.07 USDです。unitはリクエスト内のすべての金属に適用されます。ounceは28.35グラムの常衡オンスを意味するため、地金のオンスを使うにはunitを省略するかtroy_ozを指定してください。

プラチナとパラジウムのBid価格とAsk価格

Standardプラン以上では、currenciesに-BIDと-ASKのシンボルを追加すると、仲値と並んで気配値の両側がUSDXPT-BIDやUSDXPT-ASKなどのキーで返されます：

curl "https://metalapi.com/api/v1/latest?currencies=XPT,XPT-BID,XPT-ASK,XPD,XPD-BID,XPD-ASK" \
  -H "X-API-Key: $METALAPI_KEY"

プラチナとパラジウムは金よりも取引量がはるかに少ないため、割合で見たスプレッドは一般に広くなります。買取価格と販売価格を提示する場合は、仲値に固定のマージンを加えるのではなく、実際のBidとAskを基準にしてください。BidとAskは最新の気配値にのみ含まれ、過去データのエンドポイントは仲値を返します。ディーラーがこれらの価格をもとに見積もりを作るしくみは、スポット、Bid、Ask、スプレッドで解説しています。

プラチナとパラジウムの過去価格

両方の金属の日次履歴は2000年まで遡り、どのプランでも全期間を照会できます。過去データの処理には次の4つのエンドポイントを使います：

• /historical、またはパスに日付を指定：1日分の終値。
• /timeframe：期間内の日次終値。1リクエストあたり、Freeでは最大30日、有料プランでは最大365日です。
• /change：2つの日付間の開始価格、終了価格、変動額、変動率。
• /ohlc：1日分の始値、高値、安値、終値。

予算や供給契約では、1日の価格より平均値のほうが役立つことがよくあります。有料プランでは、1回の/timeframeリクエストで最大365日分の日次終値が返されるため、月次や四半期の平均を1回の呼び出しで計算できます。

# 1日分の終値（1グラムあたり）
curl "https://metalapi.com/api/v1/2024-01-15?currencies=XPT,XPD&unit=gram" \
  -H "X-API-Key: $METALAPI_KEY"

# 年初からの変動（30日を超える期間には有料プランが必要）
curl "https://metalapi.com/api/v1/change?currencies=XPT,XPD&start_date=2026-01-02&end_date=2026-10-23" \
  -H "X-API-Key: $METALAPI_KEY"

週末や市場の休日には終値がなく、系列から抜けている場合があるため、暦日ごとに1件のデータがあると想定しないでください。長期の履歴は、期間を1年ずつに分けてループ処理してください。2026年10月より前の金属価格は期近の先物から算出されているため、同じ日のスポット価格とわずかに異なる場合があります。期間指定、OHLCバー、ページングの詳細は過去データガイドで解説しています。

プラチナ・パラジウムと金の比較

金属を比較する最も簡単な方法は価格の比率です。1オンスあたりの価格を別の金属の1オンスあたりの価格で割ります。両方の価格が同じレスポンスから取得されていれば、比率はどの通貨や単位でも同じです。ドキュメントの例の価格では次のようになります：

この価格では、金1オンスでプラチナ約2.48オンスが買え、プラチナの1オンスあたりの価格は金の約40%です。こうした関係は安定していません。APIで取得できる履歴の期間中にも、3つの金属の順位は何度も入れ替わっています。「プラチナは金より安い」といった前提を価格設定のロジックにハードコードせず、系列を取得して確認してください。比率は手軽なデータチェックにもなります。比率が最近の範囲から大きく外れている場合、原因は市場の出来事ではなく、2つの価格の単位や通貨が異なっていることがほとんどです。

次のスクリプトは、Freeプランの期間制限に収まる30日分の日次終値を取得し、取引日ごとに3つの比率を出力します：

const url = new URL("https://metalapi.com/api/v1/timeframe");
url.search = new URLSearchParams({
  currencies: "XAU,XPT,XPD",
  start_date: "2026-09-24",
  end_date: "2026-10-23", // 30日間：Freeプランの期間制限内
});

const res = await fetch(url, { headers: { "X-API-Key": process.env.METALAPI_KEY } });
const data = await res.json();
if (!data.success) throw new Error(`${data.error.code}: ${data.error.info}`);

const ratio = (a, b) => (a / b).toFixed(3);
for (const [date, r] of Object.entries(data.rates)) {
  if (!r.USDXAU || !r.USDXPT || !r.USDXPD) continue; // データが欠けている日はスキップ
  console.log(date, "Au/Pt", ratio(r.USDXAU, r.USDXPT), "Au/Pd", ratio(r.USDXAU, r.USDXPD), "Pt/Pd", ratio(r.USDXPT, r.USDXPD));
}
// 例の価格では：Au/Pt 2.480, Au/Pd 2.709, Pt/Pd 1.093

同じ計算を数年分の/timeframeデータに適用すれば、比率のチャートができます。金銀比価では、同じ考え方を銀に当てはめています。

プラチナ・パラジウム価格APIの利用者

触媒コンバーターのリサイクル業者。 自動車の排ガス触媒はプラチナとパラジウムの主な用途の1つで、使用済みのコンバーターはリサイクルされたPGMの重要な供給源です。コンバーターの価値は、担体に含まれるプラチナ、パラジウム、ロジウムの量によって決まり、その量は車種によって異なります。そのため、リサイクル業者は分析結果に基づき、精錬費や処理費を差し引いた金属価値の一定割合を支払います。価格APIは、この計算のうち金属価格の部分を提供します。MetalAPIはロジウムの価格を提供していないため、計算にロジウムが必要な場合は別の情報源から取得してください：

import os
from decimal import Decimal

import requests

# 1ロットの分析済みPGM含有量（グラム）と、支払う金属価値の割合。
# プレースホルダー：自社の分析結果と精錬契約の条件を使用してください。
LOT_GRAMS = {"XPT": Decimal("120"), "XPD": Decimal("310")}
PAYABLE = Decimal("0.80")

resp = requests.get(
    "https://metalapi.com/api/v1/latest",
    params={"currencies": ",".join(LOT_GRAMS), "unit": "gram", "base": "EUR"},
    headers={"X-API-Key": os.environ["METALAPI_KEY"]},
    timeout=10,
)
data = resp.json(parse_float=Decimal)
if not data["success"]:
    raise RuntimeError(data["error"])

total = Decimal("0")
for symbol, grams in LOT_GRAMS.items():
    price = data["rates"]["EUR" + symbol]  # 1グラムあたりのEUR
    value = grams * price * PAYABLE
    total += value
    print(f"{symbol}: {grams} g x {price:.4f} EUR/g x {PAYABLE} = {value:.2f} EUR")

print(f"Payable Pt + Pd: {total:.2f} EUR at prices of {data['date']} (rhodium priced separately)")

ドキュメントの例の価格とユーロのレートでは、このプレースホルダーのロットは14,382.06 EURになります。数量と支払割合は例示であり、実際の値は分析結果と精錬契約に基づきます。

宝石店。 プラチナのジュエリーは一般に、千分率で950などの高い品位で作られます。パラジウムは単独のジュエリーにも、ホワイトゴールドの合金材料にも使われます。/caratエンドポイントは金専用なので、プラチナは品位に基づいてご自身で価格を計算してください。1グラムあたりの金属価値＝1グラムあたりの価格×品位÷1,000です。例の価格では、Pt950の金属価値は、加工費や税金を除いて1グラムあたり49.25 USDです。

産業用の買い手。 自動車用触媒のほか、プラチナとパラジウムは化学・精製用触媒、ガラス製造、電子機器、歯科用合金、燃料電池にも使われます。調達チームは、期間ごとの変動に/changeを、予算や契約の確認に/timeframeの平均値を使います。有料プランではXPTやXPDを含む任意のシンボルで価格アラートを利用でき、価格が特定の水準を超えると通知されます。Webhookでの通知はAdvancedプランからです。

投資家。 プラチナやパラジウムのコイン、バー、上場投資商品は、同じスポット価格で評価されます。/convert?from=XPT&to=EUR&amount=10なら1回の呼び出しで10トロイオンスを評価でき、baseを使えばポートフォリオを保有者の通貨で表示できます。Proプラン以上では、ポーリングしなくてもリアルタイムストリームが更新をプッシュします。

実践的なヒント

• 金属をまとめてリクエストする。 currencies=XAU,XAG,XPT,XPDなら1リクエストで済みますが、4回に分けると4リクエストかかります。
• プランの更新間隔に合わせてポーリングする。 Freeは毎日、Liteは30分ごと、Standardは10分ごと、AdvancedとProは60秒ごと、UltraとBusinessは15秒ごと、Enterpriseは5秒ごとに更新されます。その間のリクエストは同じスナップショットを返し、それでもカウントされます。
• 市場の取引時間を考慮する。 スポットの貴金属は、ニューヨーク時間の金曜日17:00に取引を終え、日曜日17:00に再開します。週末の間、APIは最後の価格を返し続けます。
• すべての価格とともに文脈を保存する： シンボル、単位、基準通貨、timestamp。単位のない数値は安全に再利用できません。
• キーの存在を確認する。 BidやAskのサイドが利用できない場合、そのキーはゼロになるのではなく、ratesから省かれます。
• 公開の価格ボードにはコード不要。 埋め込みウィジェットを使えば、APIキーを公開せずにウェブサイトにプラチナとパラジウムのリアルタイム価格を表示でき、Freeプランにも1つ含まれています。

プラチナとパラジウムの価格を使い始める

登録して無料のキーを取得し、currencies=XPT,XPDをリクエストすれば、数分で両方の金属の価格を確認できます。Freeプランには、月100リクエスト、毎日の更新、全期間の履歴が含まれます。より新しい価格、Bid/Ask、アラート、ストリーミングが必要になったら、どのプランに何が含まれるかを料金ページで確認できます。シンボルページには、APIが扱うすべての金属、通貨、暗号資産のリアルタイム価格が掲載されています。

よくある質問

プラチナとパラジウムのシンボルは何ですか？

プラチナはXPT、パラジウムはXPDで、それぞれの金属1トロイオンスを表すISO 4217コードです。レスポンスでは、USDXPTとUSDXPDに1トロイオンスあたりの米ドル建て価格が入ります。

1グラムあたりのプラチナ価格を取得できますか？

はい。/latestまたは任意の過去データのエンドポイントにunit=gramを追加してください。例の価格である1トロイオンス1,612.35 USDの場合、1グラムあたり51.84 USDです。kilogramなどの他の単位も同じように使えます。

プラチナとパラジウムの過去データはどこまで遡れますか？

日次の終値は、すべてのプランで2000年まで遡れます。1回の/timeframeリクエストで取得できるのは、Freeでは最大30日、有料プランでは最大365日なので、それより長い期間はループで取得してください。

MetalAPIはロジウムの価格を提供していますか？

いいえ。白金族金属のうち、MetalAPIが提供しているのはプラチナとパラジウムだけです。/api/v1/symbolsエンドポイントは現在のシンボル一覧を返し、クォータにはカウントされません。

Freeプランにプラチナは含まれていますか？

はい。すべてのプランに、すべてのシンボルと全期間の履歴が含まれます。有料プランでは、より新しい更新、1リクエストあたりのより長い期間、金のカラット別価格が追加され、Standard以上ではBid価格とAsk価格も利用できます。