加密货币行情周期报告

使用技术指标为加密货币永续合约生成行情周期报告。

快速开始

# 运行日度行情周期报告
python3 {baseDir}/scripts/regime_report.py

# 运行周度行情周期报告
python3 {baseDir}/scripts/regime_report.py --weekly

或直接提问：“BTC 当前行情周期是什么？” 或 “运行一份市场报告。”

注意： 该脚本将格式化报告输出至 stdout。代理（agent）负责后续投递（例如：发送至 Telegram、在聊天界面中展示）。

报告包含内容

价格与趋势：

• 当前价格 + 24 小时涨跌幅
• 行情周期分类（强势多头 / 空头、弱势多头 / 空头、震荡）
• ADX 值（趋势强度）
• 趋势方向（基于 Supertrend 判断为看涨 / 看跌）
• 价格距 Supertrend 线的距离（%）

成交量与流动性：

• 成交量 vs. 20 日均值（%）
• 🔇 = 成交量偏低，🔊 = 成交量偏高

永续合约数据：

• 资金费率 + 变动方向（↑↓→）
• 未平仓合约量（OI，单位：十亿美元）
• 🔥 = 资金费率偏高

市场背景：

• BTC 相关性（0.0 至 1.0）
• 🔗 = 高相关性（> 0.7）

配置指南

1. 配置您的观察列表（Watchlist）

选项 A：编辑默认配置文件

编辑 {baseDir}/references/config.json 以自定义资产列表：

{
  "watchlist": [
    {"symbol": "BTC", "name": "Bitcoin", "okx": "BTC-USDT-SWAP"},
    {"symbol": "ETH", "name": "Ethereum", "okx": "ETH-USDT-SWAP"}
  ],
  "indicators": {
    "supertrend": { "period": 10, "multiplier": 3 },
    "adx": { "period": 14, "strong_threshold": 25, "weak_threshold": 20 }
  }
}

选项 B：使用自定义配置文件

# 通过环境变量指定（路径必须为技能目录内的相对路径）
REGIME_CONFIG=references/my-config.json python3 {baseDir}/scripts/regime_report.py

安全提示： 出于安全考虑，配置文件路径仅限于技能目录内。不支持绝对路径及路径遍历（如 ../）。

示例配置文件位于 {baseDir}/references/config.example.json —— 可复制并按需修改。

配置字段说明：

• symbol — 简写交易代码（用于显示）
• name — 全称（用于显示）
• okx — OKX 永续合约交易对符号（须严格匹配 OKX 格式：ASSET-USDT-SWAP）

如何查找 OKX 合约符号： 访问 OKX 行情页面，或执行：

curl -s "https://www.okx.com/api/v5/public/instruments?instType=SWAP"
# 可选：通过 jq 过滤输出：| jq '.data[].instId'

2. 配置技术指标参数

在 config.json 中调整以下参数：

3. 设置定时报告（可选）

使用 OpenClaw 的 cron 系统自动接收报告。

通过 CLI 配置：

# 早间报告（美国太平洋时间上午 6 点）
openclaw cron add 
  --name "Morning Regime Report" 
  --schedule "0 6 * * *" 
  --timezone "America/Los_Angeles" 
  --message "Run the crypto regime morning report"

# 晚间报告（美国太平洋时间下午 3 点）
openclaw cron add 
  --name "Evening Regime Report" 
  --schedule "0 15 * * *" 
  --timezone "America/Los_Angeles" 
  --message "Run the crypto regime evening report"

# 周五周度汇总（美国太平洋时间下午 4 点）
openclaw cron add 
  --name "Friday Weekly Summary" 
  --schedule "0 16 * * 5" 
  --timezone "America/Los_Angeles" 
  --message "Run the crypto regime weekly report with --weekly flag"

通过配置文件配置（~/.openclaw/openclaw.json）：

{
  // ... 其他配置 ...
  "cron": {
    "jobs": [
      {
        "name": "Morning Regime Report",
        "schedule": { "kind": "cron", "expr": "0 6 * * *", "tz": "America/Los_Angeles" },
        "sessionTarget": "isolated",
        "payload": { "kind": "agentTurn", "message": "Run the crypto regime morning report" },
        "delivery": { "mode": "announce" }
      },
      {
        "name": "Evening Regime Report",
        "schedule": { "kind": "cron", "expr": "0 15 * * *", "tz": "America/Los_Angeles" },
        "sessionTarget": "isolated",
        "payload": { "kind": "agentTurn", "message": "Run the crypto regime evening report" },
        "delivery": { "mode": "announce" }
      },
      {
        "name": "Friday Weekly Summary",
        "schedule": { "kind": "cron", "expr": "0 16 * * 5", "tz": "America/Los_Angeles" },
        "sessionTarget": "isolated",
        "payload": { "kind": "agentTurn", "message": "Run the crypto regime weekly report with --weekly flag" },
        "delivery": { "mode": "announce" }
      }
    ]
  }
}

4. 测试报告

# 测试日度报告
python3 {baseDir}/scripts/regime_report.py

# 测试周度报告
python3 {baseDir}/scripts/regime_report.py --weekly

功能说明

1. 从 OKX 获取观察列表中各资产的 OHLCV 数据
2. 计算 Supertrend 指标，判断趋势方向
3. 计算 ADX 指标，衡量趋势强度
4. 获取当前资金费率与未平仓合约量（Open Interest）
5. 输出适用于 Telegram 投递的格式化报告

所用技术指标

Supertrend（周期=10，倍数=3）

• 周期： 10
• 倍数： 3
• 看涨信号： 价格位于 Supertrend 线上方
• 看跌信号： 价格位于 Supertrend 线下方

ADX（平均趋向指数）

• > 25： 强势趋势（多头或空头）
• 20–25： 弱势 / 中等强度趋势
• < 20： 无明确趋势 / 震荡行情

行情周期分类逻辑

数据来源

OKX API 接口地址：

• OHLCV：/api/v5/market/candles
• 资金费率：/api/v5/public/funding-rate
• 未平仓合约量：/api/v5/public/open-interest

资源目录说明

scripts/

• regime_report.py — 主脚本，负责拉取数据并生成报告

references/

• config.json — 默认观察列表配置文件（可直接编辑以定制）
• config.example.json — 示例配置文件，可供复制并修改