基础汇率

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

说明

根据相关币别编号查询对应汇率,数据以 1美元(USD) 作为基准
数据更新: 免费用户:2分钟  付费用户:10-15秒
测试示例: https://sapi.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 nowapiRequest($postData,&$errMsg=''){
    $apiUrl     = 'https://sapi.k780.com/';
    $useContext = stream_context_create(array(
        'http' => array(
            'method'  => 'POST',
            'header'  => 'Content-type:application/x-www-form-urlencoded',
            'content' => http_build_query($postData)
        )
    ));
    if(!$resData=file_get_contents($apiUrl,false,$useContext)){
        $errMsg = 'ERR_CONNECT';
        return false;
    }
    if(!$arrData=json_decode($resData,true)){
        $errMsg = 'ERR_DECODE';
        return false;
    }
    if($arrData['success']!=1){
        $errMsg = $arrData['msgid'].' '.$arrData['msg'];
        return false;
    }
    return $arrData['result'];
}

$postData['app'] = 'finance.rate';
$postData['scur'] = 'USD';
$postData['tcur'] = 'CNY';
$postData['appkey'] = '10003';//替换成自己的appkey
$postData['sign'] = 'b59bc3ef6191eb9f747dd4e83c99f2a4';//替换成自己的sign
$postData['format'] = 'json';
$result = nowapiRequest($postData,$errMsg);
print_r($errMsg);
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=10003&sign=b59bc3ef6191eb9f747dd4e83c99f2a4&format=json"

流量包套餐说明:

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

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

包月套餐说明:

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

规格套餐名称价格描述
101200 次配额/每小时48 元/月-
102400 次配额/每小时87 元/月-
103600 次配额/每小时130 元/月-
1041000 次配额/每小时218 元/月-
1052000 次配额/每小时439 元/月-
1064000 次配额/每小时883 元/月-
1076000 次配额/每小时1332 元/月-
1088000 次配额/每小时1786 元/月-
10910000 次配额/每小时2244 元/月-
11020000 次配额/每小时4800 元/月-
立即开通

免费试用套餐说明:

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

规格套餐名称价格描述
0试用套餐 10 次/每小时0 元/月可免费试用3个月,延长试用或次数不够可联系客服增加
立即开通

客户服务

客服QQ: 1486133340 
QQ群8: 204490433

客服微信:

数据定制

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

意见反馈