跳到正文
Agent 接入

把 Stablecoin Club 接进你的 Agent

MCP、RSS、API 三种方式读的是同一份数据：精选、热点、日报、周报和月报，按你用的工具选一种就行。全部匿名只读，不用注册，也不用 API Key。

服务正常版本 5.0.0匿名只读 · 无需 Key
MCP填一个地址，多出 7 个工具RSS复制地址，用阅读器订阅REST API匿名 GET，自己写程序取数
REST API · 5.0.0

匿名 GET，拿来就能用

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

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

用得省，也更快

  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://stablecoin.club/api/v1/items?mode=selected&window=24h&limit=20'
# 之后最快每分钟一次，带上 ETag；返回 304 就是没变化
curl --compressed -i -H 'If-None-Match: <上次的 ETag>' 'https://stablecoin.club/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。

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