🤖 AI-powered live trading suite for Polymarket and sports markets. Built for codexbt with modular strategies, secure configs, and LLM validation.

GRZFGTFNbNxTTRCVDrMvhE9Pp86HQ1ehpZ7DqgGTpump

---

✨ Features

• 🚀 Professional Architecture: Clean layout with modular, focused scripts
• 🤖 Multi-Strategy Bots: Polymarket momentum, sports scanning, arbitrage, LLM-enhanced decisions
• ⚙️ Config-Driven: Environment variables in secure .env files
• 🔄 Live Trading Ready: Relayer integration, paper trading mode, comprehensive tracking
• 🧠 AI Validation: LLM-powered signal confidence for smarter trades
• 📊 Advanced Metrics: Win/loss ratios, PnL tracking, real-time logging
• 🔒 Security First: Encrypted secrets, no hardcoded credentials
• 🎯 Risk Management: Trade limits, position sizing, automated stops

---

📁 Project Structure

File	Description
poly5min_llm_bot.py	🤖 LLM-enhanced Polymarket 5-min momentum bot
sports_bot.py	⚽ Sports market scanner and automated trader
polyarbi.py	📈 Arbitrage and spread trading engine
swissbot.py	🏔️ Swiss market trading bot
sniperbot.py	🎯 Precision sniper bot for opportunities
poly5min_all.py	🔍 Multi-market scanning and analysis tool
requirements.txt	📦 Python dependencies
.env (example)	🔐 Secure configuration template

---

🚀 Quick Start

Prerequisites

• Python 3.10+
• Git

Installation

1. Clone the repo

   git clone https://github.com/codexbt/poly-claw-bot.git
   cd poly-claw-bot

2. Install dependencies

   pip install -r requirements.txt

3. Configure environment

   cp .env.example .env  # Edit with your keys

Run a Bot

Polymarket LLM Bot:

python poly5min_llm_bot.py

Sports Bot:

python sports_bot.py

Arbitrage Bot:

python polyarbi.py

Windows PowerShell (parallel):

start powershell -NoExit python poly5min_llm_bot.py
start powershell -NoExit python sports_bot.py
start powershell -NoExit python polyarbi.py

---

🔧 Configuration

Create a .env file in the root directory with your secure credentials:

# Polymarket/Clob Credentials
PRIVATE_KEY=0xYOUR_PRIVATE_KEY
RELAYER_API_KEY=YOUR_RELAYER_API_KEY
RELAYER_API_KEY_ADDRESS=0xYOUR_SIGNER_ADDRESS

# AI/LLM Integration
OPENROUTER_API_KEY=sk-or-YOUR_OPENROUTER_KEY

# Trading Mode
PAPER_MODE=true  # Set to false for live trading

# Optional: Additional API keys for sports data
SPORTS_API_KEY=YOUR_SPORTS_API_KEY

⚠️ Security Note: Never commit .env files. Use .gitignore to exclude them.

---

🧠 Capabilities

• 🎯 Advanced Trading Engines: Momentum-based Polymarket trading with volume triggers and risk controls
• 🤖 AI-Powered Validation: OpenRouter LLM integration for trade signal confidence scoring
• 📊 Comprehensive Metrics: Real-time win/loss tracking, PnL calculations, and detailed logging
• 🔧 Modular Architecture: Easily extensible strategies and clean codebase
• 🔒 Enterprise Security: Secure .env handling, encrypted communications, no secrets in code
• ⚡ High Performance: Optimized for low-latency execution and concurrent operations

---

📌 Why this repo is professional

• Clean presentation with badges, clear structure, and concise messaging.
• Minimal root clutter and a sharp developer-first layout.
• Practical quick start and configuration guidance.
• Focus on safe trading patterns, not unbounded automation.

---

💡 Best Practices

• 🧪 Test First: Always use PAPER_MODE=true for testing strategies
• 🔐 Secure Secrets: Store all credentials in .env, never in code
• 📈 Monitor Performance: Track logs and metrics when adjusting parameters
• 🚦 Risk Management: Start with small positions and scale gradually
• 🔄 Regular Updates: Keep dependencies updated and review code periodically

📖 Examples

Running Multiple Bots

# Start all bots in background
python poly5min_llm_bot.py &
python sports_bot.py &
python polyarbi.py &

Custom Configuration

# Example: Modify risk parameters
MAX_POSITION_SIZE = 0.1  # 10% of portfolio
STOP_LOSS_PERCENT = 0.05  # 5% stop loss

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open a Pull Request

🐛 Issues & Support

• 📋 Report Issues
• 📧 Contact: Built for codexbt

⭐ Support the Project

If Poly Claw Bot helps your trading, please:

• ⭐ Star the repository
• 🍴 Fork and contribute
• 💝 Share with fellow traders

---

📄 License

Licensed under MIT License - see LICENSE for details.

---

Built with ❤️ for codexbt - Professional trading automation made simple.

Updated 2025-11-16: Improve config hints and notes Updated 2025-11-23: Refactor bot startup logging Updated 2025-11-25: Update LLM validation note Updated 2025-11-27: Refactor bot startup logging Updated 2025-12-01: Update LLM validation note Updated 2026-04-10: Polish performance logging text Updated 2026-04-14: Improve config hints and notes Updated 2026-04-29: Clarify thresholds in comments Updated 2026-05-08: Improve config hints and notes Updated 2026-05-14: Refactor bot startup logging