概览

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

请求方式

GET

响应格式

JSON

编码

UTF-8

鉴权方式

所有请求须携带 Token。支持两种传递方式：URL 参数 ?token=jz_xxx，或请求头 Authorization: Bearer jz_xxx / X-API-Token: jz_xxx（Header 方式可避免 Token 进入服务器访问日志）。Token 在控制台「Token 管理」页面创建。

免费版不校验调用来源；付费版可选绑定域名/IP：未绑定时不限制调用方式，绑定后仅允许来自绑定域名/IP 的浏览器调用（服务端调用不受限）

防盗用说明：域名/IP 绑定基于浏览器 Referer 校验，用于防止其他网页盗用您的 Token；服务端直调（PHP/curl 等不携带 Referer）无法限制，请勿将 Token 公开在前端代码中，如怀疑泄露请立即在「Token 管理」禁用并重建

本地开发调试：绑定域名/IP 的 Token 可在「Token 管理」开启"允许本地调试"，本地访问（localhost / 127.0.0.1）不受绑定限制

Token 可在控制台随时重置，重置后旧 Token 立即失效

接口地址

GET https://api.222288.cn/api/v1.php

请求参数

参数	类型	必填	说明
token	string	是	API Token，URL 参数或请求头传递（见鉴权方式）
symbol	string	是	品种代码。支持单个 `AU_USD`、批量 `AU_USD,BTC_USD`、全量 `all`

响应格式

统一返回 {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",
    "interval": 15
  }
}

字段说明

字段	类型	说明
symbol	string	本站品种代码
name_zh	string	中文名
category	string	分类：precious/metal/crypto/oil
us_price	float	美元价
us_high	float	24 小时美元最高价
us_low	float	24 小时美元最低价
cny_price	float\|null	人民币价（原油为 null）
cny_high	float\|null	24 小时人民币最高价
cny_low	float\|null	24 小时人民币最低价
change_pct	float	24 小时涨跌幅（%）
us_unit	string	美元单位（/盎司、/吨、/个、/桶）
cny_unit	string	人民币单位（/克、/公斤、/个）
forex	float	美元兑人民币汇率
updated_at	int	数据更新时间戳
plan	string	当前 Token 所属套餐（free/basic/pro/enterprise）
plan_level	int	套餐等级：0免费版 / 1基础版 / 2专业版 / 3企业版
plan_expires	int	套餐到期时间戳（0 = 免费版，无到期限制）
interval	int	最小调用间隔秒数

提示：所有价格为原始浮点数（未格式化），由客户端自行处理小数位与千分位。

品种代码表

贵金属

黄金 AU_USD

白银 AG_USD

铂金 PT_USD

钯金 PD_USD

工业金属

铝 AL_USD

铜 CU_USD

镍 NI_USD

铅 PB_USD

数字货币

比特币 BTC_USD

以太坊 ETH_USD

Solana SOL_USD

瑞波币 XRP_USD

狗狗币 DOGE_USD

币安币 BNB_USD

比特现金 BCH_USD

ZCash ZEC_USD

艾达币 ADA_USD

LINK LINK_USD

波场币 TRX_USD

波卡 DOT_USD

莱特币 LTC_USD

柴犬币 SHIB_USD

阿瓦隆 AVAX_USD

Uniswap UNI_USD

恒星币 XLM_USD

原油能源

WTI原油 WTI_USD

布伦特 BZ_USD

天然气 NG_USD

错误码

code	含义	处理建议
200	成功	正常处理数据
400	参数错误	检查 symbol 参数是否正确
401	未授权	Token 无效或缺失，检查 token 参数
403	调用来源未授权	Token 已绑定域名/IP，当前来源不在允许范围；可去控制台调整绑定（清空绑定则不限制）
429	请求超限	调用间隔不足或日次数超限，等待间隔后重试或升级套餐
500	服务异常	服务暂不可用，稍后重试

代码示例

// 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 示例（URL 传 Token）
curl "https://api.222288.cn/api/v1.php?token=YOUR_TOKEN&symbol=AU_USD"

# cURL 示例（Header 传 Token，推荐）
curl -H "Authorization: Bearer YOUR_TOKEN" "https://api.222288.cn/api/v1.php?symbol=AU_USD"

频率限制

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

套餐	调用间隔	日次数
免费版	300s	200
基础版	20s	不限
专业版	15s	不限
企业版	5s	不限

注意：调用间隔为两次请求之间的最小等待时间。未达间隔的请求返回 429 并提示剩余等待秒数。建议客户端按间隔时间定时调用。