Metadata-Version: 2.4
Name: deepalpha-bot
Version: 1.0.0
Summary: AI-powered crypto trading bot. 3-model ML consensus, Triple Barrier labeling, auto risk management. Supports Bybit, Bitget, Hyperliquid.
Author-email: DeepAlpha Team <info@deepalphabot.com>
License: Proprietary
Project-URL: Homepage, https://deepalphabot.com
Project-URL: Documentation, https://deepalphabot.com/#download
Project-URL: Discord, https://discord.gg/P4yX686m
Keywords: crypto,trading,bot,algorithmic-trading,ai,machine-learning,lightgbm,bybit,bitget,hyperliquid,automated-trading,cryptocurrency,perpetual-futures,quantitative-finance,triple-barrier,meta-labeling,shap,freqtrade
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: lightgbm>=3.3
Requires-Dist: xgboost>=1.5
Requires-Dist: scikit-learn>=1.0
Requires-Dist: numpy>=1.21
Requires-Dist: pandas>=1.3
Requires-Dist: ccxt>=4.0
Requires-Dist: python-dotenv>=0.19
Requires-Dist: requests>=2.27
Requires-Dist: joblib>=1.1
Requires-Dist: flask>=2.0
Provides-Extra: hmm
Requires-Dist: hmmlearn>=0.3; extra == "hmm"
Provides-Extra: lstm
Requires-Dist: torch>=2.0; extra == "lstm"

<div align="center">

# DeepAlpha Bot

### AI-Powered Crypto Trading in One Command

[![PyPI](https://img.shields.io/pypi/v/deepalpha-bot.svg?color=blue)](https://pypi.org/project/deepalpha-bot/)
[![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/)
[![Discord](https://img.shields.io/badge/discord-join-7289da.svg)](https://discord.gg/P4yX686m)

**Install. Configure. Trade. That's it.**

</div>

---

## What is DeepAlpha Bot?

A fully autonomous crypto trading bot powered by a 3-model machine learning consensus. It trades 26 liquid USDT perpetual coins 24/7 on **Bybit**, **Bitget**, or **Hyperliquid**.

No manual trading. No chart watching. No emotional decisions. The AI handles everything.

---

## Install in 10 seconds

```bash
pip install deepalpha-bot
```

---

## Start in 5 minutes

```bash
# Step 1: Setup (creates config, gets 7-day free trial)
deepalpha-bot setup

# Step 2: Train models (~1-2 hours, one time)
deepalpha-bot train

# Step 3: Start trading
deepalpha-bot start
```

That's it. The bot runs 24/7 and sends you Telegram notifications for every trade.

---

## How it works

```
Market Data (OHLCV, funding, OI)
        |
   Feature Engine (62 indicators → SHAP top-13)
        |
   3-Model Consensus Vote
   ├── LightGBM (primary)
   ├── XGBoost (ensemble)
   └── Random Forest (ensemble)
        |
   Meta-Labeling Filter (removes low-confidence)
        |
   HMM Regime Gate (no counter-trend trades)
        |
   Risk Management
   ├── ATR dynamic stop-loss
   ├── Multi-target take-profit (33% / 33% / 34%)
   ├── Trailing stop (breakeven at +1.5%, lock at +3%)
   └── Auto-Unstuck (graduated exit on loss)
        |
   Trade Execution (limit-first, IOC fallback)
        |
   Telegram Notification
```

---

## Key features

- **3-model ML consensus**: LightGBM + XGBoost + Random Forest vote together. Trade only when 2+ models agree.
- **Triple Barrier labeling**: Labels based on real trade outcomes (profit/stop/time), not arbitrary price direction.
- **SHAP feature selection**: 62 indicators pruned to 13 that actually predict. Recalculated every training cycle.
- **Regime detection**: HMM 3-state model (bull/bear/sideways). No longs in bear markets, no shorts in bull markets.
- **Auto risk management**: ATR-based stops, trailing take-profit, circuit breaker, daily loss limit, per-coin cooldown.
- **26 liquid coins**: BTC, ETH, SOL, BNB, DOGE, AVAX, LINK, ARB, OP, APT, SUI, INJ, TIA, WLD, NEAR, AAVE, DOT, ADA, XRP, LTC, BCH, CRV, ONDO, ENA, JUP, RENDER.
- **All major exchanges**: Bybit (recommended), Bitget, Hyperliquid.

---

## Configuration

After `deepalpha-bot setup`, edit `config.json` to adjust:

```json
{
  "MAX_POSITIONS": 3,
  "LEVERAGE": 5,
  "MAX_DAILY_LOSS": 200,
  "MAX_RISK_PER_TRADE_PCT": 0.25,
  "CIRCUIT_BREAKER_LOSSES": 5
}
```

| Setting | Default | Description |
|---|---|---|
| MAX_POSITIONS | 3 | Maximum simultaneous trades |
| LEVERAGE | 5 | Leverage per trade |
| MAX_DAILY_LOSS | 200 | Stop trading after $200 daily loss |
| MAX_RISK_PER_TRADE_PCT | 0.25 | Max 25% of equity per trade |
| CIRCUIT_BREAKER_LOSSES | 5 | Pause after 5 consecutive losses |

---

## Pricing

| Plan | Price | Trial |
|---|---|---|
| **Free Trial** | $0 | 7 days, full features |
| **Pro** | $39/month | Cancel anytime |
| **Lifetime** | $199 one-time | Updates forever |

Start your free trial: `deepalpha-bot setup`

Buy a license: [deepalphabot.com](https://deepalphabot.com)

---

## Production deployment

For 24/7 trading, run on a VPS with PM2:

```bash
# Install PM2
npm install -g pm2

# Start bot
pm2 start "deepalpha-bot start" --name deepalpha

# Auto-restart on reboot
pm2 save && pm2 startup
```

---

## Commands

| Command | Description |
|---|---|
| `deepalpha-bot setup` | Interactive setup + free trial |
| `deepalpha-bot train` | Train AI models |
| `deepalpha-bot start` | Start live trading |
| `deepalpha-bot status` | Check equity and positions |
| `deepalpha-bot version` | Show version |

---

## Also available

- **FreqAI Plugin** (free): `pip install deepalpha-freqai` — use DeepAlpha inside Freqtrade
- **Copy Trading** (free): [Copy our trades on Bybit](https://deepalphabot.com/#copy) — zero setup required
- **Website**: [deepalphabot.com](https://deepalphabot.com)

---

## Disclaimer

Trading involves significant risk of loss. Past performance does not guarantee future results. This software is provided as-is. Only trade with capital you can afford to lose entirely. Not financial advice.

---

<div align="center">

**Built by traders, for traders.**

[Website](https://deepalphabot.com) · [Discord](https://discord.gg/P4yX686m) · [PyPI](https://pypi.org/project/deepalpha-bot/)

</div>
