Crypto Sniper Oracle — 量化市场情报与报告系统

⚠️ 范围与能力说明

核心功能：获取公开市场数据并生成量化分析。

本技能支持的功能：

• ✅ 从 Binance API 获取公开行情（ticker）数据
• ✅ 从 Binance API 获取公开订单簿（order book）数据
• ✅ 计算订单簿失衡度（Order Book Imbalance, OBI）
• ✅ 计算加权平均价格（VWAP）偏离度
• ✅ 评估流动性质量（以基点 bps 表示的买卖价差）
• ✅ 生成格式化分析报告
• ✅ [可选] 通过 Telegram 发送报告
• ✅ [可选] 配置定时 cron 任务实现自动化报告

本技能不支持的功能：

• ❌ 下单或执行交易
• ❌ 转账资金
• ❌ 访问交易所私有数据
• ❌ 读取 agent 内存（仅限自身日志）
• ❌ 拦截或阻断其他技能的运行

🔧 配置选项

模式 1：仅分析（默认）

不启用 Telegram，手动调用：

# 仅获取数据并执行分析
python3 crypto_oracle.py --symbol BTCUSDT

适用场景：按需进行手动分析。

模式 2：Telegram 报告（可选）

启用 Telegram 提醒与报告：

必需的环境变量：

export TELEGRAM_BOT_TOKEN="your_bot_token_here"
export TELEGRAM_CHAT_ID="your_chat_id_here"

配置示例（JSON 格式）：

{
  "skills": {
    "crypto-sniper-oracle": {
      "enabled": true,
      "config": {
        "telegram_enabled": true
      }
    }
  }
}

适用场景：自动向 Telegram 发送报告。

模式 3：定时任务 + Telegram（全自动）

定时市场报告：

示例 cron 任务：

# 每日 UTC 时间 9 点发送报告
0 9 * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode daily

# 每小时执行异常检测
0 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode hourly

# 每 15 分钟检查价格异常
*/15 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode alerts

适用场景：完全自动化的市场监控。

📊 报告模板

1. 日度市场报告

触发方式：cron（每日 UTC 9 点）或手动命令

内容示例：

📊 CRYPTO MARKET DAILY REPORT
{date} | Powered by Wesley

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🎯 MARKET OVERVIEW (10 pairs analyzed)

🟢 BULLISH SETUPS (OBI > +0.15)
• BTCUSDT: OBI +0.18, Spread 2.1 bps
  Price vs VWAP: +0.5% (above average)
  Signal: Strong buying pressure

• ETHUSDT: OBI +0.12, Spread 3.5 bps
  Price vs VWAP: +0.3%
  Signal: Moderate bullish

🔴 BEARISH SETUPS (OBI < -0.15)
• SOLUSDT: OBI -0.16, Spread 8.2 bps
  Price vs VWAP: -0.8%
  Signal: Selling pressure

💰 LIQUIDITY QUALITY
Excellent (< 5 bps): 5 pairs
Good (5-10 bps): 3 pairs
Poor (> 30 bps): 2 pairs

📈 TOP MOVERS (24h)
+12.3% SOLUSDT (volatility: HIGH)
+8.1% ETHUSDT (volatility: MODERATE)
-5.2% BNBUSDT (volatility: MODERATE)

🎯 TRADING OPPORTUNITIES
→ BTC: Bullish setup confirmed (OBI +0.18)
→ ETH: Moderate strength, watch for breakout
→ SOL: Avoid - selling pressure + poor liquidity

━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Generated: 2026-02-27 09:00:00 UTC
Next report: 2026-02-28 09:00:00 UTC

2. 异常警报

触发条件：OBI 突增、价差激增或成交量暴增

内容示例：

🚨 MARKET ANOMALY DETECTED

Time: 15:23:45 UTC
Asset: BTCUSDT

📊 Anomaly Type: OBI SPIKE
• Previous OBI: +0.05
• Current OBI: +0.22
• Change: +340% in 15 minutes

💰 Liquidity: EXCELLENT (2.3 bps)
📈 Price vs VWAP: +0.6%

💡 Implication:
Strong buying pressure surge detected.
Potential upward price movement imminent.

🎯 Suggested Action:
Consider LONG entry if other signals align.
Monitor closely for next 30 minutes.

[View Full Analysis]

3. 小时级摘要

触发方式：cron（每小时一次）

内容示例：

⚡ HOURLY MARKET CHECK
{timestamp}

🔍 Scanned: 10 pairs
🟢 Bullish: 3
🔴 Bearish: 2
⚪ Neutral: 5

📊 Notable Changes:
• BTC OBI: +0.05 → +0.12 (↑)
• ETH Spread: 3.2 → 5.8 bps (↑)

⚠️ Alerts: None
Next check: {next_hour}

🔐 文件访问权限（扩展说明）

可读文件：

• /workspace/skills/crypto-sniper-oracle/crypto_oracle.py（数据获取器）
• /workspace/skills/crypto-sniper-oracle/reporter.py（报告生成器）
• /workspace/skills/crypto-sniper-oracle/templates/*.md（报告模板）

可写文件：

• /workspace/.oracle_cache.json（缓存有效期 45 秒）
• /workspace/MARKET_ANALYSIS.md（分析报告）
• /workspace/TRADING_LOGS.md（审计日志）
• /workspace/reports/daily_{date}.md（归档报告）
• /workspace/reports/alerts_{date}.log（警报历史）

🌐 网络访问权限（扩展说明）

始终允许：

• ✅ https://api.binance.com/api/v3/*（公开市场数据）

条件允许（仅当启用 Telegram 时）：

• ✅ https://api.telegram.org/bot{token}/*（仅用于发送消息）

永不允许：

• ❌ Binance 私有接口
• ❌ 下单相关接口
• ❌ 提现相关接口

📋 Cron 任务规范

日度报告

# 执行时间：UTC 每日 9 点
0 9 * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode daily --symbols BTCUSDT,ETHUSDT,SOLUSDT,BNBUSDT,ADAUSDT

# 执行流程：
1. 获取所有指定 symbol 的数据
2. 分别计算各 symbol 的 OBI、VWAP 和价差
3. 汇总生成日度报告
4. 若启用 Telegram，则发送报告
5. 归档至 /workspace/reports/daily_{date}.md

小时级检查

# 执行时间：每小时一次
0 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode hourly --symbols BTCUSDT,ETHUSDT

# 执行流程：
1. 快速扫描关键交易对
2. 与上一小时数据对比
3. 检测显著变化
4. 若发现异常则发出警报

价格警报

# 执行时间：每 15 分钟一次
*/15 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode alerts --symbols BTCUSDT

# 执行流程：
1. 检测 OBI 突增（变化幅度 >50%）
2. 检测价差激增（增幅 >100%）
3. 检测成交量暴增（超过均值 200%）
4. 若任一条件满足，立即通过 Telegram 发送警报

🛠️ 工作原理

第 1 层 — 数据采集（保持不变）

与 v3.2.1 版本一致，使用 crypto_oracle.py 获取数据。

第 2 层 — 报告生成（新增）

PROCEDURE Generate_Report(mode, symbols):

  1. FETCH DATA FOR ALL SYMBOLS
     For each symbol in symbols:
       data[symbol] = call_oracle(symbol)

  2. AGGREGATE METRICS
     Calculate:
     - How many bullish (OBI > 0.15)
     - How many bearish (OBI < -0.15)
     - Average spread across all symbols
     - Top movers by price change %

  3. LOAD TEMPLATE
     template = load_template(f"{mode}_report.md")

  4. POPULATE TEMPLATE
     report = template.format(
       date=now(),
       bullish_pairs=format_bullish(data),
       bearish_pairs=format_bearish(data),
       liquidity_summary=format_liquidity(data),
       top_movers=format_movers(data)
     )

  5. SAVE REPORT
     Write to /workspace/reports/{mode}_{date}.md

  6. IF TELEGRAM ENABLED:
       send_telegram_message(report)

  7. LOG EXECUTION
     Write to /workspace/TRADING_LOGS.md

第 3 层 — Telegram 投递（新增）

PROCEDURE Send_Telegram_Report(report):

  1. VALIDATE CREDENTIALS
     IF TELEGRAM_BOT_TOKEN not set:
       → Log error: "Telegram not configured"
       → ABORT
     
     IF TELEGRAM_CHAT_ID not set:
       → Log error: "Chat ID not configured"
       → ABORT

  2. FORMAT MESSAGE
     # Telegram 单条消息限制为 4096 字符
     IF len(report) > 4000:
       → Split into multiple messages
       → Send sequentially

  3. SEND VIA API
     POST https://api.telegram.org/bot{token}/sendMessage
     Body:
     {
       "chat_id": "{chat_id}",
       "text": "{report}",
       "parse_mode": "Markdown"
     }

  4. HANDLE RESPONSE
     IF success:
       → Log: "Report sent to Telegram"
     
     IF error:
       → Log error details
       → Retry once after 5s
       → If still fails: Save to /workspace/failed_reports/

🔒 安全性与隐私保护

数据采集：

• 仅采集公开市场数据
• Binance API 不需要身份认证
• 不收集任何个人数据

数据处理：

• 全部计算均在本地完成
• 缓存为临时存储（TTL 45 秒）
• 报告保存于本地

Telegram（可选）：

• 需用户显式启用
• 用户自行提供 bot token 与 chat ID
• 仅向用户自己的 Telegram 发送消息
• 不向任何第三方传输数据
• 随时可禁用

透明度保障：

• 所有 Telegram 发送操作均被记录
• 所有报告均被归档
• 完整审计轨迹记录于 TRADING_LOGS.md 中

📚 安装与配置

基础配置（不启用 Telegram）：

git clone https://github.com/georges91560/crypto-sniper-oracle.git
cd crypto-sniper-oracle

cp -r * /workspace/skills/crypto-sniper-oracle/
chmod +x /workspace/skills/crypto-sniper-oracle/*.py

Telegram 配置（可选）：

步骤 1：创建 Telegram Bot

1. 打开 Telegram，搜索 @BotFather
2. 发送指令：/newbot
3. 按提示操作，获取 BOT_TOKEN

步骤 2：获取 Chat ID

1. 向你的 Bot 发送任意消息
2. 访问：https://api.telegram.org/bot{YOUR_TOKEN}/getUpdates
3. 在返回结果中查找 "chat":{"id":123456789}

步骤 3：配置环境变量

export TELEGRAM_BOT_TOKEN="1234567890:ABCdefGHIjklMNOpqrsTUVwxyz"
export TELEGRAM_CHAT_ID="123456789"

步骤 4：测试连通性

python3 /workspace/skills/crypto-sniper-oracle/reporter.py --mode test

预期输出："✅ Test message sent to Telegram"

Cron 配置（可选）：

# 编辑 crontab
crontab -e

# 添加以下任务：
0 9 * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode daily
0 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode hourly
*/15 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode alerts

📊 使用示例

示例 1：手动分析

python3 crypto_oracle.py --symbol BTCUSDT

输出：JSON 格式数据（与 v3.2.1 版本一致）

示例 2：生成报告（不启用 Telegram）

python3 reporter.py --mode daily --symbols BTCUSDT,ETHUSDT

输出：

• 报告保存至 /workspace/reports/daily_2026-02-27.md
• 不通过 Telegram 发送

示例 3：生成并发送 Telegram 报告

# 设置好环境变量后执行
export TELEGRAM_BOT_TOKEN="..."
export TELEGRAM_CHAT_ID="..."

python3 reporter.py --mode daily --symbols BTCUSDT,ETHUSDT

输出：

• 报告本地保存
• 报告同步发送至 Telegram
• 操作记录写入 TRADING_LOGS.md

示例 4：异常警报检查

python3 reporter.py --mode alerts --symbols BTCUSDT

若检测到异常：

🚨 Alert sent to Telegram
📝 Logged to /workspace/reports/alerts_2026-02-27.log

若未检测到异常：

✅ No alerts - market normal

🎯 透明度声明

本技能的功能范围：

未启用 Telegram 时：

• 获取公开市场数据
• 计算各类量化指标
• 生成分析报告
• 报告保存于本地

启用 Telegram（用户主动选择）时：

• 上述全部功能 +
• 向用户自己的 Telegram 发送报告
• 用户须自行提供 bot token 与 chat ID
• 用户可随时禁用该功能

本技能绝不执行的操作：

• 绝不读取 agent 内存
• 绝不拦截或干扰其他技能运行
• 绝不下单或执行任何交易
• 绝不访问任何私有数据
• 绝不向第三方传输数据（仅当启用 Telegram 时，向用户自有 Telegram 发送）

网络行为说明：

默认行为：

• 仅访问 Binance 公共 API

启用 Telegram 后：

• 访问 Binance 公共 API
• 访问 Telegram API（仅限向用户自有 Bot 发送消息）

📄 许可证

MIT License — 详见 LICENSE 文件

版本：3.3.0
安全等级：L1（默认） / L2（启用 Telegram 后）
作者：Georges Andronescu（Wesley Armando）
代码仓库：https://github.com/georges91560/crypto-sniper-oracle

END OF SKILL