基础汇率

汇率查询,历史汇率、人民币外汇牌价、银联国际汇率等
接口编号: 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会不定期调整)

调用方式

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格式
(注:单次查询多个会按多个扣量)
ag string 扩展栏位 openPrice,yesyPrice,highPrice,lowPrice,changePrice,changeMargin
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"

包月套餐说明:

适合调用量比较平均的高频应用场景;有配额限制,超出配额会被暂停调用1小时,请留意购买足够配额.

规格套餐名称价格描述
101200 次配额/每小时48 元/月-
102400 次配额/每小时87 元/月省¥ 9 享9.8折
103600 次配额/每小时130 元/月省¥ 14 享9.5折
1041000 次配额/每小时218 元/月省¥ 22 享9折
1052000 次配额/每小时439 元/月省¥ 41 享8.5折
1064000 次配额/每小时883 元/月省¥ 77 享8折
1076000 次配额/每小时1332 元/月省¥ 108 享7.5折
1088000 次配额/每小时1786 元/月省¥ 134 享7折
10910000 次配额/每小时2244 元/月省¥ 156 享6.5折
11020000 次配额/每小时4800 元/月-
立即开通

流量包套餐说明:

买多少用多少,多买有优惠,10元起买,适合大多数应用场景.

规格套餐名称价格描述
201流量包 10000 次10 元-
202流量包 105000 次100 元含 5000 次赠送流量
203流量包 212000 次200 元含 12000 次赠送流量
204流量包 321000 次300 元含 21000 次赠送流量
205流量包 545000 次500 元含 45000 次赠送流量
206流量包 1100000 次1000 元含 100000 次赠送流量
207流量包 2220000 次2000 元含 220000 次赠送流量
208流量包 3360000 次3000 元含 360000 次赠送流量
209流量包 5750000 次5000 元含 750000 次赠送流量
210流量包 12000000 次10000 元含 2000000 次赠送流量
立即开通

免费试用套餐说明:

商用请选择付费套餐。 (系统繁忙或极端情况下,优先保证付费用户使用).

规格套餐名称价格描述
0免费套餐 50 次配额/每小时0 元/月可免费试用套餐3个月.
立即开通

客户服务

客服QQ: 1486133340 
QQ群8: 204490433

客服微信:

数据定制

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

意见反馈