数据格式与单位

每个价格的两种方向

对于您请求的每个品种，rates 中都包含两个数字。以基础货币为 USD 的黄金（XAU）为例：

• USDXAU：1 金衡盎司黄金的美元价格，例如 3997.89。这是应当展示给用户的数字。
• XAU：倒数，即 1 美元可买到的黄金金衡盎司数，例如 0.0002501319446。保留这种格式是为了兼容外汇类 API。

货币遵循同样的规则。基础货币为 USD 时，USDEUR 是 1 欧元的美元价格，EUR 是 1 美元可兑换的欧元数。

{
  "success": true,
  "timestamp": 1792765800,
  "date": "2026-10-23",
  "base": "USD",
  "rates": {
    "XAU": 0.0002501319446,
    "USDXAU": 3997.89,
    "EUR": 0.8589589418,
    "USDEUR": 1.1642
  }
}

选择基础货币

base 决定响应中所有价格的计价货币。默认为 USD，可接受任何支持的品种：EUR、GBP、JPY；如果您想以比特币或黄金计价，甚至可以使用 BTC 或 XAU。交叉汇率基于同一快照计算，因此彼此始终一致。

以下请求返回 EURXAU，即每金衡盎司黄金的欧元价格：

GET /api/v1/latest?api_key=YOUR_API_KEY&base=EUR&currencies=XAU,XAG

质量单位

除非传入 unit，金属价格均以金衡盎司（31.1035 克）计。支持的取值：

• troy_oz（默认）、gram、kilogram、ounce（常衡盎司，28.35 克）、pound、metric_ton 和 short_ton

也接受 g、kg、lb 和 tonne 等简写。注意 oz 表示常衡盎司。如需金银条定价所用的金衡盎司，请使用 troy_oz 或省略 unit。

unit 仅适用于贵金属和工业金属。能源仍按桶、百万英热单位（MMBtu）或加仑计价，货币和加密货币不受影响。使用非默认单位时，响应中会包含 unit 字段。以 GET /api/v1/latest?base=EUR&currencies=XAU,XAG&unit=gram 为例：

{
  "success": true,
  "timestamp": 1792765800,
  "date": "2026-10-23",
  "base": "EUR",
  "unit": "gram",
  "rates": {
    "XAU": 0.009057444725,
    "EURXAU": 110.4064149,
    "XAG": 0.6713138244,
    "EURXAG": 1.489616277
  }
}

工业金属与能源

工业金属（XCU 铜、ALU 铝、ZNC 锌和 HRC 热轧卷板钢）默认与其他金属一样以金衡盎司报价，因此所有金属可以直接比较。如需获取各市场实际交易所用的单位，铜请传入 unit=pound，铝和锌请传入 unit=metric_ton，钢请传入 unit=short_ton。

能源价格按合约单位计：WTI 和 BRENT 按桶，NATURALGAS 按 MMBtu，GASOLINE 和 HEATINGOIL 按加仑。

GET /api/v1/latest?api_key=YOUR_API_KEY&currencies=XCU&unit=pound

支持的品种

• 贵金属：XAU 黄金、XAG 白银、XPT 铂金、XPD 钯金
• 工业金属：XCU 铜、ALU 铝、ZNC 锌、HRC 钢
• 能源：WTI、BRENT、NATURALGAS、GASOLINE、HEATINGOIL
• 货币：约 55 种 ISO 4217 货币，包括 USD、EUR、GBP、JPY、CHF、CAD、AUD、CNY 和 INR
• 加密货币：BTC、ETH、SOL、XRP、BNB、ADA、DOGE、DOT、LINK、LTC、TRX、USDT、USDC

完整的最新列表请参见品种页面，也可通过 /api/v1/symbols 获取。

买入价与卖出价

在 Standard 及以上套餐中，在 currencies 中的品种代码后添加 -BID 或 -ASK，即可在中间价之外同时获取买入价和卖出价。它们适用于来自银行间报价源的品种，即贵金属和主要货币。以 currencies=XAU,XAU-BID,XAU-ASK 为例：

"rates": {
  "XAU": 0.0002501319446,
  "USDXAU": 3997.89,
  "XAU-BID": 0.0002501488386,
  "USDXAU-BID": 3997.62,
  "XAU-ASK": 0.0002501150529,
  "USDXAU-ASK": 3998.16
}

按成色计的金价

/carat 以任意货币和单位返回各种首饰成色的黄金价格，其中纯度 = 成色 ÷ 24。此端点仅限付费套餐使用。以 GET /api/v1/carat?carat=all&unit=gram 为例（有删节）：

{
  "success": true,
  "carat": "all",
  "date": "2026-10-23",
  "base": "USD",
  "timestamp": 1792765800,
  "rates": {
    "XAU24K": { "price": 128.53515, "unit": "gram", "carat": "24", "purity": 1 },
    "XAU22K": { "price": 117.82389, "unit": "gram", "carat": "22", "purity": 0.916667 },
    "XAU18K": { "price": 96.401361, "unit": "gram", "carat": "18", "purity": 0.75 },
    "XAU14K": { "price": 74.978836, "unit": "gram", "carat": "14", "purity": 0.583333 }
  }
}

时间戳与日期

timestamp 是所返回价格的 Unix 时间（以秒为单位，UTC）。date 是以 YYYY-MM-DD 表示的同一天（UTC）。历史响应的时间戳为所请求日期的 00:00 UTC，包含当天的收盘价。

const date = new Date(data.timestamp * 1000);
console.log(date.toISOString()); // 2026-10-23T14:30:00.000Z

精度

价格以 JSON 数字表示，最多 10 位有效数字，足以表示 0.0002501319446 这样的倒数汇率。只在显示数值时取整，不要在用它计算之前取整。

交易时间与周末

现货金属和货币在工作日全天候交易。市场于纽约时间周五 17:00 收盘，周日 17:00 重新开盘。周末期间价格停留在最后一笔报价上，API 会持续返回周五的收盘价（品种页面会显示“已休市”）。

加密货币 24/7 全天交易，周末也会持续更新。工业金属和能源遵循其期货交易所的交易时间。