TradeClaw

Open-source AI market intelligence for traders who prefer evidence over noise.

Self-hosted by default

Product

  • Dashboard
  • Screener
  • Backtest
  • Track record
  • Live demo

Transparency

  • What we tested and killed
  • Methodology
  • Why long-term
  • Open data
  • Calibration

Resources

  • Blog
  • Docs
  • API reference
  • How it works
  • FAQ
  • Glossary

Community

  • Discord
  • Weekly digest
  • Contribute
  • Contributors
  • Sponsors

Open source

  • GitHub repo
  • Star history
  • Self-host guide
  • Security
  • Data freshness
  • Roadmap

© 2026 TradeClaw. MIT licensed.

Terms|Privacy|Trading involves risk. Signals are informational only and are not financial advice.
DashboardScreenerCopilotTrack Record
TradeClaw
Documentation

Getting Started

  • Overview
  • Installation
  • Configuration
  • Self-Hosting

Core Features

  • Trading Signals
  • Paper Trading
  • Strategy Builder

Integrations

  • API Reference
  • Webhooks
  • Telegram Bot
  • Plugins
  • Embedding

Project

  • Contributing
  • Changelog
GitHubApp Dashboard
Open Source · Self-Hostable

TradeClaw Documentation

TradeClaw is MIT-licensed, self-hostable trading-signal software with a rule-based analysis engine, modeled paper trading, optional Telegram delivery, and a plugin system. Follow the documented Docker Compose and environment setup for your infrastructure.

MIT
Source License
Docker
Self-Hosting
Off
Auto Execution
Explicit
Outcome Labels

What is TradeClaw?

TradeClaw generates candidate signal records with a multi-indicator rule engine for assets and timeframes supported by the configured data source. Its confluence score describes weighted indicator agreement; it is not a calibrated probability of profit.

The entire TA engine is pure TypeScript — no external indicator libraries, no black boxes. You can read every formula, fork it, and extend it with the plugin system.

Architecture

Next.js App (apps/web)

All routes, API endpoints, dashboard UI, and React components.

TA Engine (apps/web/app/lib/ta-engine.ts)

Pure-math RSI, MACD, EMA, Bollinger Bands, Stochastic. Zero dependencies.

Plugin System (apps/web/lib/plugin-system.ts)

Sandboxed JS execution for custom indicators (VWAP, ATR, OBV, Ichimoku).

Signal Scanner (Dockerfile.scanner)

Background worker that polls prices, runs TA, and emits signals on a configurable interval.

TimescaleDB + Redis

PostgreSQL with time-series extensions for signal history; Redis for rate limiting.

Documentation

Getting Started

Installation

Docker, npm, Railway, and Vercel deploy guides

Configuration

Environment variables and config options

Self-Hosting

Production deployment with nginx and SSL

Core Features

Trading Signals

How signals are generated and scored

Paper Trading

Risk-free trading simulation

Strategy Builder

Visual strategy creation and backtesting

Integrations

API Reference

Full REST API documentation

Webhooks

Push event delivery with HMAC signing

Telegram Bot

Bot setup and command reference

Plugins

Custom indicator development

Embedding

Embeddable widget for any website

Project

Contributing

Dev setup and architecture overview

Changelog

Release history and recent changes

Quick Start

The fastest way to run TradeClaw is Docker Compose. From the repo root:

# 1. Clone the repository

git clone https://github.com/naimkatiman/tradeclaw

cd tradeclaw

# 2. Configure environment

cp apps/web/.env.example apps/web/.env.local

# 3. Start all services

docker compose up -d

# App runs at localhost:3000

See the Installation guide for Railway, Vercel, and bare-metal deployment options.

NextInstallation
Edit this page on GitHub