博客/开发者

用 Python 获取每克黄金价格（24K、22K、18K）

无需 API 密钥，用 Python 获取 24K、22K 和 18K 每克黄金价格，并通过 Decimal 安全计算金额。

开发者2026年9月22日

语言:

中文

如果应用需要每克黄金价格，可直接请求公开的 /v1/carat 端点。一次请求会按所选货币返回 24K、22K、21K、20K、18K、16K、14K 和 10K 的金属价值，试用无需 API 密钥。

用 Python 获取每克黄金价格

下面只使用 Python 标准库，并将价格读为 Decimal，避免货币计算中的二进制浮点误差。

import json
from decimal import Decimal
from urllib.parse import urlencode
from urllib.request import Request, urlopen

url = "https://api.goldprice.dev/v1/carat?" + urlencode({"currency": "USD"})
with urlopen(Request(url, headers={"Accept": "application/json"}), timeout=10) as response:
    payload = json.load(response)

prices = {
    "currency": payload["currency"],
    "timestamp": payload["timestamp"],
    "24k": Decimal(payload["price_gram_24k"]),
    "22k": Decimal(payload["price_gram_22k"]),
    "18k": Decimal(payload["price_gram_18k"]),
}

可将 USD 换成 EUR、GBP、INR、IDR、AED、JPY 等支持的货币。请同时保存表示价格观测时间的 timestamp。

计算金饰的金属价值

对于 12.5 克的 18K 金饰，用 18K 每克价格乘以重量，并只在最终金额上舍入一次。

from decimal import Decimal, ROUND_HALF_UP

weight = Decimal("12.5")
value = (weight * prices["18k"]).quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)

端点已按请求货币的最小单位精度返回每克值。结果只是黄金含量的指示性价值，并非零售价或回购价。加工费、宝石、税费、溢价、精炼费和回购折扣需另行计算。