API市场 代理 文档 登录 注册
首页 全部 AI 车辆 金融 生活 开发 娱乐 物流

黄金数据查询

黄金数据查询API提供上海黄金交易所所有黄金品种的实时行情数据。数据每分钟更新一次,周六日闭市期间返回最后一次行情数据。
分类: 金融 累计调用: 67 次
黄金数据查询
价格: 0.1 积分(≤0.001元)/次
代理权益: 最低 免费使用
代理价格一览
初级代理 免费
中级代理 免费
高级代理 免费
钻石代理 免费
付费模式: 按量付费
01优质数据
02详尽文档
03专业测试
04保证品质
05在线客服
06及时支持

上海黄金交易所

黄金数据查询API提供上海黄金交易所所有黄金品种的实时行情数据。数据每分钟更新一次,周六日闭市期间返回最后一次行情数据。

接口地址 https://api.douhao.com/gateway
API版本 v1.0
请求方式 GET POST
系统请求头 2 个
Header名称 默认值 必填 说明
X-API-Key 你的API密钥 逗号APIKEY,用户后台首页获取
Content-Type application/json 请求内容类型
系统参数 3 个
参数名 默认值 必填 说明
api_id 7 API接口ID,系统默认
endpoint_id ep_40618eed3d571763778d21a40209440b 端点ID,系统默认
method POST 请求方式,可选值:GET,POST
业务参数 0 个参数
参数名 类型 必填 说明 示例
暂无业务参数
返回参数 19 个参数
参数名 类型 说明 示例
success boolean 请求是否成功
data.list object 各品种行情数据,key为品种代码
data.update_time string 数据更新时间(取Au9999品种)
data.count integer 品种总数
generated_at string 接口响应时间
type string 品种代码
typename string 品种中文名称
price string 最新价
buyprice string 买入价
sellprice string 卖出价
changequantity string 涨跌额
changepercent string 涨跌幅
openingprice string 开盘价
maxprice string 最高价
minprice string 最低价
lastclosingprice string 昨收价
tradeamount string 总成交量(kg)
unit string 单位(元/克)
updatetime string 更新时间
返回示例
成功返回示例
{"success":true,"data":{"list":{"AuT+D":{"type":"AuT+D","typename":"黄金延期","price":"881.80","buyprice":"881.50","sellprice":"881.90","changequantity":"-0.69","changepercent":"-0.08%","openingprice":"878.40","maxprice":"882.34","minprice":"874.93","lastclosingprice":"882.78","tradeamount":"25032.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"mAuT+D":{"type":"mAuT+D","typename":"M黄金延期","price":"881.02","buyprice":"881.02","sellprice":"882.00","changequantity":"-1.84","changepercent":"-0.21%","openingprice":"878.50","maxprice":"882.30","minprice":"875.10","lastclosingprice":"882.89","tradeamount":"55686.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"Au9999":{"type":"Au9999","typename":"黄金9999","price":"882.00","buyprice":"881.50","sellprice":"881.70","changequantity":"-1.28","changepercent":"-0.14%","openingprice":"877.00","maxprice":"885.00","minprice":"875.03","lastclosingprice":"883.28","tradeamount":"532164.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"Au9995":{"type":"Au9995","typename":"黄金9995","price":"881.50","buyprice":"880.00","sellprice":"884.00","changequantity":"1.54","changepercent":"0.18%","openingprice":"878.00","maxprice":"881.50","minprice":"878.00","lastclosingprice":"879.96","tradeamount":"4.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"Au100g":{"type":"Au100g","typename":"100克金条","price":"882.70","buyprice":"882.50","sellprice":"886.50","changequantity":"-0.77","changepercent":"-0.09%","openingprice":"883.20","maxprice":"883.20","minprice":"877.00","lastclosingprice":"883.47","tradeamount":"168.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"AuT+N1":{"type":"AuT+N1","typename":"黄金单月延期","price":"1096.70","buyprice":"","sellprice":"","changequantity":"134.70","changepercent":"14.00%","openingprice":"","maxprice":"","minprice":"","lastclosingprice":"1096.70","tradeamount":"2.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"AuT+N2":{"type":"AuT+N2","typename":"黄金双月延期","price":"1050.00","buyprice":"","sellprice":"1050.00","changequantity":"25.00","changepercent":"2.44%","openingprice":"","maxprice":"","minprice":"","lastclosingprice":"1050.00","tradeamount":"2.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"SGiAu100g":{"type":"SGiAu100g","typename":"i黄金100g","price":"782.00","buyprice":"775.00","sellprice":"","changequantity":"24.19","changepercent":"3.19%","openingprice":"","maxprice":"","minprice":"","lastclosingprice":"782.00","tradeamount":"10.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"SGiAu9999":{"type":"SGiAu9999","typename":"i黄金9999","price":"880.60","buyprice":"880.16","sellprice":"880.96","changequantity":"-1.32","changepercent":"-0.15%","openingprice":"877.64","maxprice":"880.78","minprice":"873.97","lastclosingprice":"881.92","tradeamount":"96940.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"},"PT9995":{"type":"PT9995","typename":"铂金9995","price":"400.82","buyprice":"395.00","sellprice":"402.60","changequantity":"-1.50","changepercent":"-0.37%","openingprice":"401.86","maxprice":"401.86","minprice":"400.82","lastclosingprice":"402.32","tradeamount":"6.00","unit":"元\/克","updatetime":"2026-07-29 17:18:01"}},"update_time":"2026-07-29 17:18:01","count":10},"generated_at":"2026-07-29 17:18:17"}
失败返回示例
HTTP/1.1 401 Unauthorized

{
  "success": false,
  "error": "invalid_api_key",
  "message": "认证失败,请提供有效的API密钥"
}

业务级错误码

错误代码 HTTP状态 错误信息 详细说明
401 401 invalid_api_key API密钥无效或未提供
405 404 method_not_allowed 使用了GET以外的方法
500 500 config_error 服务配置异常
500 500 api_request_failed 第三方接口请求异常
500 500 api_parse_failed 第三方接口响应解析失败
500 500 query_failed 黄金数据查询失败

系统级错误码

错误代码 HTTP状态 错误信息 详细说明
401HTTP 401认证失败请求头中缺少 X-API-Key 或 API Key 无效
400HTTP 400参数错误缺少必要参数(api_id、endpoint_id、method)或必填业务参数缺失
404HTTP 404资源不存在API不存在、已下架或端点不存在
403HTTP 403未开通您尚未开通此API,请先开通
405HTTP 405方法不允许请求方法不在端点允许列表中
402HTTP 402积分不足账户积分不足以调用该API
500HTTP 500服务器内部错误系统异常

品种代码说明

代码名称代码名称
AuT+D黄金延期mAuT+DM黄金延期
Au9999黄金9999Au9995黄金9995
Au100g100克金条AuT+N1黄金单月延期
AuT+N2黄金双月延期PT9995铂金9995
SGiAu100gi黄金100gSGiAu9999i黄金9999

⚠ 注意:周六日及节假日闭市,闭市期间返回最后一次行情数据。数据由上海黄金交易所提供,仅供参考。

PHP
<?php
// 以 黄金数据查询(ID:7) 为例,以下为PHP请求示例:

$gateway_url = "https://api.douhao.com/gateway";

// 系统参数
$gatewayData = array(
    'api_id' => 7,
    'endpoint_id' => 'ep_40618eed3d571763778d21a40209440b',
    'method' => 'GET,POST'
);

// 业务参数(请填写实际值)
$bizParams = array(
);

// 合并请求数据
$requestData = array_merge($gatewayData, $bizParams);

// 请求头(请替换为您的API密钥)
$headers = array(
    'Content-Type: application/json',
    'X-API-Key: 您的API密钥'
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $gateway_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 180);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($requestData, JSON_UNESCAPED_UNICODE));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
$error = curl_error($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($error) {
    echo "请求错误: " . $error;
} else {
    echo "HTTP状态码: " . $httpCode . "\n";
    echo "响应数据: " . $response;
}
?>
Python
#!/usr/bin/env python3
# -*- coding: utf-8 -*-

import requests
import json

# API网关地址
gateway_url = "https://api.douhao.com/gateway"

# 系统参数
gateway_data = {
    'api_id': 7,
    'endpoint_id': 'ep_40618eed3d571763778d21a40209440b',
    'method': 'GET,POST'
}

# 业务参数(请填写实际值)
biz_params = {
}

# 合并请求参数
request_data = {**gateway_data, **biz_params}

# 请求头(请替换为您的API密钥)
headers = {
    'Content-Type': 'application/json',
    'X-API-Key': '您的API密钥'
}

try:
    response = requests.post(
        gateway_url,
        json=request_data,
        headers=headers,
        timeout=180,
        verify=False  # 生产环境建议设为True
    )
    
    print(f"HTTP状态码: {response.status_code}")
    print("响应数据:")
    print(json.dumps(response.json(), indent=2, ensure_ascii=False))
    
except requests.exceptions.RequestException as e:
    print(f"请求错误: {e}")
JavaScript (Node.js)
// 以 黄金数据查询(ID:7) 为例,以下为Node.js请求示例
// 需要先安装 axios: npm install axios

const axios = require('axios');

// API网关地址
const gatewayUrl = 'https://api.douhao.com/gateway';

// 系统参数
const gatewayData = {
    api_id: 7,
    endpoint_id: 'ep_40618eed3d571763778d21a40209440b',
    method: 'GET,POST'
};

// 业务参数(请填写实际值)
const bizParams = {
};

// 合并请求参数
const requestData = { ...gatewayData, ...bizParams };

// 请求头(请替换为您的API密钥)
const headers = {
    'Content-Type': 'application/json',
    'X-API-Key': '您的API密钥'
};

async function callApi() {
    try {
        const response = await axios.post(gatewayUrl, requestData, {
            headers: headers,
            timeout: 180000
        });
        
        console.log('HTTP状态码:', response.status);
        console.log('响应数据:');
        console.log(JSON.stringify(response.data, null, 2));
    } catch (error) {
        if (error.response) {
            console.log('HTTP状态码:', error.response.status);
            console.log('错误响应:', error.response.data);
        } else {
            console.log('请求错误:', error.message);
        }
    }
}

callApi();
Java
// 以 黄金数据查询(ID:7) 为例,以下为Java请求示例
// 需要依赖:okhttp 和 gson

import okhttp3.*;
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.TimeUnit;

public class ApiDemo {
    private static final String GATEWAY_URL = "https://api.douhao.com/gateway";
    private static final Gson gson = new GsonBuilder().setPrettyPrinting().create();
    
    public static void main(String[] args) throws Exception {
        // 系统参数
        Map<String, Object> gatewayData = new HashMap<>();
        gatewayData.put("api_id", 7);
        gatewayData.put("endpoint_id", "ep_40618eed3d571763778d21a40209440b");
        gatewayData.put("method", "GET,POST");
        
        // 业务参数(请填写实际值)
        Map<String, Object> bizParams = new HashMap<>();
        
        // 合并请求数据
        Map<String, Object> requestData = new HashMap<>(gatewayData);
        requestData.putAll(bizParams);
        
        // 请求体JSON
        String jsonBody = gson.toJson(requestData);
        
        // 创建请求
        OkHttpClient client = new OkHttpClient.Builder()
            .connectTimeout(180, TimeUnit.SECONDS)
            .readTimeout(180, TimeUnit.SECONDS)
            .build();
        
        RequestBody body = RequestBody.create(
            jsonBody,
            MediaType.parse("application/json; charset=utf-8")
        );
        
        Request request = new Request.Builder()
            .url(GATEWAY_URL)
            .post(body)
            .addHeader("Content-Type", "application/json")
            .addHeader("X-API-Key", "您的API密钥") // 请替换为您的API密钥
            .build();
        
        try (Response response = client.newCall(request).execute()) {
            System.out.println("HTTP状态码: " + response.code());
            String responseBody = response.body().string();
            System.out.println("响应数据:");
            System.out.println(gson.toJson(gson.fromJson(responseBody, Object.class)));
        }
    }
}
cURL
# 以 黄金数据查询(ID:7) 为例,以下为cURL请求示例

curl -X POST "https://api.douhao.com/gateway" \
     -H "Content-Type: application/json" \
     -H "X-API-Key: 您的API密钥" \
     -d '{
         "api_id": 7,
         "endpoint_id": "ep_40618eed3d571763778d21a40209440b",
         "method": "GET,POST",
              }'
Copyright©2018-2025 版权归属 浙江花田网络有限公司 逗号站长站 www.douhao.com
本站已获得《中华人民共和国增值电信业务经营许可证》:浙B2-20200940 浙ICP备18032409号-1 浙公网安备 33059102000262号

服务协议

逗号API接口开通服务协议

甲方(服务提供方):浙江花田网络有限公司

网站名称:逗号API

乙方(服务使用方/平台注册用户):未绑定手机号

逗号API网站用户ID:未登陆

鉴于甲方是「逗号API」网站(以下简称"本平台")的合法运营主体,拥有本平台全部API接口服务的运营、授权、管理权限;乙方为在本平台完成注册的合法用户,自愿在线申请接入甲方逗号API接口服务,用于自身合法业务运营。本协议为互联网电子格式服务协议,全程无需乙方线下填表、签字、盖章,乙方通过本平台弹窗点击"同意"、即视为乙方自愿、真实认可本协议全部条款,双方电子签约行为完全符合《电子签名法》《民法典》规定,合法有效。为明确甲乙双方权利与义务,规范API接口接入及使用行为,依据相关法律法规,甲乙双方本着平等自愿、公平诚信、互利共赢的原则,经线上合意确认,达成如下协议,双方共同恪守执行。

第一条 服务内容

1.1 甲方同意按照本协议约定,为乙方开通逗号API对应接口的访问、调用权限,具体开通的接口类型、调用频次、额度、使用场景及服务期限,以双方确认的开通清单、后台配置及补充约定为准。

1.2 甲方负责提供合规、稳定的API接口服务,包含接口技术文档、基础技术适配、日常运维、故障排查等配套服务,保障接口在正常运营状态下稳定可用。

1.3 乙方仅可在本协议约定的业务场景内使用甲方API接口服务,不得超出授权范围使用、转借、出租、出售接口权限及相关服务资源。

第二条 服务开通与使用规范

2.1 乙方提交接入申请后,甲方审核通过即为服务开通完成,乙方可通过甲方分配的密钥、账号、token等授权凭证对接使用API接口服务。乙方需妥善保管自身授权凭证,因乙方保管不当、泄露、私自转借导致的一切风险及损失,均由乙方自行承担。

2.2 乙方在使用API接口过程中,必须严格遵守国家法律法规、互联网行业规范及甲方平台规则,不得利用本API服务从事违法违规、侵权盗版、恶意攻击、爬虫泛滥、高频恶意调用、干扰平台正常运营、损害甲方品牌权益等行为。

2.3 乙方不得对甲方API接口、程序代码、技术架构、数据内容进行反向工程、逆向破解、篡改、复制、二次分发、盗用,不得批量抓取、囤积甲方平台数据及接口资源。

2.4 乙方如需变更接口使用场景、扩大调用额度、新增接口权限,需提前向甲方提交申请,经甲方审核同意后方可变更,未经许可的超范围使用视为违约行为。

第三条 费用与结算方式

3.1 本API接口服务收费标准、计费方式、套餐额度、优惠政策,以甲方「逗号API」平台公示的最新资费标准或双方另行签订的补充协议为准。若为免费试用服务,试用期限、试用额度以甲方后台配置为准。

3.2 乙方需按照约定按时足额支付服务费用,逾期付款的,甲方有权暂停乙方API接口调用权限,直至乙方结清全部费用;逾期超过约定时限的,甲方有权终止本协议,且不退还已缴纳费用。

3.3 甲方有权根据市场运营情况、技术升级、成本调整等因素,合理调整服务资费标准,调整前将通过平台公告、站内通知等方式告知乙方,调整后资费自公示生效之日起执行。

第四条 甲方权利与义务

4.1 甲方有权按照本协议及平台规则,对乙方的API使用行为进行监督、核查、管理,对违规使用行为有权采取限流、暂停、封禁接口权限、终止协议等处置措施。

4.2 甲方负责平台服务器、接口系统的日常运维,保障服务稳定运行。因系统升级、漏洞修复、服务器维护等合理原因需要临时暂停服务的,甲方将提前通过平台公告或单独通知乙方,无需承担违约责任。

4.3 因不可抗力、网络故障、运营商故障、第三方平台问题等非甲方原因导致的服务中断、延迟、数据异常,甲方无需承担责任,但会积极协助乙方排查恢复。

4.4 甲方严格遵守数据安全及隐私保护相关法律法规,妥善保管乙方对接数据及相关信息,无合法依据不得擅自泄露、出售、非法使用乙方业务数据及用户信息。

第五条 乙方权利与义务

5.1 乙方有权在授权范围内,正常、合规使用甲方开通的API接口服务,享受甲方对应的技术运维及售后支持服务。

5.2 乙方保证自身接入业务合法合规,拥有自身业务及相关内容的合法经营权、版权、使用权,乙方通过API接口产生的业务内容、用户数据、经营行为均由乙方独立负责,若因乙方业务违规、侵权、违法产生一切纠纷、赔偿、处罚,均由乙方自行承担,与甲方无关;若因此给甲方造成损失、行政处罚、第三方索赔的,乙方需全额赔偿甲方全部损失(包含罚款、赔偿金、律师费、诉讼费、运维损失等)。

5.3 乙方需配合甲方的合规核查、运维排查工作,及时提供对接信息、业务资料,不得隐瞒违规使用行为。

5.4 乙方不得将甲方API服务用于电信诈骗、网络赌博、虚假宣传、侵权盗版、恶意引流、非法数据采集等违法违规场景,一经发现,甲方有权立即终止服务、解除协议,不予退还任何费用,并保留追究乙方法律责任的权利。

第六条 保密条款

6.1 甲乙双方应对本协议内容、合作细节、对方商业信息、技术资料、接口密钥、账号信息、业务数据等涉密信息严格保密,未经对方书面同意,不得向任何第三方泄露、传播、使用。

6.2 本保密条款在本协议终止后1年内持续有效,若乙方违反保密约定,需向甲方承担违约责任,赔偿甲方全部经济损失。

第七条 知识产权条款

7.1 甲方「逗号API」平台全部知识产权,包括但不限于商标、域名、代码、程序、接口技术、文档、文案、数据资源等,均归浙江花田网络有限公司独家所有。

7.2 乙方仅获得API接口的有限使用权,未获得甲方任何知识产权的所有权、转让权、授权再许可权,不得利用甲方知识产权进行二次开发、商用变现、侵权使用。

7.3 乙方业务产生的自有知识产权归乙方所有,但不得使用甲方商标、品牌、标识进行虚假宣传、误导公众。

第八条 协议期限与终止

8.1 本协议为电子服务协议,自乙方在本平台弹窗点击【同意协议并接入】、完成线上确认,且甲方审核通过、为乙方开通API接口服务、乙方正式调用服务之日起即时生效。本协议无纸质签署版本,乙方线上确认行为等同于签字盖章,具备完整的电子合同法律效力。服务期限以双方约定或甲方后台配置的服务周期为准;若无明确约定,视为不定期服务,双方均可提前3个工作日通过平台站内消息、书面通知等合规方式告知对方终止协议。

8.2 乙方存在下列情形之一的,甲方有权单方立即终止协议、关闭接口权限,不予退还剩余费用,并追究乙方违约责任:

(1)超范围、违规使用API接口服务的;

(2)破解、盗用、转借、出售API接口权限及资源的;

(3)利用API服务从事违法违规活动的;

(4)逾期支付服务费用,经催告后仍不支付的;

(5)恶意攻击、干扰甲方平台正常运营的;

(6)其他严重违反本协议约定及法律法规的行为。

8.3 协议终止后,乙方需立即停止使用甲方全部API接口服务,删除留存的甲方技术资料、接口数据、授权凭证,不得继续使用甲方平台资源。

第九条 违约责任

9.1 任何一方违反本协议约定,均需赔偿守约方因此遭受的全部直接及间接损失。

9.2 乙方违规使用接口、泄露授权信息、侵权使用甲方知识产权的,甲方有权根据违规情节采取限流、封禁、终止服务等措施,同时乙方需向甲方支付违约金,违约金金额根据违规造成的损失确定,不足法定最低标准的,按法定标准执行。

9.3 因乙方违约导致甲方被第三方起诉、行政机关处罚的,乙方需全额承担所有费用及损失,包括但不限于赔偿金、罚款、律师费、诉讼费、公证费、差旅费等。

第十条 免责条款

10.1 甲方仅提供API接口技术服务,不对乙方的业务运营、业务合规、交易结果、用户行为承担任何法律责任,乙方自行对自身经营行为及结果负责。

10.2 因网络拥堵、运营商故障、第三方服务异常、不可抗力(地震、洪水、疫情、政策调整等)导致的服务暂时中断、延迟、数据偏差,甲方不承担违约责任,但将尽力协助恢复服务。

10.3 乙方私自修改对接参数、违规开发、私自授权第三方使用产生的一切问题及损失,由乙方自行承担。

第十一条 争议解决

本协议的签订、履行、解释及争议解决均适用中华人民共和国法律。甲乙双方因本协议产生的一切争议,优先友好协商解决;协商不成的,任何一方均有权向甲方所在地人民法院提起诉讼。

第十二条 其他约定

12.1 本协议为平台标准化电子服务协议,无需乙方填写个人/企业资料、无需线下签署,乙方平台账号、操作记录、接口调用记录即为识别乙方主体身份的唯一有效凭证。

12.2 甲方平台公示的《用户协议》《隐私政策》《API使用规范》为本协议有效组成部分,乙方线上同意本协议,即视为同时认可上述全部规则,与本协议一并生效。

12.3 本协议为线上电子协议,无任何纸质签署、资料填写环节。乙方在逗号API平台弹窗点击"同意"、勾选协议、提交接入申请、使用API服务等行为,均视为乙方真实意思表示,具备完整电子合同法律效力。

12.4 甲方对协议弹窗展示记录、乙方同意操作日志、用户账号信息、接口开通及调用记录进行永久留存归档,以上电子数据为双方协议履行、身份认定、争议处理的唯一合法有效凭证,乙方自愿认可该存证效力,无任何异议。

请滚动到底部阅读完整协议