@weaxs/openclaw-stock-analysis 0.2.12 → 0.2.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/dist/index.js +35 -2
- package/openclaw.plugin.json +1 -0
- package/package.json +1 -1
- package/scripts/tool-calls.mjs +4 -0
- package/skills/bull-trend/SKILL.md +2 -2
- package/skills/bull-trend/references/fat-tails.md +76 -3
- package/skills/bull-trend/scripts/tail_analysis.py +92 -3
- package/skills/market-review/SKILL.md +1 -0
- package/skills/stock-analysis/SKILL.md +4 -1
- package/skills/stock-screener/SKILL.md +1 -1
- package/skills/strategy-backtest/SKILL.md +1 -1
- package/tools/capabilities.py +1 -0
- package/tools/cli_budgets.json +0 -1
- package/tools/credit_data.py +293 -0
- package/tools/name_resolver.py +33 -80
- package/tools/screener.py +35 -26
- package/tools/sec_edgar.py +2 -1
- package/tools/stateless_analysis.py +17 -19
- package/tools/stock_data.py +592 -643
- package/tools/tool_schemas.json +31 -1
- package/tools/value_data.py +59 -43
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Stock Analysis — OpenClaw Plugin
|
|
2
2
|
|
|
3
|
-
A股 / 港股 / 美股 / 日股 / 韩股 / 台股 行情、技术分析、筛选与回测。OpenClaw Gateway 加载后即可在对话中调用
|
|
3
|
+
A股 / 港股 / 美股 / 日股 / 韩股 / 台股 行情、技术分析、筛选与回测。OpenClaw Gateway 加载后即可在对话中调用 75 个工具。
|
|
4
4
|
|
|
5
5
|
## 安装
|
|
6
6
|
|
|
@@ -27,7 +27,7 @@ npm install
|
|
|
27
27
|
|
|
28
28
|
## 工具与 Skills
|
|
29
29
|
|
|
30
|
-
|
|
30
|
+
75 个工具覆盖行情与基金净值、技术分析与 K 线形态、资金流与板块、估值/股东/ETF/股息、公告与 SEC、多因子选股、策略回测、市场复盘、新闻舆情、持仓风险与调仓计算。完整列表见[主仓库 README · 工具列表](https://github.com/Weaxs/stock-analysis-plugin#工具列表),Skills 见 [Skills 一览](https://github.com/Weaxs/stock-analysis-plugin#skills-一览)。
|
|
31
31
|
|
|
32
32
|
## 其他宿主
|
|
33
33
|
|
package/dist/index.js
CHANGED
|
@@ -29,7 +29,6 @@ var cli_budgets_default = {
|
|
|
29
29
|
"risk_screening.py:screen": 450,
|
|
30
30
|
"signal_tracker.py:evaluate": 300,
|
|
31
31
|
"stock_data.py:market_stats": 240,
|
|
32
|
-
"name_resolver.py:resolve": 360,
|
|
33
32
|
"import_parser.py:parse": 360,
|
|
34
33
|
"market_review.py:review": 300,
|
|
35
34
|
"anomaly_detect.py:detect": 390,
|
|
@@ -535,6 +534,36 @@ var tool_schemas_default = [
|
|
|
535
534
|
]
|
|
536
535
|
}
|
|
537
536
|
},
|
|
537
|
+
{
|
|
538
|
+
name: "get_cds_index",
|
|
539
|
+
description: "\u67E5\u8BE2\u5E02\u573A\u7EA7CDS\u6307\u6570\u4F5C\u4E3A\u4FE1\u7528\u98CE\u9669\u504F\u597D\u80CC\u666F\uFF08\u975E\u4E2A\u80A1CDS\u6216\u4EA4\u6613\u4FE1\u53F7\uFF09\u3002source=cn\u8FD4\u56DE\u4E2D\u56FD\u8D27\u5E01\u7F51CFETS-SHCH\u9AD8\u7B49\u7EA7/\u6C11\u4F01/\u957F\u4E09\u89D2/\u79D1\u521B/\u78B3\u4E2D\u548C\u5728\u5CB8CDS\u6307\u6570\u6700\u65B0\u671F\u9650\u66F2\u7EBF\uFF08bp\uFF09\u4E0E\u7A97\u53E3\u5185\u5404\u671F\u9650\u53D8\u5316\uFF08percentile\u4E3A\u7A97\u53E3\u5185\u2264\u6700\u65B0\u503C\u7684\u767E\u5206\u6BD40..100\uFF09\uFF1Bsource=global\u53D6DTCC\u516C\u5F00\u6210\u4EA4\uFF0C\u6309\u65E5\u6C47\u603B\u5F53\u524D5Y\u7CFB\u5217CDX.NA.IG\u3001iTraxx Europe/Crossover\u5229\u5DEE\uFF08bp\uFF09\u4E0ECDX.NA.HY\u4EF7\u683C\uFF08\u4EF7\u683C\u4E0B\u8DCC=\u4FE1\u7528\u8D70\u5F31\uFF09\uFF0C\u53EA\u6BD4\u8F83\u540C\u4E00\u5230\u671F\u7CFB\u5217\uFF0C\u662F\u6210\u4EA4\u4E2D\u4F4D\u6570\u800C\u975E\u5B98\u65B9\u6536\u76D8\u3002\u7528index/tenor\u53EA\u53D6\u9700\u8981\u7684\u6307\u6570\u548C\u671F\u9650\uFF0Ccn\u5386\u53F2\u53EA\u4E3A\u5339\u914D\u5230\u7684\u6307\u6570\u5206\u9875\u62C9\u53D6\u3002",
|
|
540
|
+
parameters: {
|
|
541
|
+
type: "object",
|
|
542
|
+
properties: {
|
|
543
|
+
source: {
|
|
544
|
+
type: "string",
|
|
545
|
+
enum: [
|
|
546
|
+
"cn",
|
|
547
|
+
"global"
|
|
548
|
+
],
|
|
549
|
+
description: "cn=\u4E2D\u56FD\u5728\u5CB8CDS\u6307\u6570\uFF08\u9ED8\u8BA4\uFF09\uFF0Cglobal=DTCC\u516C\u5F00\u6210\u4EA4\u7684CDX/iTraxx"
|
|
550
|
+
},
|
|
551
|
+
days: {
|
|
552
|
+
type: "number",
|
|
553
|
+
description: "\u56DE\u770B\u81EA\u7136\u65E51..90\uFF0C\u9ED8\u8BA430\uFF1Bglobal\u622A\u6B62\u5230DTCC\u6700\u65B0\u5DF2\u53D1\u5E03\u5DE5\u4F5C\u65E5\u6587\u4EF6"
|
|
554
|
+
},
|
|
555
|
+
index: {
|
|
556
|
+
type: "string",
|
|
557
|
+
description: "\u6307\u6570\u540D\uFF0C\u7CBE\u786E\u5339\u914D\u4F18\u5148\u3001\u5426\u5219\u5305\u542B\u5339\u914D\uFF0C\u5982\u6C11\u4F01\u3001\u79D1\u521B\u3001\u9AD8\u7B49\u7EA7\u3001CDX.NA.HY\u3001ITRAXX EUROPE\uFF1B\u7701\u7565\u8FD4\u56DE\u5168\u90E8"
|
|
558
|
+
},
|
|
559
|
+
tenor: {
|
|
560
|
+
type: "string",
|
|
561
|
+
description: "\u671F\u9650\uFF0C\u59823M\u30011Y\u30015Y\uFF1Bcn\u6309\u671F\u9650\u8FC7\u6EE4\uFF0Cglobal\u4EC55Y\uFF1B\u7701\u7565\u8FD4\u56DE\u5168\u90E8\u671F\u9650"
|
|
562
|
+
}
|
|
563
|
+
},
|
|
564
|
+
required: []
|
|
565
|
+
}
|
|
566
|
+
},
|
|
538
567
|
{
|
|
539
568
|
name: "get_earnings_calendar",
|
|
540
569
|
description: "\u67E5\u8BE2\u8D22\u62A5\u65E5\u5386\uFF1AA\u80A1report_date\u5FC5\u586B\u5B63\u5EA6\u671F\u672B\uFF0C\u8FD4\u56DE\u9884\u7EA6/\u4FEE\u8BA2/\u5B9E\u9645\u62AB\u9732\u4E0E\u4E1A\u7EE9\u9884\u544A\uFF1BHK\u9700symbol\uFF0C\u4F18\u5148HKEX\u5DF2\u516C\u544A\u4E1A\u7EE9\u5BA1\u6279\u8463\u4E8B\u4F1A\u6392\u671F\uFF08\u4E0D\u662F\u5B9E\u9645\u62AB\u9732\u65E5\uFF09\uFF1BUS/JP\u9700symbol\u5E76\u8FD4\u56DEyfinance\u4F9B\u5E94\u5546\u9884\u8BA1\u65E5\u671F\uFF08provider_only\uFF0C\u975E\u5B98\u65B9\u786E\u8BA4\uFF09\u3002HK\u53EF\u6309\u5DF2\u77E5\u8D22\u653F\u671F\u672B\u8FC7\u6EE4\uFF0C\u672A\u77E5\u671F\u6B21\u4E0EUS/JP\u8BF7\u6C42report_date\u65F6\u53E6\u5217unverified_schedules\uFF1BKR/TW\u4E0D\u53EF\u7528\u3002",
|
|
@@ -975,7 +1004,7 @@ var tool_schemas_default = [
|
|
|
975
1004
|
},
|
|
976
1005
|
{
|
|
977
1006
|
name: "get_market_stats",
|
|
978
|
-
description: "\u83B7\u53D6\u5E02\u573A\u6574\u4F53\u7EDF\u8BA1\uFF08\u6DA8\u8DCC\u5BB6\u6570\u3001\
|
|
1007
|
+
description: "\u83B7\u53D6\u5E02\u573A\u6574\u4F53\u7EDF\u8BA1\uFF08\u6DA8\u8DCC\u5BB6\u6570\u3001\u4E2D\u4F4D\u6DA8\u5E45\u3001\u6DA8\u8DCCTop5\u3001\u603B\u6210\u4EA4\u989D\uFF09\u3002market=A\uFF08\u9ED8\u8BA4\uFF09\u542B\u6DA8\u505C\u8DCC\u505C\u6570\uFF1BHK/US\u57FA\u4E8E\u4E1C\u65B9\u8D22\u5BCC\u6DA8\u8DCC\u6392\u884C\u8BA1\u6570\uFF0C\u65E0\u6DA8\u8DCC\u505C\u5236\u5EA6\uFF0C\u6DA8\u8DCC\u505C\u5B57\u6BB5\u4E0E\u603B\u6210\u4EA4\u989D\u4E3Anull\u3002avg_change_pct\u6052\u4E3Anull\u3002\u7528\u4E8E\u8861\u91CF\u5E02\u573A\u6574\u4F53\u60C5\u7EEA\u4E0E\u6E29\u5EA6",
|
|
979
1008
|
parameters: {
|
|
980
1009
|
type: "object",
|
|
981
1010
|
properties: {
|
|
@@ -2914,6 +2943,10 @@ var TOOL_CALLS = {
|
|
|
2914
2943
|
script: "value_data.py",
|
|
2915
2944
|
argv: (p) => ["index_valuation", p.symbol, "--years", String(p.years ?? 5)]
|
|
2916
2945
|
},
|
|
2946
|
+
get_cds_index: {
|
|
2947
|
+
script: "credit_data.py",
|
|
2948
|
+
argv: (p) => ["cds_index", "--source", p.source ?? "cn", "--days", String(p.days ?? 30), "--index", p.index ?? "", "--tenor", p.tenor ?? ""]
|
|
2949
|
+
},
|
|
2917
2950
|
get_earnings_calendar: {
|
|
2918
2951
|
script: "value_data.py",
|
|
2919
2952
|
argv: (p) => ["earnings_calendar", "--report-date", p.report_date ?? "", "--symbol", p.symbol ?? "", "--top", String(p.top ?? 50)]
|
package/openclaw.plugin.json
CHANGED
package/package.json
CHANGED
package/scripts/tool-calls.mjs
CHANGED
|
@@ -28,6 +28,10 @@ export const TOOL_CALLS = {
|
|
|
28
28
|
script: "value_data.py",
|
|
29
29
|
argv: (p) => ["index_valuation", p.symbol, "--years", String(p.years ?? 5)],
|
|
30
30
|
},
|
|
31
|
+
get_cds_index: {
|
|
32
|
+
script: "credit_data.py",
|
|
33
|
+
argv: (p) => ["cds_index", "--source", p.source ?? "cn", "--days", String(p.days ?? 30), "--index", p.index ?? "", "--tenor", p.tenor ?? ""],
|
|
34
|
+
},
|
|
31
35
|
get_earnings_calendar: {
|
|
32
36
|
script: "value_data.py",
|
|
33
37
|
argv: (p) => ["earnings_calendar", "--report-date", p.report_date ?? "", "--symbol", p.symbol ?? "", "--top", String(p.top ?? 50)],
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: bull-trend
|
|
3
|
-
description:
|
|
3
|
+
description: 趋势交易:识别中长期趋势,制定入场、持仓和退出规则。用于趋势温度计算、趋势股持有、规则化趋势策略、肥尾收益或非对称风险(赔率、凸性、脆弱性)分析。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# 趋势追踪分析
|
|
@@ -9,7 +9,7 @@ description: 趋势交易:识别中长期趋势,制定入场、持仓和退
|
|
|
9
9
|
|
|
10
10
|
趋势追踪用可执行的规则参与趋势,通过控制试错损失、保留盈利空间捕获少数大行情。肥尾描述收益分布,趋势描述价格路径;肥尾指标不是趋势启动或延续信号。
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
用户询问塔勒布、肥尾计算、极端行情、非对称风险(赔率、盈亏比、凸性、脆弱性)或策略是否依赖少数大盈利时,先读取 [肥尾、非对称风险与趋势收益诊断](references/fat-tails.md)。概念问题直接解释方法;需要具体统计结果时,按参考中的数据口径准备输入并调用 `scripts/tail_analysis.py`。普通趋势判断无需加载这份参考。
|
|
13
13
|
|
|
14
14
|
仅解释肥尾概念时,到此完成;下述流程用于具体标的的趋势分析。
|
|
15
15
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# 肥尾、非对称风险与趋势收益诊断
|
|
2
2
|
|
|
3
3
|
本参考供趋势 skill 和趋势策略回测按需读取。数值由本 skill 的 [计算脚本](../scripts/tail_analysis.py) 执行,无需独立工具注册。保留输入、运行参数和输出;没有执行环境或数据时只解释方法,数值标为未计算。
|
|
4
4
|
|
|
@@ -9,10 +9,12 @@
|
|
|
9
9
|
```bash
|
|
10
10
|
python skills/bull-trend/scripts/tail_analysis.py returns historical-returns.json --n 2 10 30 --draws 20000 --seed 42
|
|
11
11
|
python skills/bull-trend/scripts/tail_analysis.py returns historical-returns.json --current 0.05
|
|
12
|
+
python skills/bull-trend/scripts/tail_analysis.py returns historical-returns.json --tail-prob 0.05 --threshold 0
|
|
12
13
|
python skills/bull-trend/scripts/tail_analysis.py trades backtest-result.json
|
|
14
|
+
python skills/bull-trend/scripts/tail_analysis.py fragility scenarios.json --center 0
|
|
13
15
|
```
|
|
14
16
|
|
|
15
|
-
`returns` 输入是同周期历史对数收益的 JSON 数组,如 `[0.01, -0.02, 0.005]`,以小数表示;`--current` 的当前收益另传,必须从历史输入中排除。脚本不转换价格、不抓行情、不识别日期,因此先按下文校验并记录数据口径。`trades` 输入是含完整 `trades` 数组的回测 JSON
|
|
17
|
+
`returns` 输入是同周期历史对数收益的 JSON 数组,如 `[0.01, -0.02, 0.005]`,以小数表示;`--current` 的当前收益另传,必须从历史输入中排除。脚本不转换价格、不抓行情、不识别日期,因此先按下文校验并记录数据口径。`trades` 输入是含完整 `trades` 数组的回测 JSON。`fragility` 输入是情景损益表,格式见下文。脚本 stdout 输出 JSON,失败返回 `error` 并以非零状态退出。
|
|
16
18
|
|
|
17
19
|
κ 默认 n0 = 1,以固定种子做 iid 经验重抽样,输出每个 n 的 κ 和平均绝对偏差;换种子重复运行检查 Monte Carlo 波动,换历史窗口检查数据敏感性。输出没有总体置信区间。`sample_count` 是历史收益数量,`draws` 是模拟轮数,两者不能混称样本量。`current_event.percentile` 为 0..1,`upper_exceedances` / `lower_exceedances` 是历史严格超过 / 低于当前收益的次数。
|
|
18
20
|
|
|
@@ -23,9 +25,13 @@ python skills/bull-trend/scripts/tail_analysis.py trades backtest-result.json
|
|
|
23
25
|
| 收益分布有多肥尾 | 固定周期的历史收益 | 样本尾部特征、κ 的条件性估计 |
|
|
24
26
|
| 当前涨跌是否极端 | 当前收益与此前同周期收益 | 历史分位或阈值超越,不能推导后续方向 |
|
|
25
27
|
| 趋势系统是否靠大赢家 | 策略平仓盈亏 | 盈利集中度及移除大赢家后的敏感性 |
|
|
28
|
+
| 涨跌空间是否对称、赔率是否划算 | 历史收益或交易计划 | 尾部盈亏比、Omega、赔率与盈亏平衡胜率 |
|
|
29
|
+
| 头寸是否怕波动(脆弱性) | 冲击情景下的头寸损益 | 凸性 H、上下行盈亏比 |
|
|
26
30
|
|
|
27
31
|
市场收益的厚尾、策略收益的正偏和趋势延续是不同性质。塔勒布的度量回答统计稳定性问题;下文的分位和盈利贡献是本项目的诊断方法,不称为塔勒布交易信号。
|
|
28
32
|
|
|
33
|
+
肥尾和非对称风险是两层问题:肥尾描述**分布**(极端值多大、多常见,用 κ 和分位),非对称描述**暴露**(同样幅度的上下波动带来的损益是否对称,用凸性 H)。同一只股票,裸多头是线性暴露,买认购期权是凸的,卖认沽期权是凹的;分布相同,风险完全不同。
|
|
34
|
+
|
|
29
35
|
## 数据口径
|
|
30
36
|
|
|
31
37
|
使用 `get_kline` 或现有 `stock_data.py kline`,核对实际返回的日期范围、周期、数量和复权标记。股票历史价格保持一致复权口径,指数保持原始点位;先处理乱序、重复日期和无效价格,说明停牌或缺失导致的时间间隔,保留真实极端收益。
|
|
@@ -86,6 +92,73 @@ T_without_k = T - 最大 k 笔正盈利之和
|
|
|
86
92
|
|
|
87
93
|
现有回测有固定止盈默认值;省略 `take_profit` 不会关闭止盈。验证保留右尾的退出规则前,检查实际引擎和 DSL 的支持情况,将无法表达的规则明确列为未验证。
|
|
88
94
|
|
|
95
|
+
## 非对称风险:公式模板
|
|
96
|
+
|
|
97
|
+
以下全部用经验数据或用户给定的情景,不拟合分布。不要用偏度、峰度做核心指标:肥尾下高阶矩样本估计极不稳定,一个极端值就能改写结果。
|
|
98
|
+
|
|
99
|
+
### 收益分布的尾部不对称(`returns` 的 `asymmetry`)
|
|
100
|
+
|
|
101
|
+
```text
|
|
102
|
+
q_lo = 分位(r, p),q_hi = 分位(r, 1-p),p 由 --tail-prob 设定,默认 0.05
|
|
103
|
+
ETL = mean(r_i | r_i <= q_lo) 左尾平均亏损(负数)
|
|
104
|
+
ETG = mean(r_i | r_i >= q_hi) 右尾平均盈利
|
|
105
|
+
尾部盈亏比 = ETG / |ETL| ETG <= 0 或 ETL >= 0 时为 null
|
|
106
|
+
Omega(τ) = sum(max(r_i-τ, 0)) / sum(max(τ-r_i, 0)) τ 由 --threshold 设定
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
尾部盈亏比 > 1 说明样本里大涨的幅度大于大跌;Omega > 1 说明高于 τ 的收益总量超过低于 τ 的总量。没有低于 τ 的收益时 Omega 为 null。尾部样本数 `lower_tail_count` / `upper_tail_count` 很少时只作描述;N = 500、p = 0.05 时每侧约 25 个点。
|
|
110
|
+
|
|
111
|
+
### 交易赔率(`trades` 与交易计划)
|
|
112
|
+
|
|
113
|
+
```text
|
|
114
|
+
胜率 p = 盈利笔数 / 平仓笔数
|
|
115
|
+
赔率 b = 平均盈利 / |平均亏损| 脚本字段 payoff_ratio
|
|
116
|
+
盈亏平衡胜率 p* = 1 / (1 + b) 脚本字段 breakeven_win_rate
|
|
117
|
+
单笔期望(以 1 单位风险计)E = p*b - (1-p)
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
单笔计划用 R 倍数,无需脚本:
|
|
121
|
+
|
|
122
|
+
```text
|
|
123
|
+
R = (目标价 - 入场价) / (入场价 - 止损价)
|
|
124
|
+
p* = 1 / (1 + R)
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
例:入场 10、止损 9、目标 13,R = 3,p* = 25%;胜率估计高于 25% 才有正期望。止损可能跳空击穿,实际亏损按历史跳空幅度或最坏情景补充说明。
|
|
128
|
+
|
|
129
|
+
### 暴露的凸性与脆弱性(`fragility`)
|
|
130
|
+
|
|
131
|
+
来源:[Taleb, Canetti et al., A New Heuristic Measure of Fragility and Tail Risks, IMF WP/12/216](https://www.imf.org/en/publications/wp/issues/2016/12/31/a-new-heuristic-measure-of-fragility-and-tail-risks-application-to-stress-testing-26222)([arXiv 1208.1189](https://arxiv.org/abs/1208.1189))。
|
|
132
|
+
|
|
133
|
+
设 f(x) 是冲击幅度 x(如标的涨跌幅、利率变动)下的头寸损益,c 为中心情景:
|
|
134
|
+
|
|
135
|
+
```text
|
|
136
|
+
H(Δ) = (f(c-Δ) + f(c+Δ)) / 2 - f(c)
|
|
137
|
+
H < 0 凹,脆弱:波动越大越亏,伤害随冲击加速
|
|
138
|
+
H > 0 凸,反脆弱:波动越大越有利
|
|
139
|
+
H ≈ 0 线性
|
|
140
|
+
上下行盈亏比 = (f(c+Δ) - f(c)) / (f(c) - f(c-Δ))
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
输入模板(`capital` 可选,用于输出 `h_over_capital`):
|
|
144
|
+
|
|
145
|
+
```json
|
|
146
|
+
{
|
|
147
|
+
"capital": 100000,
|
|
148
|
+
"scenarios": [
|
|
149
|
+
{"shock": -0.2, "pnl": -2000},
|
|
150
|
+
{"shock": -0.1, "pnl": -2000},
|
|
151
|
+
{"shock": 0, "pnl": -1500},
|
|
152
|
+
{"shock": 0.1, "pnl": 3500},
|
|
153
|
+
{"shock": 0.2, "pnl": 8500}
|
|
154
|
+
]
|
|
155
|
+
}
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
这是买入认购期权的形状,H 为正。卖出认沽、加杠杆被强平、高负债公司的股权在下跌端加速亏损,H 为负。必须包含中心情景和对称的 ±Δ;多组 Δ 时看 H 是否随 Δ 增大而加速变负,这是脆弱性的核心信号。
|
|
159
|
+
|
|
160
|
+
`analyze_portfolio_risk` 的压力测试按 beta 线性推算,其结果作为 f(x) 时 H 恒为 0;非线性只来自期权、止损、杠杆与保证金、可转债,或公司层面的负债与经营杠杆。公司层面可用不同营收或利率冲击下的净利润或权益价值作为 f(x),情景须由用户或财报数据给出并注明假设。
|
|
161
|
+
|
|
89
162
|
## 完成标准
|
|
90
163
|
|
|
91
|
-
报告指出分析对象、数据来源及区间、周期、复权口径、样本量、公式与估计方法、实际数值或未计算原因。κ 结果还需注明 n0、n
|
|
164
|
+
报告指出分析对象、数据来源及区间、周期、复权口径、样本量、公式与估计方法、实际数值或未计算原因。κ 结果还需注明 n0、n、抽样假设和敏感性;盈利集中度需注明平仓与未平仓口径;非对称结果需注明 tail-prob、阈值或情景来源。交易建议依据趋势和风险规则,统计结果仅提供其能支持的证据。
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
#!/usr/bin/env python3
|
|
2
|
-
"""Skill-local tail diagnostics from
|
|
2
|
+
"""Skill-local tail and asymmetric-risk diagnostics from returns, backtest trades or payoff scenarios."""
|
|
3
3
|
|
|
4
4
|
import argparse
|
|
5
5
|
import json
|
|
@@ -21,12 +21,37 @@ def finite_number(value):
|
|
|
21
21
|
return float(value)
|
|
22
22
|
|
|
23
23
|
|
|
24
|
+
def ratio(numerator, denominator):
|
|
25
|
+
return numerator / denominator if denominator > 0 else None
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
def return_asymmetry(values, tail_prob, threshold):
|
|
29
|
+
lower, upper = (float(q) for q in np.quantile(values, [tail_prob, 1 - tail_prob]))
|
|
30
|
+
lower_tail, upper_tail = values[values <= lower], values[values >= upper]
|
|
31
|
+
tail_loss, tail_gain = float(lower_tail.mean()), float(upper_tail.mean())
|
|
32
|
+
excess = values - threshold
|
|
33
|
+
return {
|
|
34
|
+
"tail_probability": tail_prob,
|
|
35
|
+
"threshold": threshold,
|
|
36
|
+
"lower_quantile": lower,
|
|
37
|
+
"upper_quantile": upper,
|
|
38
|
+
"expected_tail_loss": tail_loss,
|
|
39
|
+
"expected_tail_gain": tail_gain,
|
|
40
|
+
"tail_gain_loss_ratio": ratio(tail_gain, -tail_loss) if tail_gain > 0 else None,
|
|
41
|
+
"lower_tail_count": len(lower_tail),
|
|
42
|
+
"upper_tail_count": len(upper_tail),
|
|
43
|
+
"omega": ratio(float(np.clip(excess, 0, None).sum()), float(np.clip(-excess, 0, None).sum())),
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
|
|
24
47
|
def analyze_returns(data, args):
|
|
25
48
|
if not isinstance(data, list) or len(data) < 2:
|
|
26
49
|
raise ValueError("Expected a JSON array of at least two historical returns")
|
|
27
50
|
values = np.array([finite_number(value) for value in data])
|
|
28
51
|
if not 100 <= args.draws <= 1000000 or args.seed < 0 or any(n < 2 or n > 10000 for n in args.n):
|
|
29
52
|
raise ValueError("Require draws in 100..1000000, seed >= 0, and n in 2..10000")
|
|
53
|
+
if not 0 < args.tail_prob < 0.5 or not math.isfinite(args.threshold):
|
|
54
|
+
raise ValueError("Require tail-prob in (0, 0.5) and a finite threshold")
|
|
30
55
|
centered = values - values.mean()
|
|
31
56
|
mad = float(np.abs(centered).mean())
|
|
32
57
|
rng = np.random.default_rng(args.seed)
|
|
@@ -67,6 +92,7 @@ def analyze_returns(data, args):
|
|
|
67
92
|
"mean_absolute_deviation": mad,
|
|
68
93
|
"kappa": rows,
|
|
69
94
|
"current_event": event,
|
|
95
|
+
"asymmetry": return_asymmetry(values, args.tail_prob, args.threshold),
|
|
70
96
|
"method": "iid resampling of centered empirical returns; not a population tail estimate or trading signal",
|
|
71
97
|
}
|
|
72
98
|
|
|
@@ -78,9 +104,11 @@ def analyze_trades(data):
|
|
|
78
104
|
raise ValueError("Each trade must have type buy or sell")
|
|
79
105
|
pnl = [finite_number(trade.get("pnl")) for trade in data["trades"] if trade["type"] == "sell"]
|
|
80
106
|
winners = sorted((value for value in pnl if value > 0), reverse=True)
|
|
107
|
+
losers = [value for value in pnl if value < 0]
|
|
81
108
|
gross_profit = math.fsum(winners)
|
|
82
|
-
gross_loss = math.fsum(
|
|
109
|
+
gross_loss = math.fsum(losers)
|
|
83
110
|
net = math.fsum(pnl)
|
|
111
|
+
payoff = ratio(gross_profit / len(winners), -gross_loss / len(losers)) if winners and losers else None
|
|
84
112
|
return {
|
|
85
113
|
"closed_trades": len(pnl),
|
|
86
114
|
"winning_trades": len(winners),
|
|
@@ -88,6 +116,9 @@ def analyze_trades(data):
|
|
|
88
116
|
"gross_loss": gross_loss,
|
|
89
117
|
"realized_net_pnl": net,
|
|
90
118
|
"worst_trade_pnl": min(pnl) if pnl else None,
|
|
119
|
+
"win_rate": len(winners) / len(pnl) if pnl else None,
|
|
120
|
+
"payoff_ratio": payoff,
|
|
121
|
+
"breakeven_win_rate": 1 / (1 + payoff) if payoff else None,
|
|
91
122
|
"winner_contribution": [
|
|
92
123
|
{
|
|
93
124
|
"requested_k": k,
|
|
@@ -101,6 +132,54 @@ def analyze_trades(data):
|
|
|
101
132
|
}
|
|
102
133
|
|
|
103
134
|
|
|
135
|
+
def analyze_fragility(data, center):
|
|
136
|
+
if not isinstance(data, dict) or not isinstance(data.get("scenarios"), list):
|
|
137
|
+
raise ValueError("Expected a JSON object with a scenarios array of {shock, pnl}")
|
|
138
|
+
capital = data.get("capital")
|
|
139
|
+
if capital is not None and finite_number(capital) <= 0:
|
|
140
|
+
raise ValueError("capital must be positive")
|
|
141
|
+
payoff = {}
|
|
142
|
+
for row in data["scenarios"]:
|
|
143
|
+
if not isinstance(row, dict):
|
|
144
|
+
raise ValueError("Each scenario must be an object with shock and pnl")
|
|
145
|
+
# Rounded keys pair center±delta despite binary float error.
|
|
146
|
+
shock = round(finite_number(row.get("shock")), 10)
|
|
147
|
+
if shock in payoff:
|
|
148
|
+
raise ValueError("Duplicate scenario shock")
|
|
149
|
+
payoff[shock] = finite_number(row.get("pnl"))
|
|
150
|
+
center = round(finite_number(center), 10)
|
|
151
|
+
if center not in payoff:
|
|
152
|
+
raise ValueError("Scenarios must include the center shock")
|
|
153
|
+
base, pairs = payoff[center], []
|
|
154
|
+
for shock in sorted(s for s in payoff if s > center):
|
|
155
|
+
delta = round(shock - center, 10)
|
|
156
|
+
down = payoff.get(round(center - delta, 10))
|
|
157
|
+
if down is None:
|
|
158
|
+
continue
|
|
159
|
+
up = payoff[shock]
|
|
160
|
+
h = (up + down) / 2 - base
|
|
161
|
+
scale = max(1.0, abs(up), abs(down), abs(base))
|
|
162
|
+
pairs.append(
|
|
163
|
+
{
|
|
164
|
+
"delta": delta,
|
|
165
|
+
"pnl_down": down,
|
|
166
|
+
"pnl_center": base,
|
|
167
|
+
"pnl_up": up,
|
|
168
|
+
"h": h,
|
|
169
|
+
"h_over_capital": h / capital if capital else None,
|
|
170
|
+
"gain_loss_ratio": ratio(up - base, base - down),
|
|
171
|
+
"shape": "linear" if abs(h) <= 1e-9 * scale else "convex" if h > 0 else "concave",
|
|
172
|
+
}
|
|
173
|
+
)
|
|
174
|
+
if not pairs:
|
|
175
|
+
raise ValueError("Need at least one center-delta and center+delta scenario pair")
|
|
176
|
+
return {
|
|
177
|
+
"center": center,
|
|
178
|
+
"pairs": pairs,
|
|
179
|
+
"method": "H=(f(center-delta)+f(center+delta))/2-f(center) on supplied scenarios; H<0 is fragile",
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
|
|
104
183
|
def main():
|
|
105
184
|
try:
|
|
106
185
|
parser = Parser(description=__doc__)
|
|
@@ -111,11 +190,21 @@ def main():
|
|
|
111
190
|
returns.add_argument("--draws", type=int, default=20000)
|
|
112
191
|
returns.add_argument("--seed", type=int, default=42)
|
|
113
192
|
returns.add_argument("--current", type=float, help="Separate current return, excluded from historical input")
|
|
193
|
+
returns.add_argument("--tail-prob", type=float, default=0.05, help="Each tail's probability for asymmetry")
|
|
194
|
+
returns.add_argument("--threshold", type=float, default=0.0, help="Omega gain/loss threshold return")
|
|
114
195
|
trades = sub.add_parser("trades", help="Analyze a complete run_backtest JSON result")
|
|
115
196
|
trades.add_argument("input", type=Path)
|
|
197
|
+
fragility = sub.add_parser("fragility", help="Taleb-IMF fragility heuristic from payoff scenarios")
|
|
198
|
+
fragility.add_argument("input", type=Path)
|
|
199
|
+
fragility.add_argument("--center", type=float, default=0.0, help="Shock level to perturb around")
|
|
116
200
|
args = parser.parse_args()
|
|
117
201
|
data = json.loads(args.input.read_text(encoding="utf-8"))
|
|
118
|
-
|
|
202
|
+
if args.command == "returns":
|
|
203
|
+
result = analyze_returns(data, args)
|
|
204
|
+
elif args.command == "trades":
|
|
205
|
+
result = analyze_trades(data)
|
|
206
|
+
else:
|
|
207
|
+
result = analyze_fragility(data, args.center)
|
|
119
208
|
print(json.dumps(result, ensure_ascii=True, allow_nan=False))
|
|
120
209
|
return 0
|
|
121
210
|
except OSError:
|
|
@@ -58,6 +58,7 @@ gather 工具返回以下字段:
|
|
|
58
58
|
|
|
59
59
|
### 7. 风险提示
|
|
60
60
|
- 需要注意的系统性风险
|
|
61
|
+
- 信用风险偏好:可调用 `get_cds_index`(A 股用 `source="cn", tenor="1Y"`,index 取 `"高等级"` 和 `"民企"`,美股用 `source="global", index="CDX.NA.IG"` 和 `"CDX.NA.HY"`),报告指数、期限、窗口变化与分位;信用利差走阔是风险背景,不是择时信号
|
|
61
62
|
- 板块/个股层面的风险信号
|
|
62
63
|
- 外围市场可能的影响
|
|
63
64
|
|
|
@@ -25,6 +25,8 @@ description: 综合股票分析:联合技术、基本面、资金、消息和
|
|
|
25
25
|
|
|
26
26
|
用户要求短线、波段、交易计划或买卖时机时,读取[短线交易决策框架](references/short-term-trading.md);普通基本面或长期价值分析不加载该参考。
|
|
27
27
|
|
|
28
|
+
用户询问非对称风险、赔率、盈亏比、凸性或脆弱性时,读取[肥尾、非对称风险与趋势收益诊断](../bull-trend/references/fat-tails.md)的非对称风险公式模板。
|
|
29
|
+
|
|
28
30
|
| 意图 | 调用序列 |
|
|
29
31
|
|------|---------|
|
|
30
32
|
| 个股买卖时机 | `get_technical_analysis` → `get_market_capabilities` → 当前市场支持的资金/风险工具 → `detect_market_regime`。A股可加 `get_capital_flow`(summary) 和 `screen_risk`;其他市场不得用缺失的资金或风险数据。veto_buy=true 则不入场;大盘下跌时个股看多信号降级为轻仓试错或等待;HOLD/WAIT 给出可观察触发条件 |
|
|
@@ -47,7 +49,7 @@ python3 scripts/gather.py <symbol>
|
|
|
47
49
|
|
|
48
50
|
解读实时行情前先调 `get_trading_phase` 确认该市场当前盘中阶段(盘前/早盘/午间休市/午盘/交易中/盘后/休市),避免把休市时的静态快照当作盘中信号解读。
|
|
49
51
|
|
|
50
|
-
场外公募基金净值查询使用 `get_fund_quote(symbol="018147")`,不要当作股票实时报价。`nav` 是 `nav_date` 对应的已披露日终净值而非实时价;`accumulated_nav` 为累计净值,`change_pct` 为日涨跌幅。`estimated_nav`
|
|
52
|
+
场外公募基金净值查询使用 `get_fund_quote(symbol="018147")`,不要当作股票实时报价。`nav` 是 `nav_date` 对应的已披露日终净值而非实时价;`accumulated_nav` 为累计净值,`change_pct` 为日涨跌幅。`estimated_nav` 目前恒为 `null`,缺失时不得编造或当作实时成交价;QDII 净值可能滞后 1-2 交易日,须披露实际 `nav_date`。`TIAAxxxxxx` 使用 `get_quote` 获取投顾组合识别与无统一净值提示,不推算组合净值。`advisor_code/advisor_org` 按 TIAA 前三位机构段与资本市场标准网基金投顾业务编码表进行 best-effort 映射,来源和抓取时间随结果返回;投顾机构不等于主理人,查不到时保留 null。`official_disclosures` 目前仅对确认属于有知有行的 `TIAA001001/TIAA001002/TIAA001004` 提供,其他 TIAA 组合不得套用该站文章;有搜索配置时可返回 `disclosure_status=search_partial` 和 `public_search_results`,其中每项均为 `verification=unverified_search_result`,只能作为待核实线索,否则为 `unsupported_provider`。官方披露含发布日期、摘要、正文摘录和 URL;`disclosures_partial=true` 时必须视为不完整历史披露,不能当作实时业绩或完整成分基金清单。示例账户收益不等于用户收益,引用基金代码时必须保留对应文章日期和链接。
|
|
51
53
|
|
|
52
54
|
港股 `get_quote` 自动按 yfinance → 腾讯 → finnhub → longbridge 容灾,腾讯无需 API key,使用 `r_hk` 实时报价通道(`hk` 通道延迟约 15 分钟)。腾讯港股成交量为股,成交额及市值为港元;PB、换手率、量比为 null 时按缺失处理。腾讯也是港股 `get_kline` 的第二个源,以及美股报价和 K 线在 finnhub / longbridge 之后、alphavantage 之前的备用源;腾讯 K 线为前复权(`adjusted: "qfq"`),与 yfinance 的全收益口径不同。
|
|
53
55
|
|
|
@@ -125,6 +127,7 @@ python3 scripts/gather.py <symbol>
|
|
|
125
127
|
- 财报季排期:`get_earnings_calendar(report_date="YYYY-MM-DD", symbol=...)`,区分最新预约日期、实际披露日期和已公告业绩预告,不把预告当业绩实绩。
|
|
126
128
|
- 股东变化:`get_shareholder_structure`。A 股北向值是财报十大流通股东中的 HKSCC 名义持股,缺席不等于零,不能当成日度北向买卖;港股南向值按港交所披露日期使用。
|
|
127
129
|
- 大盘估值:`get_index_valuation(symbol="000300", years=5)`;中证近期 PE1 不冒充 PE-TTM、PB 或多年分位。
|
|
130
|
+
- 信用风险偏好:`get_cds_index` 返回市场级 CDS 指数的窗口变化与分位,只作行业/大盘背景;不是个股 CDS,不能单独推出个股方向。按标的只取一个最贴近的指数和期限(如 `index="民企", tenor="1Y"`),不要无过滤拉全部:A 股民营企业用民企,央国企/高评级用高等级,科创板/硬科技用科创,长三角企业用长三角,新能源/环保用碳中和;美股投资级公司用 `source="global", index="CDX.NA.IG"`,高收益/高杠杆用 `CDX.NA.HY`(价格,下跌表示信用走弱),欧洲公司用 `ITRAXX EUROPE` 或 `CROSSOVER`。对应关系是代理,报告时说明。
|
|
128
131
|
- ETF:`get_etf_details(symbol="510300", benchmark="sh000300")`。折溢价须看净值/行情日期;披露持仓不是完整实时申赎篮子,指数成分与基金持仓分别呈现。跟踪误差必须给出用户认可的基准。
|
|
129
132
|
- 股息:`get_dividends` 区分历史、未来已公布除息日历和排行;history/calendar 支持 A/HK/US/JP/KR/TW,排行仍仅 A/HK。预案不计入已实现 TTM 股息。名义每股现金未重算送转股口径,遇送转股时不得据此精确比较持有收益。
|
|
130
133
|
- 两融:`get_margin_trading(include_ratio=true)` 的 `margin_buy_ratio_pct` 只使用同日成交额;null 表示不可计算。
|
|
@@ -7,7 +7,7 @@ description: 全市场股票筛选:按市场、估值、成长、趋势或自
|
|
|
7
7
|
|
|
8
8
|
批量研究、子任务分工或报告文件交付时,必须读取[宿主研究与报告交付](../stock-analysis/references/host-workflows.md),使用当前宿主实际提供的能力。
|
|
9
9
|
|
|
10
|
-
显式筛选条件缺少数据时工具返回 `error
|
|
10
|
+
显式筛选条件缺少数据时工具返回 `error`,不能把该条件当作已通过。工具只取市值不低于 `market_cap_min` 的股票(按市值从大到小,最多 3000 只),结果带 `warnings` 提示截断时须说明候选范围不完整。`filters_applied` 只包含实际执行的条件,基于返回的覆盖情况说明候选范围。
|
|
11
11
|
|
|
12
12
|
## 执行流程
|
|
13
13
|
|
|
@@ -103,7 +103,7 @@ python3 tools/backtest.py run <path.yaml> <symbol> --start <date> --end <date>
|
|
|
103
103
|
- 使用用户指定的互斥日期区间分别运行样本内和样本外回测。
|
|
104
104
|
- 成本假设引用结果中的 `costs` 字段(实际生效的佣金/滑点/印花税费率与实付费用合计),未模拟的费用与成交约束列入限制。
|
|
105
105
|
|
|
106
|
-
趋势策略或用户要求肥尾收益诊断时,读取 [
|
|
106
|
+
趋势策略或用户要求肥尾收益诊断时,读取 [肥尾、非对称风险与趋势收益诊断](../bull-trend/references/fat-tails.md)的盈利集中度部分,基于平仓 `pnl` 计算大赢家贡献和删除敏感性。只有用户询问市场收益分布时才进入 κ 分支。
|
|
107
107
|
|
|
108
108
|
未模拟的结算、涨跌停、复权或特定市场费用列入限制,结论限定为该模拟条件下的历史表现。
|
|
109
109
|
|
package/tools/capabilities.py
CHANGED
|
@@ -42,6 +42,7 @@ TOOL_MATRIX = {
|
|
|
42
42
|
"get_insider_trades": {"markets": ["US"], "reason": "SEC issuer Form 4 only"},
|
|
43
43
|
"get_valuation_history": {"markets": ["A", "HK", "US"], "reason": "A/HK providers; US derived from SEC filings"},
|
|
44
44
|
"get_index_valuation": {"markets": ["A"], "reason": "Chinese index valuation only"},
|
|
45
|
+
"get_cds_index": {"markets": ["A", "US"], "reason": "Market-level CN onshore CDS indices / CDX-iTraxx only"},
|
|
45
46
|
"get_earnings_calendar": {
|
|
46
47
|
"markets": ["A", "HK", "US", "JP"],
|
|
47
48
|
"reason": "A-share disclosed calendar / HK/US/JP single-symbol provider schedule",
|
package/tools/cli_budgets.json
CHANGED