全球货币汇率官方文档解读
开发者APIKEY:bed5472bfc40e344440f0856e94541e7
FIXER首页:https://fixer.io/product
FIXER开发文档中心:https://fixer.io/documentation
API的URL:https://data.fixer.io/api/
请求认证必要格式:https://data.fixer.io/api/接口名?access_token=API_KEY
接口使用说明
接口是根据个人订阅计划划分的,个人推荐付费使用,国外还有XE也是类似Fixer的,XE收费便宜0.1美元,国内封装的货币汇率像极速、聚合数据接口封装的都不行,这两家的汇率数据跟新浪在岸有10-30分钟的延迟,而新浪在岸跟XE、Fixer上的货币汇率又有接近30-60分钟的延迟。推荐国外的接口汇率都是比较实时的,追求最新汇率不缺钱的企业可以使用Fixer、XE,为了省钱可以使用极速和聚合的汇率接口,但不稳定,使用极速数据接口的话不想付费可以多注册几个账号,拿到全部appkey,代码中轮询也可以,因为每个极速号免费每天调用100次。
|
Free免费的($/m)
|
Basic基础套餐(10$/m)
|
Professional专业套餐(40$/m)
|
Professional plus高级套餐(80$/m)
|
|
0.1w次/月
|
10w次/月
|
10w次/月
|
50w/月
|
|
每1h更新一次实时数据
|
每1h更新一次实时数据
|
每10m更新一次实时数据
|
每分60s更新一次实时数据
|
|
支持有限
|
高级支持
|
高级支持
|
高级支持
|
|
历史数据
|
历史数据
|
历史数据
|
历史数据
|
|
|
SSL加密
|
SSL加密
|
SSL加密
|
|
|
可以使用所有基础货币
|
可以使用所有基础货币
|
可以使用所有基础货币
|
|
|
支持自定义汇率转换
|
支持自定义汇率转换
|
支持自定义汇率转换
|
|
|
|
支持时间序列汇率功能
|
支持时间序列汇率功能
|
|
|
|
|
支持波动汇率功能
|
接口使用
以欧元(EUR)为基本货币实时获取其他170种货币汇率接口
URL:https://data.fixer.io/api/latest?access_key=APIKEY
|
请求参数
|
类型
|
参考值
|
说明
|
|
access_key
|
String
|
Xxxx
|
你的API_KEY
|
|
返回参数
|
说明
|
|
|
|
success
|
请求状态
|
|
|
|
timestamp
|
返回收集给定速率的确切日期时间(UNIX时间戳)
|
|
|
|
base
|
基础货币
|
|
|
|
date
|
请求响应日期
|
|
|
|
rates
|
实时汇率
|
|
|
返回值:
{
"success": true,
"timestamp": 1565832306,
"base": "EUR",
"date": "2019-08-15",
"rates": {
"AED": 4.093629,
"AFN": 87.77822,
"ALL": 121.091662,
"AMD": 531.943271,
"ANG": 1.995777,
"AOA": 403.453997,
"ARS": 67.138739,
"AUD": 1.648899,
"AWG": 2.006028,
"AZN": 1.900103,
"BAM": 1.956045,
"BBD": 2.257561}}
指定函数名方式,将API请求接口返回封装到自定义函数API响应中
URL:https://data.fixer.io/api/latest?access_key=APIKEY&callback=函数名
|
请求参数
|
类型
|
参考值
|
说明
|
|
access_key
|
String
|
Xxxx
|
你的API_KEY
|
|
callback
|
String
|
MY-FUNCTION
|
自定义函数名称
|
|
返回参数
|
说明
|
|
|
|
success
|
请求状态
|
|
|
|
timestamp
|
返回收集给定速率的确切日期时间(UNIX时间戳)
|
|
|
|
base
|
基础货币
|
|
|
|
date
|
请求响应日期
|
|
|
|
rates
|
实时汇率
|
|
|
返回值:
{
"success": true,
"timestamp": 1519296206,
"base": "EUR",
"date": "2019-08-15",
"rates": {
"AUD": 1.566015,
"CAD": 1.560132,
"CHF": 1.154727,
"CNY": 7.827874,
"GBP": 0.882047,
"JPY": 132.360679,
"USD": 1.23396,
[...]
}
}
获取全世界三个字母的货币信息
URL:https://data.fixer.io/api/symbols?access_key=APIKEY
|
请求参数
|
类型
|
参考值
|
说明
|
|
access_key
|
string
|
xxxxxx
|
你自己的API_KEY
|
|
返回参数
|
说明
|
|
|
|
success
|
响应成功
|
|
|
|
symbols
|
三个字母的货币名称
|
|
|
返回JSON:
{
"success": true,
"symbols": {
"AED": "United Arab Emirates Dirham",
"AFN": "Afghan Afghani",
"ALL": "Albanian Lek",
"AMD": "Armenian Dram",
[...]
}
}
自定义基础货币转换获得指定货币汇率
URL:https://data.fixer.io/api/latest?access_key=APIKEY&base=xxx &symbols=xxx,xxx,xxx,…
|
请求参数
|
类型
|
参考值
|
说明
|
|
access_key
|
String
|
xxxxx
|
你自己的API_KEY
|
|
base
|
String
|
ALL
|
自定义基础货币
|
|
symbols
|
String
|
CNY,USD
|
指定货币(可多个)
|
|
返回值
|
说明
|
|
|
|
success
|
请求状态
|
|
|
|
timestamp
|
返回收集给定速率的确切日期时间(UNIX时间戳)
|
|
|
|
base
|
基础货币
|
|
|
|
date
|
请求响应日期
|
|
|
|
rates
|
实时汇率
|
|
|
返回值:
{
"success": true,
"timestamp": 1519296206,
"base": "USD",
"date": "2019-08-15",
"rates": {
"GBP": 0.72007,
"JPY": 107.346001,
"EUR": 0.813399,
}
}
根据自定义历史时间获取自定义基础货币换算指定货币汇率
URL:
https://data.fixer.io/api/2013-12-25?access_key=APIKEY&base=xxx &symbols=xxx,xxx,xxx,…
|
请求参数
|
类型
|
参考值
|
说明
|
|
access_key
|
String
|
xxxxx
|
你自己的API_KEY
|
|
base
|
String
|
USD
|
自定义基础货币
|
|
symbols
|
String
|
BBD,CNY
|
指定货币(可多个)
|
|
返回值
|
说明
|
|
|
|
success
|
请求状态
|
|
|
|
historical
|
历史汇率请求状态true/false
|
|
|
|
timestamp
|
返回收集给定速率的确切日期时间(UNIX时间戳)
|
|
|
|
base
|
基础货币
|
|
|
|
date
|
请求响应日期
|
|
|
|
rates
|
实时汇率
|
|
|
返回JSON:
{
"success": true,
"historical": true,
"date": "2013-12-24",
"timestamp": 1387929599,
"base": "GBP",
"rates": {
"USD": 1.636492,
"EUR": 1.196476,
"CAD": 1.739516
}
}
注意:没有指定基础货币情况下,默认的是EUR欧元进行其他货币换算
指定两种货币直接进行汇率换算
URL:https://data.fixer.io/api/convert?access_key=APIKEY&from=xxx &to=xxx&amount=xxx
|
请求参数
|
类型
|
参考值
|
说明
|
|
access_key
|
String
|
xxxxx
|
你自己的API_KEY
|
|
base
|
String
|
|
自定义基础货币
|
|
amount
|
String
|
21
|
货币金额
|
|
from
|
String
|
CNY
|
你要转换的三个字母的货币码
|
|
to
|
String
|
USD
|
要转换为的三个字母的货币码
|
|
返回参数
|
说明
|
|
|
|
success
|
请求状态
|
|
|
|
query
|
要进行转换的查询条件
|
|
|
|
Info
|
返回收集给定速率的确切日期时间(UNIX时间戳)和汇率
|
|
|
|
historical
|
基础货币
|
|
|
|
date
|
请求响应日期
|
|
|
|
result
|
根据金额*汇率得到的总额
|
|
|
返回JSON:
{
"success": true,
"query": {
"from": "GBP",
"to": "JPY",
"amount": 25
},
"info": {
"timestamp": 1519328414,
"rate": 148.972231
},
"historical": ""
"date": "2018-02-22"
"result": 3724.305775
}
根据时间区间获得一段时间的汇率
URL:https://data.fixer.io/api/timeseries?access_key=APIKEY&start_date=2012-05-01 &end_date=2012-05-25
|
请求参数
|
类型
|
参考值
|
说明
|
|
access_key
|
String
|
xxxxx
|
你自己的API_KEY
|
|
start_date
|
String
|
2018-02-01
|
开始时间
|
|
start_date
|
String
|
2018-02-05
|
结束时间
|
|
返回参数
|
说明
|
|
|
|
success
|
请求状态
|
|
|
|
timeseries
|
返回收集给定速率的确切日期时间(UNIX时间戳)
|
|
|
|
start_date
|
开始时间
|
|
|
|
end_date
|
结束时间
|
|
|
|
base
|
基础货币
|
|
|
|
rates
|
汇率
|
|
|
返回JSON
{
"success": true,
"timeseries": true,
"start_date": "2012-05-01",
"end_date": "2012-05-03",
"base": "EUR",
"rates": {
"2012-05-01":{
"USD": 1.322891,
"AUD": 1.278047,
"CAD": 1.302303
},
"2012-05-02": {
"USD": 1.315066,
"AUD": 1.274202,
"CAD": 1.299083
},
"2012-05-03": {
"USD": 1.314491,
"AUD": 1.280135,
"CAD": 1.296868
},
[...]
}
}
查看一段时间内的货币汇率波动
URL:https://data.fixer.io/api/fluctuation?access_key=APIKEY&start_date=2012-05-01 &end_date=2012-05-25
|
请求参数
|
类型
|
参考值
|
说明
|
|
access_key
|
String
|
xxxxx
|
你自己的API_KEY
|
|
start_date
|
String
|
2018-02-01
|
开始时间
|
|
start_date
|
String
|
2018-02-05
|
结束时间
|
|
返回参数
|
说明
|
|
|
|
success
|
请求状态
|
|
|
|
fluctuation
|
向波动端点发送波动请求
|
|
|
|
start_date
|
开始时间
|
|
|
|
end_date
|
结束时间
|
|
|
|
base
|
基础货币
|
|
|
|
rates
|
汇率
|
|
|
|
change
|
改变后
|
|
|
|
change_pct
|
波动值
|
|
|
返回JSON
{
"success":true,
"fluctuation":true,
"start_date":"2018-02-25",
"end_date":"2018-02-26",
"base":"EUR",
"rates":{
"USD":{
"start_rate":1.228952,
"end_rate":1.232735,
"change":0.0038,
"change_pct":0.3078
},
"JPY":{
"start_rate":131.587611,
"end_rate":131.651142,
"change":0.0635,
"change_pct":0.0483
},
[...]
}
}
调用次数达到次数限制
{
"success": false,
"error": {
"code": 104,
"info": "Your monthly API request volume has been reached. Please upgrade your plan."
}
}
|