实时金价v2

接口说明

实时金价v2 提供国内及香港主要珠宝品牌的实时贵金属价格查询服务，数据涵盖黄金、铂金及金条三大品类，每日更新报价。适合需要展示或比对品牌金价的行情类应用与工具调用。

调用地址

https://api.xunjinlu.fun/api/jinjia/v2/

请求方式

GET

鉴权说明

本接口必须携带调用密钥，密钥通过 Query 参数 key 传递，即在请求地址后附加 key=你的密钥。未携带或密钥无效时无法获取数据。

请求参数

参数说明：

• key 为调用本接口的唯一必填参数，需拼接在调用地址之后，例如 https://api.xunjinlu.fun/api/jinjia/v2/?key=你的密钥。
• 本接口无需其他筛选参数，一次请求即返回全部品牌的贵金属报价数据。
• 频率限制：每分钟约 60 次，请合理安排请求节奏。

成功响应示例

接口以纯文本形式返回，各品牌报价之间使用分隔线隔开，末尾附带提示信息。以下为成功调用的返回内容示例：

品牌: 内地周大福
黄金价格: 1292 元/克
铂金价格: - 元/克
金条价格: 1139 元/克
报价时间: 2026-09-27
------------------------
品牌: 内地周生生
黄金价格: 1294 元/克
铂金价格: 687 元/克
金条价格: 1139 元/克
报价时间: 2026-09-27
------------------------
品牌: 内地六福珠宝
黄金价格: 1290 元/克
铂金价格: 687 元/克
金条价格: 1139 元/克
报价时间: 2026-09-27
------------------------
品牌: 内地谢瑞麟
黄金价格: 1292 元/克
铂金价格: - 元/克
金条价格: 1139 元/克
报价时间: 2026-09-27
------------------------
品牌: 内地金至尊
黄金价格: 1292 元/克
铂金价格: 687 元/克
金条价格: 1139 元/克
报价时间: 2026-09-27
------------------------
品牌: 潮宏基
黄金价格: 1292 元/克
铂金价格: 687 元/克
金条价格: 1139 元/克
报价时间: 2026-09-27
------------------------
品牌: 中国黄金
黄金价格: 1293 元/克
铂金价格: 620 元/克
金条价格: 942.5 元/克
报价时间: 2026-09-27
------------------------
品牌: 老凤祥
黄金价格: 1292 元/克
铂金价格: 700 元/克
金条价格: 1146 元/克
报价时间: 2026-09-27
------------------------
品牌: 老庙黄金
黄金价格: 1292 元/克
铂金价格: 700 元/克
金条价格: 1117 元/克
报价时间: 2026-09-27
------------------------
品牌: 周六福
黄金价格: 1287 元/克
铂金价格: 707 元/克
金条价格: 1139 元/克
报价时间: 2026-09-27
------------------------
品牌: 周大生
黄金价格: 1292 元/克
铂金价格: 687 元/克
金条价格: - 元/克
报价时间: 2026-09-27
------------------------
品牌: 菜百首饰
黄金价格: 1280 元/克
铂金价格: 610 元/克
金条价格: 1102 元/克
报价时间: 2026-09-27
------------------------
品牌: 香港周大福
黄金价格: 48996 港币/两
铂金价格: - 港币/两
金条价格: - 港币/两
报价时间: 2026-09-27
------------------------
品牌: 香港周生生
黄金价格: 48995 港币/两
铂金价格: 21410 港币/两
金条价格: 43568 港币/两
报价时间: 2026-09-27
------------------------
品牌: 香港谢瑞麟
黄金价格: 48995 港币/两
铂金价格: 21410 港币/两
金条价格: 43568 港币/两
报价时间: 2026-09-27
------------------------
品牌: 香港金至尊
黄金价格: 48995 港币/两
铂金价格: 21410 港币/两
金条价格: 43568 港币/两
报价时间: 2026-09-27
------------------------
品牌: 香港六福珠宝
黄金价格: 48995 港币/两
铂金价格: 21410 港币/两
金条价格: 43568 港币/两
报价时间: 2026-09-27
------------------------
品牌: 香港老凤祥
黄金价格: 48995 港币/两
铂金价格: 21410 港币/两
金条价格: 43568 港币/两
报价时间: 2026-09-27
------------------------
Tips:仅供参考，具体以实际门店为准

响应字段说明

返回内容为纯文本，每个品牌对应一个报价区块，区块内字段以「字段名: 值」的形式逐行排列，区块之间以 ------------------------ 分隔。各字段含义如下：

补充说明：

• 当某品牌某品类暂无报价时，对应字段的值显示为 -，并保留计价单位，例如 铂金价格: - 元/克。
• 内地品牌与香港品牌使用不同的计价单位，读取数值时需结合单位一并理解。
• 返回内容中的品牌数量与顺序可能随数据更新而变化，请以实际返回为准。

错误响应示例

当请求未通过校验或服务端无法完成处理时，接口返回统一的 JSON 结构，HTTP 状态码始终为 200，业务结果由 code 与 errcode 字段表达。

字段说明：

未提供调用密钥：

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

密钥错误：

{"code":0,"msg":"密钥错误","errcode":11002}

积分余额不足：

{"code":0,"msg":"积分余额不足","errcode":11004}

请求过于频繁：

{"code":0,"msg":"请求过于频繁","errcode":11005}

接口维护中：

{"code":0,"msg":"接口维护中","errcode":11006}

当前 IP 不在白名单内：

{"code":0,"msg":"当前IP不在白名单内","errcode":11019}

密钥已过期：

{"code":0,"msg":"密钥已过期","errcode":11023}

业务错误码说明

下表列出本站对外可能返回的全部业务错误码及其含义。调用方应优先依据 errcode 进行分支处理，msg 仅作为辅助展示。

补充说明：

• 代理类接口在转发过程中同样可能返回 11013～11016 与 11017，分别对应接口不存在、地址无效、地址不允许、***请求失败以及服务暂不可用。
• 11005 对应本接口的频率限制，约为每分钟 60 次，超出后需等待下一时间窗口再发起请求。
• 11006、11007、11008、11017 属于服务侧状态类错误，通常与本次请求参数无关，建议稍后重试或关注服务状态。
• 11001、11002、11003、11012、11019、11023 属于鉴权与访问控制类错误，需检查密钥本身及其使用方式。
• 11004、11010、11011、11020、11021、11022、11024 属于积分与代理配置类错误，需检查账户积分与相关配置是否满足调用条件。

调用示例

终端 curl（bash）

curl "https://api.xunjinlu.fun/api/jinjia/v2/?key=你的密钥"

PHP

// PHP 示例
$url = "https://api.xunjinlu.fun/api/jinjia/v2/?key=你的密钥";

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

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

echo $response;

注意事项

• 密钥通过 Query 参数 key 传递，请将其视为私密凭证妥善保管，不要写入前端页面、公开仓库或客户端可反编译的代码中；一旦发现泄露，请及时更换。
• 调用地址固定为 https://api.xunjinlu.fun/api/jinjia/v2/，请使用 HTTPS 访问，避免在明文信道中传输密钥。
• 本接口为免费接口，但仍受频率限制约束，每分钟约 60 次。请勿高频轮询或并发轰炸，建议在服务端做结果缓存（报价每日更新，缓存至次日即可）。
• 返回内容为按品牌逐条排列的文本，各条之间以分隔线区分。解析时请按「品牌 / 黄金价格 / 铂金价格 / 金条价格 / 报价时间」逐行取值，不要依赖固定行号。
• 部分品牌或品类可能无报价，此时对应数值显示为 -，请在做数值计算前先判断并跳过，避免解析异常。
• 内地品牌价格单位为「元/克」，香港品牌价格单位为「港币/两」，两者计量单位与币种不同，请勿直接混算或横向比较。
• 报价时间以返回中的日期字段为准，数据每日更新，请勿将历史结果当作实时价格使用。
• 返回结果末尾带有参考性提示，数据仅供参考，实际成交价以门店为准，请勿将其用于交易决策或对外承诺。