为AI Agent设计的按次付费汇率API：ECB参考利率直连

AI Agent 的工作流里，价格、预算和报表经常横跨多种货币。开发者通常面临三种选择：订阅一套外汇数据源、再维护一个 API key，或者干脆把参考汇率当成可成交报价来用——最后一种在账务和成本核算上会埋下隐患。SML FX Convert 试图用另一种方式解决这个问题：按次付费，并且在响应里直接标明数据来源。

数据源与调用方式：透明优先

据该项目的实测记录，GET /api/fx/info 是免费接口，其响应体本身就写明数据来源为欧洲央行 EXR 每日参考汇率（European Central Bank EXR daily reference rates），并附带「Source: ECB statistics」字样。这一点对 Agent 场景很关键：当自动化流程把汇率写进报价单或成本报表时，来源可追溯比数值本身更难获得。

转换调用走 GET /api/fx/convert?from=USD&to=EUR&amount=100。未付费时返回 HTTP 402，并在 PAYMENT-REQUIRED 响应头中报价 1000 个原子单位 USDC，网络为 eip155:8453（Base 主网），方案为 exact。整个过程不需要 SML API key，也不需要注册账户——402 挑战本身就是完整的结算入口。

计价方面，每次成功转换收费 0.001 USDC；如果购买 100 次转换的信用包，价格为 0.005 USDC，全部用完后相当于每次 0.00005 USDC。对于低频、突发性的 Agent 汇率需求，这种按次模式避免了订阅制下的闲置成本。

欧洲央行 EXR 参考汇率是 ECB 每个工作日约欧洲中部时间 16:00 发布的欧元兑一篮子主要货币的参考中间价，数据随 ECB 统计数据库公开。它并非市场实时成交价，而是基于多家报价机构数据汇总的指示性汇率，发布时间固定、更新频率为每日一次。正因为如此，它非常适合账务归一与成本比较，但不适合需要盘中变动的交易场景。开发者调用时需注意，ECB 在节假日不发布新数据，调用方应处理可能出现的“同日沿用”或数据缺失情况。

x402 协议是一种基于 HTTP 402 状态码的支付协商机制，旨在让 API 调用在无需预先注册账户或 API key 的情况下完成按次结算。其基本流程是：客户端首次请求时收到 402 响应，响应头（如 PAYMENT-REQUIRED）中携带价格、支付网络、资产类型和支付方案；客户端根据这些信息构造链上支付，并将支付证明附加到重试请求中；服务端验证后返回结果。文中提到的 exact 方案表示要求支付精确金额，而 eip155:8453 是 Base 主网的 CAIP-2 链标识，USDC 则是该链上的美元稳定币。这种模式将支付逻辑内嵌于 HTTP 交互，降低了 Agent 接入支付的门槛。

失败即关闭：不编造汇率

该项目强调的一条设计约束是「故障关闭」（fail-closed）：没有真实汇率就不结算，调用方会收到一条免费的替代路径。无效的货币代码、格式错误的金额、或参考数据不可用时，系统不会静默返回一个付费的、虚构的转换结果。

这条规则对 Agent 自主执行尤其重要。自动化流程往往缺少人工复核环节，一个「看起来成功」的错误汇率可能一路传导到预算决策和供应商比价中。把失败显式暴露出来，比返回一个臆测值更符合工程直觉。

**故障关闭（fail-closed）**与故障开放（fail-open）是系统设计中的一对相反策略：前者在检测到异常时默认拒绝服务或中止流程，后者则默认放行或返回降级结果。在汇率转换场景中，故障关闭意味着当参考数据不可用、货币代码无效或金额格式错误时，API 不会返回一个猜测值，而是显式报错并引导调用方走免费替代路径。这种设计牺牲了部分可用性，但避免了错误数据污染下游决策。对于缺乏人工复核的自动化 Agent 而言，fail-closed 能有效防止“看似成功”的错误结果被静默传播。

边界说明：参考汇率不是成交价

该服务明确划定了自己的适用范围：这是 ECB 参考汇率的计算，不是银行、卡组织、交易所或券商的执行报价。它不托管法币、不做外汇交易、不保证点差，也不承诺参考汇率在任何场所可成交。

它真正适合的场景是：归一化供应商报价、比较不同货币计价的 API 成本、在工具选型前换算预算上限、以及让 Agent 商务报表统一到单一参考货币。在这些场景里，来源的可追溯性比「假装参考汇率是实时成交价」更有价值。项目方也提醒，x402 的最新条款在支出前仍然有效；402 挑战不等于结算，结算也不等于接受。

多源信息与判断

目前关于该服务的信息主要来自项目方自身的实测记录与说明文档，属于单一来源，尚缺少第三方独立验证。从工程角度看，x402 支付通道加 ECB 公开参考数据的组合思路清晰，按次计费也契合 Agent 偶发调用的特征；但参考汇率的时效性受 ECB 每日发布节奏约束，不适合需要盘中实时报价的金融场景。是否采用，取决于你的 Agent 是在做「账务归一」还是「交易决策」——前者匹配，后者不匹配。