快速接入Fixer全球货币汇率api(按照官方解读)

全球货币汇率官方文档解读

开发者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."   
  }
}