银行汇率查询：延迟数据与"仅供参考"——接入前必须知道的四件事
# 银行汇率查询：延迟数据与"仅供参考"——接入前必须知道的四件事
> 接口：银行汇率查询（apiCode=105）· 免费 · 返回格式：JSON · 适用人群：所有接入前/接入中的开发者 · 阅读时间：约 5 分钟
## TL;DR
- 数据有数分钟延迟、非投资建议，实际交易以当地银行柜台为准。
- 免费接口不承诺 SLA，历史数据每天 1 点才更新「昨日」。
- 实时牌价每 10s 更新，但仍是延迟快照，不是成交价。
- 接入前把这四点写进你的产品免责声明与异常处理。
## Why
很多踩坑不是代码问题，而是对数据性质理解错了：把「仅供参考的延迟牌价」当成「实时成交价」去撮合交易、去给用户承诺保价，结果引发客诉。本篇把文档里分散的免责与时效说明集中成「接入前检查清单」，帮你提前规避。
## What
| 维度 | 文档事实 |
|------|---------|
| 数据性质 | 延迟数据，仅供参考，实际交易汇率以当地银行为准 |
| 实时接入点 | 每 10s 更新一次（仍是延迟快照，非成交价） |
| 历史接入点 | 每天 1 点更新昨日历史牌价 |
| 投资建议 | 数据源自网络、有数分钟延迟，非投资建议 |
| 服务保障 | 免费接口，文档未承诺 SLA / 可用性指标 |
## How
### 接入前检查清单（建议直接落到代码与文案）
1. **展示层标注**：在牌价旁固定显示「数据延迟，仅供参考，以银行柜台为准」。
2. **禁止用于撮合**：不要把该接口返回值作为交易成交价或保价依据。
3. **异常处理**：请求失败时用上一次成功缓存兜底，并提示「数据可能非最新」。
4. **时效说明**：历史数据需等次日 1 点后才有，当天请用实时接入点。
```python
# 失败时回退到缓存并提示延迟
def show_rate(code, cache):
data = fetch_live(code)
if data is None and code in cache:
return cache[code], "（数据可能非最新，仅供参考）"
return data, "（仅供参考，实际以银行柜台为准）"
```
## 返回示例与解析
返回体本身不含「延迟」字段，延迟是数据源层面的属性。因此**展示责任在你这一侧**——接口不会替你标注，需要你在 UI 文案与免责声明中体现。
## 进阶 / 边界
- **不要做「秒级套利」假设**：10s 更新 + 网络延迟 + 解析耗时，你拿到的永远晚于真实牌价。
- **跨境/对账场景**：用历史接入点时注意「今天的数据明天才有」，当日核对请用实时值。
- 详细字段与状态码见[字段全解](https://www.showapi.com/guides/exchange-rate-fields-105)。
## FAQ
**Q：数据是实时的吗？**
不是严格实时。实时接入点每 10s 更新一次，且数据源自网络、有数分钟延迟，是延迟快照而非成交价。
**Q：能拿这个接口做交易系统的成交价吗？**
不能。文档明确「仅供参考，实际交易以当地银行为准」，非投资建议。
**Q：为什么历史表里没有今天的汇率？**
历史数据每天 1 点更新「昨日」，当天牌价尚未入库，请改用实时查询接入点。
**Q：接口可用性有保证吗？**
免费接口文档未承诺 SLA，生产环境应做异常兜底与缓存降级，不要把关键链路完全押在它上面。
## 相关能力 / 下一步阅读
- [银行汇率查询：免费档位下如何做本地缓存避免触达使用档次限制？](https://www.showapi.com/guides/exchange-rate-cache-105)
- [银行汇率查询：搭建企业汇率看板——币种列表 + 实时查询 + 历史走势](https://www.showapi.com/guides/exchange-rate-finance-dashboard-105)
- **本系列共 13 篇**：查看[银行汇率查询指南总目录](https://www.showapi.com/guides/exchange-rate-guides-105)
