{
  "schemaVersion": "1.0",
  "item": {
    "slug": "crypto-sniper-oracle",
    "name": "Crypto Sniper Oracle",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/georges91560/crypto-sniper-oracle",
    "canonicalUrl": "https://clawhub.ai/georges91560/crypto-sniper-oracle",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/crypto-sniper-oracle",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=crypto-sniper-oracle",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "crypto_oracle.py",
      "reporter.py",
      "README.md",
      "CONFIGURATION.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/crypto-sniper-oracle"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/crypto-sniper-oracle",
    "agentPageUrl": "https://openagent3.xyz/skills/crypto-sniper-oracle/agent",
    "manifestUrl": "https://openagent3.xyz/skills/crypto-sniper-oracle/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/crypto-sniper-oracle/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "⚠️ SCOPE & CAPABILITIES",
        "body": "Core Function: Fetch public market data and generate quantitative analysis.\n\nWhat it does:\n\n✅ Fetches public ticker data from Binance API\n✅ Fetches public order book data from Binance API\n✅ Calculates Order Book Imbalance (OBI)\n✅ Calculates VWAP divergence\n✅ Scores liquidity quality (spread in bps)\n✅ Generates formatted analysis reports\n✅ [OPTIONAL] Sends reports via Telegram\n✅ [OPTIONAL] Scheduled cron jobs for automated reports\n\nWhat it does NOT do:\n\n❌ Place orders or execute trades\n❌ Transfer funds\n❌ Access private exchange data\n❌ Read agent memory (beyond its own logs)\n❌ Intercept or block other skills"
      },
      {
        "title": "Mode 1: Analysis Only (Default)",
        "body": "No Telegram, manual invocation:\n\n# Just fetch data and analyze\npython3 crypto_oracle.py --symbol BTCUSDT\n\nUse case: Manual analysis on demand."
      },
      {
        "title": "Mode 2: Telegram Reports (Optional)",
        "body": "Enable Telegram alerts and reports:\n\nRequired environment variables:\n\nexport TELEGRAM_BOT_TOKEN=\"your_bot_token_here\"\nexport TELEGRAM_CHAT_ID=\"your_chat_id_here\"\n\nConfiguration:\n\n{\n  \"skills\": {\n    \"crypto-sniper-oracle\": {\n      \"enabled\": true,\n      \"config\": {\n        \"telegram_enabled\": true\n      }\n    }\n  }\n}\n\nUse case: Automated reports sent to Telegram."
      },
      {
        "title": "Mode 3: Cron Jobs + Telegram (Automated)",
        "body": "Scheduled market reports:\n\nExample cron jobs:\n\n# Daily report at 9am UTC\n0 9 * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode daily\n\n# Hourly anomaly check\n0 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode hourly\n\n# Price alerts every 15min\n*/15 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode alerts\n\nUse case: Fully automated market monitoring."
      },
      {
        "title": "1. Daily Market Report",
        "body": "Trigger: Cron (9am daily) or manual command\n\nContent:\n\n📊 CRYPTO MARKET DAILY REPORT\n{date} | Powered by Wesley\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n🎯 MARKET OVERVIEW (10 pairs analyzed)\n\n🟢 BULLISH SETUPS (OBI > +0.15)\n• BTCUSDT: OBI +0.18, Spread 2.1 bps\n  Price vs VWAP: +0.5% (above average)\n  Signal: Strong buying pressure\n\n• ETHUSDT: OBI +0.12, Spread 3.5 bps\n  Price vs VWAP: +0.3%\n  Signal: Moderate bullish\n\n🔴 BEARISH SETUPS (OBI < -0.15)\n• SOLUSDT: OBI -0.16, Spread 8.2 bps\n  Price vs VWAP: -0.8%\n  Signal: Selling pressure\n\n💰 LIQUIDITY QUALITY\nExcellent (< 5 bps): 5 pairs\nGood (5-10 bps): 3 pairs\nPoor (> 30 bps): 2 pairs\n\n📈 TOP MOVERS (24h)\n+12.3% SOLUSDT (volatility: HIGH)\n+8.1% ETHUSDT (volatility: MODERATE)\n-5.2% BNBUSDT (volatility: MODERATE)\n\n🎯 TRADING OPPORTUNITIES\n→ BTC: Bullish setup confirmed (OBI +0.18)\n→ ETH: Moderate strength, watch for breakout\n→ SOL: Avoid - selling pressure + poor liquidity\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nGenerated: 2026-02-27 09:00:00 UTC\nNext report: 2026-02-28 09:00:00 UTC"
      },
      {
        "title": "2. Anomaly Alert",
        "body": "Trigger: OBI spike, spread explosion, or volume surge\n\nContent:\n\n🚨 MARKET ANOMALY DETECTED\n\nTime: 15:23:45 UTC\nAsset: BTCUSDT\n\n📊 Anomaly Type: OBI SPIKE\n• Previous OBI: +0.05\n• Current OBI: +0.22\n• Change: +340% in 15 minutes\n\n💰 Liquidity: EXCELLENT (2.3 bps)\n📈 Price vs VWAP: +0.6%\n\n💡 Implication:\nStrong buying pressure surge detected.\nPotential upward price movement imminent.\n\n🎯 Suggested Action:\nConsider LONG entry if other signals align.\nMonitor closely for next 30 minutes.\n\n[View Full Analysis]"
      },
      {
        "title": "3. Hourly Summary",
        "body": "Trigger: Cron (every hour)\n\nContent:\n\n⚡ HOURLY MARKET CHECK\n{timestamp}\n\n🔍 Scanned: 10 pairs\n🟢 Bullish: 3\n🔴 Bearish: 2\n⚪ Neutral: 5\n\n📊 Notable Changes:\n• BTC OBI: +0.05 → +0.12 (↑)\n• ETH Spread: 3.2 → 5.8 bps (↑)\n\n⚠️ Alerts: None\nNext check: {next_hour}"
      },
      {
        "title": "🔐 File Access (Expanded)",
        "body": "READ:\n\n/workspace/skills/crypto-sniper-oracle/crypto_oracle.py (data fetcher)\n/workspace/skills/crypto-sniper-oracle/reporter.py (report generator)\n/workspace/skills/crypto-sniper-oracle/templates/*.md (report templates)\n\nWRITE:\n\n/workspace/.oracle_cache.json (45s cache)\n/workspace/MARKET_ANALYSIS.md (analysis reports)\n/workspace/TRADING_LOGS.md (audit trail)\n/workspace/reports/daily_{date}.md (archived reports)\n/workspace/reports/alerts_{date}.log (alert history)"
      },
      {
        "title": "🌐 Network Access (Expanded)",
        "body": "Always allowed:\n\n✅ https://api.binance.com/api/v3/* (public market data)\n\nConditionally allowed (if Telegram enabled):\n\n✅ https://api.telegram.org/bot{token}/* (send messages only)\n\nNever allowed:\n\n❌ Binance private endpoints\n❌ Order placement endpoints\n❌ Withdrawal endpoints"
      },
      {
        "title": "Daily Report",
        "body": "# Schedule: 9am UTC daily\n0 9 * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode daily --symbols BTCUSDT,ETHUSDT,SOLUSDT,BNBUSDT,ADAUSDT\n\n# What it does:\n1. Fetch data for all symbols\n2. Calculate OBI, VWAP, spread for each\n3. Aggregate into daily report\n4. Send via Telegram (if enabled)\n5. Archive to /workspace/reports/daily_{date}.md"
      },
      {
        "title": "Hourly Check",
        "body": "# Schedule: Every hour\n0 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode hourly --symbols BTCUSDT,ETHUSDT\n\n# What it does:\n1. Quick scan of key pairs\n2. Compare vs previous hour\n3. Detect significant changes\n4. Alert if anomaly detected"
      },
      {
        "title": "Price Alerts",
        "body": "# Schedule: Every 15 minutes\n*/15 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode alerts --symbols BTCUSDT\n\n# What it does:\n1. Check for OBI spikes (>50% change)\n2. Check for spread explosions (>100% increase)\n3. Check for volume surges (>200% of average)\n4. Send immediate Telegram alert if detected"
      },
      {
        "title": "LAYER 1 — Data Acquisition (Unchanged)",
        "body": "Same as v3.2.1 - uses crypto_oracle.py to fetch data."
      },
      {
        "title": "LAYER 2 — Report Generation (NEW)",
        "body": "PROCEDURE Generate_Report(mode, symbols):\n\n  1. FETCH DATA FOR ALL SYMBOLS\n     For each symbol in symbols:\n       data[symbol] = call_oracle(symbol)\n\n  2. AGGREGATE METRICS\n     Calculate:\n     - How many bullish (OBI > 0.15)\n     - How many bearish (OBI < -0.15)\n     - Average spread across all symbols\n     - Top movers by price change %\n\n  3. LOAD TEMPLATE\n     template = load_template(f\"{mode}_report.md\")\n\n  4. POPULATE TEMPLATE\n     report = template.format(\n       date=now(),\n       bullish_pairs=format_bullish(data),\n       bearish_pairs=format_bearish(data),\n       liquidity_summary=format_liquidity(data),\n       top_movers=format_movers(data)\n     )\n\n  5. SAVE REPORT\n     Write to /workspace/reports/{mode}_{date}.md\n\n  6. IF TELEGRAM ENABLED:\n       send_telegram_message(report)\n\n  7. LOG EXECUTION\n     Write to /workspace/TRADING_LOGS.md"
      },
      {
        "title": "LAYER 3 — Telegram Delivery (NEW)",
        "body": "PROCEDURE Send_Telegram_Report(report):\n\n  1. VALIDATE CREDENTIALS\n     IF TELEGRAM_BOT_TOKEN not set:\n       → Log error: \"Telegram not configured\"\n       → ABORT\n     \n     IF TELEGRAM_CHAT_ID not set:\n       → Log error: \"Chat ID not configured\"\n       → ABORT\n\n  2. FORMAT MESSAGE\n     # Telegram has 4096 char limit\n     IF len(report) > 4000:\n       → Split into multiple messages\n       → Send sequentially\n\n  3. SEND VIA API\n     POST https://api.telegram.org/bot{token}/sendMessage\n     Body:\n     {\n       \"chat_id\": \"{chat_id}\",\n       \"text\": \"{report}\",\n       \"parse_mode\": \"Markdown\"\n     }\n\n  4. HANDLE RESPONSE\n     IF success:\n       → Log: \"Report sent to Telegram\"\n     \n     IF error:\n       → Log error details\n       → Retry once after 5s\n       → If still fails: Save to /workspace/failed_reports/"
      },
      {
        "title": "Data Collection:",
        "body": "Public market data only\nNo authentication for Binance API\nNo personal data"
      },
      {
        "title": "Data Processing:",
        "body": "All calculations local\nCache temporary (45s TTL)\nReports stored locally"
      },
      {
        "title": "Telegram (Optional):",
        "body": "User must explicitly enable\nUser provides bot token + chat ID\nOnly sends TO user's Telegram\nNo data sent to third parties\nCan be disabled anytime"
      },
      {
        "title": "Transparency:",
        "body": "All Telegram sends logged\nAll reports archived\nFull audit trail in TRADING_LOGS.md"
      },
      {
        "title": "Basic Setup (No Telegram):",
        "body": "git clone https://github.com/georges91560/crypto-sniper-oracle.git\ncd crypto-sniper-oracle\n\ncp -r * /workspace/skills/crypto-sniper-oracle/\nchmod +x /workspace/skills/crypto-sniper-oracle/*.py"
      },
      {
        "title": "Telegram Setup (Optional):",
        "body": "Step 1: Create Telegram Bot\n\n1. Open Telegram, search @BotFather\n2. Send: /newbot\n3. Follow prompts, get BOT_TOKEN\n\nStep 2: Get Chat ID\n\n1. Send message to your bot\n2. Visit: https://api.telegram.org/bot{YOUR_TOKEN}/getUpdates\n3. Find \"chat\":{\"id\":123456789}\n\nStep 3: Configure\n\nexport TELEGRAM_BOT_TOKEN=\"1234567890:ABCdefGHIjklMNOpqrsTUVwxyz\"\nexport TELEGRAM_CHAT_ID=\"123456789\"\n\nStep 4: Test\n\npython3 /workspace/skills/crypto-sniper-oracle/reporter.py --mode test\n\nExpected: \"✅ Test message sent to Telegram\""
      },
      {
        "title": "Cron Setup (Optional):",
        "body": "# Edit crontab\ncrontab -e\n\n# Add jobs:\n0 9 * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode daily\n0 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode hourly\n*/15 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode alerts"
      },
      {
        "title": "Example 1: Manual Analysis",
        "body": "python3 crypto_oracle.py --symbol BTCUSDT\n\nOutput: JSON data (same as v3.2.1)"
      },
      {
        "title": "Example 2: Generate Report (No Telegram)",
        "body": "python3 reporter.py --mode daily --symbols BTCUSDT,ETHUSDT\n\nOutput:\n\nReport saved to /workspace/reports/daily_2026-02-27.md\nNo Telegram send"
      },
      {
        "title": "Example 3: Generate + Send Telegram",
        "body": "# With env vars set\nexport TELEGRAM_BOT_TOKEN=\"...\"\nexport TELEGRAM_CHAT_ID=\"...\"\n\npython3 reporter.py --mode daily --symbols BTCUSDT,ETHUSDT\n\nOutput:\n\nReport saved locally\nReport sent to Telegram\nLogged in TRADING_LOGS.md"
      },
      {
        "title": "Example 4: Alert Check",
        "body": "python3 reporter.py --mode alerts --symbols BTCUSDT\n\nIf anomaly detected:\n\n🚨 Alert sent to Telegram\n📝 Logged to /workspace/reports/alerts_2026-02-27.log\n\nIf no anomaly:\n\n✅ No alerts - market normal"
      },
      {
        "title": "What This Skill Does:",
        "body": "Without Telegram:\n\nFetches public data\nCalculates metrics\nGenerates reports\nSaves locally\n\nWith Telegram (User Opt-In):\n\nAll of above PLUS\nSends reports to user's Telegram\nUser must provide bot token + chat ID\nUser can disable anytime"
      },
      {
        "title": "What This Skill Does NOT Do:",
        "body": "Does NOT read agent memory\nDoes NOT intercept other skills\nDoes NOT trade or place orders\nDoes NOT access private data\nDoes NOT send data to third parties (except user's own Telegram if enabled)"
      },
      {
        "title": "Network Behavior:",
        "body": "Default:\n\nBinance public API only\n\nWith Telegram Enabled:\n\nBinance public API\nTelegram API (send messages only, to user's bot)"
      },
      {
        "title": "📄 License",
        "body": "MIT License - See LICENSE\n\nVersion: 3.3.0\nSecurity Level: L1 (Default) / L2 (With Telegram)\nAuthor: Georges Andronescu (Wesley Armando)\nRepository: https://github.com/georges91560/crypto-sniper-oracle\n\nEND OF SKILL"
      }
    ],
    "body": "Crypto Sniper Oracle — Quantitative Market Intelligence + Reporting\n⚠️ SCOPE & CAPABILITIES\n\nCore Function: Fetch public market data and generate quantitative analysis.\n\nWhat it does:\n\n✅ Fetches public ticker data from Binance API\n✅ Fetches public order book data from Binance API\n✅ Calculates Order Book Imbalance (OBI)\n✅ Calculates VWAP divergence\n✅ Scores liquidity quality (spread in bps)\n✅ Generates formatted analysis reports\n✅ [OPTIONAL] Sends reports via Telegram\n✅ [OPTIONAL] Scheduled cron jobs for automated reports\n\nWhat it does NOT do:\n\n❌ Place orders or execute trades\n❌ Transfer funds\n❌ Access private exchange data\n❌ Read agent memory (beyond its own logs)\n❌ Intercept or block other skills\n🔧 Configuration Options\nMode 1: Analysis Only (Default)\n\nNo Telegram, manual invocation:\n\n# Just fetch data and analyze\npython3 crypto_oracle.py --symbol BTCUSDT\n\n\nUse case: Manual analysis on demand.\n\nMode 2: Telegram Reports (Optional)\n\nEnable Telegram alerts and reports:\n\nRequired environment variables:\n\nexport TELEGRAM_BOT_TOKEN=\"your_bot_token_here\"\nexport TELEGRAM_CHAT_ID=\"your_chat_id_here\"\n\n\nConfiguration:\n\n{\n  \"skills\": {\n    \"crypto-sniper-oracle\": {\n      \"enabled\": true,\n      \"config\": {\n        \"telegram_enabled\": true\n      }\n    }\n  }\n}\n\n\nUse case: Automated reports sent to Telegram.\n\nMode 3: Cron Jobs + Telegram (Automated)\n\nScheduled market reports:\n\nExample cron jobs:\n\n# Daily report at 9am UTC\n0 9 * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode daily\n\n# Hourly anomaly check\n0 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode hourly\n\n# Price alerts every 15min\n*/15 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode alerts\n\n\nUse case: Fully automated market monitoring.\n\n📊 Report Templates\n1. Daily Market Report\n\nTrigger: Cron (9am daily) or manual command\n\nContent:\n\n📊 CRYPTO MARKET DAILY REPORT\n{date} | Powered by Wesley\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n🎯 MARKET OVERVIEW (10 pairs analyzed)\n\n🟢 BULLISH SETUPS (OBI > +0.15)\n• BTCUSDT: OBI +0.18, Spread 2.1 bps\n  Price vs VWAP: +0.5% (above average)\n  Signal: Strong buying pressure\n\n• ETHUSDT: OBI +0.12, Spread 3.5 bps\n  Price vs VWAP: +0.3%\n  Signal: Moderate bullish\n\n🔴 BEARISH SETUPS (OBI < -0.15)\n• SOLUSDT: OBI -0.16, Spread 8.2 bps\n  Price vs VWAP: -0.8%\n  Signal: Selling pressure\n\n💰 LIQUIDITY QUALITY\nExcellent (< 5 bps): 5 pairs\nGood (5-10 bps): 3 pairs\nPoor (> 30 bps): 2 pairs\n\n📈 TOP MOVERS (24h)\n+12.3% SOLUSDT (volatility: HIGH)\n+8.1% ETHUSDT (volatility: MODERATE)\n-5.2% BNBUSDT (volatility: MODERATE)\n\n🎯 TRADING OPPORTUNITIES\n→ BTC: Bullish setup confirmed (OBI +0.18)\n→ ETH: Moderate strength, watch for breakout\n→ SOL: Avoid - selling pressure + poor liquidity\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nGenerated: 2026-02-27 09:00:00 UTC\nNext report: 2026-02-28 09:00:00 UTC\n\n2. Anomaly Alert\n\nTrigger: OBI spike, spread explosion, or volume surge\n\nContent:\n\n🚨 MARKET ANOMALY DETECTED\n\nTime: 15:23:45 UTC\nAsset: BTCUSDT\n\n📊 Anomaly Type: OBI SPIKE\n• Previous OBI: +0.05\n• Current OBI: +0.22\n• Change: +340% in 15 minutes\n\n💰 Liquidity: EXCELLENT (2.3 bps)\n📈 Price vs VWAP: +0.6%\n\n💡 Implication:\nStrong buying pressure surge detected.\nPotential upward price movement imminent.\n\n🎯 Suggested Action:\nConsider LONG entry if other signals align.\nMonitor closely for next 30 minutes.\n\n[View Full Analysis]\n\n3. Hourly Summary\n\nTrigger: Cron (every hour)\n\nContent:\n\n⚡ HOURLY MARKET CHECK\n{timestamp}\n\n🔍 Scanned: 10 pairs\n🟢 Bullish: 3\n🔴 Bearish: 2\n⚪ Neutral: 5\n\n📊 Notable Changes:\n• BTC OBI: +0.05 → +0.12 (↑)\n• ETH Spread: 3.2 → 5.8 bps (↑)\n\n⚠️ Alerts: None\nNext check: {next_hour}\n\n🔐 File Access (Expanded)\n\nREAD:\n\n/workspace/skills/crypto-sniper-oracle/crypto_oracle.py (data fetcher)\n/workspace/skills/crypto-sniper-oracle/reporter.py (report generator)\n/workspace/skills/crypto-sniper-oracle/templates/*.md (report templates)\n\nWRITE:\n\n/workspace/.oracle_cache.json (45s cache)\n/workspace/MARKET_ANALYSIS.md (analysis reports)\n/workspace/TRADING_LOGS.md (audit trail)\n/workspace/reports/daily_{date}.md (archived reports)\n/workspace/reports/alerts_{date}.log (alert history)\n🌐 Network Access (Expanded)\n\nAlways allowed:\n\n✅ https://api.binance.com/api/v3/* (public market data)\n\nConditionally allowed (if Telegram enabled):\n\n✅ https://api.telegram.org/bot{token}/* (send messages only)\n\nNever allowed:\n\n❌ Binance private endpoints\n❌ Order placement endpoints\n❌ Withdrawal endpoints\n📋 Cron Job Specifications\nDaily Report\n# Schedule: 9am UTC daily\n0 9 * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode daily --symbols BTCUSDT,ETHUSDT,SOLUSDT,BNBUSDT,ADAUSDT\n\n# What it does:\n1. Fetch data for all symbols\n2. Calculate OBI, VWAP, spread for each\n3. Aggregate into daily report\n4. Send via Telegram (if enabled)\n5. Archive to /workspace/reports/daily_{date}.md\n\nHourly Check\n# Schedule: Every hour\n0 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode hourly --symbols BTCUSDT,ETHUSDT\n\n# What it does:\n1. Quick scan of key pairs\n2. Compare vs previous hour\n3. Detect significant changes\n4. Alert if anomaly detected\n\nPrice Alerts\n# Schedule: Every 15 minutes\n*/15 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode alerts --symbols BTCUSDT\n\n# What it does:\n1. Check for OBI spikes (>50% change)\n2. Check for spread explosions (>100% increase)\n3. Check for volume surges (>200% of average)\n4. Send immediate Telegram alert if detected\n\n🛠️ How It Works\nLAYER 1 — Data Acquisition (Unchanged)\n\nSame as v3.2.1 - uses crypto_oracle.py to fetch data.\n\nLAYER 2 — Report Generation (NEW)\nPROCEDURE Generate_Report(mode, symbols):\n\n  1. FETCH DATA FOR ALL SYMBOLS\n     For each symbol in symbols:\n       data[symbol] = call_oracle(symbol)\n\n  2. AGGREGATE METRICS\n     Calculate:\n     - How many bullish (OBI > 0.15)\n     - How many bearish (OBI < -0.15)\n     - Average spread across all symbols\n     - Top movers by price change %\n\n  3. LOAD TEMPLATE\n     template = load_template(f\"{mode}_report.md\")\n\n  4. POPULATE TEMPLATE\n     report = template.format(\n       date=now(),\n       bullish_pairs=format_bullish(data),\n       bearish_pairs=format_bearish(data),\n       liquidity_summary=format_liquidity(data),\n       top_movers=format_movers(data)\n     )\n\n  5. SAVE REPORT\n     Write to /workspace/reports/{mode}_{date}.md\n\n  6. IF TELEGRAM ENABLED:\n       send_telegram_message(report)\n\n  7. LOG EXECUTION\n     Write to /workspace/TRADING_LOGS.md\n\nLAYER 3 — Telegram Delivery (NEW)\nPROCEDURE Send_Telegram_Report(report):\n\n  1. VALIDATE CREDENTIALS\n     IF TELEGRAM_BOT_TOKEN not set:\n       → Log error: \"Telegram not configured\"\n       → ABORT\n     \n     IF TELEGRAM_CHAT_ID not set:\n       → Log error: \"Chat ID not configured\"\n       → ABORT\n\n  2. FORMAT MESSAGE\n     # Telegram has 4096 char limit\n     IF len(report) > 4000:\n       → Split into multiple messages\n       → Send sequentially\n\n  3. SEND VIA API\n     POST https://api.telegram.org/bot{token}/sendMessage\n     Body:\n     {\n       \"chat_id\": \"{chat_id}\",\n       \"text\": \"{report}\",\n       \"parse_mode\": \"Markdown\"\n     }\n\n  4. HANDLE RESPONSE\n     IF success:\n       → Log: \"Report sent to Telegram\"\n     \n     IF error:\n       → Log error details\n       → Retry once after 5s\n       → If still fails: Save to /workspace/failed_reports/\n\n🔒 Security & Privacy\nData Collection:\nPublic market data only\nNo authentication for Binance API\nNo personal data\nData Processing:\nAll calculations local\nCache temporary (45s TTL)\nReports stored locally\nTelegram (Optional):\nUser must explicitly enable\nUser provides bot token + chat ID\nOnly sends TO user's Telegram\nNo data sent to third parties\nCan be disabled anytime\nTransparency:\nAll Telegram sends logged\nAll reports archived\nFull audit trail in TRADING_LOGS.md\n📚 Installation & Setup\nBasic Setup (No Telegram):\ngit clone https://github.com/georges91560/crypto-sniper-oracle.git\ncd crypto-sniper-oracle\n\ncp -r * /workspace/skills/crypto-sniper-oracle/\nchmod +x /workspace/skills/crypto-sniper-oracle/*.py\n\nTelegram Setup (Optional):\n\nStep 1: Create Telegram Bot\n\n1. Open Telegram, search @BotFather\n2. Send: /newbot\n3. Follow prompts, get BOT_TOKEN\n\n\nStep 2: Get Chat ID\n\n1. Send message to your bot\n2. Visit: https://api.telegram.org/bot{YOUR_TOKEN}/getUpdates\n3. Find \"chat\":{\"id\":123456789}\n\n\nStep 3: Configure\n\nexport TELEGRAM_BOT_TOKEN=\"1234567890:ABCdefGHIjklMNOpqrsTUVwxyz\"\nexport TELEGRAM_CHAT_ID=\"123456789\"\n\n\nStep 4: Test\n\npython3 /workspace/skills/crypto-sniper-oracle/reporter.py --mode test\n\n\nExpected: \"✅ Test message sent to Telegram\"\n\nCron Setup (Optional):\n# Edit crontab\ncrontab -e\n\n# Add jobs:\n0 9 * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode daily\n0 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode hourly\n*/15 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode alerts\n\n📊 Usage Examples\nExample 1: Manual Analysis\npython3 crypto_oracle.py --symbol BTCUSDT\n\n\nOutput: JSON data (same as v3.2.1)\n\nExample 2: Generate Report (No Telegram)\npython3 reporter.py --mode daily --symbols BTCUSDT,ETHUSDT\n\n\nOutput:\n\nReport saved to /workspace/reports/daily_2026-02-27.md\nNo Telegram send\nExample 3: Generate + Send Telegram\n# With env vars set\nexport TELEGRAM_BOT_TOKEN=\"...\"\nexport TELEGRAM_CHAT_ID=\"...\"\n\npython3 reporter.py --mode daily --symbols BTCUSDT,ETHUSDT\n\n\nOutput:\n\nReport saved locally\nReport sent to Telegram\nLogged in TRADING_LOGS.md\nExample 4: Alert Check\npython3 reporter.py --mode alerts --symbols BTCUSDT\n\n\nIf anomaly detected:\n\n🚨 Alert sent to Telegram\n📝 Logged to /workspace/reports/alerts_2026-02-27.log\n\n\nIf no anomaly:\n\n✅ No alerts - market normal\n\n🎯 Transparency Statement\nWhat This Skill Does:\n\nWithout Telegram:\n\nFetches public data\nCalculates metrics\nGenerates reports\nSaves locally\n\nWith Telegram (User Opt-In):\n\nAll of above PLUS\nSends reports to user's Telegram\nUser must provide bot token + chat ID\nUser can disable anytime\nWhat This Skill Does NOT Do:\nDoes NOT read agent memory\nDoes NOT intercept other skills\nDoes NOT trade or place orders\nDoes NOT access private data\nDoes NOT send data to third parties (except user's own Telegram if enabled)\nNetwork Behavior:\n\nDefault:\n\nBinance public API only\n\nWith Telegram Enabled:\n\nBinance public API\nTelegram API (send messages only, to user's bot)\n📄 License\n\nMIT License - See LICENSE\n\nVersion: 3.3.0\nSecurity Level: L1 (Default) / L2 (With Telegram)\nAuthor: Georges Andronescu (Wesley Armando)\nRepository: https://github.com/georges91560/crypto-sniper-oracle\n\nEND OF SKILL"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/georges91560/crypto-sniper-oracle",
    "publisherUrl": "https://clawhub.ai/georges91560/crypto-sniper-oracle",
    "owner": "georges91560",
    "version": "3.3.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/crypto-sniper-oracle",
    "downloadUrl": "https://openagent3.xyz/downloads/crypto-sniper-oracle",
    "agentUrl": "https://openagent3.xyz/skills/crypto-sniper-oracle/agent",
    "manifestUrl": "https://openagent3.xyz/skills/crypto-sniper-oracle/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/crypto-sniper-oracle/agent.md"
  }
}