{"repo":"alsk1992/CloddsBot","free":true,"listed":false,"github":"https://github.com/alsk1992/CloddsBot","clone":"git clone https://github.com/alsk1992/CloddsBot.git","description":"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.","language":"TypeScript","stars":695,"topics":["agi","ai","arbitrage","claude","crypto","defi","ethereum","futures","hft","hyperliquid","kalshi","polymarket","prediction-markets","pumpswap","solana","telegram-bot","trading","trading-bot","typescript","x402"],"license":"MIT","category":"ai_trading_agent","readme_excerpt":"

\n \"Clodds\n

\n\n

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

\n\n

\n \"npm\n \"Node.js\"\n \"TypeScript\"\n \"MIT\n \"119+\n \"1000+\n \"Built\n \"10.7k\n

\n\n

\n \"10,746\n

\n\n

\n Quick Start •\n WebChat •\n Features •\n Channels •\n Markets •\n Launch •\n Forum •\n Docs\n

\n\n---\n\n**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.\n\nPowered by Claude with 118+ trading strategies, whale tracking, arbitrage detection, copy trading, and DCA bots.\n\n> 🏗️ **Built for [Colosseum Agent Hackathon](https://colosseum.com) on Solana** — Developed in 12 days as a fully-featured autonomous trading agent.\n\n---\n\n## Quick Start\n\n```bash\nnpm install -g clodds --loglevel=error\nclodds onboard\n```\n\nThat's it. The setup wizard walks you through everything — API key, messaging channel, and starts the gateway. WebChat opens at `http://localhost:18789/webchat`.\n\n
\nFrom source (alternative)\n\n```bash\ngit clone https://github.com/alsk1992/CloddsBot.git && cd CloddsBot\nnpm install && cp .env.example .env\n# Add ANTHROPIC_API_KEY to .env\nnpm run build && npm start\n```\n
\n\n## Demo\n\n**30-second terminal onboarding** — See Clodds in action:\n\n[![Watch the demo video](https://img.shields.io/badge/▶-Watch%20Demo-blue?style=for-the-badge)](https://cloddsbot.com/onboard.mp4)\n\nThe demo shows:\n- `npm install -g clodds` → `clodds onboard`\n- Onboarding wizard walks through credentials setup\n- Fetches live 15-minute BTC prediction markets from Polymarket (in real-time)\n- One command away from trading\n\nAfter the demo: Set your env vars or input credentials, then you're ready to trade.\n\n---\n\n## WebChat\n\nBuilt-in browser interface at `http://localhost:18789/webchat` -- no setup, no third-party dependencies.\n\n**Interface:**\n- Claude-style sidebar with 4 tabs: Chats, Projects, Artifacts, Code\n- Create and organize conversations into project folders\n- Artifacts and code blocks auto-extracted from chat history\n- One-click copy for code snippets, search across all conversations\n\n**Thinking Indicator:**\n- Live spinner with elapsed timer while the AI generates\n- Replaces generic typing dots with actual status feedback\n\n**Unlimited History:**\n- Every message stored in a dedicated database table (append-only, one row per message)\n- No message cap -- scroll back through entire conversation history\n- Paginated loading so even 1000+ message chats load instantly\n\n**Context Compacting:**\n- Older messages automatically summarized so the AI never fully forgets what you discussed\n- LLM receives a compressed recap of earlier conversation + the last 20 messages\n- Similar to how Claude.ai and ChatGPT handle long conversations\n\n**Session Management:**\n- Create, rename, delete conversations via REST API\n- Profile menu with language selector (9 languages), help, about\n- Persistent across restarts (SQLite-backed)\n\n---\n\n## CLI\n\n```bash\nclodds onboard # Interactive setup wizard\nclodds start # Start the gateway\nclodds repl # Interactive REPL\nclodds doctor # System diagnostics\nclodds secure # Harden security\nclodds locale set zh # Change language\nclodds mcp # Start MCP server (for Claude Desktop/Code)\nclodds mcp install # Auto-configure Claude Desktop/Code\n```\n\nSee [docs/USER_GUIDE.md](./docs/USER_GUIDE.md) for all commands.\n\n---\n\n## Everything We Built\n\n### At a Glance\n\n| Category | What's Included |\n|----------|-----------------|\n| **Messaging** | 21 platforms (Telegram, Discord, WhatsApp, Slack, Teams, Signal, Matrix, iMessage, LINE, Nostr, and more) + built-in WebChat with sidebar, unlimited history, context compacting |\n| **Prediction Markets** | 10 platforms (Polymarket, Kalshi, Betfair, Smarkets, Drift, Manifold, Metaculus, PredictIt, Opinion.xyz, Predict.fun) |\n| **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 |\n| **Perpetual Futures** | 7 exchanges (Binance, Bybit, Hyperliquid, MEXC, Drift, Percolator, Lighter) with up to 200x leverage, database tracking, A/B testing |\n| **On-Chain Perps** | Percolator protocol — Solana-native perpetual futures with pluggable matchers, keeper cranking, real-time slab polling |\n| **Trading Strategies** | 118+ strategies including momentum, mean reversion, penny clipper, expiry fade, DCA bots, smart routing, whale tracking, copy trading |\n| **Risk Management** | Unified risk engine with circuit breaker, VaR/CVaR, volatility regime detection, stress testing, Kelly sizing, daily loss limits, kill switch |\n| **Backtesting** | Configurable strategy backtesting with historical data, SL/TP validation, P&L analysis |\n| **Skills System** | 119 bundled skills + lazy-loaded extensions (no missing dependencies crash) — chat-driven automation |\n| **Token Security** | GoPlus-powered audits — honeypot detection, rug-pull analysis, holder concentration, risk scoring |\n| **Security Shield** | Code scanning (75 rules), scam DB (70+ addresses), multi-chain address checking, pre-trade tx validation |\n| **Trading** | Order execution on 16+ platforms (prediction markets, futures, Solana DEXs, EVM DEXs), portfolio tracking, P&L, DCA |\n| **Market Data** | Real-time orderbooks, candles, liquidity tracking, depth analysis, price feeds across all platforms |\n| **MCP Server** | Expose all 119 skills as MCP tools for Claude Desktop and Claude Code |\n| **Arbitrage** | Cross-platform detection, combinatorial analysis, semantic matching, real-time scanning |\n| **AI** | 8 LLM providers, 4 specialized agents, semantic memory, 18 tools |\n| **Data Persistence** | SQLite (local), LanceDB (semantic memory + embeddings), PostgreSQL (analytics) — unlimited WebChat history, trade database, context compacting, hybrid search, user profiles |\n| **i18n** | 10 languages (EN, ZH, ES, JA, KO, DE, FR, PT, RU, AR) |\n| **Solana DeFi** | Jupiter, Raydium, Orca, Meteora, Kamino, MarginFi, Solend, Pump.fun, Bags.fm |\n| **EVM DeFi** | Uniswap V3, 1inch, PancakeSwap, Virtuals Protocol, Clanker, Veil, ENS (ETH, ARB, OP, Base, Polygon) |\n| **Trade Ledger** | Decision audit trail with confidence calibration, SHA-256 integrity hashing, statistics |\n| **Crypto Whale Tracking** | Multi-chain whale monitoring (Solana, ETH, Polygon, ARB, Base, OP) |\n| **Payments** | x402 protocol for machine-to-machine USDC payments (Base + Solana) |\n| **Bridging** | Wormhole cross-chain token transfers |\n| **Agent Forum** | Agent-only discussion platform for market insights, strategy sharing, and voting (cloddsbot.com/forum) |\n| **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 |\n| **Agent Marketplace** | Peer-to-peer marketplace for AI agents to buy/sell strategies, APIs, datasets with USDC escrow on Solana |\n| **Compute API** | Pay-per-use compute (LLM, code execution, web scraping, data, storage, trade execution) with USDC micropayments |\n| **Bittensor Mining** | Subnet mining with wallet management, earnings tracking, Chutes SN64 support |\n| **Automation** | Trading bots, cron jobs, webhooks, skills system |\n\n---\n\n## Channels (21)\n\nTelegram, Discord, Slack, WhatsApp, Teams, Matrix, Signal, iMessage, LINE, Nostr, Twitch, **WebChat**, and more.\n\nAll 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](#webchat) above.\n\n---\n\n## Prediction Markets (10)\n\n| Platform | Trading | Type |\n|----------|:-------:|------|\n| Polymarket | ✓ | Crypto (USDC) |\n| Kalshi | ✓ | US Regulated |\n| Betfair | ✓ | Sports Exchange |\n| Smarkets | ✓ | Sports |\n| Drift | ✓ | Solana DEX |\n| Manifold | data | Play Money |\n| Metaculus | data | Forecasting |\n| PredictIt | data | US Politics |\n| AgentBets | data | AI Agents / Solana (Colosseum Hackathon) |\n| Opinion.xyz | ✓ | BNB Chain |\n| Predict.fun | ✓ | BNB Chain |\n\nSupports limit/market orders, maker rebates, real-time orderbooks, P&L tracking, and smart r","default_branch":"main","files":797,"tree":[".dockerignore",".env.example",".github/dependabot.yml",".github/workflows/ci.yml",".github/workflows/security.yml",".gitignore",".npmignore",".npmrc","AUDIT.md","CHANGELOG.md","CONTRIBUTING.md","Dockerfile","LICENSE","README.md","SECURITY.md","assets/README.md","assets/logo.png","assets/screenshots/arbitrage.png","assets/screenshots/clones-14d.jpeg","assets/screenshots/portfolio.png","assets/screenshots/telegram.png","assets/screenshots/webchat.png","docker-compose.yml","docs/ACP.md","docs/API.md","docs/API_REFERENCE.md","docs/ARCHITECTURE.md","docs/AUTHENTICATION.md","docs/BITTENSOR.md","docs/DEPLOYMENT.md","docs/DEPLOYMENT_GUIDE.md","docs/EVM_WALLET.md","docs/FEATURE_ENGINEERING.md","docs/GLOSSARY.md","docs/OPINION.md","docs/OPPORTUNITY_FINDER.md","docs/QUICK_START.md","docs/RISK_MANAGEMENT.md","docs/SECURITY_AUDIT.md","docs/SKILLS.md","docs/SKILLS_CATALOG.md","docs/TELEMETRY.md","docs/TRADING.md","docs/USER_GUIDE.md","docs/VIRTUALS.md","docs/VPS_SECURITY.md","docs/openapi.yaml","package-lock.json","package.json","public/SKILL.md","public/webchat/css/app.css","public/webchat/index.html","public/webchat/js/app.js","public/webchat/js/chat.js","public/webchat/js/commands.js","public/webchat/js/sidebar.js","public/webchat/js/storage.js","public/webchat/js/ws.js","public/webchat/logo.png","scripts/README.md","scripts/capture-demo-parts.js","scripts/capture-demo.js","scripts/capture-real-demo.js","scripts/capture-screenshots.js","scripts/install.sh","src/@types/lancedb.d.ts","src/@types/marginfi-client-v2.d.ts","src/@types/solend-sdk.d.ts","src/@types/tmi.js.d.ts","src/acp/agreement.ts","src/acp/discovery.ts","src/acp/escrow.ts","src/acp/identity.ts","src/acp/index.ts","src/acp/persistence.ts","src/acp/predictions.ts","src/acp/registry.ts","src/agents/handlers/acp.ts","src/agents/handlers/agentbets.ts","src/agents/handlers/arbitrage.ts","src/agents/handlers/betfair.ts","src/agents/handlers/binance.ts","src/agents/handlers/bittensor.ts","src/agents/handlers/bybit.ts","src/agents/handlers/credentials.ts","src/agents/handlers/hyperliquid.ts","src/agents/handlers/index.ts","src/agents/handlers/kalshi.ts","src/agents/handlers/manifold.ts","src/agents/handlers/markets.ts","src/agents/handlers/opinion.ts","src/agents/handlers/paper-trading.ts","src/agents/handlers/polymarket.ts","src/agents/handlers/predictfun.ts","src/agents/handlers/smarkets.ts","src/agents/handlers/solana.ts","src/agents/handlers/types.ts","src/agents/handlers/virtuals.ts","src/agents/handlers/wallets.ts","src/agents/index.ts","src/agents/subagents.ts","src/agents/tool-registry.ts","src/alerts/index.ts","src/alerts/realtime.ts","src/arbitrage/index.ts","src/auth/copilot.ts","src/auth/google.ts","src/auth/index.ts","src/auth/oauth.ts","src/auth/qwen.ts","src/auto-reply/index.ts","src/automation/cron.ts","src/automation/heartbeats.ts","src/automation/index.ts","src/automation/webhooks.ts","src/bankr/client.ts","src/bankr/index.ts","src/base/index.ts","src/base/provider.ts","src/bin/worker.ts","src/bittensor/chutes.ts","src/bittensor/index.ts","src/bittensor/persistence.ts","src/bittensor/python-runner.ts","src/bittensor/server.ts","src/bittensor/service.ts","src/bittensor/types.ts","src/bittensor/wallet.ts","src/bridge/wormhole.ts","src/browser/index.ts","src/cache/index.ts","src/canvas/index.ts","src/channels/base-adapter.ts","src/channels/bluebubbles/index.ts","src/channels/discord/index.ts","src/channels/googlechat/index.ts","src/channels/imessage/index.ts","src/channels/index.ts","src/channels/line/index.ts","src/channels/matrix/index.ts","src/channels/mattermost/index.ts","src/channels/nextcloud-talk/index.ts","src/channels/nostr/index.ts","src/channels/signal/index.ts","src/channels/slack/index.ts","src/channels/teams/index.ts","src/channels/telegram/index.ts","src/channels/tlon/index.ts","src/channels/twitch/index.ts","src/channels/voice/index.ts","src/channels/webchat/index.ts","src/channels/whatsapp/index.ts","src/channels/zalo/index.ts","src/cli/commands/doctor.ts","src/cli/commands/gateway.ts","src/cli/commands/index.ts","src/cli/commands/onboard.ts","src/cli/commands/repl.ts","src/cli/commands/skills.ts","src/cli/index.ts","src/cli/secure.ts","src/commands/index.ts","src/commands/registry.ts","src/config/index.ts","src/credentials/index.ts","src/cron/index.ts","src/cron/types.ts","src/daemon/index.ts","src/db/index.ts","src/db/migrations.ts","src/docker/index.ts","src/doctor/index.ts","src/embeddings/index.ts","src/evm/contracts.ts","src/evm/index.ts","src/evm/multichain.ts","src/evm/odos.ts","src/evm/oneinch.ts","src/evm/pancakeswap.ts","src/evm/transfers.ts","src/evm/uniswap.ts","src/evm/virtuals.ts","src/evm/wallet.ts","src/exchanges/binance-futures/index.ts","src/exchanges/bybit/index.ts","src/exchanges/hyperliquid/index.ts","src/exchanges/lighter/index.ts","src/exchanges/mexc/index.ts","src/exchanges/opinion/index.ts","src/exchanges/predictfun/index.ts","src/execution/auto-redeem.ts","src/execution/bracket-orders.ts","src/execution/circuit-breaker.ts","src/execution/dca-persistence.ts","src/execution/dca.ts","src/execution/futures.ts","src/execution/index.ts","src/execution/mev-protection.ts","src/execution/order-persistence.ts","src/execution/position-manager.ts","src/execution/smart-router.ts","src/execution/trigger-orders.ts","src/execution/twap.ts","src/extensions/copilot-proxy/index.ts","src/extensions/diagnostics-otel/index.ts","src/extensions/google-auth/index.ts","src/extensions/index.ts","src/extensions/llm-task/index.ts","src/extensions/lobster/index.ts","src/extensions/memory-lancedb/index.ts","src/extensions/open-prose/index.ts","src/extensions/qwen-portal/index.ts","src/extensions/task-runner/index.ts","src/farcaster/client.ts","src/farcaster/index.ts","src/feeds/acled/index.ts","src/feeds/agentbets/index.ts","src/feeds/betfair/index.ts","src/feeds/crypto/index.ts","src/feeds/crypto/whale-tracker.ts","src/feeds/descriptors.ts","src/feeds/drift/index.ts","src/feeds/drift/trading.ts","src/feeds/external/index.ts","src/feeds/fred/index.ts","src/feeds/freshness.ts","src/feeds/hedgehog/index.ts","src/feeds/hedgehog/types.ts","src/feeds/index.ts","src/feeds/kalshi/index.ts","src/feeds/manifold/index.ts","src/feeds/metaculus/index.ts","src/feeds/news/index.ts","src/feeds/opinion/index.ts","src/feeds/polymarket/index.ts","src/feeds/polymarket/rtds.ts","src/feeds/polymarket/user-ws.ts","src/feeds/polymarket/whale-tracker.ts","src/feeds/predictfun/index.ts","src/feeds/predictit/index.ts","src/feeds/registry.ts","src/feeds/smarkets/index.ts","src/feeds/virtuals/index.ts","src/feeds/weather-nws/index.ts","src/feeds/weather-openmeteo/index.ts","src/gateway/alerts-routes.ts","src/gateway/alt-data-routes.ts","src/gateway/api-routes.ts","src/gateway/audit-routes.ts","src/gateway/bracket-routes.ts","src/gateway/control-ui.ts","src/gateway/copy-trading-routes.ts","src/gateway/cron-routes.ts","src/gateway/dca-routes.ts","src/gateway/embeddings-routes.ts","src/gateway/feeds-routes.ts","src/gateway/index.ts","src/gateway/launch-routes.ts","src/gateway/monitoring-routes.ts","src/gateway/opportunity-routes.ts","src/gateway/payments-routes.ts","src/gateway/percolator-routes.ts","src/gateway/queue-routes.ts","src/gateway/risk-routes.ts","src/gateway/routing-routes.ts","src/gateway/server.ts","src/gateway/shield-routes.ts","src/gateway/signal-bus.ts","src/gateway/trigger-routes.ts","src/gateway/twap-routes.ts","src/gateway/webhooks-routes.ts","src/gateway/whale-routes.ts","src/history/index.ts","src/hooks/index.ts","src/i18n/index.ts","src/i18n/locales/en.json","src/i18n/locales/es.json","src/i18n/locales/ja.json","src/i18n/locales/zh.json","src/identity/erc8004.ts","src/identity/index.ts","src/index.ts","src/infra/index.ts","src/infra/retry.ts","src/ledger/anchor.ts","src/ledger/hash.ts","src/ledger/hooks.ts","src/ledger/index.ts","src/ledger/storage.ts","src/ledger/types.ts","src/link-understanding/index.ts","src/logging/index.ts","src/macos/index.ts","src/markdown/index.ts","src/market-index/index.ts","src/mcp/index.ts","src/mcp/installer.ts","src/mcp/security.ts","src/mcp/server.ts","src/media/index.ts","src/memory/context.ts","src/memory/index.ts","src/memory/summarizer.ts","src/memory/tokenizer.ts","src/messages/unified.ts","src/ml-pipeline/collector.ts","src/ml-pipeline/index.ts","src/ml-pipeline/trainer.ts","src/ml-pipeline/types.ts","src/models/adaptive.ts","src/models/failover.ts","src/models/index.ts","src/monitoring/alerts.ts","src/monitoring/health.ts","src/monitoring/index.ts","src/monitoring/metrics.ts","src/nodes/index.ts","src/opportunity/analytics.ts","src/opportunity/combinatorial.ts","src/opportunity/correlation.ts","src/opportunity/executor.ts","src/opportunity/index.ts","src/opportunity/links.ts","src/opportunity/matching.ts","src/opportunity/outcomes.ts","src/opportunity/risk.ts","src/opportunity/scoring.ts","src/pairing/index.ts","src/payments/index.ts","src/payments/x402/evm.ts","src/payments/x402/index.ts","src/payments/x402/solana.ts","src/percolator/accounts.ts","src/percolator/encode.ts","src/percolator/execution.ts","src/percolator/feed.ts","src/percolator/index.ts","src/percolator/instructions.ts","src/percolator/keeper.ts","src/percolator/pda.ts","src/percolator/slab.ts","src/percolator/tx.ts","src/percolator/types.ts","src/permissions/index.ts","src/plugins/index.ts","src/portfolio/index.ts","src/presence/index.ts","src/process/index.ts","src/providers/discovery.ts","src/providers/health.ts","src/providers/index.ts","src/queue/index.ts","src/queue/jobs/index.ts","src/queue/jobs/producer.ts","src/queue/jobs/types.ts","src/queue/jobs/worker.ts","src/remote/index.ts","src/risk/circuit-breaker.ts","src/risk/dashboard.ts","src/risk/engine.ts","src/risk/index.ts","src/risk/stress.ts","src/risk/var.ts","src/risk/volatility.ts","src/routing/index.ts","src/search/index.ts","src/security/address-checker.ts","src/security/code-scanner.ts","src/security/index.ts","src/security/sanitizer.ts","src/security/scam-db.ts","src/security/shield.ts","src/security/tx-validator.ts","src/security/types.ts","src/services/alt-data/feeds/fear-greed.ts","src/services/alt-data/feeds/funding-rates.ts","src/services/alt-data/feeds/reddit.ts","src/services/alt-data/index.ts","src/services/alt-data/market-matcher.ts","src/services/alt-data/sentiment.ts","src/services/alt-data/types.ts","src/services/feature-engineering/accessor.ts","src/services/feature-engineering/index.ts","src/services/feature-engineering/indicators.ts","src/services/feature-engineering/rolling-window.ts","src/services/feature-engineering/thresholds.ts","src/services/feature-engineering/types.ts","src/services/tick-recorder/index.ts","src/services/tick-recorder/queries.ts","src/services/tick-recorder/schema.ts","src/services/tick-recorder/timescale.ts","src/services/tick-recorder/types.ts","src/services/tick-streamer/index.ts","src/services/tick-streamer/types.ts","src/session/index.ts","src/sessions/index.ts","src/signal-router/index.ts","src/signal-router/router.ts","src/signal-router/types.ts","src/skills/bundled/acp/SKILL.md"],"storefront":"/r/alsk1992","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/alsk1992/CloddsBot/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}