黄金价格查询 API 接入文档gold

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

获取 API Key：登录 https://apizero.cn/account/keys

以下 5 种语言示例都是可直接运行的，只需把 YOUR_API_KEY 替换为实际 Key。

curl "https://v1.apizero.cn/api/gold?type=all&key=YOUR_API_KEY"

import requests

resp = requests.get(
    "https://v1.apizero.cn/api/gold",
    params={
    "type": "all",
    "key": "YOUR_API_KEY",
},
    timeout=15,
)
resp.raise_for_status()
print(resp.json())

// Node.js 18+ / 浏览器原生 fetch
const params = new URLSearchParams({
  "type": "all",
  "key": "YOUR_API_KEY",
});

const res = await fetch(`https://v1.apizero.cn/api/gold?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://v1.apizero.cn/api/gold", nil)
	q := req.URL.Query()
	q.Set("type", "all")
	q.Set("key", "YOUR_API_KEY")
	req.URL.RawQuery = q.Encode()

	resp, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

<?php
$url = "https://v1.apizero.cn/api/gold?" . http_build_query([
    "type" => "all",
    "key" => "YOUR_API_KEY",
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
$body = curl_exec($ch);
curl_close($ch);

$data = json_decode($body, true);
print_r($data);

{
    "code": 0,
    "msg": "成功",
    "data": {
        "update_time": "2026-05-06 15:30:00",
        "source": "huangjinjiage.cn",
        "type": "all",
        "international": [
            {
                "name": "国际金价",
                "price": "4647.3",
                "change": "7.19",
                "percent": "0.39%",
                "high": "1828.34",
                "low": "1815.50",
                "time": "2026-5-6"
            },
            {
                "name": "国际银价",
                "price": "75.28",
                "change": "0.21",
                "percent": "0.91%",
                "high": "23.24",
                "low": "22.78",
                "time": "2026-5-6"
            }
        ],
        "domestic": [
            {
                "name": "国内金价",
                "price": "1022.9",
                "change": "2.08",
                "percent": "0.56%",
                "high": "375",
                "low": "372.76",
                "time": "2026-5-6"
            }
        ],
        "brand": [
            {
                "brand": "内地周大福",
                "gold_price": "1413",
                "pt_price": "-",
                "bar_price": "1239",
                "unit": "元\/克",
                "time": "2026-5-6"
            }
        ]
    },
    "request_id": "abc123def456"
}

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