@openfinclaw/findoo-datahub-plugin 2026.3.2 → 2026.3.10
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/DESIGN.md +492 -151
- package/_vendor/claude-skills-finance/SKILL.md +192 -0
- package/_vendor/claude-skills-finance/assets/dcf_analysis_template.md +184 -0
- package/_vendor/claude-skills-finance/assets/expected_output.json +161 -0
- package/_vendor/claude-skills-finance/assets/forecast_report_template.md +177 -0
- package/_vendor/claude-skills-finance/assets/sample_financial_data.json +219 -0
- package/_vendor/claude-skills-finance/assets/variance_report_template.md +122 -0
- package/_vendor/claude-skills-finance/references/financial-ratios-guide.md +396 -0
- package/_vendor/claude-skills-finance/references/forecasting-best-practices.md +294 -0
- package/_vendor/claude-skills-finance/references/valuation-methodology.md +255 -0
- package/_vendor/claude-skills-finance/scripts/budget_variance_analyzer.py +406 -0
- package/_vendor/claude-skills-finance/scripts/dcf_valuation.py +449 -0
- package/_vendor/claude-skills-finance/scripts/forecast_builder.py +494 -0
- package/_vendor/claude-skills-finance/scripts/ratio_calculator.py +432 -0
- package/index.ts +332 -14
- package/openclaw.plugin.json +2 -2
- package/package.json +1 -1
- package/references/cn-market-specifics.md +165 -0
- package/references/crypto-analysis.md +635 -0
- package/references/financial-ratios-cn.md +452 -0
- package/references/hk-market-specifics.md +166 -0
- package/references/macro-cycle-cn.md +409 -0
- package/references/valuation-cn.md +427 -0
- package/skills/README.md +294 -0
- package/skills/a-concept-cycle/skill.md +200 -0
- package/skills/a-convertible-arb/skill.md +294 -0
- package/skills/a-dividend-king/skill.md +187 -0
- package/skills/a-earnings-season/skill.md +221 -0
- package/skills/a-index-timer/skill.md +192 -0
- package/skills/a-ipo-new/skill.md +297 -0
- package/skills/a-northbound-decoder/skill.md +185 -0
- package/skills/a-quant-board/skill.md +286 -0
- package/skills/a-share/skill.md +347 -0
- package/skills/a-share-radar/skill.md +185 -0
- package/skills/cross-asset/skill.md +202 -0
- package/skills/crypto/skill.md +269 -0
- package/skills/crypto-altseason/skill.md +208 -0
- package/skills/crypto-btc-cycle/skill.md +231 -0
- package/skills/crypto-defi-yield/skill.md +181 -0
- package/skills/crypto-funding-arb/skill.md +158 -0
- package/skills/crypto-stablecoin-flow/skill.md +149 -0
- package/skills/data-query/skill.md +124 -30
- package/skills/derivatives/skill.md +188 -35
- package/skills/etf-fund/skill.md +216 -0
- package/skills/factor-screen/skill.md +186 -0
- package/skills/hk-china-internet/skill.md +190 -0
- package/skills/hk-dividend-harvest/skill.md +192 -0
- package/skills/hk-hsi-pulse/skill.md +154 -0
- package/skills/hk-southbound-alpha/skill.md +163 -0
- package/skills/hk-stock/skill.md +295 -0
- package/skills/macro/skill.md +244 -53
- package/skills/risk-monitor/skill.md +171 -0
- package/skills/us-dividend/skill.md +162 -0
- package/skills/us-earnings/skill.md +149 -0
- package/skills/us-equity/skill.md +235 -0
- package/skills/us-etf/skill.md +261 -0
- package/skills/us-sector-rotation/skill.md +223 -0
- package/src/config.ts +4 -5
- package/src/datahub-client.test.ts +4 -7
- package/src/datahub-client.ts +6 -1
- package/src/register-tools.ts +720 -0
- package/src/tool-helpers.ts +89 -0
- package/test/e2e/l3-gateway-bootstrap.live.test.ts +339 -0
- package/test/e2e/l4-skill-tool-chain.live.test.ts +465 -0
- package/skills/crypto-defi/skill.md +0 -69
- package/skills/equity/skill.md +0 -64
- package/skills/market-radar/skill.md +0 -47
|
@@ -0,0 +1,294 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: fin-a-convertible-arb
|
|
3
|
+
description: "A-share convertible bond (可转债) arbitrage & strategy — double-low screening, forced-redemption timing, conversion-price reset (下修) analysis, YTM debt-floor valuation, credit risk assessment. Uses fin_derivatives (convertible endpoints), fin_stock (underlying equity), fin_ta (technicals). Use when: user mentions 可转债/转债/CB, convertible bond codes (11xxxx.SH/12xxxx.SZ), double-low strategy (双低), forced redemption (强赎), conversion price reset (下修), or YTM analysis on Chinese convertible bonds. NOT for: futures/options (use fin-derivatives), plain A-share equity (use fin-a-share unless the question is about a CB's underlying), US/HK stocks (use fin-us-equity/fin-hk-stock), crypto (use fin-crypto)."
|
|
4
|
+
metadata: { "openclaw": { "emoji": "🔄", "requires": { "extensions": ["findoo-datahub-plugin"] } } }
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# A-Share Convertible Bond Arbitrage (A股可转债策略)
|
|
8
|
+
|
|
9
|
+
Use **fin_derivatives** (convertible endpoints), **fin_stock** (underlying equity data), and **fin_ta** (technical indicators) for convertible bond analysis via DataHub.
|
|
10
|
+
|
|
11
|
+
## When to Use
|
|
12
|
+
|
|
13
|
+
- User mentions 可转债、转债、CB、可转换债券
|
|
14
|
+
- Convertible bond codes: `11xxxx.SH` (上交所) / `12xxxx.SZ` (深交所)
|
|
15
|
+
- Double-low screening (双低策略筛选)
|
|
16
|
+
- Forced redemption analysis (强赎博弈)
|
|
17
|
+
- Conversion price reset (下修转股价) analysis
|
|
18
|
+
- YTM (到期收益率) ranking or debt-floor valuation
|
|
19
|
+
- Credit risk assessment for convertible bonds
|
|
20
|
+
- T+0 intraday trading strategy on convertible bonds
|
|
21
|
+
- User asks about a specific CB's underlying stock (e.g. "XX转债正股怎么样") — this is still a CB context
|
|
22
|
+
|
|
23
|
+
## When NOT to Use
|
|
24
|
+
|
|
25
|
+
- Plain A-share stock analysis without CB context → use **fin-a-share**
|
|
26
|
+
- Futures or commodity options → use **fin-derivatives**
|
|
27
|
+
- US/HK equities → use **fin-us-equity** / **fin-hk-stock**
|
|
28
|
+
- Market-wide overview → use **fin-a-share-radar**
|
|
29
|
+
- ETF/fund analysis → use **fin-etf-fund**
|
|
30
|
+
|
|
31
|
+
## Tools & Parameters
|
|
32
|
+
|
|
33
|
+
### fin_derivatives (convertible endpoints)
|
|
34
|
+
|
|
35
|
+
| Parameter | Type | Required | Format | Default | Example |
|
|
36
|
+
| ---------- | ------ | -------- | ------------------ | ------- | ---------------- |
|
|
37
|
+
| symbol | string | Yes | CB code | — | 113050.SH |
|
|
38
|
+
| endpoint | string | Yes | see endpoint table | — | convertible/list |
|
|
39
|
+
| trade_date | string | No | YYYY-MM-DD | — | 2026-03-07 |
|
|
40
|
+
| start_date | string | No | YYYY-MM-DD | — | 2026-01-01 |
|
|
41
|
+
| end_date | string | No | YYYY-MM-DD | — | 2026-03-07 |
|
|
42
|
+
| limit | number | No | 1-5000 | 200 | 50 |
|
|
43
|
+
|
|
44
|
+
### fin_stock (underlying equity)
|
|
45
|
+
|
|
46
|
+
| Parameter | Type | Required | Format | Default | Example |
|
|
47
|
+
| --------- | ------ | -------- | ------------------ | ------- | ---------------- |
|
|
48
|
+
| symbol | string | Yes | A-share code | — | 600519.SH |
|
|
49
|
+
| endpoint | string | Yes | see endpoint table | — | price/historical |
|
|
50
|
+
|
|
51
|
+
### fin_ta (technical indicators)
|
|
52
|
+
|
|
53
|
+
| Parameter | Type | Required | Format | Default | Example |
|
|
54
|
+
| --------- | ------ | -------- | ----------- | ------- | --------- |
|
|
55
|
+
| symbol | string | Yes | CB or stock | — | 113050.SH |
|
|
56
|
+
| endpoint | string | Yes | indicator | — | rsi |
|
|
57
|
+
|
|
58
|
+
### Symbol Format
|
|
59
|
+
|
|
60
|
+
| Type | Pattern | Example |
|
|
61
|
+
| --------------- | ----------- | -------------------- |
|
|
62
|
+
| 上交所可转债 | `11xxxx.SH` | 113050.SH (南银转债) |
|
|
63
|
+
| 深交所可转债 | `12xxxx.SZ` | 123136.SZ (绿动转债) |
|
|
64
|
+
| 正股 (Shanghai) | `600xxx.SH` | 600036.SH (招商银行) |
|
|
65
|
+
| 正股 (Shenzhen) | `000xxx.SZ` | 000001.SZ (平安银行) |
|
|
66
|
+
|
|
67
|
+
## Endpoint Map
|
|
68
|
+
|
|
69
|
+
### Convertible Bond Endpoints (fin_derivatives)
|
|
70
|
+
|
|
71
|
+
| endpoint | Description | Key Params |
|
|
72
|
+
| ------------------------ | -------------------------------- | ---------------------------- |
|
|
73
|
+
| `convertible/list` | All CB list with basic info | limit |
|
|
74
|
+
| `convertible/detail` | Single CB detail (terms/clauses) | symbol |
|
|
75
|
+
| `convertible/historical` | CB historical OHLCV + premium | symbol, start_date, end_date |
|
|
76
|
+
|
|
77
|
+
### Underlying Equity Endpoints (fin_stock)
|
|
78
|
+
|
|
79
|
+
| endpoint | Description | Key Params |
|
|
80
|
+
| --------------------- | --------------------- | ---------- |
|
|
81
|
+
| `price/historical` | Underlying OHLCV | symbol |
|
|
82
|
+
| `fundamental/ratios` | PE/PB/ROE etc. | symbol |
|
|
83
|
+
| `profile` | Company overview | symbol |
|
|
84
|
+
| `shareholders/pledge` | Pledge ratio (质押率) | symbol |
|
|
85
|
+
| `financial/cashflow` | Cash flow statement | symbol |
|
|
86
|
+
|
|
87
|
+
### Technical Endpoints (fin_ta)
|
|
88
|
+
|
|
89
|
+
| endpoint | Description | Key Params |
|
|
90
|
+
| ----------- | --------------- | ---------- |
|
|
91
|
+
| `rsi` | RSI(14) | symbol |
|
|
92
|
+
| `macd` | MACD | symbol |
|
|
93
|
+
| `bollinger` | Bollinger Bands | symbol |
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## Analysis Patterns
|
|
98
|
+
|
|
99
|
+
### Pattern 1: 双低策略筛选 (Double-Low Screening)
|
|
100
|
+
|
|
101
|
+
**目标:** 找出"下有保底、上有弹性"的可转债组合。
|
|
102
|
+
|
|
103
|
+
1. 获取全市场可转债列表:
|
|
104
|
+
`fin_derivatives(endpoint="convertible/list", limit=5000)`
|
|
105
|
+
|
|
106
|
+
2. 计算双低值:
|
|
107
|
+
`双低值 = 转债价格 + 转股溢价率 × 100`
|
|
108
|
+
|
|
109
|
+
3. 筛选条件 (按优先级):
|
|
110
|
+
- 双低值 < 130 (核心条件)
|
|
111
|
+
- 剩余年限 > 1 年 (避免到期强制赎回)
|
|
112
|
+
- 信用评级 >= AA- (避免信用风险)
|
|
113
|
+
- 正股非 ST / \*ST (排除退市风险)
|
|
114
|
+
- 日均成交额 > 500 万 (保证流动性)
|
|
115
|
+
|
|
116
|
+
4. 双低值分层解读:
|
|
117
|
+
|
|
118
|
+
| 双低值区间 | 评价 | 策略建议 |
|
|
119
|
+
| ---------- | -------- | ---------------------------- |
|
|
120
|
+
| < 110 | 极度低估 | 重仓,等权持有 10-20 只 |
|
|
121
|
+
| 110 - 130 | 优质区间 | 标准仓位,月度轮动 |
|
|
122
|
+
| 130 - 150 | 中性 | 需额外催化剂 (下修/业绩改善) |
|
|
123
|
+
| > 150 | 偏贵 | 不适合双低策略 |
|
|
124
|
+
|
|
125
|
+
5. 组合构建: 取双低值最低的 10-20 只等权持有,每月末按最新双低值重新排序轮动。
|
|
126
|
+
|
|
127
|
+
> 💡 双低策略的超额收益来源于"均值回归"——低价+低溢价的转债要么正股反弹带动转债上涨,要么溢价率压缩(下修/强赎预期)。
|
|
128
|
+
|
|
129
|
+
> ⚠️ 双低值计算前务必剔除已公告强赎的转债(这些转债价格将向转股价值收敛,双低值失真)。
|
|
130
|
+
|
|
131
|
+
### Pattern 2: 强赎博弈分析 (Forced Redemption Timing)
|
|
132
|
+
|
|
133
|
+
**目标:** 识别即将触发或已触发强赎条款的转债,把握套利窗口。
|
|
134
|
+
|
|
135
|
+
1. 查询目标转债条款:
|
|
136
|
+
`fin_derivatives(endpoint="convertible/detail", symbol="113050.SH")`
|
|
137
|
+
→ 提取强赎触发条件 (通常: 正股价连续 15/30 日 > 130% 转股价)
|
|
138
|
+
|
|
139
|
+
2. 获取正股历史价格:
|
|
140
|
+
`fin_stock(endpoint="price/historical", symbol="<正股代码>", limit=30)`
|
|
141
|
+
→ 计算正股价/转股价比值,统计连续满足天数
|
|
142
|
+
|
|
143
|
+
3. 强赎状态分类:
|
|
144
|
+
|
|
145
|
+
| 状态 | 含义 | 操作建议 |
|
|
146
|
+
| ------------------ | ------------------------ | --------------------------------- |
|
|
147
|
+
| 未触发 (< 10日) | 距离强赎较远 | 按常规策略持有 |
|
|
148
|
+
| 接近触发 (10-14日) | 高概率触发,市场开始定价 | 关注正股走势,准备转股或卖出 |
|
|
149
|
+
| 已触发 (>= 15日) | 等待公司公告 | 15-30 交易日套利窗口 |
|
|
150
|
+
| 公告强赎 | 确认赎回,倒计时开始 | 转股价值 > 赎回价则转股,否则卖出 |
|
|
151
|
+
| 公告不赎回 | 管理层释放继续持有信号 | 利好持有,溢价率可能扩大 |
|
|
152
|
+
|
|
153
|
+
4. 强赎套利逻辑:
|
|
154
|
+
- 强赎公告后,转债价格将向转股价值收敛
|
|
155
|
+
- 若转股价值 > 当前转债价格 → 买入转债 + 转股 + 卖出正股锁定差价
|
|
156
|
+
- 若转债价格 > 转股价值 → 卖出转债 (溢价率将快速压缩)
|
|
157
|
+
|
|
158
|
+
> ⚠️ 强赎公告后最后交易日通常有 15-30 个交易日,但最后几天流动性急剧下降,应提前操作。
|
|
159
|
+
|
|
160
|
+
> 💡 "不赎回"公告是隐含利好——说明公司希望持有人继续持有转债而非转股稀释股权,通常正股有上涨预期。
|
|
161
|
+
|
|
162
|
+
### Pattern 3: 下修转股价分析 (Conversion Price Reset)
|
|
163
|
+
|
|
164
|
+
**目标:** 识别可能下修转股价的转债,捕捉溢价率瞬间压缩的套利机会。
|
|
165
|
+
|
|
166
|
+
1. 查询下修条款:
|
|
167
|
+
`fin_derivatives(endpoint="convertible/detail", symbol="<转债代码>")`
|
|
168
|
+
→ 提取下修触发条件 (通常: 正股价连续 N 日 < 85% 转股价,各家条款不同)
|
|
169
|
+
|
|
170
|
+
2. 验证是否满足触发条件:
|
|
171
|
+
`fin_stock(endpoint="price/historical", symbol="<正股代码>", limit=30)`
|
|
172
|
+
→ 计算正股价/转股价比值
|
|
173
|
+
|
|
174
|
+
3. 下修概率评估:
|
|
175
|
+
|
|
176
|
+
| 因素 | 利于下修 | 不利于下修 |
|
|
177
|
+
| -------------- | ---------------------------- | -------------------- |
|
|
178
|
+
| 转债余额占比 | 余额大,公司有促转股动力 | 余额小,下修收益不大 |
|
|
179
|
+
| 回售压力 | 临近回售期,管理层被迫行动 | 距回售期远 |
|
|
180
|
+
| 大股东持仓 | 大股东持有转债,下修利好自己 | 大股东无持仓 |
|
|
181
|
+
| 股权稀释容忍度 | 总股本大,稀释比例小 | 小盘股,稀释影响大 |
|
|
182
|
+
|
|
183
|
+
4. 下修结果分类:
|
|
184
|
+
|
|
185
|
+
| 类型 | 含义 | 影响 |
|
|
186
|
+
| ---------- | -------------------------- | ---------------------------- |
|
|
187
|
+
| 下修到底 | 转股价下修至最新正股价附近 | 溢价率大幅压缩,转债价格飙升 |
|
|
188
|
+
| 下修不到位 | 转股价仅小幅下调 | 溢价率部分压缩,涨幅有限 |
|
|
189
|
+
| 拒绝下修 | 股东大会否决 | 利空,溢价率可能进一步扩大 |
|
|
190
|
+
|
|
191
|
+
> 💡 下修公告到股东大会表决通常需 15-20 个交易日,期间转债价格会逐步反映下修预期。
|
|
192
|
+
|
|
193
|
+
> ⚠️ 下修需经股东大会 2/3 以上同意,大股东投票意向是关键——提前查询大股东是否持有转债。
|
|
194
|
+
|
|
195
|
+
### Pattern 4: 到期收益率分析 (YTM Debt-Floor Valuation)
|
|
196
|
+
|
|
197
|
+
**目标:** 评估转债的债底保护强度,判断安全边际。
|
|
198
|
+
|
|
199
|
+
1. 获取转债基本信息:
|
|
200
|
+
`fin_derivatives(endpoint="convertible/detail", symbol="<转债代码>")`
|
|
201
|
+
→ 提取: 面值(通常100)、票面利率(各年不同)、到期赎回价、剩余年限
|
|
202
|
+
|
|
203
|
+
2. 获取当前价格:
|
|
204
|
+
`fin_derivatives(endpoint="convertible/historical", symbol="<转债代码>", limit=1)`
|
|
205
|
+
|
|
206
|
+
3. YTM 近似计算:
|
|
207
|
+
`YTM ≈ (到期赎回价 + 累计利息 - 当前价格) / (当前价格 × 剩余年限) × 100%`
|
|
208
|
+
|
|
209
|
+
4. YTM 分层解读:
|
|
210
|
+
|
|
211
|
+
| YTM 区间 | 属性 | 含义 |
|
|
212
|
+
| -------- | ------ | ---------------------------- |
|
|
213
|
+
| > 3% | 强债底 | 即使正股归零,到期仍有正收益 |
|
|
214
|
+
| 1% - 3% | 有债底 | 安全边际充足,适合保守投资者 |
|
|
215
|
+
| 0% - 1% | 弱债底 | 勉强保本,需依赖转股价值 |
|
|
216
|
+
| -3% - 0% | 无债底 | 已偏股化,需要正股上涨支撑 |
|
|
217
|
+
| < -3% | 纯投机 | 完全依赖股性,无安全边际 |
|
|
218
|
+
|
|
219
|
+
> ⚠️ YTM 计算假设发行人正常兑付——信用风险高的转债(评级 < AA-)即使 YTM 高也不安全。
|
|
220
|
+
|
|
221
|
+
> 💡 A 股转债利息税率 20%(个人投资者),计算税后 YTM 更准确: 税后利息 = 票面利息 × 0.8。
|
|
222
|
+
|
|
223
|
+
### Pattern 5: 信用风险评估 (Credit Risk Assessment)
|
|
224
|
+
|
|
225
|
+
**目标:** 排除有违约风险的转债,避免"搜特转债"式踩雷。
|
|
226
|
+
|
|
227
|
+
1. 查询转债评级和正股信息:
|
|
228
|
+
`fin_derivatives(endpoint="convertible/detail", symbol="<转债代码>")`
|
|
229
|
+
`fin_stock(endpoint="profile", symbol="<正股代码>")`
|
|
230
|
+
|
|
231
|
+
2. 查询正股财务健康度:
|
|
232
|
+
`fin_stock(endpoint="fundamental/ratios", symbol="<正股代码>")`
|
|
233
|
+
`fin_stock(endpoint="financial/cashflow", symbol="<正股代码>")`
|
|
234
|
+
`fin_stock(endpoint="shareholders/pledge", symbol="<正股代码>")`
|
|
235
|
+
|
|
236
|
+
3. 信用风险评分体系:
|
|
237
|
+
|
|
238
|
+
| 风险因子 | 低风险 | 中风险 | 高风险 (红线) |
|
|
239
|
+
| ------------ | ----------- | ---------- | ------------------ |
|
|
240
|
+
| 信用评级 | >= AA | AA- | < AA- 或无评级 |
|
|
241
|
+
| 质押率 | < 20% | 20% - 40% | > 40% |
|
|
242
|
+
| 经营现金流 | 连续 3 年正 | 间歇性为负 | 连续 2 年为负 |
|
|
243
|
+
| 正股市值 | > 100 亿 | 30-100 亿 | < 30 亿 |
|
|
244
|
+
| 是否 ST/\*ST | 否 | — | 是 (一票否决) |
|
|
245
|
+
| 审计意见 | 标准无保留 | 带强调事项 | 保留/否定/无法表示 |
|
|
246
|
+
|
|
247
|
+
4. 红线规则 (任一触发即排除):
|
|
248
|
+
- 正股 ST / \*ST
|
|
249
|
+
- 信用评级 < AA-
|
|
250
|
+
- 质押率 > 50%
|
|
251
|
+
- 连续 2 年经营现金流为负 + 净利润为负
|
|
252
|
+
|
|
253
|
+
> ⚠️ 搜特转债 (2022年首只违约) 暴雷前兆: AA 评级下调→正股连续亏损→质押率飙升→评级再下调→违约。评级变动是最重要的预警信号。
|
|
254
|
+
|
|
255
|
+
> 💡 银行转债 (如南银转债、苏银转债) 信用风险极低,但弹性也最小——适合稳健配置而非套利。
|
|
256
|
+
|
|
257
|
+
---
|
|
258
|
+
|
|
259
|
+
## A股可转债交易规则 (必知)
|
|
260
|
+
|
|
261
|
+
| 规则 | 详情 |
|
|
262
|
+
| ------------ | --------------------------------------------------------- |
|
|
263
|
+
| 交易方式 | T+0 (当天买入可当天卖出) |
|
|
264
|
+
| 涨跌幅限制 | 无涨跌幅限制 (但有临停规则) |
|
|
265
|
+
| 临停规则 | 涨跌 >= 20% 停牌 30 分钟; 涨跌 >= 30% 停牌至 14:57 |
|
|
266
|
+
| 转股期 | 发行后 6 个月可转股 (具体见募集说明书) |
|
|
267
|
+
| 强赎条款 | 正股价连续 N 日 > 130% 转股价 (通常 15/30 中的 15 日) |
|
|
268
|
+
| 回售条款 | 正股价连续 N 日 < 70% 转股价,持有人可按面值+利息回售 |
|
|
269
|
+
| 下修条款 | 正股价连续 N 日 < 85% 转股价,公司可提议下修 (需股东大会) |
|
|
270
|
+
| 税收 (个人) | 利息税 20%,资本利得免税 |
|
|
271
|
+
| 最小交易单位 | 10 张 (面值 1000 元) |
|
|
272
|
+
| 交易时间 | 9:30-11:30, 13:00-15:00 (同正股) |
|
|
273
|
+
|
|
274
|
+
---
|
|
275
|
+
|
|
276
|
+
## Data Notes
|
|
277
|
+
|
|
278
|
+
- **convertible/list**: 返回全市场存续可转债,含价格、溢价率、评级等核心字段
|
|
279
|
+
- **convertible/detail**: 返回单只转债的强赎/回售/下修条款细节、转股价、到期赎回价
|
|
280
|
+
- **convertible/historical**: 返回转债历史行情(OHLCV)及转股溢价率序列
|
|
281
|
+
- **正股数据联动**: 转债分析通常需同时查询正股数据,使用 fin_stock 的 price/historical 和 fundamental/ratios
|
|
282
|
+
- **数据延迟**: 收盘后更新,日内交易需注意数据时效
|
|
283
|
+
- **评级更新**: 信用评级非实时,通常跟踪评级公告
|
|
284
|
+
|
|
285
|
+
## Response Guidelines
|
|
286
|
+
|
|
287
|
+
- 始终用中文回复,专业术语可保留英文 (YTM, T+0, Delta 等)
|
|
288
|
+
- 涉及具体转债时,同时展示转债代码和简称 (如 113050.SH 南银转债)
|
|
289
|
+
- 双低策略筛选结果以表格形式呈现,按双低值升序排列
|
|
290
|
+
- 强赎/下修分析必须注明条款触发条件的具体天数和比例
|
|
291
|
+
- 信用风险评估明确标注红线因子,给出"安全/谨慎/回避"三级结论
|
|
292
|
+
- YTM 计算同时给出税前和税后数值
|
|
293
|
+
- 任何涉及操作建议时必须附带风险提示
|
|
294
|
+
- T+0 特性相关问题要提醒临停规则 (20% 和 30% 阈值)
|
|
@@ -0,0 +1,187 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: fin-a-dividend-king
|
|
3
|
+
description: "A-share dividend strategy — continuous dividend history, yield screening, payout safety, dividend trap detection, tax-aware income planning. Use when: user asks about high-dividend A-shares, dividend sustainability, income investing, dividend reinvestment, or dividend tax rules. NOT for: individual stock deep analysis (use fin-a-share), US/HK dividend stocks (use fin-us-dividend/fin-hk-dividend-harvest), index DCA timing (use fin-a-index-timer), factor screening (use fin-factor-screen)."
|
|
4
|
+
metadata:
|
|
5
|
+
{
|
|
6
|
+
"openclaw":
|
|
7
|
+
{ "emoji": "\ud83c\udf39", "requires": { "extensions": ["findoo-datahub-plugin"] } },
|
|
8
|
+
}
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# A-Share Dividend King Strategy
|
|
12
|
+
|
|
13
|
+
Use **fin_stock** and **fin_index** for systematic A-share dividend investing. Core logic: continuous dividends + sustainable payout + cash flow backing = true dividend king; high yield alone may be a trap.
|
|
14
|
+
|
|
15
|
+
## When to Use
|
|
16
|
+
|
|
17
|
+
- "A股哪些高股息股票" / "high dividend A-shares"
|
|
18
|
+
- "中国神华分红安全吗" / "is Shenhua's dividend safe"
|
|
19
|
+
- "红利ETF和自选组合哪个好" / "dividend ETF vs custom portfolio"
|
|
20
|
+
- "连续分红多少年" / "how many years of consecutive dividends"
|
|
21
|
+
- "每月投5000做红利策略" / "monthly 5000 RMB dividend strategy"
|
|
22
|
+
- "股息率4%以上的股票" / "stocks with yield above 4%"
|
|
23
|
+
- "红利税怎么算" / "how does dividend tax work"
|
|
24
|
+
- "高股息会不会是陷阱" / "could high yield be a trap"
|
|
25
|
+
|
|
26
|
+
## When NOT to Use
|
|
27
|
+
|
|
28
|
+
- 个股全景分析 (基本面/筹码/技术面) -> use `/fin-a-share`
|
|
29
|
+
- 美股股息策略 -> use `/fin-us-dividend`
|
|
30
|
+
- 港股高息策略 -> use `/fin-hk-dividend-harvest`
|
|
31
|
+
- 指数估值定投 -> use `/fin-a-index-timer`
|
|
32
|
+
- 量化多因子选股 -> use `/fin-factor-screen`
|
|
33
|
+
- 可转债/期货/期权 -> use `/fin-derivatives`
|
|
34
|
+
- 宏观经济数据 -> use `/fin-macro`
|
|
35
|
+
- 概念炒作周期 -> use `/fin-a-concept-cycle`
|
|
36
|
+
|
|
37
|
+
## Tools & Parameters
|
|
38
|
+
|
|
39
|
+
### fin_stock -- Dividend & Fundamental Data
|
|
40
|
+
|
|
41
|
+
| Parameter | Type | Required | Format | Default | Example |
|
|
42
|
+
| ---------- | ------ | -------- | --------------- | ------- | --------------------- |
|
|
43
|
+
| symbol | string | Yes | `{code}.SH/SZ` | -- | 601088.SH |
|
|
44
|
+
| endpoint | string | Yes | see table below | -- | fundamental/dividends |
|
|
45
|
+
| start_date | string | No | YYYY-MM-DD | -- | 2020-01-01 |
|
|
46
|
+
| end_date | string | No | YYYY-MM-DD | -- | 2026-12-31 |
|
|
47
|
+
| limit | number | No | 1-5000 | 200 | 50 |
|
|
48
|
+
|
|
49
|
+
#### Endpoints
|
|
50
|
+
|
|
51
|
+
| endpoint | Description | Example |
|
|
52
|
+
| ----------------------- | ------------------------ | --------------------------------------------------------------------------- |
|
|
53
|
+
| `fundamental/dividends` | Dividend history | `fin_stock(symbol="601088.SH", endpoint="fundamental/dividends", limit=20)` |
|
|
54
|
+
| `fundamental/ratios` | Yield/PE/PB/ROE | `fin_stock(symbol="601088.SH", endpoint="fundamental/ratios", limit=8)` |
|
|
55
|
+
| `fundamental/income` | Net income (payout calc) | `fin_stock(symbol="601088.SH", endpoint="fundamental/income", limit=8)` |
|
|
56
|
+
| `fundamental/cash` | OCF (sustainability) | `fin_stock(symbol="601088.SH", endpoint="fundamental/cash", limit=8)` |
|
|
57
|
+
| `fundamental/balance` | Asset/liability check | `fin_stock(symbol="601088.SH", endpoint="fundamental/balance", limit=4)` |
|
|
58
|
+
| `price/historical` | Total return tracking | `fin_stock(symbol="601088.SH", endpoint="price/historical", limit=250)` |
|
|
59
|
+
| `profile` | Industry classification | `fin_stock(symbol="601088.SH", endpoint="profile")` |
|
|
60
|
+
|
|
61
|
+
### fin_index -- Dividend Index Benchmarks
|
|
62
|
+
|
|
63
|
+
| Parameter | Type | Required | Format | Default | Example |
|
|
64
|
+
| --------- | ------ | -------- | -------------- | ------- | ------------ |
|
|
65
|
+
| symbol | string | Depends | `XXXXXX.SH/SZ` | -- | 000922.SH |
|
|
66
|
+
| endpoint | string | Yes | see table | -- | constituents |
|
|
67
|
+
| limit | number | No | 1-5000 | 200 | 100 |
|
|
68
|
+
|
|
69
|
+
#### Endpoints
|
|
70
|
+
|
|
71
|
+
| endpoint | Description | Example |
|
|
72
|
+
| ------------------ | ------------------------------ | ------------------------------------------------------------------ |
|
|
73
|
+
| `constituents` | Index members (screening pool) | `fin_index(symbol="000922.SH", endpoint="constituents")` |
|
|
74
|
+
| `daily_basic` | Index PE/PB valuation | `fin_index(symbol="000922.SH", endpoint="daily_basic", limit=250)` |
|
|
75
|
+
| `price/historical` | Index price history | `fin_index(symbol="000922.SH", endpoint="price/historical")` |
|
|
76
|
+
|
|
77
|
+
**Key dividend indices:**
|
|
78
|
+
|
|
79
|
+
- `000922.SH` -- CSI Dividend Index (中证红利)
|
|
80
|
+
- `000015.SH` -- Dividend Index (上证红利)
|
|
81
|
+
- `399324.SZ` -- Shenzhen Dividend Price Index (深证红利)
|
|
82
|
+
|
|
83
|
+
## Dividend Analysis Pattern
|
|
84
|
+
|
|
85
|
+
1. **Dividend Continuity Check** `fin_stock(fundamental/dividends, limit=15)` -- Establish track record
|
|
86
|
+
- Count consecutive years with cash dividend > 0
|
|
87
|
+
- Calculate average annual dividend per share and growth rate
|
|
88
|
+
- Check for irregular patterns (special dividends, stock dividends only)
|
|
89
|
+
- > =5 consecutive years = stable; >=10 years = king; <3 years = unreliable
|
|
90
|
+
- Payout frequency: most A-shares pay annually (Apr-Jul); some pay semi-annually
|
|
91
|
+
|
|
92
|
+
2. **Yield Validation** `fin_stock(fundamental/ratios, limit=8)` -- Current yield vs history
|
|
93
|
+
- Current dividend yield (dv_ratio field) vs 5-year average
|
|
94
|
+
- > =4% = attractive; >=6% = unusually high (verify sustainability)
|
|
95
|
+
- Compare PE/PB to determine if high yield comes from price drop (may be value trap)
|
|
96
|
+
- <=2% = below market, not suitable for income strategy
|
|
97
|
+
- ROE should be >8% for sustainable dividends
|
|
98
|
+
|
|
99
|
+
3. **Payout Safety** `fin_stock(fundamental/income, limit=8)` + `fin_stock(fundamental/cash, limit=8)` -- Can they keep paying?
|
|
100
|
+
- Payout ratio = total dividend / net income
|
|
101
|
+
- <60% = very safe; 60-70% = safe; 70-85% = elevated; >85% = at risk of cut
|
|
102
|
+
- OCF / total dividend > 1.5x = cash flow backed; <1.0x = borrowing to pay dividends
|
|
103
|
+
- Net income trend: declining 2+ quarters = future payout at risk
|
|
104
|
+
- Free cash flow (OCF - CapEx) should cover dividends
|
|
105
|
+
|
|
106
|
+
4. **Dividend Trap Detection** -- Cross-validate steps 1-3
|
|
107
|
+
- Trap Signal 1: yield >8% + declining revenue 2 quarters = likely cut next year
|
|
108
|
+
- Trap Signal 2: payout ratio >90% + OCF/dividend <1.0 = unsustainable
|
|
109
|
+
- Trap Signal 3: one-time special dividend inflating yield (check dividend history for irregularity)
|
|
110
|
+
- Trap Signal 4: high yield from price crash (PE dropping) not from growing dividends
|
|
111
|
+
- Safe Signal: yield 4-6% + payout <65% + OCF coverage >2x + stable/growing earnings = genuine king
|
|
112
|
+
|
|
113
|
+
5. **Industry Layer** `fin_stock(profile)` -- Sector-specific dividend characteristics
|
|
114
|
+
- Utilities (power/water): most stable, 4-5% yield, low growth, quasi-bond
|
|
115
|
+
- Banks: highest yield (5-7%), very low payout ratio (25-35%), safe but zero growth
|
|
116
|
+
- Energy (coal/oil): cyclical, current high yield may not persist through down-cycle
|
|
117
|
+
- Consumer staples: moderate yield (2-4%), but dividend growth 8-12% p.a.
|
|
118
|
+
- Real estate: historically high yield, but sector risk post-2022 makes sustainability questionable
|
|
119
|
+
- Telecom (China Mobile/Unicom/Telecom): state-owned, stable 4-5%, improving payout policy
|
|
120
|
+
|
|
121
|
+
6. **Dividend Index Benchmark** `fin_index(daily_basic, symbol=000922.SH, limit=250)` -- Is the strategy cheap?
|
|
122
|
+
- CSI Dividend Index current PE/PB vs 10-year percentile
|
|
123
|
+
- PE <30% percentile = dividend stocks are cheap (good entry)
|
|
124
|
+
- PE >70% percentile = dividend premium exhausted, reduce exposure
|
|
125
|
+
- Compare individual stock yield to CSI Dividend Index yield
|
|
126
|
+
|
|
127
|
+
## Dividend Tax Rules (A-Share)
|
|
128
|
+
|
|
129
|
+
| Holding Period | Tax Rate | Net Yield (on 5% gross) |
|
|
130
|
+
| ---------------- | -------- | ----------------------- |
|
|
131
|
+
| < 1 month | 20% | 4.0% |
|
|
132
|
+
| 1 month - 1 year | 10% | 4.5% |
|
|
133
|
+
| > 1 year | 0% | 5.0% |
|
|
134
|
+
|
|
135
|
+
**Strategy implication:** Hold dividend stocks > 1 year for tax-free dividends. Short-term traders lose 20% of dividend income to tax.
|
|
136
|
+
|
|
137
|
+
## Dividend Reinvestment Compound Model
|
|
138
|
+
|
|
139
|
+
When user asks about long-term wealth building:
|
|
140
|
+
|
|
141
|
+
```
|
|
142
|
+
Given: monthly investment M, average yield Y, dividend growth rate G
|
|
143
|
+
Year N total = M * 12 * N * (1 + Y * (1+G)^(N/2)) (simplified)
|
|
144
|
+
|
|
145
|
+
Example: M=5000, Y=5%, G=3%, N=20
|
|
146
|
+
Principal: 5000 * 12 * 20 = 1,200,000
|
|
147
|
+
With DRIP compound: ~1,980,000 (estimated)
|
|
148
|
+
Dividend income Year 20: ~99,000/year (~8,250/month passive income)
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
Show both with and without dividend reinvestment to demonstrate compounding power.
|
|
152
|
+
|
|
153
|
+
## Data Notes
|
|
154
|
+
|
|
155
|
+
- **Dividend data**: Tushare, updated after annual/interim report disclosure (Apr-Aug main window)
|
|
156
|
+
- **Dividend yield**: calculated on trailing 12-month dividends; forward yield needs manual estimate
|
|
157
|
+
- **Payout ratio**: use annual data only (quarterly dividends rare in A-shares)
|
|
158
|
+
- **Ex-dividend dates**: extractable from `fundamental/dividends` record_date/ex_date fields
|
|
159
|
+
- **A-share specifics**: most companies pay once per year; some SOEs moving to semi-annual
|
|
160
|
+
- **Data lag**: dividend announcements may lag actual board decision by 1-2 weeks
|
|
161
|
+
|
|
162
|
+
## Response Guidelines
|
|
163
|
+
|
|
164
|
+
### Number Format
|
|
165
|
+
|
|
166
|
+
- Dividend yield: 5.23% (2 decimal places, always with %)
|
|
167
|
+
- Payout ratio: 62.5% (1 decimal place)
|
|
168
|
+
- Dividend per share: 1.85 RMB/share
|
|
169
|
+
- Market cap / revenue: > 1 yi use "yi RMB", < 1 yi use "wan RMB"
|
|
170
|
+
- Consecutive years: "10 consecutive years" (integer)
|
|
171
|
+
- OCF coverage: 2.3x (1 decimal place)
|
|
172
|
+
|
|
173
|
+
### Must Include
|
|
174
|
+
|
|
175
|
+
- Data cutoff date
|
|
176
|
+
- Consecutive dividend years count
|
|
177
|
+
- Payout ratio with safety assessment
|
|
178
|
+
- OCF coverage ratio
|
|
179
|
+
- Dividend tax impact based on holding period
|
|
180
|
+
- Any trap warning signals detected
|
|
181
|
+
|
|
182
|
+
### Display Format
|
|
183
|
+
|
|
184
|
+
- Single stock dividend analysis: narrative with key metrics bolded
|
|
185
|
+
- Multi-stock dividend screening: table (columns: stock / yield / consecutive years / payout ratio / OCF coverage / safety score)
|
|
186
|
+
- Dividend history: summarize trend direction + key changes, don't list every year
|
|
187
|
+
- Always end with: holding period tax reminder + ex-dividend date if approaching
|