Currency Reference API: ISO Codes and Names

The 30 ISO 4217 currencies covered by the ECB reference rates family, with names and symbols where unambiguous. ECB reference rates, updated once per business day, not live interbank rates.

原始信息汇总

数据集概述

该API名为 Currency Reference API: ISO Codes and Names，由 Automator Labs 创建，归类于 Financial（金融）类别，是 ECB Exchange Rates 系列API的配套参考数据集。

核心功能

提供一套静态参考列表，涵盖ECB（欧洲中央银行）汇率参考体系所支持的全部货币（共 30种ISO 4217货币，外加 EUR（欧元）），包含每种货币的 ISO代码、通用名称及可打印符号。

主要用途

• 构建货币选择器（Currency picker）
• 表单验证（Form validation）
• 外汇仪表盘（FX dashboard）
• 其他ECB汇率系列API的文档生成

数据特点

• 数据来源：ECB官方每日发布的参考汇率文件（eurofxref-daily.xml、eurofxref-hist.xml），不依赖第三方外汇提供商或API密钥。
• 更新频率：每个工作日下午约16:00 CET更新一次，无盘中或周末更新；属于静态参考数据，仅在ECB增删货币时变动。
• 符号说明：当多种货币共用同一符号（如“$”）时，该字段返回 null，此时建议使用ISO代码。

使用方法（免费订阅流程）

1. 订阅 BASIC（免费） 套餐（每月1000次请求）。
2. 调用 GET /currencies 接口。
3. 在请求头中携带 X-RapidAPI-Key 和 X-RapidAPI-Host: currency-reference-api-iso-codes-and-names.p.rapidapi.com。
4. 返回的JSON数据包含 count（数量）、base（基准货币）、source（来源）、currencies（货币列表）。

接口示例

GET /currencies

返回约 30种货币加EUR，单条记录格式示例如下：

{"code":"USD","name":"US Dollar","symbol":"$"}

错误处理

API以JSON格式返回错误，包含 error 和 message 字段。可能出现的错误代码包括：

• INVALID_CURRENCY / MISSING_CURRENCY（400，不支持的或缺失的ISO代码，消息会列出所有受支持代码）
• INVALID_DATE（400）
• INVALID_RANGE / RANGE_TOO_WIDE（400）
• INVALID_AMOUNT（400）
• RATE_NOT_AVAILABLE（404，某货币在指定日期无公布汇率）
• NO_DATA（404/503，日期早于ECB历史范围或无数据加载）
• METHOD_NOT_ALLOWED（405）
• QUERY_TOO_LONG（414）

定价方案

• BASIC：$0.00 / 月（免费）
• PRO：$9.00 / 月
• ULTRA：$29.00 / 月
• MEGA：$79.00 / 月

订阅情况

目前该API有 1位订阅用户。