跳转到主要内容
GET
货币符号

快速开始

基础 URL

验证端点

symbols 端点是汇率服务中最简单的 API 调用,只需 API 密钥即可检索完整可用货币符号列表。
此成功请求返回所有可用货币符号及其对应描述:

请求参数

api_key
String
必填
您的唯一 API 密钥。请注意,每个用户为每个 Cleariflow API 拥有 独立的 API 密钥,因此您的汇率 API 密钥无法用于 IP 地理定位 API,例如。

响应参数

API 响应以通用、轻量的 JSON 格式 返回。
currencies
Object
JSON 对象,以所有可用货币符号为键,完整描述为值。包括传统法定货币(USD、EUR、GBP 等)和流行加密货币(BTC、ETH 等)。
last_updated
Integer
货币符号从数据源最后更新的 Unix 时间戳。

使用场景

获取所有可用货币

symbols 端点非常适合:
  • 动态 UI 生成:在应用中填充下拉菜单或货币选择器
  • 货币验证:在发起汇率请求前检查货币代码是否受支持
  • 货币发现:探索汇率 API 中所有可用货币
  • 应用初始化:使用完整支持货币列表初始化应用

使用示例:货币选择器

支持的货币

汇率 API 支持 80 多种货币,包括:
  • 主要法定货币:USD、EUR、GBP、JPY、AUD、CAD、CHF、CNY
  • 欧洲货币:SEK、NOK、DKK、PLN、CZK、HUF、RON、BGN、HRK、ISK
  • 亚洲货币:KRW、SGD、HKD、TWD、MYR、PHP、THB、IDR、INR、ILS
  • 美洲货币:BRL、MXN、ARS
  • 非洲货币:ZAR、MAD、DZD
  • 加密货币:BTC、ETH、BNB、DOGE、XRP、BCH、LTC
所有货币代码遵循 ISO 4217 标准,确保国际兼容性。