Metadata-Version: 2.4
Name: radbot
Version: 1.0.10
Summary: Radix Aggregated DEX Trading Bot
Author: Akond Ltd
License: AGPL-3.0-or-later
Project-URL: Homepage, https://radixtalk.com/
Project-URL: Repository, https://github.com/AkondLtd/radbot
Project-URL: Issues, https://github.com/AkondLtd/radbot/issues
Keywords: radix,dex,trading,bot,defi,crypto
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: X11 Applications :: Qt
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE-agpl-3.0.txt
Requires-Dist: PySide6>=6.6
Requires-Dist: requests>=2.31
Requires-Dist: aiohttp>=3.9
Requires-Dist: async-timeout>=4.0
Requires-Dist: aiolimiter>=1.1
Requires-Dist: numpy>=2.0
Requires-Dist: pandas>=2.1
Requires-Dist: matplotlib>=3.8
Requires-Dist: mplfinance>=0.12.10b0
Requires-Dist: cryptography>=42.0
Requires-Dist: radix-engine-toolkit>=2.2
Requires-Dist: mnemonic>=0.21
Requires-Dist: bip_utils>=2.9
Requires-Dist: cairocffi>=1.6
Requires-Dist: segno>=1.4
Requires-Dist: qrcode-artistic>=3.0
Requires-Dist: pillow>=10.0
Requires-Dist: nocairosvg>=2024
Requires-Dist: Cython>=3.0
Requires-Dist: platformdirs>=4.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Dynamic: license-file

# RadBot

**Radix Aggregated DEX Trading Bot**

RadBot is an automated trading bot for the [Radix DLT](https://www.radixdlt.com/) network. It monitors token prices 24/7 and executes trades across aggregated DEX liquidity based on your chosen strategy.

## Features

- **Multiple Strategies** — Manual indicator-based, Ping Pong, and AI-powered machine learning
- **Technical Indicators** — RSI, MACD, Bollinger Bands, Moving Average Crossover, ATR, and more
- **AI Optimization** — Machine learning auto-tunes strategy parameters after sufficient trade data
- **Non-Custodial** — Your keys never leave your machine; wallet password stays in RAM only
- **Real-Time Dashboard** — Live price charts, balance tracking, trade history, and profit analytics
- **Aggregated DEX Routing** — Finds the best swap route across Radix DEX pools

## Quick Start

### Install from PyPI

```bash
pip install radbot
```

### Or clone and install locally

```bash
git clone https://github.com/AkondLtd/radbot.git
cd radbot
pip install -e .
```

### Run

```bash
radbot
```

## Requirements

- Python 3.11 or later
- Windows, Linux, or macOS
- An active internet connection (for Radix Gateway API access)
- XRD tokens in your wallet for trading and network fees

## First Steps

1. **Load your wallet** — Create a new wallet, import a seed phrase, or load an existing wallet file
2. **Configure trade pairs** — Browse available token pairs and select which ones to track
3. **Create a trade** — Pick a pair, choose a strategy, set your amount, and start trading
4. **Monitor** — Watch your trades execute on the Active Trades tab

See the full [Getting Started Guide](docs/getting_started.md) for detailed instructions.

## Strategies

| Strategy | Description |
|----------|-------------|
| **Ping Pong** | Buy at a fixed low price, sell at a fixed high price — simple and predictable |
| **Manual** | You configure technical indicators (RSI, MACD, etc.) and RadBot follows the signals |
| **AI Strategy** | Machine learning analyses your trade history and optimises indicator parameters automatically |

## Project Structure

```
radbot/
├── core/           # Radix blockchain interaction (wallet, transactions, network)
├── config/         # Application and database configuration
├── constants/      # Strategy type definitions
├── database/       # SQLite database managers (trades, balances, tokens, history)
├── gui/            # PySide6 Qt GUI (tabs, components, styling)
├── images/         # Icons and images
├── indicators/     # Technical indicator implementations
├── models/         # Data models
├── services/       # Background services (trade monitor, price history, AI)
├── security/       # Dependency verification
├── utils/          # Utility helpers
├── docs/           # User documentation
├── libs/           # Platform-specific libraries (Cairo DLLs for Windows)
├── main.py         # Application entry point
└── version.py      # Version metadata
```

## Security

- Wallet passwords are held in RAM only and erased on exit
- Private keys are never written to disk unencrypted
- Seed phrases are never stored by RadBot
- Fee configuration uses compiled native modules with integrity verification
- Dependency hashes are verified at startup

## License

This project is licensed under the [GNU Affero General Public License v3.0](LICENSE-agpl-3.0.txt).

## Links

- [RadixTalk Community](https://radixtalk.com/)
- [Radix DLT](https://www.radixdlt.com/)
