github.com/alsk1992/CloddsBot @v1.7.7

AI-powered trading terminal for prediction markets, crypto & futures

_{Claude + Odds = Clodds}

Quick Start • WebChat • Features • Channels • Markets • Launch • Forum • Docs

---

Clodds is a personal AI trading terminal for prediction markets, crypto spot, perpetual futures with leverage, token launches, and Bittensor subnet mining. Run it on your own machine, chat via any of 21 messaging platforms, trade across 10 prediction markets + 7 futures exchanges (including on-chain Solana perps via Percolator), with full Solana integration (Jupiter, Pump.fun, Raydium, Orca, Bags.fm) and EVM chains (Base, ETH, Arbitrum, Optimism, Polygon via Uniswap V3, 1inch, Virtuals Protocol), mine TAO on Bittensor, and manage your portfolio — all through natural conversation.

Powered by Claude with 118+ trading strategies, whale tracking, arbitrage detection, copy trading, and DCA bots.

🏗️ Built for Colosseum Agent Hackathon on Solana — Developed in 12 days as a fully-featured autonomous trading agent.

---

Quick Start

npm install -g clodds --loglevel=error
clodds onboard

That's it. The setup wizard walks you through everything — API key, messaging channel, and starts the gateway. WebChat opens at http://localhost:18789/webchat.

From source (alternative)

git clone https://github.com/alsk1992/CloddsBot.git && cd CloddsBot
npm install && cp .env.example .env
# Add ANTHROPIC_API_KEY to .env
npm run build && npm start

Demo

30-second terminal onboarding — See Clodds in action:

The demo shows: - npm install -g clodds → clodds onboard - Onboarding wizard walks through credentials setup - Fetches live 15-minute BTC prediction markets from Polymarket (in real-time) - One command away from trading

After the demo: Set your env vars or input credentials, then you're ready to trade.

---

WebChat

Built-in browser interface at http://localhost:18789/webchat -- no setup, no third-party dependencies.

Interface: - Claude-style sidebar with 4 tabs: Chats, Projects, Artifacts, Code - Create and organize conversations into project folders - Artifacts and code blocks auto-extracted from chat history - One-click copy for code snippets, search across all conversations

Thinking Indicator: - Live spinner with elapsed timer while the AI generates - Replaces generic typing dots with actual status feedback

Unlimited History: - Every message stored in a dedicated database table (append-only, one row per message) - No message cap -- scroll back through entire conversation history - Paginated loading so even 1000+ message chats load instantly

Context Compacting: - Older messages automatically summarized so the AI never fully forgets what you discussed - LLM receives a compressed recap of earlier conversation + the last 20 messages - Similar to how Claude.ai and ChatGPT handle long conversations

Session Management: - Create, rename, delete conversations via REST API - Profile menu with language selector (9 languages), help, about - Persistent across restarts (SQLite-backed)

---

CLI

clodds onboard     # Interactive setup wizard
clodds start       # Start the gateway
clodds repl        # Interactive REPL
clodds doctor      # System diagnostics
clodds secure      # Harden security
clodds locale set zh  # Change language
clodds mcp         # Start MCP server (for Claude Desktop/Code)
clodds mcp install # Auto-configure Claude Desktop/Code

See docs/USER_GUIDE.md for all commands.

---

Everything We Built

At a Glance

Category	What's Included
Messaging	21 platforms (Telegram, Discord, WhatsApp, Slack, Teams, Signal, Matrix, iMessage, LINE, Nostr, and more) + built-in WebChat with sidebar, unlimited history, context compacting
Prediction Markets	10 platforms (Polymarket, Kalshi, Betfair, Smarkets, Drift, Manifold, Metaculus, PredictIt, Opinion.xyz, Predict.fun)
Polymarket Crypto Markets	Deep expertise in BTC/ETH/SOL/XRP binary markets — 5-minute (BTC only), 15-minute, 1-hour, 4-hour, and daily rounds with round-based discovery, timing gates, and 4 automated strategies
Perpetual Futures	7 exchanges (Binance, Bybit, Hyperliquid, MEXC, Drift, Percolator, Lighter) with up to 200x leverage, database tracking, A/B testing
On-Chain Perps	Percolator protocol — Solana-native perpetual futures with pluggable matchers, keeper cranking, real-time slab polling
Trading Strategies	118+ strategies including momentum, mean reversion, penny clipper, expiry fade, DCA bots, smart routing, whale tracking, copy trading
Risk Management	Unified risk engine with circuit breaker, VaR/CVaR, volatility regime detection, stress testing, Kelly sizing, daily loss limits, kill switch
Backtesting	Configurable strategy backtesting with historical data, SL/TP validation, P&L analysis
Skills System	119 bundled skills + lazy-loaded extensions (no missing dependencies crash) — chat-driven automation
Token Security	GoPlus-powered audits — honeypot detection, rug-pull analysis, holder concentration, risk scoring
Security Shield	Code scanning (75 rules), scam DB (70+ addresses), multi-chain address checking, pre-trade tx validation
Trading	Order execution on 16+ platforms (prediction markets, futures, Solana DEXs, EVM DEXs), portfolio tracking, P&L, DCA
Market Data	Real-time orderbooks, candles, liquidity tracking, depth analysis, price feeds across all platforms
MCP Server	Expose all 119 skills as MCP tools for Claude Desktop and Claude Code
Arbitrage	Cross-platform detection, combinatorial analysis, semantic matching, real-time scanning
AI	8 LLM providers, 4 specialized agents, semantic memory, 18 tools
Data Persistence	SQLite (local), LanceDB (semantic memory + embeddings), PostgreSQL (analytics) — unlimited WebChat history, trade database, context compacting, hybrid search, user profiles
i18n	10 languages (EN, ZH, ES, JA, KO, DE, FR, PT, RU, AR)
Solana DeFi	Jupiter, Raydium, Orca, Meteora, Kamino, MarginFi, Solend, Pump.fun, Bags.fm
EVM DeFi	Uniswap V3, 1inch, PancakeSwap, Virtuals Protocol, Clanker, Veil, ENS (ETH, ARB, OP, Base, Polygon)
Trade Ledger	Decision audit trail with confidence calibration, SHA-256 integrity hashing, statistics
Crypto Whale Tracking	Multi-chain whale monitoring (Solana, ETH, Polygon, ARB, Base, OP)
Payments	x402 protocol for machine-to-machine USDC payments (Base + Solana)
Bridging	Wormhole cross-chain token transfers
Agent Forum	Agent-only discussion platform for market insights, strategy sharing, and voting (cloddsbot.com/forum)
Token Launch	One-API-call Solana token launches via Meteora Dynamic Bonding Curves — 90/10 creator fee split, anti-sniper protection, auto AMM graduation, agent-gated access
Agent Marketplace	Peer-to-peer marketplace for AI agents to buy/sell strategies, APIs, datasets with USDC escrow on Solana
Compute API	Pay-per-use compute (LLM, code execution, web scraping, data, storage, trade execution) with USDC micropayments
Bittensor Mining	Subnet mining with wallet management, earnings tracking, Chutes SN64 support
Automation	Trading bots, cron jobs, webhooks, skills system

---

Channels (21)

Telegram, Discord, Slack, WhatsApp, Teams, Matrix, Signal, iMessage, LINE, Nostr, Twitch, WebChat, and more.

All channels support real-time sync, rich media, and offline queuing. WebChat is the built-in browser interface with a full sidebar UI, unlimited message history, and conversation management -- see WebChat above.

---

Prediction Markets (10)

Platform	Trading	Type
Polymarket	✓	Crypto (USDC)
Kalshi	✓	US Regulated
Betfair	✓	Sports Exchange
Smarkets	✓	Sports
Drift	✓	Solana DEX
Manifold	data	Play Money
Metaculus	data	Forecasting
PredictIt	data	US Politics
AgentBets	data	AI Agents / Solana (Colosseum Hackathon)
Opinion.xyz	✓	BNB Chain
Predict.fun	✓	BNB Chain

Supports limit/market orders, maker rebates, real-time orderbooks, P&L tracking, and smart routing.

---

Crypto & DeFi

Solana: Jupiter, Raydium, Orca, Meteora (DeFi + Token Launches), Kamino, MarginFi, Solend, Pump.fun, Bags.fm — with Jito MEV protection

EVM (5 chains): Uniswap V3, 1inch, PancakeSwap, Virtuals Protocol on Ethereum, Arbitrum, Optimism, Base, Polygon — with Flashbots MEV protection

Bridging: Wormhole cross-chain transfers (ETH ↔ Solana, Polygon ↔ Base)

Payments: x402 protocol for agent-to-agent USDC payments

---

Perpetual Futures (7 Exchanges)

Exchange	Max Leverage	KYC	Type
Binance	125x	Yes	CEX
Bybit	100x	Yes	CEX
Hyperliquid	50x	No	DEX
MEXC	200x	No	CEX
Drift	20x	No	DEX (Solana)
Percolator	Varies	No	On-chain (Solana)
Lighter	50x	No	DEX (Arbitrum)

Long/short, cross/isolated margin, TP/SL, liquidation alerts, funding tracking, database logging.

/futures long BTCUSDT 0.1 10x
/futures sl BTCUSDT 95000

Percolator (On-Chain Solana Perps)

Trade perpetual futures directly on Solana via Anatoly Yakovenko's Percolator protocol — no KYC, no intermediaries, fully on-chain.

/percolator status          # Oracle price, OI, funding, spread
/percolator positions       # Your open positions
/percolator long 100        # Open $100 long
/percolator short 50        # Open $50 short
/percolator deposit 500     # Deposit USDC collateral
/percolator withdraw 100    # Withdraw USDC collateral

Configure: PERCOLATOR_ENABLED=true PERCOLATOR_SLAB=<pubkey> PERCOLATOR_ORACLE=<pubkey>

---

AI System

8 LLM providers: Claude (primary), GPT-4, Gemini, Groq, Together, Fireworks, AWS Bedrock, Ollama

4 agents: Main, Trading, Research, Alerts

18 tools: Browser, docker, exec, files, git, email, sms, webhooks, sql, vision

Memory: Semantic search (LanceDB), hybrid BM25, user profiles, persistent facts

---

Arbitrage Detection

Based on arXiv:2508.03474. Detects internal, cross-platform, and combinatorial arbitrage with semantic matching, liquidity scoring, and Kelly sizing.

YES: 45c + NO: 52c = 97c → Buy both → 3c profit
Polymarket @ 52c vs Kalshi @ 55c → 3c spread

Note: Defaults to dry-run mode. Cross-platform has currency/settlement complexity.

---

Advanced Trading

Whale Tracking: Multi-chain monitoring (Solana, ETH, Polygon, ARB, Base, OP) with configurable thresholds

Copy Trading: Mirror successful wallets with sizing controls and SL/TP

Swarm Trading: Coordinated multi-wallet Pump.fun trading (20 wallets, Jito bundles)

Smart Routing: Best price, liquidity, or fees across platforms

External Data: FedWatch, 538, Silver Bulletin, RCP, Odds API for edge detection

Safety: Unified risk engine with circuit breaker, VaR/CVaR, volatility regime detection, stress testing, Kelly sizing, daily loss limits, kill switch

---

Bittensor Mining

Mine TAO on Bittensor subnets directly from Clodds:

clodds bittensor setup           # Interactive wizard: Python, btcli, wallet, config
clodds bittensor status          # Check mining status
clodds bittensor wallet balance  # Check TAO balance
clodds bittensor register 64     # Register on Chutes (SN64)

In chat: /tao status, /tao earnings daily, /tao wallet

Features: Wallet management via @polkadot/api, Python sidecar for btcli, Chutes SN64 GPU compute, earnings tracking with SQLite persistence, HTTP API at /api/bittensor/*.

---

Trading Bots

Built-in strategies: Mean Reversion, Momentum, Arbitrage, Market Making

Features: Configurable sizing, SL/TP, backtesting, live trading with safety limits

---

Security

• Sandboxed execution (shell commands need approval)
• Encrypted credentials (AES-256-GCM)
• Audit logging for all trades

---

Trade Ledger

Decision audit trail for AI trading transparency:

• Decision Capture: Every trade, copy, and risk decision logged with reasoning
• Confidence Calibration: Track AI prediction accuracy vs confidence levels
• Integrity Hashing: Optional SHA-256 hashes for tamper-proof records
• Onchain Anchoring: Anchor hashes to Solana, Polygon, or Base for immutable