汇率接口
533
2022-09-06
汇率查询，货币汇率
实时金融汇率查询接口，例如可以查询人民币互兑美元、欧元等价格及常见国家货币的实时汇率等。
- 十大银行汇率表
、
- 汇率查询API接口支持的所有币种列表
接口地址：http://api.tianapi.com/fxrate/index
请求示例：http://api.tianapi.com/fxrate/index?key=APIKEY&fromcoin=USD&tocoin=CNY&money=1
支持协议：http/https
请求方式：get/post
返回格式：utf-8 json
▼ 接口信息
▼ 请求参数
post方式请求时，enctype应为application/x-www-form-urlencoded
上传文件二进制数据流方式，enctype必须为multipart/form-data
参数url、base64中有特殊字符时，建议对值urlencode编码后传递
| 名称 | 类型 | 必填 | 示例值/默认值 | 说明 |
|---|---|---|---|---|
| key | string | 是 | 您自己的APIKEY（注册账号后获得） | api密钥 |
| fromcoin | string | 是 | USD | 来源货币，例如美元USD |
| tocoin | string | 是 | CNY | 目标兑换货币，例如人民币CNY |
| money | int | 是 | 1 | 兑换金额，单位元 |
▼ 返回示例
返回示例作为参考，建议以实际测试结果为准
{ "code": 200, "msg": "success", "newslist": [
{ "money": "7.0752"
}
]
}▼ 返回参数
| 名称 | 类型 | 示例值 | 说明 |
|---|---|---|---|
| money | string | 7.0752 | 金额价格，单位元 |
▼ 接口价格
| 用户等级 | 免费接口数 | 每日赠送次数 | 会员价格 | 说明 |
|---|---|---|---|---|
| 免费会员 | 10个 | 100次 | 免费 | 每个免费接口每天赠送100次 |
| 高级会员 | 不限 | 1万次 | 20元/月、120元/年 | 每个免费接口每天赠送1W次 |
| 黄金会员 | 不限 | 50万次 | 65元/月、390元/年 | 每个免费接口每天赠送50W次 |
| 提示：系统优先使用赠送额度，超出后每次调用消耗1颗天豆（0.0001元），如项目有更高需求请点此升级会员等级。 | ||||
▼ 错误状态码
错误消息可能会有所调整，请根据错误代码进行流程判断
| 错误代码 | 错误消息 | 解释帮助 |
|---|---|---|
| 100 | 内部服务器错误 | 报此错误码请及时反馈或等待官方修复 |
| 110 | 当前API已下线 | 接口已下线无法使用，可关注相关通知 |
| 120 | API暂时维护中 | 接口暂时关闭维护中，请注意相关公告 |
| 130 | API调用频率超限 | 超过每秒请求数上限，可在控制台-接口管理中查询 |
| 140 | API没有调用权限 | 请检查是否自行在接口管理中停用或被禁用了该接口 |
| 150 | API可用次数不足 | 账号余额不足以调用接口，请在控制台中查看 |
| 160 | 账号未申请该API | 请先在接口文档页面申请该接口，点此查看说明 |
| 170 | Referer请求来源受限 | 设置了Referer白名单，但来源Referer不在白名单内 |
| 180 | IP请求来源受限 | 设置了IP白名单，但来源IP不在白名单内 |
| 190 | 当前key已限制使用 | 通常为账号被限制使用，此状态无法恢复 |
| 230 | key错误或为空 | 请检查apikey是否填写错误，点此查看帮助 |
| 240 | 缺少key参数 | 请检查是否传递了key参数或者编码格式是否符合要求 |
| 250 | 数据返回为空 | 数据查询或转换失败，请检查输入值或注意中文编码问题 |
| 260 | 参数值不得为空 | 请检查关键参数是否传递了空值 |
| 270 | 参数值不符合要求 | 参数值不符合基本格式要求，点此查看说明 |
| 280 | 缺少必要的参数 | 缺少必填的参数，请根据接口文档检查 |
| 290 | 超过最大输入字节限制 | 超出最大字符限制，请查看接口文档的说明 |
| 1开头的是系统级错误，2开头的是用户级错误，其中200代码表示请求成功处理并计费。 | ||
返回格式：json
请求方式：get
请求示例：http://web.juhe.cn/finance/exchange/rmbquot?key=您申请的APPKEY
接口备注：100外币兑人民币，更新时间2分钟，此汇率仅供参考，以中国银行各分行实际交易汇率为准，不构成投资建议。投资者据此买卖，风险自担
API测试工具
请求Header：
| 名称 | 值 | |
|---|---|---|
| Content-Type | application/x-www-form-urlencoded |
请求参数说明：
| 名称 | 必填 | 类型 | 说明 | |
|---|---|---|---|---|
| key | 是 | String | APP Key | |
| type | 否 | int | 两种格式(0或者1,默认为0) | |
| bank | 否 | int | (0:工商银行,1:招商银行,2:建设银行,3:中国银行,4:交通银行,5:农业银行,默认为:0) |
返回参数说明：
| 名称 | 类型 | 说明 | |
|---|---|---|---|
| 见JSON返回示例 | - | - |
JSON返回示例：JSON在线格式化工具
{"resultcode":"200","reason":"SUCCESSED!","result":[
{ "data1":{ "name":"英镑", /*货币名称*/
"fBuyPri":"1001.430", /*现汇买入价*/
"mBuyPri":"970.510", /*现钞买入价*/
"fSellPri":"1009.480", /*现汇卖出价*/
"mSellPri":"1009.480", /*现钞卖出价*/
"bankConversionPri":"1014.870", /*银行折算价/中间价*/
"date":"2012-12-13", /*发布日期*/
"time":"16:25:49" /*发布时间*/
}, "data2":{ "name":"港币", "fBuyPri":"80.210", "mBuyPri":"79.570", "fSellPri":"80.520", "mSellPri":"80.520", "bankConversionPri":"81.140", "date":"2012-12-13", "time":"16:25:49"
}, "data3":{ "name":"美元", "fBuyPri":"621.650", "mBuyPri":"616.670", "fSellPri":"624.150", "mSellPri":"624.150", "bankConversionPri":"628.870", "date":"2012-12-13", "time":"16:25:49"
}, "data4":{ "name":"瑞士法郎", "fBuyPri":"670.310", "mBuyPri":"649.620", "fSellPri":"675.700", "mSellPri":"675.700", "bankConversionPri":"674.350", "date":"2012-12-13", "time":"16:25:49"
}, "data5":{ "name":"新加坡元", "fBuyPri":"508.300", "mBuyPri":"492.610", "fSellPri":"512.390", "mSellPri":"512.390", "bankConversionPri":"512.000", "date":"2012-12-13", "time":"16:25:49"
}, "data6":{ "name":"瑞典克朗", "fBuyPri":"93.340", "mBuyPri":"90.450", "fSellPri":"94.090", "mSellPri":"94.090", "bankConversionPri":"93.770", "date":"2012-12-13", "time":"16:25:49"
}, "data7":{ "name":"丹麦克朗", "fBuyPri":"108.920", "mBuyPri":"105.550", "fSellPri":"109.790", "mSellPri":"109.790", "bankConversionPri":"109.430", "date":"2012-12-13", "time":"16:25:49"
}, "data8":{ "name":"挪威克朗", "fBuyPri":"110.490", "mBuyPri":"107.080", "fSellPri":"111.380", "mSellPri":"111.380", "bankConversionPri":"111.060", "date":"2012-12-13", "time":"16:25:49"
}, "data9":{ "name":"日元", "fBuyPri":"7.431", "mBuyPri":"7.201", "fSellPri":"7.483", "mSellPri":"7.483", "bankConversionPri":"7.531", "date":"2012-12-13", "time":"16:25:49"
}, "data10":{ "name":"加拿大元", "fBuyPri":"630.950", "mBuyPri":"611.470", "fSellPri":"636.010", "mSellPri":"636.010", "bankConversionPri":"638.800", "date":"2012-12-13", "time":"16:25:49"
}, "data11":{ "name":"澳大利亚元", "fBuyPri":"654.900", "mBuyPri":"634.680", "fSellPri":"660.160", "mSellPri":"660.160", "bankConversionPri":"663.300", "date":"2012-12-13", "time":"16:25:49"
}, "data12":{ "name":"欧元", "fBuyPri":"812.520", "mBuyPri":"787.430", "fSellPri":"819.040", "mSellPri":"819.040", "bankConversionPri":"821.960", "date":"2012-12-13", "time":"16:25:49"
}, "data13":{ "name":"澳门元", "fBuyPri":"77.910", "mBuyPri":"75.300", "fSellPri":"78.210", "mSellPri":"80.720", "bankConversionPri":"78.320", "date":"2012-12-13", "time":"16:25:49"
}, "data14":{ "name":"菲律宾比索", "fBuyPri":"15.100", "mBuyPri":"14.640", "fSellPri":"15.220", "mSellPri":"15.690", "bankConversionPri":"15.220", "date":"2012-12-13", "time":"16:25:49"
}, "data15":{ "name":"泰国铢", "fBuyPri":"20.240", "mBuyPri":"19.620", "fSellPri":"20.400", "mSellPri":"21.030", "bankConversionPri":"20.390", "date":"2012-12-13", "time":"16:25:49"
}, "data16":{ "name":"新西兰元", "fBuyPri":"524.400", "mBuyPri":"0.000", "fSellPri":"528.610", "mSellPri":"0.000", "bankConversionPri":"526.770", "date":"2012-12-13", "time":"16:25:49"
}, "data17":{ "name":"韩国元", "fBuyPri":"0.000", "mBuyPri":"0.560", "fSellPri":"0.000", "mSellPri":"0.608", "bankConversionPri":"0.586", "date":"2012-12-13", "time":"16:25:49"
}
}
]
}版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。
相关文章
发表评论
暂时没有评论，来抢沙发吧~