Clodds: A Claude-powered autonomous terminal for prediction markets and crypto trading
A self-hosted Claude terminal for prediction markets, crypto, and futures, operated through 21 messaging channels.
GitHub alsk1992/CloddsBot Updated 2026-09-11 Branch main Stars 1.6K Forks 256
TypeScript AI trading agent Claude Polymarket Solana Self-hosted

🧭 Decision Guide

Try it if you

  • You want to run Claude on your own machine, connect to Polymarket, and start with live 15-minute BTC markets.
    The README Quick Start and Demo sections provide npm install -g clodds, clodds onboard, and live 15-minute BTC prediction markets from Polymarket.
  • Your team uses TypeScript and needs connections across Solana, EVM, and perpetual futures venues.
    The project stack includes TypeScript; the Architecture section lists Jupiter, Raydium, Uniswap V3, Binance, Bybit, and Hyperliquid.
  • You want to operate a risk-controlled trading agent through Telegram, Discord, or WebChat.
    The Architecture section lists 21 Messaging Channels; Advanced Trading lists VaR/CVaR, circuit breaker, Kelly sizing, and kill switch.

Skip it if you

  • You cannot provide ANTHROPIC_API_KEY or do not want to manage trading private keys.
    The Configuration section marks ANTHROPIC_API_KEY as Required and lists SOLANA_PRIVATE_KEY; Quick Start says the wizard configures the API key.
  • Your business cannot accept up to 200x leverage, automated execution, or liquidation risk.
    The Architecture section lists Binance 125x, Bybit 100x, MEXC 200x, and liquidation monitoring.
  • You require a mature trading system with a published Node version, test coverage, or third-party security audit.
    The provided README material does not specify a Node version, test coverage, or third-party security audit; the project has 4 contributors.

Requirements

  • Install the npm package: the README Quick Start gives npm install -g clodds --loglevel=error.
  • Run clodds onboard; the README says the wizard configures the API key, messaging channel, and gateway.
  • Provide ANTHROPIC_API_KEY; the Configuration section marks it as Required.
  • For Solana trading, configure SOLANA_PRIVATE_KEY; the Configuration section lists this variable.
  • Data is stored by default under ~/.clodds/, including an automatically created SQLite database.
  • WebChat opens by default at http://localhost:18789/webchat.

First step (verbatim from README)

npm install -g clodds --loglevel=error

Watch out

  • Do not treat up to 200x leverage as a low-risk default; the Architecture explicitly lists MEXC 200x and Percolator up to 200x.
    The README Architecture sections for Perpetual Futures and On-chain Perps.
  • Credentials are stored under the local ~/.clodds/ data directory, so account for the location of SOLANA_PRIVATE_KEY.
    The Configuration section states that data is stored under ~/.clodds/ and lists SOLANA_PRIVATE_KEY.
  • Some skills are lazy-loaded on first use; the README says missing dependencies do not crash the app, and /skills shows their status.
    The Skills & Extensions section describes 118 bundled skills, lazy loading, and the /skills command.
  • Shell commands are not executed without approval; the README explicitly requires sandboxed execution and approval for shell commands.
    The README bullet list and Security section.

Not stated in the README

  • The supported operating systems and Node.js version are not specified in the provided README material.
  • Claude API costs, venue fees, and data-service costs are not specified.
  • Which of the 118+ strategies are enabled by default, and whether live trading is the default, are not specified.
  • The scope of exchange API permissions and whether private keys ever leave the local machine are not specified.
  • The complete credential application process for Polymarket, Kalshi, Binance, and other venues is not specified.
  • Default parameters and trigger behavior for VaR/CVaR, circuit breaker, and kill switch are not specified.
  • Backtest data sources, reproducibility, and differences between backtesting and live trading are not specified.
  • Whether SQLite, LanceDB, and PostgreSQL are all required is not specified.
  • Docker deployment, production topology, and backup/recovery procedures are not specified in the provided sections.
  • Independent security audits, vulnerability response, and maintenance commitments are not specified.

💡 Deep Analysis

6
Yes I cannot monitor markets continuously. I want alerts for Polymarket and perpetual futures through Telegram, Discord, and WebChat, with Claude explaining opportunities. Does CloddsBot fit this interaction model?
For: An individual trader who needs to manage Polymarket and perpetual-futures alerts through Telegram, Discord, and WebChat instead of continuously watching a professional terminal.

Yes, as a conversational research and alerting interface, but not as a substitute for validated trading signals.

  • The README supports Telegram, Discord, WebChat, and other channels—21 in total—and provides Main, Trading, Research, and Alerts agents, matching the desired separation of research, execution, and notifications.
  • WebChat requires no third-party dependency, stores messages in SQLite, supports unlimited history and pagination, and compacts context. This is useful for reviewing long-running market discussions.
  • External data includes FedWatch, 538, Silver Bulletin, RCP, and Odds API, while bundled skills include arbitrage detection, edge finding, and whale tracking.
  • However, the README does not specify alert latency, deduplication, channel rate limits, Claude explanation accuracy, or whether critical alerts remain reliable during network outages.

It can reduce information-screening effort, but the available material does not establish an exchange-grade real-time alert SLA.

  • README Channels: Telegram, Discord, WebChat; “21 messaging platforms”
  • README AI System: four agents, including Research and Alerts
  • README WebChat: SQLite, Unlimited History, and Context Compacting
  • README Advanced Trading: External Data, Arbitrage Detection, and Whale Tracking
clodds onboard
Not stated in the README:The README does not define alert latency, message retries, deduplication, or offline-queue recovery semantics across channels.;It provides no accuracy, false-positive, or availability metrics for the Research or Alerts agents.
It depends I need to run Polymarket, Binance, and Solana DEX integrations on my own machine and query or execute trades through Telegram. Is CloddsBot suitable for me?
For: A self-hosted individual trader who uses Polymarket, Binance, and Solana DEXs and wants to manage trades through Telegram.

It depends: CloddsBot fits a technical trader who wants one self-hosted control surface, but not someone who treats natural-language commands as risk-free order instructions.

  • The README explicitly supports self-hosting, Telegram, and 21 messaging platforms; WebChat also runs locally.
  • It covers Polymarket, Binance, and Solana components such as Jupiter, Raydium, and Orca, reducing the need to operate separate clients.
  • AES-256-GCM credential encryption, trade audit logs, a unified risk engine, circuit breakers, and a kill switch are included. However, the user remains responsible for API permissions, private keys, RPC endpoints, and the host.
  • Claude handles natural-language interaction, but the README does not establish that intent is always interpreted correctly, on-chain transactions always succeed, or returns are reliable.

It is therefore closer to a self-hosted trading terminal than a managed trading service.

  • README: self-hosted; “21 messaging platforms”
  • README: Polymarket, Binance, Jupiter, Raydium, and Orca
  • README Security: AES-256-GCM and audit logging for all trades
  • README Advanced Trading: unified risk engine and kill switch
npm install -g clodds --loglevel=error
Not stated in the README:The README does not state whether Telegram commands require confirmation by default or how granular permissions are.;It does not specify order-type coverage, retry behavior, or regional availability for each current adapter.
It depends I build agents in TypeScript and want to use x402 USDC payments to call the Compute API's LLM, code, data, and trade services. Is CloddsBot suitable as agent-economy infrastructure?
For: A TypeScript developer who wants to connect AI agents to x402 USDC payments, the Compute API, and the Marketplace rather than deploying only a personal trading terminal.

It depends: CloddsBot exposes agent payments and compute services, but the README does not provide enough security and operational detail to classify it as production-grade payment infrastructure.

  • The README exposes a Compute API with llm, code, web, data, storage, and trade services. Its payment flow uses USDC sent to a Base treasury wallet plus payment proof.
  • The project description explicitly includes machine-to-machine payments, and the README also lists Agent Forum, Agent Marketplace, and Compute API, matching agent-economy use cases.
  • TypeScript is the main project language, and an MCP server is available for Claude Desktop/Code integration.
  • However, the README does not explain replay protection for payment proofs, refunds or disputes, service authentication, wallet custody responsibilities, quota isolation, or an API availability guarantee. The trade service also introduces real-market execution risk.

It is suitable for integration prototypes and agent workflows, but the README alone cannot establish payment security or regulatory readiness for production.

  • README Compute API: llm, code, web, data, storage, and trade
  • README Compute API: send USDC to a treasury wallet on Base and include payment proof
  • Project description: “Agent commerce protocol for machine-to-machine payments”
  • README CLI: clodds mcp and clodds mcp install
  • Project data: main_language is TypeScript
curl https://compute.cloddsbot.com/health
Not stated in the README:The README does not specify the x402 payment-proof format, validity period, replay protection, or settlement-confirmation rules.;It does not define Compute API authentication, quotas, SLA, refunds, data isolation, or compliance responsibilities.;It does not describe Marketplace review, commissions, malicious-skill handling, or version-compatibility policies.
Yes I maintain mean-reversion, momentum, arbitrage, and DCA strategies in TypeScript and want to reuse execution and risk controls across seven perpetual exchanges and prediction markets. Can CloddsBot serve as the strategy foundation?
For: A small quantitative team using TypeScript to maintain mean-reversion, momentum, arbitrage, and DCA strategies, requiring backtesting, live execution, and cross-platform risk limits.

Yes, as a strategy-orchestration and multi-market execution layer, but the README does not justify treating it as an institutional low-latency quantitative stack.

  • The README lists 118 skills, including arbitrage detection, DCA, exchange integrations, and automation. Lazy loading supports incremental strategy adoption.
  • Four agents are provided, including a Trading agent. The shared execution layer handles balance checks, slippage, fees, PnL, and settlement polling, which creates a basis for cross-platform reuse.
  • Risk controls include VaR/CVaR, stress testing, Kelly sizing, daily loss limits, circuit breakers, and a kill switch.
  • However, the README gives no matching-fidelity data for backtests, latency or throughput benchmarks, partial-fill semantics, or production SLA. TypeScript plus a Claude-driven agent is also not demonstrated to be suitable for extremely latency-sensitive HFT.

It fits a small team integrating strategies, but should not be treated as a replacement for a professional matching or ultra-low-latency execution system.

  • README Skills & Extensions: 118 bundled skills; strategies include Arbitrage detection and DCA
  • README AI System: four agents, including Trading
  • Project insight solution_analysis: shared execution handles balances, slippage, fees, PnL, and settlement
  • README Advanced Trading: VaR/CVaR, stress testing, Kelly sizing, daily loss limits, and kill switch
git clone https://github.com/alsk1992/CloddsBot.git && cd CloddsBot
Not stated in the README:The README does not state whether backtests accurately simulate fees, funding, slippage, latency, partial fills, and liquidation.;It provides no strategy API details, test-coverage figures, throughput data, or end-to-end latency benchmarks.
It depends I need to coordinate up to 20 wallets on Solana using Pump.fun and Jito Bundles, combined with whale tracking and copy trading. Is CloddsBot suitable for this execution scenario?
For: A developer using Solana, Pump.fun, and Jito Bundles for coordinated multi-wallet trading across 20 wallets.

It depends: the README directly targets this workflow, but reliability and compliance boundaries for high-risk on-chain execution still require validation.

  • The README explicitly lists Swarm Trading with 20 wallets, Pump.fun, and Jito bundles, so the use case is more than a generic marketing claim.
  • Solana integrations also include Jupiter, Raydium, Orca, and Bags.fm, while whale tracking and copy trading provide sizing controls and SL/TP.
  • Smart Routing can optimize for price, liquidity, or fees; security features include trade auditing, unified risk controls, and a kill switch.
  • However, the README does not explain multi-wallet private-key isolation, Jito bundle failure or replay handling, RPC latency, MEV outcomes, execution guarantees during congestion, or Pump.fun-specific regional and platform rules.

It is suitable for prototyping and strategy orchestration, but the available evidence is insufficient for deterministic atomic execution or provable wallet isolation.

  • README Advanced Trading: Swarm Trading; “20 wallets, Jito bundles”
  • README: Solana integration includes Jupiter, Pump.fun, Raydium, Orca, and Bags.fm
  • README Advanced Trading: Whale Tracking, Copy Trading, and Smart Routing
  • README Security: encrypted credentials and audit logging for all trades
clodds doctor
Not stated in the README:The README does not state whether credentials for the 20 wallets are isolated per wallet or whether hardware-wallet signing is supported.;It does not describe the state model for failed, partially confirmed, duplicated, or congested Jito bundles.
It depends I only need Polymarket, Kalshi, and perpetual futures with restricted APIs, and I do not want token launches, Bittensor mining, or multi-wallet Pump.fun features. Would CloddsBot be unnecessarily complex?
For: A security-sensitive user who only wants prediction-market and perpetual-futures trading with read-only or restricted APIs, without token launches, Bittensor mining, or multi-wallet Pump.fun features.

It depends: lazy loading can reduce initial complexity, but the project’s overall scope is substantially larger than your minimum requirement.

  • The README covers 10 prediction markets, seven futures exchanges, Solana, multiple EVM chains, token launches, and Bittensor subnet mining, so the capability surface is broad.
  • At the same time, 118 skills are lazy-loaded, and missing dependencies do not crash the application at startup. You can therefore limit initial use to Polymarket, Kalshi, and futures-related skills.
  • Security features include sandboxed execution, approval-required shell commands, AES-256-GCM credential encryption, and trade audit logs. The CLI also provides clodds secure, which aligns with restricted credentials.
  • However, the README does not provide a minimal installation profile, a least-privilege template, complete instructions for disabling unwanted modules, or proof that unused modules are fully removed from the runtime path.

It can work if you accept a broad self-hosted terminal; a specialized trading tool may fit better if you require a minimal and easily auditable system.

  • README: 10 prediction markets, seven futures exchanges, token launches, and Bittensor subnet mining
  • README Skills & Extensions: 118 bundled skills; “lazy-loaded on first use”
  • README Security: sandboxed execution, AES-256-GCM, and audit logging
  • README CLI: `clodds secure`
clodds secure
Not stated in the README:The README does not explain how to create a least-privilege configuration with read-only or trade-only permissions.;It does not state whether disabling skills, channels, and chain adapters removes their dependencies, ports, and background jobs from runtime.;It provides no security-audit, penetration-test, or credential-compromise response information.

✨ Highlights

  • Claude-powered, with 118+ trading strategies and 10 prediction markets
  • Supports 21 messaging platforms and 7 perpetual futures exchanges
  • Uses AES-256-GCM credential encryption and logs all trade audits
  • The architecture lists up to 200x leverage and automated liquidation monitoring

🔧 Engineering

  • Run clodds onboard to configure credentials, messaging channels, and the gateway
  • Fetches live 15-minute BTC prediction market data from Polymarket
  • Provides 118+ skills for arbitrage, copy trading, whale tracking, and DCA
  • Unifies access to Jupiter, Pump.fun, Uniswap V3, and Binance

⚠️ Risks

  • Configuration requires ANTHROPIC_API_KEY and potentially SOLANA_PRIVATE_KEY
  • The architecture includes up to 200x leverage, which can amplify execution losses
  • The project has 4 contributors, and the README says the hackathon version was built in 12 days
  • The README gives no Node version, test coverage, or security audit information

👥 For who?

  • Developers needing a self-hosted Claude trading terminal integrated with Polymarket
  • Teams using TypeScript and managing Solana or EVM trading integrations
  • Users who want to operate a trading agent through Telegram, Discord, or WebChat