黄金数据查询API接口文档 GET / POST 金融数据

黄金数据查询API提供上海黄金交易所所有黄金品种的实时行情数据。数据每分钟更新一次，周六日闭市期间返回最后一次行情数据。

请求 GET / POST返回 application/json0.1 积分 / 次上线 2026-09-24 14:57:41

黄金数据查询API提供上海黄金交易所所有黄金品种的实时行情数据。数据每分钟更新一次，周六日闭市期间返回最后一次行情数据。

0.1 积分 / 次调用次数: 3正常运行KEY 必填
接口信息
GET / POST api.souxiaocha.com/apis/gateway?api=gold
方法
GET / POST
分类
金融数据
计费
0.1 积分 / 次
KEY
KEY 必填
调用
3
QPM
不限制
鉴权
Query 参数、Header(X-API-Key)
作者
—

黄金数据查询接口信息

接口地址：
https://api.souxiaocha.com/apis/gateway?api=gold
请求方式：
GET / POST
返回格式：
application/json

调用统计

3总调用次数
请求示例 · GET
GET https://api.souxiaocha.com/apis/gateway?api=gold

apikey=你的API密钥

GET 参数放在查询字符串中。参数值请替换为实际有效值。

返回示例
{"success":true,"data":{"list":{"AuT+D":{"type":"AuT+D","typename":"黄金延期","price":"881.80","buyprice":"881.50","sellprice":"881.90","changequantity":"-0.69","changepercent":"-0.08%","openingprice":"878.40","maxprice":"882.34","minprice":"874.93","lastclosingprice":"882.78","tradeamount":"25032.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"mAuT+D":{"type":"mAuT+D","typename":"M黄金延期","price":"881.02","buyprice":"881.02","sellprice":"882.00","changequantity":"-1.84","changepercent":"-0.21%","openingprice":"878.50","maxprice":"882.30","minprice":"875.10","lastclosingprice":"882.89","tradeamount":"55686.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"Au9999":{"type":"Au9999","typename":"黄金9999","price":"882.00","buyprice":"881.50","sellprice":"881.70","changequantity":"-1.28","changepercent":"-0.14%","openingprice":"877.00","maxprice":"885.00","minprice":"875.03","lastclosingprice":"883.28","tradeamount":"532164.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"Au9995":{"type":"Au9995","typename":"黄金9995","price":"881.50","buyprice":"880.00","sellprice":"884.00","changequantity":"1.54","changepercent":"0.18%","openingprice":"878.00","maxprice":"881.50","minprice":"878.00","lastclosingprice":"879.96","tradeamount":"4.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"Au100g":{"type":"Au100g","typename":"100克金条","price":"882.70","buyprice":"882.50","sellprice":"886.50","changequantity":"-0.77","changepercent":"-0.09%","openingprice":"883.20","maxprice":"883.20","minprice":"877.00","lastclosingprice":"883.47","tradeamount":"168.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"AuT+N1":{"type":"AuT+N1","typename":"黄金单月延期","price":"1096.70","buyprice":"","sellprice":"","changequantity":"134.70","changepercent":"14.00%","openingprice":"","maxprice":"","minprice":"","lastclosingprice":"1096.70","tradeamount":"2.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"AuT+N2":{"type":"AuT+N2","typename":"黄金双月延期","price":"1050.00","buyprice":"","sellprice":"1050.00","changequantity":"25.00","changepercent":"2.44%","openingprice":"","maxprice":"","minprice":"","lastclosingprice":"1050.00","tradeamount":"2.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"SGiAu100g":{"type":"SGiAu100g","typename":"i黄金100g","price":"782.00","buyprice":"775.00","sellprice":"","changequantity":"24.19","changepercent":"3.19%","openingprice":"","maxprice":"","minprice":"","lastclosingprice":"782.00","tradeamount":"10.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"SGiAu9999":{"type":"SGiAu9999","typename":"i黄金9999","price":"880.60","buyprice":"880.16","sellprice":"880.96","changequantity":"-1.32","changepercent":"-0.15%","openingprice":"877.64","maxprice":"880.78","minprice":"873.97","lastclosingprice":"881.92","tradeamount":"96940.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"PT9995":{"type":"PT9995","typename":"铂金9995","price":"400.82","buyprice":"395.00","sellprice":"402.60","changequantity":"-1.50","changepercent":"-0.37%","openingprice":"401.86","maxprice":"401.86","minprice":"400.82","lastclosingprice":"402.32","tradeamount":"6.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"}},"update_time":"2026-07-29 17:18:01","count":10},"generated_at":"2026-07-29 17:18:17"}

详细文档

黄金数据查询 API 接口文档

接口描述

黄金数据查询API提供上海黄金交易所所有黄金品种的实时行情数据。数据每分钟更新一次，周六日闭市期间返回最后一次行情数据。

功能特性

  • 黄金数据查询API提供上海黄金交易所所有黄金品种的实时行情数据。数据每分钟更新一次，周六日闭市期间返回最后一次行情数据。
  • 返回 JSON 结构化数据，便于程序解析
  • 支持 GET / POST 两种调用方式
  • 平台统一密钥鉴权与调用统计，支持积分计费

接口地址

https://api.souxiaocha.com/apis/gateway?api=gold

请求方式

GET / POST（业务参数 GET 通过 URL 传递，POST 支持表单或 JSON）

鉴权方式

调用需携带平台密钥（用户中心「令牌管理」获取，SK- 开头）：

  • URL 参数：key=SK-你的密钥
  • 或请求头：X-API-Key: SK-你的密钥

请求参数

本接口无需业务参数，直接调用即可。

响应格式

JSON 格式响应

成功返回示例：

{"success":true,"data":{"list":{"AuT+D":{"type":"AuT+D","typename":"黄金延期","price":"881.80","buyprice":"881.50","sellprice":"881.90","changequantity":"-0.69","changepercent":"-0.08%","openingprice":"878.40","maxprice":"882.34","minprice":"874.93","lastclosingprice":"882.78","tradeamount":"25032.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"mAuT+D":{"type":"mAuT+D","typename":"M黄金延期","price":"881.02","buyprice":"881.02","sellprice":"882.00","changequantity":"-1.84","changepercent":"-0.21%","openingprice":"878.50","maxprice":"882.30","minprice":"875.10","lastclosingprice":"882.89","tradeamount":"55686.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"Au9999":{"type":"Au9999","typename":"黄金9999","price":"882.00","buyprice":"881.50","sellprice":"881.70","changequantity":"-1.28","changepercent":"-0.14%","openingprice":"877.00","maxprice":"885.00","minprice":"875.03","lastclosingprice":"883.28","tradeamount":"532164.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"Au9995":{"type":"Au9995","typename":"黄金9995","price":"881.50","buyprice":"880.00","sellprice":"884.00","changequantity":"1.54","changepercent":"0.18%","openingprice":"878.00","maxprice":"881.50","minprice":"878.00","lastclosingprice":"879.96","tradeamount":"4.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"Au100g":{"type":"Au100g","typename":"100克金条","price":"882.70","buyprice":"882.50","sellprice":"886.50","changequantity":"-0.77","changepercent":"-0.09%","openingprice":"883.20","maxprice":"883.20","minprice":"877.00","lastclosingprice":"883.47","tradeamount":"168.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"AuT+N1":{"type":"AuT+N1","typename":"黄金单月延期","price":"1096.70","buyprice":"","sellprice":"","changequantity":"134.70","changepercent":"14.00%","openingprice":"","maxprice":"","minprice":"","lastclosingprice":"1096.70","tradeamount":"2.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"AuT+N2":{"type":"AuT+N2","typename":"黄金双月延期","price":"1050.00","buyprice":"","sellprice":"1050.00","changequantity":"25.00","changepercent":"2.44%","openingprice":"","maxprice":"","minprice":"","lastclosingprice":"1050.00","tradeamount":"2.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"SGiAu100g":{"type":"SGiAu100g","typename":"i黄金100g","price":"782.00","buyprice":"775.00","sellprice":"","changequantity":"24.19","changepercent":"3.19%","openingprice":"","maxprice":"","minprice":"","lastclosingprice":"782.00","tradeamount":"10.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"SGiAu9999":{"type":"SGiAu9999","typename":"i黄金9999","price":"880.60","buyprice":"880.16","sellprice":"880.96","changequantity":"-1.32","changepercent":"-0.15%","openingprice":"877.64","maxprice":"880.78","minprice":"873.97","lastclosingprice":"881.92","tradeamount":"96940.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"PT9995":{"type":"PT9995","typename":"铂金9995","price":"400.82","buyprice":"395.00","sellprice":"402.60","changequantity":"-1.50","changepercent":"-0.37%","openingprice":"401.86","maxprice":"401.86","minprice":"400.82","lastclosingprice":"402.32","tradeamount":"6.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"}},"update_time":"2026-07-29 17:18:01","count":10},"generated_at":"2026-07-29 17:18:17"}

失败返回示例：

HTTP/1.1 401 Unauthorized

{
  "success": false,
  "error": "invalid_api_key",
  "message": "认证失败，请提供有效的API密钥"
}

返回参数说明

参数名 类型 说明
success boolean 请求是否成功
data.list object 各品种行情数据，key为品种代码
data.update_time string 数据更新时间（取Au9999品种）
data.count integer 品种总数
generated_at string 接口响应时间
type string 品种代码
typename string 品种中文名称
price string 最新价
buyprice string 买入价
sellprice string 卖出价
changequantity string 涨跌额
changepercent string 涨跌幅
openingprice string 开盘价
maxprice string 最高价
minprice string 最低价
lastclosingprice string 昨收价
tradeamount string 总成交量（kg）
unit string 单位（元/克）
updatetime string 更新时间

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=gold?key=SK-你的密钥"

错误响应

上游业务级错误：

code msg 描述
401 invalid_api_key API密钥无效或未提供
405 method_not_allowed 使用了GET以外的方法
500 config_error 服务配置异常
500 api_request_failed 第三方接口请求异常
500 api_parse_failed 第三方接口响应解析失败
500 query_failed 黄金数据查询失败

平台级错误（errcode）：11001 缺少密钥 / 11002 密钥无效或已禁用 / 11005 接口禁用 / 11006 接口维护 / 11010 积分不足 / 11018 请求方式不允许。

失败时请以响应体中的 code / errcode 与 msg 判断。

注意事项

  • 本接口为平台代理的聚合数据服务，数据与稳定性以上游服务为准
  • 涉及命理、测算类内容（如有）仅供娱乐参考，不构成任何现实建议
  • 请合理控制调用频率，避免高频恶意调用触发风控
  • 密钥请妥善保管，勿在公开代码或前端页面中暴露

开发时间

2026-09-24