铂金价格 API：获取实时与历史 XPT 和 XPD 价格

通过 API 获取铂金和钯金价格

铂金价格 API 以结构化数据（通常是通过 HTTPS 传输的 JSON）提供铂金的当前价格和历史价格，让回收商的报价工具、珠宝商的价目表或投资者的投资组合追踪器无需从网站上复制数字即可使用。钯金是与铂金最接近的金属，通常也一并提供。MetalAPI 通过与黄金和白银相同的端点和响应格式为两者报价。

铂金和钯金与铑、钌、铱和锇同属六种铂族金属（PGM）。MetalAPI 提供铂金和钯金的价格；其他四种金属不在其品种列表中。

XPT 和 XPD 是 ISO 4217 中分别代表 1 金衡盎司铂金和钯金的代码，与黄金的 XAU 属于同一系列。实时价格是现货价：银行间买入价与卖出价报价的中间值。所有套餐（包括 Free）都包含这两个品种。

通过 API 获取每盎司铂金价格

与黄金和白银一样，铂金和钯金在批发市场中按金衡盎司（31.1034768 克）计价，这也是 API 的默认单位。从 /latest 请求这两种金属，如需比较还可以加上黄金。无论返回多少个品种，一次请求的消耗都相同：

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

每种金属都会出现两次。USDXPT 是 1 金衡盎司铂金的美元价格，即需要显示的数字；XPT 是其倒数，即每美元可买到的金衡盎司数，保留它是为了兼容外汇类 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 美元的示例汇率，铂金为每金衡盎司 1,384.94 欧元，钯金为每金衡盎司 1,267.65 欧元。57 种受支持的货币均可使用，金属价格和汇率始终来自同一快照。

每克铂金和钯金价格

珠宝商和回收商通常以克为单位，工业买家则常用千克。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
  }
}

即铂金每克 51.84 美元、钯金每克 47.45 美元，或每千克分别为 51,838.26 美元和 47,448.07 美元。unit 适用于请求中的所有金属，而 ounce 表示 28.35 克的常衡盎司，因此如需金银条所用的盎司，请省略 unit 或传入 troy_oz。

铂金和钯金的买入价与卖出价

在 Standard 及以上套餐中，将 -BID 和 -ASK 品种加入 currencies，即可在中间价旁边获得报价的买卖双边价格，键名如 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"

铂金和钯金的交易量远小于黄金，因此按百分比计，它们的价差通常更大。如果您要报出买入价和卖出价，请以真实的买入价和卖出价为基础，而不是在中间价上加一个固定利润。买入价和卖出价仅包含在最新报价中；历史端点返回的是中间价。现货价、买入价、卖出价与价差解释了交易商如何在此基础上形成报价。

铂金和钯金历史价格

两种金属的每日历史数据均可追溯到 2000 年，所有套餐都可以查询全部历史数据。以下四个端点可以满足历史数据方面的需求：

• /historical，或直接以日期作为路径：获取某一天的收盘价。
• /timeframe：获取某个区间的每日收盘价，单次请求最多 30 天（Free）或 365 天（付费套餐）。
• /change：获取两个日期之间的起始价、结束价、绝对变化和百分比变化。
• /ohlc：获取某一天的开盘价、最高价、最低价和收盘价。

对于预算和供货合同，平均价往往比单日价格更有用。在付费套餐中，一次 /timeframe 请求最多返回 365 个每日收盘价，一次调用就足以计算月度或季度平均价。

# 某一天的收盘价，按克计
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"

周末和市场假日没有收盘价，可能不会出现在序列中，因此不要假设每个日历日都有一条记录。对于更长的历史数据，请逐年循环获取。2026 年 10 月之前的金属价格源自近月期货，因此可能与同一天的现货价略有差异。历史数据指南详细介绍了区间、OHLC 数据和分页。

将铂金和钯金与黄金进行比较

价格比值是比较这些金属最简单的方法：用一种金属的每盎司价格除以另一种。当两个价格来自同一个响应时，比值在任何货币和单位下都相同。按文档中的示例价格：

按这些价格，1 盎司黄金约可换取 2.48 盎司铂金，每盎司铂金的价格约为黄金的 40%。这些关系并不稳定：在 API 提供的历史数据中，三种金属的价格排序已经不止一次发生变化。不要把“铂金比黄金便宜”这类假设写死在定价逻辑中，请获取数据序列来查看。比值还是一种低成本的数据校验方式：如果比值远远超出近期范围，通常意味着两个价格使用了不同的单位或货币，而不是发生了市场事件。

下面的脚本获取 30 天的每日收盘价（在 Free 套餐的区间限制之内），并输出每个交易日的三个比值：

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

三元催化器回收商。汽车尾气催化器是铂金和钯金的主要用途之一，废旧催化器则是再生铂族金属的重要来源。催化器的价值取决于其载体所含的铂、钯和铑的数量，而这因车型而异，因此回收商依靠化验结果，并在扣除精炼和处理费用后按金属价值的一定比例付款。价格 API 提供这一计算中的金属价格部分。MetalAPI 不提供铑的报价，如果您的模型需要，请从其他来源获取：

import os
from decimal import Decimal

import requests

# 一批货物经化验的铂族金属含量（克），以及您按金属价值支付的比例。
# 占位数值：请使用您自己的化验结果和精炼合同条款。
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]  # 欧元/克
    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 欧元。其中的数量和支付比例仅为示意；实际数值应来自化验结果和您的精炼合同。

珠宝商。铂金首饰通常采用高成色，例如千分之 950，而钯金既用于制作钯金首饰，也用作白色 K 金的合金金属。/carat 端点仅适用于黄金，因此请自行按成色为铂金定价：每克金属价值 = 每克价格 × 成色 ÷ 1,000。按示例价格，950 铂金每克的金属价值为 49.25 美元，尚未计入加工费和税费。

工业买家。除汽车催化器外，铂金和钯金还用于化工和炼油催化剂、玻璃生产、电子产品、牙科合金和燃料电池。采购团队使用 /change 查看阶段涨跌，使用 /timeframe 计算平均价，用于预算和合同核查。付费套餐提供价格提醒，适用于包括 XPT 和 XPD 在内的任何品种，可在价格突破某一水平时发出提醒；Webhook 推送从 Advanced 套餐起提供。

投资者。铂金和钯金的投资币、金属条和交易所交易产品都根据同一现货价格估值。/convert?from=XPT&to=EUR&amount=10 一次调用即可计算 10 金衡盎司的价值，base 可以将投资组合换算为持有人的货币；从 Pro 套餐起，实时流会主动推送更新，无需您自行轮询。

实用建议

• 合并请求多种金属。currencies=XAU,XAG,XPT,XPD 只算一次请求；分四次调用则算四次。
• 按套餐的更新间隔轮询。Free 每日更新，Lite 每 30 分钟，Standard 每 10 分钟，Advanced 和 Pro 每 60 秒，Ultra 和 Business 每 15 秒，Enterprise 每 5 秒。在两次更新之间发出的请求会返回相同的快照，但仍计入配额。
• 注意市场交易时间。贵金属现货市场在纽约时间周五 17:00 休市，周日 17:00 重新开市。周末期间 API 会持续返回最后的价格。
• 为每个价格存储上下文信息：品种、单位、基础货币和 timestamp。没有单位的数字无法安全地重复使用。
• 检查键是否存在。如果买入价或卖出价不可用，它会从 rates 中省略，而不是被设为零。
• 公开价格看板无需编写代码。可嵌入小组件可以在网站上显示实时铂金和钯金价格，且不会暴露您的 API 密钥；Free 套餐包含一个小组件。

开始使用铂金和钯金价格

注册获取免费密钥，并请求 currencies=XPT,XPD，几分钟内即可看到两种金属的价格。Free 套餐每月包含 100 次请求，价格每日更新，并提供完整的历史数据。当您需要更新鲜的价格、买入价和卖出价、价格提醒或实时流时，定价页面列出了各套餐包含的功能，品种页面则列出了 API 涵盖的所有金属、货币和加密货币的实时价格。

常见问题

铂金和钯金的代码是什么？

铂金为 XPT，钯金为 XPD，即 ISO 4217 中分别代表 1 金衡盎司铂金和钯金的代码。在响应中，USDXPT 和 USDXPD 是以美元/金衡盎司计的价格。

可以获取每克铂金价格吗？

可以。在 /latest 或任何历史端点中加上 unit=gram 即可。按每金衡盎司 1,612.35 美元的示例价格，即每克 51.84 美元。kilogram 和其他单位的用法相同。

铂金和钯金的历史数据可以追溯到多久以前？

所有套餐都提供自 2000 年起的每日收盘价。单次 /timeframe 请求最多覆盖 30 天（Free）或 365 天（付费套餐），更长的区间请循环获取。

MetalAPI 提供铑的价格吗？

不提供。在铂族金属中，MetalAPI 只提供铂金和钯金的报价。/api/v1/symbols 端点返回当前的品种列表，且不计入配额。

Free 套餐包含铂金吗？

包含。所有套餐都包含全部品种和完整的历史数据。付费套餐提供更频繁的更新、更长的单次请求区间和黄金的 K 金价格，从 Standard 起还提供买入价和卖出价。