黄金行情API怎么选?做黄金ETF工具,光有国际金价够吗?
TickDB Research ·
黄金行情API怎么选?做黄金ETF工具,光有国际金价够吗?
摘要:为黄金ETF页面或持仓工具选择黄金行情API,国际金价只是其中一项输入。本文以518880和XAUUSD的真实返回为例,结合上金所及基金公司资料,拆清ETF成交价、国际金价与基金净值的分工,给出产品数据需求表和可复算的持仓参考金额。
黄金ETF工具的需求看起来很短:展示金价、展示持仓金额,再告诉用户今天涨了多少。
但把这三个功能放进同一个页面时,数据源就不能只按“有没有黄金”来选。国际金价在晚上继续变化,境内ETF的报价可能停在下午;基金公司公布的净值,又是另一项数据。
产品如果只有一个“更新时间”,读者很容易以为三组数字说的是同一时刻、同一件事。
这次我们从518880这只黄金ETF出发,实际查询了ETF和XAUUSD。真正改变选型清单的发现,是同一次请求返回了两个不同的数据时间。
先确认产品买的是什么
上金所的黄金ETF名单将518880列为华安易富黄金交易型开放式证券投资基金,跟踪标的为Au99.99合约收盘价。华安基金产品页列明代码518880、币种CNY,并单独展示单位净值。
这意味着:做这只ETF的持仓工具,必须先拿它自己的份额价格。国际金价可以帮助理解市场背景,却不能直接充当这只基金每份多少钱。
世界黄金协会同样把现货价格、LBMA黄金价格和地区价格分开。名字里都有“黄金”,并不表示它们可以互相替换。
一次返回里,ETF停在下午,黄金/美元已经到了晚上
2026年11月16日,我们用TickDB快照接口一次查询518880.SH,XAUUSD,请求成功,返回两个对象:
| 对象 | 最新价字段原值 | 各自数据时间,北京时间 |
|---|---|---|
| 518880.SH,黄金ETF华安 | 7.852 | 11月16日15:00:01 |
| XAUUSD,黄金/美元 | 3873.51000 | 11月16日23:19:09 |
两条记录的数据时间相差8小时19分08秒。这个结果不适合直接拿来比较谁涨得快,却足以提醒产品设计:晚上查询成功,不会让ETF价格自动变成夜间价格。

图示为本次历史响应的两个数据对象。价格尺度和时间不同,不画成同一刻的收益对照。
请求时间可以记录在系统日志里。给用户看的页面则应把“ETF报价时间”和“国际金价时间”分别放在对应数字旁边。是否已收市、是否处于交易时段,还应结合交易日历和时段判断,不能仅凭时间相差几个小时就认定接口故障。
1000份ETF的参考市值,究竟乘哪个价格
假设持有1000份518880,这只是教学数量。按本次ETF最新价字段计算:
1000份 × 7.852元/份 = 7852元
它是该报价对应的参考市值,没有扣除交易费用,也不是保证能卖出的金额。要展示盈亏,还需要用户的成本及相关费用,不能用当天涨跌幅冒充持仓收益。
用XAUUSD的数值乘1000份,则把国际黄金报价和基金份额混成了同一种单位。即使再换成人民币,这个乘法也不会自动成立:基金份额不是一盎司黄金,份额价格还需要回到基金自身的数据与产品规则。
下面几行可以直接复算本例:
from decimal import Decimal
# 真实ETF快照节选;1000份是教学设定,不是实际持仓。
snapshot = {"symbol": "518880.SH", "last_price": "7.852",
"timestamp": 1794812401000}
shares = Decimal("1000")
amount = shares * Decimal(snapshot["last_price"])
print(snapshot["symbol"], f"参考市值 {amount:.2f} 元")
实际输出:
518880.SH 参考市值 7852.00 元
成交价和净值,也不能只留一个字段
华安基金官网在本次核验时展示11月16日单位净值7.8814。它与接口返回的ETF最新成交价7.852不是同一个数。
这没有必要先被描述成哪家数据错了。一个是份额成交价格字段,一个是基金公司披露的单位净值,各自有用途。若要做盘中溢折价功能,应取得适合该功能的参考净值数据和时间,例如经确认的IOPV来源,再按对应方法计算;不能把晚间公布的日终净值伪装成白天每一刻都已经知道的输入。
按页面功能选数据,比先列供应商更有效
| 页面要帮用户完成什么 | 必需输入 | 黄金/美元报价能否单独完成 |
|---|---|---|
| 看这只ETF多少钱一份 | ETF代码、份额成交价、数据时间 | 不能 |
| 看固定份额的参考市值 | 份额数量、ETF价格与币种 | 不能 |
| 看国际黄金市场背景 | 明确对象及单位的金价、数据时间 | 可作对应市场的参考 |
| 看持仓盈亏 | ETF价格、成本、数量、费用口径 | 不能 |
| 看净值或盘中溢折价 | 合适的NAV/IOPV输入、日期及计算方法 | 不能 |
TickDB在本次任务中的具体作用,是用同一REST快照入口取得A股ETF与黄金/美元的行情输入,保留各自的证券身份和时间戳。页面可以少接一套查询流程,同时仍要分别表达两个对象。这项优势不能被扩大成已经提供基金净值、IOPV或完整基金估值服务。
主任务是A股ETF页面,下一步可从TickDB A股行情API核对行情接入。若产品还要净值、费用和申赎信息,就把这些列成单独需求,不让一个“黄金行情API”包办所有功能。
数据源选型的第一步,可以从页面上一句文案开始:用户看到这串数字后,要判断什么?把这句话说清楚,再决定买哪项数据,开发和产品会更容易在同一张需求表上讨论。
资料:上海黄金交易所《黄金ETF》名单;华安基金518880产品页;世界黄金协会Gold spot prices;TickDB《行情快照》与2026年11月16日原始响应。同日晚间核验,金额使用教学份额,不涉及投资建议。