银行汇率查询 指南总目录
约 11 分钟 入门银行汇率查询官方指南目录免费接口金融数据
# 银行汇率查询 指南总目录
接口：银行汇率查询（apiCode=105）· 分类：金融数据 · 服务商：昆明秀派科技有限公司（易源官方自营）· 免费接口（L0 基础版 100 次/天、1 QPS）· 接入点：4 个（币种列表 / 实时查询 / 汇率转换 / 历史汇率）· 最后实测核对：2026-09-18
## 一句话速览
银行汇率查询提供主流银行外汇牌价的币种列表、实时查询、币种间换算、历史汇率四类能力，注册即可免费调用。数据为延迟数据、仅供参考，实际交易汇率以当地银行柜台为准。
本目录汇总 13 篇官方指南，覆盖从「5 分钟接入」到「MCP / OpenAPI 集成」的完整路径。文中所有实测数据标注日期，可在对应文章里核对。
## 全部文章（共 13 篇）
### 入门层
1. [银行汇率查询：5 分钟从注册跑到第一次调用](https://www.showapi.com/guides/exchange-rate-quickstart-105) — 拿 AppKey、发第一次请求、读懂返回结构。含 2026-09-18 实测的美元牌价返回。
2. [银行汇率查询返回字段全解（五大价位 / 两层状态码 / 空值情况）](https://www.showapi.com/guides/exchange-rate-fields-105) — 系统级与业务级状态码的区别、五大价位含义、17 种货币存在空价位的原因。
### 场景实战层
3. [银行汇率查询：汇率转换只需 3 个必填参数](https://www.showapi.com/guides/exchange-rate-convert-guide-105) — `fromCode` / `toCode` / `money` 的用法，以及文档未列出的 `rate` 字段。
4. [银行汇率查询历史汇率：按月取还是按区间取](https://www.showapi.com/guides/exchange-rate-history-guide-105) — 两种时间参数的选择、90 天区间的实测行为、倒序返回。
5. [银行汇率查询：用币种列表接入点做货币下拉框](https://www.showapi.com/guides/exchange-rate-currency-list-105) — 动态生成货币选项、国旗图与空值兜底、为什么要自行补上 CNY。
6. [银行汇率查询：一份单文件 HTML 就能看实时牌价](https://www.showapi.com/guides/exchange-rate-web-demo-105) — 可直接运行的单页工具，含完整代码与浏览器跨域实测结果。
### 技术深挖层
7. [银行汇率查询：L0 档位每天 100 次，缓存该缓存什么](https://www.showapi.com/guides/exchange-rate-cache-105) — 免费档位对照表、内存缓存与 Redis 实现、三类数据的 TTL 与缓存键。
8. [银行汇率查询：数据延迟与「仅供参考」的四个适用范围](https://www.showapi.com/guides/exchange-rate-delay-caveat-105) — 数据性质、展示层标注、快照时间戳的读法。
9. [银行汇率查询并发怎么控？纯同步模型下的限流思路](https://www.showapi.com/guides/exchange-rate-concurrency-105) — 令牌桶实现、缓存优先、指数退避，附并发实测结果。
### 行业方案层
10. [银行汇率查询：跨境电商与留学缴费的多币种牌价管理](https://www.showapi.com/guides/exchange-rate-crossborder-105) — 四个接入点串成展示 / 换算 / 对账链路，含落库表结构设计。
11. [银行汇率查询：企业汇率看板的落库与走势实现](https://www.showapi.com/guides/exchange-rate-finance-dashboard-105) — 定时拉取、快照并入库、历史分段取数、实时与历史字段的统一映射。
### 集成层
12. [银行汇率查询：用 MCP 在 AI 客户端里对话式查汇率](https://www.showapi.com/guides/exchange-rate-mcp-105) — 一段 JSON 配置接入，含 MCP 握手与 `tools/call` 的实测返回。
13. [银行汇率查询 OpenAPI 文档：导入 Postman 与 Swagger UI](https://www.showapi.com/guides/exchange-rate-openapi-105) — 文档入口、页面上看不到的超时与接入点字段、版本留档做法。
## 相关资源
| 资源 | 链接 |
|------|------|
| 接口详情页 | https://www.showapi.com/apiGateway/view/105 |
| 接入点：汇率查询（105-30） | https://www.showapi.com/apiGateway/view/105/30 |
| 接入点：汇率转换（105-31） | https://www.showapi.com/apiGateway/view/105/31 |
| 接入点：查询历史汇率（105-34） | https://www.showapi.com/apiGateway/view/105/34 |
| 接入点：外汇牌价币种列表（105-35） | https://www.showapi.com/apiGateway/view/105/35 |
| 产品说明 | https://www.showapi.com/apiGateway/view/105?tab=intro |
| 使用向导 | https://www.showapi.com/apiGateway/view/105?tab=guides |
| OpenAPI 3.0（YAML） | https://www.showapi.com/openapi/market/105.yaml |
| OpenAPI 3.0（JSON） | https://www.showapi.com/openapi/market/105.json |
| MCP 服务地址 | http://www.showapi.com.cn/mcp/105/{your_appKey} |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 免费接口与档位说明 | https://www.showapi.com/free-api |
## 阅读建议
第一次接入：按 1 → 2 的顺序，先把请求跑通，再把字段读对。
做产品功能：看 3 / 4 / 5 / 6，覆盖换算、历史、货币选择器与可运行 Demo。
准备上线：7 / 8 / 9 三篇一起看，把调用额度、数据性质、并发控制三件事定下来。
企业团队：10 / 11 给业务方案与看板架构，12 / 13 给 AI 客户端与接口治理两条集成路径。
## 四个接入点速览
| 接入点 | 路径 | 入参 | 主要返回字段 |
|--------|------|------|--------------|
| 汇率查询 | `105-30` | `code`（可选） | `listSize`、`list[].{name, code, hui_in, chao_in, hui_out, chao_out, zhesuan, day, time}` |
| 汇率转换 | `105-31` | `fromCode`、`toCode`、`money` | `money`、`rate`、`ret_code` |
| 查询历史汇率 | `105-34` | `code` 或 `name`；`month` 或 `startDate` + `endDate` | `currency_code`、`currency_name`、`startDate`、`endDate`、`list[].{publish_time, middle_rate, buying_rate, selling_rate, cash_buying_rate, cash_selling_rate}` |
| 外汇牌价币种列表 | `105-35` | 无 | `exchange_list[].{flag, name, code}` |
四个接入点共用一套 AppKey 与鉴权方式（query 参数 `appKey`），服务地址统一为 `https://route.showapi.com`。
## FAQ
**Q1：这几个接入点要分别申请吗？**
不需要。它们属于同一个接口（apiCode=105），共用一个 AppKey，只是请求路径后缀不同。
**Q2：接口收费吗？**
银行汇率查询是免费接口，注册即享 L0 基础版，每日 100 次、并发 1 QPS，长期有效。通过平台积分可升级到更高档位。
**Q3：数据是实时的吗？**
不是。返回的是延迟数据，延迟时长无法固定，接口返回为银行上一周期或上两周期的数据，仅供参考，实际交易汇率以当地银行为准。
**Q4：一共几个接入点？**
4 个：汇率查询（105-30）、汇率转换（105-31）、查询历史汇率（105-34）、外汇牌价币种列表（105-35）。
**Q5：支持哪些集成方式？**
直接调用 HTTP 接口、接口级 MCP 服务、标准 OpenAPI 3.0 文档导入 API 工具，三种方式都可用，底层是同一套接口。
