fuyao.aicubes.cn 同花顺官方 REST API (2026-09-19 发现)

背景: akshare stock_fhps_em / stock_fhps_detail_ths 接口是同花顺网页抓取——

官方源: fuyao.aicubes.cn 提供官方同花顺 REST API + MCP tool。

接入信息

Base URL: https://fuyao.aicubes.cn
Auth Header: X-api-key: <your-key> (用户已有 sk-fuyao-...)
文档: https://fuyao.aicubes.cn/llms.txt (有全站文档索引)

A 股相关接口

需求	接口	字段
A 股分红事件流	`/api/a-share/corporate-actions/adjustment-factors?thscode=600519.SH&limit=5`	`dividend_per_share` (元/股), `ex_date_ms`, `per_share_bonus`, `ticker`
估值快照	`/api/a-share/valuations/snapshot?thscodes=603165.SH`	`pe_ttm`, `pb_mrq`, `ps_ttm`, `pcf_ttm` (无 dividend_yield)
股票列表	`/api/meta/tickers/list`	按资产类型分页
标的检索	`/api/meta/tickers/search?q=600519`	按代码/名称

已知限制

❌ 没有现成的 TTM 股息率字段 (同花顺 APP 内部算)
✅ 有完整事件流 (按 ex_date_ms 自己 sum dividend_per_share 算 TTM)
✅ 同花顺 APP "财年滚动 TTM" 算法 = 实施日 + 365d 滚动 ± 0.01-0.1%

实战 (9/19)

curl -s -H "X-api-key: sk-fuyao-..." \
  "https://fuyao.aicubes.cn/api/a-share/corporate-actions/adjustment-factors?thscode=603165.SH&limit=30" | python3 -m json.tool | head -40

返回 (例):

{
  "code": 0,
  "data": {
    "item": [
      {"ticker": "603165", "ex_date_ms": 1782403200000, "dividend_per_share": 0.6, "per_share_bonus": 0},
      {"ticker": "603165", "ex_date_ms": 1766073600000, "dividend_per_share": 1.1, ...},
      ...
    ]
  }
}

注意: akshare 也提供 ak.stock_fhps_detail_ths 同字段接口——两边都可用, fuyao 是官方权威源, akshare 是同花顺抓取, 数据一致.

A 股高息选股推荐做法 (9/19 v5)

粗筛: 东方财富 stock_fhps_em(date='YYYYMMDD') 1 拉 3700 只 (3 秒)
校验: fuyao.aicubes.cn / akshare ths 单只查 stock_fhps_detail_ths(symbol=) (0.5 秒/只, 8 线程并行)
输出: 用同花顺字段 "税前分红率" (财年滚动) TTM

比 akshare 的优势

项	akshare	fuyao.aicubes.cn
同花顺 APP 算法	✓	✓ (官方, 一致)
限流	经常被反爬挡	不限 (用户付费)
鉴权	无	`X-api-key`
MCP 工具	❌	✅ (同花顺 MCP server)
数据延迟	偶尔	官方实时

未来: 如果 fuyao 提供 TTM 股息率字段, 优先用 fuyao (官方实时)。

2.6 KiB Raw Blame History