Skip to content

0xCaptain888/clawpath

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ClawPath — BNB Nexus AI Agent for Binance

钳途 · 用 AI 建设加密,与币安一起逐浪 Web3

A Telegram Bot powered AI Agent with 16 Skills for the Binance ecosystem — covering trading strategy, market marketing, and developer tools.

Features

Core Trading Skills

Skill Command Description
Real-time Price /price BNB Multi-coin price query
K-line Charts /kline BNB 4h Candlestick chart generation with MA overlays
AI Smart DCA /dca Intelligent dollar-cost averaging with backtest
Earn Products /earn Launchpool / Simple Earn / BNB Vault aggregation
Portfolio /portfolio Full portfolio view with USDT valuation
AI Analysis /analyze BNB RSI / MACD / Bollinger / Volume / AI score
Price Alert /alert BNB 700 Above/below price alerts with periodic checks
Gas Predictor /gas BNB Chain gas fee analysis and time-based predictions
Token Rankings /rank trending Trending / Alpha / Social Hype / Smart Money / Meme / PnL
Futures Data /futures funding BNB USDS-M futures price / funding rate / OI / long-short ratio
Meme Rush /meme new sol New / Finalizing / Migrated meme tokens + Topic Rush
Square Post /square Publish to Binance Square
Smart Money Signal /signal sol On-chain smart money buy/sell signals

🦞 Lobster Smart Trading (/lobster)

  • Signal Light — 8-dimension cross-validated signal (RSI multi-TF, MACD, Bollinger, MA alignment, volume anomaly, momentum, funding rate, social sentiment) → Green / Yellow / Red
  • Arbitrage Dashboard — Spot-futures basis, funding rate annualized yield, triangular arbitrage scanner, top basis ranking
  • Shell Backtest — MA crossover strategy backtest with 4-layer visualization (price + trades, equity curve, drawdown, volume)

📣 Lobster Marketing Bureau (/marketing)

  • Heatmap — Composite ranking: Social Hype (40%) + Trending (30%) + Smart Money Inflow (30%)
  • Content Generator — Real-time market data → Chinese tweet + English tweet + long-form outline
  • Campaign Manager — AI-recommended 7-step workflow + reward structure + progress tracking

🔧 Developer Toolbox (/devtool)

  • API Health Monitor — 10-endpoint latency check + AI diagnosis + optimization suggestions
  • Smart Doc Assistant — Keyword → endpoint + params + runnable code example (fuzzy match, CN/EN)
  • Test Case Generator — Boundary / exception / concurrency test matrix + executable Python script

Quick Start

Prerequisites

  • Python 3.10+
  • Telegram Bot Token (from @BotFather)

Installation

git clone https://github.com/0xCaptain888/clawpath.git
cd clawpath
pip install -r requirements.txt
cp .env.example .env
# Edit .env with your Telegram Bot Token
python bot.py

Configuration

Variable Required Description
TELEGRAM_BOT_TOKEN Yes Telegram Bot API token
ENCRYPTION_KEY No Key for encrypting stored API keys (auto-generated if empty)
ALERT_INTERVAL No Price alert check interval in seconds (default: 30)

Binding Binance API Key

In Telegram, send /bindkey and follow the prompts. Only Read permission is required. Enable Spot Trading if you want to use DCA auto-buy.

⚠️ Never enable Withdrawal permission.

Tech Stack

  • python-telegram-bot 21.6 — Telegram Bot API
  • binance-connector 3.9.0 — Binance REST API
  • aiohttp — Binance Web3 API (Social Hype, Smart Money, Meme Rush, Trading Signal)
  • matplotlib + mplfinance — Charts and backtest visualization
  • numpy + pandas — Technical indicator computation

Project Structure

clawpath/
├── bot.py              # Main bot (16 skills)
├── requirements.txt    # Python dependencies
├── .env.example        # Environment template
└── data/               # Runtime data (gitignored)
    ├── users.json      # User API keys (obfuscated)
    ├── alerts.json     # Price alerts
    ├── dca_plans.json  # DCA plans
    └── campaigns.json  # Marketing campaigns

License

MIT


#AI建设加密 与币安一起逐浪Web3

About

ClawPath (钳途) — BNB Nexus AI Agent for Binance | 16-Skill Telegram Bot | Trading + Marketing + DevTools | #AI建设加密

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors