mirror of
https://ghfast.top/https://github.com/aeroxw/easy_tdx_max.git
synced 2026-09-12 14:34:18 +08:00
docs: README 开头重写为定位+四大能力总览(去版本号堆砌),补 CLI 新命令与 Web API 端点(板块总览/回测任务/策略库/自选/AI)
This commit is contained in:
@@ -8,49 +8,61 @@
|
|||||||
[](https://deepwiki.com/handsomejustin/easy_tdx)
|
[](https://deepwiki.com/handsomejustin/easy_tdx)
|
||||||
|
|
||||||
<img src="./docs/top_img.png" alt="头部宣传图" />
|
<img src="./docs/top_img.png" alt="头部宣传图" />
|
||||||
|
|
||||||
量化基金花百万买的毫秒级行情通道,散户连一根日线都要手动截图——这不是技术差距,这是数据霸凌。
|
量化基金花百万买的毫秒级行情通道,散户连一根日线都要手动截图——这不是技术差距,这是数据霸凌。
|
||||||
|
|
||||||
easy-tdx 要做的事很简单:**把机构的数据锁砸开,扔到每个普通人桌面。**
|
easy-tdx 要做的事很简单:**把机构的数据锁砸开,扔到每个普通人桌面。**
|
||||||
|
|
||||||
它是一个完全免费、无需注册、无需 API Key、纯开源的行**情核武器**。
|
它是一个完全免费、无需注册、无需 API Key、纯开源的 A 股量化工具箱。对通达信网络协议净室实现(不依赖通达信客户端,也能直接读写本地数据文件),一行命令即可拉取 K 线、报价、板块、资金流、分时、逐笔成交;Python API / CLI / Web API 三通道,输出 JSON 天然喂给 AI Agent。
|
||||||
一行命令,A股、港股、美股、期货——K线、报价、资金流向、板块轮动、分时明细、逐笔成交,**毫秒级拉满**。
|
|
||||||
|
|
||||||
**34个技术指标**(MACD、KDJ、RSI、BOLL……连”捉妖大师”和”30日乖离率信号”都给你算好)开箱即用。
|
## 四大能力
|
||||||
**缠论分析**(笔、中枢、买卖点、背驰)一键出结果——你不再需要手画分型、猜线段。
|
|
||||||
**内置回测引擎**——写个策略文件,一行命令跑回测,54 个经典策略自带(覆盖全部 50 个注册指标),多因子组合、策略选股扫描,批量对比哪个最赚钱一目了然。**防过拟合验证链**(v1.25 新增)——Walk-Forward 七窗样本外验证(每窗独立开仓)、训练/验证/测试三段适配性体检(8 项可解释检查 + 「高适配」标记)、0-100 综合评分、多 seed 晋级门槛、买入持有基准对比,回测页勾选即出报告——「回测好」升级为「样本外也好」。**深度风险报告**(v1.28 新增)——绩效指标扩到 25 项(新增 Ulcer 指数、95% 日 VaR/CVaR、SQN 系统质量数、最大连胜/连亏);基准对比从超额收益一个数升级为 α/β/信息比率/跟踪误差四件套(「涨的时候跟不跟得上大盘、跌的时候抗不抗跌」一眼可读);策略一行带移动止损与百分比止损止盈(`self.buy(trail_stop=0.08)` 涨得越高止损线跟得越高,OCO 任一触发即失效);引擎行为由黄金测试锁定——54 个内置策略的指标基线进 CI,撮合/费率逻辑任何静默漂移当场爆红。
|
|
||||||
|
|
||||||
**行情终端 Web UI**(v1.23 重大升级)——`easy-tdx serve` 一条命令,浏览器秒变专业看盘终端:**市场看板**(五大指数实时推送 + 迷你分时、涨跌统计、四维情绪雷达、全市场涨跌分布直方图、涨停雷达、行业/概念热冷榜、涨幅/跌幅/成交额/换手四联排行榜、两市异动雷达)、**自选行情**(输入 6 位代码即加,全表 SSE 实时刷新、行内迷你分时)、**个股详情弹窗**(五档盘口 + 1/3/5 日分时 + 带 MA/BOLL/MACD/KDJ/RSI 指标切换的日 K,一键加自选、一键全策略寻优)、**板块下钻**(行业/概念弹窗看板块走势 + 成分股涨跌榜直达个股)。实时推送采用 SSE 单循环轮询 fan-out 架构(盘中 8 秒一拍,无人订阅自动休眠),自选持久化 SQLite。展示层设计对标专业终端(暗色、红涨绿跌、高信息密度),数据全部来自通达信协议直连——不花一分钱。
|
### 🖥️ 行情终端(Web UI)
|
||||||
|
|
||||||
**🤖 AI 深度辅助:让 AI 读报告、陪你复盘(v1.29 重大升级)**——量化工具最大的门槛从来不是取数,而是**看不懂报告**:25 项绩效指标、Walk-Forward 逐窗、α/β/信息比率、S-D 评级……对普通人就是天书。v1.28.1 的「AI 解读 Prompt 导出」要把提示词复制出去手动粘贴;v1.29 起升级为**配置你自己的模型、一键直接解读**:
|
`easy-tdx serve` 一条命令,浏览器秒变专业看盘终端,全部板块级数据由协议直连、不花一分钱:
|
||||||
|
|
||||||
- **AI 设置页**——9 家 Provider 开箱即用(DeepSeek / 通义千问 / **智谱 GLM** / Kimi / MiniMax / OpenAI / Claude / Ollama 本地免 Key / 自定义任意兼容网关),API 地址与模型可改,连通性一键测试。配置落盘 `~/.easy_tdx/llm.json`,环境变量可兜底——**你的 Key 只属于你**,本工具不代管、不代理、不经手第三方。
|
- **市场看板**:五大指数实时推送(SSE)、全市场涨跌统计、四维情绪雷达、涨停雷达、两市异动雷达、全市场涨跌分布
|
||||||
- **✨ 一键直接解读**——回测页把整份报告(配置 + 25 项指标 + WF + 评估 + 评级 + 成交摘要)组装成提示词,点击后作为**后台任务**发给你配置的模型,前端轮询进度、实时显示已耗时,不占连接、刷新页面不丢结果。模型回来的是「做了十几年量化的老手朋友」口吻的通俗解读、改进建议与 0-10 信心分——**把读报告这件事外包给 AI,你只做决策**。
|
- **行业总览 / 概念总览**:全部板块一屏尽览(一级行业/二级行业/概念),热力图 + 表格双视图、板块广度统计与涨跌幅分布、涨幅/跌幅/涨速异动三榜、翻红/翻绿轮动时间线,点击板块下钻分时/日K + 成分股涨跌榜
|
||||||
- **AI 解读历史**——每次解读自动归档(提问 + 正文 + 当时的策略/参数/标的/区间),随时翻旧账对比「同一个策略上次 AI 怎么说」;每条带「→ 去回测(带参数)」一键复现当时场景,看完解读直接回去调参。
|
- **自选行情**:全表 SSE 实时刷新、行内迷你分时;**龙头池**:159 只核心龙头一键扫描
|
||||||
- **为 AI 时代做的工程加固**——思考型模型(GLM-5.x / DeepSeek-R1 等)思考链计入 token 预算导致正文空白?显式拦截并给出可操作提示;模型慢?读超时可调、后台任务不超时;解读内容一律标注「AI 生成,仅供参考,不构成投资建议」。
|
- **期货持仓排名**:中金所每日成交/持仓前 20 名会员一键采集(含新手科普)
|
||||||
|
- **个股详情弹窗**:五档盘口 + 1/3/5 日分时 + 带 MA/BOLL/MACD/KDJ/RSI 的日 K,一键加自选、一键全策略寻优
|
||||||
|
|
||||||
**这一步的意义**:取数自由(v1.0)→ 回测自由(v1.17)→ 防过拟合(v1.25)→ **认知自由(v1.29)**。前几步解决「数据与工具的不平等」,这一步解决「解读能力的不平等」——机构有研究员写晨报,你现在有自己的 AI 分析师。仍是 MIT 开源、零注册、零平台费,唯一成本是你自己模型的调用费(用 Ollama 本地模型连这个都是零)。
|
<img src="./docs/web-ui-page-4.png" alt="行情终端 Web UI:市场看板 / 行业概念总览 / 自选行情 / 个股与板块详情" />
|
||||||
|
|
||||||
**v1.29 同场加映**(借鉴社区 Fork [swimmingaaron/easy_tdx](https://github.com/swimmingaaron/easy_tdx) 的好想法,逐项甄别后移植):**交易时段感知刷新**(看板轮询休市自动暂停、三态状态栏、手动刷新不受限,不再半夜空转刷数据);**120 分钟 K 线**(MAC 原生两级降级获取)与**逐 bar 涨跌幅/振幅字段**(`pre_close`/`change_pct`/`amplitude_pct` 直接返回);**159 只核心龙头池**(东财全行业龙头名单 → `universe=core` 一键只扫龙头,配「龙头池」页面;名单仅为扫描范围,不构成任何推荐);全站**风险提示与免责声明**常驻。WebUI 工程加固:未知 API 路径返回 JSON 404 而非 HTML、入口页 `no-store` 防缓存旧版——更新即所见。
|
### 📊 回测工作台(Web UI + 回测引擎)
|
||||||
|
|
||||||
**期货持仓雷达:中金所成交持仓排名(v1.29.1 新增)**——每个交易日收盘后约 16:15,中金所官网公布各期货品种「成交量 / 持买单量(多单)/ 持卖单量(空单)」各前 20 名期货公司会员的排名,这是散户能免费看到的**最接近"主力动向"的公开数据**。本工具把它变成一键采集:CLI 一行命令(`easy-tdx ccpm IF --table`)、Web API(`GET /api/v1/ccpm/rank`)、WebUI「期货持仓排名」页(品种下拉 + 日期选择器 + 一键采集,合约页签自动标注主力合约,前 20 名合计多单/空单/净持仓概览,三组排名并排表格)。覆盖 IF 沪深300 / IH 上证50 / IC 中证500 / IM 中证1000 四大股指期货与 TS/TF/T/TL 2/5/10/30 年期国债期货;非交易日与未发布自动识别并可回溯最近交易日;每个交易日数据发布后不可变,按日落盘缓存(`~/.easy_tdx/cache/ccpm/`),历史二次查询零网络。页面附三段新手科普:「(代客)」是什么意思、多单/空单/加减仓怎么看、以及最重要的一条——**排名表看不出是套保还是投机,空单多 ≠ 看空市场**(股指期货空单大头常是机构套保盘)。
|
浏览器里选标的、挑策略、调参数,全程零代码;也可以走 CLI / Python API:
|
||||||
|
|
||||||
<img src="./docs/web-ui-page-4.png" alt="行情终端 Web UI(v1.23):市场看板 / 自选行情 / 个股与板块详情" />
|
- **回测引擎**:内置 54 个策略(覆盖全部 50 个注册指标),`init()/next()` 两函数写自定义策略,订单撮合/费率/滑点/移动止损齐备,引擎行为由黄金测试锁定
|
||||||
|
- **防过拟合验证链**:Walk-Forward 样本外验证(逐窗独立开仓)、训练/验证/测试三段适配性体检、0-100 综合评分、多 seed 晋级门槛、买入持有基准对比(α/β/信息比率/跟踪误差)
|
||||||
|
- **25 项绩效指标 + S/A/B/C/D 评级**:SQN、Ulcer、95% VaR/CVaR、最大连胜/连亏……评级不看收益率,只看风险调整后的持有体验
|
||||||
|
- **组合与寻优**:多标的组合回测、多策略资金分仓、参数网格寻优(单策略/一键全策略)、策略库 SQLite 持久化、策略选股全市场扫描
|
||||||
|
- **通达信公式**:不会 Python 也能玩——粘贴公式(`买入: CROSS(MA(C,5), MA(C,20));`)即可计算/选股/回测,30+ 函数白名单向量化求值,无未来数据
|
||||||
|
- **AI 解读**:配置你自己的模型(DeepSeek / 通义千问 / 智谱 GLM / Kimi / OpenAI / Claude / Ollama 本地免 Key 等 9 家 Provider),一键把整份回测报告变成「老手朋友」口吻的大白话 + 改进建议 + 信心分;解读历史自动归档、一键复现
|
||||||
|
|
||||||
**回测可视化 Web UI**(v1.17 新增)——Vue3 + ECharts 单页应用,浏览器里选标的、挑策略、调参数,K 线买卖点、净值回撤、25 项绩效指标一目了然。支持组合回测、参数网格寻优、多策略结果对比,**还能把好策略存进策略库(SQLite 持久化),勾选多个策略做资金分仓组合回测看综合表现**,全程零代码。v1.27 起新增「附加分析」开关:勾选后随回测自动跑 Walk-Forward 逐窗柱状图与一条龙评估报告(评分分项 / 高适配徽标 / 买入持有对比)。v1.28.1 起新手与 AI 辅助两连击:三个报告框内置**名词解释折叠帮助**(33 个词条讲清每项指标是什么、怎么算、怎么看,默认收起点击展开,重点粗体、阈值橙色、细节细体);回测报告一键导出 **AI 解读 Prompt**——把配置 + 25 项指标 + WF 逐窗 + 一条龙评估 + 评级 + 成交摘要组装成结构化提示词,复制发给 ChatGPT / Claude / DeepSeek / 豆包,即可获得「老手朋友」口吻的通俗解读、改进建议与 **0-10 信心分**(附「该不该执行」行动刻度)。
|
<img src="./docs/web-ui-page-5.png" alt="回测报告:评级徽章、25 项绩效指标与 AI 解读" />
|
||||||
|
|
||||||
**数据评级系统**(v1.17.14 新增)——回测结果顶部直接显示 **S/A/B/C/D 五档评级徽章**,1 秒判断「这个品种适不适合经常参与」。评级**不看收益率**(避免被近期大涨误导),只看风险调整后的持有体验:卡玛比率、最大回撤、胜率、利润因子、夏普、波动率六维加权 + 一票否决(系统亏损/深回撤/低胜率直接低评)。京东方那种「收益 126% 但胜率 35%、回撤 41%」的案例会评 **D 档**——明确告诉普通人「别碰,套牢后回本极难」。三个入口(单标的/组合/寻优)都有评级,长线低频策略不会被冤枉(交易少时只降权胜率维度,不否决整个评级)。
|
### 🔬 数据与指标
|
||||||
|
|
||||||
<img src="./docs/web-ui-page-5.png" alt="数据评级系统:S/A/B/C/D 五档评级徽章与评级明细" />
|
- **34 个技术指标**:MACD/KDJ/RSI/BOLL/DMI/ATR 到捉妖大师(ZHUOYAO)、30 日乖离率信号(BIAS_SIGNAL),支持自定义参数与分钟线
|
||||||
|
- **缠论分析**:K线合并 → 分型 → 笔 → 中枢 → 线段 → 买卖点 → 背驰,一键出结果,支持多级别联立
|
||||||
|
- **因子与组合**:19 个内置因子、IC/分层/衰减分析、4 种组合优化器 + 再平衡引擎、TWAP/VWAP 执行仿真与方根冲击滑点
|
||||||
|
- **数据底座**:本地 K 线仓库(DuckDB 增量同步 + 临时 bar 状态机 + 健康自检)、通达信本地文件离线读写、财报三表 / 通达信 F10 / 巨潮公告 / 新浪财经
|
||||||
|
|
||||||
**通达信公式 + 轮动组合**(v1.27 新增)——不会 Python 也照样玩:直接粘贴通达信公式(`买入: CROSS(MA(C,5), MA(C,20));`),命名布尔输出就是买卖信号,计算 / 全市场选股 / 回测一条龙(30+ 函数白名单向量化求值,无未来数据、不走 eval)。**轮动组合引擎**按排名定期换仓:固定槽位等额、跌出排名自动卖出补位、日/周/月调仓、槽内止盈止损,动量或公式数值输出都能当排名分。
|
### 🤖 AI Agent 友好
|
||||||
|
|
||||||
**本地 K 线数据仓库**(v1.26 新增)——拉过的行情自动沉淀为 DuckDB 单文件列存:增量同步只补缺口、15:05 前的当日 bar 标记临时值(回测默认忽略,杜绝拿盘中价当收盘价)、缺口/除权跳变/新鲜度健康自检。数据信任层同步加固:QFQ 前复权带双引擎对拍校验(公式法 vs 跳空检测法)、回测任务 SQLite 持久化(重启 serve 对比页历史不清空)、费率按品种自动区分(ETF/可转债免印花税)。
|
所有 CLI 默认输出 JSON(`--table` 切表格);`easy-tdx serve` 一键起 REST + WebSocket 服务,浏览器打开 `/docs` 就是交互式 API 文档——Claude Code、OpenClaw 等 Agent 直接吃。
|
||||||
|
|
||||||
装上就能跑。**Python API + CLI + Web API 三通道**,输出 JSON 天然喂给 AI Agent:Claude Code、OpenClaw、Hermes 直接吃。`easy-tdx serve` 一键起 REST 服务,浏览器打开就是交互式 API 文档。
|
<img src="./docs/cli-page-1.png" alt="CLI JSON 输出示例" />
|
||||||
|
|
||||||
<img src="./docs/cli-page-1.png" alt="CLI 三通道输出示例:JSON 行情数据" />
|
## 30 秒上手
|
||||||
|
|
||||||
<img src="./docs/web-ui-page-6.png" alt="Web API / Web UI 使用示意" />
|
```bash
|
||||||
|
pip install easy-tdx
|
||||||
|
easy-tdx ping # 服务器测速
|
||||||
|
easy-tdx kline SH 600519 --count 10 --table # K 线
|
||||||
|
easy-tdx serve # 行情终端 + 回测工作台(浏览器自动打开)
|
||||||
|
```
|
||||||
|
|
||||||
**你不懂 TCP 协议?不用。**
|
**你不懂 TCP 协议?不用。**
|
||||||
**你不会写量化框架?不用。**
|
**你不会写量化框架?不用。**
|
||||||
@@ -59,6 +71,10 @@ easy-tdx 要做的事很简单:**把机构的数据锁砸开,扔到每个普
|
|||||||
|
|
||||||
`pip install easy-tdx`,30秒后——你屏幕上的数据,和机构看到的**是同一份**。
|
`pip install easy-tdx`,30秒后——你屏幕上的数据,和机构看到的**是同一份**。
|
||||||
|
|
||||||
|
📖 **文档**:[GitHub Wiki](https://github.com/handsomejustin/easy_tdx/wiki)(各模块指南) ·
|
||||||
|
[回测系统完全上手手册](./docs/回测系统完全上手手册.html)(零基础图文,13 章) ·
|
||||||
|
[docs/](./docs) 目录(策略开发手册 / 量化指南 / API 字段参考)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**为什么做这个?**
|
**为什么做这个?**
|
||||||
@@ -73,8 +89,6 @@ easy-tdx 要做的事很简单:**把机构的数据锁砸开,扔到每个普
|
|||||||
随便用,随便改,随便分发。
|
随便用,随便改,随便分发。
|
||||||
**数据面前,人人平等。**
|
**数据面前,人人平等。**
|
||||||
|
|
||||||
📖 **详细用法请查看 [GitHub Wiki](https://github.com/handsomejustin/easy_tdx/wiki)**
|
|
||||||
|
|
||||||
## 项目架构
|
## 项目架构
|
||||||
|
|
||||||
<img src="./docs/easy-tdx-architecture.png" alt="easy-tdx 七层架构总览:接口 → 服务 → 领域 → 持久 → 网关 → 协议 → 外部源" />
|
<img src="./docs/easy-tdx-architecture.png" alt="easy-tdx 七层架构总览:接口 → 服务 → 领域 → 持久 → 网关 → 协议 → 外部源" />
|
||||||
@@ -560,12 +574,14 @@ easy-tdx warehouse check # 缺口 / 除权跳变
|
|||||||
|
|
||||||
Web UI 包含两大模块:
|
Web UI 包含两大模块:
|
||||||
|
|
||||||
- **行情终端(v1.23 新增)**——侧边栏专业终端布局:
|
- **行情终端**——侧边栏专业终端布局(行情:市场看板 / 行业总览 / 概念总览 / 自选行情 / 龙头池 / 期货持仓排名):
|
||||||
- **市场看板**:五大指数实时行情(SSE 推送)、全市场涨跌统计(涨/跌/平/涨停/跌停 + 堆叠条)、行业/概念板块热度榜、涨幅榜/跌幅榜、两市异动雷达(加速拉升/封涨停板/大单托盘等),点击个股打开五档盘口 + 分时/日K 对话框;
|
- **市场看板**:五大指数实时行情(SSE 推送)、全市场涨跌统计(涨/跌/平/涨停/跌停 + 堆叠条)、行业/概念板块热度榜、涨幅榜/跌幅榜、两市异动雷达(加速拉升/封涨停板/大单托盘等),点击个股打开五档盘口 + 分时/日K 对话框;
|
||||||
|
- **行业总览 / 概念总览**(v1.32.1):全部行业(一级/二级可切)/概念板块一屏尽览——板块广度统计条、涨跌幅分布直方图、热力图与表格双视图、搜索过滤、涨幅/跌幅/涨速异动三榜、翻红/翻绿轮动时间线,30s 自动刷新(休市暂停);点击板块复用详情弹窗(分时/日K + 成分股涨跌榜直达个股);
|
||||||
- **自选行情**:输入 6 位代码一键加自选(SQLite 持久化),全表实时刷新(SSE),行内迷你分时图,点击行看个股详情;
|
- **自选行情**:输入 6 位代码一键加自选(SQLite 持久化),全表实时刷新(SSE),行内迷你分时图,点击行看个股详情;
|
||||||
|
- **龙头池**:159 只核心龙头名单一键只扫龙头(名单仅为扫描范围,不构成任何推荐);
|
||||||
- **期货持仓排名**(v1.29.1):中金所每日成交/持仓前 20 名会员一键采集(品种下拉 + 日期选择 + 自动回溯最近交易日开关),合约页签自动标注主力,前 20 名合计多单/空单/净持仓概览,三组排名并排表格;附「品种一览」「多单空单加减仓怎么看」新手科普(重点:排名看不出套保还是投机,空单多 ≠ 看空市场);
|
- **期货持仓排名**(v1.29.1):中金所每日成交/持仓前 20 名会员一键采集(品种下拉 + 日期选择 + 自动回溯最近交易日开关),合约页签自动标注主力,前 20 名合计多单/空单/净持仓概览,三组排名并排表格;附「品种一览」「多单空单加减仓怎么看」新手科普(重点:排名看不出套保还是投机,空单多 ≠ 看空市场);
|
||||||
- **实时推送架构**:后端单条轮询循环 fan-out 到所有 SSE 连接(交易时段 ~8s 一拍,盘外降频 60s,无人订阅自动休眠),前端指数退避重连。
|
- **实时推送架构**:后端单条轮询循环 fan-out 到所有 SSE 连接(交易时段 ~8s 一拍,盘外降频 60s,无人订阅自动休眠),前端指数退避重连。
|
||||||
- **回测工作台(v1.17 起)**——浏览器里选标的、挑策略、调参数,K 线买卖点、净值回撤、25 项绩效指标一目了然。支持组合回测、参数网格寻优、多策略结果对比,还能把好策略存进策略库(SQLite 持久化),勾选多个策略做资金分仓组合回测看综合表现,全程零代码。
|
- **回测工作台**——浏览器里选标的、挑策略、调参数,K 线买卖点、净值回撤、25 项绩效指标一目了然。支持组合回测、参数网格寻优、多策略结果对比、策略库(SQLite 持久化)与多策略资金分仓、信号雷达、Walk-Forward / 一条龙附加分析、**AI 解读与解读历史**(分析:单标的回测 / 组合回测 / 参数寻优 / 结果对比 / 策略库 / 信号雷达 / AI 解读历史),全程零代码。
|
||||||
|
|
||||||
**前置条件:**
|
**前置条件:**
|
||||||
|
|
||||||
@@ -597,7 +613,7 @@ Windows 用户可以下载打包好的单一 EXE(约 80-150MB),双击即
|
|||||||
|
|
||||||
EXE 打包方法见 [`docs/packaging.md`](./docs/packaging.md)。
|
EXE 打包方法见 [`docs/packaging.md`](./docs/packaging.md)。
|
||||||
|
|
||||||
打开浏览器后,顶部导航栏有五个页面:
|
打开浏览器后,「分析」分组下是回测工作台的核心页面:
|
||||||
|
|
||||||
**1. 单标的回测**(首页 `/`)
|
**1. 单标的回测**(首页 `/`)
|
||||||
|
|
||||||
@@ -1223,6 +1239,39 @@ curl -X POST "http://localhost:8000/api/v1/indicator/compute" \
|
|||||||
curl -X POST "http://localhost:8000/api/v1/chanlun/analyze" \
|
curl -X POST "http://localhost:8000/api/v1/chanlun/analyze" \
|
||||||
-H "Content-Type: application/json" \
|
-H "Content-Type: application/json" \
|
||||||
-d '{"market": "SZ", "code": "000001", "category": "DAY", "count": 200}'
|
-d '{"market": "SZ", "code": "000001", "category": "DAY", "count": 200}'
|
||||||
|
|
||||||
|
# ── 板块总览(一次取全部板块:当日涨跌幅 + 涨速 + 3/5/20日/YTD 涨幅 + 领涨股,服务端 15s 缓存)──
|
||||||
|
# board_type: HY 行业一级 / HY2 行业二级 / GN 概念 / FG 风格 / DQ 地区
|
||||||
|
curl "http://localhost:8000/api/v1/board-mac/overview?board_type=HY"
|
||||||
|
curl "http://localhost:8000/api/v1/board-mac/overview?board_type=GN"
|
||||||
|
|
||||||
|
# ── 回测任务(WebUI 回测工作台同款后端)──
|
||||||
|
# 列出内置策略及参数 schema
|
||||||
|
curl "http://localhost:8000/api/v1/backtest/strategies"
|
||||||
|
# 提交异步回测(strategy 见 /backtest/strategies;完整字段与 portfolio/multi/optimize/wf/evaluate
|
||||||
|
# 各端点的请求体以 /docs 的 Swagger 为准),返回 task_id
|
||||||
|
curl -X POST "http://localhost:8000/api/v1/backtest/run/async" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"strategy": "ma_cross", "symbol": "SZ:000001", "category": "DAY", "count": 2000}'
|
||||||
|
# 轮询任务结果(对比页/导出亦走 /backtest/tasks)
|
||||||
|
curl "http://localhost:8000/api/v1/backtest/tasks/<task_id>"
|
||||||
|
|
||||||
|
# ── 策略库(保存的策略持久化 SQLite)──
|
||||||
|
curl "http://localhost:8000/api/v1/strategies"
|
||||||
|
|
||||||
|
# ── 自选股 ──
|
||||||
|
curl "http://localhost:8000/api/v1/watchlist"
|
||||||
|
curl -X POST "http://localhost:8000/api/v1/watchlist" \
|
||||||
|
-H "Content-Type: application/json" -d '{"market": "SH", "code": "600519", "name": "贵州茅台"}'
|
||||||
|
|
||||||
|
# ── AI 解读(模型 Key 只存本地 ~/.easy_tdx/llm.json)──
|
||||||
|
curl "http://localhost:8000/api/v1/llm/config" # 当前配置 + Provider 预设
|
||||||
|
curl -X POST "http://localhost:8000/api/v1/llm/chat/async" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"prompt": "解读这份回测报告:..."}' # 后台任务,GET /llm/chat/tasks/{id} 轮询
|
||||||
|
|
||||||
|
# ── 交易时段(自动刷新门控用)──
|
||||||
|
curl "http://localhost:8000/api/v1/market/session"
|
||||||
```
|
```
|
||||||
|
|
||||||
### WebSocket 实时行情
|
### WebSocket 实时行情
|
||||||
@@ -1307,13 +1356,25 @@ uvicorn.run(app, host="0.0.0.0", port=8000)
|
|||||||
| `factor analyze` | 因子分析(IC/分层/衰减) |
|
| `factor analyze` | 因子分析(IC/分层/衰减) |
|
||||||
| `pfactor backtest` | 组合因子选股回测 |
|
| `pfactor backtest` | 组合因子选股回测 |
|
||||||
| `run-all` | 批量运行所有策略并排名(绩效排名 + 综合评分 + 可选图表) |
|
| `run-all` | 批量运行所有策略并排名(绩效排名 + 综合评分 + 可选图表) |
|
||||||
|
| `optimize` | 参数网格寻优(单策略网格搜索,或 `--all` 一键寻优所有内置策略并排名) |
|
||||||
|
| `strategies` | 列出内置策略注册表(名称/中文标签/参数默认值/预设寻优网格) |
|
||||||
|
| `formula compute` | 通达信公式计算(命名布尔输出即买卖信号) |
|
||||||
|
| `formula screen` | 公式批量选股(信号在最后一根 = 1 的标的) |
|
||||||
|
| `formula backtest` | 公式回测(买/卖列自动挑选,输出绩效 + 评级 + 评分) |
|
||||||
|
| `warehouse sync` | 本地 K 线仓库增量同步(DuckDB,需 `easy-tdx[warehouse]`) |
|
||||||
|
| `warehouse query` | 仓库查询(默认忽略未收盘的临时 bar) |
|
||||||
|
| `warehouse stats` | 仓库统计(各标的行数/数据范围) |
|
||||||
|
| `warehouse check` | 仓库健康自检(缺口/除权跳变/新鲜度) |
|
||||||
|
| `ccpm` | 中金所成交持仓排名(官网每日发布,按日落盘缓存) |
|
||||||
|
| `announcement` | 公告检索(巨潮资讯网,独立数据源,支持下载 PDF) |
|
||||||
| `screen scan` | 策略选股扫描(纯离线,全市场信号扫描) |
|
| `screen scan` | 策略选股扫描(纯离线,全市场信号扫描) |
|
||||||
| `screen rank` | 扫描结果回测排名(按夏普/回撤等指标排序) |
|
| `screen rank` | 扫描结果回测排名(按夏普/回撤等指标排序) |
|
||||||
|
| `screen strength` | 强势股排名(5/20/60 日涨幅加权,steady/breakout/balanced 三预设) |
|
||||||
| `serve` | 启动 Web API 服务器(REST + WebSocket,需 `easy-tdx[web]`) |
|
| `serve` | 启动 Web API 服务器(REST + WebSocket,需 `easy-tdx[web]`) |
|
||||||
| `f10` | 财报三表(新浪:利润表/资产负债表/现金流量表) |
|
| `f10` | 财报三表(新浪:利润表/资产负债表/现金流量表) |
|
||||||
| `finance-info` | 最新财务快照(通达信协议,30+ 项单期指标) |
|
| `finance-info` | 最新财务快照(通达信协议,30+ 项单期指标) |
|
||||||
| `company-info` | F10 公司信息(无板块名列目录 / 有板块名读正文) |
|
| `company-info` | F10 公司信息(无板块名列目录 / 有板块名读正文) |
|
||||||
| `fund-flow` | 历史资金流向 |
|
| `fund-flow` | 历史资金流向(CLI 暂未实现,Web API `/fund-flow/history` 可用) |
|
||||||
| `ex kline` | 扩展市场 K 线 |
|
| `ex kline` | 扩展市场 K 线 |
|
||||||
| `ex quote` | 扩展市场报价 |
|
| `ex quote` | 扩展市场报价 |
|
||||||
| `ex quote-list` | 扩展市场商品列表 |
|
| `ex quote-list` | 扩展市场商品列表 |
|
||||||
|
|||||||
Reference in New Issue
Block a user