Skip to content

ai-trading-terminal/cloddsbot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Clodds Logo

AI-powered trading terminal for prediction markets, crypto & futures
Claude + Odds = Clodds

npm version Node.js TypeScript MIT License 119+ Skills Built for Colosseum Hackathon 10.7k clones in 14 days


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.


Quick Start

Latest release: v1.7.3View all releases

Platform Download Run
Windows x64 cloddsbot-x64.7z Run installer → launch cloddsbot-x64.exe
Linux x64 cloddsbot-Linux-x64.run chmod +x → run installer
macOS Apple Silicon cloddsbot-macOS-arm64.dmg Open DMG → drag to Applications

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)

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 proof
  • Statistics: Win rates, P&L, block reasons, accuracy by confidence bucket
clodds ledger stats              # Show decision statistics
clodds ledger calibration        # Confidence vs accuracy analysis
clodds ledger verify <id>        # Verify record integrity
clodds ledger anchor <id>        # Anchor hash to Solana

Enable: clodds config set ledger.enabled true


Skills & Extensions

118 bundled skills across trading, data, automation, and infrastructure — lazy-loaded on first use so missing dependencies don't crash the app. Run /skills to see status.

Category Skills
Trading Polymarket, Kalshi, Betfair, Hyperliquid, Binance, Bybit, MEXC, Drift, Jupiter, Raydium, Orca, Percolator, DCA (16 platforms)
Analysis Arbitrage detection, edge finding, whale tracking, copy trading, token security audits, security shield
Automation Cron jobs, triggers, bots, webhooks
AI Memory, embeddings, multi-agent routing

9 extensions for Copilot, OpenTelemetry, LanceDB, Qwen Portal, and more.


Architecture

┌──────────────────────────────────────────────────────────────────────────────┐
│                         GATEWAY & USER INTERFACE                              │
│  HTTP • WebSocket • Auth • Rate Limiting • 1000 connections                   │
│  21 Messaging Channels: WebChat, Telegram, Discord, Slack, Teams, Matrix...  │
└──────────────────────────────────────────┬─────────────────────────────────────┘
                                           │
┌──────────────────────────────────────────┴─────────────────────────────────────┐
│                            AI AGENTS LAYER (4)                                 │
│  Main (Claude) • Trading (Exec) • Research (Data) • Alerts (Monitor)          │
│  119+ Skills • 18 Tools • LanceDB Memory • Semantic Reasoning                  │
└──────────────────────────────────────────┬─────────────────────────────────────┘
                                           │
┌──────────────────────────────────────────┴─────────────────────────────────────┐
│                    UNIFIED STRATEGY & RISK LAYER                               │
│  118+ Strategies • Risk Engine (VaR/CVaR/Circuit Breaker) • Kelly Sizing      │
│  Backtesting • Trade Ledger • Position Manager • Arbitrage Detection          │
│  Whale Tracking • Copy Trading • MEV Protection • Smart Routing               │
└──────────────────────────────────────────┬─────────────────────────────────────┘
                                           │
    ┌──────────────────────┬──────────────┼──────────────┬──────────────────────┐
    ▼                      ▼              ▼              ▼                      ▼
┌──────────────────┐ ┌──────────────┐ ┌──────────────┐ ┌─────────────┐ ┌──────────────┐
│ PREDICTION       │ │ SOLANA DeFi  │ │ EVM DeFi     │ │ PERPETUAL   │ │ ON-CHAIN     │
│ MARKETS          │ │              │ │              │ │ FUTURES     │ │ PERPS        │
├──────────────────┤ ├──────────────┤ ├──────────────┤ ├─────────────┤ ├──────────────┤
│ Polymarket:      │ │ Jupiter      │ │ Uniswap V3   │ │ Binance     │ │ Percolator   │
│  • 5-min BTC     │ │ Raydium      │ │ 1inch        │ │  (125x)     │ │ (Solana)     │
│  • 1h/4h/daily   │ │ Orca         │ │ PancakeSwap  │ │ Bybit       │ │              │
│    (All assets)  │ │ Meteora      │ │ Virtuals     │ │  (100x)     │ │ Slab Parser  │
│ Kalshi           │ │ Kamino       │ │ Clanker      │ │ Hyperliquid │ │ Keeper Crank │
│ Betfair          │ │ MarginFi     │ │ Veil         │ │  (50x)      │ │ Oracle Feed  │
│ Smarkets         │ │ Solend       │ │ (ETH, ARB,   │ │ MEXC (200x) │ │              │
│ Drift           │ │ Pump.fun     │ │  OP, Base,   │ │ Drift       │ │ Settlement   │
│ Opinion.xyz      │ │ Bags.fm      │ │  Polygon)    │ │  (Solana)   │ │ Monitoring   │
│ Predict.fun      │ │              │ │              │ │ Percolator  │ │ Liquidation  │
│ Manifold         │ │ Jito Bundles │ │ Flashbots    │ │ Lighter     │ │ Alerts       │
│ Metaculus        │ │ MEV Protect. │ │ MEV Protect. │ │  (ARB)      │ │              │
│ PredictIt        │ │              │ │              │ │             │ │ Up to 200x   │
│                  │ │ WebSocket &  │ │ WebSocket &  │ │ WebSocket & │ │ leverage     │
│ CLOB Orders      │ │ HTTP APIs    │ │ HTTP APIs    │ │ HTTP APIs   │ │              │
│ Settlement       │ │              │ │              │ │             │ │ Fully        │
│ Tracking         │ │ Real-time    │ │ Real-time    │ │ Liquidation │ │ On-chain     │
└──────────────────┘ │ Price Feeds  │ │ Price Feeds  │ │ Monitoring  │ │              │
                     │              │ │              │ │             │ │ No KYC       │
    │ Gamma API │    │ Chainlink    │ │ Chainlink    │ │ Funding     │ │              │
    │ Poll for  │    │ Feeds        │ │ Feeds        │ │ Rates       │ └──────────────┘
    │ rounds    │    │              │ │              │ │             │
    │ Execution │    │ Execution    │ │ Execution    │ │ Execution   │
    └──────────┘    └──────────────┘ └──────────────┘ └─────────────┘
                     │                │                │
    ┌────────────────┴────────────────┴────────────────┴──────────────┐
    │          COMMON EXECUTION & DATA LAYER                          │
    │  Order Builder • Balance Checker • Slippage Estimator           │
    │  Fee Calculator • Real-time P&L • Settlement Polling            │
    │  Bittensor Mining (TAO) • x402 Payments (USDC)                 │
    │  Token Launch (Meteora DBC) • Agent Forum • Marketplace         │
    └────────────────────────┬─────────────────────────────────────────┘
                             │
                             ▼
        ┌───────────────────────────────────────────────────┐
        │       DATA PERSISTENCE LAYER                       │
        ├───────────────────────────────────────────────────┤
        │ SQLite: Local configs, WebChat, earnings          │
        │ LanceDB: Semantic memory, embeddings, profiles    │
        │ PostgreSQL: Trade history, analytics, backtest    │
        │ Backup & Sync: 3x replication • Compression       │
        └───────────────────────────────────────────────────┘

Configuration

# Required
ANTHROPIC_API_KEY=sk-ant-...

# Channels (pick any)
TELEGRAM_BOT_TOKEN=...
DISCORD_BOT_TOKEN=...

# Trading
POLYMARKET_API_KEY=...
SOLANA_PRIVATE_KEY=...

Data stored in ~/.clodds/ (SQLite database, auto-created on first run).


Summary

Category Count
Messaging Channels 21
Prediction Markets 10
Futures Exchanges 7
AI Tools 18
Skills 119
LLM Providers 8
Solana DeFi Protocols 9
Trading Strategies 4
Extensions 9

License

MIT — see LICENSE


Clodds — Claude + Odds
Built with Claude by Anthropic

About

Open Source AI trading agent that operates autonomously across 1000+ markets - Polymarket, Kalshi, Binance, Hyperliquid, Solana DEXs, 5 EVM chains. Scans for edge, executes instantly, manages risk while you sleep. Agent commerce protocol for machine-to-machine payments. Self-hosted. Built on Claude.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors