概览

金尊API 提供多品类实时行情数据，覆盖贵金属、工业金属、数字货币、原油能源四大品类。所有接口采用 RESTful 风格，GET 请求，JSON 响应。

鉴权方式

所有请求须携带 token 参数。Token 在控制台「Token 管理」页面创建，付费套餐需绑定调用域名。

接口地址

请求参数

响应格式

统一返回 {code, msg, data} 结构：

{
  "code": 200,
  "msg": "成功",
  "data": {
    "data": {
      "AU_USD": {
        "symbol": "AU_USD",
        "name_zh": "黄金",
        "category": "precious",
        "us_price": 4382.53,
        "us_high": 4396.11,
        "us_low": 4372.63,
        "cny_price": 951.88,
        "cny_high": 954.83,
        "cny_low": 949.73,
        "change_pct": -0.04,
        "us_unit": "/盎司",
        "cny_unit": "/克"
      }
    },
    "forex": 6.755647,
    "updated_at": 1786805008,
    "plan": "pro",
    "delay": 15
  }
}

字段说明

品种代码表

贵金属

工业金属

数字货币

原油能源

错误码

代码示例

// PHP 示例
$token = "YOUR_TOKEN";
$symbol = "AU_USD,BTC_USD";
$url = "https://api.222288.cn/api/v1.php"
     . "?token={$token}&symbol={$symbol}";

$resp = json_decode(file_get_contents($url), true);
if ($resp["code"] === 200) {
    $au = $resp["data"]["data"]["AU_USD"];
    echo "黄金 $" . $au["us_price"] . " ≈ ¥" . $au["cny_price"];
}

// JavaScript 示例（建议后端代理，勿前端暴露 Token）
const token = "YOUR_TOKEN";
const symbol = "AU_USD,BTC_USD";
const url = `https://api.222288.cn/api/v1.php?token=${token}&symbol=${symbol}`;

const resp = await fetch(url);
const data = await resp.json();
if (data.code === 200) {
    const au = data.data.data.AU_USD;
    console.log(`黄金 $${au.us_price} ≈ ¥${au.cny_price}`);
}

# Python 示例
import requests

token = "YOUR_TOKEN"
symbol = "AU_USD,BTC_USD"
url = f"https://api.222288.cn/api/v1.php?token={token}&symbol={symbol}"

resp = requests.get(url).json()
if resp["code"] == 200:
    au = resp["data"]["data"]["AU_USD"]
    print(f"黄金 \${au['us_price']} ≈ ¥{au['cny_price']}")

# cURL 示例
curl "https://api.222288.cn/api/v1.php?token=YOUR_TOKEN&symbol=AU_USD"

频率限制

按套餐限制 QPS 与日调用次数，超限返回 429。