接入说明
Golddataapi 提供标准 RESTful 接口，所有请求均通过 HTTPS 调用，返回数据格式为 JSON。
请求基础地址：
https://golddataapi.goldeye.com.cn/v1
所有接口均需在 query 参数或 Header 中携带您的 app_secret 完成鉴权。如尚未获取 app_secret，请前往 价格方案 页面购买。
鉴权方式
每次请求需携带 app_secret 作为身份凭证。两种方式任选其一：
方式一：URL 参数
GET https://golddataapi.goldeye.com.cn/v1/gold/spot?app_secret=YOUR_APP_SECRET
方式二：HTTP Header
curl -H "X-App-Secret: YOUR_APP_SECRET" \ https://golddataapi.goldeye.com.cn/v1/gold/spot
错误码
| code | 说明 |
|---|---|
| 0 | 请求成功 |
| 401 | app_secret 无效或未携带 |
| 402 | 账户调用额度不足，请前往购买 |
| 403 | 当前接口未在套餐内 |
| 429 | 请求频率过高，请稍后重试 |
| 500 | 服务器内部错误，请联系客服 |
黄金 Gold 实时行情
GET/v1/gold/spot
请求示例
curl "https://golddataapi.goldeye.com.cn/v1/gold/spot?app_secret=YOUR_APP_SECRET&symbol=XAUUSD"
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| app_secret | string | 是 | 身份密钥 |
| symbol | string | 否 | 品种代码，默认 XAUUSD（伦敦金） |
返回示例
{ "code": 0, "data": { "symbol": "XAUUSD", "name": "伦敦金", "bid": 2358.35, "ask": 2358.49, "last": 2358.42, "change": 20.16, "change_pct": 0.86, "high": 2362.10, "low": 2338.20, "timestamp": 1716960421 }}
白银 Silver 实时行情
GET/v1/silver/spot
返回结构与黄金接口一致，symbol 支持 XAGUSD（伦敦银）。
curl "https://golddataapi.goldeye.com.cn/v1/silver/spot?app_secret=YOUR_APP_SECRET"
铂金 Platinum 实时行情
GET/v1/platinum/spot
返回铂金 XPT/USD 实时行情。
curl "https://golddataapi.goldeye.com.cn/v1/platinum/spot?app_secret=YOUR_APP_SECRET"
钯金 Palladium 实时行情
GET/v1/palladium/spot
返回钯金 XPD/USD 实时行情。
curl "https://golddataapi.goldeye.com.cn/v1/palladium/spot?app_secret=YOUR_APP_SECRET"
原油 Crude Oil 实时行情
GET/v1/oil/spot
支持 symbol=WTI（西德州轻质）/ BRENT（布伦特）。
curl "https://golddataapi.goldeye.com.cn/v1/oil/spot?app_secret=YOUR_APP_SECRET&symbol=WTI"
多周期 K 线
GET/v1/{symbol}/kline
支持的 {symbol}：gold / silver / platinum / palladium / oil。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| app_secret | string | 是 | 身份密钥 |
| period | string | 是 | 1m / 5m / 15m / 30m / 1h / 4h / 1d |
| limit | int | 否 | 返回条数，默认 200，最大 1000 |
返回示例
{ "code": 0, "data": [ [1716960360, 2356.20, 2358.50, 2355.80, 2358.42, 1240], // time, open, high, low, close, volume [1716960420, 2358.42, 2359.10, 2357.30, 2358.95, 980] ]}
贵金属资讯
GET/v1/news
聚合全球财经媒体的贵金属与大宗商品资讯。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| app_secret | string | 是 | 身份密钥 |
| category | string | 否 | gold / silver / oil / market |
| limit | int | 否 | 返回条数，默认 20 |
curl "https://golddataapi.goldeye.com.cn/v1/news?app_secret=YOUR_APP_SECRET&category=gold&limit=10"