https://github.com/naimkatiman/tradeclaw
π€ Self-hosted AI trading signals - RSI, MACD, EMA for forex, crypto & metals. Live signals, backtesting, paper trading. Free forever.
https://github.com/naimkatiman/tradeclaw
ai algorithmic-trading backtesting bitcoin crypto docker finance forex macd nextjs open-source paper-trading rsi self-hosted signals technical-analysis trading trading-bot trading-signals typescript
Last synced: 3 months ago
JSON representation
π€ Self-hosted AI trading signals - RSI, MACD, EMA for forex, crypto & metals. Live signals, backtesting, paper trading. Free forever.
- Host: GitHub
- URL: https://github.com/naimkatiman/tradeclaw
- Owner: naimkatiman
- License: mit
- Created: 2026-03-21T02:28:48.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-03T01:07:32.000Z (3 months ago)
- Last Synced: 2026-04-03T03:42:28.098Z (3 months ago)
- Topics: ai, algorithmic-trading, backtesting, bitcoin, crypto, docker, finance, forex, macd, nextjs, open-source, paper-trading, rsi, self-hosted, signals, technical-analysis, trading, trading-bot, trading-signals, typescript
- Language: TypeScript
- Homepage: https://tradeclaw.win
- Size: 5.76 MB
- Stars: 5
- Watchers: 0
- Forks: 3
- Open Issues: 21
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-quant - TradeClaw - `JavaScript` - Open-source AI trading signal platform with RSI/MACD/EMA confluence scoring, real-time signals for 10+ assets, self-hostable with one Docker command. (Trading & Backtesting)
README
# TradeClaw
**Open-source AI trading signal platform. Self-hosted. Free forever.**
[](https://github.com/naimkatiman/tradeclaw/stargazers)
[](https://opensource.org/licenses/MIT)
[](https://tradeclaw.win/users)
[](https://hub.docker.com/r/tradeclaw/tradeclaw)
[](https://tradeclaw.win/dashboard)
[](https://tradeclaw.win/status)
[](https://tradeclaw.win/subscribe)
[](https://tradeclaw.win/subscribe)
[](https://replit.com/github/naimkatiman/tradeclaw)
[](https://tradeclaw.win/fly)
[](https://tradeclaw.win/supabase)
[](https://github.com/sponsors/naimkatiman)
**[π Live Demo](https://tradeclaw.win/dashboard)** Β· **[β‘ Get Started](https://tradeclaw.win/start)** Β· **[π‘ API](https://tradeclaw.win/api-docs)** Β· **[π Docs](https://tradeclaw.win/docs)** Β· **[π€ Contribute](https://tradeclaw.win/contribute)**
π [δΈζ](README.zh.md) | [ζ₯ζ¬θͺ](README.ja.md) | [νκ΅μ΄](README.ko.md)
---
> 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
```bash
npx @naimkatiman/tradeclaw-demo
```
Opens a full live demo at `http://localhost:3001` β signals, leaderboard, backtest, all running locally.
π **[Interactive Setup Guide β](https://tradeclaw.win/start)**
## Deploy in 60 seconds
```bash
docker run -p 3000:3000 tradeclaw/tradeclaw
```
Open [http://localhost:3000](http://localhost:3000) β done.
[](https://railway.app/new/template?template=https://github.com/naimkatiman/tradeclaw)
[](https://vercel.com/new/clone?repository-url=https://github.com/naimkatiman/tradeclaw/tree/main/apps/web)
**[Supabase Setup Guide](https://tradeclaw.win/supabase)** β upgrade from JSON to Postgres with one command.
Or with Docker Compose (adds persistent data):
```bash
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
## Live Signal Badges
Embed live BTC/ETH/Gold signals in any README β auto-refresh every 5 min, no API key:
[](https://tradeclaw.win/signal/BTCUSD-H1-BUY)
[](https://tradeclaw.win/signal/ETHUSD-H1-BUY)
[](https://tradeclaw.win/signal/XAUUSD-H1-BUY)
```markdown
[](https://tradeclaw.win)
[](https://tradeclaw.win)
```
## Packages
All packages are published to [GitHub Packages](https://github.com/naimkatiman/tradeclaw/packages).
**Setup** β add to your project's `.npmrc`:
```
@naimkatiman:registry=https://npm.pkg.github.com
```
Then install:
```bash
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
```bash
npx @naimkatiman/tradeclaw signals --pair BTCUSD --limit 5
npx @naimkatiman/tradeclaw leaderboard --period 30d
npx @naimkatiman/tradeclaw health
```
### MCP Server (Claude Desktop)
```json
{
"mcpServers": {
"tradeclaw": {
"command": "npx",
"args": ["@naimkatiman/tradeclaw-mcp"]
}
}
}
```
## GitHub Action
```yaml
- uses: naimkatiman/tradeclaw/packages/tradeclaw-action@main
with: { pair: BTCUSD, min_confidence: 70 }
```
[Action docs β](https://tradeclaw.win/github-action) Β· [Marketplace β](https://github.com/marketplace/actions/tradeclaw-signal)
## Contributing
Check **[good first issues](https://github.com/naimkatiman/tradeclaw/labels/good%20first%20issue)** and **[contribution guide](https://tradeclaw.win/contribute)**.
## 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
[](https://github.com/sponsors/naimkatiman)
[](https://buymeacoffee.com/naimkatiman)
---