MetalAPI 快速入门
注册免费 MetalAPI 账户，获取 API 密钥并发出第一个请求，查询黄金、白银、铂金和钯金的实时价格。几分钟即可完成从注册到收到首个 JSON 响应的全过程。
简介
MetalAPI 是一个 JSON REST API，提供现货贵金属、工业金属、能源、约 55 种货币和 13 种加密货币的价格。它提供实时报价、可追溯至 1999 年的每日历史数据、金额换算、OHLC 数据以及按成色（K 数）划分的黄金价格。
所有端点都是 https://metalapi.com/api/v1 下的普通 HTTPS GET 请求，因此任何编程语言或 HTTP 客户端都能调用。本指南将带您在几分钟内完成从注册到收到第一个响应的全过程。
获取 API 密钥
使用电子邮箱创建免费账户，无需信用卡。Free 套餐每月包含 100 次请求，价格每日更新，足以用来试用 API。
在控制台中打开 API keys 并创建一个密钥。密钥以 mk_live_ 开头，后跟 32 个字符。我们只存储每个密钥的哈希值，因此完整密钥仅显示一次。请立即将其复制到密码管理器或环境变量中。
发出第一个请求
请求四种贵金属以美元计价的最新价格。请将 YOUR_API_KEY 替换为您的密钥：
curl "https://metalapi.com/api/v1/latest?api_key=YOUR_API_KEY&base=USD¤cies=XAU,XAG,XPT,XPD"理解响应
base 是价格的计价货币（默认为 USD）。currencies 用于将响应限定为您需要的品种；省略该参数则在一次响应中返回所有品种。调用成功时返回如下 JSON：
{
"success": true,
"timestamp": 1792713600,
"date": "2026-10-23",
"base": "USD",
"rates": {
"XAU": 0.0002501319446,
"USDXAU": 3997.89,
"XAG": 0.01853911754,
"USDXAG": 53.94,
"XPT": 0.000620212733,
"USDXPT": 1612.35,
"XPD": 0.0006775985906,
"USDXPD": 1475.8
},
"rate_limit": {
"limit": 100,
"remaining": 99,
"reset": 1793491200,
"used": 1,
"plan": "Free",
"reset_date": "2026-11-01T00:00:00.000Z"
}
}每个品种都会出现两次。USDXAU 是 1 金衡盎司黄金以基础货币计的价格，通常就是您要展示的数字。XAU 是它的倒数：1 美元可以买到多少金衡盎司黄金。数据格式指南详细说明了这两种方向。
rate_limit 区块（同时以 X-RateLimit-* 响应头返回）显示本月配额还剩多少以及何时重置。
在代码中调用
下面用 JavaScript（Node.js 18+、Deno 或 Bun）发出同样的请求。这次密钥通过请求头而不是 URL 发送：
const res = await fetch("https://metalapi.com/api/v1/latest?currencies=XAU,XAG", {
headers: { Authorization: `Bearer ${process.env.METALAPI_KEY}` },
});
const data = await res.json();
if (!data.success) throw new Error(`${data.error.code}: ${data.error.info}`);
console.log("Gold, USD per troy ounce:", data.rates.USDXAU);后续步骤
相关指南
准备好开始构建了吗？
创建免费账户获取 API 密钥，或在 API 参考中浏览所有端点。