人民币汇率查询 - 即刻数据#

数据由 即刻数据 提供。即刻数据专注稳定易用的数据 API、MCP 与 AI Skill 能力，帮助开发者和 AI 客户端快速接入可靠数据服务。

支持： 外汇币种列表、人民币外汇牌价查询、汇率转换。

---

前置配置：获取 AppKey#

bash

export JIKE_CNY_EXCHANGE_RATE_KEY=你的AppKey

也可以使用通用 Key：

bash

export JIKE_APPKEY=你的AppKey

---

使用方法#

查询支持的币种列表#

bash

python3 scripts/cny_exchange_rate.py list

查询单个币种人民币牌价#

bash

python3 scripts/cny_exchange_rate.py query --currency usd

查询全部币种人民币牌价#

bash

python3 scripts/cny_exchange_rate.py query

汇率转换#

bash

python3 scripts/cny_exchange_rate.py convert --from-currency usd --to-currency cny --money 100

输出示例：

text

💱 汇率转换结果

  日期: 2025-11-23
  金额: 712.6900
  说明: 100美元 = 712.6900人民币

直接调用 API#

text

GET https://api.jikeapi.cn/v1/cny_exchange_rate/currenc_list?appkey=YOUR_APPKEY
GET https://api.jikeapi.cn/v1/cny_exchange_rate/query?currency=usd&appkey=YOUR_APPKEY
GET https://api.jikeapi.cn/v1/cny_exchange_rate/convert?from_currency=usd&to_currency=cny&money=100&appkey=YOUR_APPKEY

---

AI 使用步骤#

当用户询问汇率、外汇牌价、金额换算时：

1. 判断意图：问“支持哪些币种”用 list；问“某币种牌价”用 query；问“多少钱换算”用 convert。
2. 提取参数：识别源币种、目标币种和金额。
3. 调用脚本：执行对应子命令。
4. 展示结果：说明汇率日期、转换金额和接口返回描述。

参数说明#

子命令参数说明示例list无查询支持币种list``query``--currency币种代码，不传返回全部usd``convert``--from-currency源货币usd``convert``--to-currency目标货币cny``convert``--money金额100

返回字段#

字段含义currency货币类型currency_name货币名称spot_buying现汇买入价cash_buying现钞买入价spot_selling现汇卖出价cash_selling现钞卖出价money转换后的金额desc转换说明

错误处理#

情况处理方式未配置 AppKey提醒用户配置 JIKE_CNY_EXCHANGE_RATE_KEY 或 JIKE_APPKEY币种不存在提醒用户先用 list 查询支持币种金额非法提醒用户提供大于 0 的数字网络超时建议稍后重试或检查网络

---

脚本位置#

scripts/cny_exchange_rate.py：封装了 currenc_list、 query、 convert 三个接口的参数校验、请求和展示逻辑。