黄金行情 API 的代码与价格口径如何确认

核心结论 · 30秒开发速览

“黄金价格”有多种口径：现货黄金（如 XAU/USD，按美元/盎司）、交易所黄金期货、以及国内以人民币/克计价的品种。接入前要确认三件事：接口中的代码代表哪种口径、计价货币与单位，以及报价是成交价还是买卖报价。

常见的黄金价格口径

口径	常见代码	计价方式
国际现货黄金	XAUUSD、GOLD	美元 / 金衡盎司
黄金期货	交易所合约代码	随合约规格，有到期月份
国内黄金品种	交易所合约代码	人民币 / 克

确认代码的步骤

1在供应商的产品列表中搜索黄金相关代码，记录每个代码的说明。

2确认代码对应现货、期货还是差价合约。

3确认计价货币与数量单位。

4请求一次最新报价，与公开参考价比对数量级是否一致。

5在代码映射表中写明口径，避免不同开发者误用。

单位换算示例

美元/盎司换算为人民币/克（仅用于展示参考）python

1TROY_OUNCE_GRAMS = 31.1034768
2
3def usd_oz_to_cny_gram(usd_per_oz: float, usd_cny: float) -> float:
4    return round(usd_per_oz * usd_cny / TROY_OUNCE_GRAMS, 2)
5
6print(usd_oz_to_cny_gram(2400.0, 7.10))  # 547.85

在 AllTick 中的黄金数据

AllTick 将黄金、白银、原油等列在贵金属与商品类别，使用与外汇相同的 quote-b-api 接口。官方文档中的代表产品包括 GOLD、Silver、USOIL，官网行情示例中也展示了 XAU/USD。使用前请在产品列表中确认具体代码与口径。

规范来源与验证记录 · 2026-10-13

已根据下方一手资料核对相关端点、字段与交易所规则。

Python 示例已在 Python 3.14.0 上通过 ast.parse 语法解析；此检查不验证依赖安装、运行兼容性或网络响应。

本轮未使用真实 Token 执行 AllTick 请求，也未完成生产端到端测试。复现时请记录套餐、依赖版本、交易时段、ret/trace 与实际结果。

一手规范与规则

上线前建议复现

确认代码、报价货币和源单位，不默认 GOLD 与 XAUUSD 等价；再进行金衡盎司到克的换算。
换汇时记录商品和外汇时间，拒绝过期或不同步输入；对照 Decimal 精确值与展示舍入值。