@openfinclaw/findoo-datahub-plugin 2026.3.2 → 2026.3.10

package/skills/a-share-radar/skill.md

@@ -0,0 +1,185 @@
+---
+name: fin-a-share-radar
+description: "A-share market monitoring — dragon-tiger list, limit-up/down stats, block trades, sector money flow, margin trading, Stock Connect (north/south bound), IPO calendar. DataHub endpoints via fin_market. Use when: user asks about A-share market overview, daily recap, unusual trading activity, institutional flows, margin levels, northbound/southbound capital. NOT for: individual A-share stock analysis (use fin-a-share), US/HK markets, macro data (use fin-macro)."
+metadata: { "openclaw": { "emoji": "📡", "requires": { "extensions": ["findoo-datahub-plugin"] } } }
+---
+
+# A-Share Market Radar
+
+Use **fin_market** for A-share market-wide monitoring and anomaly detection via DataHub.
+
+## Tools & Parameters
+
+### fin_market
+
+| Parameter  | Type   | Required | Format              | Default | Example         |
+| ---------- | ------ | -------- | ------------------- | ------- | --------------- |
+| endpoint   | string | Yes      | see endpoint table  | —       | market/top_list |
+| trade_date | string | No       | YYYY-MM-DD (交易日) | latest  | 2026-02-28      |
+| symbol     | string | No       | stock code          | —       | 600519.SH       |
+| start_date | string | No       | YYYY-MM-DD          | —       | 2026-02-01      |
+| end_date   | string | No       | YYYY-MM-DD          | —       | 2026-02-28      |
+| limit      | number | No       | 1-5000              | 200     | 30              |
+
+## Endpoints
+
+### 龙虎榜 & 异动 (4)
+
+| endpoint             | Description                          | Key Params | Example                                                                                             |
+| -------------------- | ------------------------------------ | ---------- | --------------------------------------------------------------------------------------------------- |
+| `market/top_list`    | Dragon-tiger list (top movers)       | date       | `fin_market(endpoint="market/top_list", date="2026-02-28")`                                         |
+| `market/top_inst`    | Institutional trades on dragon-tiger | date       | `fin_market(endpoint="market/top_inst", date="2026-02-28")`                                         |
+| `market/limit_list`  | Limit-up/down stocks                 | date       | `fin_market(endpoint="market/limit_list", date="2026-02-28")`                                       |
+| `market/suspend`     | Trading suspensions                  | trade_date | `fin_market(endpoint="market/suspend")`                                                             |
+| `market/stock_limit` | 个股涨跌停价 (tushare)               | symbol     | `fin_market(endpoint="market/stock_limit", symbol="600519.SH")` — 需带 symbol，不支持按日期批量扫描 |
+
+### 资金流向 (3)
+
+| endpoint                | Description            | Key Params | Example                                                                 |
+| ----------------------- | ---------------------- | ---------- | ----------------------------------------------------------------------- |
+| `moneyflow/individual`  | Per-stock capital flow | symbol     | `fin_market(endpoint="moneyflow/individual", symbol="600519.SH")`       |
+| `moneyflow/industry`    | Sector capital flow    | trade_date | `fin_market(endpoint="moneyflow/industry", trade_date="2026-02-28")`    |
+| `moneyflow/block_trade` | Block trade records    | trade_date | `fin_market(endpoint="moneyflow/block_trade", trade_date="2026-02-28")` |
+
+### 融资融券 (3)
+
+| endpoint         | Description                 | Key Params | Example                                                          |
+| ---------------- | --------------------------- | ---------- | ---------------------------------------------------------------- |
+| `margin/summary` | Market margin summary       | trade_date | `fin_market(endpoint="margin/summary", trade_date="2026-02-28")` |
+| `margin/detail`  | Per-stock margin detail     | symbol     | `fin_market(endpoint="margin/detail", symbol="600519.SH")`       |
+| `margin/trading` | Margin trading transactions | trade_date | `fin_market(endpoint="margin/trading", trade_date="2026-02-28")` |
+
+### 北向资金 / Stock Connect (4)
+
+| endpoint           | Description                                  | Key Params          | Example                                                                           |
+| ------------------ | -------------------------------------------- | ------------------- | --------------------------------------------------------------------------------- |
+| `flow/hsgt_flow`   | Northbound/Southbound daily flows            | start_date/end_date | `fin_market(endpoint="flow/hsgt_flow", start_date="2026-02-01")`                  |
+| `flow/hsgt_top10`  | Top 10 HSGT holdings                         | date                | `fin_market(endpoint="flow/hsgt_top10", date="2026-02-28")`                       |
+| `flow/ggt_daily`   | Southbound daily flows                       | start_date/end_date | `fin_market(endpoint="flow/ggt_daily", start_date="2026-02-01")`                  |
+| `flow/ggt_monthly` | 南向月度汇总 (tushare)                       | start_date/end_date | `fin_market(endpoint="flow/ggt_monthly")` — 中长期南向资金趋势                    |
+| `flow/ggt_top10`   | Southbound top 10 transactions ⚠️ UNRELIABLE | trade_date          | ~~`fin_market(endpoint="flow/ggt_top10")`~~ — DataHub 超时，改用 `flow/ggt_daily` |
+
+### 互联互通成分股 (1)
+
+| endpoint        | Description                    | Key Params | Example                                             |
+| --------------- | ------------------------------ | ---------- | --------------------------------------------------- |
+| `flow/hs_const` | Stock Connect constituent list | symbol     | `fin_market(endpoint="flow/hs_const", symbol="SH")` |
+
+### 全市场快照 (1)
+
+| endpoint           | Description          | Key Params | Example                                                                             |
+| ------------------ | -------------------- | ---------- | ----------------------------------------------------------------------------------- |
+| `market_snapshots` | 全市场快照 (massive) | —          | `fin_market(endpoint="market_snapshots")` — 返回 12000+ 记录，含所有标的最新价/成交 |
+
+### 市场发现 (5)
+
+| endpoint                | Description       | Key Params | Example                                        |
+| ----------------------- | ----------------- | ---------- | ---------------------------------------------- |
+| `discovery/gainers`     | Top gainers       | —          | `fin_market(endpoint="discovery/gainers")`     |
+| `discovery/losers`      | Top losers        | —          | `fin_market(endpoint="discovery/losers")`      |
+| `discovery/active`      | Most active       | —          | `fin_market(endpoint="discovery/active")`      |
+| `discovery/new_share`   | IPO calendar      | —          | `fin_market(endpoint="discovery/new_share")`   |
+| `market/trade_calendar` | Exchange calendar | —          | `fin_market(endpoint="market/trade_calendar")` |
+
+## Post-Market Review (盘后复盘 7 步)
+
+1. **涨跌全貌** `market/limit_list` — 涨停>80+跌停<10=强势; 跌停>50=恐慌
+2. **龙虎榜** `market/top_list` + `market/top_inst` — 机构买>卖=看多
+3. **板块资金** `moneyflow/industry` — 连续3日净流入=主题行情
+4. **北向资金** `flow/hsgt_flow` — 单日净流出>100亿=外资撤离
+5. **南向资金** `flow/ggt_daily` — 内资港股配置方向 | `flow/ggt_monthly` — 中长期趋势
+6. **融资余额** `margin/summary` — 余额增+指数涨=杠杆入场; 高位滞涨=了结风险
+7. **融资明细** `margin/trading` — 个股融资买入/偿还
+
+## Pre-Market Scan (盘前扫描 6 步)
+
+0. **全市场快照** `market_snapshots` → 全市场快照概览，盘前快速获取所有标的最新价/成交量
+1. **隔夜情绪** `discovery/gainers` + `discovery/losers` — 涨幅榜集中度>30%=题材延续; 跌幅榜龙头补跌=退潮信号
+2. **交易日历** `market/trade_calendar` — 确认今日是否交易，长假前后流动性变化
+3. **大宗交易** `moneyflow/block_trade` — 溢价=看好, 大幅折价=减持信号
+4. **IPO 日历** `discovery/new_share` — 本周新股申购/上市，打新冻结资金影响
+5. **昨日北向** `flow/hsgt_flow` — 隔夜欧美收盘后外资动向前瞻
+
+## 量化异常评分
+
+采集 5 个维度，各 20 分，总分 100:
+
+| 维度         | 数据源               | 关键阈值                       |
+| ------------ | -------------------- | ------------------------------ |
+| 涨停数信号   | `market/limit_list`  | >100=满分, 50-100=中, <30=零分 |
+| 北向资金     | `flow/hsgt_flow`     | 净流入>100亿=满分, <-50亿=零分 |
+| 融资余额变化 | `margin/summary`     | 日增>100亿=满分, 降>50亿=零分  |
+| 板块集中度   | `moneyflow/industry` | Top3占比>50%=满分, <15%=低分   |
+| 龙虎榜机构   | `market/top_inst`    | 净买>10亿=满分, 净卖>5亿=零分  |
+
+综合解读: 80-100=极度看多(注意过热), 50-79=中性偏多(结构性机会), 30-49=偏空(防御), <30=看空(等待企稳)。
+
+**动量加速因子**: 将今日总分与 5 日均分对比 — 差值>+15=加速看多(情绪拐点), <-15=加速看空(恐慌升级), ±5 内=趋势延续。连续 3 日同向加速=强趋势确认。
+
+## 高级监控模式
+
+### 连板梯队分析 (A股独有)
+
+`market/limit_list` 按连板天数分层: 1板数>60=活跃/<20=冰点; 2-3板晋级率>30%=强共识; 最高板达7+=赚钱效应极强。
+**核心指标**: 晋级率 = N+1板数/N板数。连续2日下降=退潮信号，提前1-2日预警。
+
+### 机构席位交叉分析
+
+`market/top_inst` 多日交叉比对:
+
+- **同席位多票**: 同一席位3日内现身3+票=主题型建仓(推断板块方向)
+- **机构对倒**: 同票同日买+卖席位均现=分歧,短期见顶概率高
+- **净买集中度**: Top3机构占全市场>40%=高确定性方向
+
+### 板块轮动动量
+
+`moneyflow/industry` 5日滚动净流入判断轮动节奏:
+
+- **启动**: 净流出转净流入+连续3日递增=新主线候选
+- **加速**: 环比增速>50%且进入Top3=确认主线
+- **衰竭**: 绝对值大但环比降2日=兑现期,资金将切换
+
+### 融资盘杠杆预警
+
+`margin/summary` 时间序列(start_date/end_date):
+
+- **加杠杆**: 5日余额增>3%+近60日高位=过热; **平仓**: 5日降>5%+指数加速跌=被动去杠杆
+- **底部**: 连续10日缩减后企稳+指数止跌=杠杆出清,左侧布局信号
+
+### 南北向资金背离
+
+`flow/hsgt_flow`(北向) vs `flow/ggt_daily`(南向) 方向相反时:
+
+| 模式     | 北向  | 南向     | 解读                |
+| -------- | ----- | -------- | ------------------- |
+| AH共振   | 流入  | 流入港股 | risk-on,最强信号    |
+| AH跷跷板 | 流入A | 流出港股 | A股估值/政策优势    |
+| 全面避险 | 流出A | 流出港股 | 关注美元/美债       |
+| 港股虹吸 | 流出A | 流入港股 | AH溢价过高/南向抄底 |
+
+连续3日同向=趋势信号; 单日异动可能为MSCI调仓/ETF申赎扰动。
+
+### 周度复盘模板
+
+周五盘后聚合5日数据(start_date=周一, end_date=周五):
+
+1. `market/limit_list` — 周涨停总数+日均+最高板(vs上周)
+2. `flow/hsgt_flow` — 周累计净流入(vs 20周均值)
+3. `moneyflow/industry` — Top5板块排名+新进/退出
+4. `margin/summary` — 融资余额周变化率
+5. `market/top_inst` — 机构净买Top10+板块归因
+
+### 月度趋势判断
+
+20日滚动(start_date=20日前): 北向月累计>200亿=趋势流入/<-100亿=撤离; 融资月变化>5%=杠杆堆积/<-5%=出清; 涨停日均>80+晋级率>25%=赚钱效应持续。
+
+## Data Notes
+
+- **龙虎榜/涨停**: 收盘后约 18:00 发布，1-2 小时延迟
+- **北向资金**: DataHub 提供收盘确认数据（非盘中估算）
+- **南向资金**: 收盘后发布，港股交易时间与 A 股不完全重合
+- **融资融券**: T+1 发布（今天看到的是昨日数据）
+- **大宗交易**: 收盘后发布
+- **trade_date**: 必须是交易日（周末/节假日无数据）
+- **discovery/gainers|losers**: yfinance 数据源，偶有速率限制
+- **hs_const**: 成分股名单不定期调整，以交易所公告为准

package/skills/cross-asset/skill.md

@@ -0,0 +1,202 @@
+---
+name: fin-cross-asset
+description: "Cross-asset correlation and allocation — stock-bond-FX-commodity linkage, Merrill Clock positioning, risk parity signals. Orchestrates fin_macro + fin_index + fin_market + fin_derivatives. Use when: user asks about asset allocation, cross-market correlation, stock-bond relationship, AH premium arbitrage, or macro-driven portfolio rotation. NOT for: single-asset deep analysis (use fin-a-share for A-shares, fin-us-equity for US, fin-hk-stock for HK), A-share market signals (use fin-a-share-radar)."
+metadata: { "openclaw": { "emoji": "🔗", "requires": { "extensions": ["findoo-datahub-plugin"] } } }
+---
+
+# Cross-Asset Correlation & Allocation
+
+跨资产相关性分析与大类资产配置。综合编排 **fin_macro** + **fin_index** + **fin_market** + **fin_derivatives** + **fin_crypto**，构建宏观象限判定与配置建议。
+
+> 美林时钟象限判定 → see `fin-macro` skill (Macro Cycle Locator 段落)。本 skill 聚焦跨资产配置权重映射。
+
+## 多工具编排序列
+
+### 完整跨资产分析 (8 步)
+
+1. **宏观定位**: `fin_macro(endpoint="pmi")` + `fin_macro(endpoint="cpi")` → 判定经济+通胀方向
+2. **流动性评估**: `fin_macro(endpoint="shibor")` + `fin_macro(endpoint="money_supply")` → M2/M1 剪刀差
+3. **股票市场**: `fin_index(symbol="000300.SH")` + `fin_index(symbol="000905.SH")` → 大小盘风格
+4. **债券市场**: `fin_macro(endpoint="treasury_cn")` → 期限利差
+5. **汇率+外资**: `fin_macro(endpoint="currency/price/historical", symbol="USDCNH")` + `fin_market(endpoint="flow/hsgt_flow")` → 外部冲击
+6. **商品信号**: `fin_derivatives(symbol="SC.INE", endpoint="futures/historical")` + 黄金 + 铜 → 通胀预期交叉验证
+7. **象限判定**: 综合以上 6 步 → 输出当前象限 + 配置建议表
+8. **配置输出**: 生成配置表 (资产类别 / 权重% / 代理标的 / 置信度高中低)，权重合计 100%
+
+## 核心工具端点
+
+### 股票代理 (fin_index)
+
+```
+fin_index(symbol="000300.SH", endpoint="price/historical", limit=250)  # 沪深300
+fin_index(symbol="000905.SH", endpoint="price/historical", limit=250)  # 中证500
+fin_index(symbol="399006.SZ", endpoint="price/historical", limit=250)  # 创业板指
+fin_index(endpoint="daily_basic", symbol="000300.SH")                  # 估值数据
+```
+
+### 债券代理 (fin_macro)
+
+```
+fin_macro(endpoint="treasury_cn", limit=250)       # 中国国债收益率
+fin_macro(endpoint="treasury_us", limit=250)        # 美债收益率
+fin_macro(endpoint="shibor", limit=60)               # 银行间利率
+```
+
+### 外汇代理 (fin_macro)
+
+```
+fin_macro(endpoint="currency/price/historical", symbol="USDCNH", limit=250)
+fin_macro(endpoint="currency/snapshots")
+```
+
+### 商品代理 (fin_derivatives — 期货价格代理)
+
+DataHub 无直接大宗商品现货端点，**使用期货价格作为代理**:
+
+```
+fin_derivatives(symbol="AU.SHF", endpoint="futures/historical", limit=250)  # 黄金
+fin_derivatives(symbol="CU.SHF", endpoint="futures/historical", limit=250)  # 铜 (经济晴雨表)
+fin_derivatives(symbol="SC.INE", endpoint="futures/historical", limit=250)  # 原油
+```
+
+### 资金流向 (fin_market)
+
+```
+fin_market(endpoint="flow/hsgt_flow")     # 北向资金
+fin_market(endpoint="flow/ggt_daily")     # 南向资金 (日频)
+fin_market(endpoint="flow/ggt_monthly")   # 南向资金 (月度汇总，跨资产趋势分析)
+fin_market(endpoint="margin/summary")     # 融资融券
+```
+
+### 加密资产 (fin_crypto)
+
+```
+fin_crypto(endpoint="coin/historical", symbol="bitcoin", start_date="2025-01-01", end_date="2026-03-07")
+# ⚠️ coin/historical 使用 CoinGecko API，需传 coin_id（如 "bitcoin"），非交易对格式
+# ⚠️ 必须传 start_date/end_date，不支持 limit 参数
+fin_crypto(endpoint="coin/global_stats")  # 全局市值/BTC dominance
+```
+
+### 市场体制 (fin_data_regime)
+
+```
+fin_data_regime(symbol="000300.SH")  # 当前市场体制检测
+```
+
+## 相关性矩阵 — 异常信号表
+
+| 资产对             | 正常相关性 | 异常信号                                |
+| ------------------ | ---------- | --------------------------------------- |
+| 股票 vs 债券       | 负相关     | 同涨 = 流动性泛滥; 同跌 = 流动性危机    |
+| 铜 vs 原油         | 正相关     | 铜跌油涨 = 滞胀信号                     |
+| 美债 vs A 股       | 弱负相关   | 美债利率急升 → A 股外资流出压力         |
+| BTC vs 纳斯达克    | 近年正相关 | 脱钩 = 加密市场独立叙事                 |
+| 人民币 vs 北向资金 | 正相关     | 人民币贬值 + 北向流出 = 双重压力        |
+| CNH vs 北向资金    | 正相关     | CNH 升值但北向净流出 = 避险性撤资       |
+| Shibor vs 股票     | 弱负相关   | Shibor 急升 + 股市大跌 = 钱荒踩踏       |
+| 原油 vs CPI        | 滞后正相关 | 油价飙升 3-6 月后 CPI 跟涨 = 输入性通胀 |
+
+## 信号交叉验证
+
+经济动能(PMI) × 通胀(CPI/PPI/M2) × 流动性(Shibor) × 外部(美债 treasury_us) → 象限判定 → 配置建议
+
+置信度: 4/4 一致 = 高; 3/4 = 中; 2/4 = 低 → 低置信度时现金 >= 30%。
+
+## 特殊场景 Pattern
+
+### 股债双杀 (流动性危机)
+
+触发: 股票暴跌 + 债券暴跌 + Shibor 急升（信用利差代理）
+
+- 验证: `fin_macro(shibor)` O/N 急升 + `fin_macro(shibor_quote)` 期限结构倒挂 + `fin_macro(treasury_cn)` + `fin_index(000300.SH)`
+- ⚠️ DataHub 无直接信用利差端点，用 Shibor O/N 变化 + 期限结构作为流动性压力代理
+- 应对: 超配现金 + 黄金，等待央行注入流动性
+
+### AH 溢价套利
+
+触发: AH 溢价指数偏离历史均值
+
+- 验证: `fin_stock(601398.SH)` (see fin-a-share) + `fin_stock(01398.HK)` (see fin-hk-stock) + `fin_macro(currency/price/historical, USDCNH)`
+- 高溢价做多港股低配 A 股，低溢价反向
+
+### USD-CNY-A股 三角联动
+
+触发: 美元走强 + 人民币快速贬值
+
+- 验证: `fin_macro(currency/price/historical, USDCNH)` + `fin_market(flow/hsgt_flow)`
+- 链路: 美元强 → 人民币弱 → 北向流出 → A 股承压
+
+### 收益率曲线倒挂 (衰退前兆)
+
+触发: 10Y - 2Y 利差转负 (`fin_macro(treasury_cn)` 或 `fin_macro(treasury_us)`)
+
+- 倒挂 > 3 月 → 12-18 月内衰退概率显著上升; 解除倒挂后反而更危险
+- 应对: 减配股票 + 超配长债，等待降息周期
+
+## 进阶跨资产模式
+
+### Risk-On / Risk-Off 快速判定
+
+并行查 4 指标: `fin_crypto(coin/global_stats)` BTC 24h 变化 + `fin_derivatives(AU.SHF)` + `fin_data_regime(000300.SH)` + `fin_macro(treasury_us)`
+
+> ⚠️ coin/historical 需 coin_id + start_date/end_date，快速判定改用 coin/global_stats 的 btc_market_cap_change_percentage_24h
+
+- BTC涨 + 黄金跌 + 体制=bull + 美债收益率升 → **Risk-On** → 超配股票/高收益资产
+- BTC跌 + 黄金涨 + 体制=bear/crisis + 美债收益率降 → **Risk-Off** → 超配债券/现金/黄金
+- 3/4 一致 = 高置信; 2:2 分裂 = 观望，现金 >= 30%
+
+### 铜金比经济晴雨表
+
+`fin_derivatives(CU.SHF)` / `fin_derivatives(AU.SHF)` 比值趋势:
+
+- 上行 = 经济扩张信心 → 利好股票/工业品; 下行 = 衰退/避险 → 利好黄金/国债
+- 铜金比与 PMI 背离 > 2 月 = 领先信号，关注拐点
+
+### 美元周期与新兴市场
+
+补充: `fin_macro(endpoint="worldbank/country")` → 国别分类 (发达/新兴)，辅助全球资产配置决策。
+
+`fin_macro(currency/price/historical, USDCNH)` + `fin_macro(index_global)` + `fin_market(flow/hsgt_flow)`:
+
+- 美元强周期: EM 资本外流 → 减配 A/港股; 弱周期: 资本回流 → 增配 A/港股/商品
+- USDCNH 趋势与北向流向背离 = 政策干预或结构性变化
+
+### 实际利率与黄金定价
+
+`fin_macro(treasury_us)` 10Y - `fin_macro(cpi)` 最新同比 = 实际利率:
+
+- 负实际利率 → 黄金看涨; > 2% → 黄金承压，现金/短债更优
+- 从正转负 = 黄金最佳入场窗口
+
+### 中国信贷脉冲
+
+`fin_macro(social_financing)` + `fin_macro(money_supply)`:
+
+- 信贷脉冲 = 社融增量的二阶导 (3 月移动平均增速的变化率)。脉冲转正 → 6-9 月后大宗需求回升
+- 脉冲正 → 增配铜/原油/A 股周期板块
+
+### Crypto-Equity 脱钩检测
+
+`fin_crypto(coin/historical, symbol="bitcoin", start_date=60日前, end_date=今天)` vs `fin_index(000300.SH, 60)` 30 日滚动相关性:
+
+> ⚠️ coin/historical 使用 coin_id (非交易对)，需传 start_date/end_date
+
+- \> 0.6 = 高联动 (风险共振); < 0.3 = 脱钩 (独立行情)
+- 脱钩+BTC涨 = 加密独立叙事; 脱钩+BTC跌 = 加密特有风险
+
+## 配置模板
+
+| 模板   | 股票             | 债券              | 商品           | 黄金     | 加密      | 现金 | 适用人群    |
+| ------ | ---------------- | ----------------- | -------------- | -------- | --------- | ---- | ----------- |
+| 保守型 | 20% (300)        | 70% (treasury_cn) | —              | —        | —         | 10%  | 退休/低风险 |
+| 均衡型 | 50% (300+500)    | 30% (treasury_cn) | 10% (AU+CU+SC) | —        | —         | 10%  | 标准配置    |
+| 激进型 | 60% (创业板+500) | —                 | 15% (SC+CU)    | —        | 15% (BTC) | 10%  | 高风险偏好  |
+| 全天候 | 30% (300)        | 40% (10Y+)        | 15% (CU+SC)    | 15% (AU) | —         | —    | 桥水风格    |
+
+规则: 象限判定 + 置信度选基础模板，信号强度微调 +/-5%; 低置信度时现金提升至 30%。
+
+## 输出规范
+
+- 标注当前象限及置信度 (高/中/低)
+- 配置权重合计 100%，异常相关性 (偏离 > 1σ) 高亮标注
+- 注明数据截止日期与观察窗口 (30D/90D/250D)

package/skills/crypto/skill.md

@@ -0,0 +1,269 @@
+---
+name: fin-crypto
+description: "Crypto asset analysis — CEX market data (ticker/orderbook/funding rate), DeFi protocols (TVL/fees/yields/stablecoins via DefiLlama), market metrics (CoinGecko). 21 DataHub endpoints via fin_crypto. Use when: user asks about crypto prices, DeFi protocols, funding rates, stablecoin flows, token valuation, DEX volumes, or ecosystem health. NOT for: traditional stocks (use fin-a-share/fin-us-equity/fin-hk-stock), macro rates (use fin-macro), derivatives (use fin-derivatives)."
+metadata: { "openclaw": { "emoji": "🪙", "requires": { "extensions": ["findoo-datahub-plugin"] } } }
+---
+
+# Crypto Asset Analysis
+
+CEX 行情 + CoinGecko 市场数据 + DefiLlama DeFi 数据，统一通过 `fin_crypto` 访问。
+
+> **数据边界:** DataHub 提供 CoinGecko + DefiLlama + CCXT 数据。链上原始数据（活跃地址、Gas、MVRV、NUPL、巨鲸追踪、交易所余额）不在覆盖范围，需 Glassnode / Nansen / Dune 等第三方服务。
+>
+> 详细分析框架、估值模型、风险矩阵见下方 Analysis Patterns 和 Advanced Patterns 段落。
+
+## Tools
+
+### fin_crypto — 21 endpoints
+
+| Parameter | Type   | Required | Format                         | Default | Example     |
+| --------- | ------ | -------- | ------------------------------ | ------- | ----------- |
+| endpoint  | string | Yes      | see tables below               | —       | coin/market |
+| symbol    | string | Depends  | pair / coin ID / protocol slug | —       | BTC/USDT    |
+| limit     | number | No       | 1-250                          | 100     | 20          |
+
+### fin_data_ohlcv — K 线
+
+| Parameter | Type   | Required | Default | Example  |
+| --------- | ------ | -------- | ------- | -------- |
+| symbol    | string | Yes      | —       | BTC/USDT |
+| market    | string | No       | crypto  | crypto   |
+| timeframe | string | No       | 1h      | 4h       |
+| limit     | number | No       | 200     | 100      |
+
+### fin_data_regime — 市场体制
+
+Returns: bull / bear / sideways / volatile / crisis
+
+### fin_ta — 技术指标
+
+Indicators: sma, ema, rsi, macd, bbands
+
+## Endpoint Reference
+
+### CEX Market Data (5)
+
+| endpoint              | Description            | Example                                                              |
+| --------------------- | ---------------------- | -------------------------------------------------------------------- |
+| `market/ticker`       | Single ticker snapshot | `fin_crypto(endpoint="market/ticker", symbol="BTC/USDT")`            |
+| `market/tickers`      | All tickers            | `fin_crypto(endpoint="market/tickers")`                              |
+| `market/orderbook`    | Order book depth       | `fin_crypto(endpoint="market/orderbook", symbol="BTC/USDT")`         |
+| `market/trades`       | Recent trades          | `fin_crypto(endpoint="market/trades", symbol="BTC/USDT")`            |
+| `market/funding_rate` | Perpetual funding rate | `fin_crypto(endpoint="market/funding_rate", symbol="BTC/USDT:USDT")` |
+
+### CoinGecko Market Intelligence (6)
+
+| endpoint            | Description            | Example                                                                                                    |
+| ------------------- | ---------------------- | ---------------------------------------------------------------------------------------------------------- |
+| `coin/market`       | Market cap ranking     | `fin_crypto(endpoint="coin/market", limit=20)`                                                             |
+| `coin/historical`   | Coin historical data   | `fin_crypto(endpoint="coin/historical", symbol="bitcoin", start_date="2025-01-01", end_date="2026-03-07")` |
+| `coin/info`         | Coin detail info       | `fin_crypto(endpoint="coin/info", symbol="ethereum")`                                                      |
+| `coin/categories`   | Category rankings      | `fin_crypto(endpoint="coin/categories")`                                                                   |
+| `coin/trending`     | Trending / hot coins   | `fin_crypto(endpoint="coin/trending")`                                                                     |
+| `coin/global_stats` | Global market overview | `fin_crypto(endpoint="coin/global_stats")`                                                                 |
+
+### DeFi Protocol Data — DefiLlama (10)
+
+| endpoint              | Description                 | Example                                                                                                             |
+| --------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------- |
+| `defi/protocols`      | Protocol TVL ranking        | `fin_crypto(endpoint="defi/protocols", limit=20)`                                                                   |
+| `defi/tvl_historical` | Full TVL history            | `fin_crypto(endpoint="defi/tvl_historical")`                                                                        |
+| `defi/protocol_tvl`   | Single protocol TVL history | `fin_crypto(endpoint="defi/protocol_tvl", symbol="aave")` ⚠️ API 需 `protocol` 参数，但 buildParams 映射为 `symbol` |
+| `defi/chains`         | Blockchain TVL comparison   | `fin_crypto(endpoint="defi/chains")`                                                                                |
+| `defi/bridges`        | Cross-chain bridge volumes  | `fin_crypto(endpoint="defi/bridges")`                                                                               |
+| `defi/yields`         | Yield farming opportunities | `fin_crypto(endpoint="defi/yields")`                                                                                |
+| `defi/stablecoins`    | Stablecoin market data      | `fin_crypto(endpoint="defi/stablecoins")`                                                                           |
+| `defi/fees`           | Protocol fees/revenue       | `fin_crypto(endpoint="defi/fees")`                                                                                  |
+| `defi/dex_volumes`    | DEX trading volumes         | `fin_crypto(endpoint="defi/dex_volumes")`                                                                           |
+| `defi/coin_prices`    | DeFi token prices           | `fin_crypto(endpoint="defi/coin_prices", symbol="ethereum")` ⚠️ API 需 `coins` 参数，但 buildParams 映射为 `symbol` |
+
+## Analysis Patterns
+
+### Market Overview (全景)
+
+```
+1. fin_crypto(coin/global_stats)                    → 总市值、BTC dom、24h vol
+2. fin_crypto(coin/market, limit=20)                → Top 20 表现
+3. fin_crypto(coin/trending)                        → 社区热度
+4. fin_crypto(market/funding_rate, symbol="BTC/USDT") → 衍生品情绪
+5. fin_crypto(defi/stablecoins)                     → 场外资金
+6. fin_crypto(defi/protocols) + fin_crypto(defi/chains) → DeFi/链生态格局
+→ 综合判定: 看多/中性/看空 + 置信度
+```
+
+### DeFi Protocol Analysis (深度 + 估值)
+
+```
+1. fin_crypto(defi/protocol_tvl, symbol="X") → TVL 趋势 + FDV
+2. fin_crypto(defi/fees)                     → 年化收入; fees/TVL ratio
+3. fin_crypto(defi/yields)                   → 当前 yield vs 历史中位
+4. fin_crypto(defi/stablecoins)              → 稳定币流入趋势
+→ 估值: P/F = FDV / annualized_revenue; P/TVL = mcap / TVL
+→ 同赛道横向对比: 同类 protocol P/F + P/TVL 排名, TVL 趋势, fees 增长率
+```
+
+## Advanced Patterns
+
+### BTC Dominance Cycle — Altseason 择时
+
+```
+1. fin_crypto(coin/global_stats)                     → btc_dominance % (当前快照)
+2. 对比历史: 定期记录 global_stats 快照，计算 7d/30d dom 变化
+   ⚠️ coin/historical 不返回 dominance 历史数据，只能通过多次 global_stats 快照对比
+3. fin_crypto(coin/market, limit=20)                 → BTC 价格 + 涨跌幅辅助判断
+→ dom↑ + BTC↑ = BTC season (减配山寨)
+→ dom↓ + BTC↑ = Altseason (轮动 ETH→大盘→中小盘)
+→ dom↓ + BTC↓ = 恐慌出逃 | dom↑ + BTC↓ = 山寨失血
+→ 阈值: dom 7d 变化 > ±0.5% 视为趋势信号
+```
+
+### DeFi 赛道轮动 + Category Rotation
+
+```
+1. fin_crypto(coin/categories)          → 赛道 7d% 排名 (本周 vs 上周 Top 5)
+2. fin_crypto(defi/protocols, limit=50) → 各协议 category + TVL 变化
+3. fin_crypto(defi/fees)                → fees 增长验证真实需求
+→ 轮动节奏: DEX → Lending → Derivatives → RWA → AI
+→ 赛道 7d TVL >15% + fees 同步增长 = 真实需求; TVL↑ fees 不增 = 激励驱动
+→ 持续 2 周 Top 5 = 持续性热点 (非 FOMO)
+```
+
+### 稳定币先行指标 + Cross-chain 资金流
+
+```
+1. fin_crypto(defi/stablecoins)         → USDT+USDC+DAI 总 mcap 4w 滚动变化
+2. fin_crypto(defi/bridges)             → 跨链桥 net flow
+3. fin_crypto(defi/chains)              → 目标链 TVL 验证
+→ 稳定币 4w +$2B = 强流入 (领先 2-4w); 4w <$0 = 流出防御
+→ Bridge net inflow >$50M/week = 生态加速; 2 周净流出 >5% TVL = 降温
+```
+
+### L2 生态对比
+
+```
+fin_crypto(defi/chains) + fin_crypto(defi/bridges) + fin_crypto(defi/dex_volumes)
+→ 对比 Arbitrum/Optimism/Base/zkSync: TVL 绝对值 + 增速 + 桥净流入 + DEX 量
+```
+
+### Token 经济学 + Meme Coin 风险
+
+```
+Token 经济学 (coin/info):
+  FDV/MC >5x = 高稀释风险 | 2~5x = 中等 | <2x = 低稀释
+  流通率 = circulating / max_supply
+
+Meme 风险评分 (coin/info + coin/market + market/orderbook):
+  mcap <$10M → +30 | vol/mcap >200% → +20 | 上线 <30d → +20
+  spread >1% → +15 | 7d rank↑ >100 → +15
+→ >60 = 高风险; >80 = 极高风险
+```
+
+### CEX 流动性 + Yield Farming 评估
+
+```
+CEX 流动性 (market/orderbook + market/trades):
+  Spread <0.05% = 高流动性 | 0.05~0.3% = 中等 | >0.3% = 低流动性
+  单笔 >$100K 连续 = 大户活动 | 买盘/卖盘深度 >1.5 = 买方占优
+
+Yield Farming (defi/yields + defi/protocol_tvl + defi/fees):
+  APY >100% + TVL↓ = 死亡螺旋 | 20~50% + TVL 稳 + fees↑ = 可持续
+  5~20% + TVL↑ = 蓝筹 DeFi | <5% = 类债券配置
+```
+
+### Crypto-Macro 联动
+
+```
+fin_macro(treasury_us) + fin_crypto(coin/global_stats)
+→ 实际收益率↓ = risk-on 看多 | ↑ = risk-off 承压
+→ 10Y <1% 利好加密 | >2.5% 宏观逆风显著
+```
+
+## Signal Quick-Reference
+
+### Funding Rate + Open Interest 组合
+
+| Funding Rate | OI 趋势 | 信号          | 解读                            |
+| ------------ | ------- | ------------- | ------------------------------- |
+| > +0.10%     | OI↑     | Fragile top   | 多头极度拥挤，清算瀑布概率高    |
+| > +0.10%     | OI↓     | Cooling off   | 多头减仓，极端风险降低          |
+| +0.03~+0.10% | OI↑     | Healthy bull  | 趋势延续，仓位健康              |
+| +0.03~+0.10% | OI↓     | Profit-take   | 逐步止盈中                      |
+| -0.01~+0.03% | —       | Neutral       | 无方向信号                      |
+| -0.05~-0.01% | OI↑     | Squeeze load  | 空头加仓，轧空材料积累          |
+| < -0.05%     | OI↑     | Short squeeze | 极端空头 + 高 OI = 反弹概率极高 |
+| < -0.05%     | OI↓     | Capitulation  | 市场出清，等待企稳              |
+
+### Stablecoin Signals
+
+| Signal                   | Implication           | Lead Time | 细节                  |
+| ------------------------ | --------------------- | --------- | --------------------- |
+| USDT+USDC 4w 增量 > $2B  | Strong capital inflow | 2-4 weeks | 牛市弹药补充          |
+| USDT+USDC 4w 增量 < -$1B | Capital flight        | 2-4 weeks | 系统性风险升温        |
+| USDT OTC 溢价 > 0.5%     | Strong buy pressure   | 即时      | 场外急切入场          |
+| USDT OTC 折价 > 0.5%     | Panic selling         | 即时      | 场外恐慌抛售          |
+| DAI supply 周增 > 5%     | DeFi leverage surge   | 1-2 weeks | CDP 需求↑ = DeFi 活跃 |
+
+### Chain Ecosystem Health
+
+| Metric          | Source           | Healthy                | Warning             |
+| --------------- | ---------------- | ---------------------- | ------------------- |
+| TVL             | defi/chains      | > 5% MoM growth        | Negative MoM        |
+| Bridge net flow | defi/bridges     | Net inflow > $50M/week | Net outflow         |
+| DEX volume      | defi/dex_volumes | Sustained growth       | Consecutive decline |
+| Protocol count  | defi/protocols   | New protocols joining  | Protocols leaving   |
+| Fee revenue     | defi/fees        | MoM growth > 10%       | Revenue declining   |
+
+## Contract Risk Calculator (Pure Math — Zero Data Dependency)
+
+合约交易风险计算，纯数学公式，无需额外数据端点。
+
+### Liquidation Price
+
+```
+Long:  Liq = entry × (1 - 1/leverage × (1 - maintenance_margin_rate))
+Short: Liq = entry × (1 + 1/leverage × (1 - maintenance_margin_rate))
+```
+
+常见 maintenance_margin_rate: Binance 0.4%, OKX 0.5%, Bybit 0.5%。
+
+**示例:** BTC $60,000 做多 20x，维持保证金率 0.5%
+→ Liq = 60000 × (1 - 1/20 × (1 - 0.005)) = 60000 × 0.95025 = **$57,015**
+
+### Risk Dashboard (用户提供 entry + leverage + position size)
+
+| 指标     | 公式                                          | 阈值                  |
+| -------- | --------------------------------------------- | --------------------- |
+| 爆仓距离 | \|entry - liq\| / entry × 100%                | <3% = 极高风险        |
+| 最大亏损 | position_size / leverage × (1 + fee_rate × 2) | 即保证金 + 双向手续费 |
+| 保证金率 | margin / position_value × 100%                | <维持保证金率 = 强平  |
+| 盈亏平衡 | entry ± entry × fee_rate × 2 × leverage       | 需覆盖开平手续费      |
+
+### 仓位管理建议
+
+| 杠杆倍数 | 爆仓距离 | 适用场景 | 建议仓位占比 |
+| -------- | -------- | -------- | ------------ |
+| 2-3x     | 33-50%   | 趋势跟踪 | ≤30% 总资金  |
+| 5-10x    | 10-20%   | 波段交易 | ≤15% 总资金  |
+| 20-50x   | 2-5%     | 极短线   | ≤5% 总资金   |
+| >50x     | <2%      | 赌博     | ⚠️ 不建议    |
+
+**多仓位综合风险:** 当用户持有多个合约仓位时，计算总保证金占用 / 账户净值 = 账户风险度。>70% = 需减仓；>85% = 连环爆仓风险。
+
+### 与现有数据结合
+
+```
+1. fin_crypto(market/ticker, symbol="BTC/USDT")      → 当前价格 vs 用户入场价
+2. fin_crypto(market/funding_rate, symbol="BTC/USDT") → funding 正/负判断持仓成本方向
+3. fin_data_regime(symbol="BTC/USDT", market="crypto") → 市场体制决定杠杆上限建议
+→ Bull regime: 最高建议 10x | Volatile/Crisis: 最高 3x | Bear: 建议纯现货
+```
+
+## Data Notes
+
+- **CoinGecko**: ~30 req/min rate limit; coin ID uses slug (bitcoin, ethereum); `coin/historical` 和 `coin/info` 需传 coin_id (如 "bitcoin")，非交易对格式; `coin/historical` 需传 `start_date`/`end_date`（不支持 `limit`）
+- **DefiLlama**: No auth, ~10min refresh, high TVL data reliability
+- **CEX**: Via DataHub aggregation, 1-5min delay; OHLCV via CCXT lower latency
+- **Funding rate**: Settlement cycles vary by exchange (8h/4h), always note the period
+- **Bridge data**: Partial coverage for smaller bridges
+- **OI data**: Available via market/funding_rate response; cross-validate with volume trends
+- **Category data**: CoinGecko categories update daily; use 7d% for rotation signals