@openfinclaw/openfinclaw-strategy 2026.3.14 → 2026.3.26

package/src/{validate.ts → strategy/validate.ts}

@@ -1,11 +1,10 @@
 /**
  * Strategy package validation for Findoo Backtest Agent (FEP v2.0).
  * Validates fep.yaml structure, strategy script safety, and required fields.
- * @module openfinclaw/validate
  */
 import { readFile } from "node:fs/promises";
 import path from "node:path";
-import type { FepV2Style, FepV2Timeframe } from "./types.js";
+import type { FepV2Style, FepV2Timeframe } from "../types.js";
 
 /** FEP 版本常量 */
 const FEP_VERSION = "2.0";
@@ -223,7 +222,6 @@ function validateSymbol(symbol: string): { valid: boolean; market?: string } {
 
 /**
  * 提取 YAML 块内容
- * 提取指定块名下的所有内容（缩进的子行）
  */
 function extractYamlBlock(yamlContent: string, blockName: string): string {
   const lines = yamlContent.split("\n");
@@ -287,7 +285,6 @@ function validateFepYaml(
 ): { hasUniverse: boolean } {
   let hasUniverse = false;
 
-  // 检查 fep 版本
   const fepMatch = /^\s*fep\s*:\s*["']?([^"'\s]+)["']?/m.exec(fepStr);
   if (!fepMatch) {
     errors.push("fep.yaml 必须包含 'fep:' 版本声明（例如 fep: \"2.0\"）");
@@ -297,13 +294,11 @@ function validateFepYaml(
     );
   }
 
-  // ── identity 验证 ──
   if (!hasField(fepStr, "identity")) {
     errors.push("fep.yaml 必须包含 'identity:' 节");
   } else {
     const identityBlock = extractYamlBlock(fepStr, "identity");
 
-    // 必填字段检查
     const requiredIdentityFields = [
       { field: "id", message: "策略唯一标识" },
       { field: "name", message: "策略显示名称" },
@@ -324,7 +319,6 @@ function validateFepYaml(
       }
     }
 
-    // author.name 必填
     if (!hasField(identityBlock, "author")) {
       errors.push("fep.yaml identity 必须包含 'author' 节");
     } else {
@@ -334,7 +328,6 @@ function validateFepYaml(
       }
     }
 
-    // style 枚举验证
     const styleValue = getFieldValue(identityBlock, "style");
     if (styleValue) {
       const cleanedStyle = styleValue.replace(/["']/g, "");
@@ -343,7 +336,6 @@ function validateFepYaml(
       }
     }
 
-    // visibility 枚举验证
     const visibilityValue = getFieldValue(identityBlock, "visibility");
     if (visibilityValue) {
       const cleanedVisibility = visibilityValue.replace(/["']/g, "");
@@ -354,23 +346,20 @@ function validateFepYaml(
       }
     }
 
-    // license 枚举验证
     const licenseValue = getFieldValue(identityBlock, "license");
     if (licenseValue) {
       const cleanedLicense = licenseValue.replace(/["']/g, "");
       if (!VALID_LICENSES.includes(cleanedLicense)) {
-        warnings.push(`fep.yaml identitylicense 建议: ${VALID_LICENSES.join(", ")}`);
+        warnings.push(`fep.yaml identity.license 建议: ${VALID_LICENSES.join(", ")}`);
       }
     }
 
-    // tags 格式验证
     const tagsValue = getFieldValue(identityBlock, "tags");
     if (tagsValue && !tagsValue.startsWith("[")) {
       warnings.push("identity.tags 应使用行内数组格式，如: tags: [trend, btc, crypto]");
     }
   }
 
-  // ── technical 验证（可选，有默认值）──
   if (hasField(fepStr, "technical")) {
     const technicalBlock = extractYamlBlock(fepStr, "technical");
 
@@ -385,13 +374,11 @@ function validateFepYaml(
     }
   }
 
-  // ── backtest 验证（必填）──
   if (!hasField(fepStr, "backtest")) {
     errors.push("fep.yaml 必须包含 'backtest:' 节");
   } else {
     const backtestBlock = extractYamlBlock(fepStr, "backtest");
 
-    // symbol 必填
     if (!hasField(backtestBlock, "symbol")) {
       errors.push("fep.yaml backtest 必须包含 'symbol'（交易品种）");
     } else {
@@ -405,7 +392,6 @@ function validateFepYaml(
       }
     }
 
-    // defaultPeriod 必填
     if (!hasField(backtestBlock, "defaultPeriod")) {
       errors.push("fep.yaml backtest 必须包含 'defaultPeriod'");
     } else {
@@ -418,12 +404,10 @@ function validateFepYaml(
       }
     }
 
-    // initialCapital 必填
     if (!hasField(backtestBlock, "initialCapital")) {
       errors.push("fep.yaml backtest 必须包含 'initialCapital'（初始资金）");
     }
 
-    // timeframe 枚举验证（可选）
     const timeframeValue = getFieldValue(backtestBlock, "timeframe");
     if (timeframeValue) {
       const cleanedTimeframe = timeframeValue.replace(/["']/g, "");
@@ -432,7 +416,6 @@ function validateFepYaml(
       }
     }
 
-    // universe 检测
     if (hasField(backtestBlock, "universe")) {
       hasUniverse = true;
       const universeBlock = extractYamlBlock(backtestBlock, "universe");
@@ -441,7 +424,6 @@ function validateFepYaml(
       }
     }
 
-    // rebalance 验证（可选）
     if (hasField(backtestBlock, "rebalance")) {
       const rebalanceBlock = extractYamlBlock(backtestBlock, "rebalance");
       const freqValue = getFieldValue(rebalanceBlock, "frequency");
@@ -454,7 +436,6 @@ function validateFepYaml(
     }
   }
 
-  // ── risk 验证（可选）──
   if (hasField(fepStr, "risk")) {
     const riskBlock = extractYamlBlock(fepStr, "risk");
     const thresholdValue = getFieldValue(riskBlock, "maxDrawdownThreshold");
@@ -466,7 +447,6 @@ function validateFepYaml(
     }
   }
 
-  // ── paper 验证（可选）──
   if (hasField(fepStr, "paper")) {
     const paperBlock = extractYamlBlock(fepStr, "paper");
     const barIntervalValue = getFieldValue(paperBlock, "barIntervalSeconds");
@@ -492,7 +472,6 @@ function validateStrategyScript(
 ): void {
   const codeWithoutComments = removePythonComments(scriptStr);
 
-  // 检查策略函数
   const hasCompute =
     /\bdef\s+compute\s*\(\s*data\s*\)/.test(scriptStr) ||
     /\bdef\s+compute\s*\(\s*data\s*,\s*context\s*(?:=\s*None)?\s*\)/.test(scriptStr);
@@ -502,22 +481,18 @@ function validateStrategyScript(
     errors.push("scripts/strategy.py 必须定义 compute(data) 或 select(universe) 函数");
   }
 
-  // 如果有 universe 配置，推荐使用 select
   if (hasUniverse && !hasSelect) {
     warnings.push("backtest 配置了 universe，建议使用 select(universe) 函数实现多标的策略");
   }
 
-  // 如果没有 universe 但使用 select，给出警告
   if (!hasUniverse && hasSelect && !hasCompute) {
     warnings.push("使用 select(universe) 函数时，建议在 backtest 中配置 universe");
   }
 
-  // 检查返回值结构（简单检查）
   if (hasCompute && !/\baction\b/.test(scriptStr)) {
     warnings.push("compute(data) 返回值应包含 action 字段（buy/sell/hold/target）");
   }
 
-  // 检查禁止的 import
   for (const pattern of FORBIDDEN_IMPORT_PATTERNS) {
     if (pattern.test(scriptStr)) {
       const match = pattern.exec(scriptStr);
@@ -526,7 +501,6 @@ function validateStrategyScript(
     }
   }
 
-  // 检查禁止的函数调用（忽略注释）
   for (const pattern of FORBIDDEN_CALL_PATTERNS) {
     if (pattern.test(codeWithoutComments)) {
       const match = pattern.exec(codeWithoutComments);
@@ -535,7 +509,6 @@ function validateStrategyScript(
     }
   }
 
-  // 检查破坏回测一致性的模式（忽略注释）
   for (const pattern of BACKTEST_BREAKING_PATTERNS) {
     if (pattern.test(codeWithoutComments)) {
       const match = pattern.exec(codeWithoutComments);
@@ -549,8 +522,6 @@ function validateStrategyScript(
 
 /**
  * 验证策略包目录（FEP v2.0）
- * @param dirPath 策略包目录路径
- * @returns 验证结果
  */
 export async function validateStrategyPackage(dirPath: string): Promise<ValidateResult> {
   const errors: string[] = [];
@@ -561,7 +532,6 @@ export async function validateStrategyPackage(dirPath: string): Promise<Validate
   const scriptDir = path.join(normalizedDir, "scripts");
   const strategyPath = path.join(scriptDir, "strategy.py");
 
-  // ── 检查必需文件 ──
   let fepContent: string;
   try {
     const raw = await readFile(fepPath, "utf-8");
@@ -580,10 +550,8 @@ export async function validateStrategyPackage(dirPath: string): Promise<Validate
     return { valid: false, errors };
   }
 
-  // ── 验证 fep.yaml ──
   const { hasUniverse } = validateFepYaml(fepContent, errors, warnings);
 
-  // ── 验证 strategy.py ──
   validateStrategyScript(strategyContent, hasUniverse, errors, warnings);
 
   return {

package/skills/cross-asset-lite/SKILL.md

@@ -1,95 +0,0 @@
----
-name: fin-cross-asset-lite
-description: "Cross-asset price comparison and trend analysis — compare crypto, stocks, indices side by side. Use when user asks to compare multiple assets, wants to know which performed better, or asks about relative strength between markets. Works with price/kline data only (no fundamentals)."
-metadata:
-  { "openclaw": { "emoji": "⚖️", "requires": { "extensions": ["openfinclaw"] } } }
----
-
-# Cross-Asset Lite — 多资产价格对比
-
-用价格数据做跨市场对比 — BTC vs 黄金、茅台 vs 腾讯、加密 vs A 股。
-
-## Tools
-
-### fin_compare — 并排对比（核心）
-
-| Parameter | Type   | Required | Example                     |
-| --------- | ------ | -------- | --------------------------- |
-| symbols   | string | Yes      | BTC/USDT,ETH/USDT,600519.SH |
-
-返回每个资产的最新价格 + 周涨跌幅。最多 5 个资产。
-
-### fin_kline — K 线趋势
-
-| Parameter | Type   | Required | Default | Example  |
-| --------- | ------ | -------- | ------- | -------- |
-| symbol    | string | Yes      | —       | BTC/USDT |
-| market    | string | No       | auto    | crypto   |
-| limit     | number | No       | 30      | 7        |
-
-### fin_price — 单资产查价
-
-| Parameter | Type   | Required | Example  |
-| --------- | ------ | -------- | -------- |
-| symbol    | string | Yes      | BTC/USDT |
-| market    | string | No       | auto     |
-
-## Analysis Framework
-
-### Step 1: 数据获取
-
-```
-fin_compare(symbols="资产A,资产B,资产C")
-```
-
-### Step 2: 趋势对比
-
-对每个资产分别获取 K 线，计算：
-
-- 周涨跌幅（已在 fin_compare 返回）
-- 月涨跌幅（fin_kline limit=30，取首尾价格计算）
-- 波动率（K 线日收益率标准差 × √252）
-
-### Step 3: 相对强弱判断
-
-| 场景         | 判断逻辑                        |
-| ------------ | ------------------------------- |
-| A涨B跌       | A 相对强势，资金可能从 B 流向 A |
-| 同涨 A > B   | A 弹性更大，risk-on 环境        |
-| 同跌 A < B   | A 防御性更强                    |
-| 两者相关性高 | 可能受同一宏观因子驱动          |
-
-### Step 4: 输出模板
-
-```markdown
-## 资产对比（截至 YYYY-MM-DD）
-
-| 资产 | 最新价 | 周涨跌 | 月涨跌 | 判断 |
-| ---- | ------ | ------ | ------ | ---- |
-| BTC  | $XX    | +X.X%  | +X.X%  | 强势 |
-| ETH  | $XX    | +X.X%  | +X.X%  | 跟涨 |
-| 茅台 | ¥XX    | -X.X%  | -X.X%  | 弱势 |
-
-**结论**: [一句话总结相对强弱和可能原因]
-```
-
-## Common Comparison Pairs
-
-| 场景         | Symbols                             |
-| ------------ | ----------------------------------- |
-| 加密双雄     | BTC/USDT,ETH/USDT                   |
-| 加密 vs 传统 | BTC/USDT,600519.SH,AAPL             |
-| 白酒双雄     | 600519.SH,000858.SZ                 |
-| 中美科技     | 00700.HK,AAPL                       |
-| 加密生态     | BTC/USDT,ETH/USDT,SOL/USDT,BNB/USDT |
-
-## Examples
-
-**用户:** BTC 和 ETH 最近谁涨得多？
-**流程:** `fin_compare(symbols="BTC/USDT,ETH/USDT")` → 对比表格
-
-**用户:** 比较一下茅台和腾讯
-**流程:** `fin_compare(symbols="600519.SH,00700.HK")` → 价格+周涨跌
-
-**用户:** 加密和 A 股最近走势相反吗？
-**流程:** `fin_compare(symbols="BTC/USDT,000300.SH")` + `fin_kline` 各取 30 天 → 趋势对比分析

package/skills/crypto-altseason/SKILL.md

@@ -1,122 +0,0 @@
----
-name: fin-crypto-altseason
-description: "Crypto altseason timing — BTC dominance trend, Altseason Index (Top 50 vs BTC), ETH/BTC ratio, category rotation radar, capital rotation ladder (BTC→ETH→large ALT→mid-cap→meme). Use when: user asks about altseason, BTC dominance direction, ETH/BTC ratio, altcoin rotation, or 'should I switch from BTC to alts'. NOT for: BTC cycle analysis (use fin-crypto-btc-cycle), single coin lookup (use fin-crypto), DeFi yields (use fin-crypto-defi-yield), funding rate arbitrage (use fin-crypto-funding-arb)."
-metadata:
-  { "openclaw": { "emoji": "🔄", "requires": { "extensions": ["openfinclaw"] } } }
----
-
-# Crypto Altseason Timing
-
-BTC dominance is the traffic light for altseason. This skill turns "feels like alts are pumping" into a quantifiable, actionable rotation timing system.
-
-## When to Use
-
-- "现在是山寨季吗" / "Is it altseason?"
-- "BTC dominance 在下降意味着什么" / "BTC dominance is dropping, what does it mean?"
-- "ETH/BTC 汇率怎么看" / "How is ETH/BTC doing?"
-- "该从 BTC 换到山寨了吗" / "Should I rotate from BTC to alts?"
-- "哪个赛道最近涨得好" / "Which crypto sector is pumping?"
-
-## Tools & Parameters
-
-### fin_crypto — Core data
-
-| Parameter | Type   | Required | Format              | Default | Example           |
-| --------- | ------ | -------- | ------------------- | ------- | ----------------- |
-| endpoint  | string | Yes      | see endpoints below | —       | coin/global_stats |
-| symbol    | string | Depends  | pair / coin ID      | —       | ETH/BTC           |
-| limit     | number | No       | 1-250               | 100     | 50                |
-
-#### Key Endpoints
-
-| endpoint              | Description                  | Example                                                              |
-| --------------------- | ---------------------------- | -------------------------------------------------------------------- |
-| `coin/global_stats`   | BTC dominance (current snap) | `fin_crypto(endpoint="coin/global_stats")`                           |
-| `coin/market`         | Top N coins by market cap    | `fin_crypto(endpoint="coin/market", limit=50)`                       |
-| `coin/categories`     | Category/sector 7d% rankings | `fin_crypto(endpoint="coin/categories")`                             |
-| `coin/trending`       | Trending / hot coins         | `fin_crypto(endpoint="coin/trending")`                               |
-| `market/funding_rate` | Funding rate (sentiment)     | `fin_crypto(endpoint="market/funding_rate", symbol="ETH/USDT:USDT")` |
-
-## Altseason Analysis Pattern
-
-### 1. BTC Dominance Assessment
-
-1. **BTC Dominance snapshot** `fin_crypto(endpoint="coin/global_stats")` — Get current btc_dominance %
-   - 💡 BTC dominance is the single most important altseason indicator
-
-2. **BTC + market context** `fin_crypto(endpoint="coin/market", limit=50)` — Top 50 coin performance
-   - Calculate: how many of Top 50 (excluding stablecoins) outperformed BTC over 7d/30d
-
-### 2. Altseason Index (Self-Calculated)
-
-```
-Count coins in Top 50 (excluding stablecoins + wrapped tokens) that outperformed BTC in 7d return.
-Altseason Index = outperformers / eligible_count × 100
-
-Interpretation:
-  > 75% = Altseason confirmed (strong rotation out of BTC)
-  50-75% = Transitional (rotation beginning)
-  25-50% = Neutral (mixed signals)
-  < 25% = Bitcoin Season (BTC dominates, alts lag)
-```
-
-### 3. Rotation Ladder Detection
-
-```
-BTC → ETH → Large ALT → Mid-cap ALT → Meme → TOP signal
-
-Step 1: fin_kline(symbol="ETH/BTC", market="crypto", limit=30) → ETH/BTC trend
-Step 2: fin_crypto(coin/market, limit=50) → stratify by market cap tiers:
-  - Tier 1 (>$50B): BTC, ETH
-  - Tier 2 ($10-50B): SOL, BNB, XRP, ADA, AVAX, DOT
-  - Tier 3 ($1-10B): mid-cap alts
-  - Tier 4 (<$1B): small-cap / meme
-```
-
-### 4. Altseason Health Check (Composite)
-
-```
-Combine signals into a composite score (0-5):
-
-1. BTC dom trending down (7d) .............. +1
-2. Altseason Index > 50% ................... +1
-3. ETH/BTC in uptrend (above 20d SMA) ...... +1
-4. Top category 7d% > +15% ................. +1
-5. Meme category NOT leading ............... +1
-
-Score interpretation:
-  5/5 = Strong healthy altseason (rotate aggressively)
-  3-4 = Altseason developing (start positioning)
-  1-2 = Early / mixed signals (selective, stick to large caps)
-  0   = Bitcoin Season (stay in BTC or sidelines)
-```
-
-## Signal Quick-Reference
-
-### BTC Dominance + BTC Price Matrix
-
-| BTC Dominance | BTC Price | Signal          | Action                                |
-| ------------- | --------- | --------------- | ------------------------------------- |
-| dom ↓         | BTC ↑     | Altseason onset | Rotate BTC → ETH → ALT progressively  |
-| dom ↓         | BTC ↓     | Panic exit      | Risk-off, move to stablecoins         |
-| dom ↑         | BTC ↑     | Bitcoin Season  | Concentrate in BTC, trim alts         |
-| dom ↑         | BTC ↓     | ALT hemorrhage  | Worst scenario for alts, full defense |
-
-Threshold: dom 7d change > ±0.5% = trend signal; > ±2% = strong signal.
-
-## Response Guidelines
-
-### Number Formats
-
-- BTC dominance: 54.3% (1 decimal)
-- Altseason Index: 68% (integer)
-- ETH/BTC ratio: 0.0542 (4 decimals)
-- Category 7d%: +28.5% / -3.2% (always with +/- sign, 1 decimal)
-
-### Must Include
-
-- Data timestamp ("Data as of YYYY-MM-DD")
-- Current BTC dominance with directional context
-- Altseason Index score with interpretation
-- Rotation ladder current phase
-- At least one ⚠️ risk signal assessment

package/skills/crypto-funding-arb/SKILL.md

@@ -1,88 +0,0 @@
----
-name: fin-crypto-funding-arb
-description: "Crypto funding rate arbitrage — perpetual funding rates, delta-neutral yield, cross-exchange rate spread, annualized return calculator. Use when: user asks about funding rate, delta-neutral strategy, basis trading, perpetual vs spot arb, or CeFi yield. NOT for: DeFi yields (use fin-crypto-defi-yield), spot trading (use fin-crypto), macro rates (use fin-macro)."
-metadata:
-  { "openclaw": { "emoji": "🔄", "requires": { "extensions": ["openfinclaw"] } } }
----
-
-# Crypto Funding Rate Arbitrage
-
-永续合约资金费率套利分析 — Delta 中性策略的收益计算、风险监控与跨交易所利差发现。
-
-> **核心逻辑:** 永续合约每 8h 结算 funding rate。当 funding > 0 时，做多付费给做空方。Delta 中性策略 = 现货买入 + 永续做空，锁定 funding 收益，无方向性风险。
-
-## When to Use
-
-- "BTC 资金费率多少" / "BTC funding rate"
-- "哪些币 funding rate 最高" / "top funding rate coins"
-- "funding 套利能赚多少" / "funding arb yield"
-- "现在做 delta 中性策略合适吗" / "delta neutral strategy"
-- "Binance 和 OKX funding 差多少" / "cross-exchange funding spread"
-
-## Tools & Parameters
-
-### fin_crypto — Funding & Market Data
-
-| Parameter | Type   | Required | Format              | Default | Example             |
-| --------- | ------ | -------- | ------------------- | ------- | ------------------- |
-| endpoint  | string | Yes      | see endpoints below | —       | market/funding_rate |
-| symbol    | string | Depends  | pair format         | —       | BTC/USDT:USDT       |
-| limit     | number | No       | 1-250               | 100     | 20                  |
-
-#### Endpoints
-
-| endpoint              | Description                 | Example                                                              |
-| --------------------- | --------------------------- | -------------------------------------------------------------------- |
-| `market/funding_rate` | Perpetual funding rate + OI | `fin_crypto(endpoint="market/funding_rate", symbol="BTC/USDT:USDT")` |
-| `market/ticker`       | Spot price snapshot         | `fin_crypto(endpoint="market/ticker", symbol="BTC/USDT")`            |
-| `market/tickers`      | All tickers (scan)          | `fin_crypto(endpoint="market/tickers")`                              |
-| `market/orderbook`    | Order book depth            | `fin_crypto(endpoint="market/orderbook", symbol="BTC/USDT")`         |
-
-## Funding Rate Arbitrage Analysis Pattern
-
-1. **Funding Rate Scan** `fin_crypto(market/funding_rate, symbol="BTC/USDT:USDT")` — 获取目标币种当前 funding rate + OI
-   - ⚠️ 如果 funding > +0.10%/8h → 多头极度拥挤，套利收益高但清算瀑布风险也高
-   - ⚠️ 如果 funding < -0.05%/8h → 空头拥挤，反向套利（现货做空 + 永续做多）但执行难度大
-
-2. **Spot Price Baseline** `fin_crypto(market/ticker, symbol="BTC/USDT")` — 现货价格基准
-   - 💡 计算 basis = (永续价 - 现货价) / 现货价 × 100%。正 basis + 正 funding = 做空端有利
-
-3. **Annualized Return Calculation** — 核心输出
-   ```
-   8h rate → Daily = rate × 3
-   Annual = rate × 3 × 365
-   Net annual = annual - (maker_fee × 2 × 365) - slippage_estimate
-   ```
-
-4. **Liquidity Assessment** `fin_crypto(market/orderbook, symbol="BTC/USDT")` — 执行成本评估
-   - ⚠️ 如果 spread > 0.1% → 大仓位进出滑点显著，套利净收益打折
-   - ⚠️ 如果 orderbook depth < $500K within 0.1% → 流动性不足，不适合大额套利
-
-## Signal Quick-Reference
-
-### Funding Rate Signals
-
-| Funding Rate (8h) | Annualized | Signal        | Action                                     |
-| ----------------- | ---------- | ------------- | ------------------------------------------ |
-| > +0.15%          | > 55%      | Extreme long  | High yield but squeeze risk; size down     |
-| +0.05% ~ +0.15%   | 18-55%     | Sweet spot    | Best risk-adjusted arb window              |
-| +0.01% ~ +0.05%   | 4-18%      | Marginal      | Only worth it for large capital + low fees |
-| -0.01% ~ +0.01%   | < 4%       | Neutral       | Not actionable                             |
-| < -0.05%          | —          | Short squeeze | Consider reverse arb (risky)               |
-
-## Response Guidelines
-
-### Number Formatting
-
-- Funding rate: 4 decimal places per period (+0.0800%/8h)
-- Annualized yield: 1 decimal place (35.0% annualized)
-- BTC price: to integer ($67,432)
-- OI / Volume: $B/$M notation ($4.2B OI)
-- Basis: 2 decimal places (+0.12%)
-
-### Must Include
-
-- Funding rate period (8h/4h/1h) — never show rate without period
-- Net yield after fees (maker fee typically 0.02%, taker 0.05%)
-- Risk tier classification (low/medium/high/extreme)
-- Data timestamp ("funding rate as of 2026-03-07 08:00 UTC")

package/skills/crypto-stablecoin-flow/SKILL.md

@@ -1,103 +0,0 @@
----
-name: fin-crypto-stablecoin-flow
-description: "Stablecoin capital flow analysis — USDT/USDC/DAI market cap trends, 4-week rolling inflow as leading indicator, chain distribution (ETH/Tron/BSC), stablecoin-to-total-market ratio. Use when: user asks about stablecoin supply, capital inflow/outflow, OTC demand, USDT vs USDC comparison, or whether money is entering crypto. NOT for: individual coin analysis (use fin-crypto), DeFi yield farming (use fin-crypto), macro rates (use fin-macro)."
-metadata:
-  { "openclaw": { "emoji": "💵", "requires": { "extensions": ["openfinclaw"] } } }
----
-
-# Stablecoin Capital Flow Analysis
-
-Stablecoins = crypto market's M2 money supply. Track stablecoin flows as a **2-4 week leading indicator** for BTC and altcoin price direction.
-
-> **Core thesis:** Capital enters crypto in three steps: fiat -> stablecoin -> BTC/altcoin. Stablecoin supply changes signal capital intent before price moves.
-
-## When to Use
-
-- "USDT 市值在增长吗" / "Is USDT market cap growing"
-- "稳定币总量是多少" / "Total stablecoin supply"
-- "场外资金在进场吗" / "Is money flowing into crypto"
-- "USDT 和 USDC 有什么区别" / "USDT vs USDC comparison"
-- "稳定币在哪条链上最多" / "Which chain has the most stablecoins"
-- "现在是入场好时机吗" / "Is this a good time to enter crypto"
-
-## When NOT to Use
-
-- Individual coin price/analysis (BTC/ETH/SOL) -> use `/fin-crypto`
-- DeFi protocol TVL/yields -> use `/fin-crypto`
-- CEX trading (orderbook/funding rate) -> use `/fin-crypto`
-- Macro interest rates/treasury yields -> use `/fin-macro`
-- A-share/US equity -> use `/fin-a-share` or `/fin-us-equity`
-
-## Tools & Parameters
-
-### fin_crypto
-
-| Parameter | Type   | Required | Format              | Default | Example          |
-| --------- | ------ | -------- | ------------------- | ------- | ---------------- |
-| endpoint  | string | Yes      | see endpoints below | —       | defi/stablecoins |
-| symbol    | string | Depends  | coin ID / pair      | —       | bitcoin          |
-| limit     | number | No       | 1-250               | 100     | 20               |
-
-#### Key Endpoints
-
-| endpoint            | Description                                      | Example                                        |
-| ------------------- | ------------------------------------------------ | ---------------------------------------------- |
-| `defi/stablecoins`  | All stablecoins: market cap + chain distribution | `fin_crypto(endpoint="defi/stablecoins")`      |
-| `coin/global_stats` | Total crypto market cap (for ratio calc)         | `fin_crypto(endpoint="coin/global_stats")`     |
-| `coin/market`       | Top coins by market cap (BTC price ref)          | `fin_crypto(endpoint="coin/market", limit=10)` |
-| `defi/chains`       | Per-chain TVL (cross-validate fund flow)         | `fin_crypto(endpoint="defi/chains")`           |
-| `defi/bridges`      | Cross-chain bridge volumes (migration)           | `fin_crypto(endpoint="defi/bridges")`          |
-
-## Stablecoin Flow Analysis Pattern
-
-1. **Stablecoin Supply Snapshot** `fin_crypto(endpoint="defi/stablecoins")` — Total supply + per-coin breakdown
-   - Key fields: total mcap, USDT mcap, USDC mcap, DAI mcap, chain distribution per coin
-   - ⚠️ If total stablecoin mcap < previous known value -> capital outflow signal, check severity
-   - 💡 USDT growth = primarily Asian retail/OTC inflow; USDC growth = institutional/DeFi allocation
-
-2. **Total Market Context** `fin_crypto(endpoint="coin/global_stats")` — Crypto total market cap + BTC dominance
-   - Calculate: stablecoin_ratio = total_stablecoin_mcap / total_crypto_mcap
-   - ⚠️ Ratio rising (e.g., 9% -> 12%) = capital retreating to sidelines (defensive)
-   - ⚠️ Ratio falling (e.g., 12% -> 9%) = capital deploying into risk assets (offensive)
-
-3. **Chain Distribution Analysis** `fin_crypto(endpoint="defi/stablecoins")` — Per-chain stablecoin breakdown
-   - Ethereum = institutional DeFi + lending protocols
-   - Tron = Asian OTC + cross-border remittance + retail
-   - BSC = retail DeFi + gaming
-   - Arbitrum/Base = L2 DeFi migration
-   - ⚠️ If Tron USDT growing fastest -> Asian retail surge (historically bullish for BTC in 2-4 weeks)
-
-4. **Capital Flow Verdict** — Synthesize all signals
-   - Strong inflow: 4w total increase > $2B + ratio declining + Tron USDT growing
-   - Neutral: 4w change < $1B absolute, ratio stable
-   - Outflow warning: 4w decrease > $1B + ratio rising + BTC price declining
-
-## Leading Indicator Framework
-
-### 4-Week Rolling Change Thresholds
-
-| 4-Week Change | Signal           | Historical BTC 30d Avg | Action                        |
-| ------------- | ---------------- | ---------------------- | ----------------------------- |
-| > +$3B        | Strong inflow    | +15%                   | Bullish positioning warranted |
-| +$1B to +$3B  | Moderate inflow  | +8%                    | Cautiously optimistic         |
-| -$1B to +$1B  | Neutral          | +2%                    | No directional signal         |
-| -$3B to -$1B  | Moderate outflow | -5%                    | Reduce leverage, raise cash   |
-| < -$3B        | Capital flight   | -12%                   | Defensive mode, max caution   |
-
-## Response Guidelines
-
-### Number Formats
-
-- Stablecoin market cap: $168.2B (use $B for billions, $M for millions)
-- Supply changes: +$1.8B / -$500M (always show +/- sign)
-- Ratios: 9.8% (1 decimal place)
-- BTC price: to nearest dollar ($67,432)
-- Chain distribution: percentages with 1 decimal (Ethereum 45.2%, Tron 31.8%)
-
-### Must Include
-
-- Data timestamp ("Data as of YYYY-MM-DD")
-- Top 3 stablecoins by market cap with individual figures
-- Stablecoin/total crypto market cap ratio
-- Chain distribution for at least top 3 chains
-- Always end with a directional verdict: bullish / neutral / bearish with confidence level