外汇 API：查询参考汇率与币种换算

NBP reference-rate tool

通过 QVeris 查找汇率工具，为预算、报告和币种换算提供数据。先明确需要哪些币种，以及任务采用什么日期口径。NBP 参考汇率工具提供了一个可直接查看的入口，可以把公布汇率及来源带入计算。

例如供应商按 USD 报价，而团队使用 PLN 编制预算。参考汇率流程可以输出汇率、公布日期及预计 PLN 金额的计算过程，方便审核者在汇率变化后更新预算。

本文示例聚焦已公布的参考汇率。需要可交易买卖价、持续行情推送或券商成交价时，应另选明确支持该需求的能力。

仅作假设算术演示：1,000 USD 乘以假设的 4.00 PLN/USD，等于 4,000 PLN。这些数字用于说明公式，不是当前汇率报价。实际使用前必须替换为工具返回的汇率。

在乘法两侧写明单位，可以快速发现币种方向写反的问题。反向换算时，还要确认当前汇率类型是否适合直接取倒数。

NBP API documentation

USD-to-PLN conversion taskAPI documentation

检查所选 NBP 工具后，使用下面的参数对象查询最近可用的 A 表美元汇率：

{
  "table": "A",
  "code": "USD",
  "topCount": 1,
  "format": "json"
}

NBP API 文档（英文原文）区分 A/B 表平均汇率与 C 表买卖汇率，并说明公布日期。“最近可用”可能对应上一个工作日，应保留返回日期，不能替换为今天。

可以通过USD 转 PLN 换算任务把结果整理成预算备注；系统需要重复换算时，再按照API 文档连接相同能力。

公布的参考汇率可以为比较或估算提供一致依据。银行付款报价可能包含点差、费用及有效期限。应把参考汇率换算标为估算，并单独列出实际支付成本。

涉及会计或合同换算时，使用适用规则或约定要求的日期与来源，不能为了方便把交易日汇率改成最新汇率。请求日期没有观察值时，应按明确的回退规则处理，并记录实际采用日期。

来源表可能只提供若干币种相对于本币的汇率，而不是任意货币对。计算交叉汇率前，先确认两条数据的日期和定义兼容。

economic dataPython integration patternQVeris pricing

把输入金额、币种、汇率、公布日期、公式和输出金额一起保存。内部计算保留所需精度，最后再按展示要求四舍五入。报告引用某次换算时保留当时汇率，不要在每次刷新时用新汇率重算旧结论。

报告需要宏观背景时，可以连接经济数据；需要重复查询时，参考Python 接入流程并使用外汇工具自己的参数。提高刷新频率前，查看QVeris 价格说明中的试用条款和调用成本。

点击后将打开已预填的 QVeris 任务，查询 NBP A 表最近可用的美元参考汇率。结果会列出每 1 USD 对应的 PLN、公布日期、来源和公式，再计算不含银行费用与点差的参考金额。