Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Institutional-grade quantitative market oracle with Order Book Imbalance (OBI), VWAP analysis, automated reports, and Telegram alerts.
Institutional-grade quantitative market oracle with Order Book Imbalance (OBI), VWAP analysis, automated reports, and Telegram alerts.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
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.
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.
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
No Telegram, manual invocation: # Just fetch data and analyze python3 crypto_oracle.py --symbol BTCUSDT Use case: Manual analysis on demand.
Enable Telegram alerts and reports: Required environment variables: export TELEGRAM_BOT_TOKEN="your_bot_token_here" export TELEGRAM_CHAT_ID="your_chat_id_here" Configuration: { "skills": { "crypto-sniper-oracle": { "enabled": true, "config": { "telegram_enabled": true } } } } Use case: Automated reports sent to Telegram.
Scheduled market reports: Example cron jobs: # Daily report at 9am UTC 0 9 * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode daily # Hourly anomaly check 0 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode hourly # Price alerts every 15min */15 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode alerts Use case: Fully automated market monitoring.
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
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]
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}
READ: /workspace/skills/crypto-sniper-oracle/crypto_oracle.py (data fetcher) /workspace/skills/crypto-sniper-oracle/reporter.py (report generator) /workspace/skills/crypto-sniper-oracle/templates/*.md (report templates) WRITE: /workspace/.oracle_cache.json (45s cache) /workspace/MARKET_ANALYSIS.md (analysis reports) /workspace/TRADING_LOGS.md (audit trail) /workspace/reports/daily_{date}.md (archived reports) /workspace/reports/alerts_{date}.log (alert history)
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
# Schedule: 9am UTC daily 0 9 * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode daily --symbols BTCUSDT,ETHUSDT,SOLUSDT,BNBUSDT,ADAUSDT # What it does: 1. Fetch data for all symbols 2. Calculate OBI, VWAP, spread for each 3. Aggregate into daily report 4. Send via Telegram (if enabled) 5. Archive to /workspace/reports/daily_{date}.md
# Schedule: Every hour 0 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode hourly --symbols BTCUSDT,ETHUSDT # What it does: 1. Quick scan of key pairs 2. Compare vs previous hour 3. Detect significant changes 4. Alert if anomaly detected
# Schedule: Every 15 minutes */15 * * * * /workspace/skills/crypto-sniper-oracle/reporter.py --mode alerts --symbols BTCUSDT # What it does: 1. Check for OBI spikes (>50% change) 2. Check for spread explosions (>100% increase) 3. Check for volume surges (>200% of average) 4. Send immediate Telegram alert if detected
Same as v3.2.1 - uses crypto_oracle.py to fetch data.
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
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 has 4096 char limit 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/
Public market data only No authentication for Binance API No personal data
All calculations local Cache temporary (45s TTL) Reports stored locally
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
All Telegram sends logged All reports archived Full audit trail in TRADING_LOGS.md
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
Step 1: Create Telegram Bot 1. Open Telegram, search @BotFather 2. Send: /newbot 3. Follow prompts, get BOT_TOKEN Step 2: Get Chat ID 1. Send message to your bot 2. Visit: https://api.telegram.org/bot{YOUR_TOKEN}/getUpdates 3. Find "chat":{"id":123456789} Step 3: Configure export TELEGRAM_BOT_TOKEN="1234567890:ABCdefGHIjklMNOpqrsTUVwxyz" export TELEGRAM_CHAT_ID="123456789" Step 4: Test python3 /workspace/skills/crypto-sniper-oracle/reporter.py --mode test Expected: "โ Test message sent to Telegram"
# Edit crontab crontab -e # Add jobs: 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
python3 crypto_oracle.py --symbol BTCUSDT Output: JSON data (same as v3.2.1)
python3 reporter.py --mode daily --symbols BTCUSDT,ETHUSDT Output: Report saved to /workspace/reports/daily_2026-02-27.md No Telegram send
# With env vars set export TELEGRAM_BOT_TOKEN="..." export TELEGRAM_CHAT_ID="..." python3 reporter.py --mode daily --symbols BTCUSDT,ETHUSDT Output: Report saved locally Report sent to Telegram Logged in TRADING_LOGS.md
python3 reporter.py --mode alerts --symbols BTCUSDT If anomaly detected: ๐จ Alert sent to Telegram ๐ Logged to /workspace/reports/alerts_2026-02-27.log If no anomaly: โ No alerts - market normal
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
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)
Default: Binance public API only With Telegram Enabled: Binance public API Telegram API (send messages only, to user's bot)
MIT License - See LICENSE Version: 3.3.0 Security Level: L1 (Default) / L2 (With Telegram) Author: Georges Andronescu (Wesley Armando) Repository: https://github.com/georges91560/crypto-sniper-oracle END OF SKILL
Data access, storage, extraction, analysis, reporting, and insight generation.
Largest current source with strong distribution and engagement signals.