trading skills: 文档同步 (单币上限规则/平仓盈亏字段/静默规则/推送模板)

2026-09-25 01:25:13 +08:00
parent c83161d87e
commit f46abb8ca3
111 changed files with 12151 additions and 224 deletions
@@ -0,0 +1,34 @@
+# A股券商账户 API 接入调研 (2026-09-14, 中泰证券)
+
+**用户问题**: "能接入同花顺的接口获取账户信息吗?" → 券商是**中泰证券**
+
+## 核心结论
+
+1. **同花顺没有官方账户 API** — 行情/财务数据可以 (AKShare, 已有 tonghuashun skill), 但**个人账户信息 (资金/持仓/委托) 无开放接口**。iFinD 是机构付费数据终端, 不含个人账户。
+2. **中泰 XTP = 中泰证券自研量化平台** — 中泰客户先天条件最好, 唯一官方正路。
+
+## 路线对比
+
+| 路线 | 能拿到什么 | 门槛 | 备注 |
+|---|---|---|---|
+| **中泰 XTP 量化版** | 官方 API: 资金/持仓/委托/成交 + 程序化下单, Linux C++/Python SDK | 营业部申请, 常见说法 50 万起 (各营业部执行不一, 部分可谈), 需签量化协议 + 测试 | 官网 xtp.zts.com.cn (SPA 页面, curl 只能拿到空壳, 需浏览器渲染) |
+| 中泰齐富通 App 条件单 | 只有预设条件单, 无账户查询 API | 无 | 不符合 API 需求 |
+| easytrader (开源) | 模拟登录同花顺客户端读资金/持仓, 可下单 | 需 **Windows** 跑同花顺 PC 客户端 (Linux 要开 VM); 客户端升级易挂 | 兜底方案 |
+| 券商量化 API (换券商) | 官方稳定 | 华鑫奇点 / 中泰 XTP / 国君; QMT/PTrade 多数 50 万门槛, 部分券商 QMT 10 万可开 | XTP 开不了时的替代 |
+| 长桥 LongPort (已在用) | 港美股账户 + 行情 + **期权 0DTE** | 无 | 无 A 股 |
+
+## 实操建议 (给用户的话术)
+
+1. 打中泰客服 95538 或找客户经理, 问: "XTP 量化版开通的具体资金门槛" + "个人客户申请材料和测试流程"
+2. 门槛谈不下来 → 换低门槛券商开量化账户 (华鑫奇点 / 部分券商 QMT 10 万)
+3. 资产规模决定可行性 — 先问用户量级再推进流程, 别白折腾
+
+## 本次 session 工具状态 (勿当持久约束)
+
+- CamoFox browser MCP 连接失败 (CONNECTION_REFUSED), XTP 官网 SPA 无法渲染 → 门槛细节**未网络验证**, 基于训练知识, 已向用户标注"建议客服确认"
+- Bing 搜索摘要抓取无有效结果
+
+## 触发词
+
+- "同花顺 接口 / 账户信息" / "券商 API" / "中泰 / XTP" / "QMT / PTrade" → 本 reference
+- 用户问"能不能接 X" → 先列路线对比表 (不推卸, § 31 禁止过度防御)
@@ -0,0 +1,67 @@
+# 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** (官方实时)。