数据接口

免费 · 公开 · CC BY 4.0 · 最后更新 2026-09-20

这是什么

本站每日的黄金宏观读数有一个机器可读的 JSON 接口：字段稳定、每个字段自带数据来源与截止日，供 AI Agent、脚本与研究者直接引用，不必解析页面 HTML。

接口返回的数字与主页同源同口径——来自同一次数据快照、同一套代码，所以不存在「接口说的和页面上写的不一样」。

端点

端点	内容	更新
`GET /readings.json`	全部读数（JSON，约 60 KB）	每日 2 次 + 价格每 30 分钟
`GET /latest.json`	同上（别名）	同上
`GET /readings.en.json`	英文版读数：字段路径与中文版完全一致，字符串值（单位、来源、口径说明）为英文，`lang: "en"`；数字来自同一份快照	同上
`GET /brief.en.md`	英文版当日简报（Markdown，几 KB）	每日 2 次
`GET /brief.md`	当天关键数字的纯文本简报（Markdown，很小）	每日 2 次
`GET /llms.txt`	写给大模型的站点说明书	每日 2 次
`GET /d/YYYY-MM-DD.html`	某一期的存档页（URL 永久稳定，可回溯）	每日新增一期
`GET /d/`	存档索引（爬虫可从此处抵达每一期）	每日
`GET /topic/`	指标口径与专题解读	每周
`GET /sitemap.xml`	站点地图	每日

快速开始

$ curl -s "https://xaudaily.com/readings.json?src=your-app" | head -40

Python（仅标准库）：

import json, urllib.request
url = "https://xaudaily.com/readings.json?src=your-app"
with urllib.request.urlopen(url, timeout=20) as r:
    d = json.load(r)
print(d["data_asof"], d["readings"]["au"]["last"])

请保留 ?src= 查询参数。 它是渠道标识（例如 ?src=my-trading-bot）：带该参数的请求会走 Cache-Control: no-store、每次都回到源站，于是我们统计得到「哪些应用在用这份数据」—— 这是本站能持续免费提供它的依据。去掉参数不会报错，但统计不到你。

字段结构

readings 下有 11 个键：gold（COMEX 金价）、au（沪金）、 cpi、pce、nfp（非农）、ppi、dxy、 gdp、treasury（美债 10Y/30Y）、oil（布伦特/WTI），以及 extra（VIX、SPDR 持仓、联邦基金利率、Polymarket 决议概率、ADP、挑战者裁员、央行购金、驱动因子评分、事件预判等）。

要点：每个字段的载荷形状并不相同，统一的只有下面那层「信封」。引用前请先确认你要的字段长什么样，别假设所有字段都有 value：

字段	载荷形状	单位
`gold`	`rows`：日线 OHLC 数组（元素 `{"d","o","h","l","c"}`，约 120 根）；另有 `live`＝实时 tick（`{"last","chg","chg_pct","date","time","source"}`）。顶层没有 `last`：要「当前价」用 `gold.live.last`，要「收盘价」用 `gold.rows[-1].c`，两者不是一回事	美元/盎司
`au`	`last`、`chg1d`（%）、`spark`（近期序列）	元/克
`cpi` / `pce` / `ppi` / `nfp`	`months[]` 与 `vals[]` 按下标一一对齐；另有 `published`、`stale`	% 同比 / 万人
`treasury`	`y10` / `y30`，各含 `dates[]`、`vals[]`，以及派生量 `last`、`chg5`、`chg20`、`slope20`、`trend`、`pctile52`	%
`oil`	`brent` / `wti`，结构与 `treasury` 同	美元/桶
`dxy`	`dates[]` + 对应序列（结构同 `treasury`）	指数
`gdp`	`quarters`：对象数组 `{"q","val"}`——不是 `months[]`/`vals[]` 那种平行数组，别按 cpi 的写法去取	% 年化环比
`extra.vix` / `extra.spdr`	`value` + `date`（SPDR 另有 `changePct`）	指数 / 吨
`extra.polymarket`	`cut50`、`cut25`、`hold`、`hike25`… 隐含概率；另有 `meetingDate`、`closed`——标明是哪一次会议、该市场是否已结算（`closed:true` 时是已开奖的结果，不是前瞻定价，别当预测用）	0~1
`extra.debt`	`debtPctGdp`（`debtQ` 为其季度）与 `netInterest`（`netInterestQ` 才是它的季度——两条 FRED 序列 vintage 不同，`netInterestQ` 常比 `debtQ` 新一个季度）	% / 十亿美元（年化）——这是字段的原始单位；站内中文展示一律换算为「亿美元」（×10）
`extra.drivers` / `extra.events`	9 因子规则化评分（-100 利空 ~ +100 利多）/ 事件预估与区间	分 / —

统一约定（每个字段都遵守）

source：该字段的数据来源，逐项标注
asOf / date：数据截止日（不是抓取时间）——官方统计本身滞后数周至数月
stale：某数据源抓取失败时，会沿用上一次成功值并置 stale: true。引用前请检查这个标记，不要把陈旧值当成当日数据
units：字段 → 单位的映射表（在顶层，不在各字段里）
schema：接口版本号，当前 xaudaily.readings/v1。字段只新增，不改名、不删除；若将来必须做破坏性变更，会升版本号并在本页说明

返回示例（节选，实际字段更全）

{
  "schema": "xaudaily.readings/v1",
  "generated_at": "2026-09-19 00:00 JST",
  "data_asof": "2026-09-19 00:00",
  "units": { "gold": "USD/oz", "cpi": "% 同比", "nfp": "万人（新增非农）" },
  "site": { "home": "https://xaudaily.com/", "daily_archive": "https://xaudaily.com/d/2026-09-19.html" },
  "readings": {
    "gold": { "label": "COMEX GC 连续", "unit": "美元/盎司", "source": "...", "asOf": "2026-09-18",
              "stale": false,
              "rows": [ { "d": "2026-04-06", "o": 4701.7, "h": 4733.1, "l": 4626.2, "c": 4675.6 } ],
              "live": { "last": 4386.71, "chg": 5.11, "chg_pct": 0.12, "date": "2026-09-18",
                        "time": "23:42:34" } },
    "au":   { "label": "沪金 Au99.99 连续", "unit": "元/克", "source": "...", "asOf": "2026-09-18",
              "last": 951.38, "chg1d": 1.75, "spark": [ 948.2, 949.94 ] },
    "cpi":  { "source": "...", "asOf": "2026-08", "published": "2026-09-11", "stale": false,
              "months": [ "2026-07", "2026-08" ], "vals": [ 3.3, 3.4 ] }
  },
  "meta": { "attribution": "引用请注明来源 xaudaily.com。" }
}

更新节奏

06:30 / 22:40（东京时间）：全量刷新——隔夜美盘收盘后、美国数据发布后各一次
每 30 分钟：金价与沪金的实时 tick 单独刷新（只更新价格类字段）
概率与预判是规则模型输出，不是承诺；本站把模型概率与 Polymarket 的市场定价分开标注，不混为一谈

可嵌入的金价徽标（免费，不用注册）

如果这份数据对你的读者有用，可以把一枚跟着金价刷新的徽标嵌到你的网站、博客或 README 上：图像由本站托管，你不需要自己维护。

<a href="https://xaudaily.com/?utm_source=widget&amp;utm_medium=embed&amp;utm_campaign=gold-badge">
  <img src="https://xaudaily.com/widget/gold-badge.svg" width="320" height="96"
       alt="今日金价 · 黄金读数 xaudaily.com">
</a>

约 2.7 KB 的 SVG，跟着金价约 30 分钟刷新一次（另有每日两次全量更新）；
深色站点用 /widget/gold-badge-dark.svg；预览、复制按钮与三种写法见挂件说明页；
配色是中国习惯（红涨绿跌）——面向英文读者请在嵌入处补一句说明，或直接看箭头方向；
可点击的链接必须由外层 <a> 包裹 <img> 实现（用 <img> 加载的 SVG，其内部链接点不动）；
请不要把图下载后自托管——那样它会停在旧价，也丢失归因。

许可与署名

本站数据以 CC BY 4.0 提供：可自由使用、转载、再分发，但必须署名并附链接。

推荐署名格式（请照抄，链接不要去掉）：

数据来源：黄金读数 xaudaily.com（https://xaudaily.com/）

英文场景：

Source: Gold Data Reading, xaudaily.com — https://xaudaily.com/

若要把数据再包装成「自有数据源」发布、或需要更宽松的条款，请先邮件联系 xaudaily@163.com。

免责

本站不构成投资建议，不提供买卖指导。所有数字经程序校验、与主页同源，但不保证适合任何特定用途；使用风险由使用者自行承担。

常见问题

这个接口收费吗？有限流吗？

免费，不需要注册或 API Key。没有硬性限流，但它是静态文件且带缓存头，请不要高频轮询——数据每天只更新两次（价格类字段每 30 分钟），分钟级轮询没有意义。

为什么带 `?src=` 参数后响应头变成 `no-store`？

故意的：带 ?src= 的请求绕过 CDN 边缘缓存直接回源，以便按渠道统计使用量；不带参数则走正常缓存（max-age=300），更省带宽。

可以按历史日期取数吗？

JSON 只提供当日快照（gold.rows 内含约 120 根日线，本身即有历史）。按日期的历史读数请用 /d/ 存档页，每天一个永久稳定的 URL。（见历史存档）

数据可以直接用于交易决策吗？

不建议。它是日报而非行情终端：每日两次更新（价格 30 分钟），且官方统计本身有滞后。用于研究、看板、写作与 AI 引用更合适。