提供全球 168 种法定货币和主流数字货币的实时汇率查询与换算,数据来源于国际外汇市场权威报价,每 5 分钟更新一次,支持正向与反向换算、历史汇率回溯,适用于跨境电商、财务结算、出境旅行等场景。
汇率查询 API 通过标准 HTTP GET 请求返回 JSON 格式的汇率数据。支持按 ISO 4217 货币代码指定源币种与目标币种,可传入金额直接返回换算结果。同时支持查询指定历史日期的汇率,返回字段涵盖汇率、换算结果、日涨跌幅等信息。接口全程 HTTPS 加密传输,支持高并发调用。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| apikey | string | 是 | 用户身份密钥,在控制台「应用管理」中创建应用后获取。 |
| from | string | 是 | 源币种代码(ISO 4217),如 USD、EUR、JPY。 |
| to | string | 是 | 目标币种代码(ISO 4217),如 CNY、GBP、HKD。 |
| amount | float | 否 | 换算金额,默认为 1。传入具体金额可直接获得换算结果。 |
| date | string | 否 | 历史日期,格式 yyyy-MM-dd,不填则返回实时汇率。 |
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,200 表示请求成功,其余见错误码对照表。 |
| msg | string | 状态描述信息。 |
| data.from | string | 源币种代码。 |
| data.to | string | 目标币种代码。 |
| data.rate | float | 汇率值。 |
| data.amount | float | 换算的原始金额。 |
| data.result | float | 换算后金额。 |
| data.fluctuation | string | 日涨跌幅,如「+0.12%」。 |
| data.update_time | string | 数据更新时间,格式 yyyy-MM-dd HH:mm:ss。 |
{
"code": 200,
"msg": "success",
"data": {
"from": "USD",
"to": "CNY",
"rate": 7.2635,
"amount": 1,
"result": 7.2635,
"fluctuation": "+0.12%",
"update_time": "2026-07-25 15:30:00"
}
}