# 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)

```bash
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
```

返回 (例):
```json
{
  "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)

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

## 比 akshare 的优势

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

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