README

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



  Clodds CA: 2puc76ehVHyPXhZmDprtP2phDSFE4kzZKDT4JgAWpump



  
  
  
  
  
  
  
  
  



  



  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, with full Solana integration (Jupiter, Pump.fun, Raydium, Orca, Bags.fm) and EVM chains (Robinhood,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

 Requirement: Node.js 22 or newer. Node.js 20 is not supported and dependency installation may fail.

bash
npm install -g https://github.com/alsk1992/CloddsBot/releases/latest/download/clodds.tgz --loglevel=error
clodds onboard


 The old clodds package on npmjs.com is no longer maintained. Install the current release from GitHub using the command above.

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)

bash
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:
- Install the latest GitHub Release → 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 au