跳到正文
JINMAI / OPEN RESEARCH
金脉 · 数据接入台

让黄金研究,
进入你的工作流。

把金脉整理的消息、事件脉络与市场简报带到你的研究助手、阅读器或程序中。从原文线索出发,让每次查询都有出处。

基础服务可达接口 5.0.0公开读取 · 无需 Key

消息线索

检索精选与公开动态,保留摘要、时间和来源。

事件脉络

沿热点事件的时间线,继续查找相关报道。

市场简报

按日期读取日报、周报与月报,回到当期材料。

START WITH A QUESTION

从一个有出处的问题开始

先选接入方式,完成连接,再让助手检索。示例问题可以直接复制;实际结果以工具返回为准。

请检索金脉最近 24 小时有关央行购金的公开消息,列出材料时间、已确认事实、仍待核实的信息,并附来源链接。没有找到时请明确说明。
REST API · 5.0.0

匿名 GET,拿来就能用

不用 token;浏览器跨域、curl 和各语言默认的 HTTP 客户端都能直接调。路径是 /api/v1,字段和错误码以 OpenAPI 为准。

第一个请求
curl --compressed 'https://aurhot.cn/api/v1/items?mode=selected&window=24h&limit=20'

按分类筛选

在资讯请求中加上 category,只取对应分类;不传则包含全部分类。返回条目的 category 也使用下表中的值。

分类请求参数
各国央行category=central-banks
黄金ETFcategory=etf
美联储category=fed
原油category=oil
美债收益率category=treasuries
军事政治category=geopolitics
宏观动态category=macro
市场行情category=market
产业动态category=industry
观点category=opinion

用得省,也更快

  1. 01
    开压缩

    curl 加 --compressed,其他客户端打开 gzip 或 br。JSON 压缩后只有原来的 1/4 到 1/8。

  2. 02
    带上 ETag

    保存响应里的 ETag,下次带 If-None-Match;内容没变时返回 304,不传正文。

  3. 03
    按节奏取

    资讯和热点最快一分钟一次;日报每天 08:00 后取一次,周报、月报出刊后取一次;往回翻页翻到已有的那条就停。

内容多久变一次:新资讯全天陆续进来,精选每天变几次到几十次,日报每天 08:00、周报每周一 10:00、月报每月 1 日 10:30(北京时间)各一期。

接口一览

路径用来做什么多久取一次
资讯
/api/v1/items精选或最近 7 天全部动态,可按分类、时间窗、关键词筛最快 1 分钟一次
热点与事件
/api/v1/hot-topics当前热点榜 Top 10最快 1 分钟一次
/api/v1/stories/{publicId}一个事件的报道时间线、AI 综述和关联事件需要时
日报
/api/v1/dailies/latest最新一期日报每天 08:00 后一次
/api/v1/dailies/{date}指定日期日报;撤稿会移除引用缓存过期后使用前验证 ETag
/api/v1/dailies日报日期索引每天一次
周报与月报
/api/v1/weeklies/latest最新一期周报:头条、总述和一周重点,按栏目分好每周一 10:00 后一次
/api/v1/weeklies/{week}指定一周,ISO 周如 2026-W39;撤稿会移除引用缓存过期后使用前验证 ETag
/api/v1/weeklies周报索引每周一次
/api/v1/monthlies/latest最新一期月报每月 1 日 10:30 后一次
/api/v1/monthlies/{month}指定月份,如 2026-09缓存过期后使用前验证 ETag
/api/v1/monthlies月报索引每月一次
给 AI 助手
/api/v1/agent给 Agent 的使用说明,列出的地址返回整理好的中文 Markdown需要时
完整精选同步
/api/v1/selected/snapshot当前全部精选,分页一次拿全只在第一次
/api/v1/selected/changes之后的新增、修改和撤选几分钟一次

常见用法

bash
# 第一次:保存响应头里的 ETag
curl --compressed -i 'https://aurhot.cn/api/v1/items?mode=selected&window=24h&limit=20'
# 之后最快每分钟一次,带上 ETag;返回 304 就是没变化
curl --compressed -i -H 'If-None-Match: <上次的 ETag>' 'https://aurhot.cn/api/v1/items?mode=selected&window=24h&limit=20'

需要往回翻页时,把 page.nextCursor 作为 cursor 传回去,翻到已经有的那条就停,不要每次把 7 天重翻一遍。

出错了怎么办

400
参数不对:按 OpenAPI 和返回的 code 修正,不要自动换成更宽的查询。cursor 无效或滑出时间窗返回 invalid_cursor,从第一页重来。
409
snapshot_required:增量没法安全续上,重新取一次完整快照。
429
请求太密:按 Retry-After 等待,不要并发重试。
5xx
指数退避,先用上次成功的结果;公开服务不承诺 SLA。

能匿名调用不等于所有用途都获许可,见使用规则。