黄金行情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.85211月16日15:00:01
XAUUSD,黄金/美元3873.5100011月16日23:19:09

两条记录的数据时间相差8小时19分08秒。这个结果不适合直接拿来比较谁涨得快,却足以提醒产品设计:晚上查询成功,不会让ETF价格自动变成夜间价格。

黄金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日原始响应。同日晚间核验,金额使用教学份额,不涉及投资建议。

相关文章

港股行情API怎么选?本地脚本搬上服务器,还要比较什么?

个人港股脚本搬到团队服务器,选行情API要比较的不只是价格。本文对照富途OpenD官方运行条件和一次腾讯控股真实快照,把网关、登录、行情权限、数据时间与团队使用需求拆开,给出可直接交给开发和数据供应商的试用清单。

TickDB Research ·

AI盯盘怎么用?自选股涨超3%,收到提醒后先看什么?

自己维护股票监控的量化投资者与投研成员,常常遇到同一只股票反复触发提醒,却不知道这次该看什么。本文通过TickDB股票行情API,取得2026年11月12日寒武纪、海光信息的真实分钟行情,重放两种提醒方式,并结合公司资讯梳理后续核查顺序:先看这次新增了什么变化,再看价格处在什么位置,接着查有没有值得更新原判断的信息。附可复制监控任务卡与重放代码,方便换成自己的自选股。

TickDB Research ·