2026年黄金话题一直没冷下来。国际金价震荡上行，国内实物黄金价格跟着走，不少做金融科技和电商的同行都在问同一个问题：有没有一个接口能把国内外主要市场的黄金行情一次性拿到，不用挨个对接多个数据源？

探数API的黄金数据查询接口就是针对这个需求设计的。下面从接口能覆盖哪些市场、返回数据长什么样、怎么选合适的子接口、以及在哪些业务场景下能用，逐个说清楚。

🤔 返回数据长什么样

黄金数据查询接口包含7个子接口，各自覆盖不同的交易市场。先看两个最常用的——上海黄金交易所和伦敦金银市场的返回示例。

上海黄金交易所子接口（每1分钟更新）

返回的是一组以品种代码为key的行情对象，每个对象包含最新价、买价、卖价、涨跌值、涨跌幅、今开、最高、最低、昨收、成交量、单位及更新时间：

{
  "code": 1,
  "msg": "操作成功",
  "data": {
    "list": {
      "AuT+D": {
        "type": "AuT+D",
        "typename": "黄金延期",
        "price": "876.00",
        "buyprice": "875.61",
        "sellprice": "877.24",
        "changequantity": "5.28",
        "changepercent": "0.61%",
        "openingprice": "870.50",
        "maxprice": "877.18",
        "minprice": "864.87",
        "lastclosingprice": "871.25",
        "tradeamount": "13050.00",
        "unit": "元/克",
        "updatetime": "2026-07-18 15:05:01"
      },
      "Au9999": {
        "type": "Au9999",
        "typename": "黄金9999",
        "price": "878.00",
        "buyprice": "870.00",
        "sellprice": "878.00",
        "changequantity": "5.52",
        "changepercent": "0.63%",
        "openingprice": "872.00",
        "maxprice": "878.00",
        "minprice": "866.00",
        "lastclosingprice": "872.48",
        "tradeamount": "5988.00",
        "unit": "元/克",
        "updatetime": "2026-07-18 15:05:01"
      },
      "Au100g": {
        "type": "Au100g",
        "typename": "100克金条",
        "price": "875.00",
        "buyprice": "865.00",
        "sellprice": "880.00",
        "changequantity": "2.26",
        "changepercent": "0.26%",
        "openingprice": "870.07",
        "maxprice": "875.00",
        "minprice": "865.75",
        "lastclosingprice": "872.74",
        "tradeamount": "38.00",
        "unit": "元/克",
        "updatetime": "2026-07-18 15:05:01"
      }
    }
  }
}

几个需要注意的点：

• price 是最新成交价，buyprice / sellprice 对应买卖盘报价
• changepercent 用百分比字符串返回（如 "0.61%"），计算时需要去掉百分号
• 周六日闭市期间接口不会报错，而是返回最后一次行情数据——提前知道省时间
• unit 统一为 元/克，不同子接口的单位各不相同，下文会单独说明

伦敦金银市场子接口：返回的是数组结构，覆盖伦敦金、伦敦银、铂金期货和钯金期货：

{
  "code": 1,
  "msg": "操作成功",
  "data": {
    "list": [
      {
        "type": "伦敦金",
        "price": "4016.36",
        "changepercent": "+1%",
        "changequantity": "+40.1",
        "openingprice": "3976.87",
        "maxprice": "4023.62",
        "minprice": "4017.06",
        "lastclosingprice": "3976.26",
        "updatetime": "2026-07-18 15:07:17"
      },
      {
        "type": "伦敦银",
        "price": "55.89",
        "changepercent": "+0.72%",
        "changequantity": "+0.4",
        "openingprice": "55.58",
        "maxprice": "56.18",
        "minprice": "55.96",
        "lastclosingprice": "55.49",
        "updatetime": "2026-07-18 15:07:17"
      }
    ]
  }
}

这个子接口的特点是：

• 单位是 美元/盎司，和国内交易所的 元/克 不一样，做跨市场对比时注意换算
• 数组结构，遍历即可，不需要按key取值
• 铂金和钯金也包含在内，不只是黄金
  

  🤔 黄金数据查询：七个子接口怎么选

整个黄金数据查询产品包含7个子接口，覆盖的市场和更新频率各有不同。用一张表来看：

金店实物黄金这个子接口跟其他的不太一样——它的数据来源是各品牌官网和金融资讯公开收集，更新频率是每1小时（当天数据正常12点前更新完毕），而且各地金价会有差异，仅做参考。如果你做的是黄金回收报价类的业务，建议先联系客服确认数据覆盖情况。

几个选接口的实用建议：

如果你的业务主要在国内，需要上交所和期货的实时数据——选上交所黄金行情和上海期货交易所就够了。前者适合看Au9999、AuT+D这些交易品种的秒级行情，后者适合分析远月合约的价差结构。

如果你做的是跨境业务或者需要国际金价作为基准——伦敦金银市场和国际金价格（现货）这两个可以搭配用。前者偏期货报价，后者是现货买卖价，数据源略有不同。换句话说，国内盘和国际盘的数据都能通过一个产品拿到，不需要分别对接两套系统。

如果你做的是黄金电商或者贵金属回收——金店实物黄金子接口直接返回各品牌的挂牌价，周大福、周生生、中国黄金这些主流品牌都覆盖了，不用自己爬各品牌官网。

📦 接口核心字段解读

不管哪个子接口，核心字段的语义基本一致。逐个说清楚：

changepercent 这个字段处理起来有个小细节——它返回的是带百分号的字符串，不是纯数字。直接拿来做数值计算会报错，建议在业务层先做一次格式化。另外部分品种在闭市或刚开盘时，buyprice 和 sellprice 可能为空字符串，做展示的时候记得做空值判断。

💡 应用场景

黄金交易平台

在线黄金交易平台的核心是报价的实时性和准确性。上交所黄金行情子接口每1分钟更新，AuT+D和Au9999这两个交易量最大的品种都包含在内。用这个接口做行情展示页，用户看到的价格和交易所实际走势是一致的。

金融市场分析

金融数据服务商做黄金板块分析的时候，通常需要同时参考国际金价和国内盘面。伦敦金银市场子接口覆盖伦敦金、伦敦银、铂金和钯金，国际金价格子接口则提供XAU现货的买卖双向报价。把国内上交所数据和伦敦市场数据拼在一起，就能做跨市场价差分析。

电子商务

销售黄金首饰和投资金的电商网站，金价变动直接影响定价。金店实物黄金子接口返回周大福、周生生、六福珠宝等品牌的基础金价，产品页可以根据这些数据做动态调价。注意这个子接口的更新频率是每1小时，不是秒级，适合做日间定价参考，不适合做实时交易。

总结

黄金数据查询API覆盖了国内两大交易所、银行账户黄金、港台市场、主要金店挂牌价以及伦敦和国际现货市场，总共7个子接口。选择的时候主要看你的业务需要哪些市场的数据，以及能接受的更新频率。

国内交易用上交所+期货，跨境业务搭配伦敦+国际现货，黄金电商则可以直接用金店报价子接口。每个子接口的返回结构略有不同（有的是对象、有的是数组），接入前确认一下字段映射关系就行。总的来说，这个接口适合需要快速接入、对黄金数据覆盖广度有要求的B端业务。

📋 常见问题 FAQ

Q1: 黄金数据查询API有免费额度吗？

每个新注册用户都有免费调用额度，具体次数可以在个人中心查看。超出后按调用量计费，不同子接口的计费标准略有差异，详情见定价页面。

Q2: 周六日能获取到黄金行情数据吗？

能。周六日闭市期间接口不会报错，而是自动返回最后一次行情数据。等下一交易日开盘后，数据会恢复正常更新。

Q3: 上交所和上海期货的黄金数据有什么区别？

上交所黄金行情（shgold2）覆盖的是现货延期和现货品种，如Au9999、AuT+D，适合做实时行情展示。上海期货（shfuture）覆盖的是期货合约，包括远月合约（如AU2610、AU2702），适合做套利分析和价差监控。两个接口的更新频率也不同，上交所是每分钟，期货是每5分钟。

Q4: 金店实物黄金数据的准确性如何？

金店数据由金融资讯公开收集，各地金价会有所差异，数据在当天12点前更新完毕。适合做参考和展示，不建议用于精确的交易决策。