AI agentsbotfree
CloddsBot: what it does, what it needs, where it sprawls
Last checked 2026-09-08
CloddsBot (Clodds) is a self-hosted AI trading agent built on Claude. You install it with npm, talk to it through WebChat or one of 21 messaging platforms, and it reads order books, detects arbitrage and places orders on ten prediction markets.
The prediction-market core sits inside a much larger project that also covers perpetual futures on 7 exchanges, Solana and EVM DEX trading, token launches and Bittensor mining. The README was written for a Colosseum hackathon and reads like it.
What it does
The README's venue table lists trading support on Polymarket, Kalshi, Betfair, Smarkets, Drift, Opinion.xyz and Predict.fun, with data-only access to Manifold, Metaculus, PredictIt and AgentBets. It supports limit and market orders, maker rebates, real-time order books, P&L tracking and smart routing.
A unified risk engine covers a circuit breaker, VaR and CVaR, volatility regime detection, stress testing, Kelly sizing, daily loss limits and a kill switch. A trade ledger logs every decision with reasoning and optional SHA-256 hashes.
- npm install -g clodds, then clodds onboard
- Polymarket crypto rounds: 5-minute (BTC only), 15-minute, 1-hour, 4-hour and daily, with 4 automated strategies
- 119 bundled skills exposed as MCP tools for Claude Desktop and Claude Code
- 8 LLM providers: Claude primary, plus GPT-4, Gemini, Groq, Together, Fireworks, Bedrock, Ollama
Strategy
Arbitrage detection follows arXiv:2508.03474 and covers internal (YES plus NO under $1), cross-platform (Polymarket versus Kalshi spreads) and combinatorial cases with semantic matching, liquidity scoring and Kelly sizing. The README notes it defaults to dry-run and that cross-platform has currency and settlement complexity.
Built-in bot strategies are mean reversion, momentum, arbitrage and market making. Copy trading mirrors wallets with sizing controls and stop-loss and take-profit. The summary table at the bottom counts 4 trading strategies, while a badge near the top says 118+.
Setup and requirements
Node.js 22 or newer and TypeScript. ANTHROPIC_API_KEY is required. Venue credentials such as POLYMARKET_API_KEY and SOLANA_PRIVATE_KEY go in .env, and credentials are stored AES-256-GCM encrypted under ~/.clodds/ with a SQLite database.
Shell commands run sandboxed and need approval. Docker Compose is supported.
Activity and maintenance
901 stars and 175 forks as of 2026-09-08. Created 2026-01-26, last push 2026-09-01, 29 open issues. MIT licensed. The homepage cloddsbot.com returned 200 on the check date.
The README claims 10,746 clones in 14 days via a screenshot. That is the project's own number.
Where it falls short
Scope. The same README that documents Kalshi order placement also documents a Solana token launch endpoint, an agent marketplace with USDC escrow and a memecoin contract address. A trader who wants only the prediction-market piece inherits all of it.
There is no profit claim, and the README's numbers about itself (skills, strategies, markets) do not agree with each other. Expect to read source before trusting a strategy with size.
Who should use it
Developers who want a conversational agent over many venues and are comfortable auditing a large TypeScript codebase. Also anyone who wants Polymarket and Kalshi exposed as MCP tools to Claude.
Not for a one-strategy operator who wants a small, readable bot.
Questions about CloddsBot
Is CloddsBot free?
The software is MIT licensed. You supply an Anthropic API key and venue credentials. The project also sells compute and token-launch API calls in USDC, which are optional.
Does CloddsBot trade on Kalshi?
Yes. Kalshi is listed with trading support alongside Polymarket, Betfair, Smarkets, Drift, Opinion.xyz and Predict.fun.
Is CloddsBot legit?
It is a real, actively pushed open-source repo with 901 stars as of 2026-09-08. It makes no profit claims. It also promotes its own token, which you can ignore.
Does CloddsBot execute trades automatically?
It can. Arbitrage defaults to dry-run and shell commands need approval; live order placement is a configuration choice.
Bots die in execution. Terminals are execution.
Wanted a bot for speed and cross-venue vision? The free Kairos terminal trades Kalshi, Polymarket and Predict.fun from one book, no keys to manage.