基础汇率

汇率查询,历史汇率、人民币外汇牌价、银联国际汇率等
接口编号: 600接口名称: 汇率查询连接应用: 3416个
应用编号: 120001应用标识: finance.rate服务商: NowAPI

说明

根据相关币别编号查询对应汇率,数据以 1美元(USD) 作为基准
数据更新: 免费用户:2分钟  付费用户:10-15秒
测试示例: http://api.k780.com/?app=finance.rate&scur=USD&tcur=CNY&appkey=10003&sign=b59bc3ef6191eb9f747dd4e83c99f2a4 (示例中sign会不定期调整)

更新
2018-09-21 支持多币种查询,一对多、多对一或多对多查询。

请求方式

Get/Post

请求url

 HTTP: http://api.k780.com
HTTPS: https://sapi.k780.com

请求参数

参数 类型 是否必须 备注
scur string 原币种编号,多个用逗号隔开,支持一对多、多对一、多对多查询.
例: &scur=cny&tcur=usd 或 &scur=usd&tcur=cny,aed,cad 或 &scur=cny,aed,cad&tcur=usd,cny,aed
支持币种: Json格式
(注:单次查询多个会按多个扣量)
tcur string 目标币种编号,多个用逗号隔开,支持一对多、多对一、多对多查询.
例: &scur=cny&tcur=usd 或 &scur=usd&tcur=cny,aed,cad 或 &scur=cny,aed,cad&tcur=usd,cny,aed
支持币种: Json格式
(注:单次查询多个会按多个扣量)
appkey string 使用API的唯一凭证 获取
sign string md5后的32位密文,登陆用. 获取
format {json|xml} 返回数据格式
jsoncallback string js跨域使用jsonp时可使用此参数

Json请求示例

http://api.k780.com/?app=finance.rate&scur=USD&tcur=CNY&appkey=APPKEY&sign=SIGN&format=json

JsonP请求示例

http://api.k780.com/?app=finance.rate&scur=USD&tcur=CNY&appkey=APPKEY&sign=SIGN&format=json&jsoncallback=data

Xml请求示例

http://api.k780.com/?app=finance.rate&scur=USD&tcur=CNY&appkey=APPKEY&sign=SIGN&format=xml

Json返回示例

1.成功
{
    "success": "1",
    "result": {
        "status": "ALREADY",
        "scur": "USD", /*原币种*/
        "tcur": "CNY", /*目标币种*/
        "ratenm": "美元/人民币",
        "rate": "6.5793", /*汇率结果(保留6位小数四舍五入) */
        "update": "2016-06-24 08:30:37" /*数据更新时间*/
    }
}
2.成功(一对多/多对一/多对多)
{
    success: "1",
    result: {
        status: "ALREADY",
        totline: "3",
        scur_s: "USD,USD,USD",
        tcur_s: "CNY,AED,CAD",
        lists: [
        {
            scur: "USD",
            tcur: "CNY",
            ratenm: "美元/人民币",
            rate: "6.709700",
            update: "2019-03-25 23:29:00"
        },
        {
            scur: "USD",
            tcur: "AED",
            ratenm: "美元/阿联酋迪拉姆",
            rate: "3.672700",
            update: "2019-03-26 08:12:03"
        },
        {
            scur: "USD",
            tcur: "CAD",
            ratenm: "美元/加拿大元",
            rate: "1.338900",
            update: "2019-03-26 08:50:24"
        }
        ]
    }
}

2.异常
{
    "success":"0",
    "msgid":"...",
    "msg":"..."
}

示例代码

<?php
header("Content-Type:text/html;charset=UTF-8");
function nowapi_call($a_parm){
    if(!is_array($a_parm)){
        return false;
    }
    //combinations
    $a_parm['format']=empty($a_parm['format'])?'json':$a_parm['format'];
    $apiurl=empty($a_parm['apiurl'])?'http://api.k780.com/?':$a_parm['apiurl'].'/?';
    unset($a_parm['apiurl']);
    foreach($a_parm as $k=>$v){
        $apiurl.=$k.'='.$v.'&';
    }
    $apiurl=substr($apiurl,0,-1);
    if(!$callapi=file_get_contents($apiurl)){
        return false;
    }
    //format
    if($a_parm['format']=='base64'){
        $a_cdata=unserialize(base64_decode($callapi));
    }elseif($a_parm['format']=='json'){
        if(!$a_cdata=json_decode($callapi,true)){
            return false;
        }
    }else{
        return false;
    }
    //array
    if($a_cdata['success']!='1'){
        echo $a_cdata['msgid'].' '.$a_cdata['msg'];
        return false;
    }
    return $a_cdata['result'];
}

$nowapi_parm['app']='finance.rate';
$nowapi_parm['scur']='USD';
$nowapi_parm['tcur']='CNY';
$nowapi_parm['appkey']='APPKEY';
$nowapi_parm['sign']='SIGN';
$nowapi_parm['format']='json';
$result=nowapi_call($nowapi_parm);
var_dump($result);
print_r($result);

#python
import json,urllib
from urllib import urlencode

url = 'http://api.k780.com'
params = {
  'app' : 'finance.rate',
  'scur' : 'USD',
  'tcur' : 'CNY',
  'appkey' : 'APPKEY',
  'sign' : 'SIGN',
  'format' : 'json',
}
params = urlencode(params)

f = urllib.urlopen('%s?%s' % (url, params))
nowapi_call = f.read()
#print content
a_result = json.loads(nowapi_call)
if a_result:
  if a_result['success'] != '0':
    print a_result['result'];
  else:
    print a_result['msgid']+' '+a_result['msg']
else:
  print 'Request nowapi fail.';

import java.net.*;
import java.io.*;

public class test{
    public static void main(String args[]) throws Exception {
        URL u=new URL("http://api.k780.com/?app=finance.rate&scur=USD&tcur=CNY&appkey=APPKEY&sign=SIGN&format=json");
        InputStream in=u.openStream();
        ByteArrayOutputStream out=new ByteArrayOutputStream();
        try {
            byte buf[]=new byte[1024];
            int read = 0;
            while ((read = in.read(buf)) > 0) {
                out.write(buf, 0, read);
            }
        }  finally {
            if (in != null) {
                in.close();
            }
        }
        byte b[]=out.toByteArray( );
        System.out.println(new String(b,"utf-8"));
    }
}

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title></title>
<script type="text/javascript" src="https://www.nowapi.com/style/jquery/1.11.3/jquery.min.js"></script>
<script>
$(document).ready(function(){
     $.ajax({
        type          : 'get',
        async         : false,
        url           : 'http://api.k780.com/?app=finance.rate&scur=USD&tcur=CNY&appkey=APPKEY&sign=SIGN&format=json&jsoncallback=data',
        dataType      : 'jsonp',
        jsonp         : 'callback',
        jsonpCallback : 'data',
        success       : function(data){
            if(data.success!='1'){
                alert(data.msgid+' '+data.msg);
                exit;
            }
            //遍历
            var description = "";
            for(var i in data.result){
                var property=data.result[i];
                description+=i+" = "+property+"\n";
            }
            alert(description);
        },
        error:function(){
            alert('fail');
        }
    });
});
</script>
</head>
<body>
</body>
</html>

curl "http://api.k780.com/?app=finance.rate&scur=USD&tcur=CNY&appkey=APPKEY&sign=SIGN&format=json"

流量包套餐

10元/10000次;买多少用多少,多买有优惠,10元起买,适合大多数应用场景。 费用计算

包月套餐

48.00元每月/每小时200次调用配额;200次配额起买,适合调用量比较平均的高频应用场景。 费用计算

免费试用

每小时50次配额;每秒1次并发限制,商用请选择付费套餐。 (系统繁忙或极端情况下,优先保证付费用户使用) 马上试用

客户服务

客服QQ: 1597000273 

客服微信:

商务合作/大客户

362705971 

数据定制

定制接口、定制数据格式、采集等;联系请提供数据样式范本。1597000273 

意见反馈