\r \r

国内金价查询 · 极速数据黄金（Gold）\r

\r

数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。\r \r

何时使用本技能（触发条件）\r

\r 当用户询问以下任一主题时，应触发本技能：\r \r

• 金价、黄金价格、今日金价、现在黄金多少钱\r
• 金店价格、品牌金价（如周大福、老凤祥等零售价）\r
• 银行金条、银行黄金、账户金、纸黄金（对应接口：银行账户黄金等）\r
• 国际金价、伦敦金、伦敦银、外盘黄金\r
• 黄金走势、金价涨跌、未来趋势、后市怎么看（基于返回的涨跌幅、开高低收等作说明，勿编造未在数据中出现的结论）\r \r 技术前提： 使用脚本 skills/gold/gold.py，配置环境变量 JISU_API_KEY。\r \r 接口与数据范围：\r \r
• 上海黄金交易所价格（/gold/shgold）\r
• 上海期货交易所价格（/gold/shfutures）\r
• 香港金银业贸易场价格（/gold/hkgold）\r
• 银行账户黄金价格（/gold/bank）\r
• 伦敦金、银价格（/gold/london）\r
• 金店金价（/gold/storegold）\r \r

前置配置：获取 API Key\r

\r

1. 前往 极速数据官网 注册账号\r
2. 进入 黄金价格 API 页面，点击「申请数据」\r
3. 在会员中心获取 AppKey\r
4. 配置 Key：\r \r \r

# Linux / macOS\r
export JISU_API_KEY="your_appkey_here"\r
\r
# Windows PowerShell\r
$env:JISU_API_KEY="your_appkey_here"\r
```\r
\r
## 脚本路径\r
\r
脚本文件：`skills/gold/gold.py`\r
\r
## 使用方式\r
\r
### 1. 上海黄金交易所价格（/gold/shgold）\r
\r
```bash\r
python3 skills/gold/gold.py shgold\r
```\r
\r
### 2. 上海期货交易所价格（/gold/shfutures）\r
\r
```bash\r
python3 skills/gold/gold.py shfutures\r
```\r
\r
### 3. 香港金银业贸易场价格（/gold/hkgold）\r
\r
```bash\r
python3 skills/gold/gold.py hkgold\r
```\r
\r
### 4. 银行账户黄金价格（/gold/bank）\r
\r
```bash\r
python3 skills/gold/gold.py bank\r
```\r
\r
### 5. 伦敦金、银价格（/gold/london）\r
\r
```bash\r
python3 skills/gold/gold.py london\r
```\r
\r
### 6. 金店金价（/gold/storegold）\r
\r
```bash\r
# 不指定日期：默认当天（仅支持最近 7 天）\r
python3 skills/gold/gold.py storegold\r
\r
# 指定日期：\r
python3 skills/gold/gold.py storegold '{"date":"2023-09-20"}'\r
```\r
\r
请求 JSON（仅 `storegold` 支持）：\r
\r
```json\r
{\r
  "date": "2023-09-20"\r
}\r
```\r
\r
## 返回结果示例（节选）\r
\r
### 上海黄金交易所价格\r
\r
```json\r
[\r
  {\r
    "type": "Au(T+D)",\r
    "typename": "黄金延期",\r
    "price": "238.05",\r
    "openingprice": "241.00",\r
    "maxprice": "241.50",\r
    "minprice": "237.50",\r
    "changepercent": "-0.90%",\r
    "lastclosingprice": "240.22",\r
    "tradeamount": "45998.0000",\r
    "updatetime": "2015-10-26 15:29:13"\r
  }\r
]\r
```\r
\r
### 上海期货交易所价格\r
\r
```json\r
[\r
  {\r
    "type": "AU1512",\r
    "typename": "黄金1512",\r
    "price": "238.7",\r
    "changequantity": "-0.949",\r
    "buyprice": "238.7",\r
    "buyamount": "5",\r
    "sellprice": "238.75",\r
    "sellamount": "100",\r
    "tradeamount": "210274",\r
    "openingprice": "241.5",\r
    "lastclosingprice": "239.649",\r
    "maxprice": "241.5",\r
    "minprice": "237.799",\r
    "holdamount": "188302",\r
    "increaseamount": "-6086"\r
  }\r
]\r
```\r
\r
### 银行账户黄金价格\r
\r
```json\r
[\r
  {\r
    "typename": "人民币黄金",\r
    "midprice": "408.92",\r
    "buyprice": "408.67",\r
    "sellprice": "409.17",\r
    "maxprice": "409.16",\r
    "minprice": "407.58",\r
    "updatetime": "2020-07-21 12:19:54"\r
  }\r
]\r
```\r
\r
### 伦敦金、银价格\r
\r
```json\r
[\r
  {\r
    "type": "伦敦金",\r
    "price": "1818.6899",\r
    "changepercent": "+0.05%",\r
    "changequantity": "+0.9199",\r
    "openingprice": "1817.95",\r
    "maxprice": "1820.29",\r
    "minprice": "1815.8199",\r
    "lastclosingprice": "1817.77",\r
    "updatetime": "2020-07-21 12:23:35"\r
  }\r
]\r
```\r
\r
### 金店金价\r
\r
```json\r
{\r
  "list": [\r
    {\r
      "store_name": "周大福",\r
      "date": "2023-09-20",\r
      "gold": "612.00",\r
      "platinum": "387.00",\r
      "goldbar": "602.00",\r
      "jewelry": "612.00",\r
      "solid_gold": null\r
    }\r
  ]\r
}\r
```\r
\r
当无数据时，脚本会输出：\r
\r
```json\r
{\r
  "error": "api_error",\r
  "code": 201,\r
  "message": "没有信息"\r
}\r
```\r
\r
## 常见错误码\r
\r
来源于 [极速数据黄金文档](https://www.jisuapi.com/api/gold/)：\r
\r
| 代号 | 说明     |\r
|------|----------|\r
| 201  | 没有信息 |\r
\r
系统错误码：\r
\r
| 代号 | 说明                 |\r
|------|----------------------|\r
| 101  | APPKEY 为空或不存在  |\r
| 102  | APPKEY 已过期        |\r
| 103  | APPKEY 无请求权限    |\r
| 104  | 请求超过次数限制     |\r
| 105  | IP 被禁止            |\r
\r
## 推荐用法\r
\r
1. **比价类**：用户问「现在黄金价格大概是多少？上海金交所和金店各多少？」  \r
   - 依次调用：`python3 skills/gold/gold.py shgold`、`python3 skills/gold/gold.py storegold`（可按需加 `bank`、`london`）。  \r
   - 从结果中摘取常见品种（如 AU9999、黄金延期）及主流金店克价，对比 **国内盘面 vs 金店零售 vs 银行渠道**。\r
\r
2. **走势 / 趋势类**：用户问「黄金走势怎样？后面还会涨吗？」  \r
   - 拉取 `shgold`、`shfutures`、`london`、`bank` 等中与用户场景相关的接口，用返回的 **涨跌幅、昨收、最高最低** 等字段归纳「当前数据反映的强弱」，并明确 **数据时效与免责**；**禁止**捏造 API 未提供的预测结论。\r
\r
## 关于极速数据\r
\r
**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r
\r
- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息  \r
- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测  \r
- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询  \r
- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别  \r
- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令  \r
- **位置服务**：基站查询，经纬度地址转换，坐标系转换  \r
\r
在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\r
\r