银行汇率查询：数据延迟与「仅供参考」的四个适用范围
约 7 分钟 入门银行汇率查询延迟数据仅供参考数据性质
# 银行汇率查询：数据延迟与「仅供参考」的四个适用范围
接口：银行汇率查询（apiCode=105）· 免费接口（L0 基础版 100 次/天、1 QPS）· 请求方式：POST / GET · 返回格式：JSON · 适用人群：接入前与接入中的开发者、产品经理 · 阅读时间：约 5 分钟 · 最后实测核对：2026-09-18
## 核心要点
- 返回的是延迟数据，「延迟时长无法固定」，实际交易汇率以当地银行为准。
- 接入点文档明确标注「非投资建议，数据分析参考」，接口定位是展示与分析。
- 返回体里没有表示延迟时长的字段，时效标注要在展示层用 `day` 和 `time` 自行完成。
## 这套数据是什么性质
先看两句官方原文。产品说明的表述是：数据为延迟数据，仅供参考，实际交易汇率以当地银行为准；延迟时长无法固定，接口返回为银行上一周期或上两周期的数据，不返回实时汇率，因银行汇率更新无固定时间规则，故延迟周期无法明确。汇率查询接入点（105-30）的文档描述是：数据源自网络，有数分钟延迟，非投资建议，数据分析参考。
这两句话决定了它的适用范围。凡是需要「此刻的成交价」的地方，都不在这个范围里。
## 四个适用范围
**一是展示与分析类场景。** 牌价表、比价页、走势图、内容资讯里的数据引用都属于这一类。用户看到的是一份有明确时间戳的参考数据，不是承诺价格的报价单。
**二是换算与预估类场景。** 汇率转换接入点返回的金额适合做展示与预估，正式账单金额以银行实际成交价为准。
**三是不能用它做成交价或交易撮合。** 接口返回的是银行上一周期或上两周期的数据，它描述的是某个已过去的时点，不是下单时刻的价格。
**四是时效标注由展示层负责。** 接口不会替你在响应里写「本条数据延迟 N 分钟」。2026-09-18 实测确认，105-30 的业务返回体只有 `listSize`、`list`、`ret_code` 三个字段，没有表示延迟的字段。界面上的时效提示要在你的代码与文案里补上。
## 判断数据有多旧
返回体给了两个字段可以定位快照时间：`list[].day` 是发布日，`list[].time` 是发布时间。2026-09-18 实测不传 `code` 时返回 46 条记录，46 条的 `day` 都是 `2026-09-18`，`time` 都是 `09:16:23`——同一批返回共用同一个时间戳，可以整体取首条的值作为这批数据的快照时间。
```python
import requests
js = requests.post(
"https://route.showapi.com/105-30",
params={"appKey": "YOUR_APPKEY"},
data={},
timeout=15
).json()
body = js.get("showapi_res_body", {})
rows = body.get("list") or []
if rows:
snapshot = f"{rows[0]['day']} {rows[0]['time']}"
print("数据快照时间：", snapshot)
# 直接给前端用，比后端计算相对时间更准确
else:
print("未取到数据，请用上一次成功缓存兜底，并提示数据可能非最新")
```
把快照时间写进响应里给前端，展示层就不用自己推算，用户也能直接看到数据对应的是哪个时点。
## 落到代码与文案里的做法
展示层在牌价旁固定标注一行：数据延迟，仅供参考，实际交易以银行柜台为准。这行文案适合做成组件的一部分，而不是散落在各个页面里手写。
异常处理里准备一条降级路径：接口异常时返回上一次成功缓存的结果，同时把界面上的时效提示改成「数据可能不是最新」。缓存与降级的实现见缓存那篇。
对内部团队说清接口的定位，比在代码里加判断更有效。产品、运营、客服知道这份数据「不是成交价」之后，对外话术自然会落在适用范围之内。
## FAQ
**Q1：接口返回的是实时汇率吗？**
不是。产品说明写明延迟时长无法固定，返回的是银行上一周期或上两周期的数据，不返回实时汇率；接入点文档标注「有数分钟延迟」。
**Q2：能拿它做交易系统的成交价吗？**
不能。文档明确「仅供参考，实际交易汇率以当地银行为准」，同时标注「非投资建议，数据分析参考」。
**Q3：返回体里有表示延迟时长的字段吗？**
没有。2026-09-18 实测 105-30 的业务返回体只有 `listSize`、`list`、`ret_code`。时效标注需要在展示层用 `day` 和 `time` 自行完成。
**Q4：用户问到「这个价格准吗」怎么答？**
按官方口径回答：数据来自主流银行外汇牌价，为延迟数据，仅供参考，实际交易汇率以当地银行柜台为准。
**Q5：免费接口有可用性承诺吗？**
免费接口文档未承诺 SLA 指标。生产环境建议做异常兜底与缓存降级，不要把它放在唯一的关键路径上。
## 下一步阅读
- [银行汇率查询：L0 档位每天 100 次，缓存该缓存什么](https://www.showapi.com/guides/exchange-rate-cache-105)：降级兜底与缓存键的具体写法。
- [银行汇率查询并发怎么控？纯同步模型下的限流思路](https://www.showapi.com/guides/exchange-rate-concurrency-105)：把调用量压在 L0 档位以内。
- [银行汇率查询：企业汇率看板的落库与走势实现](https://www.showapi.com/guides/exchange-rate-finance-dashboard-105)：把每天的牌价留痕，事后可回溯。
- **本系列共 13 篇**：查看[银行汇率查询指南总目录](https://www.showapi.com/guides/exchange-rate-guides-105)
