Repolode
alsk1992

alsk1992/CloddsBot

Self-hosted, Claude-powered trading terminal for prediction markets, crypto and perpetual futures, driven by chat.

Stars
3,078
Forks
388
Open issues
40
Last commit
last month

Repolode describes open-source projects and does not give investment advice. Trading and investing can lose money: assess the risk yourself and follow the laws where you live before using this project.

What is it?

Clodds is a self-hosted trading terminal that runs on your own machine and takes instructions through chat. It covers prediction markets such as Polymarket and Kalshi, crypto spot trading, and perpetual futures on exchanges including Binance, Bybit and Hyperliquid, with Claude as the underlying AI.

On the on-chain side it integrates Solana DEXs and protocols such as Jupiter, Raydium and Pump.fun, plus EVM DEXs on Ethereum, Base, Arbitrum, Optimism and Polygon. Messaging support spans 21 platforms, and a built-in WebChat interface runs locally.

Risk tooling includes a circuit breaker, Kelly sizing, daily loss limits and a kill switch, alongside backtesting, arbitrage scanning, whale tracking and copy trading. Arbitrage defaults to dry-run mode, and the skills can be exposed as an MCP server for Claude Desktop and Claude Code.

Key features

  • 01Trades Polymarket, Kalshi, Betfair and other prediction markets, plus crypto spot and futures.
  • 02Chat interface across 21 messaging platforms, with a built-in local WebChat.
  • 03Solana and EVM DeFi execution through Jupiter, Uniswap, 1inch and similar protocols.
  • 04Risk controls including circuit breaker, Kelly sizing, daily loss limits and kill switch.
  • 05Backtesting, arbitrage detection, whale tracking and copy trading tools.
  • 06Exposes its skills as an MCP server for Claude Desktop and Claude Code.

Use cases

  • Running automated prediction market strategies on short-interval crypto price markets.
  • Monitoring and trading across several perpetual futures exchanges from one chat interface.
  • Experimenting with arbitrage detection between prediction markets in dry-run mode.
  • Giving Claude Desktop or Claude Code access to trading tools via MCP.

Quick start

  1. 1

    Install the current release from GitHub (requires Node.js 22+)

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

    Run the setup wizard, which configures the API key and messaging channel and starts the gateway

    clodds onboard

Things to know

  • Requires Node.js 22 or newer; Node.js 20 is not supported.
  • Needs an Anthropic API key (Claude) to power the AI features.
  • The old npmjs.com clodds package is unmaintained, so you must install from GitHub releases.
  • Trading involves real financial risk, and cross-platform arbitrage has currency and settlement complexity.

In collections

Topics

FAQ

What is CloddsBot?
Self-hosted, Claude-powered trading terminal for prediction markets, crypto and perpetual futures, driven by chat. Clodds is a self-hosted trading terminal that runs on your own machine and takes instructions through chat. It covers prediction markets such as Polymarket and Kalshi, crypto spot trading, and perpetual futures on exchanges including Binance, Bybit and Hyperliquid, with Claude as the underlying AI.
Is CloddsBot free to use? What license does it have?
CloddsBot is open source under the MIT license. Check the license terms before using it in commercial products.
Is CloddsBot still maintained?
Updated within 6 months. The last commit to CloddsBot was on Oct 2, 2026.
What can I use CloddsBot for?
Running automated prediction market strategies on short-interval crypto price markets. Monitoring and trading across several perpetual futures exchanges from one chat interface. Experimenting with arbitrage detection between prediction markets in dry-run mode. Giving Claude Desktop or Claude Code access to trading tools via MCP.
How do I install CloddsBot?
Install the current release from GitHub (requires Node.js 22+): npm install -g https://github.com/alsk1992/CloddsBot/releases/latest/download/clodds.tgz --loglevel=error Run the setup wizard, which configures the API key and messaging channel and starts the gateway: clodds onboard
Where can I get CloddsBot?
The source code and installation instructions are on GitHub: https://github.com/alsk1992/CloddsBot

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects