跳转到主要内容
GET
/
v1
/
convert
货币转换
curl --request GET \
  --url https://exchange-rates.cleariflow.com/v1/convert
{
    "base": "EUR",
    "target": "USD",
    "base_amount": 1,
    "converted_amount": 1.160968,
    "exchange_rate": 1.160968,
    "last_updated": 1755806612
}

​
快速开始

​
基础 URL

https://exchange-rates.cleariflow.com/v1/convert

​
验证端点

convert 端点需要您的 API 密钥、基础货币和目标参数来执行货币转换。 
https://exchange-rates.cleariflow.com/v1/convert
? api_key = YOUR_UNIQUE_API_KEY
& base = EUR
& target = USD
此成功请求使用最新汇率将 1 EUR 转换为 USD： 
{
    "base": "EUR",
    "target": "USD",
    "base_amount": 1,
    "converted_amount": 1.160968,
    "exchange_rate": 1.160968,
    "last_updated": 1755806612
}

​
请求参数

​
api_key
String
必填
您的唯一 API 密钥。请注意，每个用户为每个 Cleariflow API 拥有 独立的 API 密钥，因此您的汇率 API 密钥无法用于 IP 地理定位 API，例如。
​
base
String
必填
用于获取最新汇率的基础货币。使用 ISO 4217 货币标准（例如 USD 表示美元），与本 API 中所有货币参数相同。
​
target
String
必填
相对于基础货币要获取汇率的目标货币。与 base 参数一样，此处传递的任何货币均遵循 ISO 4217 标准。请注意，与其他端点不同，convert 一次仅接受一个目标货币。
​
date
String
您要获取汇率的历史日期，格式为 YYYY-MM-DD。若留空，将使用最新可用汇率。
​
base_amount
Float
您要转换为目标货币的基础货币金额。

​
响应参数

API 响应以通用、轻量的 JSON 格式 返回。
​
base
String
用于获取汇率的基础货币。
​
target
String
base_amount 被转换到的目标货币。
​
date
String
根据成功请求提取货币的日期。
​
base_amount
Float
请求中的基础货币金额。
​
converted_amount
Float
base_amount 转换后的目标货币金额。
​
exchange_rate
Float
用于将 base_amount 从基础货币转换为目标货币的汇率。