Crypto Sniper Oracle — Quantitative Market Intelligence + Reporting

⚠️ SCOPE & CAPABILITIES

Core Function: Fetch public market data and generate quantitative analysis.

What it does:

• - ✅ Fetches public ticker data from Binance API
• ✅ Fetches public order book data from Binance API
• ✅ Calculates Order Book Imbalance (OBI)
• ✅ Calculates VWAP divergence
• ✅ Scores liquidity quality (spread in bps)
• ✅ Generates formatted analysis reports
• ✅ [OPTIONAL] Sends reports via Telegram
• ✅ [OPTIONAL] Scheduled cron jobs for automated reports

What it does NOT do:

• - ❌ Place orders or execute trades
• ❌ Transfer funds
• ❌ Access private exchange data
• ❌ Read agent memory (beyond its own logs)
• ❌ Intercept or block other skills

🔧 Configuration Options

Mode 1: Analysis Only (Default)

No Telegram, manual invocation:
CODEBLOCK0

Use case: Manual analysis on demand.

Mode 2: Telegram Reports (Optional)

Enable Telegram alerts and reports:

Required environment variables:
CODEBLOCK1

Configuration:
CODEBLOCK2

Use case: Automated reports sent to Telegram.

Mode 3: Cron Jobs + Telegram (Automated)

Scheduled market reports:

Example cron jobs:
CODEBLOCK3

Use case: Fully automated market monitoring.

📊 Report Templates

1. Daily Market Report

Trigger: Cron (9am daily) or manual command

Content:

📊 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. Anomaly Alert

Trigger: OBI spike, spread explosion, or volume surge

Content:

🚨 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. Hourly Summary

Trigger: Cron (every hour)

Content:

⚡ 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}

🔐 File Access (Expanded)

READ:

• - /workspace/skills/crypto-sniper-oracle/crypto_oracle.py (data fetcher)
• INLINECODE1 (report generator)
• INLINECODE2 (report templates)

WRITE:

• - /workspace/.oracle_cache.json (45s cache)
• INLINECODE4 (analysis reports)
• INLINECODE5 (audit trail)
• INLINECODE6 (archived reports)
• INLINECODE7 (alert history)

🌐 Network Access (Expanded)

Always allowed:

• - ✅ https://api.binance.com/api/v3/* (public market data)

Conditionally allowed (if Telegram enabled):

• - ✅ https://api.telegram.org/bot{token}/* (send messages only)

Never allowed:

• - ❌ Binance private endpoints
• ❌ Order placement endpoints
• ❌ Withdrawal endpoints

📋 Cron Job Specifications

Daily Report

CODEBLOCK7

Hourly Check

CODEBLOCK8

Price Alerts

CODEBLOCK9

🛠️ How It Works

LAYER 1 — Data Acquisition (Unchanged)

Same as v3.2.1 - uses crypto_oracle.py to fetch data.

LAYER 2 — Report Generation (NEW)

CODEBLOCK10

LAYER 3 — Telegram Delivery (NEW)

CODEBLOCK11

🔒 Security & Privacy

Data Collection:

• - Public market data only
• No authentication for Binance API
• No personal data

Data Processing:

• - All calculations local
• Cache temporary (45s TTL)
• Reports stored locally

Telegram (Optional):

• - User must explicitly enable
• User provides bot token + chat ID
• Only sends TO user's Telegram
• No data sent to third parties
• Can be disabled anytime

Transparency:

• - All Telegram sends logged
• All reports archived
• Full audit trail in TRADING_LOGS.md

📚 Installation & Setup

Basic Setup (No Telegram):

CODEBLOCK12

Telegram Setup (Optional):

Step 1: Create Telegram Bot
CODEBLOCK13

Step 2: Get Chat ID
CODEBLOCK14

Step 3: Configure
CODEBLOCK15

Step 4: Test
CODEBLOCK16

Expected: "✅ Test message sent to Telegram"

Cron Setup (Optional):

CODEBLOCK17

📊 Usage Examples

Example 1: Manual Analysis

CODEBLOCK18

Output: JSON data (same as v3.2.1)

Example 2: Generate Report (No Telegram)

CODEBLOCK19

Output:

• - Report saved to INLINECODE11
• No Telegram send

Example 3: Generate + Send Telegram

CODEBLOCK20

Output:

• - Report saved locally
• Report sent to Telegram
• Logged in TRADING_LOGS.md

Example 4: Alert Check

CODEBLOCK21

If anomaly detected:
CODEBLOCK22

If no anomaly:

✅ No alerts - market normal

🎯 Transparency Statement

What This Skill Does:

Without Telegram:

• - Fetches public data
• Calculates metrics
• Generates reports
• Saves locally

With Telegram (User Opt-In):

• - All of above PLUS
• Sends reports to user's Telegram
• User must provide bot token + chat ID
• User can disable anytime

What This Skill Does NOT Do:

• - Does NOT read agent memory
• Does NOT intercept other skills
• Does NOT trade or place orders
• Does NOT access private data
• Does NOT send data to third parties (except user's own Telegram if enabled)

Network Behavior:

Default:

• - Binance public API only

With Telegram Enabled:

• - Binance public API
• Telegram API (send messages only, to user's bot)

📄 License

MIT License - See LICENSE