12 篇指南

使用 MetalAPI 进行开发的指南

集成实时与历史金属、货币和加密货币价格所需的一切——从首次请求到 Webhook，再到生产环境最佳实践。

入门

首次请求、身份验证以及套餐限制的工作方式。

注册免费 MetalAPI 账户，获取 API 密钥并发出第一个请求，查询黄金、白银、铂金和钯金的实时价格。几分钟即可完成从注册到收到首个 JSON 响应的全过程。

了解如何通过查询参数或请求头发送 MetalAPI 的 API 密钥，如何将密钥限制为仅供您自己的域名使用，以及在生产环境中妥善保管密钥的最佳做法。

了解 MetalAPI 各套餐的每月请求配额、每分钟速率限制和价格更新间隔如何运作，哪些请求会计费，以及如何通过响应头和 /usage 端点跟踪您的用量。

端点、响应格式、单位和错误代码。

MetalAPI 全部端点及参数说明：latest、historical、convert、timeframe、change、OHLC、carat、symbols、usage 和 stream，每个端点均附有请求示例，便于快速查阅与集成。

MetalAPI 错误代码及其对应的 HTTP 状态码一览，以及如何在代码中处理失败的请求、哪些错误值得重试，如何使用指数退避制定合理的重试策略。

了解 MetalAPI 价格的两种表示方向、如何选择基础货币和质量单位、买卖价与按成色计的金价、时间戳格式以及市场交易时间，正确解析每一个 API 响应。

一页速览 MetalAPI REST API：基础 URL、身份验证、请求参数、响应格式、错误代码、速率限制，以及 Node.js、PHP 和 Python 代码示例，助您快速上手贵金属价格接口。

历史数据分析、Webhook、小组件以及生产环境运行。

使用可嵌入小组件在任意网站上显示实时金属价格，无需编写后端代码，页面中也不会出现 API 密钥。在控制台中完成配置后复制嵌入代码，即可用于 HTML、WordPress 或 Shopify。

当价格突破您设定的阈值时，接收带签名的 HTTP 回调，并使用 HMAC-SHA256 验证签名。本指南介绍提醒条件、负载格式、Node.js 与 PHP 验证代码以及重试机制。

查询可追溯至 1999 年的每日价格，获取日期区间数据，比较两个日期之间的涨跌，获取 OHLC 日线数据，并利用 MetalAPI 历史数据分析黄金等品种的价格趋势。

合理缓存、批量请求多个品种、用实时流代替轮询，并确保 API 密钥和 Webhook 的安全。这些 MetalAPI 集成最佳实践可帮助您节省配额，提升性能与稳定性。

通过 MetalAPI MCP 服务器，将 Claude、ChatGPT、Cursor、VS Code 等 AI 助手连接到实时金属价格。支持登录授权（OAuth）和 API 密钥两种连接方式，几分钟即可完成配置。