实时汇率查询换算API提供全球主要货币之间的实时汇率查询和金额换算服务。数据每分钟更新一次。
| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key |
你的API密钥
|
是 | 逗号APIKEY,用户后台首页获取 |
Content-Type |
application/json
|
是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id |
6 |
是 | API接口ID,系统默认 |
endpoint_id |
ep_793fab630bd38eccf48ad9eb3a2a054a |
是 | 端点ID,系统默认 |
method |
POST |
是 | 请求方式,可选值:GET,POST |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
from |
string | 是 | 源货币代码(大写),如:CNY、USD、EUR | |
to |
string | 是 | 目标货币代码(大写),如:USD、JPY、GBP | |
money |
string | 否 | 需要换算的金额,默认为 1。必须大于 0 | |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
success |
boolean | 请求是否成功 | |
data.from |
string | 源货币代码(具体代码见接口详情) | |
data.from_name |
string | 源货币名称(具体名称见接口详情) | |
data.to |
string | 目标货币代码(具体代码见接口详情) | |
data.to_name |
string | 目标货币名称(具体名称见接口详情) | |
data.exchange |
string | 当前汇率(1 源货币 = X 目标货币) | |
data.updatetime |
string | 汇率更新时间 | |
data.money |
string | 换算后的金额 | |
input |
object | 请求时的输入参数回显 | |
generated_at |
string | 接口响应时间 | |
{"success":true,"data":{"from":"CNY","from_name":"人民币","to":"USD","to_name":"美元","exchange":"0.147796","money":"0.147796","updatetime":"2026-07-29 18:28:02"},"input":{"from":"CNY","to":"USD","money":"1"},"generated_at":"2026-07-29 19:12:18"}
HTTP/1.1 400 Bad Request
{
"success": false,
"error": "missing_currency",
"message": "请提供源货币(from)和目标货币(to)参数"
}
本接口用于查询指定基准货币对全球多种货币的实时汇率列表。数据来源为第三方汇率数据服务,由于数据源公布延迟,部分货币可能存在不定滞后,以返回的 updatetime 字段为准
| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key |
你的API密钥
|
是 | 逗号APIKEY,用户后台首页获取 |
Content-Type |
application/json
|
是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id |
6 |
是 | API接口ID,系统默认 |
endpoint_id |
ep_3qdo2l07u_1791776485248 |
是 | 端点ID,系统默认 |
method |
POST |
是 | 请求方式,可选值:GET |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
from |
string | 是 | 基准货币代码,3位大写字母,如 CNY、USD、EUR | |
format |
string | 否 | 返回格式,可选 json(默认)或 txt | |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
data |
object | 成功时返回的数据对象;失败时为 [] | |
data.base |
string | 基准货币代码 | |
data.base_name |
string | 基准货币中文名 | |
data.count |
integer | 返回的货币数量 | |
data.execution_time |
string | 本次请求处理耗时(秒) | |
data.list |
object | 货币汇率列表,以货币代码为键 | |
data.list.{CODE}.name |
string | 货币中文名 | |
data.list.{CODE}.rate |
string | 汇率(字符串,保留原始精度) | |
data.list.{CODE}.updatetime |
string | 该货币汇率更新时间,格式 YYYY-MM-DD HH:MM:SS | |
{"code":0,"msg":"查询成功","data":{"base":"CNY","base_name":"人民币","count":160,"from_cache":false,"list":{"USD":{"name":"美元","rate":"0.149400","updatetime":"2026-10-12 11:24:01"},"EUR":{"name":"欧元","rate":"0.133260","updatetime":"2026-10-12 11:24:49"},"JPY":{"name":"日元","rate":"23.636100","updatetime":"2026-10-12 11:24:51"}}}}
{"code":10001,"msg":"缺少密钥参数 key","data":[]}
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
400 |
400 | missing_currency | 缺少 from 或 to 参数 |
400 |
400 | invalid_money | 金额参数无效 |
401 |
400 | invalid_api_key | API密钥无效或未提供 |
500 |
400 | config_error | 服务配置异常 |
500 |
400 | api_request_failed | 第三方接口请求异常 |
500 |
400 | api_parse_failed | 第三方接口响应解析失败 |
502 |
400 | query_failed | 汇率查询失败 |
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
401 | HTTP 401 | 认证失败 | 请求头中缺少 X-API-Key 或 API Key 无效 |
400 | HTTP 400 | 参数错误 | 缺少必要参数(api_id、endpoint_id、method)或必填业务参数缺失 |
404 | HTTP 404 | 资源不存在 | API不存在、已下架或端点不存在 |
403 | HTTP 403 | 未开通 | 您尚未开通此API,请先开通 |
405 | HTTP 405 | 方法不允许 | 请求方法不在端点允许列表中 |
402 | HTTP 402 | 积分不足 | 账户积分不足以调用该API |
500 | HTTP 500 | 服务器内部错误 | 系统异常 |
代码 | 货币名称 | 代码 | 货币名称 |
|---|---|---|---|
CNY | 人民币 | USD | 美元 |
EUR | 欧元 | JPY | 日元 |
HKD | 港币 | KRW | 韩元 |
RUB | 卢布 | GBP | 英镑 |
SGD | 新加坡元 | TWD | 新台币 |
CAD | 加拿大元 | AUD | 澳大利亚元 |
BRL | 巴西雷亚尔 | INR | 印度卢比 |
CHF | 瑞士法郎 | THB | 泰国铢 |
MOP | 澳门元 | NZD | 新西兰元 |
ZAR | 南非兰特 | SEK | 瑞典克朗 |
IDR | 印尼卢比 | MXN | 墨西哥比索 |
ARS | 阿根廷比索 | MYR | 林吉特 |
OMR | 阿曼里亚尔 | EGP | 埃及镑 |
PKR | 巴基斯坦卢比 | PYG | 巴拉圭瓜拉尼 |
BHD | 巴林第纳尔 | PAB | 巴拿马巴尔博亚 |
BMD | 百慕大元 | BGN | 保加利亚列弗 |
ISK | 冰岛克朗 | PLN | 波兰兹罗提 |
BOB | 玻利维亚诺 | BWP | 博茨瓦纳普拉 |
DKK | 丹麦克朗 | PHP | 菲律宾比索 |
COP | 哥伦比亚比索 | CUP | 古巴比索 |
KZT | 哈萨克斯坦坚戈 | ANG | 荷兰盾 |
GHS | 加纳塞地 | CZK | 捷克克朗 |
ZWL | 津巴布韦元 | QAR | 卡塔尔里亚尔 |
KWD | 科威特第纳尔 | HRK | 克罗地亚库纳 |
KES | 肯尼亚先令 | LVL | 拉脱维亚拉特 |
LAK | 老挝基普 | LBP | 黎巴嫩镑 |
LTL | 立陶宛立特 | RON | 罗马尼亚列伊 |
MUR | 毛里求斯卢比 | MNT | 蒙古图格里克 |
BDT | 孟加拉塔卡 | PEN | 秘鲁新索尔 |
MAD | 摩洛哥迪拉姆 | NOK | 挪威克朗 |
SAR | 沙特里亚尔 | LKR | 斯里兰卡卢比 |
SOS | 索马里先令 | TZS | 坦桑尼亚先令 |
TND | 突尼斯第纳尔 | TRY | 土耳其里拉 |
GTQ | 危地马拉格查尔 | UYU | 乌拉圭比索 |
HUF | 匈牙利福林 | JMD | 牙买加元 |
ILS | 以色列谢克尔 | JOD | 约旦第纳尔 |
VND | 越南盾 | CLP | 智利比索 |
PGK | 巴布亚新几内亚基那 | KPW | 朝鲜圆 |
LSL | 莱索托洛提 | LYD | 利比亚第纳尔 |
RWF | 卢旺达法郎 | MMK | 缅甸元 |
MWK | 马拉维克瓦查 | NIO | 尼加拉瓜科多巴 |
NPR | 尼泊尔卢比 | SBD | 所罗门群岛元 |
SCR | 塞舌尔法郎 | BND | 文莱元 |
SYP | 叙利亚镑 | DZD | 阿尔及利亚第纳尔 |
AED | 阿联酋迪拉姆 | BBD | 巴巴多斯元 |
AFN | 阿富汗尼 | ALL | 阿尔巴尼亚勒克 |
AMD | 亚美尼亚德拉姆 | AOA | 安哥拉宽扎 |
AWG | 阿鲁巴盾弗罗林 | AZN | 阿塞拜疆新马纳特 |
BAM | 波斯尼亚马尔卡 | BIF | 布隆迪法郎 |
BSD | 巴哈马元 | BTN | 不丹努扎姆 |
BYN | 白俄罗斯卢布 | BZD | 伯利兹美元 |
CDF | 刚果法郎 | CRC | 哥斯达黎加科朗 |
CUC | 古巴可兑换比索 | CVE | 佛得角埃斯库多 |
DJF | 吉布提法郎 | DOP | 多明尼加比索 |
NGN | 尼日利亚奈拉 | ERN | 厄立特里亚纳克法 |
ETB | 埃塞俄比亚比尔 | FJD | 斐济元 |
FKP | 福克兰镑 | GEL | 格鲁吉亚拉里 |
GIP | 直布罗陀镑 | GMD | 冈比亚达拉西 |
GNF | 几内亚法郎 | GYD | 圭亚那元 |
HNL | 洪都拉斯伦皮拉 | HTG | 海地古德 |
IQD | 伊拉克第纳尔 | IRR | 伊朗里亚尔 |
KGS | 吉尔吉斯斯坦索姆 | KHR | 柬埔寨瑞尔 |
KMF | 科摩罗法郎 | KYD | 开曼群岛元 |
LRD | 利比里亚元 | MDL | 摩尔多瓦列伊 |
MGA | 马尔加什阿里亚 | MKD | 马其顿第纳尔 |
MVR | 马尔代夫拉菲亚 | MZN | 新莫桑比克梅蒂卡尔 |
NAD | 纳米比亚元 | RSD | 塞尔维亚第纳尔 |
SDG | 苏丹镑 | SHP | 圣圣赫勒拿镑 |
SLL | 塞拉利昂利昂 | SRD | 苏里南元 |
STD | 圣多美多布拉 | SZL | 斯威士兰里兰吉尼 |
TJS | 塔吉克斯坦索莫尼 | TMT | 土库曼斯坦马纳特 |
TOP | 汤加潘加 | TTD | 特立尼达多巴哥元 |
UAH | 乌克兰格里夫纳 | UGX | 乌干达先令 |
UZS | 乌兹别克斯坦苏姆 | VEF | 委内瑞拉玻利瓦尔 |
VUV | 瓦努阿图瓦图 | WST | 萨摩亚塔拉 |
XAF | 中非法郎 | XCD | 东加勒比元 |
XOF | 西非法郎 | XPF | 太平洋法郎 |
YER | 也门里亚尔 | ZMW | 赞比亚克瓦查 |
SVC | 萨尔瓦多科朗 | MRU | 毛里塔尼亚乌吉亚 |
浙公网安备 33059102000262号