实时金价v1 API 文档

接口说明

今日金价查询API是一个实时获取国内各大金店黄金价格和国际黄金白银期货价格的接口。数据每10分钟更新一次，确保获取到最新的市场行情信息。

本接口返回内容包括：

• 国内主要金店（周大福、六福珠宝、菜百首饰等）的黄金零售价和换金价
• 国际黄金现货、上海黄金现货、国际白银现货、上海白银现货的实时交易价格
• 多种贵金属行情图表链接（实时图、趋势图）

调用地址： https://openapi.xunjinlu.fun/api/jinjia/v1.php

请求方式： GET

密钥要求： 必须提供有效密钥

鉴权方式： Query 参数

计费模式： 免费

所属分类： 实时金价

请求参数

请求示例

GET https://openapi.xunjinlu.fun/api/jinjia/v1.php?key=sk_xxxxxxxxxxxxxxxx

成功响应示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "update_time": "2026-05-02 18:58:02",
        "shops": [
            {
                "name": "周大福",
                "retail_price": "1419",
                "exchange_price": "978",
                "update_time": "2026-05-02 18:58:02"
            },
            {
                "name": "六福珠宝",
                "retail_price": "1417",
                "exchange_price": "1205",
                "update_time": "2026-05-02 18:58:03"
            },
            {
                "name": "菜百首饰",
                "retail_price": "1388",
                "exchange_price": null,
                "update_time": "2026-05-02 18:58:03"
            }
        ],
        "futures": [
            {
                "name": "国际黄金现货",
                "trade_price": "4614.95",
                "trade_unit": "美元/盎司",
                "convert_price": "1012.9647",
                "convert_unit": "元/克",
                "update_time": "2026-05-02 04:59:58"
            },
            {
                "name": "上海黄金现货",
                "trade_price": "1013.36",
                "trade_unit": "人民币/克",
                "convert_price": "1013.36",
                "convert_unit": "元/克",
                "update_time": "2026-04-30 15:02:10"
            },
            {
                "name": "国际白银现货",
                "trade_price": "75.36",
                "trade_unit": "美元/盎司",
                "convert_price": "16.5412",
                "convert_unit": "元/克",
                "update_time": "2026-05-02 04:59:58"
            },
            {
                "name": "上海白银现货",
                "trade_price": "17954",
                "trade_unit": "人民币/千克",
                "convert_price": "17.954",
                "convert_unit": "元/克",
                "update_time": "2026-04-30 14:43:50"
            }
        ],
        "charts": {
            "intl_gold_realtime": "https://webquotepic.eastmoney.com/GetPic.aspx?token=44c9d251add88e27b65ed86506f6e5da&nid=122.XAU&type=r&imageType=rf",
            "intl_gold_trend": "https://webquoteklinepic.eastmoney.com/GetPic.aspx?nid=122.XAU&type=&unitWidth=-6&ef=&formula=RSI&AT=1&imageType=KXL",
            "intl_silver_realtime": "https://webquotepic.eastmoney.com/GetPic.aspx?token=44c9d251add88e27b65ed86506f6e5da&nid=122.XAG&type=r&imageType=rf",
            "intl_silver_trend": "https://webquoteklinepic.eastmoney.com/GetPic.aspx?nid=122.XAG&type=&unitWidth=-6&ef=&formula=RSI&AT=1&imageType=KXL",
            "shanghai_gold_realtime": "https://webquotepic.eastmoney.com/GetPic.aspx?token=44c9d251add88e27b65ed86506f6e5da&nid=118.SHAU&type=r&imageType=rf",
            "shanghai_gold_trend": "https://webquoteklinepic.eastmoney.com/GetPic.aspx?nid=118.SHAU&type=&unitWidth=-6&ef=&formula=RSI&AT=1&imageType=KXL",
            "shanghai_silver_realtime": "https://webquotepic.eastmoney.com/GetPic.aspx?token=44c9d251add88e27b65ed86506f6e5da&nid=118.SHAG&type=r&imageType=r",
            "comex_gold_realtime": "https://webquotepic.eastmoney.com/GetPic.aspx?imageType=r&type=&token=44c9d251add88e27b65ed86506f6e5da&nid=101.GC00Y",
            "comex_gold_trend": "https://webquoteklinepic.eastmoney.com/GetPic.aspx?nid=101.GC00Y&type=&unitWidth=-6&ef=&formula=RSI&AT=1&imageType=KXL",
            "comex_silver_realtime": "https://webquotepic.eastmoney.com/GetPic.aspx?imageType=r&type=&token=44c9d251add88e27b65ed86506f6e5da&nid=101.SI00Y",
            "comex_silver_trend": "https://webquoteklinepic.eastmoney.com/GetPic.aspx?nid=101.SI00Y&type=&unitWidth=-6&ef=&formula=RSI&AT=1&imageType=KXL"
        }
    },
    "api_info": {
        "developer": "尋鯨錄",
        "blog": "https://www.xunjinlu.fun",
        "api_platform": "https://api.xunjinlu.fun"
    }
}

响应字段说明

顶层字段

data 对象字段

shops 数组元素字段

futures 数组元素字段

charts 对象字段

api_info 对象字段

错误响应示例

当请求出现错误时，API将返回如下格式的JSON响应：

{
    "code": 0,
    "msg": "未提供调用密钥",
    "errcode": 11001
}

业务错误码说明

调用示例

PHP 示例

// 实时金价查询示例
$key = 'sk_xxxxxxxxxxxxxxxx';
$url = 'https://openapi.xunjinlu.fun/api/jinjia/v1.php?key=' . urlencode($key);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result['code'] === 200) {
    // 成功获取数据
    $data = $result['data'];
    echo "更新时间: " . $data['update_time'] . "\n";

    // 遍历金店金价
    foreach ($data['shops'] as $shop) {
        echo $shop['name'] . " 零售价: " . $shop['retail_price'] . " 元/克\n";
    }

    // 遍历期货价格
    foreach ($data['futures'] as $future) {
        echo $future['name'] . ": " . $future['trade_price'] . " " . $future['trade_unit'] . "\n";
    }
} else {
    // 错误处理
    echo "错误码: " . $result['errcode'] . "\n";
    echo "错误信息: " . $result['msg'] . "\n";
}

JavaScript 示例

// 实时金价查询示例
const key = 'sk_xxxxxxxxxxxxxxxx';
const url = `https://openapi.xunjinlu.fun/api/jinjia/v1.php?key=${encodeURIComponent(key)}`;

fetch(url)
    .then(response => response.json())
    .then(result => {
        if (result.code === 200) {
            const data = result.data;
            console.log('更新时间:', data.update_time);

            // 遍历金店金价
            data.shops.forEach(shop => {
                consol

…（已按长度限制截断）