基础汇率历史

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

说明

历史汇率查询接口,支持多种不同类型的K线数据(1天,1周,1月,半年,1年等),同时支持币种间转换;支持全球163个币种 Json格式扣费扣量特别说明(扣量: 包月套餐扣可用配额次数,流量包套餐扣可用次数)
1. result.dtCount节点值为数据条数,每10条数据或不足10条扣量1次;例如:数据条数为9扣量1次,为11扣量2次。

测试示例: https://sapi.k780.com/?app=finance.rate_history.v3&curNoS=USDCNY&htType=HT1D&dateYmdS=20210702&appkey=10003&sign=b59bc3ef6191eb9f747dd4e83c99f2a4&format=json (示例中sign会不定期调整)

调用方式

GET/POST

请求url

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

请求参数

参数 类型 是否必须 备注
app string 固定 finance.rate_history.v3
curNoS string 币别编号 如:USDCNY
支持组合币种: Json格式
htType string 历史数据类型 包含:
HT1D: 1天K线
HT1W: 1周K线
HT1M: 1月K线
HTHY: 半年K线
HT1Y: 1年K线
dateYmdS string 查询指定时间(段)的汇率
1.指定时间: 例:20150101
2.指定时间(段): 20150101-20150201 最大跨度10年
(注:单次多个查询会按多次扣量,多个查询只对付费用户开放)
appkey string 使用API的唯一凭证 获取
format {json|xml} 返回数据格式

Json请求示例

http://api.k780.com/?app=finance.rate_history.v3&curNoS=USDCNY&htType=HT1D&dateYmdS=20210702&appkey=APPKEY&sign=SIGN&format=json

Json返回示例

1.成功
{
    success: "1",
    result: {
        dtCount: "1",
        dtAppend: {
            htType: "HT1D",  /*查询的历史数据类型*/
            curNoS: "USDCNY",/*查询的币种*/
            dateYmdS: "20210502-20210705" /*查询的时间范围段*/
        },
        dtList: [{
            d: "20210506", /*数据日期*/
            o: "6.4794", /*开盘价*/
            c: "6.4641", /*收盘价*/
            y: "6.4756", /*昨收价*/
            h: "6.4834", /*最高价*/
            l: "6.464", /*最低价*/
            cp: "-0.0115", /*涨跌*/
            cm: "-0.18", /*涨跌%*/
            ap: "0.0194", /*振幅*/
            am: "0.3" /*振幅%*/
        },
        {
            d: "20210507",
            o: "6.4662",
            c: "6.4332",
            y: "6.4641",
            h: "6.4662",
            l: "6.4332",
            cp: "-0.0309",
            cm: "-0.48",
            ap: "0.033",
            am: "0.51"
        }
       
        .......     
 
    ]
  }
}


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_history.v3';
$postData['curNoS'] = 'USDCNY';
$postData['htType'] = 'HT1D';
$postData['dateYmdS'] = '20210702';
$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_history.v3',
  'curNoS' : 'USDCNY',
  'htType' : 'HT1D',
  'dateYmdS' : '20210702',
  '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_history.v3&curNoS=USDCNY&htType=HT1D&dateYmdS=20210702&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"));
    }
}

curl "http://api.k780.com/?app=finance.rate_history.v3&curNoS=USDCNY&htType=HT1D&dateYmdS=20210702&appkey=10003&sign=b59bc3ef6191eb9f747dd4e83c99f2a4&format=json"

流量包套餐说明:

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

规格套餐名称价格描述
201流量包 10000 次10 元约 0.00100 元/次
202流量包 105000 次100 元约 0.00095 元/次
203流量包 212000 次200 元约 0.00094 元/次
204流量包 321000 次300 元约 0.00093 元/次
205流量包 545000 次500 元约 0.00092 元/次
206流量包 1100000 次1000 元约 0.00091 元/次
207流量包 2220000 次2000 元约 0.00090 元/次
208流量包 3360000 次3000 元约 0.00089 元/次
209流量包 5750000 次5000 元约 0.00087 元/次
210流量包 12000000 次10000 元约 0.00083 元/次
立即开通

包月套餐说明:

适合调用量比较平均的高频应用场景;有配额限制,超出配额会被暂停调用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 

意见反馈