
| 接口编号: 601 | 接口名称: 黄金数据 | 连接应用: 1458个 |
| 应用编号: 120010 | 应用标识: finance.shgold | 服务商: NowAPI |
说明
SH黄金交易所今日金价查询,含: 黄金品种、最新价、最高价、最低价、开盘价、昨收价,数据更新时间等。 数据更新: 免费用户2分钟,付费用户实时 SH黄金交易所交易时段: 工作日09:00至15:30,20:00至次日02:30。 测试示例: https://sapi.k780.com/?app=finance.gold_price&goldid=1051&appkey=10003&sign=b59bc3ef6191eb9f747dd4e83c99f2a4&format=json (示例中sign会不定期调整) 如有报价盘相关数据或软件需求请联系客服.
请求网址
HTTP: http://api.k780.com
HTTPS: https://sapi.k780.com
请求方式
Post/Get
请求Header
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
请求参数
| 参数 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| app | string | 是 | finance.gold_price |
| goldid | string | 是 | 查询品种,多个用逗号隔开(1051,1052,1053,1054),包含:
1051:黄金T+D 1052:白银T+D 1053:黄金9999 1054:黄金9995 1056:铂金9995 1058:金条100g 1059:黄金T+N1 1060:黄金T+N2 (注:单次查询多个会按多个扣量,试用套餐暂只支持单个查询) |
| version | int | 是 | 版本号 1:旧版(默认) 3:最新版 |
| appkey | string | 是 | 使用API的唯一凭证 获取 |
| sign | string | 是 | md5后的32位密文,登陆用. 获取 |
| format | {json|xml} | 否 | 返回数据格式 |
| jsoncallback | string | 否 | js跨域使用jsonp时可使用此参数 |
Json请求示例
http://api.k780.com/?app=finance.gold_price&goldid=1051,1052,1053,1054,1055,1056,1057,1058,1059,1060&appkey=APPKEY&sign=SIGN&format=json
Json返回示例
1.成功
{
"success": "1",
"result": {
dtQuery: "1051",
dtCount: "1",
dtList: {
"1051": {
"goldid":"1051",
"variety": "AuT+D", /*品种*/
"varietynm": "黄金T+D", /*品种名称*/
"last_price": "403.1", /*当前价*/
"buy_price": "402.85", /*买入价*/
"sell_price": "403.1", /*卖出价*/
"high_price": "404.97", /*最高价*/
"low_price": "402.6", /*最低价*/
"open_price": "395.75", /*开盘价*/
"yesy_price": "397.13", /*昨收价*/
"change_price": "5.97", /*涨跌额*/
"change_margin": "1.5%", /*涨跌幅*/
"uptime": "2022-06-13 16:58:39" /*更新时间 (行情有变化uptime才会更新)*/
},
.....
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.gold_price';
$postData['goldid'] = '1051,1052,1053,1054,1055,1056,1057,1058,1059,1060';
$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.gold_price',
'goldid' : '1051,1052,1053,1054,1055,1056,1057,1058,1059,1060',
'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.gold_price&goldid=1051,1052,1053,1054,1055,1056,1057,1058,1059,1060&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.gold_price&goldid=1051,1052,1053,1054,1055,1056,1057,1058,1059,1060&appkey=10003&sign=b59bc3ef6191eb9f747dd4e83c99f2a4&format=json"
流量包套餐说明:
买多少用多少,多买有优惠,10元起买,适合大多数应用场景.
| 规格 | 套餐名称 | 价格 | 描述 |
|---|---|---|---|
| 201 | 流量包 5000 次 | 10 元 | 约 0.00200 元/次 |
| 202 | 流量包 52500 次 | 100 元 | 约 0.00190 元/次 |
| 203 | 流量包 106000 次 | 200 元 | 约 0.00189 元/次 |
| 204 | 流量包 160500 次 | 300 元 | 约 0.00187 元/次 |
| 205 | 流量包 272500 次 | 500 元 | 约 0.00183 元/次 |
| 206 | 流量包 550000 次 | 1000 元 | 约 0.00182 元/次 |
| 207 | 流量包 1110000 次 | 2000 元 | 约 0.00180 元/次 |
| 208 | 流量包 1680000 次 | 3000 元 | 约 0.00179 元/次 |
| 209 | 流量包 2875000 次 | 5000 元 | 约 0.00174 元/次 |
| 210 | 流量包 6000000 次 | 10000 元 | 约 0.00167 元/次 |
包月套餐说明:
适合调用量比较平均的高频应用场景;有配额限制,超出配额会被暂停调用1小时,请留意购买足够配额.
| 规格 | 套餐名称 | 价格 | 描述 |
|---|---|---|---|
| 101 | 200 次配额/每小时 | 48 元/月 | - |
| 102 | 400 次配额/每小时 | 87 元/月 | 省¥ 9 享9.8折 |
| 103 | 600 次配额/每小时 | 130 元/月 | 省¥ 14 享9.5折 |
| 104 | 1000 次配额/每小时 | 218 元/月 | 省¥ 22 享9折 |
| 105 | 2000 次配额/每小时 | 439 元/月 | 省¥ 41 享8.5折 |
| 106 | 4000 次配额/每小时 | 883 元/月 | 省¥ 77 享8折 |
| 107 | 6000 次配额/每小时 | 1332 元/月 | 省¥ 108 享7.5折 |
| 108 | 8000 次配额/每小时 | 1786 元/月 | 省¥ 134 享7折 |
| 109 | 10000 次配额/每小时 | 2244 元/月 | 省¥ 156 享6.5折 |
| 110 | 20000 次配额/每小时 | 4800 元/月 | - |
免费试用套餐说明:
商用请选择付费套餐。 (系统繁忙或极端情况下,优先保证付费用户使用).
| 规格 | 套餐名称 | 价格 | 描述 |
|---|---|---|---|
| 0 | 试用套餐 10 次/每小时 | 0 元/月 | 可免费试用3个月,延长试用或次数不够可联系客服增加 |