TradeClaw

Open-source AI trading signal platform. Self-hosted. Free forever.

🚀 Live Demo · ⚡ Get Started · 📡 API · 📖 Docs · 🤝 Contribute

🌍 中文 | 日本語 | 한국어

---

RSI · MACD · EMA · Bollinger · Stochastic — 5-indicator confluence. Live signals for BTC, ETH, Gold, Forex. Deploy in 60 seconds, no subscription required.

Try it now — no install

npx @naimkatiman/tradeclaw-demo

Opens a full live demo at http://localhost:3001 — signals, leaderboard, backtest, all running locally.

👉 Interactive Setup Guide →

Deploy in 60 seconds

docker run -p 3000:3000 tradeclaw/tradeclaw

Open http://localhost:3000 — done.

Supabase Setup Guide — upgrade from JSON to Postgres with one command.

Or with Docker Compose (adds persistent data):

git clone https://github.com/naimkatiman/tradeclaw
cd tradeclaw && cp .env.example .env
docker compose up -d

What you get

	TradeClaw	TradingView	3Commas
Self-hosted	✅	❌	❌
Open source	✅	❌	❌
Free forever	✅	❌ ($15/mo+)	❌ ($29/mo+)
REST API	✅	❌ paid	✅
Telegram bot	✅ built-in	❌	✅ paid
Custom plugins	✅ JS	Pine Script	❌
MCP / AI native	✅	❌	❌

Features: Dashboard · Backtest · Screener · Paper trading · Telegram bot · Webhooks · Discord bot · Signal replay · Multi-timeframe · AI explanations · CLI · MCP server · Plugin system · PWA · RSS feeds · 190+ pages

Strategy Presets

Five named entry strategies, swappable via SIGNAL_ENGINE_PRESET env var. Every signal is tagged with strategyId so you can audit which logic fired it.

Preset	Logic
classic	Baseline RSI + MACD + EMA scoring — no regime filter, no risk breakers
regime-aware	Classic signals filtered by HMM regime, rejects counter-trend trades
hmm-top3	Regime-aware signals ranked by confidence, top 3 only — current production
vwap-ema-bb	Mean-reversion at BB extremes with VWAP + EMA trend confirmation
full-risk	HMM top-3 with risk-weighted allocation and full circuit-breaker pipeline

Compare them side-by-side — multi-select any presets in the backtest UI to see metrics tables and equity-curve overlay charts. Sharpe, drawdown, win-rate, and overlapping-trade handling are all computed correctly (#57, #58).

import { runBacktest } from '@tradeclaw/strategies';

const result = await runBacktest({
  preset: 'hmm-top3',
  candles,
  allocation: { perTrade: 0.02 },
  risk: { maxConcurrent: 3 },
});

Public Signal Feed

Rate-limited public API tier — no auth, no key, just fetch:

curl https://tradeclaw.win/api/feed/public
curl https://tradeclaw.win/api/signal-of-the-day

Live Signal Badges

Embed live BTC/ETH/Gold signals in any README — auto-refresh every 5 min, no API key:

[![BTC Signal](https://tradeclaw.win/api/badge/BTCUSD)](https://tradeclaw.win)
[![ETH Signal](https://tradeclaw.win/api/badge/ETHUSD)](https://tradeclaw.win)

Packages

All packages are published to GitHub Packages.

Setup — add to your project's .npmrc:

@naimkatiman:registry=https://npm.pkg.github.com

Then install:

npm install @naimkatiman/tradeclaw           # CLI
npm install @naimkatiman/tradeclaw-js        # JS/TS SDK
npm install @naimkatiman/tradeclaw-agent     # Self-hosted agent
npm install @naimkatiman/tradeclaw-mcp       # MCP server for AI assistants
npm install @naimkatiman/tradeclaw-discord   # Discord bot
npm install @naimkatiman/tradeclaw-demo      # Local demo
npx @naimkatiman/create-tradeclaw            # Scaffold a new instance

CLI

npx @naimkatiman/tradeclaw signals --pair BTCUSD --limit 5
npx @naimkatiman/tradeclaw leaderboard --period 30d
npx @naimkatiman/tradeclaw health

MCP Server (Claude Desktop)

{
  "mcpServers": {
    "tradeclaw": {
      "command": "npx",
      "args": ["@naimkatiman/tradeclaw-mcp"]
    }
  }
}

GitHub Action

- uses: naimkatiman/tradeclaw/packages/tradeclaw-action@main
  with: { pair: BTCUSD, min_confidence: 70 }

Action docs → · Marketplace →

Contributing

Check good first issues and contribution guide.

Contributors

Thanks to everyone who helps make TradeClaw better. If you’re looking to contribute, start with CONTRIBUTING.md.

⭐ Star this repo to help others discover TradeClaw

---

_{MIT License · Made with ⚡ · tradeclaw.win}