接口编号: 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会不定期调整)
请求网址
HTTP: http://api.k780.com
HTTPS: https://sapi.k780.com
请求方式
GET/POST
请求Header
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
请求参数
参数 | 类型 | 是否必须 | 备注 |
---|---|---|---|
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小时,请留意购买足够配额.
规格 | 套餐名称 | 价格 | 描述 |
---|---|---|---|
101 | 200 次配额/每小时 | 48 元/月 | - |
102 | 400 次配额/每小时 | 87 元/月 | - |
103 | 600 次配额/每小时 | 130 元/月 | - |
104 | 1000 次配额/每小时 | 218 元/月 | - |
105 | 2000 次配额/每小时 | 439 元/月 | - |
106 | 4000 次配额/每小时 | 883 元/月 | - |
107 | 6000 次配额/每小时 | 1332 元/月 | - |
108 | 8000 次配额/每小时 | 1786 元/月 | - |
109 | 10000 次配额/每小时 | 2244 元/月 | - |
110 | 20000 次配额/每小时 | 4800 元/月 | - |
免费试用套餐说明:
商用请选择付费套餐。 (系统繁忙或极端情况下,优先保证付费用户使用).
规格 | 套餐名称 | 价格 | 描述 |
---|---|---|---|
0 | 试用套餐 10 次/每小时 | 0 元/月 | 可免费试用3个月,延长试用或次数不够可联系客服增加 |