Currency Converter API

Convert an amount between any two of 30 currencies using official ECB reference rates, today or on a historical date. ECB reference rates, updated once per business day, not live interbank rates.

原始信息汇总

数据集概述

Currency Converter API 是一个基于官方欧洲央行（ECB）参考汇率构建的货币转换工具，强调透明度和可审计性，适用于展示、会计和报告场景。

核心特点

• 官方数据源：直接使用欧洲央行官方发布的每日参考汇率（eurofxref-daily.xml 和 eurofxref-hist.xml），无第三方外汇供应商干预。
• 全透明与可追溯：每次转换响应均包含实际使用的汇率（rate）和日期（date_used），保证结果可复现和审计。
• 历史汇率支持：通过传递 date 参数，可在指定日期或该日期之前最近的工作日进行转换，自动处理周末和节假日的回退逻辑。
• 任意货币对：支持非欧元货币之间的转换，如美元（USD）到英镑（GBP）的换算，内部按欧元交叉汇率计算。

适用场景

• 结账和定价页面中的参考汇率显示
• 发票工具、费用报告
• 电子商务价格本地化
• 财务仪表板展示

功能限制（诚实声明）

• 使用欧洲央行每日一次的参考汇率，非实时银行间汇率。
• 不提供日内或周末更新。
• 适用于显示、记账和报告，不用于实时交易或支付；实际转账将包含各自的点差和手续费。

API 信息

• 端点：GET /convert?from=&to=&amount=&date=
  • 返回转换后的金额、精确汇率及汇率生效日期。
• 示例：GET /convert?from=USD&to=GBP&amount=100
  • 响应示例：{"from":"USD","to":"GBP","amount":100,"rate":0.738247,"result":73.82,"date_used":"2026-09-08"}
• 支持的货币数量：30种货币。

错误代码

错误码	含义
INVALID_CURRENCY (400)	不支持或缺少货币ISO代码，响应将列出所有支持代码
MISSING_CURRENCY (400)	缺少货币参数
INVALID_DATE (400)	日期格式无效
INVALID_RANGE / RANGE_TOO_WIDE (400)	范围无效或过宽
INVALID_AMOUNT (400)	金额无效
RATE_NOT_AVAILABLE (404)	解析日期中，请求的货币无已发布汇率
NO_DATA (404/503)	日期早于欧洲央行历史开始或不存在更早工作日（404）；服务暂无汇率数据（503）
METHOD_NOT_ALLOWED (405)	不支持的HTTP方法
QUERY_TOO_LONG (414)	请求过长

所有错误均以JSON格式返回，包含 error 和 message 字段。

定价与订阅

• BASIC（免费）：$0.00/月，包含1000次请求/月（截至2026-09-09有效）。
• PRO：$9.00/月
• ULTRA：$29.00/月
• MEGA：$79.00/月

开发者信息

• 创建者：AUtomator labs
• 订阅人数：1
• 类别：金融（Financial）
• 产品网站：可访问RapidAPI页面获取更多信息
• 支持接口调试：可通过Playground（/playground）在线测试

使用流程（Spotlight）

1. 订阅BASIC（免费）计划。
2. 调用 GET /convert 接口，需包含 X-RapidAPI-Key 和 X-RapidAPI-Host 请求头（主机为 currency-converter-api17.p.rapidapi.com）。
3. JSON响应包含 from、to、amount、rate 和 result等字段。

数据更新与频率

• 数据源来自欧洲央行每日约16:00 CET发布的参考汇率。
• 不提供日内或周末更新，仅在每个工作日更新一次。