黄金价格查询

goldGET

GEThttps://v1.apizero.cn/api/gold

概述

实时黄金价格聚合查询，一次返回三大维度： • 国际贵金属（4 项）：国际金价、国际铂金、国际银价、国际钯金，含最新价 / 涨跌额 / 涨跌幅 / 最高价 / 最低价 / 报价时间 • 国内金价（4 项）：国内金价（黄金延期）、投资金条、黄金回收价格、国内银价 • 品牌金店牌价：内地/香港周大福、周生生、六福珠宝、老凤祥等门店当日牌价参数 type：all=全部（默认）/ international=国际 / domestic=国内 / brand=品牌金店国际/国内来自官网实时 jin.js，约 2 分钟缓存；品牌金店来自页面牌价（按日更新）。实时价以接口返回的 update_time / quote_time 为准。

调用约定

网关 · https://v1.apizero.cn
鉴权 · Authorization: Bearer <API Key>
回包 · JSON {code, msg, data}。成功看 code === 0，不要只看 HTTP 200。

/aidocs/gold/raw.md

打开 Markdown

鉴权

匿名每日 50 次、QPS 2；登录用户每日 200 次、QPS 5（全部免费）。已内建 10 分钟缓存。

获取 API Key：获取 API Key/account/keys

请求头

Authorizationstring选填

推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

Header	类型	必填	说明
Authorization	string	否	推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

全部行情（推荐）

GETURL QUERY·APPLICATION/JSON

一次返回国际贵金属 + 国内金价 + 品牌金店。国际/国内来自官网实时 jin.js（约 2 分钟缓存），品牌金店来自页面牌价（按日更新）。文档示例为真实抓取（已截断），实时价以接口为准。

https://v1.apizero.cn/api/gold?type=all

type（类型）string选填

固定 all

例all

参数	类型	必填	说明	示例
type（类型）	string	否	固定 all	all

返回结果

update_timestring

服务端抓取时间

quote_timestring

行情时钟（来自 jin.js）

internationalarray

国际金/铂/银/钯

namestring

名称

pricestring

价格

changestring

涨跌额

percentstring

涨跌幅

highstring

最高

lowstring

最低

timestring

时间

domesticarray

国内金价/投资金条/回收/银价

namestring

名称

pricestring

价格

changestring

涨跌额

percentstring

涨跌幅

highstring

最高

lowstring

最低

timestring

时间

brandarray

品牌金店牌价

brandstring

brand

gold_pricestring

gold_price

pt_pricestring

pt_price

bar_pricestring

bar_price

unitstring

unit

timestring

时间

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

字段

类型

说明

update_time

string

服务端抓取时间

quote_time

string

行情时钟（来自 jin.js）

international

array

国际金/铂/银/钯

name	string	名称
price	string	价格
change	string	涨跌额
percent	string	涨跌幅
high	string	最高
low	string	最低
time	string	时间

domestic

array

国内金价/投资金条/回收/银价

name	string	名称
price	string	价格
change	string	涨跌额
percent	string	涨跌幅
high	string	最高
low	string	最低
time	string	时间

brand

array

品牌金店牌价

brand	string	brand
gold_price	string	gold_price
pt_price	string	pt_price
bar_price	string	bar_price
unit	string	unit
time	string	时间

tips

string

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "update_time": "2026-08-19 10:54:54",
    "source": "huangjinjiage.cn / jin.js",
    "type": "all",
    "quote_time": "10:54:00",
    "international": [
      {
        "name": "国际金价",
        "price": "4353.85",
        "change": "19.68",
        "percent": "0.45%",
        "high": "4361.86",
        "low": "4324.66",
        "time": "2026-08-19 10:54:00"
      },
      {
        "name": "国际铂金",
        "price": "1729.22",
        "change": "-4.58",
        "percent": "-0.26%",
        "high": "1733.90",
        "low": "1712.00",
        "time": "2026-08-19 10:54:26"
      }
    ],
    "domestic": [
      {
        "name": "国内金价",
        "price": "944.70",
        "change": "-10.30",
        "percent": "-1.08%",
        "high": "955.00",
        "low": "939.00",
        "time": "2026-08-19 10:54:48"
      },
      {
        "name": "投资金条",
        "price": "960.70",
        "change": "-10.30",
        "percent": "-1.06%",
        "high": "971.00",
        "low": "955.00",
        "time": "2026-08-19 10:54:48"
      },
      {
        "name": "黄金回收价格",
        "price": "929.70",
        "change": "-10.30",
        "percent": "-1.10%",
        "high": "940.00",
        "low": "924.00",
        "time": "2026-08-19 10:54:48"
      }
    ],
    "brand": [
      {
        "brand": "内地周大福",
        "gold_price": "1339",
        "pt_price": "-",
        "bar_price": "1175",
        "unit": "元/克",
        "time": "2026-08-19"
      },
      {
        "brand": "内地周生生",
        "gold_price": "1338",
        "pt_price": "689",
        "bar_price": "1175",
        "unit": "元/克",
        "time": "2026-08-19"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

国际贵金属

GETURL QUERY·APPLICATION/JSON

仅国际金/铂/银/钯（jin.js 实时）。

https://v1.apizero.cn/api/gold?type=international

type（类型）string必填

固定 international

例international

参数	类型	必填	说明	示例
type（类型）	string	是	固定 international	international

返回结果

internationalarray

国际行情列表

namestring

名称

pricestring

价格

changestring

涨跌额

percentstring

涨跌幅

highstring

最高

lowstring

最低

timestring

时间

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

字段

类型

说明

international

array

国际行情列表

name	string	名称
price	string	价格
change	string	涨跌额
percent	string	涨跌幅
high	string	最高
low	string	最低
time	string	时间

tips

string

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "update_time": "2026-08-19 10:54:54",
    "source": "huangjinjiage.cn / jin.js",
    "type": "all",
    "quote_time": "10:54:00",
    "international": [
      {
        "name": "国际金价",
        "price": "4353.85",
        "change": "19.68",
        "percent": "0.45%",
        "high": "4361.86",
        "low": "4324.66",
        "time": "2026-08-19 10:54:00"
      },
      {
        "name": "国际铂金",
        "price": "1729.22",
        "change": "-4.58",
        "percent": "-0.26%",
        "high": "1733.90",
        "low": "1712.00",
        "time": "2026-08-19 10:54:26"
      }
    ],
    "domestic": [
      {
        "name": "国内金价",
        "price": "944.70",
        "change": "-10.30",
        "percent": "-1.08%",
        "high": "955.00",
        "low": "939.00",
        "time": "2026-08-19 10:54:48"
      },
      {
        "name": "投资金条",
        "price": "960.70",
        "change": "-10.30",
        "percent": "-1.06%",
        "high": "971.00",
        "low": "955.00",
        "time": "2026-08-19 10:54:48"
      },
      {
        "name": "黄金回收价格",
        "price": "929.70",
        "change": "-10.30",
        "percent": "-1.10%",
        "high": "940.00",
        "low": "924.00",
        "time": "2026-08-19 10:54:48"
      }
    ],
    "brand": [
      {
        "brand": "内地周大福",
        "gold_price": "1339",
        "pt_price": "-",
        "bar_price": "1175",
        "unit": "元/克",
        "time": "2026-08-19"
      },
      {
        "brand": "内地周生生",
        "gold_price": "1338",
        "pt_price": "689",
        "bar_price": "1175",
        "unit": "元/克",
        "time": "2026-08-19"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

国内金价

GETURL QUERY·APPLICATION/JSON

国内延期金价、投资金条、回收价、银价。

https://v1.apizero.cn/api/gold?type=domestic

type（类型）string必填

固定 domestic

例domestic

参数	类型	必填	说明	示例
type（类型）	string	是	固定 domestic	domestic

返回结果

domesticarray

国内行情列表

namestring

名称

pricestring

价格

changestring

涨跌额

percentstring

涨跌幅

highstring

最高

lowstring

最低

timestring

时间

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

字段

类型

说明

domestic

array

国内行情列表

name	string	名称
price	string	价格
change	string	涨跌额
percent	string	涨跌幅
high	string	最高
low	string	最低
time	string	时间

tips

string

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "update_time": "2026-08-19 10:54:54",
    "source": "huangjinjiage.cn / jin.js",
    "type": "all",
    "quote_time": "10:54:00",
    "international": [
      {
        "name": "国际金价",
        "price": "4353.85",
        "change": "19.68",
        "percent": "0.45%",
        "high": "4361.86",
        "low": "4324.66",
        "time": "2026-08-19 10:54:00"
      },
      {
        "name": "国际铂金",
        "price": "1729.22",
        "change": "-4.58",
        "percent": "-0.26%",
        "high": "1733.90",
        "low": "1712.00",
        "time": "2026-08-19 10:54:26"
      }
    ],
    "domestic": [
      {
        "name": "国内金价",
        "price": "944.70",
        "change": "-10.30",
        "percent": "-1.08%",
        "high": "955.00",
        "low": "939.00",
        "time": "2026-08-19 10:54:48"
      },
      {
        "name": "投资金条",
        "price": "960.70",
        "change": "-10.30",
        "percent": "-1.06%",
        "high": "971.00",
        "low": "955.00",
        "time": "2026-08-19 10:54:48"
      },
      {
        "name": "黄金回收价格",
        "price": "929.70",
        "change": "-10.30",
        "percent": "-1.10%",
        "high": "940.00",
        "low": "924.00",
        "time": "2026-08-19 10:54:48"
      }
    ],
    "brand": [
      {
        "brand": "内地周大福",
        "gold_price": "1339",
        "pt_price": "-",
        "bar_price": "1175",
        "unit": "元/克",
        "time": "2026-08-19"
      },
      {
        "brand": "内地周生生",
        "gold_price": "1338",
        "pt_price": "689",
        "bar_price": "1175",
        "unit": "元/克",
        "time": "2026-08-19"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

品牌金店

GETURL QUERY·APPLICATION/JSON

周大福/周生生等门店牌价（以门店为准）。

https://v1.apizero.cn/api/gold?type=brand

type（类型）string必填

固定 brand

例brand

参数	类型	必填	说明	示例
type（类型）	string	是	固定 brand	brand

返回结果

brandarray

品牌金店列表

brandstring

brand

gold_pricestring

gold_price

pt_pricestring

pt_price

bar_pricestring

bar_price

unitstring

unit

timestring

时间

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

字段

类型

说明

brand

array

品牌金店列表

brand	string	brand
gold_price	string	gold_price
pt_price	string	pt_price
bar_price	string	bar_price
unit	string	unit
time	string	时间

tips

string

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "update_time": "2026-08-19 10:54:54",
    "source": "huangjinjiage.cn / jin.js",
    "type": "all",
    "quote_time": "10:54:00",
    "international": [
      {
        "name": "国际金价",
        "price": "4353.85",
        "change": "19.68",
        "percent": "0.45%",
        "high": "4361.86",
        "low": "4324.66",
        "time": "2026-08-19 10:54:00"
      },
      {
        "name": "国际铂金",
        "price": "1729.22",
        "change": "-4.58",
        "percent": "-0.26%",
        "high": "1733.90",
        "low": "1712.00",
        "time": "2026-08-19 10:54:26"
      }
    ],
    "domestic": [
      {
        "name": "国内金价",
        "price": "944.70",
        "change": "-10.30",
        "percent": "-1.08%",
        "high": "955.00",
        "low": "939.00",
        "time": "2026-08-19 10:54:48"
      },
      {
        "name": "投资金条",
        "price": "960.70",
        "change": "-10.30",
        "percent": "-1.06%",
        "high": "971.00",
        "low": "955.00",
        "time": "2026-08-19 10:54:48"
      },
      {
        "name": "黄金回收价格",
        "price": "929.70",
        "change": "-10.30",
        "percent": "-1.10%",
        "high": "940.00",
        "low": "924.00",
        "time": "2026-08-19 10:54:48"
      }
    ],
    "brand": [
      {
        "brand": "内地周大福",
        "gold_price": "1339",
        "pt_price": "-",
        "bar_price": "1175",
        "unit": "元/克",
        "time": "2026-08-19"
      },
      {
        "brand": "内地周生生",
        "gold_price": "1338",
        "pt_price": "689",
        "bar_price": "1175",
        "unit": "元/克",
        "time": "2026-08-19"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/gold?type=all"

错误码

先看业务 code。HTTP 也可能不是 200。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快（QPS）

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

业务码	HTTP	说明
0	200	成功
4000	400	参数错误
4011	401	API Key 无效
4013	403	API Key 已暂停
4014	403	当前 IP 不在 Key 白名单
4015	401	此接口需要 API Key
4022	402	余额不足
4029	429	调用过快（QPS）
4030	429	今日免费额度已用完
4040	503	接口已下线
4041	404	接口不存在
5000	500	服务器内部错误
5020	502	上游暂时不可用
5021	502	上游返回格式异常
5030	502	暂无可用节点

调用限制

计费模式: 完全免费
QPS 限制: QPS 3
登录免费额度: 200 次（已认证）
匿名每日额度: 50 次（无 API Key）
黄金会员: 每天 50,000 次 · QPS 10
钻石会员: 每天 100,000 次 · QPS 30
企业会员: 每天 1,000,000 次 · QPS 120

计费模式	完全免费
QPS 限制	QPS 3
登录免费额度	200 次（已认证）
匿名每日额度	50 次（无 API Key）
黄金会员	每天 50,000 次 · QPS 10
钻石会员	每天 100,000 次 · QPS 30
企业会员	每天 1,000,000 次 · QPS 120

购买套餐、看评价请走商城详情。购买 / 调试

更新日志

1.0.02026-05-06
首次上线，聚合国际黄金/国内黄金/十大品牌金店三类金价数据修复源码 GBK 编码 bug（源码用 <?xml encoding="utf-8" ?> 强制 UTF-8 解析 GBK 内容会导致中文乱码）缓存改用 Redis（10 分钟），不再依赖文件系统解析失败容错（三个表都空时返回 5021 而非空 200）支持 type 参数按需返回单类数据（节省带宽）

免责声明

本接口数据仅供参考，不构成任何投资建议。黄金价格波动风险大，投资需谨慎。品牌金店价格以各门店实际报价为准。数据依赖 huangjinjiage.cn 页面爬取，如页面改版可能影响字段完整性。