68 lines
2.6 KiB
Markdown
68 lines
2.6 KiB
Markdown
# 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** (官方实时)。
|