{"_id":"@alsk1992/clodds","name":"@alsk1992/clodds","dist-tags":{"latest":"1.1.0"},"versions":{"1.1.0":{"name":"@alsk1992/clodds","version":"1.1.0","description":"AI trading terminal for 700+ markets. Prediction markets, crypto, futures up to 200x. 22 chat channels, arbitrage, whale tracking, copy trading, MEV protection. Built on Claude.","main":"dist/index.js","bin":{"clodds":"dist/cli/index.js"},"scripts":{"dev":"tsx watch src/index.ts","build":"tsc","start":"node dist/index.js","gateway":"tsx src/gateway/index.ts","worker":"tsx src/bin/worker.ts","onboard":"tsx src/cli/onboard.ts","typecheck":"tsc --noEmit","test":"node --test --import tsx --import ./tests/helpers/test-setup.ts tests/**/*.test.ts","ci":"npm run typecheck && npm run test && npm run build","prepublishOnly":"npm run build","publish:npm":"npm publish --registry https://registry.npmjs.org","publish:github":"npm publish --registry https://npm.pkg.github.com","publish:all":"npm run publish:npm && npm run publish:github"},"keywords":["trading","prediction-markets","polymarket","kalshi","betfair","agentbets","crypto","defi","futures","binance","solana","ethereum","arbitrage","whale-tracking","copy-trading","mev-protection","ai","claude","telegram-bot","discord-bot","trading-bot"],"author":{"name":"alsk1992"},"homepage":"https://cloddsbot.com","bugs":{"url":"https://github.com/alsk1992/CloddsBot/issues"},"engines":{"node":">=22.0.0"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/alsk1992/CloddsBot.git"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"dependencies":{"@anthropic-ai/sdk":"^0.73.0","@anthropic-ai/tokenizer":"^0.0.4","@coral-xyz/anchor":"^0.32.1","@drift-labs/sdk":"^2.156.0","@hapi/boom":"^10.0.1","@jup-ag/api":"^6.0.48","@jup-ag/dca-sdk":"^3.0.1","@jup-ag/limit-order-sdk":"^0.1.10","@kamino-finance/klend-sdk":"^2.13.10","@kamino-finance/kliquidity-sdk":"^6.5.1","@meteora-ag/dlmm":"^1.9.3","@meteora-ag/dynamic-bonding-curve-sdk":"^1.5.2","@noble/ed25519":"^2.3.0","@noble/hashes":"^1.8.0","@noble/secp256k1":"^3.0.0","@orca-so/whirlpool-sdk":"^0.4.2","@orca-so/whirlpools":"^6.0.0","@polkadot/api":"^14.3.1","@predictdotfun/sdk":"^1.2.8","@project-serum/anchor":"^0.26.0","@raydium-io/raydium-sdk-v2":"^0.2.32-alpha","@slack/bolt":"^3.17.1","@solana/spl-token":"^0.4.14","@solana/web3.js":"^1.98.4","@types/better-sqlite3":"^7.6.13","@types/bn.js":"^5.2.0","@types/figlet":"^1.7.0","@types/pg":"^8.16.0","@whiskeysockets/baileys":"^6.7.0","@wormhole-foundation/sdk":"^4.10.0","@wormhole-foundation/sdk-evm":"^4.9.1","@wormhole-foundation/sdk-evm-cctp":"^4.9.1","@wormhole-foundation/sdk-evm-tokenbridge":"^4.9.1","@wormhole-foundation/sdk-solana":"^4.9.1","@wormhole-foundation/sdk-solana-cctp":"^4.9.1","@wormhole-foundation/sdk-solana-tokenbridge":"^4.9.1","@xenova/transformers":"^2.17.2","better-sqlite3":"^12.6.2","binance":"^3.3.1","bn.js":"^5.2.2","bs58":"^5.0.0","bullmq":"^5.67.3","bybit-api":"^4.5.2","chalk":"^5.3.0","chokidar":"^3.5.3","commander":"^12.0.0","discord.js":"^14.14.1","docx":"^9.5.1","dotenv":"^16.6.1","ethers":"^6.16.0","eventemitter3":"^5.0.1","express":"^4.18.2","fast-xml-parser":"^5.3.4","figlet":"^1.10.0","glob":"^10.3.10","grammy":"^1.21.1","hyperliquid":"^1.7.7","inquirer":"^9.2.14","ioredis":"^5.9.2","json5":"^2.2.3","mammoth":"^1.11.0","node-cron":"^3.0.3","nodemailer":"^7.0.13","pg":"^8.17.2","pino":"^8.18.0","pino-pretty":"^10.3.1","sharp":"^0.34.5","sql.js":"^1.10.3","tiktoken":"^1.0.22","tmi.js":"^1.8.5","unofficial-opinion-clob-sdk":"^0.1.10","ws":"^8.16.0","yaml":"^2.3.4","zod":"^3.22.4"},"overrides":{"axios":"^1.7.4","undici":"^6.23.0","nanoid":"^3.3.8","bigint-buffer":"npm:@vekexasia/bigint-buffer2@^1.0.4","fast-xml-parser":"^5.3.4","@cosmjs/crypto":"^0.38.1","@cosmjs/amino":"^0.38.1","@cosmjs/proto-signing":"^0.38.1","@cosmjs/stargate":"^0.38.1","@cosmjs/tendermint-rpc":"^0.38.1","@cosmjs/cosmwasm-stargate":"^0.38.1"},"devDependencies":{"@types/express":"^4.17.21","@types/hapi__boom":"^9.0.1","@types/node":"^20.19.32","@types/nodemailer":"^6.4.22","@types/sql.js":"^1.4.9","@types/ws":"^8.5.10","puppeteer":"^24.37.2","tsx":"^4.7.0","typescript":"^5.3.3"},"_id":"@alsk1992/clodds@1.1.0","gitHead":"69c5e64aa40492ccd9bdf55125b3fe176e538571","types":"./dist/index.d.ts","_nodeVersion":"24.5.0","_npmVersion":"11.5.1","dist":{"integrity":"sha512-lGy0fWLItKAs2Jv7lr5bZMKpVfo3ULViXd+9JPAbeUc2vuHFi7B/rd8uxG5ggjLxLCyOcA3p6hLeLkyhcls7XQ==","shasum":"9d001fd461a0c70c309a261a963da3b09d4882dc","tarball":"https://registry.npmjs.org/@alsk1992/clodds/-/clodds-1.1.0.tgz","fileCount":1719,"unpackedSize":17524441,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCkfegauz3YsbPRLZ3r4dDCrClJXMQ8asei7vQVrqS00gIgVymEDHusuOmBIeVgJc1AzSeI+r/pxaqt2iBlP5N5Zx4="}]},"_npmUser":{"name":"6to7figs","email":"vib3labs@gmail.com"},"directories":{},"maintainers":[{"name":"6to7figs","email":"vib3labs@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/clodds_1.1.0_1770577909615_0.3354700533318291"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-08T19:11:49.452Z","1.1.0":"2026-02-08T19:11:49.911Z","modified":"2026-02-08T19:11:50.227Z"},"maintainers":[{"name":"6to7figs","email":"vib3labs@gmail.com"}],"description":"AI trading terminal for 700+ markets. Prediction markets, crypto, futures up to 200x. 22 chat channels, arbitrage, whale tracking, copy trading, MEV protection. Built on Claude.","homepage":"https://cloddsbot.com","keywords":["trading","prediction-markets","polymarket","kalshi","betfair","agentbets","crypto","defi","futures","binance","solana","ethereum","arbitrage","whale-tracking","copy-trading","mev-protection","ai","claude","telegram-bot","discord-bot","trading-bot"],"repository":{"type":"git","url":"git+https://github.com/alsk1992/CloddsBot.git"},"author":{"name":"alsk1992"},"bugs":{"url":"https://github.com/alsk1992/CloddsBot/issues"},"license":"MIT","readme":"<p align=\"center\">\n  <img src=\"https://cloddsbot.com/logo.png\" alt=\"Clodds Logo\" width=\"280\">\n</p>\n\n<p align=\"center\">\n  <strong>AI-powered trading terminal for prediction markets, crypto & futures</strong>\n  <br>\n  <sub>Claude + Odds = Clodds</sub>\n</p>\n\n<p align=\"center\">\n  <img src=\"https://img.shields.io/badge/version-0.3.10-blue\" alt=\"Version\">\n  <img src=\"https://img.shields.io/badge/node-%3E%3D20-brightgreen\" alt=\"Node.js\">\n  <img src=\"https://img.shields.io/badge/typescript-5.3-blue\" alt=\"TypeScript\">\n  <a href=\"https://opensource.org/licenses/MIT\"><img src=\"https://img.shields.io/badge/license-MIT-yellow\" alt=\"MIT License\"></a>\n  <img src=\"https://img.shields.io/badge/channels-22-purple\" alt=\"22 Channels\">\n  <img src=\"https://img.shields.io/badge/markets-10-orange\" alt=\"9 Markets\">\n</p>\n\n<p align=\"center\">\n  <a href=\"#quick-start\">Quick Start</a> •\n  <a href=\"#everything-we-built\">Features</a> •\n  <a href=\"#channels\">Channels</a> •\n  <a href=\"#prediction-markets-10\">Markets</a> •\n  <a href=\"#documentation\">Docs</a>\n</p>\n\n---\n\n**Clodds** is a personal AI trading terminal for prediction markets, crypto spot, and **perpetual futures with leverage**. Run it on your own machine, chat via any of **22 messaging platforms**, trade across **10 prediction markets + 6 futures exchanges** (including on-chain Solana perps via Percolator), and manage your portfolio — all through natural conversation.\n\nBuilt on Claude with arbitrage detection algorithms based on [arXiv:2508.03474](https://arxiv.org/abs/2508.03474), which documented arbitrage patterns on Polymarket. See [Arbitrage Limitations](#arbitrage-limitations) for practical considerations.\n\n---\n\n## Deployment Options\n\n| Option | Best For | Setup Time | Features |\n|--------|----------|------------|----------|\n| **[Self-Hosted](#quick-start)** | Full control, all features | 5 min | 22 channels, trading, DeFi, bots |\n| **[Cloudflare Worker](#cloudflare-worker)** | Lightweight, edge deployment | 2 min | 3 webhook channels, market data, arbitrage |\n| **[Compute API](#compute-api)** | Agents paying for compute | Live | LLM, code, web, data, storage |\n\n## Compute API\n\n**Live at:** https://api.cloddsbot.com\n\nAgents can pay USDC for compute resources — no API keys needed, just a wallet.\n\n```bash\n# Check health\ncurl https://api.cloddsbot.com/health\n\n# See pricing\ncurl https://api.cloddsbot.com/pricing\n\n# Check balance\ncurl https://api.cloddsbot.com/balance/0xYourWallet\n```\n\n**Services:**\n| Service | Pricing | Description |\n|---------|---------|-------------|\n| `llm` | $0.000003/token | Claude, GPT-4, Llama, Mixtral |\n| `code` | $0.001/second | Sandboxed Python, JS, Rust, Go |\n| `web` | $0.005/request | Web scraping with JS rendering |\n| `data` | $0.001/request | Prices, orderbooks, candles |\n| `storage` | $0.0001/MB | Key-value file storage |\n| `trade` | $0.01/call | Trade execution (Polymarket, DEXs) |\n\n**Payment flow:**\n1. Send USDC to treasury wallet on Base\n2. Include payment proof in request\n3. API credits your balance\n4. Use compute services\n\nSee [docs/API.md](./docs/API.md#clodds-compute-api) for full documentation.\n\n## Quick Start\n\n**Option 1: npm (recommended)**\n```bash\n# One-time: configure npm for @alsk1992 scope\necho \"@alsk1992:registry=https://npm.pkg.github.com\" >> ~/.npmrc\n\n# Install globally\nnpm install -g @alsk1992/clodds\n\n# Run\nexport ANTHROPIC_API_KEY=sk-ant-...\nclodds start\n```\n\n**Option 2: From source**\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\nOpen `http://localhost:18789/webchat` — no account needed.\n\n## CLI\n\n```bash\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** | 22 platforms (Telegram, Discord, WhatsApp, Slack, Teams, Signal, Matrix, iMessage, LINE, Nostr, and more) |\n| **Prediction Markets** | 9 platforms (Polymarket, Kalshi, Betfair, Smarkets, Drift, Manifold, Metaculus, PredictIt) |\n| **Perpetual Futures** | 5 exchanges (Binance, Bybit, Hyperliquid, MEXC, Percolator) 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| **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 5 platforms, portfolio tracking, P&L, trade logging, DCA on 16 platforms |\n| **MCP Server** | Expose all 113 skills as MCP tools for Claude Desktop and Claude Code |\n| **Arbitrage** | Cross-platform detection, combinatorial analysis, semantic matching, real-time scanning |\n| **AI** | 6 LLM providers, 4 specialized agents, semantic memory, 21 tools |\n| **i18n** | 10 languages (EN, ZH, ES, JA, KO, DE, FR, PT, RU, AR) |\n| **Solana DeFi** | Jupiter, Raydium, Orca, Meteora, Pump.fun integration |\n| **EVM DeFi** | Uniswap V3, 1inch, Virtuals Protocol (ETH, ARB, OP, Base, Polygon) |\n| **Smart Trading** | Whale tracking, copy trading, smart routing, MEV protection |\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| **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 (22)\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.\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\nSupports limit/market orders, maker rebates, real-time orderbooks, P&L tracking, and smart routing.\n\n---\n\n## Crypto & DeFi\n\n**Solana:** Jupiter, Raydium, Orca, Meteora, Pump.fun — with Jito MEV protection\n\n**EVM (5 chains):** Uniswap V3, 1inch, Virtuals Protocol on Ethereum, Arbitrum, Optimism, Base, Polygon — with Flashbots MEV protection\n\n**Bridging:** Wormhole cross-chain transfers (ETH ↔ Solana, Polygon ↔ Base)\n\n**Payments:** x402 protocol for agent-to-agent USDC payments\n\n---\n\n## Perpetual Futures (5 Exchanges)\n\n| Exchange | Max Leverage | KYC | Type |\n|----------|--------------|-----|------|\n| Binance | 125x | Yes | CEX |\n| Bybit | 100x | Yes | CEX |\n| Hyperliquid | 50x | No | DEX |\n| MEXC | 200x | No | CEX |\n| Percolator | Varies | No | On-chain (Solana) |\n\nLong/short, cross/isolated margin, TP/SL, liquidation alerts, funding tracking, database logging.\n\n```\n/futures long BTCUSDT 0.1 10x\n/futures sl BTCUSDT 95000\n```\n\n### Percolator (On-Chain Solana Perps)\n\nTrade perpetual futures directly on Solana via Anatoly Yakovenko's Percolator protocol — no KYC, no intermediaries, fully on-chain.\n\n```\n/percolator status          # Oracle price, OI, funding, spread\n/percolator positions       # Your open positions\n/percolator long 100        # Open $100 long\n/percolator short 50        # Open $50 short\n/percolator deposit 500     # Deposit USDC collateral\n/percolator withdraw 100    # Withdraw USDC collateral\n```\n\nConfigure: `PERCOLATOR_ENABLED=true PERCOLATOR_SLAB=<pubkey> PERCOLATOR_ORACLE=<pubkey>`\n\n---\n\n## AI System\n\n**6 LLM providers:** Claude (primary), GPT-4, Gemini, Groq, Together, Ollama\n\n**4 agents:** Main, Trading, Research, Alerts\n\n**21 tools:** Browser, docker, exec, files, git, email, sms, webhooks, sql, vision\n\n**Memory:** Semantic search (LanceDB), hybrid BM25, user profiles, persistent facts\n\n---\n\n## Arbitrage Detection\n\nBased on [arXiv:2508.03474](https://arxiv.org/abs/2508.03474). Detects internal, cross-platform, and combinatorial arbitrage with semantic matching, liquidity scoring, and Kelly sizing.\n\n```\nYES: 45c + NO: 52c = 97c → Buy both → 3c profit\nPolymarket @ 52c vs Kalshi @ 55c → 3c spread\n```\n\n**Note:** Defaults to dry-run mode. Cross-platform has currency/settlement complexity.\n\n---\n\n## Advanced Trading\n\n**Whale Tracking:** Multi-chain monitoring (Solana, ETH, Polygon, ARB, Base, OP) with configurable thresholds\n\n**Copy Trading:** Mirror successful wallets with sizing controls and SL/TP\n\n**Swarm Trading:** Coordinated multi-wallet Pump.fun trading (20 wallets, Jito bundles)\n\n**Smart Routing:** Best price, liquidity, or fees across platforms\n\n**External Data:** FedWatch, 538, Silver Bulletin, RCP, Odds API for edge detection\n\n**Safety:** Unified risk engine with circuit breaker, VaR/CVaR, volatility regime detection, stress testing, Kelly sizing, daily loss limits, kill switch\n\n---\n\n## Bittensor Mining\n\nMine TAO on Bittensor subnets directly from Clodds:\n\n```bash\nclodds bittensor setup           # Interactive wizard: Python, btcli, wallet, config\nclodds bittensor status          # Check mining status\nclodds bittensor wallet balance  # Check TAO balance\nclodds bittensor register 64     # Register on Chutes (SN64)\n```\n\n**In chat:** `/tao status`, `/tao earnings daily`, `/tao wallet`\n\nFeatures: Wallet management via `@polkadot/api`, Python sidecar for btcli, Chutes SN64 GPU compute, earnings tracking with SQLite persistence, HTTP API at `/api/bittensor/*`.\n\n---\n\n## Trading Bots\n\nBuilt-in strategies: Mean Reversion, Momentum, Arbitrage, Market Making\n\nFeatures: Configurable sizing, SL/TP, backtesting, live trading with safety limits\n\n---\n\n## Security\n\n- Sandboxed execution (shell commands need approval)\n- Encrypted credentials (AES-256-GCM)\n- Audit logging for all trades\n\n---\n\n## Trade Ledger\n\nDecision audit trail for AI trading transparency:\n\n- **Decision Capture:** Every trade, copy, and risk decision logged with reasoning\n- **Confidence Calibration:** Track AI prediction accuracy vs confidence levels\n- **Integrity Hashing:** Optional SHA-256 hashes for tamper-proof records\n- **Onchain Anchoring:** Anchor hashes to Solana, Polygon, or Base for immutable proof\n- **Statistics:** Win rates, P&L, block reasons, accuracy by confidence bucket\n\n```bash\nclodds ledger stats              # Show decision statistics\nclodds ledger calibration        # Confidence vs accuracy analysis\nclodds ledger verify <id>        # Verify record integrity\nclodds ledger anchor <id>        # Anchor hash to Solana\n```\n\nEnable: `clodds config set ledger.enabled true`\n\n---\n\n## Skills & Extensions\n\n**111 bundled skills** across trading, data, automation, and infrastructure — lazy-loaded on first use so missing dependencies don't crash the app. Run `/skills` to see status.\n\n| Category | Skills |\n|----------|--------|\n| Trading | Polymarket, Kalshi, Betfair, Hyperliquid, Binance, Bybit, MEXC, Jupiter, Raydium, Orca, Percolator, DCA (16 platforms) |\n| Analysis | Arbitrage detection, edge finding, whale tracking, copy trading, token security audits, security shield |\n| Automation | Cron jobs, triggers, bots, webhooks |\n| AI | Memory, embeddings, multi-agent routing |\n\n**7 extensions** for Copilot, OpenTelemetry, LanceDB, and more.\n\n---\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────────┐\n│                            GATEWAY                                   │\n│       HTTP • WebSocket • Auth • Rate Limiting • 1000 connections     │\n└─────────────────────────────────┬───────────────────────────────────┘\n                                  │\n        ┌─────────────────────────┼─────────────────────────┐\n        ▼                         ▼                         ▼\n┌───────────────┐         ┌───────────────┐         ┌───────────────┐\n│   CHANNELS    │         │    AGENTS     │         │    FEEDS      │\n│   (22)        │         │    (4)        │         │    (9+)       │\n├───────────────┤         ├───────────────┤         ├───────────────┤\n│ Telegram      │         │ Main          │         │ Polymarket    │\n│ Discord       │         │ Trading       │         │ Kalshi        │\n│ WhatsApp      │         │ Research      │         │ Betfair       │\n│ Slack         │         │ Alerts        │         │ Manifold      │\n│ Teams         │         │               │         │ Crypto (10)   │\n│ Matrix        │         │ Tools (21)    │         │               │\n│ Signal        │         │ Skills (110)  │         │ Arbitrage     │\n│ +15 more      │         │ Memory        │         │ Detector      │\n└───────────────┘         └───────────────┘         └───────────────┘\n        │                         │                         │\n        └─────────────────────────┼─────────────────────────┘\n                                  │\n        ┌─────────────────────────┼─────────────────────────┐\n        ▼                         ▼                         ▼\n┌───────────────┐         ┌───────────────┐         ┌───────────────┐\n│   TRADING     │         │   SOLANA      │         │   PAYMENTS    │\n│               │         │   DeFi        │         │   (x402)      │\n├───────────────┤         ├───────────────┤         ├───────────────┤\n│ Execution     │         │ Jupiter       │         │ Base USDC     │\n│ Portfolio     │         │ Raydium       │         │ Solana USDC   │\n│ Trade Logger  │         │ Orca          │         │ Auto-approve  │\n│ Bots          │         │ Meteora       │         │               │\n│ Risk Manager  │         │ Pump.fun      │         │ Wormhole      │\n│ Backtesting   │         │               │         │ Bridge        │\n└───────────────┘         └───────────────┘         └───────────────┘\n                                  │\n                          ┌───────────────┐\n                          │  BITTENSOR    │\n                          ├───────────────┤\n                          │ Wallet        │\n                          │ Subnet Mining │\n                          │ Earnings      │\n                          │ Chutes (SN64) │\n                          └───────────────┘\n                                  │\n                          ┌───────────────┐\n                          │  PERCOLATOR   │\n                          ├───────────────┤\n                          │ Slab Parser   │\n                          │ Trade CPI     │\n                          │ Keeper Crank  │\n                          │ Oracle Feed   │\n                          └───────────────┘\n```\n\n---\n\n## Configuration\n\n```bash\n# Required\nANTHROPIC_API_KEY=sk-ant-...\n\n# Channels (pick any)\nTELEGRAM_BOT_TOKEN=...\nDISCORD_BOT_TOKEN=...\n\n# Trading\nPOLYMARKET_API_KEY=...\nSOLANA_PRIVATE_KEY=...\n```\n\nData stored in `~/.clodds/` (SQLite database, auto-created on first run).\n\n---\n\n## Documentation\n\n| Document | Description |\n|----------|-------------|\n| [User Guide](./docs/USER_GUIDE.md) | Commands, chat usage, workflows |\n| [API Reference](./docs/API_REFERENCE.md) | HTTP/WebSocket endpoints, authentication, error codes |\n| [Architecture](./docs/ARCHITECTURE.md) | System design, components, data flow, extension points |\n| [Deployment](./docs/DEPLOYMENT.md) | Environment variables, Docker, systemd, production checklist |\n| [Trading](./docs/TRADING.md) | Execution, bots, risk management, safety controls |\n| [Security](./docs/SECURITY_AUDIT.md) | Security hardening, audit checklist |\n| [OpenAPI Spec](./docs/openapi.yaml) | Full OpenAPI 3.0 specification |\n\n---\n\n## Development\n\n```bash\nnpm run dev          # Hot reload\nnpm test             # Run tests\nnpm run typecheck    # Type check\nnpm run lint         # Lint\nnpm run build        # Build\n```\n\n### Docker\n```bash\ndocker compose up --build\n```\n\n---\n\n## Summary\n\n| Category | Count |\n|----------|------:|\n| Messaging Channels | **22** |\n| Prediction Markets | **9** |\n| Futures Exchanges | **5** |\n| AI Tools | **21** |\n| Skills | **103** |\n| LLM Providers | **6** |\n| Solana DEX Protocols | **5** |\n| Trading Strategies | **4** |\n| Extensions | **7** |\n\n---\n\n## License\n\nMIT — see [LICENSE](./LICENSE)\n\n---\n\n<p align=\"center\">\n  <strong>Clodds</strong> — Claude + Odds\n  <br>\n  <sub>Built with Claude by Anthropic</sub>\n</p>\n","readmeFilename":"README.md","_rev":"1-8807a4e6bc46b9c5ec4d063611c39b0e"}